间距：实现与治理
将间距转化为可重用的资产、工具、文档、所有权和验证规则。此参考定义了采用边界、失败行为和可观察证据，同时保留环境特定限制的可配置性。
包状态： 参考上下文已准备好供人工审查。合同和测试场景已完成，但不保证采用的实现已通过它们。
决策
对于间距，采用设计和实现共享的版本化设计令牌和组件合同。通过一个权威的写入路径、类型化接口、显式状态和幂等副作用处理来实现行为。此实现块专注于实现和治理。该包是一个参考合同：采用团队必须根据自身环境中的证据选择数值限制、提供者、管辖范围和运营所有者。
范围
- 间距参与者、输入、输出、状态、策略或模式版本，以及实现和治理重点所需的外部可见结果。
- 主要和备用接口、后台工作、缓存、集成、支持路径和可执行相同边界的证据。
- 采用特定的配置、推广、恢复和验证职责，以安全应用该参考。
不包括在此块内
- 为每个采用者选择通用供应商、框架、管辖范围、数值阈值、保留期或服务级别目标。
- 声称已针对下游实现运行打包场景，或该参考授予法律、安全或无障碍认证。
合同
- 按语义目的命名令牌；当存在语义令牌时，产品代码不依赖于原始调色板、间距或排版值。
- 在同一合同中定义允许的变体和状态，包括无障碍行为、内容约束和响应行为。
- 将破坏性令牌或组件更改视为迁移，包含所有权、兼容性说明和可衡量的采用情况。
- 使用视觉检查作为变更证据，而非语义、键盘操作或可访问名称的唯一测试。
- 在边界处对输入进行一次验证，并保留下游逻辑使用的规范化表示。
- 在业务转换之前或与出站记录原子性持久化；消费者通过持久操作标识去重。
- 为组件内部、关系、布局、密度和安全区域定义受限的语义间距尺度，并从版本化令牌生成平台值。
- 测试嵌套、缩放、文本缩放、长本地内容、触控目标、窄屏和双向布局，迁移异常而非累积任意间隙。
- 对于实现和治理变体，强制执行此声明边界：将间距转化为可重用资产、工具、文档、所有权和验证规则。
实现指导
- 先发布增量存储和接口更改，观察性地补充，然后在兼容性证据出现后废弃旧路径。
- 在选择框架或供应商细节前，建模间距输入、输出、参与者、状态、不变量、副作用和证据。
- 将适用的间距合同或策略版本与重要状态一起存储，以便迁移、重放和支持决策可追溯。
- 在受控推广后引入路径，比较预期和观察结果，并保持经过测试的恢复路径，直到采用证据完整。
失败处理与保障
- 未知令牌或变体在开发中明显失败，已发布客户端使用文档化的安全回退。
- 无效或矛盾的间距状态被拒绝或隔离；实现绝不猜测会扩大权限或重复效果的值。
- 重试有界且使用持久标识；耗尽后，工作达到可检查的终态并有责任所有者。
验证与运维
- 在持久化前后注入依赖失败，证明重试收敛到一个外部可见结果。
- 按合同版本监控间距成功、拒绝、验证失败、依赖失败、重试耗尽和恢复，且不包含敏感有效载荷维度。
- 在策略、模式、依赖、迁移或边界变更后，重新运行配对的正负测试夹具并保留结果证据。
采用假设
- 示例中的名称和值是具体夹具，不是通用默认；采用者通过文档化证据和所有权替换它们。
- 采用系统能提供认证身份、持久操作或记录版本、有界遥测和受控变更路径。
本包中看似可执行的示例是夹具和验收合同。运行集合验证器检查结构和元数据，然后在目标仓库中翻译并执行场景，最后记录实现证据。