跳转至

组件主题化表面

{
  "scope": "global",
  "triggers": {
    "theming": [
      "INV3",
      "INV4",
      "INV5",
      "INV6",
      "INV7",
      "INV8",
      "INV9",
      "INV10",
      "INV12",
      "INV14",
      "INV15"
    ]
  }
}

本记录定义了组件解剖结构如何与公共主题化 API 相关联。

目的

主题作者需要为可设置样式的可见组件部分提供稳定的名称,而无需将每个包装器、插槽、状态或实现细节都暴露为永久选择器。

组件解剖结构是语义清单。主题化表面是该清单的一种显式、限定投影,而非一一对应的副本。

系统模型

每个组件规范中的机器可读块将每个面向消费者的解剖条目映射到一种主题化处置。该映射不包含在生成的消费者文档中:

  1. target — 该组件为可见部分承诺一个稳定的公共目标,例如 selector-popup。
  2. inherits — 该部分没有独立的目标。它使用此组件父级目标的样式,例如 Button 标签继承自 button。
  3. delegatesTo — 另一个 Astryx 组件拥有该部分及其目标,例如 Selector 标签使用 Field/field-label。
  4. none 及分类原因 — 当前没有公共目标可达该稳定解剖部分。所需原因必须以恰好一个事实性分类开头:
    • intentional: — 已批准的边界使该部分当前不可主题化;
    • reachability-gap: — 当前目标应当可达该部分,但实际不能;
    • unsettled: — 是否暴露或如何暴露该部分仍需所有者决策。

none 记录当前可达性。它本身并不决定某个部分必须保持不可主题化,也不授权未来的公共目标。

每个当前未弃用的公共目标都映射到一个解剖条目或一个显式的家族所有者。消费者的 .doc.mjs 文件继续拥有解剖名称、描述和公共目标文档。组件规范拥有确切映射,并仅解释非显而易见的理由或例外。

视觉 prop 轴和状态是目标的“选择器能力”。它们不是独立的解剖部分或独立的目标。运行时的 themeProps() 反射、公共 .doc.mjs 中的 theming.targets[].visualProps / states 元数据,以及经检查的组件规范元数据描述了这些选择器轴,而不向消费者暴露维护者的处置;它们不声明哪些 CSS 属性具有保证行为。

适配规则使用与根 components 相同的组件目标、轴、值域和扩展验证;它不会创建并行的组件-值策略。内置值以及权威开放原语域接受的值只能在规则内设置样式,无需匹配的根样式声明。其有效性依赖于主题注册的自定义值,在有效的根 components 映射上引入,构建工具可在那里生成无条件模块增强;适配规则随后可在条件下重新设置该值的样式。

共享的保证属性目录为:

Category Exact authoring keys
绘制 color, backgroundColor, opacity, outlineColor, outlineOffset, outlineStyle, outlineWidth, boxShadow, textShadow
边框/形状 borderColor, borderStyle, borderWidth, borderRadius
排版 fontFamily, fontSize, fontStyle, fontWeight, letterSpacing, lineHeight, textAlign, textDecorationColor, textDecorationLine, textDecorationStyle, textDecorationThickness, textTransform
内边距 padding, paddingBlock, paddingBlockStart, paddingBlockEnd, paddingInline, paddingInlineStart, paddingInlineEnd

初始目录包含七个已发布包主题使用的每个标准 CSS 键,但 height 除外:backgroundColor, borderColor, borderRadius, borderStyle, borderWidth, color, fontFamily, fontSize, fontWeight, lineHeight, padding, paddingBlock, 和 paddingInline。它增加了使这些类别保持一致所需的显式绘制、排版和逻辑内边距键。height 仍是目标特定的新增项,因为它会改变布局。

该目录是一个词汇表,而不是对每个目标自动保证。每个目标的 guaranteedProperties 列出它从该目录支持的精确合理子集,以及任何经审查的精确目标特定新增项。省略意味着尽力而为;不需要异常条目。

此列表是字面意义上的。列出的简写属性不隐含其展开属性;逻辑属性不隐含对应的物理属性;一个属性不隐含诸如 background、inlineSize 或 outline 之类的别名。目录之外的属性,包括 height、width、gap、定位、溢出以及 grid/flex 结构,需要显式目标新增项才能成为保证项。

每个声明的属性都必须在目标拥有的解剖部分上产生合理、可观察的结果。通用组件样式可能接受其他 CSS 属性,但仅接受本身是尽力而为,而非兼容性承诺。

边界与不变式

  • INV1 — 参与是基于能力的。 核心组件参与。Lab 组件在选择加入公共组件主题化或准备晋级之前豁免。届时它们必须提供与其他参与组件相同的目标、元数据、解剖处置和验证。仅消费语义 token 并不会使组件加入。
  • INV2 — 解剖锚定公共目标。 每个当前目标都代表一个稳定的语义部分,无论是本地的还是通过显式家族所有者实现。
  • INV3 — 解剖不意味着目标泛滥。 每个参与的解剖条目都有一个组件规范映射,但继承、委托和事实性 none 都是有效结果。none 原因将有意的当前边界与可达性缺口或未定的未来暴露区分开来;它绝不会静默决定未来的可主题化性。当桌面端和触摸端渲染不同部分或使用不同主题化所有者时,它们使用独立的解剖行。这些行描述的是在呈现切换期间除一个瞬态副本外永不会同时挂载的替代方案,并且两者都遵循 architecture:component-style-authoring INV7 的最小构造。
  • INV4 — 目标负责绘制。 目标应落在稳定的可见元素上,该元素绘制由主题控制的输出——而不是事件包装器、推测性的内部结构或仅为了布局管道而创建的节点。
  • INV5 — 组合保留所有权。 由共享 Astryx 原语渲染的部分委托给该原语的目标,除非父级保证一个不同的公开视觉约定。
  • INV6 — 状态保留在所属目标上。 变体、大小、选中、禁用和交互状态通过 themeProps 反映为目标能力;它们不会仅为每种状态创建并行目标。像是 Icon.variant 这样的插图请求选择的是提供的插图而不是样式,因此不会反映。
  • INV7 — 保证使用一个目录和精确的目标声明。 共享目录定义了受支持的词汇表,而非自动的目标保证。每个目标的 guaranteedProperties 列出它保证的合理目录子集以及任何经审查的目标特定新增项。每个列出的属性必须在所拥有的解剖部分上产生可观察的结果,并带有代表性的编译器和运行时证据。
  • INV8 — 名称不暗示自身之外的任何东西。 除非确切的编写键出现在目标声明中,否则不保证任何简写、展开形式、逻辑/物理对应项、别名或自定义属性。省略的属性仍为尽力而为;无需异常机制。
  • INV9 — 通用样式是尽力而为。 目标可以通过通用样式管道接受其已声明保证集合之外的 CSS 属性。这种接受并不保证有用的效果或跨版本兼容性。
  • INV10 — 公共语义变量是被接纳的,而非推断的。 当没有保证的 CSS 属性能够表达调用方拥有的需求时,组件可以公开一个经审查的公共自定义属性,该属性具有基于用途的含义、稳定的默认值或回退、明确的目标/状态范围、消费者文档和兼容性覆盖。它必须通过 architecture:public-component-api 中的接纳标准;实现缺口并不能自动证明新变量的合理性。
  • INV11 — 私有展开保持私有。 编译器可以将保证的公共属性转换为一个或多个私有 --_* 变量,以便所属组件可以在其内部绘制器之间路由、组合或转换该值。按约定,这些变量不得被消费者直接编写或依赖。确切映射仍为受检代码/元数据,而非复制的文字说明;已知的强制缺口记录在 architecture:theme-compilation 中。
  • INV12 — 别名是兼容性,而非解剖。 已移除的目标别名不计为当前语义部分。从 0.7.0 开始,运行时目标输出、组件元数据、CLI 发现、主题构建和生成的文档仅暴露规范目标。维护中的主题、CLI 模板和可复制示例使用规范键。破坏性发布在下方 spec:AST-017 下保留完整的旧到新映射和迁移路径。
  • INV13 — 家族所有权是显式的。 家族文档可以为多个组件拥有一个共享目标,但本地文档链接到该所有者,而不是让所有权留待推断。
  • INV14 — 可扩展轴需要与主题无关的回退。 一个 prop 轴只有在具备视觉性且不可用的自定义值具有一个不依赖当前主题的安全、确定性基线时,才能进行主题扩展。Heading.type 满足条件,因为必需的 Heading.level 提供了该基线。Icon.variant 满足条件,因为未列出的变体会在不带变体的情况下渲染请求,这对每个主题都是一样的。它是一个插图请求,而不是样式选择器:icon 目标不反映它,因此它没有 themeProps() 反射、visualProps 条目或组件样式映射。Icon.size 不满足:没有任何缺失的自定义尺寸可以在不静默改变几何、对齐或组合的情况下被推断出来。行为、结构、位置、方向和状态机轴始终保持封闭。主题可以在封闭轴上重新定义现有值,但不能新增一个。
  • INV15 — 条件样式不会创建条件 API。 适配组件的写入使用与根组件写入相同的共享验证。规则可以在不于根 components 中重复该目标或值的情况下,为独立有效的内置值或开放原语值设置样式。仅在通过主题注册后才有效的自定义值,必须在规则使用它之前注册到有效的根表面上,以便生成的类型绝不依赖媒体条件。未解决的共享验证结果会带入适配中。

该机制保持不变,并在共享契约成为权威时自动收紧;它不是永久性的适配豁免,也不是扩展点。

已批准的弃用表面移除

0.7.0 版本移除了本节所述的已弃用组件主题化兼容面。这是 spec:AST-017 下的一个破坏性变更;该版本包含精确的旧到新映射,以及一个分阶段迁移 codemod。

已批准的目标别名迁移如下:

已弃用目标 规范目标
base-table table
checkbox checkbox-indicator
codeblock code-block
codeblock-copy-button code-block-copy-button
codeblock-header code-block-header
codeblock-title code-block-title
date-input-clear-icon input-clear-icon
date-range-input-clear-icon input-clear-icon
hovercard hover-card
multi-selector-clear-icon input-clear-icon
navicon nav-icon
popover-surface popover
progressbar progress-bar
progressbar-fill progress-bar-fill
progressbar-mark progress-bar-mark
progressbar-track progress-bar-track
radio radio-indicator
radio-dot radio-indicator-dot
selector-clear-icon input-clear-icon
statusdot status-dot
textarea text-area

0.7.0 的移除操作还会删除仅用于上述别名的兼容机制:themeProps(..., {legacyNames}) 选项、ThemePropsOptions.legacyNames、ComponentThemingTarget.deprecatedFor,以及仅限别名的过滤或发现行为。

已弃用的裸属性/值和状态选择器类(如 .primary、.sm 和 .checked)将不再输出。它们的稳定替代方案是规范化的 astryx-* 目标,以及其显式反射的 data-* 属性。语义化的 defineTheme({components}) 键仍然受支持;只有上表中 21 个已弃用的目标拼写会迁移到其规范键。由于不带限定符的裸类无法标识其所属的属性/状态轴,且可能由使用者自行编写,codemod 会将其留待人工审查。

规范目标名称、语义化组件键、反射的 data-* 选择器以及当前目标行为均不在本次移除授权范围内,并继续受支持。内置和生成的主题必须在别名消失之前迁移到规范目标。静态内联主题键会获得受支持的迁移;动态主题对象和自定义 CSS 会获得上述完整映射。

本记录不负责语义化令牌定义、主题编写优先级、主题如何生成输出,也不负责组件外观的设计理由。

DEP-0013 — 弃用 21 个组件主题化目标别名

字段 值
id DEP-0013
cleanup CLN-0022
package @astryxdesign/core, @astryxdesign/cli
surface 主题目标名称:上表映射中的 21 个别名,作为 defineTheme({components}) 键以及 .astryx-<alias> CSS 类;此外还有仅服务于这些别名的机制:themeProps(..., {legacyNames}) 选项、ThemePropsOptions.legacyNames、ComponentThemingTarget.deprecatedFor,以及仅限别名的发现和过滤行为
old contract 每个别名都会在同一元素上与其规范目标一并输出,可被主题构建接受,并被 CLI 发现功能列出
替换 上表映射中的规范目标,同时用作主题键和 CSS 类
直接权威 architecture:component-theming-surface INV12 及本节。所有者:cixzhang、imdreamrunner
警告 主题构建会警告 Deprecated component target "<alias>". Use "<canonical>" instead.;CLI 发现机制会为每个别名标注其替换目标
迁移 运行 astryx upgrade --from <0.6 version> --apply --path .;审查它添加的每个 TODO(astryx upgrade)
codemod migrate-deprecated-theme-surface:重命名主题 components 映射中的静态键以及 CSS 中的别名类。当旧键与规范键并存时,它会添加一个 TODO。四个 clear-icon 别名在 CSS 中通过 :where(.astryx-<owner> *) 保留其所有者作用域;主题键无法承载该作用域,因此 codemod 会添加一个 TODO。字符串中的计算键和 CSS 会作为上报案例处理,而不会被重写
下游 受维护的主题、CLI 模板和可复制示例仅使用规范键;捆绑主题和探测主题构建时不使用任何别名
迁移沿革 no prior transition
状态 proposed
目标计划 CLN-0022,于 0.7.0 中

CLN-0022 — 仅限规范主题目标

字段 值
id CLN-0022
生命周期 DEP-0013
变更 组件停止输出 21 个别名类。主题构建将别名键视为未知组件,并建议使用规范键。CLI 发现机制和生成的文档仅列出规范目标。legacyNames、ThemePropsOptions 和 deprecatedFor 已移除
回滚 从最终 0.6 基线恢复别名输出、元数据与发现机制
状态 pending — 随其 [breaking] Changeset 在已声明的小版本中落地

DEP-0014 — 弃用裸属性与状态类

字段 值
ID DEP-0014
清理 CLN-0023
包 @astryxdesign/core
表面 渲染出的 CSS 类:每个主题元素上,每个视觉属性或状态值对应一个裸类(.primary、.sm、.checked;以数字开头的值保留其属性前缀,如 .level-2),并在别名目标上重复出现
旧契约 凡是以裸值类限定 Astryx 目标的选择器(如 .astryx-button.primary),即匹配该属性或状态
替代方案 规范目标加上其映射的 data-* 属性,例如 .astryx-button[data-variant="primary"]。主题 components 键保持不变
直接权威 architecture:component-theming-surface、本节。负责人:cixzhang、imdreamrunner
警告 消费者文档将这些类标记为已弃用,并指明替代方案
迁移 运行 astryx upgrade --from <0.6 version> --apply --path .。手动替换未限定的裸类,但仅限它们指向 Astryx 目标之处
Codemod migrate-deprecated-theme-surface:将 .css 文件中带目标限定的裸类重写为映射的 data-* 选择器,使用最终 0.6 版本输出的所有裸类。当 Astryx 曾输出的某个类在其所限定的目标上已无已知含义时,它会添加一条 TODO。未限定的类无法归类,因为裸类不标明其轴向,且可能为应用自身所有
downstream 每个受维护主题的生成 CSS 不包含目标限定的裸类;探测主题和视觉门仅使用 data-* 选择器
transition no prior transition
state proposed
target plan CLN-0023 在 0.7.0 中

CLN-0023 — 仅反射属性

字段 值
id CLN-0023
lifecycle DEP-0014
delta themeProps() 会发出一个规范性目标类和反射的 data-* 属性;不渲染任何裸 prop 或状态类
rollback 从最终 0.6 基线恢复裸类输出
state pending — 在一个声明的次版本中落地,并附带其 [breaking] Changeset

变更耦合

  • 添加或重命名 themeProps() 目标时,会同时更新其组件规范映射、.doc.mjs 公共目标元数据、生成/CLI 发现以及验证。可复制的示例和受维护主题使用规范性键。
  • 0.7.0 弃用表面移除会保留每个规范性目标和语义键,首先迁移内置/生成的主题,并提供上文指明的确切别名和裸选择器迁移证据。
  • 添加消费者解剖需要有意的组件规范映射,将其映射到目标、继承、委托或事实上的 none。它不会自动创建 CSS API。none 条目将当前状态分类为 intentional、reachability-gap 或 unsettled;改变可达性会更新映射,而未来的暴露仍遵循常规的公共目标审查。
  • 将某个 prop 轴开放给主题定义的值时,会对该轴进行分类,并在所属组件契约或管理系统规范中记录其无匹配回退。审查需证明该轴是视觉性的、回退是安全且与主题无关的,并且每个不合格的轴保持关闭。一个聚焦的组件测试覆盖了没有匹配活动主题规则的自定义值。extensibleAxes.test.ts 仅检查结构接线:公共映射、themeProps() 反射和消费者元数据。artwork 轴保留公共映射检查,因为其映射是主题构建所增强的映射,但它没有样式接线:守卫仅通过显式的 artwork 请求映射列表(目前为 IconVariantMap)将其豁免于 themeProps() 反射和 visualProps 检查。其聚焦的回退测试渲染一个未列出的名称。
  • 向目标的 guaranteedProperties 添加属性时,需记录其用途和范围,证明其对所属解剖结构部分的合理可观察效果,并添加具有代表性的编译器/运行时覆盖。仅凭目录成员资格并不能添加目标保证;目录之外的目标特定行为需通过同样的已审查声明来接纳。常见的属性到变量行为属于主题编译。
  • 添加公共语义自定义属性时,首先要说明为何没有受保证的 CSS 属性能够表达该需求,然后一并更新其组件契约、消费者文档、稳定回退/默认值、范围、运行时证据和兼容性覆盖。它并不是针对不受支持属性的默认应对方式。
  • 将目标所有权移至某个族时,需在同一已审查变更中更新每个成员的处置和链接。
  • 将参与扩展到另一个包时,首先将一致性守卫扩展到该包;没有元数据的部分公共目标是缺陷。

拥有代码

  • 组件 .doc.mjs 中的 usage.anatomy[] 负责面向消费者的语义部分清单,并且不包含主题化配置或维护者理由说明。
  • 组件 .doc.mjs 中的 theming.targets[] 负责可发现的规范公共目标及其视觉属性/状态选择器轴。已移除的别名不在此元数据中,也不计入解剖结构。visualProps 不声明 CSS 属性支持。
  • 已批准的属性目录由本条记录所拥有。一旦编写模式支持,目标 guaranteedProperties 声明将位于组件 .doc.mjs 的 theming.targets[] 中;目前尚不存在机器可读的字段。
  • 组件 .doc.mjs 中的 theming.vars[] 负责记录文档化的自定义属性,并标记私有实现变量;theming.derived[] 记录经检查的公共属性扩展元数据。
  • 组件记录(docs/specs/components/)中的 ### Theming anatomy 区块负责精确的、机器可读的解剖结构到目标的配置。在迁移期间它是可选的,会与消费者解剖结构进行对照检查,并且不会包含在生成的消费者文档中。附近的组件规范文字负责非显而易见的理由、例外情况和链接。
  • 运行时 themeProps() 调用会发出一个规范目标以及反射的 data-* 状态/属性选择器。
  • CLI 发现与主题构建使用规范目标元数据;可复制的示例省略已移除的别名。
  • scripts/check-knowledge.mjs、themingTargets.test.ts、extensibleAxes.test.ts 和 derivedVarRegistry.test.ts 强制执行源/元数据/生成物之间的关系。extensibleAxes.test.ts 仅证明结构一致性;组件契约、审查和有针对性的组件测试用于证明某个轴是否可以开放以及其回退是否安全。
  • 当多个组件采用同一部件契约时,家族契约负责共享的目标语义。

决定规格

  • spec:AST-012/DEC-2 和 spec:AST-012/DEC-3 将自适应组件写入约束为封闭的有序规则模型。spec:AST-012/DEC-5 使组件验证与根主题共享,并为有效性依赖于主题注册的值保留有效根的存在。
  • spec:AST-087/DEC-9 使 Icon.variant 成为主题可扩展轴,每个主题列出一次该轴的名称,其回退为不带变体的请求。
  • spec:AST-017/DEC-26 基于最小化 DOM 构建组件;除了一处临时切换副本(INV3)之外,桌面和触摸行永远不会同时挂载。
  • spec:AST-017/DEC-1 负责已发布的兼容性分类与迁移:移除兼容路径属于破坏性变更。本条记录负责确切的已弃用主题化群体及其批准的 0.7.0 移除窗口。

验证

不变量 证据 失败信号
INV1 跨包目标/文档清单 参与包中的已导出目标对元数据或 CLI 验证不可见
INV2, INV3 双向解剖配置/目标检查 当前目标没有语义部分所有者,解剖结构机械地创建目标,或者 none 悄然成为未来策略;或者在临时切换副本之外同时挂载独立的桌面和触摸行
INV4, INV5 组件审查外加对渲染后 DOM 的检查 公共目标落在非绘制管道上,或成为没有独特语义的子原语的别名
INV6 themingTargets.test.ts 和 extensibleAxes.test.ts;视觉门禁的探针主题为每个声明的目标、每个声明的状态以及反射属性的每个枚举值提供各自的探针颜色,因此一次捕获可以显示哪个条目最后绘制了每个元素;同一目标上的条目会设置相同的四个颜色属性,因此一次捕获可以证明获胜条目到达了该元素,而不是其下方的每个条目;它无法枚举的属性会被报告为未探测(.github/scripts/visual-gate/generate-probe-theme.mjs) 状态/变体对所属目标不可见,或成为不必要的并行目标
INV7, INV8 现有属性夹具(部分;存在以下缺口) 声明的属性缺少证据,或未列出的对应属性被当作隐含
INV9 API 文档与兼容性审查 通用属性接受被表述为受支持的兼容性承诺
INV10, INV11 现有注册表/公共变量/运行时测试(部分;存在以下缺口) 公共语义变量绕过准入,或使用者必须编写私有变量才能达到承诺的行为
INV12, INV13 仅限规范运行的运行时发射与发现、已移除别名拒绝、完整的 codemod 映射/测试、规范维护的主题/模板清单,以及家族所有者夹具 已移除的别名被发射或发现、迁移映射不完整、规范目标发生变化、已移除的兼容性元数据残留,或所有权保持隐式
INV14 组件契约、所有者审查、针对无匹配回退的专项测试,以及结构性的 extensibleAxes.test.ts 覆盖及其明确的 artwork 轴豁免清单 不合格的轴被打开、缺失的规则导致行为不可预测地变化、映射/反射/文档接线发生漂移,或 artwork 轴获得反射或失去豁免
INV15 覆盖有限域、开放域、已注册域和未解析域的共享根/适配组件验证夹具 根与适配不一致、有效的开放值需要根样式、规则有条件地将自定义值注册入册,或未解析行为变成适配特定行为

已知符合性与验证差距:

  • 组件验证仍存在未解决领域,而共享契约仍不完整。Root 表面和适配表面产生相同的结果与诊断;这是共享的验证债务,而非适配特有的例外或 API 准入。当共享契约成为权威时,两个表面都会自动收紧。独立有效的内置及开放原语值不要求匹配根样式声明。

  • 组件 schema 没有机器可读的轴分类(axis-classification)或回退(fallback)字段。因此,extensibleAxes.test.ts 仅检查结构一致性;它无法推断某个轴是否为视觉轴,或其回退在语义上是否安全。组件契约或管辖系统规范、所有者评审以及专项回退测试可提供该证据,而不必将结构守卫视为准入政策。

  • 并非所有由 map 支撑的轴都已对照 INV14 完成审计。Pagination.variant 和 Banner.container 是已知的开放结构性轴,在它们的词汇表闭合之前仍属于符合性差距。通过结构守卫并不会使其具备扩展资格。

  • 共享目录已获批准,但组件文档编写 schema 没有 guaranteedProperties 字段。后续工作必须添加精确名称字段,将每个当前目标连同其合理的目录子集和经评审的新增项一起迁移,将声明暴露给发现机制,并拒绝未知或隐含的名称。在该迁移完成之前,目录不会自动保证任何目标上的任何属性。

  • CI 尚未要求每个已声明目标/属性对提供具有代表性的编译器和运行时证据。后续工作必须使缺失输出路径或可观察的运行时证据导致验证失败;对布局敏感的补充项还需要内部耦合和方向性证据。

  • 运行时/构建时的私有变量拒绝以及媒体表面派生展开,是由 architecture:theme-compilation 负责并规定的独立编译器符合性差距。

  • 探针主题仅覆盖 Core 目标(例如 rich-text-editor 没有探针条目)。它只从目标组件所指名文档的顶层 props 中解析被反射 prop 的值,因此在其他地方记录的 prop(例如在另一个文档中或某个子组件下)不会被探测;这占了生成器报告跳过的 83 个 props 中的 76 个(例如 button-group.size、avatar-status-dot.variant)。其余 7 个的类型没有可枚举的字符串值,例如数值型 gap 标度或 string | CodeLanguage。每个条目还会设置相同的四个颜色属性,因此同一元素上后应用的条目会覆盖先前条目的绘制(在 Button 上,elevation 会覆盖 base、size 和 variant 的绘制)。

来自 2026-08-30 审计的迁移工作

  • 43 个参与的 Core 组件文档没有解剖清单。
  • 若干解剖文档依赖父级/家族拥有的目标,但没有显式所有者链接。
  • Lab 组件在声明公共主题化或准备晋升之前继续保持豁免。现有的晋升守卫会检查参与的 Lab 组件。

在将双向验证设为强制要求之前,先补齐组件规范映射和 Core 解剖清单。审计清单是迁移证据,而非政策。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx