agentcss 0.25.2 → 0.25.3

package/ai/tokens.schema.json

@@ -1,58 +1,104 @@
 {
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://frontend-lib.dev/ai/tokens.schema.json",
-  "title": "frontend-lib 令牌契约",
-  "$comment": [
-    "描述 ai/tokens.json 的形状，由 05-audit/gen-ai-contract.py 生成。",
-    "",
-    "🔴 为什么用 $value / $type 这种写法：",
-    "   这是 W3C Design Tokens 草案的形状，Open Props 与 Primer 都在用。",
-    "   好处是 Figma / Style Dictionary / 各类构建工具能**直接消费**，",
-    "   不需要我们再写一层的适配。对标的意义就在这里 —— 不是更好看，是更少重复。",
-    "",
-    "🔴 真值方向：tokens.css 是真值，本文件是导出物，",
-    "   一致性由 gen-ai-contract.py --check 保证（单向，不双向同步）。"
-  ],
-  "type": "object",
-  "required": ["schemaVersion", "source", "sets"],
-  "properties": {
-    "schemaVersion": { "type": "string" },
-    "source": { "type": "string" },
-    "sets": {
-      "type": "object",
-      "properties": {
-        "light": { "$ref": "#/definitions/tokenSet" },
-        "dark": { "$ref": "#/definitions/tokenSet" }
-      },
-      "required": ["light", "dark"]
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "$id": "https://frontend-lib.dev/ai/tokens.schema.json",
+ "title": "frontend-lib 令牌契约",
+ "$comment": [
+  "描述 ai/tokens.json 的形状，由 05-audit/gen-ai-contract.py 生成。",
+  "",
+  "🔴 为什么用 $value / $type 这种写法：",
+  "   这是 W3C Design Tokens 草案的形状，Open Props 与 Primer 都在用。",
+  "   好处是 Figma / Style Dictionary / 各类构建工具能**直接消费**，",
+  "   不需要我们再写一层的适配。对标的意义就在这里 —— 不是更好看，是更少重复。",
+  "",
+  "🔴 真值方向：tokens.css 是真值，本文件是导出物，",
+  "   一致性由 gen-ai-contract.py --check 保证（单向，不双向同步）。"
+ ],
+ "type": "object",
+ "required": [
+  "schemaVersion",
+  "source",
+  "sets"
+ ],
+ "properties": {
+  "schemaVersion": {
+   "type": "string"
+  },
+  "source": {
+   "type": "string"
+  },
+  "sets": {
+   "type": "object",
+   "properties": {
+    "light": {
+     "$ref": "#/definitions/tokenSet"
     },
-    "coverage": {
-      "type": "object",
-      "properties": {
-        "lightCount": { "type": "number" },
-        "darkCount": { "type": "number" },
-        "onlyInDark": { "type": "array", "items": { "type": "string" } },
-        "onlyInLight": { "type": "array", "items": { "type": "string" } }
-      }
+    "dark": {
+     "$ref": "#/definitions/tokenSet"
     }
+   },
+   "required": [
+    "light",
+    "dark"
+   ]
   },
-  "definitions": {
-    "tokenSet": {
-      "type": "object",
-      "additionalProperties": { "$ref": "#/definitions/token" }
+  "coverage": {
+   "type": "object",
+   "properties": {
+    "lightCount": {
+     "type": "number"
+    },
+    "darkCount": {
+     "type": "number"
+    },
+    "onlyInDark": {
+     "type": "array",
+     "items": {
+      "type": "string"
+     }
+    },
+    "onlyInLight": {
+     "type": "array",
+     "items": {
+      "type": "string"
+     }
+    }
+   }
+  }
+ },
+ "definitions": {
+  "tokenSet": {
+   "type": "object",
+   "additionalProperties": {
+    "$ref": "#/definitions/token"
+   }
+  },
+  "token": {
+   "type": "object",
+   "required": [
+    "$value"
+   ],
+   "properties": {
+    "$value": {
+     "type": "string"
+    },
+    "$type": {
+     "type": "string",
+     "enum": [
+      "color",
+      "dimension",
+      "number",
+      "duration",
+      "cubicBezier",
+      "alias",
+      "other"
+     ]
     },
-    "token": {
-      "type": "object",
-      "required": ["$value"],
-      "properties": {
-        "$value": { "type": "string" },
-        "$type": {
-          "type": "string",
-          "enum": ["color", "dimension", "number", "duration",
-                   "cubicBezier", "alias", "other"]
-        },
-        "$description": { "type": "string" }
-      }
+    "$description": {
+     "type": "string",
+     "maxLength": 400,
+     "$comment": "必须描述**本令牌**，且必须来自它与相邻注释（前导或同行尾注释）。归属由 05-audit/ai-token-desc-gate.py 判定：分隔线 / 空串 / 半句话 / 超过 400 字 / 错位一位 都会红。"
     }
+   }
   }
+ }
 }

package/dist/COSTS.md

@@ -18,13 +18,13 @@
 
 | 档 | 组件 | tokens（必付） | CSS | JS | **合计** | 源码版合计 | 差 |
 |---|---|---:|---:|---:|---:|---:|---:|
-| primitive | `badge` | 2.9 KB | 0.5 KB | — | **3.4 KB** | 24.6 KB | −21.2 KB |
+| primitive | `badge` | 2.9 KB | 0.5 KB | — | **3.4 KB** | 24.7 KB | −21.2 KB |
 | primitive | `button` | 2.9 KB | 1.0 KB | — | **3.9 KB** | 28.3 KB | −24.4 KB |
 | primitive | `card` | 2.9 KB | 0.9 KB | — | **3.9 KB** | 26.0 KB | −22.1 KB |
 | primitive | `choice` | 2.9 KB | 1.1 KB | — | **4.1 KB** | 28.1 KB | −24.0 KB |
-| primitive | `combobox` | 2.9 KB | 1.0 KB | 5.4 KB | **9.3 KB** | 31.4 KB | −22.1 KB |
+| primitive | `combobox` | 2.9 KB | 1.0 KB | 5.4 KB | **9.3 KB** | 31.4 KB | −22.2 KB |
 | primitive | `date-range` | 2.9 KB | 0.8 KB | 2.5 KB | **6.3 KB** | 28.4 KB | −22.1 KB |
-| primitive | `delta` | 2.9 KB | 0.3 KB | — | **3.2 KB** | 24.6 KB | −21.4 KB |
+| primitive | `delta` | 2.9 KB | 0.3 KB | — | **3.2 KB** | 24.7 KB | −21.5 KB |
 | primitive | `input` | 2.9 KB | 1.0 KB | — | **4.0 KB** | 25.8 KB | −21.9 KB |
 | primitive | `metric` | 2.9 KB | 0.5 KB | — | **3.4 KB** | 25.1 KB | −21.7 KB |
 | primitive | `popover` | 2.9 KB | 0.8 KB | 2.2 KB | **5.9 KB** | 29.2 KB | −23.3 KB |
@@ -32,19 +32,19 @@
 | primitive | `select` | 2.9 KB | 0.8 KB | 4.1 KB | **7.9 KB** | 32.9 KB | −24.9 KB |
 | primitive | `separator` | 2.9 KB | 0.2 KB | — | **3.2 KB** | 23.2 KB | −20.0 KB |
 | primitive | `skeleton` | 2.9 KB | 0.5 KB | — | **3.4 KB** | 23.8 KB | −20.4 KB |
-| primitive | `switch` | 2.9 KB | 0.8 KB | — | **3.7 KB** | 30.2 KB | −26.5 KB |
-| primitive | `timeline` | 2.9 KB | 0.5 KB | — | **3.4 KB** | 25.1 KB | −21.7 KB |
+| primitive | `switch` | 2.9 KB | 0.8 KB | — | **3.7 KB** | 30.3 KB | −26.5 KB |
+| primitive | `timeline` | 2.9 KB | 0.5 KB | — | **3.4 KB** | 25.2 KB | −21.7 KB |
 | primitive | `upload` | 2.9 KB | 1.4 KB | 4.2 KB | **8.5 KB** | 39.3 KB | −30.8 KB |
 | pattern | `accordion` | 2.9 KB | 1.3 KB | 1.8 KB | **6.0 KB** | 36.4 KB | −30.4 KB |
 | pattern | `content` | 2.9 KB | 1.0 KB | — | **4.0 KB** | 26.5 KB | −22.5 KB |
 | pattern | `drawer` | 2.9 KB | 0.8 KB | 2.6 KB | **6.3 KB** | 30.1 KB | −23.8 KB |
-| pattern | `dropdown` | 2.9 KB | 0.8 KB | 3.5 KB | **7.2 KB** | 31.5 KB | −24.4 KB |
+| pattern | `dropdown` | 2.9 KB | 0.8 KB | 3.5 KB | **7.2 KB** | 31.6 KB | −24.4 KB |
 | pattern | `form-validation` | 2.9 KB | 0.8 KB | — | **3.7 KB** | 26.8 KB | −23.1 KB |
 | pattern | `list` | 2.9 KB | 0.6 KB | — | **3.5 KB** | 24.3 KB | −20.8 KB |
 | pattern | `nav` | 2.9 KB | 1.2 KB | 2.6 KB | **6.8 KB** | 33.0 KB | −26.2 KB |
 | pattern | `overlay` | 2.9 KB | 1.2 KB | 3.6 KB | **7.7 KB** | 38.5 KB | −30.8 KB |
 | pattern | `pagination` | 2.9 KB | 0.8 KB | 2.6 KB | **6.3 KB** | 32.4 KB | −26.1 KB |
-| pattern | `reveal` | 2.9 KB | 0.3 KB | 1.2 KB | **4.4 KB** | 26.4 KB | −22.0 KB |
+| pattern | `reveal` | 2.9 KB | 0.3 KB | 1.2 KB | **4.4 KB** | 26.5 KB | −22.0 KB |
 | pattern | `states` | 2.9 KB | 0.9 KB | — | **3.8 KB** | 26.3 KB | −22.5 KB |
 | pattern | `tabs` | 2.9 KB | 0.7 KB | 2.0 KB | **5.6 KB** | 29.1 KB | −23.5 KB |
 | pattern | `tooltip` | 2.9 KB | 0.5 KB | 1.9 KB | **5.3 KB** | 28.5 KB | −23.2 KB |

package/docs/ACCESSIBILITY.md

@@ -5,7 +5,7 @@
 
 | 项目 | 值 |
 |---|---|
-| 声明适用版本 | agentcss `0.25.2` |
+| 声明适用版本 | agentcss `0.25.3` |
 | 声明日期 | 2026-11-03 |
 | 复核节奏 | 每次发版前重跑（`npm run gate` 内含全部证据） |
 | 范围 | 本库交付的 CSS / JS、全部 `demo.html`（组件页 + 图表页 + 组合页）、以及文档站生成的页面 |

package/docs/GUIDANCE.md

@@ -0,0 +1,82 @@
+# GUIDANCE · 建议层
+
+> **这一层的地位**：`docs/INVARIANT.md` 写物理事实，`ai/*.json` 写机器契约，
+> 这一份写**工作方式与品味**。它随时可以整份作废 —— 判据是
+> INVARIANT 里那句：「如果明天出现一个无限强的模型，这句话还成立吗？」
+> 这里的话**不成立**，所以它们必须待在这一层，不许往上渗。
+
+**为什么要有这一层**：把建议混进事实层，会让事实层变成"随时会变的规矩"；
+把建议删干净，又会让每次都重新踩同一批坑。分层的意义是 ——
+事实层永不变，契约层可协商，建议层可作废。
+
+> ⚠️ **公开面的边界**：这一份只收「工作方式与品味」。
+> 发布凭证、账号二次因子、内部排期与到期日**不进这里**，也不进任何公开文档 ——
+> 0.11.4 曾因此把四份文档（含本文件）整份移进内部目录。
+> 现在的做法是：**只公开可以公开的那一部分**，而不是让三层体系缺一层。
+
+---
+
+## 一、动手之前
+
+| 建议 | 为什么 |
+|---|---|
+| 先跑 `python 05-audit/impact-report.py` 看这次改动会波及哪些门禁 | 事后被 20 道门禁同时判红，比事前花 10 秒看影响面贵得多 |
+| 改 CSS 前先确认它是不是"生成物"（`dist/` 下的一律是） | 改产物会被 `build-dist --check` 判新鲜度失败，白改 |
+| 新增组件前先搜一遍现有组件能不能改 | 44 个组件的维护成本远高于 43 个 |
+| 动 `01-tokens/` 之前，先读 `docs/BUDGET.md` 的储备与棘轮 | 令牌层的改动会同时推动体积、对比度、暗色三组判据 |
+
+## 二、写代码
+
+| 建议 | 为什么 |
+|---|---|
+| 不要写魔法数字：能进令牌的进令牌，进不去的写一行注释说清来历 | 令牌化的价值在于"改一处、全场一致"；散落的数字会把这点吃掉 |
+| 组件之间不要 `@import` 互相依赖 | 一旦互相依赖，单独引一个组件就不可能了，包体也会失控 |
+| 状态一律走 `data-state`，不要新造状态类 | 类名会被使用者复制粘贴，属性化的状态更容易被脚本和测试读到 |
+| 只用逻辑属性（`inline-start` / `block-end`），不写 `left` / `right` | 物理属性是 RTL 的唯一来源；`rtl-render` 门禁会拦住，但改起来比重写便宜得多 |
+| 注释写"为什么"，不写"是什么" | 本库注释占比约七成，其中绝大部分是"这个取舍放弃了什么" |
+| 加一条门禁时，同时加一条**反向控制** | 见下节 |
+
+## 三、关于门禁
+
+| 建议 | 为什么 |
+|---|---|
+| 新判据必须配一条"注入反例 ⇒ 必须变红"的自检 | 没有反向控制的判据无法证明自己有牙；仓库里 85 条自检就是为此存在 |
+| 判据红的时候，先怀疑**判据自己**，再怀疑代码 | 历史上多次"红得很有道理"其实是参照物取错、作用域取宽、单位取混 |
+| 每一条判据都要能回答"它圈中的对象是否都能按同一标准评价" | 圈不干净就会误报；误报比漏报贵，因为它会让人放弃信任门禁 |
+| 别用"文本匹配"证明"渲染了" | 类名可以由运行时拼串产生，grep 不到不等于没渲染 |
+| 度量型判据必须写清"两个数各自是什么" | 拿列容器当行长、拿字节当体积，都会让判据永远给出同一个结论 |
+
+## 四、AI 协作
+
+| 建议 | 为什么 |
+|---|---|
+| 让 AI 先读 `llms.txt`，再按需读 `ai/components.json` | 全量读 352 KB 的 CHANGELOG 是浪费上下文 |
+| 用 `node ai/cli.js` 校验它产出的契约，而不是相信它说"改好了" | `check` / `diff` / `patch` 三个子命令就是给这件事用的 |
+| AI 报告的"已完成"要能被一条命令复核 | 不能复核的完成，等于没完成 |
+| 不要让它替你做"要不要发版"这种不可撤回的决定 | 这条是本仓库的惯例，不是技术约束 |
+
+## 五、提交与发布
+
+| 建议 | 为什么 |
+|---|---|
+| 提交前跑 `npm run gate:fast`，收尾跑 `npm run gate` | `fast` 是纯静态层，秒级；`full` 才是那 9 分钟 |
+| 打 tag 之前，先确认**tag 将要指向的那棵树**能过发布门禁 | 本地工作区通过 ≠ tag 快照通过；两者差一个"未提交的基线"就够红一轮 |
+| 顺序是：先让 CI 绿 → 再打 tag → 再推 tag | 反过来等于拿发版当试验 |
+| 发版失败先查 npm 是否已吃进版本，再决定重试还是回滚 | 有些失败只到 Release 那一步，npm 上其实已经有包了 |
+| 移动 tag 之后要重新核对 provenance 里的 `gitCommit` | tag 是发布物与提交之间唯一的锚点，移了就得重新验 |
+
+## 六、什么不该进这一层
+
+- **能机器判定的 → 进契约**（`ai/*.json`），不要写成建议；
+- **物理机制的 → 进 `INVARIANT.md`**，不要写成建议；
+- **随版本变的数字 → 进 `docs/FACTS.md` 或 `ai/components.json`**，不要手抄进文档。
+
+三层的边界一旦松动，最先坏掉的不是文档，而是**门禁判据的可信度**。
+
+---
+
+## 附：这一层为什么可以被整份删掉
+
+以上每一条都是"在某个能力水平下、某种协作方式里"的经验。
+换成更强的模型、更成熟的团队、更严格的 CI，其中相当一部分会变成多余的动作。
+把它们写在这一层，就是为了**将来能干净地删掉它们**，而不必动到事实层和契约层。

package/docs/LESSONS.md

@@ -0,0 +1,182 @@
+# LESSONS · 门禁与工程的可复用教训
+
+> 这份文件从维护者的内部错误登记里挑出**可以公开、可以复用**的部分。
+> 每条都是真实红过的门禁、或真实做错过的事，不是假想。
+>
+> 为什么不直接公开完整登记：完整版含内部路径、工单代号与排期，
+> 那部分不出门。这里保留的是**规则本身** —— 换一个项目也用得上。
+
+---
+
+## 一、判据的错法（比代码错更难查）
+
+### 1. 作用域取宽了：把"不是它的对象"也抓进来审
+
+**症状** 给表单加了一个"校验中…"的提示，可访问性判据立刻红：
+「错误文案太含糊：正在检查是否可用…」。
+
+**根因** 判据本意是"错误文案要说人话"，取数却是「所有被 `aria-describedby`
+关联的文本」—— 帮助文字、加载提示全被当成错误文案审。
+
+**规则**
+```
+写判据前先问：这个选择器圈中的对象，是不是都能按同一标准评价。
+圈不干净就缩范围（只取 .field__error / role=alert / aria-invalid 指向的），
+不要用"所有 describedby"这种顺手的写法。
+```
+
+### 2. 阈值从数据里反推：判的是"短"，不是"含糊"
+
+**症状** 同一条判据里还有一条更隐蔽的：用「长度 ≤ 最长含糊词 + 2」判含糊。
+最长词是 `invalid`（7）⇒ 阈值 9 ⇒ 凡是 ≤9 字的文案一律判含糊，
+而 20 个字的废话照样过。
+
+**根因** 把长度当成了"含糊"的代理指标，而阈值又是从词表长度推出来的，
+两个不相干的量被乘在一起。
+
+**规则**
+```
+代理指标必须与被判对象有因果关系。判"含糊"就判构成（整句只由含糊词组成），
+不要判长度。任何阈值型判据都要配一条反向控制：喂一个真含糊的样本，必须转红。
+```
+
+### 3. 参照物取错了一层：拿容器当行宽
+
+**症状** 判"宽通道是否真的越过了正文行长"，量的是宽块与**列容器**的宽度，
+得到 420 vs 544，判"没打开"—— 而实际上是打开的。
+
+**根因** 行长只施加在内容块上，列容器是满宽的。两个数不是同一种东西。
+
+**规则**
+```
+差值型判据先写清"两个数各自是什么"，参照物必须与被判对象同一层
+（文本块 vs 文本块，容器 vs 容器）。拿不准就用探针：
+同一元素"加类前 / 加类后"各量一次，差值归零才是真的没生效。
+```
+
+### 4. 指标名与定义不一致：「未渲染」其实是「文本没被提到」
+
+**症状** 覆盖率门禁把 41 个类记成"未渲染"，逐个去看，其中 10 个每次交互都在渲染。
+
+**根因** 判据是文本匹配，而类名可以由 JS 拼串产生（`'tooltip--' + pos`），
+源码里没有完整字面量 ⇒ 渲染了也搜不到。
+
+**规则**
+```
+指标名必须能被它的实现完整解释；做不到就换名字（"未被文本引用"而不是"未渲染"）。
+类名、事件名、storage key 这类字符串契约一律写完整字面量，不拼前缀 ——
+拼串的代价不是多打几个字，是所有静态检查都看不见它。
+```
+
+### 5. 零文件即通过：判据在没有对象时静默变绿
+
+**症状** 某道扫描类门禁，路径写错导致一个文件都没扫到，结论是 PASS。
+
+**规则**
+```
+凡是"扫描 / 遍历 / 统计"型判据，必须先断言"扫到了东西"，
+再断言"扫到的东西都合格"。零对象一律判失败，不判通过。
+```
+
+---
+
+## 二、删除与清理
+
+### 6. 「清理」不等于「释放空间」
+
+**症状** 某台机器上每次跑完整门禁，回收站就多 2.3 GB；8 轮攒了 16.86 GB。
+门禁一直是全绿的。
+
+**根因** 该环境的删除被改写成"移进回收站"（bash 的 `rm` 是个函数、
+Python 的 `os.unlink` 被替换）。而回收站与仓库**同一块盘** ⇒
+"清理"只是换了目录继续占着，一个字节都没释放。
+
+**规则**
+```
+① 脚本清理自己创建的临时大目录时，确认删除动作真的删了，
+   而不是被平台接管（可以看回收站大小、看卷空闲空间）。
+② 「清理」必须度量：跑前跑后各量一次，差值才是证据。
+   命令返回 0 只证明调用成功。
+③ 用户说"我习惯了"不是验收通过，是问题被默许的信号。
+```
+
+### 7. 临时目录的位置会改变测试的语义
+
+**症状** 为了省事，把 `TEMP` 指到仓库内的 `.git/tmp`，结果三道
+"模拟无 git 环境"的反向控制全红 —— 它们期望在空目录里只看到一个文件，
+却看到了整个仓库的 966 个文件。
+
+**根因** 临时目录在 `.git/` 内部，git 向上就能找到仓库，"这里没有仓库"的前提失效。
+
+**规则**
+```
+临时目录的边界必须与仓库边界互斥。改全局环境变量（TEMP/TMPDIR/PATH）之前，
+先枚举谁会读它 —— 测试代码最常拿这类变量当"干净空间"的锚点。
+修一个问题，用最小作用域；不要顺手改跨层的锚点。
+```
+
+### 8. 删目录前，先列过它
+
+**症状** 一个临时目录被建到了盘符根下（路径格式错误导致的），发现后直接删了整个目录。
+事后无法证明它原本是空的。
+
+**规则**
+```
+`rm -rf <dir>` 的作用域是整棵子树，而"我知道里面有什么"不等于"我列出过里面有什么"。
+删除前先 ls 目标**本身**，并核对"这一层应该只有我刚造的那一个东西"。
+拿不出这句话，就不删。
+```
+
+---
+
+## 三、发布与版本
+
+### 9. tag 打在"代码对了"的提交上，但发布门禁看的是 tag 快照
+
+**症状** 功能提交打完 tag 就推，半小时后补的那批视觉基线没跟着走，
+发布工作流当场红（页面尺寸变了）。
+
+**根因** 本地的门禁跑的是**工作区**（含未提交的基线），CI 跑的是 **tag 指向的那棵树**。
+两者差一个未提交的文件就够红一轮。
+
+**规则**
+```
+打 tag 前问的是「tag 将要指向的那棵树能过发布门禁吗」，
+而不是「我刚跑过的门禁过了吗」。
+顺序：先让主干 CI 绿 → 再打 tag → 再推 tag。
+```
+
+### 10. 对外文档里的数字，单位必须同量纲
+
+**症状** 更新日志写「16 页有变化（浅色 16 / 暗色 16 / RTL 8）」——
+三个数各自都对，但前面说"页"、括号里列"张"，40 张图对应 16 个页面，
+读者按字面算不出 16。
+
+**规则**
+```
+一句话里出现两个以上的数，先确认它们同一个单位；不同单位就分开写。
+对外数字必须能被一条命令复算，复算命令记在提交说明里。
+已发布的文档不做"偷偷改"—— 改历史条目会让仓库领先于发布物。
+```
+
+---
+
+## 四、这套文档的分层为什么重要
+
+上面十条里，前五条属于**判据的错法**，第六到八条属于**运行时副作用**，
+第九、十条属于**发布语义**。它们有一个共同点：
+
+> **都是门禁自己看不见的错。**
+
+代码写错，门禁会红；判据写错、清理没释放空间、tag 指错树 ——
+这些是"尺子本身的问题"，而尺子不会量自己。
+
+所以本库的做法是：
+
+- 每条新判据都配一条**反向控制**（注入反例 ⇒ 必须变红），
+  证明它有牙，而不是证明它存在；
+- 定期做**元检查**：门禁的参照物、作用域、量纲、零对象行为；
+- 把每一次"红得没有道理"和"绿得没有道理"都登记下来，变成常驻判据。
+
+这也是 `docs/GUIDANCE.md` 里那条建议的出处：
+**判据红的时候，先怀疑判据自己，再怀疑代码。**

package/index.html

@@ -97,7 +97,7 @@ li a:active { background: var(--surface-sunken); }
   </p>
 </main>
 <footer class="wrap">
-  <p class="note">0.25.2 · 零第三方运行时依赖</p>
+  <p class="note">0.25.3 · 零第三方运行时依赖</p>
 </footer>
 </body>
 </html>

package/llms-full.txt

@@ -1,6 +1,6 @@
 # agentcss — full reference (one file)
 
-> Generated from `ai/components.json` + `ai/pitfalls*.json` + `ai/behaviors.json` at version **0.25.2**.
+> Generated from `ai/components.json` + `ai/pitfalls*.json` + `ai/behaviors.json` at version **0.25.3**.
 > Do not edit by hand: run `python 05-audit/gen-llms.py` (freshness is gated).
 > Short version: `llms.txt`. Machine contract: `ai/*.json`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcss",
-  "version": "0.25.2",
+  "version": "0.25.3",
   "description": "移动 Web 组件库：CSS + 可选行为脚本，零第三方运行时依赖。样式用 bundler 引入，交互行为用 script 标签引入。",
   "keywords": [
     "css",
@@ -20,7 +20,7 @@
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
-      "default": "./index.html"
+      "default": "./esm/index.mjs"
     },
     "./tokens.css": "./dist/01-tokens/tokens.css",
     "./typography.css": "./dist/01-tokens/typography.css",
@@ -29,7 +29,9 @@
       "types": "./types/index.d.ts",
       "default": "./esm/index.mjs"
     },
+    "./esm/*.mjs": "./esm/*.mjs",
     "./esm/*": "./esm/*.mjs",
+    "./ai/*": "./ai/*",
     "./primitives/*": "./dist/02-primitives/*",
     "./patterns/*": "./dist/03-patterns/*",
     "./recipes/*": "./dist/04-recipes/*",