agentcss 0.0.0-stage → 0.11.3

package/ai/components.json

@@ -0,0 +1,1944 @@
+{
+  "schemaVersion": "1.0.0",
+  "generatedBy": "05-audit/gen-ai-contract.py",
+  "libraryVersion": "0.11.3",
+  "$comment": "机器可读的组件契约。slots = BEM 元素名（在本库里元素名就是插槽名），states.enum = 组件会在 DOM 上写出的 data-* 取值，states.legacyClass = 仍未收敛到 data 属性的历史状态类（INVARIANT I-8 未达标）。",
+  "maturityCriteria": {
+    "alpha": "缺 demo.html 或缺 05-audit 下的专属门禁 ⇒ 还没被机器验证过，不要用",
+    "beta": "有 demo + 专属门禁，但**下面至少有一条没过**：① 状态仍用 .is-* class 表达（违反 INVARIANT I-8）；② 该收编到微行为核的行为还是**手写副本**（manual）或**根本没做**（gap） ⇒ 改一处不会全库跟着变（I-14 的病）",
+    "stable": "以上四条全过：有 demo + 专属门禁 + 状态全在 data-* 属性上 + 行为零欠账",
+    "$note": "成熟度是【计算出来的】，不是拍的。手写把某个组件改成 stable 而它还有 manual / gap ⇒ 门禁会红。",
+    "$whyFourth": "🔴 为什么第四条判据不能省：用前三条时多数组件会**全是 stable** ⇒ ladder 没有任何鉴别力（对标 Primer 六档阶梯，每档都有硬判据）。补上「行为欠账」这一条后：**stable 31 / beta 4**（本行由生成器算出，不要手改）。",
+    "$strictImpact": "⚠️ strict 档位只放行 stable ⇒ 4 个组件在 strict 下不可用：accordion / drawer / dropdown / overlay。放宽 strict 会让「未收编的手写行为」进入生产路径。（本行由生成器算出，不要手改）"
+  },
+  "summary": {
+    "total": 35,
+    "byMaturity": {
+      "stable": 31,
+      "beta": 4
+    },
+    "byTier": {
+      "primitive": 13,
+      "pattern": 14,
+      "recipe": 4,
+      "asset": 4
+    }
+  },
+  "components": [
+    {
+      "id": "bar",
+      "tier": "asset",
+      "purpose": "柱状图（charter 13 图表规范）：堆叠/分组两种语义、超量程裁剪、图例",
+      "rootClass": "bar",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "chart-check.js"
+      ],
+      "files": {
+        "css": "09-assets/bar/bar.css",
+        "js": "09-assets/bar/bar.js",
+        "jsAlso": [],
+        "demo": "09-assets/bar/demo.html"
+      },
+      "slots": [
+        "bar__bar",
+        "bar__grid",
+        "bar__label",
+        "bar__label--clip",
+        "bar__label--max",
+        "bar__legend",
+        "bar__legend-item",
+        "bar__legend-swatch",
+        "bar__note",
+        "bar__s0",
+        "bar__s1",
+        "bar__s2",
+        "bar__s3",
+        "bar__s4",
+        "bar__svg",
+        "bar__threshold",
+        "bar__xlabel",
+        "bar__ytick"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {
+          "clipped": [
+            "1"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": "Bar",
+      "globalAlso": [],
+      "behaviorRef": "API.md#bar"
+    },
+    {
+      "id": "model-viewer",
+      "tier": "asset",
+      "purpose": "3D 模型查看器：令牌驱动样式，不含渲染库本体",
+      "rootClass": "mv",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "chart-check.js",
+        "model-viewer-contract.js"
+      ],
+      "files": {
+        "css": "09-assets/model-viewer/model-viewer.css",
+        "js": "09-assets/model-viewer/model-viewer.js",
+        "jsAlso": [],
+        "demo": "09-assets/model-viewer/demo.html"
+      },
+      "slots": [
+        "mv__btn",
+        "mv__cap",
+        "mv__err",
+        "mv__hint",
+        "mv__ph",
+        "mv__stage",
+        "mv__stage--err",
+        "mv__status"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": "ModelViewer",
+      "globalAlso": [],
+      "behaviorRef": "API.md#model-viewer"
+    },
+    {
+      "id": "scientific-plot",
+      "tier": "asset",
+      "purpose": "二维科学绘图：折线/区间带/对数轴，纯令牌驱动、零依赖",
+      "rootClass": "splot",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "scientific-plot-check.js"
+      ],
+      "files": {
+        "css": "09-assets/scientific-plot/scientific-plot.css",
+        "js": "09-assets/scientific-plot/scientific-plot.js",
+        "jsAlso": [],
+        "demo": "09-assets/scientific-plot/demo.html"
+      },
+      "slots": [
+        "splot__anno",
+        "splot__anno-dot",
+        "splot__axis",
+        "splot__axis-label",
+        "splot__band",
+        "splot__err",
+        "splot__grid",
+        "splot__legend",
+        "splot__legend-item",
+        "splot__legend-mark",
+        "splot__line",
+        "splot__note",
+        "splot__pt",
+        "splot__ref",
+        "splot__ref-label",
+        "splot__s0",
+        "splot__s1",
+        "splot__s2",
+        "splot__s3",
+        "splot__s4",
+        "splot__tick",
+        "splot__tick-label"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "img"
+        ],
+        "attrs": [
+          "hidden",
+          "label"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "ScientificPlot",
+      "globalAlso": [],
+      "behaviorRef": "API.md#scientific-plot"
+    },
+    {
+      "id": "sparkline",
+      "tier": "asset",
+      "purpose": "迷你趋势图：无坐标轴、纯形状，适合表格内嵌的一行走势",
+      "rootClass": "sparkline",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "chart-check.js",
+        "sparkline-contract.js"
+      ],
+      "files": {
+        "css": "09-assets/sparkline/sparkline.css",
+        "js": "09-assets/sparkline/sparkline.js",
+        "jsAlso": [],
+        "demo": "09-assets/sparkline/demo.html"
+      },
+      "slots": [],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "img"
+        ],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": "Chart",
+      "globalAlso": [],
+      "behaviorRef": "API.md#sparkline"
+    },
+    {
+      "id": "accordion",
+      "tier": "pattern",
+      "purpose": "可折叠分组",
+      "rootClass": "accordion",
+      "maturity": "beta",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": [
+          "roving:gap"
+        ]
+      },
+      "gates": [
+        "accordion-contract.js"
+      ],
+      "files": {
+        "css": "03-patterns/accordion/accordion.css",
+        "js": "03-patterns/accordion/accordion.js",
+        "jsAlso": [],
+        "demo": "03-patterns/accordion/demo.html"
+      },
+      "slots": [
+        "accordion__heading",
+        "accordion__hint",
+        "accordion__item",
+        "accordion__label",
+        "accordion__marker",
+        "accordion__panel",
+        "accordion__panel-inner",
+        "accordion__trigger"
+      ],
+      "variants": [
+        "accordion--flush"
+      ],
+      "states": {
+        "enum": {
+          "state": [
+            "closed",
+            "open"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "button",
+          "region"
+        ],
+        "attrs": [
+          "disabled",
+          "expanded",
+          "hidden",
+          "labelledby"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "Accordion",
+      "globalAlso": [],
+      "behaviorRef": "API.md#accordion"
+    },
+    {
+      "id": "content",
+      "tier": "pattern",
+      "purpose": "长文排版容器（标题/段落/列表/引用/代码）",
+      "rootClass": "prose",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "content-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/content/content.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "03-patterns/content/demo.html"
+      },
+      "slots": [],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#content"
+    },
+    {
+      "id": "drawer",
+      "tier": "pattern",
+      "purpose": "侧边抽屉，含遮罩",
+      "rootClass": "drawer",
+      "maturity": "beta",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": [
+          "dismissable:manual"
+        ]
+      },
+      "gates": [
+        "drawer-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/drawer/drawer.css",
+        "js": "03-patterns/drawer/drawer.js",
+        "jsAlso": [],
+        "demo": "03-patterns/drawer/demo.html"
+      },
+      "slots": [
+        "drawer__body",
+        "drawer__close",
+        "drawer__foot",
+        "drawer__head",
+        "drawer__title"
+      ],
+      "variants": [
+        "drawer--bottom",
+        "drawer--left",
+        "drawer--right",
+        "drawer--top"
+      ],
+      "states": {
+        "enum": {
+          "state": [
+            "leaving"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": "Drawer",
+      "globalAlso": [],
+      "behaviorRef": "API.md#drawer"
+    },
+    {
+      "id": "dropdown",
+      "tier": "pattern",
+      "purpose": "下拉菜单",
+      "rootClass": "dd",
+      "maturity": "beta",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": [
+          "typeahead:gap"
+        ]
+      },
+      "gates": [
+        "dropdown-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/dropdown/dropdown.css",
+        "js": "03-patterns/dropdown/dropdown.js",
+        "jsAlso": [],
+        "demo": "03-patterns/dropdown/demo.html"
+      },
+      "slots": [
+        "dd__btn",
+        "dd__caret",
+        "dd__check",
+        "dd__item",
+        "dd__menu",
+        "dd__sep"
+      ],
+      "variants": [
+        "dd--end"
+      ],
+      "states": {
+        "enum": {
+          "state": [
+            "active"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "menu",
+          "menuitem",
+          "separator"
+        ],
+        "attrs": [
+          "disabled",
+          "expanded"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "Dropdown",
+      "globalAlso": [],
+      "behaviorRef": "API.md#dropdown"
+    },
+    {
+      "id": "form-validation",
+      "tier": "pattern",
+      "purpose": "表单校验反馈与错误汇总",
+      "rootClass": "form",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "form-validation-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/form-validation/form-validation.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "03-patterns/form-validation/demo.html"
+      },
+      "slots": [
+        "form__actions",
+        "form__notice",
+        "form__row",
+        "form__summary",
+        "form__summary-link",
+        "form__summary-title"
+      ],
+      "variants": [
+        "form--has-summary"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [
+          "dirty"
+        ],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "alert"
+        ],
+        "attrs": [
+          "describedby",
+          "hidden"
+        ]
+      },
+      "usesOtherNamespaces": [
+        "field__checking-hint",
+        "field__error",
+        "field__input"
+      ],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#form-validation"
+    },
+    {
+      "id": "list",
+      "tier": "pattern",
+      "purpose": "键值列表/条目列表",
+      "rootClass": "list",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "list-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/list/list.css",
+        "js": "03-patterns/list/flip.js",
+        "jsAlso": [],
+        "demo": "03-patterns/list/demo.html"
+      },
+      "slots": [
+        "list__actions",
+        "list__item",
+        "list__main",
+        "list__meta",
+        "list__note",
+        "list__title",
+        "list__value",
+        "list__value--down",
+        "list__value--up"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "list"
+        ],
+        "attrs": [
+          "hidden"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "FLIP",
+      "globalAlso": [],
+      "behaviorRef": "API.md#list"
+    },
+    {
+      "id": "nav",
+      "tier": "pattern",
+      "purpose": "顶部导航与目录",
+      "rootClass": "nav",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "nav-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/nav/nav.css",
+        "js": "03-patterns/nav/nav.js",
+        "jsAlso": [
+          "03-patterns/nav/toc.js"
+        ],
+        "demo": "03-patterns/nav/demo.html"
+      },
+      "slots": [
+        "nav__brand",
+        "nav__inner",
+        "nav__link",
+        "nav__list",
+        "nav__scrim",
+        "nav__toggle"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {
+          "state": [
+            "open"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": [
+          "controls",
+          "current",
+          "expanded",
+          "label"
+        ]
+      },
+      "usesOtherNamespaces": [
+        "toc__link",
+        "toc__list",
+        "toc__title"
+      ],
+      "global": "Nav",
+      "globalAlso": [
+        {
+          "global": "Toc",
+          "js": "03-patterns/nav/toc.js"
+        }
+      ],
+      "behaviorRef": "API.md#nav"
+    },
+    {
+      "id": "overlay",
+      "tier": "pattern",
+      "purpose": "吐司提示与模态遮罩",
+      "rootClass": "toast",
+      "maturity": "beta",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": [
+          "dismissable:manual"
+        ]
+      },
+      "gates": [
+        "overlay-check.js",
+        "overlay-host-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/overlay/overlay.css",
+        "js": "03-patterns/overlay/overlay.js",
+        "jsAlso": [],
+        "demo": "03-patterns/overlay/demo.html"
+      },
+      "slots": [
+        "toast__body",
+        "toast__close",
+        "toast__desc",
+        "toast__timer",
+        "toast__title"
+      ],
+      "variants": [
+        "toast--error",
+        "toast--success",
+        "toast--warning"
+      ],
+      "states": {
+        "enum": {
+          "state": [
+            "leaving"
+          ]
+        },
+        "boolean": [
+          "scroll-locked"
+        ],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "status"
+        ],
+        "attrs": [
+          "hidden"
+        ]
+      },
+      "usesOtherNamespaces": [
+        "dialog__actions",
+        "dialog__desc",
+        "dialog__title"
+      ],
+      "global": "Overlay",
+      "globalAlso": [],
+      "behaviorRef": "API.md#overlay"
+    },
+    {
+      "id": "pagination",
+      "tier": "pattern",
+      "purpose": "分页控件",
+      "rootClass": "pagination",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "pagination-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/pagination/pagination.css",
+        "js": "03-patterns/pagination/pagination.js",
+        "jsAlso": [],
+        "demo": "03-patterns/pagination/demo.html"
+      },
+      "slots": [
+        "pagination__ellipsis",
+        "pagination__item",
+        "pagination__link",
+        "pagination__list",
+        "pagination__live",
+        "pagination__sr",
+        "pagination__status"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "navigation",
+          "region"
+        ],
+        "attrs": [
+          "controls",
+          "current",
+          "disabled",
+          "label",
+          "live"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "Pagination",
+      "globalAlso": [],
+      "behaviorRef": "API.md#pagination"
+    },
+    {
+      "id": "reveal",
+      "tier": "pattern",
+      "purpose": "入场动效：一个 data-reveal 属性六个方向，无 JS 时内容全可见",
+      "rootClass": "reveal",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "reveal-contract.js"
+      ],
+      "files": {
+        "css": "03-patterns/reveal/reveal.css",
+        "js": "03-patterns/reveal/reveal.js",
+        "jsAlso": [],
+        "demo": "03-patterns/reveal/demo.html"
+      },
+      "slots": [],
+      "variants": [],
+      "states": {
+        "enum": {
+          "reveal": [
+            "down",
+            "left",
+            "none",
+            "right",
+            "scale",
+            "up"
+          ]
+        },
+        "boolean": [
+          "reveal",
+          "reveal-children",
+          "reveal-done",
+          "reveal-ready"
+        ],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": "Reveal",
+      "globalAlso": [],
+      "behaviorRef": "API.md#reveal"
+    },
+    {
+      "id": "states",
+      "tier": "pattern",
+      "purpose": "空/加载/错误/成功四种整块状态",
+      "rootClass": "state",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "states-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/states/states.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "03-patterns/states/demo.html"
+      },
+      "slots": [
+        "state__action",
+        "state__desc",
+        "state__detail",
+        "state__icon",
+        "state__title"
+      ],
+      "variants": [
+        "state--empty",
+        "state--error",
+        "state--loading"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "alert",
+          "group",
+          "status"
+        ],
+        "attrs": [
+          "busy",
+          "hidden",
+          "label",
+          "live",
+          "pressed"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#states"
+    },
+    {
+      "id": "tabs",
+      "tier": "pattern",
+      "purpose": "选项卡切换",
+      "rootClass": "tabs",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "tabs-contract.js"
+      ],
+      "files": {
+        "css": "03-patterns/tabs/tabs.css",
+        "js": "03-patterns/tabs/tabs.js",
+        "jsAlso": [],
+        "demo": "03-patterns/tabs/demo.html"
+      },
+      "slots": [
+        "tabs__list",
+        "tabs__panel",
+        "tabs__panel--enter",
+        "tabs__tab"
+      ],
+      "variants": [
+        "tabs--manual",
+        "tabs--vertical"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "tab",
+          "tablist",
+          "tabpanel"
+        ],
+        "attrs": [
+          "controls",
+          "disabled",
+          "label",
+          "labelledby",
+          "orientation",
+          "selected"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "Tabs",
+      "globalAlso": [],
+      "behaviorRef": "API.md#tabs"
+    },
+    {
+      "id": "tooltip",
+      "tier": "pattern",
+      "purpose": "悬停/聚焦提示",
+      "rootClass": "tooltip",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "tooltip-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/tooltip/tooltip.css",
+        "js": "03-patterns/tooltip/tooltip.js",
+        "jsAlso": [],
+        "demo": "03-patterns/tooltip/demo.html"
+      },
+      "slots": [],
+      "variants": [
+        "tooltip--bottom",
+        "tooltip--inset-inline-end",
+        "tooltip--inset-inline-start",
+        "tooltip--top"
+      ],
+      "states": {
+        "enum": {
+          "state": [
+            "open"
+          ]
+        },
+        "boolean": [
+          "tooltip"
+        ],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "tooltip"
+        ],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": "Tooltip",
+      "globalAlso": [],
+      "behaviorRef": "API.md#tooltip"
+    },
+    {
+      "id": "tree",
+      "tier": "pattern",
+      "purpose": "可展开树形结构",
+      "rootClass": "tree",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "tree-check.js"
+      ],
+      "files": {
+        "css": "03-patterns/tree/tree.css",
+        "js": "03-patterns/tree/tree.js",
+        "jsAlso": [],
+        "demo": "03-patterns/tree/demo.html"
+      },
+      "slots": [
+        "tree__count",
+        "tree__item",
+        "tree__label",
+        "tree__marker",
+        "tree__node"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "group"
+        ],
+        "attrs": [
+          "expanded",
+          "selected"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "Tree",
+      "globalAlso": [],
+      "behaviorRef": "API.md#tree"
+    },
+    {
+      "id": "badge",
+      "tier": "primitive",
+      "purpose": "状态标签：计数、分类、结果标记",
+      "rootClass": "badge",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "badge-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/badge/badge.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/badge/demo.html"
+      },
+      "slots": [],
+      "variants": [
+        "badge--clickable",
+        "badge--danger",
+        "badge--info",
+        "badge--lg",
+        "badge--neutral",
+        "badge--solid-danger",
+        "badge--solid-success",
+        "badge--solid-warning",
+        "badge--success",
+        "badge--warning"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#badge"
+    },
+    {
+      "id": "button",
+      "tier": "primitive",
+      "purpose": "动作触发：主/次/危险/纯文字四档",
+      "rootClass": "btn",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "button-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/button/button.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/button/demo.html"
+      },
+      "slots": [
+        "btn__label",
+        "btn__spinner"
+      ],
+      "variants": [
+        "btn--block",
+        "btn--danger",
+        "btn--ghost",
+        "btn--icon",
+        "btn--lg",
+        "btn--md",
+        "btn--primary",
+        "btn--secondary",
+        "btn--sm"
+      ],
+      "states": {
+        "enum": {
+          "state": [
+            "success"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": [
+          "busy",
+          "disabled"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#button"
+    },
+    {
+      "id": "card",
+      "tier": "primitive",
+      "purpose": "内容容器：媒体+正文+操作区三段",
+      "rootClass": "card",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "card-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/card/card.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/card/demo.html"
+      },
+      "slots": [
+        "card__body",
+        "card__desc",
+        "card__footer",
+        "card__link",
+        "card__media",
+        "card__title"
+      ],
+      "variants": [
+        "card--compact",
+        "card--elevated",
+        "card--flat",
+        "card--interactive",
+        "card--linked",
+        "card--row",
+        "card--selected"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "button",
+          "checkbox",
+          "switch"
+        ],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#card"
+    },
+    {
+      "id": "choice",
+      "tier": "primitive",
+      "purpose": "单选/多选/原生 select 外观的统一控件",
+      "rootClass": "choice",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "choice-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/choice/choice.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/choice/demo.html"
+      },
+      "slots": [
+        "choice__group",
+        "choice__hint",
+        "choice__input",
+        "choice__label",
+        "choice__legend",
+        "choice__mark",
+        "choice__options"
+      ],
+      "variants": [
+        "choice--checkbox",
+        "choice--radio"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": [
+          "describedby",
+          "hidden"
+        ]
+      },
+      "usesOtherNamespaces": [
+        "select__arrow",
+        "select__control",
+        "select__control--auto"
+      ],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#choice"
+    },
+    {
+      "id": "combobox",
+      "tier": "primitive",
+      "purpose": "可搜索 + 可多选标签的输入控件",
+      "rootClass": "combo",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "combobox-check.js",
+        "combobox-instance-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/combobox/combobox.css",
+        "js": "02-primitives/combobox/combobox.js",
+        "jsAlso": [],
+        "demo": "02-primitives/combobox/demo.html"
+      },
+      "slots": [
+        "combo__empty",
+        "combo__field",
+        "combo__input",
+        "combo__list",
+        "combo__opt",
+        "combo__tag",
+        "combo__tag-del",
+        "combo__tag-text",
+        "combo__tags"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {
+          "state": [
+            "active",
+            "disabled"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "option",
+          "presentation"
+        ],
+        "attrs": [
+          "disabled",
+          "label",
+          "selected"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "Combobox",
+      "globalAlso": [],
+      "behaviorRef": "API.md#combobox"
+    },
+    {
+      "id": "date-range",
+      "tier": "primitive",
+      "purpose": "日期区间选择，含预设快捷范围",
+      "rootClass": "drange",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "date-range-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/date-range/date-range.css",
+        "js": "02-primitives/date-range/date-range.js",
+        "jsAlso": [],
+        "demo": "02-primitives/date-range/demo.html"
+      },
+      "slots": [
+        "drange__clear",
+        "drange__error",
+        "drange__field",
+        "drange__input",
+        "drange__label",
+        "drange__preset",
+        "drange__presets",
+        "drange__sep",
+        "drange__summary"
+      ],
+      "variants": [
+        "drange--disabled"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "alert"
+        ],
+        "attrs": [
+          "hidden",
+          "invalid",
+          "live",
+          "pressed"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "DateRange",
+      "globalAlso": [],
+      "behaviorRef": "API.md#date-range"
+    },
+    {
+      "id": "input",
+      "tier": "primitive",
+      "purpose": "文本输入及其标签/帮助/错误三件套",
+      "rootClass": "field",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "input-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/input/input.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/input/demo.html"
+      },
+      "slots": [
+        "field__error",
+        "field__hint",
+        "field__input",
+        "field__input--sm",
+        "field__input--textarea",
+        "field__label",
+        "field__req"
+      ],
+      "variants": [
+        "field--row"
+      ],
+      "states": {
+        "enum": {
+          "state": [
+            "valid"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "alert"
+        ],
+        "attrs": [
+          "describedby",
+          "hidden",
+          "invalid"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#input"
+    },
+    {
+      "id": "popover",
+      "tier": "primitive",
+      "purpose": "锚定到触发元素的浮层",
+      "rootClass": "popover",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "popover-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/popover/popover.css",
+        "js": "02-primitives/popover/popover.js",
+        "jsAlso": [],
+        "demo": "02-primitives/popover/demo.html"
+      },
+      "slots": [
+        "popover__arrow",
+        "popover__desc",
+        "popover__footer",
+        "popover__title"
+      ],
+      "variants": [
+        "popover--bottom",
+        "popover--end",
+        "popover--start",
+        "popover--top"
+      ],
+      "states": {
+        "enum": {
+          "open": [
+            "true"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "main"
+        ],
+        "attrs": [
+          "hidden"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "Popover",
+      "globalAlso": [],
+      "behaviorRef": "API.md#popover"
+    },
+    {
+      "id": "progress",
+      "tier": "primitive",
+      "purpose": "进度条与进度环",
+      "rootClass": "progress",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "progress-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/progress/progress.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/progress/demo.html"
+      },
+      "slots": [
+        "progress__bar"
+      ],
+      "variants": [
+        "progress--danger",
+        "progress--indeterminate",
+        "progress--lg",
+        "progress--sm",
+        "progress--success",
+        "progress--warning"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "main",
+          "progressbar"
+        ],
+        "attrs": [
+          "busy",
+          "hidden",
+          "label",
+          "valuemax",
+          "valuemin",
+          "valuenow"
+        ]
+      },
+      "usesOtherNamespaces": [
+        "progress-ring__label",
+        "progress-steps__seg",
+        "progress-steps__seg--current",
+        "progress-steps__seg--done"
+      ],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#progress"
+    },
+    {
+      "id": "select",
+      "tier": "primitive",
+      "purpose": "自定义下拉选择（非原生）",
+      "rootClass": "select",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "select-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/select/select.css",
+        "js": "02-primitives/select/select.js",
+        "jsAlso": [],
+        "demo": "02-primitives/select/demo.html"
+      },
+      "slots": [
+        "select__btn",
+        "select__caret",
+        "select__check",
+        "select__list",
+        "select__opt",
+        "select__opt-text",
+        "select__value",
+        "select__value--placeholder"
+      ],
+      "variants": [
+        "select--block",
+        "select--end"
+      ],
+      "states": {
+        "enum": {
+          "state": [
+            "active"
+          ]
+        },
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "option"
+        ],
+        "attrs": [
+          "disabled",
+          "expanded",
+          "selected"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": "Select",
+      "globalAlso": [],
+      "behaviorRef": "API.md#select"
+    },
+    {
+      "id": "separator",
+      "tier": "primitive",
+      "purpose": "分隔线，可带中间文字",
+      "rootClass": "separator",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "separator-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/separator/separator.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/separator/demo.html"
+      },
+      "slots": [],
+      "variants": [
+        "separator--both",
+        "separator--label",
+        "separator--tight"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "separator"
+        ],
+        "attrs": [
+          "label"
+        ]
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#separator"
+    },
+    {
+      "id": "skeleton",
+      "tier": "primitive",
+      "purpose": "加载占位骨架",
+      "rootClass": "skeleton",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "skeleton-check.js",
+        "skeleton-lever-check.js"
+      ],
+      "files": {
+        "css": "02-primitives/skeleton/skeleton.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/skeleton/demo.html"
+      },
+      "slots": [],
+      "variants": [
+        "skeleton--block",
+        "skeleton--circle",
+        "skeleton--text"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "main"
+        ],
+        "attrs": [
+          "busy",
+          "hidden"
+        ]
+      },
+      "usesOtherNamespaces": [
+        "skeleton-list__row"
+      ],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#skeleton"
+    },
+    {
+      "id": "switch",
+      "tier": "primitive",
+      "purpose": "开关切换",
+      "rootClass": "switch",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "switch-contract.js",
+        "switch-geometry.js"
+      ],
+      "files": {
+        "css": "02-primitives/switch/switch.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "02-primitives/switch/demo.html"
+      },
+      "slots": [
+        "switch__input",
+        "switch__label",
+        "switch__label--sr",
+        "switch__thumb",
+        "switch__track"
+      ],
+      "variants": [
+        "switch--disabled",
+        "switch--lg"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "switch"
+        ],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#switch"
+    },
+    {
+      "id": "analysis-report",
+      "tier": "recipe",
+      "purpose": "组合型研究报告页面：正文与辅助栏并排，窄屏自然退回单栏",
+      "rootClass": "report",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "analysis-report-check.js"
+      ],
+      "files": {
+        "css": "04-recipes/analysis-report/analysis-report.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "04-recipes/analysis-report/demo.html"
+      },
+      "slots": [
+        "report__aside",
+        "report__body",
+        "report__code",
+        "report__fig",
+        "report__foot",
+        "report__kicker",
+        "report__main",
+        "report__meta",
+        "report__quote"
+      ],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "region"
+        ],
+        "attrs": [
+          "label"
+        ]
+      },
+      "usesOtherNamespaces": [
+        "card__title",
+        "kf__title"
+      ],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#analysis-report"
+    },
+    {
+      "id": "detail-page",
+      "tier": "recipe",
+      "purpose": "实体详情页骨架：字段齐全 / 部分缺失 / 无数据三种状态同构，无数据是一等状态",
+      "rootClass": "detail-page",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "detail-page-contract.py"
+      ],
+      "files": {
+        "css": "04-recipes/detail-page/detail-page.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "04-recipes/detail-page/demo.html"
+      },
+      "slots": [],
+      "variants": [],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [
+        "detail-body__heading",
+        "detail-body__section",
+        "detail-body__text",
+        "detail-hero__body",
+        "detail-hero__deco",
+        "detail-hero__eyebrow",
+        "detail-hero__meta",
+        "detail-hero__title",
+        "detail-kpi__delta",
+        "detail-kpi__label",
+        "detail-kpi__value",
+        "detail-kpi__value--missing",
+        "detail-null__reason",
+        "detail-null__title"
+      ],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#detail-page"
+    },
+    {
+      "id": "report",
+      "tier": "recipe",
+      "purpose": "报告版式系统 v1：共享基础 + 三套版式（杂志/科研技术/金融研究），只换一个 rep--* 类即可切换取舍",
+      "rootClass": "rep",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "report-check.js"
+      ],
+      "files": {
+        "css": "04-recipes/report/report.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "04-recipes/report/demo.html"
+      },
+      "slots": [
+        "rep__aside",
+        "rep__body",
+        "rep__cap",
+        "rep__cap--table",
+        "rep__fig",
+        "rep__fig--wide",
+        "rep__grid",
+        "rep__keyline",
+        "rep__kicker",
+        "rep__lede",
+        "rep__meta",
+        "rep__note",
+        "rep__pull",
+        "rep__risk",
+        "rep__sec",
+        "rep__source",
+        "rep__sources",
+        "rep__standfirst",
+        "rep__title",
+        "rep__wide"
+      ],
+      "variants": [
+        "rep--finance",
+        "rep--magazine",
+        "rep--technical"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [],
+        "attrs": []
+      },
+      "usesOtherNamespaces": [],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#report"
+    },
+    {
+      "id": "table",
+      "tier": "recipe",
+      "purpose": "数据表格：排序/加载/空/错误四态；三种用途预设（财务/学术/统计）",
+      "rootClass": "table",
+      "maturity": "stable",
+      "maturityReasons": {
+        "hasDemo": true,
+        "hasDedicatedGate": true,
+        "statesOnDomAttributes": true,
+        "behaviorDebt": []
+      },
+      "gates": [
+        "table-check.js"
+      ],
+      "files": {
+        "css": "04-recipes/table/table.css",
+        "js": null,
+        "jsAlso": [],
+        "demo": "04-recipes/table/demo.html"
+      },
+      "slots": [
+        "table__bar",
+        "table__cap",
+        "table__empty",
+        "table__error",
+        "table__foot",
+        "table__loading",
+        "table__sort",
+        "table__unit"
+      ],
+      "variants": [
+        "table--academic",
+        "table--compact",
+        "table--financial",
+        "table--stats"
+      ],
+      "states": {
+        "enum": {},
+        "boolean": [],
+        "legacyClass": []
+      },
+      "aria": {
+        "roles": [
+          "alert",
+          "status"
+        ],
+        "attrs": [
+          "label",
+          "live",
+          "sort"
+        ]
+      },
+      "usesOtherNamespaces": [
+        "stat__ci",
+        "stat__p",
+        "stat__p--sig",
+        "stat__se"
+      ],
+      "global": null,
+      "globalAlso": [],
+      "behaviorRef": "API.md#table"
+    }
+  ]
+}