docs: define interpreted runtime and typed resource presentation
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
|
||||
| 领域 | 语言中的内容 | 参考章节 |
|
||||
| --- | --- | --- |
|
||||
| UI | 场景、渲染树、组件及展示效果 | [场景与渲染树](../guide/11-scenes-and-render-trees.md)、[UI 组件](../guide/12-ui-components.md) |
|
||||
| UI | 函数返回的可渲染值、组件及展示效果 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md)、[UI 组件](../guide/12-ui-components.md) |
|
||||
| 业务逻辑 | 函数、结果、调用组合及业务效果 | [函数与调用](../guide/09-functions-and-calls.md) |
|
||||
| 数据结构与访问 | class、共享类型、读取与字段使用 | [类型与类](../guide/07-types-and-classes.md)、[数据读取](../guide/10-data-access.md) |
|
||||
| Agent | 后续的能力、上下文、任务及行为模型 | [规范状态](specification-status.md#agent) |
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
|
||||
源码文件不作为代码身份或 module 边界。本书中的 Markdown 文件是文档章节,不对应语言中的源码组织单位。
|
||||
|
||||
代码段的具体语法粒度尚未定义,不能将一个场景、一条声明或一个 S3 对象直接规定为同一种单位。
|
||||
代码段的具体语法粒度尚未定义,不能将一条声明或一个 S3 对象直接规定为同一种单位。
|
||||
|
||||
## 索引与视图
|
||||
|
||||
@@ -31,8 +31,8 @@ S3 对象键不是语言中的 namespace key。bucket 名、对象键和存储
|
||||
|
||||
## namespace 制
|
||||
|
||||
namespace 同时表达归属与查找位置,使业务函数、类型、场景和后续 Agent 代码遵循一致的组织模型。第一级与后续层级具有相同语义。
|
||||
namespace 同时表达归属与查找位置,使业务函数、类型、界面逻辑和后续 Agent 代码遵循一致的组织模型。第一级与后续层级具有相同语义。
|
||||
|
||||
这一组织选择不自动决定构建边界、执行位置、权限继承或业务数据存储。相关语义需要由各自规则定义,而不是从 S3 物理布局推导。
|
||||
这一组织选择不自动决定检查边界、执行位置、权限继承或业务数据存储。相关语义需要由各自规则定义,而不是从 S3 物理布局推导。
|
||||
|
||||
[相关章节:namespace](../guide/03-namespaces.md) · [目录](../README.md)
|
||||
|
||||
@@ -21,7 +21,7 @@
|
||||
|
||||
```ebnf
|
||||
program = { use-decl }, declaration, { declaration }, EOF ;
|
||||
declaration = class-decl | function-decl | scene-decl ;
|
||||
declaration = class-decl | function-decl ;
|
||||
|
||||
use-decl = "use", namespace-key ;
|
||||
namespace-key = user-handle, ":", namespace-path ;
|
||||
@@ -82,21 +82,13 @@ primary = identifier | string | number | symbol
|
||||
|
||||
相关说明:[表达式与绑定](../guide/08-expressions-and-bindings.md)、[数据读取](../guide/10-data-access.md)。
|
||||
|
||||
## 场景与渲染节点
|
||||
## 界面值与资源访问
|
||||
|
||||
```ebnf
|
||||
scene-decl = "export", "scene", identifier, "{", render-decl, "}" ;
|
||||
render-decl = "render", "{", node, "}" ;
|
||||
界面使用普通函数返回可渲染值表达,不增加 scene 声明、render 块或独立节点文法。顶级类型、界面值构造、组件参数及子节点组合的形式尚未定义,因此本附录不补写相应产生式,也不规定单根结构。
|
||||
|
||||
node = identifier, [ arguments ], [ children ] ;
|
||||
arguments = "(", [ argument, { ",", argument } ], ")" ;
|
||||
argument = [ identifier, ":" ], expression ;
|
||||
children = "{", { node }, "}" ;
|
||||
```
|
||||
客户端访问与呈现是资源处理行为,不增加源码中的函数声明形式。访问定位和函数类型表达的具体写法待定,见[规范状态](specification-status.md#资源访问与呈现)。
|
||||
|
||||
render 内单根结构由产生式表达。组件是否接受子节点、参数是否合法以及 render 内可使用哪些表达式效果,属于语义规则。
|
||||
|
||||
相关说明:[场景与渲染树](../guide/11-scenes-and-render-trees.md)、[UI 组件](../guide/12-ui-components.md)。
|
||||
相关说明:[资源访问与呈现](../guide/11-resource-access-and-presentation.md)、[UI 组件](../guide/12-ui-components.md)。
|
||||
|
||||
## 词法
|
||||
|
||||
|
||||
@@ -12,16 +12,19 @@
|
||||
| 代码段 | 独立存储、具有明确归属的代码内容单位 | [代码存储与视图](code-storage-and-views.md) |
|
||||
| 可见代码视图 | 由索引成员关系获得的 namespace 逻辑代码集合 | [代码存储与视图](code-storage-and-views.md) |
|
||||
| use | 引用完整 namespace key 的声明 | [程序结构与导入](../guide/04-program-structure.md) |
|
||||
| Preflight | 理解、检查和准备程序的构建阶段 | [Preflight 与 inflight](../guide/05-preflight-and-inflight.md) |
|
||||
| Preflight | 理解声明、检查程序并建立关联索引的执行准备阶段 | [Preflight 与 inflight](../guide/05-preflight-and-inflight.md) |
|
||||
| inflight | 使用实际输入执行逻辑并产生可观察结果的运行阶段 | [Preflight 与 inflight](../guide/05-preflight-and-inflight.md) |
|
||||
| 类型 | 描述值的结构及其允许用法的定义 | [类型与类](../guide/07-types-and-classes.md) |
|
||||
| 类型身份 | 由具体类型声明确定的身份;成员相同不自动使不同声明兼容 | [类型身份与兼容](../guide/07-types-and-classes.md#76-类型身份与兼容) |
|
||||
| class | 数据结构声明 | [类型与类](../guide/07-types-and-classes.md) |
|
||||
| 表达式 | 描述计算并产生值的源码形式 | [表达式与绑定](../guide/08-expressions-and-bindings.md) |
|
||||
| 绑定 | 将表达式结果关联到局部名称 | [表达式与绑定](../guide/08-expressions-and-bindings.md) |
|
||||
| 函数 | 定义输入、结果和执行逻辑的可调用声明 | [函数与调用](../guide/09-functions-and-calls.md) |
|
||||
| 数据依赖 | 后续计算需要前一计算结果的关系 | [函数与调用](../guide/09-functions-and-calls.md) |
|
||||
| 场景 / scene | 描述一个 UI 视图的声明 | [场景与渲染树](../guide/11-scenes-and-render-trees.md) |
|
||||
| 渲染树 | render 块内由组件节点组成的树 | [场景与渲染树](../guide/11-scenes-and-render-trees.md) |
|
||||
| 资源访问 | 定位并查看 namespace、声明或结果,或在输入就绪后发起调用的客户端行为 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md) |
|
||||
| 按类型呈现 | 客户端依据当前资源或结果的类型选择处理方式;顶级类型及契约待定 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md) |
|
||||
| 可渲染值 | 可由客户端作为界面呈现的结果值;正式类型及构造形式待定 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md) |
|
||||
| hook | 关联触发或订阅及持续更新的关系;源码形式和生命周期边界待定 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md) |
|
||||
| 符号字面量 | 以点号和标识符表达的命名值,如 `.title` | [词法结构](../guide/06-lexical-structure.md) |
|
||||
|
||||
[目录](../README.md)
|
||||
|
||||
@@ -14,9 +14,15 @@
|
||||
| use | 引用完整 namespace,不附加选择性名称列表 |
|
||||
| 代码组织 | 独立代码段存储在 S3,由索引组装可见代码视图,不采用源码文件 module 制 |
|
||||
| 数据结构目标 | 用 class 表达共享结构,通过类取得数据的具体形式另行定义 |
|
||||
| 类型兼容 | 用户声明的类型按声明身份区分,不仅凭字段或方法相同建立兼容或能力实现关系;不采用结构类型兼容 |
|
||||
| 调用目标 | 普通逻辑调用表达输入、结果与依赖,系统组织执行 |
|
||||
| 官方组件 | 官方 UI 组件与用户库内容分别定义 |
|
||||
| 阶段命名 | 构建阶段为 Preflight,运行阶段为 inflight;名称本身不增加源码关键字 |
|
||||
| 阶段命名 | 执行准备与检查阶段为 Preflight,运行阶段为 inflight;名称本身不增加源码关键字 |
|
||||
| 执行方向 | 平台解释执行代码,不要求独立构建步骤或字节码转译;Preflight 检查并建立关联索引 |
|
||||
| 界面表达 | 普通函数返回可渲染值表达界面,不采用独立 scene 声明或 render 块 |
|
||||
| 资源访问 | 客户端可查看获准访问的资源,依据当前资源或调用结果的类型选择呈现方式 |
|
||||
| 函数查看与调用 | 必填参数未就绪时查看函数本身;输入满足调用要求后可调用并呈现结果;执行等待不退回为定义查看 |
|
||||
| 跨端使用 | 函数调用与 hook 关联由平台组织执行和通信,应用直接使用符合声明类型的结果与更新 |
|
||||
|
||||
## 收录的语法提案
|
||||
|
||||
@@ -27,7 +33,7 @@
|
||||
| 表达式与 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、参数、布局与默认值 |
|
||||
| 组件效果 | [第 12 章](../guide/12-ui-components.md) | 参数、布局与默认值的效果提案;构造表达式尚未定义 |
|
||||
|
||||
程序声明组合与[形式文法](formal-grammar.md)同样属于设计稿。正文中的陈述定义这些提案内部的用法,不将其确定程度提升为最终规范。
|
||||
|
||||
@@ -57,9 +63,12 @@
|
||||
|
||||
尚未定义:
|
||||
|
||||
- 程序入口、空代码视图、多个场景的选择与顶层绑定。
|
||||
- 程序入口、空代码视图、客户端访问所用的定位形式与顶层绑定。
|
||||
- 函数本身的完整类型表达、值形式与查看信息范围。
|
||||
- 完整基础类型、数值范围、可选值、泛型及类型转换。
|
||||
- 类构造、方法、默认值、继承和字段可见性。
|
||||
- 显式能力实现、类型兼容与转换关系的声明形式,以及类型推断规则。
|
||||
- 代码更新和不同版本之间的类型身份比较规则。
|
||||
- 重复声明、完整控制流、可变性、赋值和作用域细节。
|
||||
|
||||
本文简单函数体仅收录 let 与末尾 return,不意味着整门语言只允许这两种语句。
|
||||
@@ -81,6 +90,7 @@
|
||||
- 显式等待、失败处理、缺失值、取消和超时的源码形式。
|
||||
- 数据读取成员的声明、参数与结果类型。
|
||||
- 一次结果、持续结果及其更新语义。
|
||||
- hook 的源码形式、触发或订阅关系、生命周期、关联解除和更新范围。
|
||||
- 带业务修改的调用顺序、重复执行限制与失败行为。
|
||||
- 更新代码时已有调用使用哪个版本。
|
||||
|
||||
@@ -91,12 +101,29 @@
|
||||
尚未定义:
|
||||
|
||||
- 官方组件库的 key、显式引用形式与名称可见性。
|
||||
- 命名参数和位置参数的完整绑定规则及重复传参处理。
|
||||
- 渲染中的调用、状态、数据绑定、事件与更新。
|
||||
- 普通表达式中构造界面值的形式、参数传入方式及子节点组合。
|
||||
- 界面结果的根结构、集合形式和类型约束;不沿用 render 单根文法。
|
||||
- 界面计算中的调用、状态、数据绑定、事件与更新。
|
||||
- 布局单位、参数范围、负数、显式尺寸、约束与溢出。
|
||||
- 主题、样式、文字测量和其他组件。
|
||||
|
||||
正文的官方组件示例省略未定义的依赖部分,不承诺免导入使用。
|
||||
正文的官方组件示例使用结构示意,不定义调用语法,也不承诺免导入使用。
|
||||
|
||||
## 资源访问与呈现
|
||||
|
||||
资源定位、函数本身与调用结果的区别,以及参数就绪和执行等待的边界,主要定义见[资源访问与呈现](../guide/11-resource-access-and-presentation.md)。
|
||||
|
||||
保留待讨论:
|
||||
|
||||
- 顶级类型的名称、集合,以及界面、数据、代码与媒体的类别边界。
|
||||
- 顶级类型采用继承、接口、协议或其他机制的关系与声明形式。
|
||||
- 可渲染类型的契约、普通类型的默认展示方式及自定义呈现。
|
||||
- 同一资源具有多种呈现能力时的选择规则及未知类型的处理方式。
|
||||
- 参数填写、默认或可省略参数、平台提供参数与访问触发调用的具体规则。
|
||||
- 资源查看、显式调用、可执行入口与具有业务修改效果的操作之间的界限。
|
||||
- 图片、字体等资源的标识、归属与类型约定。
|
||||
|
||||
顶级类型尚未纳入基础类型表或形式文法;其定义待定不影响已确定的访问与结果呈现方向。
|
||||
|
||||
## Agent
|
||||
|
||||
@@ -106,6 +133,6 @@ Agent 是规划应用领域。声明、能力、工具、上下文、任务、
|
||||
|
||||
本文定义源码及应有的语言效果。云端实体、持久化类、自动建表、通信、缓存、部署和编排实现不在本阶段规范中。
|
||||
|
||||
S3 约定仅用于代码存储,不规定业务数据后端。Preflight 与 inflight 的职责不要求特定机器码、执行图或部署产物。
|
||||
S3 约定仅用于代码存储,不规定业务数据后端。平台负责跨端执行与通信的约定不指定传输协议、类型编码、调度算法或部署产物。
|
||||
|
||||
[目录](../README.md)
|
||||
|
||||
Reference in New Issue
Block a user