# 规范状态 本附录记录语言设计的确定程度与尚未定义的边界。它用于理解设计稿，不代表软件实现进度或可执行性保证。 ## 已确定约定 | 主题 | 已确定内容 | | --- | --- | | 语言定位 | 前后端共用的云原生编程语言，UI 是应用领域之一 | | 代码归属 | 每段代码属于唯一用户名和至少一级 namespace | | 用户身份 | 使用唯一 handle 定位，不用显示名替代 | | namespace | 各层语义一致；以外部 key 检索，不在正文声明自身归属 | | key 形式 | `用户名:namespace路径`，冒号分隔用户与路径，点号分隔层级 | | use | 引用完整 namespace，不附加选择性名称列表 | | 代码组织 | 独立代码段存储在 S3，由索引组装可见代码视图，不采用源码文件 module 制 | | 数据结构目标 | 用 class 表达共享结构，通过类取得数据的具体形式另行定义 | | 调用目标 | 普通逻辑调用表达输入、结果与依赖，系统组织执行 | | 官方组件 | 官方 UI 组件与用户库内容分别定义 | | 阶段命名 | 构建阶段为 Preflight，运行阶段为 inflight；名称本身不增加源码关键字 | ## 收录的语法提案 | 提案 | 正文位置 | 说明 | | --- | --- | --- | | 词法与字面量 | [第 6 章](../guide/06-lexical-structure.md) | 本书统一采用的标识符、字符串、数字和符号形式 | | 类字段与类型标注 | [第 7 章](../guide/07-types-and-classes.md) | class 目标已确定，字段和类型体系仍为具体写法提案 | | 表达式与 let | [第 8 章](../guide/08-expressions-and-bindings.md) | 基础运算、成员访问与局部绑定 | | function 与 return | [第 9 章](../guide/09-functions-and-calls.md) | 函数签名、基本函数体与调用组合 | | Product.get | [第 10 章](../guide/10-data-access.md) | 读取体验提案，不是 class 自动附带的 API | | 场景与组件 | [第 11、12 章](../guide/11-scenes-and-render-trees.md) | scene、render、参数、布局与默认值 | 程序声明组合与[形式文法](formal-grammar.md)同样属于设计稿。正文中的陈述定义这些提案内部的用法，不将其确定程度提升为最终规范。 ## 身份与权限 尚未定义： - 用户名的字符、长度、大小写、Unicode 归一化及身份范围扩展。 - handle 改名、旧名称复用、历史引用稳定性及账号生命周期。 - 代码的默认公开性、读取与执行权限，以及 namespace 权限继承。 - 协作、Agent 委托、操作身份记录与归属转移。 定位信息不构成授权，是这些规则必须保留的边界。 ## 引用与代码视图 尚未定义： - 代码段的语法边界、视图成员范围和下级 namespace 的纳入方式。 - use 的作用范围、声明可见性、限定名、别名与同名冲突。 - 视图顺序、版本选择、成员一致性及编辑操作映射。 - key 的传递编码和索引关联机制。 正文跨 namespace 示例采用目标声明可见、名称可直接解析且无冲突的条件；该条件不代替正式名称查找规则。 ## 声明与类型 尚未定义： - 程序入口、空代码视图、多个场景的选择与顶层绑定。 - 完整基础类型、数值范围、可选值、泛型及类型转换。 - 类构造、方法、默认值、继承和字段可见性。 - 重复声明、完整控制流、可变性、赋值和作用域细节。 本文简单函数体仅收录 let 与末尾 return，不意味着整门语言只允许这两种语句。 ## 词法与表达式 尚未定义： - 完整保留字集合、Unicode 版本与字符类别边界。 - 换行字符、字符串扩展转义、更多字面量和运算符。 - 数值溢出、除法、隐式转换与所有调用参数的求值顺序。 正文中同级二元算术运算的组合顺序属于表达式提案，不规定所有调用的执行顺序。 ## 调用与数据 尚未定义： - 显式等待、失败处理、缺失值、取消和超时的源码形式。 - 数据读取成员的声明、参数与结果类型。 - 一次结果、持续结果及其更新语义。 - 带业务修改的调用顺序、重复执行限制与失败行为。 - 更新代码时已有调用使用哪个版本。 正常结果必须符合声明，未就绪或失败不能伪造为成功结果。Product.get 示例只展示成功路径。 ## UI 尚未定义： - 官方组件库的 key、显式引用形式与名称可见性。 - 命名参数和位置参数的完整绑定规则及重复传参处理。 - 渲染中的调用、状态、数据绑定、事件与更新。 - 布局单位、参数范围、负数、显式尺寸、约束与溢出。 - 主题、样式、文字测量和其他组件。 正文的官方组件示例省略未定义的依赖部分，不承诺免导入使用。 ## Agent Agent 是规划应用领域。声明、能力、工具、上下文、任务、生命周期、权限及模型驱动行为的边界尚未定义。 ## 规范范围 本文定义源码及应有的语言效果。云端实体、持久化类、自动建表、通信、缓存、部署和编排实现不在本阶段规范中。 S3 约定仅用于代码存储，不规定业务数据后端。Preflight 与 inflight 的职责不要求特定机器码、执行图或部署产物。 [目录](../README.md)