agentcss 0.25.4 → 0.25.6

package/dist/02-primitives/date-range/date-range.js

@@ -146,7 +146,14 @@ return true;
 }
 
 function paintSummary(s) {
-if (summary) summary.innerHTML = s ? ('区间 <b>' + s + '</b>') : '';
+
+if (!summary) return;
+summary.textContent = '';
+if (!s) return;
+summary.appendChild(document.createTextNode('区间 '));
+var b = document.createElement('b');
+b.textContent = s;
+summary.appendChild(b);
 }
 
 function emit() {
@@ -186,6 +193,7 @@ presets = presets.filter(function (x) { return opt.presets.indexOf(x.key) >= 0;
 }
 var box = root.querySelector('[data-dr-presets]');
 if (!box) return;
+
 box.innerHTML = presets.map(function (p) {
 return '<button class="drange__preset" type="button" aria-pressed="false" ' +
 'data-dr-preset="'+ p.key + '">' + p.label + '</button>';

package/dist/02-primitives/popover/popover.js

@@ -148,6 +148,7 @@ box.setAttribute('inert', '');
 
 box.setAttribute('role', 'dialog');
 box.setAttribute('aria-label', opts.label || '');
+
 box.innerHTML =
 '<span class="popover__arrow" aria-hidden="true"></span>'+
 '<div class="popover__body">'+ (opts.html || '') + '</div>';

package/dist/03-patterns/drawer/drawer.js

@@ -210,6 +210,7 @@ head.appendChild(closeBtn);
 
 var body = document.createElement('div');
 body.className = 'drawer__body';
+
 if (typeof opt.content === 'string') body.innerHTML = opt.content;
 else if (opt.content) body.appendChild(opt.content);
 

package/dist/04-recipes/app-shell/shell-nav.js

@@ -75,6 +75,7 @@ btn.type = 'button';
 btn.className = 'shell__menu';
 btn.setAttribute('aria-label', o.label || ('打开' + title));
 btn.setAttribute('aria-haspopup', 'dialog');
+
 btn.innerHTML = ICON;
 btn.addEventListener('click', function () { self.open(); });
 topbar.insertBefore(btn, topbar.firstChild);

package/dist/09-assets/model-viewer/model-viewer.js

@@ -68,8 +68,14 @@ this.btn.addEventListener('click', function () { self.load(); });
 this.ui.appendChild(this.btn);
 
 this.hint = el('p', 'mv__hint');
-this.hint.innerHTML = '模型 <code>' + (this.src.split('/').pop() || '—') +
-'</code> 会<b>点击后才下载</b>，首屏不占流量。';
+
+var fname = el('code', null, this.src.split('/').pop() || '—');
+var strong = el('b', null, '点击后才下载');
+this.hint.appendChild(document.createTextNode('模型 '));
+this.hint.appendChild(fname);
+this.hint.appendChild(document.createTextNode(' 会'));
+this.hint.appendChild(strong);
+this.hint.appendChild(document.createTextNode('，首屏不占流量。'));
 this.ui.appendChild(this.hint);
 
 if (!hasWebGL()) {
@@ -260,6 +266,7 @@ self.raf = requestAnimationFrame(loop);
 self.ui.innerHTML = '';
 var cap = el('p', 'mv__cap');
 var dt = Math.round(((window.performance && performance.now) ? performance.now() : Date.now()) - t0);
+
 cap.innerHTML = '模型 <b>' + fmtKB(bytes || self.lastBytes || 0) + '</b> · 引擎就绪耗时 <b>' + dt + 'ms</b>' +
 (controls ? ' · 拖动可旋转，滚轮/双指可缩放' : ' · 未加载控制器，无法拖动');
 self.node.appendChild(cap);

package/dist/09-assets/scientific-plot/scientific-plot.js

@@ -501,6 +501,7 @@ return String(s == null ? '' : s)
       legendHtml = '<ul class="splot__legend">' + items.join('') + '</ul>';
     }
 
+    /* @html-sink internal — svg 由本文件生成，图例名字已过 esc() */
     el.innerHTML = svg + legendHtml;
     return {
       svg: el.firstChild,

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.6` |
+| 声明日期 | 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/docs/LAYER-BASELINE.md

@@ -25,7 +25,7 @@
 > ⇒ 它支撑的结论是「我们在这 7 个环境里试过，结果如下」，
 > 不是「我们保证这 7 个环境一直能用」。
 > 逐项结果（7 行 × 15 项）、15 项全集与复核方法见
-> [`10-review/webview/RESULTS.md`](../10-review/webview/RESULTS.md)。
+> [`10-review/webview/RESULTS.md`](https://github.com/owain323/frontend-lib/blob/master/10-review/webview/RESULTS.md)。
 
 ---
 
@@ -146,7 +146,7 @@ Android 上 Chrome ≠ 系统 WebView ≠ 各家 App 内置 WebView。**入口
 |---|---|
 | 数据怎么来的 | 在真实设备上打开 `10-review/webview/capability-probe.html`，把页面输出的结果贴进上表 |
 | 有没有原始记录 | 🔴 **没有入库**。当时探针把 JSON POST 回采集端，落的是本机文件，仓库里只留下转录进表格的结论 |
-| 逐项结果在哪看 | [`10-review/webview/RESULTS.md`](../10-review/webview/RESULTS.md) —— 7 行 × 15 项矩阵 |
+| 逐项结果在哪看 | [`10-review/webview/RESULTS.md`](https://github.com/owain323/frontend-lib/blob/master/10-review/webview/RESULTS.md) —— 7 行 × 15 项矩阵 |
 | 别人怎么复核 | 同上文件「怎么自己复核一行」：取 UA → 在目标设备复跑探针 → 比对 `N / 15` 与缺失项 |
 | 日期锚点 | 表格「测试日期」列写的是「见采集所在提交（git log）」；用 `git blame` + 该行 UA 的唯一片段定位 |
 | 有没有自动化守着 | **没有**。人工一次性实测，浏览器升级不会触发任何门禁 |

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.6 · 零第三方运行时依赖</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.6**.
 > 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.6",
   "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": {
@@ -71,7 +73,17 @@
     "CODE_OF_CONDUCT.md",
     "CHANGELOG.md",
     "LICENSE",
-    "index.html"
+    "index.html",
+    "!**/*.bak",
+    "!**/*.tmp",
+    "!**/*.orig",
+    "!**/*.rej",
+    "!**/*.old",
+    "!**/*.pyc",
+    "!**/*.log",
+    "!**/.DS_Store",
+    "!**/Thumbs.db",
+    "!**/__parity_probe.js"
   ],
   "sideEffects": [
     "**/*.css",
@@ -84,9 +96,9 @@
     "gate:fast": "bash 05-audit/check-all.sh --fast",
     "gate:timing": "bash 05-audit/check-all.sh --timing",
     "ci:observe": "python3 05-audit/nightly-observe.py",
-            "ci:print-cost": "node 05-audit/print-pagination-cost.js",
-"ci:print-audit": "node 05-audit/print-content-audit.js --all",
-"ci:merge-exp": "node 05-audit/render-merge-experiment.js",
+    "ci:print-cost": "node 05-audit/print-pagination-cost.js",
+    "ci:print-audit": "node 05-audit/print-content-audit.js --all",
+    "ci:merge-exp": "node 05-audit/render-merge-experiment.js",
     "ci:zoom-merge": "node 05-audit/zoom-merge-experiment.js --all",
     "size:record": "python3 05-audit/size-baseline.py --record",
     "dist": "python3 05-audit/build-dist.py",