agentcss 0.25.4 → 0.25.5

package/dist/COSTS.md

@@ -22,12 +22,12 @@
 | 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.2 KB |
-| primitive | `date-range` | 2.9 KB | 0.8 KB | 2.5 KB | **6.3 KB** | 28.4 KB | −22.1 KB |
+| primitive | `combobox` | 2.9 KB | 1.0 KB | 5.5 KB | **9.4 KB** | 31.5 KB | −22.1 KB |
+| primitive | `date-range` | 2.9 KB | 0.8 KB | 2.6 KB | **6.3 KB** | 28.6 KB | −22.3 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 |
+| primitive | `popover` | 2.9 KB | 0.8 KB | 2.2 KB | **5.9 KB** | 29.3 KB | −23.4 KB |
 | primitive | `progress` | 2.9 KB | 0.8 KB | — | **3.7 KB** | 26.2 KB | −22.5 KB |
 | 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 |
@@ -37,7 +37,7 @@
 | 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 | `drawer` | 2.9 KB | 0.8 KB | 2.6 KB | **6.3 KB** | 30.2 KB | −23.9 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 |
@@ -52,8 +52,8 @@
 
 ## 三、全库
 
-- 全部组件都用上（min，含 tokens 一份）：**70.4 KB**
-- 源码版（带注释）全库 gzip：358.8 KB
+- 全部组件都用上（min，含 tokens 一份）：**70.6 KB**
+- 源码版（带注释）全库 gzip：380.1 KB
 
 > ⚠️ 源码版那个数字**不是**要付的钱：它包含我们的注释（全库 CSS 有 69% 是注释，字节口径）。
 > 它的用途只有一个 —— 让人看清"dist 到底省了多少"。

package/docs/ACCESSIBILITY.md

@@ -5,8 +5,8 @@
 
 | 项目 | 值 |
 |---|---|
-| 声明适用版本 | agentcss `0.25.4` |
-| 声明日期 | 2026-11-03 |
+| 声明适用版本 | agentcss `0.25.5` |
+| 声明日期 | 2026-11-04 |
 | 复核节奏 | 每次发版前重跑（`npm run gate` 内含全部证据） |
 | 范围 | 本库交付的 CSS / JS、全部 `demo.html`（组件页 + 图表页 + 组合页）、以及文档站生成的页面 |
 | 不在范围 | 使用者拿这些组件拼出来的业务页面（那是你的无障碍责任，不是库的） |

package/docs/CONVENTIONS.md

@@ -139,14 +139,26 @@
 所以"未分层"是当前唯一安全的选择。`cascade-layer-gate.py` 把这条变成可判状态：
 一旦出现第一条 `@layer`，就要求三条前提的实测记录已落档，否则红。
 
-`!important` 现有 10 处，**每一处都必须能被归类**：
+`!important` **每一处都必须能被归类**，归不了类的 ⇒ 红。判据不是"清零" ——
+清零会逼人删掉无障碍兜底。
 
-| 类别 | 处数 | 为什么必须赢 |
-|---|---|---|
-| 无障碍偏好（`prefers-reduced-motion`） | 9 | 操作系统级偏好，组件无权推翻 |
-| 正确性（`[hidden] { display: none }`） | 1 | 不赢就会"藏不住" |
+| 类别 | 为什么必须赢 |
+|---|---|
+| 无障碍偏好（`prefers-reduced-motion: reduce`） | 操作系统级偏好，组件无权推翻 |
+| 正确性（`[hidden] { display: none }`） | 不赢就会"藏不住" |
+| 打印媒体（`@media print` + `display: none`） | 纸张上没有交互，屏幕专属元素必须真的不出现 |
+
+**这里刻意不写"现在有几处"**（I-7：同一个数字有第二个出处，就必然漂移）。
+要数字就跑门禁，它会把每一类的处数打出来：
+
+```bash
+python 05-audit/cascade-layer-gate.py
+```
 
-分不了类的 `!important` ⇒ 红。判据不是"清零"——清零会逼人删掉无障碍兜底。
+> 曾经的教训：这份文档写"10 处（无障碍 9 + `[hidden]` 1）"，而门禁当时实测
+> **13 处**——多出来的 2 处是打印媒体，文档连这个类别都没列。
+> 于是按文档去审计的人会把 2 处**判成"说不清"**，而那两处恰恰是正当的。
+> 少写一个类别，比少写一个数字更坏。
 
 ## 八 · 对比度与触控的硬线
 

package/index.html

@@ -97,7 +97,7 @@ li a:active { background: var(--surface-sunken); }
   </p>
 </main>
 <footer class="wrap">
-  <p class="note">0.25.4 · 零第三方运行时依赖</p>
+  <p class="note">0.25.5 · 零第三方运行时依赖</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.4**.
+> Generated from `ai/components.json` + `ai/pitfalls*.json` + `ai/behaviors.json` at version **0.25.5**.
 > 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.4",
+  "version": "0.25.5",
   "description": "移动 Web 组件库：CSS + 可选行为脚本，零第三方运行时依赖。样式用 bundler 引入，交互行为用 script 标签引入。",
   "keywords": [
     "css",
@@ -23,6 +23,8 @@
       "default": "./esm/index.mjs"
     },
     "./tokens.css": "./dist/01-tokens/tokens.css",
+    "./tokens.core.css": "./dist/01-tokens/tokens.core.css",
+    "./base.reset.css": "./dist/01-tokens/base.reset.css",
     "./typography.css": "./dist/01-tokens/typography.css",
     "./page.css": "./dist/01-tokens/page.css",
     "./esm": {