docs: define interpreted runtime and typed resource presentation
This commit is contained in:
@@ -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