438 lines
18 KiB
Rust
438 lines
18 KiB
Rust
// Generated by scripts/generate_ast.py from Endor.asdl. Do not edit.
|
||
|
||
use super::Spanned;
|
||
use crate::Span;
|
||
/// wire/编辑器核对的协议身份，来自 ASDL 原文哈希；生成节点注释不参与此值。
|
||
pub const AST_SCHEMA_ID: &str =
|
||
"urn:endor:ast:sha256:21b0349ac295d9bc8cedcad8f07d8e2d45cf220e19e7c2fad10269555fcfd71a";
|
||
/// 宿主/编辑器传输的版本化语法文档，wire 校验后供 compiler 使用。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct AstDocument {
|
||
/// 协议身份，wire 按 AST_SCHEMA_ID 核对；不是源码内容哈希。
|
||
pub schema: String,
|
||
/// 拥有的语法根，文档校验及编译从这里递归。
|
||
pub root: AstRoot,
|
||
}
|
||
/// parse_ast 按模式构造的模块、表达式或交互根，compiler 据此选择生成入口。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(tag = "kind", content = "data", deny_unknown_fields)]
|
||
pub enum AstRoot {
|
||
/// 模块根，包含函数/类声明。
|
||
Module(Program),
|
||
/// 表达式根，编译后直接返回求值结果。
|
||
Expression(Expr),
|
||
/// 交互根，包含一次完整提交。
|
||
Interactive(InteractiveInput),
|
||
}
|
||
impl Spanned for AstRoot {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
// 按实际构造器取得唯一可定位子节点的范围。
|
||
match self {
|
||
Self::Module(node) => node.span(),
|
||
Self::Expression(node) => node.span(),
|
||
Self::Interactive(node) => node.span(),
|
||
}
|
||
}
|
||
}
|
||
/// parser 复制的名称文本与位置，用于声明、类型注解或属性名。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Name {
|
||
/// 拥有名称文本，不依赖输入缓冲存活。
|
||
pub text: String,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Name {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 模块声明序列，compiler 先注册全部顶层名称再分析各函数体。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Program {
|
||
/// 按源码顺序的声明；源码模块解析要求非空，文档结构本身不限制数量。
|
||
pub declarations: Vec<Decl>,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Program {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 顶层/交互声明的种类及完整范围，compiler 按函数或类分派。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Decl {
|
||
/// 函数/类声明载荷，JSON 和类型采用 kind/data 标签。
|
||
pub kind: DeclKind,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Decl {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 函数与类声明的判别载荷，外层 Decl 另外保存完整跨度。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(tag = "kind", content = "data", deny_unknown_fields)]
|
||
pub enum DeclKind {
|
||
/// 显式参数/返回注解与函数体，compiler 生成独立模板及源码签名；解析本身不调用函数。
|
||
Function(Function),
|
||
/// 类名、可选基类、字段和方法，compiler 检查成员后生成构类指令。
|
||
Class(Class),
|
||
}
|
||
impl Spanned for DeclKind {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
// 按实际构造器取得唯一可定位子节点的范围。
|
||
match self {
|
||
Self::Function(node) => node.span(),
|
||
Self::Class(node) => node.span(),
|
||
}
|
||
}
|
||
}
|
||
/// 类名、可选基类、字段和方法，compiler 检查成员后生成构类指令。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Class {
|
||
/// 类声明名与精确位置。
|
||
pub name: Name,
|
||
/// 显式基类名，可省略；当前 compiler 对省略项使用 Object。
|
||
pub base: Option<Name>,
|
||
/// 按出现顺序的字段名称/类型注解，不含方法。
|
||
pub fields: Vec<Parameter>,
|
||
/// 按出现顺序的方法；显式 self 约束由 compiler 检查。
|
||
pub methods: Vec<Function>,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Class {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 显式参数/返回注解与函数体，compiler 生成独立模板及源码签名；解析本身不调用函数。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Function {
|
||
/// 函数/方法名，代码模板沿用为诊断名称。
|
||
pub name: Name,
|
||
/// 位置参数列表，compiler 依次分配前部局部槽。
|
||
pub parameters: Vec<Parameter>,
|
||
/// 返回类型名，生成源码签名后由运行时解析。
|
||
pub return_type: Name,
|
||
/// 独立函数作用域的语句体，当前源码不支持嵌套声明闭包。
|
||
pub body: Block,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Function {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 函数参数或类字段共用的名称/类型注解，实际类型身份由运行时环境解析。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Parameter {
|
||
/// 参数/字段名，用于布局和重复检查。
|
||
pub name: Name,
|
||
/// 声明类型名，前端只保留文本与位置。
|
||
pub type_name: Name,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Parameter {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 顺序语句块，compiler 检查确定初始化并按语句生成指令。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Block {
|
||
/// 有序语句列表，不引入独立块级局部作用域。
|
||
pub statements: Vec<Stmt>,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Block {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 语句种类及原文范围，compiler 处理副作用、控制流或返回。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Stmt {
|
||
/// 具体语句载荷，外层另存整句范围。
|
||
pub kind: StmtKind,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Stmt {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 语句判别载荷，parser 选择分支，compiler 按绑定、赋值、控制流等规则处理。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(tag = "kind", content = "data", deny_unknown_fields)]
|
||
pub enum StmtKind {
|
||
/// let 新绑定，compiler 检查重名并分析右值后才标记目标已初始化。
|
||
Binding(Binding),
|
||
/// 普通名称赋值，compiler 按作用域写局部槽或全局环境。
|
||
Assignment(Assignment),
|
||
/// 成员写入的对象、属性名与右值，compiler 生成 StoreAttr。
|
||
MemberAssignment(MemberAssignment),
|
||
/// 条件、then 和可选 else，compiler 合并继续路径的初始化集合并生成跳转。
|
||
If(IfStatement),
|
||
/// 循环条件与体，compiler 生成回边并处理循环可能零次执行。
|
||
While(WhileStatement),
|
||
/// 函数返回，compiler 对缺省值补 Nil；当前源码语法要求 return 后有表达式。
|
||
Return(ReturnStatement),
|
||
/// 表达式载荷及完整范围，compiler 生成留下一个结果的求值序列。
|
||
Expression(Expr),
|
||
/// 顶层/交互声明的种类及完整范围，compiler 按函数或类分派。
|
||
Declaration(Decl),
|
||
}
|
||
impl Spanned for StmtKind {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
// 按实际构造器取得唯一可定位子节点的范围。
|
||
match self {
|
||
Self::Binding(node) => node.span(),
|
||
Self::Assignment(node) => node.span(),
|
||
Self::MemberAssignment(node) => node.span(),
|
||
Self::If(node) => node.span(),
|
||
Self::While(node) => node.span(),
|
||
Self::Return(node) => node.span(),
|
||
Self::Expression(node) => node.span(),
|
||
Self::Declaration(node) => node.span(),
|
||
}
|
||
}
|
||
}
|
||
/// let 新绑定，compiler 检查重名并分析右值后才标记目标已初始化。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Binding {
|
||
/// let 目标名，重复声明由语义分析拒绝。
|
||
pub name: Name,
|
||
/// 绑定右值，本局部不能在初始化前读取自身。
|
||
pub value: Expr,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Binding {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 普通名称赋值，compiler 按作用域写局部槽或全局环境。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Assignment {
|
||
/// 普通赋值目标，函数内首次赋值可预分配局部槽。
|
||
pub name: Name,
|
||
/// 先求右值再更新目标。
|
||
pub value: Expr,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Assignment {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 成员写入的对象、属性名与右值，compiler 生成 StoreAttr。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct MemberAssignment {
|
||
/// 属性写入接收对象表达式，前端不求值。
|
||
pub object: Expr,
|
||
/// 待写属性名，compiler 加入名字表。
|
||
pub name: Name,
|
||
/// 待写右值，当前 compiler 先于接收对象生成求值以匹配 VM 栈布局。
|
||
pub value: Expr,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for MemberAssignment {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 条件、then 和可选 else，compiler 合并继续路径的初始化集合并生成跳转。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct IfStatement {
|
||
/// 条件表达式，运行时按真值协议选择分支。
|
||
pub condition: Expr,
|
||
/// 条件为真的 then 块。
|
||
pub body: Block,
|
||
/// 可选 else 块，缺省时存在直接继续路径。
|
||
pub otherwise: Option<Block>,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for IfStatement {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 循环条件与体，compiler 生成回边并处理循环可能零次执行。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct WhileStatement {
|
||
/// 每轮重新求值的条件，假值退出。
|
||
pub condition: Expr,
|
||
/// 循环体，可能一次也不执行。
|
||
pub body: Block,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for WhileStatement {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 函数返回，compiler 对缺省值补 Nil；当前源码语法要求 return 后有表达式。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct ReturnStatement {
|
||
/// 可选返回表达式，手工 AST 缺省时由 compiler 补 Nil。
|
||
pub value: Option<Expr>,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for ReturnStatement {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 单次交互提交容器，parser 产生一条语句，compiler 也检查数量，不保存宿主会话环境。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct InteractiveInput {
|
||
/// 当前 parse/compile 约定恰好一个完整提交的语句。
|
||
pub statements: Vec<Stmt>,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for InteractiveInput {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 表达式载荷及完整范围，compiler 生成留下一个结果的求值序列。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(deny_unknown_fields)]
|
||
pub struct Expr {
|
||
/// 求值形状，不缓存名称解析或运行时类型。
|
||
pub kind: ExprKind,
|
||
/// 原始 UTF-8 文本的半开字节范围，定位与父子范围校验共用；不是字符列。
|
||
pub span: Span,
|
||
}
|
||
impl Spanned for Expr {
|
||
/// 原文切片、定位和 Visitor 节点钩子调用，返回存储范围或被包装节点的范围。
|
||
fn span(&self) -> Span {
|
||
self.span
|
||
}
|
||
}
|
||
/// 名称、字面量、等待、运算和调用等表达式载荷，范围由外层 Expr 提供。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
|
||
#[serde(tag = "kind", content = "data", deny_unknown_fields)]
|
||
pub enum ExprKind {
|
||
/// 变量引用文本，compiler 决定局部槽或全局索引。
|
||
Name(String),
|
||
/// 原始十进制拼写，保留全部位数、前导零及尾零，不转浮点。
|
||
Number(String),
|
||
/// 已解码受支持转义的拥有文本，原引号范围在外层 Expr。
|
||
String(String),
|
||
/// 点开头的符号名，前端可表示，当前 compiler 拒绝生成运行时值。
|
||
Symbol(Name),
|
||
/// 等待子表达式，VM 执行上下文决定是否允许停放。
|
||
Await(Box<Expr>),
|
||
/// 一元取负，可在纯数值链上合并符号。
|
||
Unary {
|
||
/// 运算种类，决定算术、比较或取负指令。
|
||
operation: UnaryOp,
|
||
/// 一元子表达式，Rust 的递归回边间接存储。
|
||
operand: Box<Expr>,
|
||
},
|
||
/// 左右操作数及算术/比较种类，保留解析优先级树。
|
||
Binary {
|
||
/// 运算种类，决定算术、比较或取负指令。
|
||
operation: BinaryOp,
|
||
/// 二元左操作数，当前 compiler 先于右侧求值。
|
||
left: Box<Expr>,
|
||
/// 二元右操作数，与左侧一起被运行时运算消费。
|
||
right: Box<Expr>,
|
||
},
|
||
/// 接收对象及属性名的读取。
|
||
Member {
|
||
/// 成员读取接收对象。
|
||
object: Box<Expr>,
|
||
/// 成员或符号名，不是已解析的运行时属性句柄。
|
||
name: Name,
|
||
},
|
||
/// 被调用表达式与位置实参，由 VM 实际求值。
|
||
Call {
|
||
/// 调用目标，先于实参求值。
|
||
callee: Box<Expr>,
|
||
/// 有序位置实参，AST 不隐式添加接收者。
|
||
arguments: Vec<Expr>,
|
||
},
|
||
}
|
||
/// 一元运算种类，compiler 合并纯数值负号或生成运行时取负。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize, Copy)]
|
||
pub enum UnaryOp {
|
||
/// 一元取负。
|
||
Negate,
|
||
}
|
||
/// 二元算术/比较种类，parser 保留优先级树，compiler 映射为对应 VM 操作。
|
||
#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize, Copy)]
|
||
pub enum BinaryOp {
|
||
/// 加法。
|
||
Add,
|
||
/// 减法。
|
||
Subtract,
|
||
/// 乘法。
|
||
Multiply,
|
||
/// 除法。
|
||
Divide,
|
||
/// 相等比较。
|
||
Equal,
|
||
/// 不等比较。
|
||
NotEqual,
|
||
/// 小于比较。
|
||
Less,
|
||
/// 小于等于比较。
|
||
LessEqual,
|
||
/// 大于比较。
|
||
Greater,
|
||
/// 大于等于比较。
|
||
GreaterEqual,
|
||
}
|