NodeSpec 单轨规范
1. 文档定位
本文档定义 ViewCompose 的节点语义边界：仅允许 NodeSpec，不再存在 Props 双轨。
目标：
- 保证渲染链路语义稳定、可推导、可测试
- 防止动态字段回流导致的 patch/skip 语义退化
- 为新增节点提供统一接入模板
历史阶段文档见：
2. 当前硬边界
VNode只包含非空spec: NodeSpec，不再包含props。UiTreeBuilder.emit/emitResolved必传spec，不再接受props参数。- renderer 主链路只允许读取
NodeSpec + ResolvedModifiers。 - 锚点等附加元数据必须通过 modifier 元素传递（如
Modifier.overlayAnchor(...)）。 - 禁止新增
Props/TypedPropKeys/PropKeys/node.props代码路径。
3. 语义分工
- 组件语义字段：进入
NodeSpec。 - 通用视觉与交互修饰：进入
Modifier。 - 主题默认值：由
Theme -> Defaults解析后注入NodeSpec/Modifier。
4. 值准入边界
NodeSpec 值会参与 VNode 相等判断、Patch 规划、子树跳过、诊断与失败渲染回滚。因此语义
payload 必须不可变、可按结构比较且平台无关。不能仅仅因为原生 View Setter 接受某个类型，
就把 Android Framework 对象或可变接口类型保存在规格中。
文本明确遵循这条规则：
TextNodeProps对纯文本与富文本都只保留一份权威TextDocument。ButtonNodeProps与ToggleNodeProps使用可空String标签。- Android
CharSequence、Spanned、Spannable与Editable只存在于 Renderer 互操作代码， 并在最终原生绑定或输入边界转换。
该分层可以避免可变 Span 与按身份比较的平台值导致未变化的 VNode 被误判为变化，或变化后的 值因错误原因被判定为相等。
5. 已解析 Surface 边界
NodeType.Surface 与 SurfaceNodeProps 配对，不再使用通用 BoxNodeProps。设计系统组件在
发射前解析 Brush、Shape、Border、有效尺寸、可选可见高度和裁剪策略。通用交互反馈通过有序
UiInteractionIndication Modifier 契约传递，而不是 Surface、Box 或 Row NodeSpec 字段。
Android Renderer 执行两类快照，不接收设计系统标识或语义 Token 角色。
通用调用方 Modifier 仍按顺序追加在已解析 Surface 之后。调用方 Background、Border、Corner 或 Shape 会替换组件提供的可见 Surface，并使用完整有效边界。Basic 组件可以通过普通有序 Modifier 契约提供精确 Shadow 与 Elevation，因为 Renderer 已经以通用方式执行它们。
只有当原生后端拥有单个外层 Modifier 无法寻址的多个内部目标时，组件 NodeSpec 才保留交互值。
因此 SegmentedControl 与 NavigationBar 携带完整的已选和未选 UiStateLayerColors；TabRow 则
发出 eager keyed 子 Box，并让每个子项拥有自己的 indication Modifier。
6. 新节点接入清单
新增第一方节点必须完成：
- 定义节点
NodeSpec。 - 使用不可变、可按结构比较且平台无关的语义字段。
- DSL 参数映射到
NodeSpec（必要时配合 modifier 元数据）。 - renderer binder/patch 对应实现。
- 单元测试覆盖：结构稳定、字段变化、交互变化。
- demo 验证路径与必要 instrumentation。
7. 扩展路径（业务/第三方）
扩展也必须走 spec-only：
- 自定义
NodeSpec - 自定义 binder/patch
- 不允许通过动态 map 透传语义
8. 防回归机制
- 单测已覆盖
requireSpec<T>()的严格读取与失败提示。 - 静态守卫测试扫描 framework 主源码，拦截
Props体系回流。 - 架构/流程文档将 NodeSpec-only 作为 review 必查项。