endorphin-aster-vm/crates/frontend

frontend

独立源码前端：EndorReader → SourceUnit → 手写 Rust lexer → token → rust-peg parser → 拥有文本的 AST。当前解析基础函数与表达式，不生成字节码、不进行类型／名称解析、不执行源码。语法是可继续调整的首版实现，当前契约见 源码前端。

内容	职责
Cargo.toml	frontend 包与 peg 0.8.6 依赖，不依赖 core、Host 或 Storage
src	阅读器、SourceUnit、token、源码范围、诊断、AST、词法；PEG 规则独立在 grammar.peg
tests	Unicode、优先级、函数、完整输入与错误位置验证
examples	可交给 cli parse 的源码样例

宿主通过 EndorReader 读取字符串、流、文件或注入的 URI provider，取得 SourceUnit 后调用 lex_source、parse_source、parse_source_expression；低层 lex、parse、parse_expression 仍保留。读取契约见 Endor 阅读器。Core 仍为零外部依赖；后续把 AST 转成已有字节码并交给 VM 解释执行；这是平台内部准备步骤，尚未接通。资源修订、依赖锁和解释器统一升级的设计方向见 执行与版本模型。返回 工作区。