feat: generate unified AST and editor contracts from ASDL
Verify databases and deploy Aster VM / verify-and-deploy (push) Successful in 7m55s

This commit is contained in:
2026-10-19 14:31:28 +08:00
parent be4f1add58
commit f5268d2e09
40 changed files with 2517 additions and 172 deletions
+14
View File
@@ -0,0 +1,14 @@
# 编辑器 AST 接口
这里的类型和遍历函数均从 [Endor.asdl](../Endor.asdl) 生成,不再维护第二份手写节点定义。
| 文件 | 职责 |
| --- | --- |
| [ast.ts](ast.ts) | TypeScript 节点类型、AST_SCHEMA_ID、Visitor 回调与 walk* 函数 |
| [ast.schema.json](ast.schema.json) | JSON Schema 2020-12;校验带 schema 标识的 AstDocument 结构 |
TypeScript 编译时类型不代替 JSON 校验。编辑器可使用现有 JSON Schema 工具校验文档,再交给类型与遍历接口;walk* 的回调返回 false 时跳过该节点的子树。可选字段允许省略或 null,Rust 的标准输出会写成 null。
所有位置为原文 UTF-8 字节范围,不是 JavaScript UTF-16 下标;编辑器需要以原文换算。JSON Schema 检查结构,父子范围关系和原文 UTF-8 边界由 Rust AstDocument::validate/validate_source 检查。schema 标识变化需要调用方升级契约,不提供隐式迁移。
在仓库根运行 `python3 scripts/generate_ast.py --write` 重新生成,--check 做静态同步检查。完整格式见 [AST 模型](../../../docs/runtime/ast.md)。返回 [frontend](../README.md)。
+601
View File
@@ -0,0 +1,601 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:endor:ast:sha256:c0da1a2640ad85f2c8e8159a10756e649d3aab179823a7cd890d9ebbb7f5d46e",
"$ref": "#/$defs/AstDocument",
"$defs": {
"Span": {
"type": "object",
"properties": {
"start": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"end": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
},
"AstDocument": {
"type": "object",
"properties": {
"schema": {
"const": "urn:endor:ast:sha256:c0da1a2640ad85f2c8e8159a10756e649d3aab179823a7cd890d9ebbb7f5d46e"
},
"root": {
"$ref": "#/$defs/AstRoot"
}
},
"required": [
"schema",
"root"
],
"additionalProperties": false
},
"AstRoot": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"const": "Module"
},
"data": {
"$ref": "#/$defs/Program"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Expression"
},
"data": {
"$ref": "#/$defs/Expr"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Interactive"
},
"data": {
"$ref": "#/$defs/InteractiveInput"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
}
]
},
"Name": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"text",
"span"
],
"additionalProperties": false
},
"Program": {
"type": "object",
"properties": {
"declarations": {
"type": "array",
"items": {
"$ref": "#/$defs/Decl"
}
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"declarations",
"span"
],
"additionalProperties": false
},
"Decl": {
"type": "object",
"properties": {
"kind": {
"$ref": "#/$defs/DeclKind"
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"kind",
"span"
],
"additionalProperties": false
},
"DeclKind": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"const": "Function"
},
"data": {
"$ref": "#/$defs/Function"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
}
]
},
"Function": {
"type": "object",
"properties": {
"name": {
"$ref": "#/$defs/Name"
},
"parameters": {
"type": "array",
"items": {
"$ref": "#/$defs/Parameter"
}
},
"return_type": {
"$ref": "#/$defs/Name"
},
"body": {
"$ref": "#/$defs/Block"
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"name",
"parameters",
"return_type",
"body",
"span"
],
"additionalProperties": false
},
"Parameter": {
"type": "object",
"properties": {
"name": {
"$ref": "#/$defs/Name"
},
"type_name": {
"$ref": "#/$defs/Name"
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"name",
"type_name",
"span"
],
"additionalProperties": false
},
"Block": {
"type": "object",
"properties": {
"statements": {
"type": "array",
"items": {
"$ref": "#/$defs/Stmt"
}
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"statements",
"span"
],
"additionalProperties": false
},
"Stmt": {
"type": "object",
"properties": {
"kind": {
"$ref": "#/$defs/StmtKind"
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"kind",
"span"
],
"additionalProperties": false
},
"StmtKind": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"const": "Binding"
},
"data": {
"$ref": "#/$defs/Binding"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Return"
},
"data": {
"$ref": "#/$defs/ReturnStatement"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Expression"
},
"data": {
"$ref": "#/$defs/Expr"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Declaration"
},
"data": {
"$ref": "#/$defs/Decl"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
}
]
},
"Binding": {
"type": "object",
"properties": {
"name": {
"$ref": "#/$defs/Name"
},
"value": {
"$ref": "#/$defs/Expr"
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"name",
"value",
"span"
],
"additionalProperties": false
},
"ReturnStatement": {
"type": "object",
"properties": {
"value": {
"anyOf": [
{
"$ref": "#/$defs/Expr"
},
{
"type": "null"
}
]
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"span"
],
"additionalProperties": false
},
"InteractiveInput": {
"type": "object",
"properties": {
"statements": {
"type": "array",
"items": {
"$ref": "#/$defs/Stmt"
}
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"statements",
"span"
],
"additionalProperties": false
},
"Expr": {
"type": "object",
"properties": {
"kind": {
"$ref": "#/$defs/ExprKind"
},
"span": {
"$ref": "#/$defs/Span"
}
},
"required": [
"kind",
"span"
],
"additionalProperties": false
},
"ExprKind": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"const": "Name"
},
"data": {
"type": "string"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Number"
},
"data": {
"type": "string"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "String"
},
"data": {
"type": "string"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Symbol"
},
"data": {
"$ref": "#/$defs/Name"
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Unary"
},
"data": {
"type": "object",
"properties": {
"operation": {
"$ref": "#/$defs/UnaryOp"
},
"operand": {
"$ref": "#/$defs/Expr"
}
},
"required": [
"operation",
"operand"
],
"additionalProperties": false
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Binary"
},
"data": {
"type": "object",
"properties": {
"operation": {
"$ref": "#/$defs/BinaryOp"
},
"left": {
"$ref": "#/$defs/Expr"
},
"right": {
"$ref": "#/$defs/Expr"
}
},
"required": [
"operation",
"left",
"right"
],
"additionalProperties": false
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Member"
},
"data": {
"type": "object",
"properties": {
"object": {
"$ref": "#/$defs/Expr"
},
"name": {
"$ref": "#/$defs/Name"
}
},
"required": [
"object",
"name"
],
"additionalProperties": false
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"const": "Call"
},
"data": {
"type": "object",
"properties": {
"callee": {
"$ref": "#/$defs/Expr"
},
"arguments": {
"type": "array",
"items": {
"$ref": "#/$defs/Expr"
}
}
},
"required": [
"callee",
"arguments"
],
"additionalProperties": false
}
},
"required": [
"kind",
"data"
],
"additionalProperties": false
}
]
},
"UnaryOp": {
"enum": [
"Negate"
]
},
"BinaryOp": {
"enum": [
"Add",
"Subtract",
"Multiply",
"Divide"
]
}
}
}
+183
View File
@@ -0,0 +1,183 @@
// Generated by scripts/generate_ast.py from Endor.asdl. Do not edit.
export const AST_SCHEMA_ID = "urn:endor:ast:sha256:c0da1a2640ad85f2c8e8159a10756e649d3aab179823a7cd890d9ebbb7f5d46e" as const;
export interface Span { start: number; end: number; }
export type AstDocument = { schema: typeof AST_SCHEMA_ID; root: AstRoot; };
export type AstRoot = { kind: "Module"; data: Program; } | { kind: "Expression"; data: Expr; } | { kind: "Interactive"; data: InteractiveInput; };
export type Name = { text: string; span: Span; };
export type Program = { declarations: Array<Decl>; span: Span; };
export type Decl = { kind: DeclKind; span: Span; };
export type DeclKind = { kind: "Function"; data: Function; };
export type Function = { name: Name; parameters: Array<Parameter>; return_type: Name; body: Block; span: Span; };
export type Parameter = { name: Name; type_name: Name; span: Span; };
export type Block = { statements: Array<Stmt>; span: Span; };
export type Stmt = { kind: StmtKind; span: Span; };
export type StmtKind = { kind: "Binding"; data: Binding; } | { kind: "Return"; data: ReturnStatement; } | { kind: "Expression"; data: Expr; } | { kind: "Declaration"; data: Decl; };
export type Binding = { name: Name; value: Expr; span: Span; };
export type ReturnStatement = { value?: Expr | null; span: Span; };
export type InteractiveInput = { statements: Array<Stmt>; span: Span; };
export type Expr = { kind: ExprKind; span: Span; };
export type ExprKind = { kind: "Name"; data: string; } | { kind: "Number"; data: string; } | { kind: "String"; data: string; } | { kind: "Symbol"; data: Name; } | { kind: "Unary"; data: { operation: UnaryOp; operand: Expr; }; } | { kind: "Binary"; data: { operation: BinaryOp; left: Expr; right: Expr; }; } | { kind: "Member"; data: { object: Expr; name: Name; }; } | { kind: "Call"; data: { callee: Expr; arguments: Array<Expr>; }; };
export type UnaryOp = "Negate";
export type BinaryOp = "Add" | "Subtract" | "Multiply" | "Divide";
export interface Visitor {
visitSpan?(node: Span): boolean | void;
visitAstDocument?(node: AstDocument): boolean | void;
visitAstRoot?(node: AstRoot): boolean | void;
visitName?(node: Name): boolean | void;
visitProgram?(node: Program): boolean | void;
visitDecl?(node: Decl): boolean | void;
visitDeclKind?(node: DeclKind): boolean | void;
visitFunction?(node: Function): boolean | void;
visitParameter?(node: Parameter): boolean | void;
visitBlock?(node: Block): boolean | void;
visitStmt?(node: Stmt): boolean | void;
visitStmtKind?(node: StmtKind): boolean | void;
visitBinding?(node: Binding): boolean | void;
visitReturnStatement?(node: ReturnStatement): boolean | void;
visitInteractiveInput?(node: InteractiveInput): boolean | void;
visitExpr?(node: Expr): boolean | void;
visitExprKind?(node: ExprKind): boolean | void;
visitUnaryOp?(node: UnaryOp): boolean | void;
visitBinaryOp?(node: BinaryOp): boolean | void;
}
export function walkSpan(node: Span, visitor: Visitor): void { visitor.visitSpan?.(node); }
export function walkAstDocument(node: AstDocument, visitor: Visitor): void {
if (visitor.visitAstDocument?.(node) === false) return;
walkAstRoot(node.root, visitor);
}
export function walkAstRoot(node: AstRoot, visitor: Visitor): void {
if (visitor.visitAstRoot?.(node) === false) return;
switch (node.kind) {
case "Module":
walkProgram(node.data, visitor);
break;
case "Expression":
walkExpr(node.data, visitor);
break;
case "Interactive":
walkInteractiveInput(node.data, visitor);
break;
}
}
export function walkName(node: Name, visitor: Visitor): void {
if (visitor.visitName?.(node) === false) return;
walkSpan(node.span, visitor);
}
export function walkProgram(node: Program, visitor: Visitor): void {
if (visitor.visitProgram?.(node) === false) return;
for (const value of node.declarations) walkDecl(value, visitor);
walkSpan(node.span, visitor);
}
export function walkDecl(node: Decl, visitor: Visitor): void {
if (visitor.visitDecl?.(node) === false) return;
walkDeclKind(node.kind, visitor);
walkSpan(node.span, visitor);
}
export function walkDeclKind(node: DeclKind, visitor: Visitor): void {
if (visitor.visitDeclKind?.(node) === false) return;
switch (node.kind) {
case "Function":
walkFunction(node.data, visitor);
break;
}
}
export function walkFunction(node: Function, visitor: Visitor): void {
if (visitor.visitFunction?.(node) === false) return;
walkName(node.name, visitor);
for (const value of node.parameters) walkParameter(value, visitor);
walkName(node.return_type, visitor);
walkBlock(node.body, visitor);
walkSpan(node.span, visitor);
}
export function walkParameter(node: Parameter, visitor: Visitor): void {
if (visitor.visitParameter?.(node) === false) return;
walkName(node.name, visitor);
walkName(node.type_name, visitor);
walkSpan(node.span, visitor);
}
export function walkBlock(node: Block, visitor: Visitor): void {
if (visitor.visitBlock?.(node) === false) return;
for (const value of node.statements) walkStmt(value, visitor);
walkSpan(node.span, visitor);
}
export function walkStmt(node: Stmt, visitor: Visitor): void {
if (visitor.visitStmt?.(node) === false) return;
walkStmtKind(node.kind, visitor);
walkSpan(node.span, visitor);
}
export function walkStmtKind(node: StmtKind, visitor: Visitor): void {
if (visitor.visitStmtKind?.(node) === false) return;
switch (node.kind) {
case "Binding":
walkBinding(node.data, visitor);
break;
case "Return":
walkReturnStatement(node.data, visitor);
break;
case "Expression":
walkExpr(node.data, visitor);
break;
case "Declaration":
walkDecl(node.data, visitor);
break;
}
}
export function walkBinding(node: Binding, visitor: Visitor): void {
if (visitor.visitBinding?.(node) === false) return;
walkName(node.name, visitor);
walkExpr(node.value, visitor);
walkSpan(node.span, visitor);
}
export function walkReturnStatement(node: ReturnStatement, visitor: Visitor): void {
if (visitor.visitReturnStatement?.(node) === false) return;
if (node.value != null) walkExpr(node.value, visitor);
walkSpan(node.span, visitor);
}
export function walkInteractiveInput(node: InteractiveInput, visitor: Visitor): void {
if (visitor.visitInteractiveInput?.(node) === false) return;
for (const value of node.statements) walkStmt(value, visitor);
walkSpan(node.span, visitor);
}
export function walkExpr(node: Expr, visitor: Visitor): void {
if (visitor.visitExpr?.(node) === false) return;
walkExprKind(node.kind, visitor);
walkSpan(node.span, visitor);
}
export function walkExprKind(node: ExprKind, visitor: Visitor): void {
if (visitor.visitExprKind?.(node) === false) return;
switch (node.kind) {
case "Name":
break;
case "Number":
break;
case "String":
break;
case "Symbol":
walkName(node.data, visitor);
break;
case "Unary":
walkUnaryOp(node.data.operation, visitor);
walkExpr(node.data.operand, visitor);
break;
case "Binary":
walkBinaryOp(node.data.operation, visitor);
walkExpr(node.data.left, visitor);
walkExpr(node.data.right, visitor);
break;
case "Member":
walkExpr(node.data.object, visitor);
walkName(node.data.name, visitor);
break;
case "Call":
walkExpr(node.data.callee, visitor);
for (const value of node.data.arguments) walkExpr(value, visitor);
break;
}
}
export function walkUnaryOp(node: UnaryOp, visitor: Visitor): void {
if (visitor.visitUnaryOp?.(node) === false) return;
}
export function walkBinaryOp(node: BinaryOp, visitor: Visitor): void {
if (visitor.visitBinaryOp?.(node) === false) return;
}