agentcss 0.14.0 → 0.15.0

package/03-patterns/dropdown/README.md

@@ -10,6 +10,7 @@
 | `Esc` | 关闭，并把焦点**还给按钮** |
 | `Tab` | 关闭菜单（焦点移到下一个元素）|
 | `Enter` / `Space` | 激活当前项 |
+| 字母 / 数字（**可选**） | 跳到名字以该前缀开头的项（APG 标为 `(Optional)`；见下） |
 
 ## ⚠️ 另有两条容易漏的
 
@@ -66,12 +67,27 @@ menu.setAttribute('role', 'menu');
 `data-state` / `data-value`，**不用 class 切换** —— 这是全库 INVARIANT I-8
 （状态必须活在 DOM 属性上），也是门禁会查的东西。
 
-## 成熟度：beta（两条行为债，如实列出）
+## 成熟度：stable（行为零欠账）
 
-| 债 | 现在的后果 |
+两条历史债都收编了，记账在 `ai/behaviors.json`：
+
+| 曾经 | 现在 |
 |---|---|
-| `focus-return:manual` | 关闭后归位是手写的，不是统一机制 |
-| `typeahead:gap` | **没有类型搜索** —— APG 的 Menu Button 不硬性要求，但列表长时体验缺失 |
+| `focus-return:manual` | 0.8.6 收编：`open()` 里 `save()`、`close()` 里 `restore()`，替掉手写的 `btn.focus()` |
+| `typeahead:gap` | 0.15.0 收编：打字跳项走 typeahead 核（见下） |
+
+### 打字跳项（APG 的 `(Optional)` 项）
+
+打一个字母 ⇒ 跳到**下一个**以它开头的项；快速连打 ⇒ 前缀累积；连打同一个字母 ⇒
+在匹配项之间循环；不匹配 ⇒ **什么都不做**（APG 不要求"没找到"有反馈）。
+
+⚠️ **它天然只对拉丁字母标签有效**：中文标签靠输入法，而 IME 组字时 `keydown`
+给的是 `Process` / `Unidentified`，拿不到字符。所以判据用一张英文夹具测
+（`dropdown-check` ⑦），demo 的中文菜单不受影响、也不会因此变慢。
+
+⚠️ 匹配前会**剥掉开头的装饰符号**：带勾选的项文本是「✓ 按日期」，
+不剥的话打「按」永远匹配不到。这和 table 列头把 `↕` 念出来是同一类问题 ——
+装饰符号不该混进"名字"里。
 
 ## 反例
 

package/03-patterns/dropdown/dropdown.js

@@ -223,6 +223,72 @@
   };
   /* ==== BEHAVIOR INJECT END: dismissable ==== */
 
+  /* ==== BEHAVIOR INJECT BEGIN: typeahead ==== */
+  var flTypeahead = function (opts) {
+    var opt = opts || {};
+    var items = opt.items || function () { return []; };
+    var textOf = opt.textOf || function (x) { return String((x && x.textContent) || ''); };
+    var usable = opt.usable || function () { return true; };
+    var timeout = opt.timeout || 500;
+    var onHit = opt.onHit || function () {};
+    var buf = '';
+    var timer = null;
+    var last = -1;
+
+    function stop() {
+      if (timer) { clearTimeout(timer); timer = null; }
+    }
+
+    /* 连打同一字符 ⇒ 只按首字符匹配（理由见文件头 ③④）*/
+    function repeated(s) {
+      if (s.length < 2) return false;
+      for (var i = 1; i < s.length; i++) {
+        if (s.charAt(i) !== s.charAt(0)) return false;
+      }
+      return true;
+    }
+
+    function find(needle) {
+      var l = items() || [];
+      var n = l.length;
+      if (!n) return -1;
+      for (var k = 0; k < n; k++) {
+        var i = (last + 1 + k) % n;      /* ① 从当前项之后开始 ⇒ 会绕回 */
+        if (!usable(l[i])) continue;     /* ⑤ */
+        if (textOf(l[i]).toLowerCase().indexOf(needle) === 0) return i;
+      }
+      return -1;                          /* ⑥ */
+    }
+
+    function type(ch) {
+      if (!ch) return -1;
+      buf += String(ch).toLowerCase();    /* ② */
+      stop();
+      timer = setTimeout(clear, timeout); /* ④ */
+      var needle = repeated(buf) ? buf.charAt(0) : buf;   /* ③ */
+      var i = find(needle);
+      if (i >= 0) {
+        last = i;
+        onHit(i, (items() || [])[i], buf);
+      }
+      return i;
+    }
+
+    /* 只清缓冲，不清 last（理由见文件头）*/
+    function clear() {
+      buf = '';
+      stop();
+    }
+
+    return {
+      type: type,
+      clear: clear,
+      buffer: function () { return buf; },
+      destroy: function () { stop(); },
+    };
+  };
+  /* ==== BEHAVIOR INJECT END: typeahead ==== */
+
   /* ---- 旧环境兼容：Element.closest 在老 WebView 上不存在 ----
      直接调用会在真机上抛 `is not a function`（本地完全正常，
      只在老环境炸 —— 属静默失效）。这里做模块内兜底，
@@ -315,6 +381,8 @@
          焦点留在按钮上，菜单项永远进不去（真机用 NVDA + Edge 实测过）。
          APG 的菜单按钮也是这样：打开即把焦点交给第一项。 */
       focusAt(0);
+      /* 每次打开都从空缓冲开始：上次关菜单前打了一半的前缀不该留到这次 */
+      typeahead.clear();
       flEmit(root, 'fl-open', null);
       if (opt.onOpen) opt.onOpen();
     }
@@ -324,6 +392,7 @@
       menu.hidden = true;
       btn.setAttribute('aria-expanded', 'false');
       active = -1;
+      typeahead.clear();
       if (restoreFocus !== false) fr.restore();
       flEmit(root, 'fl-close', null);
       if (opt.onClose) opt.onClose();
@@ -359,6 +428,22 @@
       onMove: function (i) { focusAt(i); },
     });
 
+    /* ⑥ 打字跳项 —— APG Menu 的 `(Optional)` 项，走 typeahead 核。
+       匹配**可见文本**，但先剥掉开头的装饰符号：带勾选的项文本是
+       "✓ 按日期"，不剥的话打"按"永远匹配不到（同 table 列头 ↕ 那一类问题）。
+       ⚠️ 中文标签实际上打不出来：IME 走 keydown 时 key 是 Process / Unidentified。
+          这条是给拉丁字母标签的菜单用的 —— APG 的 typeahead 本来就是这个前提，
+          所以判据用一张英文夹具页测（见 dropdown-check ⑥）。 */
+    var typeahead = flTypeahead({
+      items: function () { return itemsOf(menu); },
+      textOf: function (el) {
+        var s = String((el && el.textContent) || '').replace(/\s+/g, ' ').trim();
+        return s.replace(/^[^0-9A-Za-z\u4e00-\u9fa5]+/, '');
+      },
+      usable: function (el) { return el.getAttribute('aria-disabled') !== 'true'; },
+      onHit: function (i) { focusAt(i); },
+    });
+
     /* ---------- 按钮 ---------- */
     /* 🔴 修：原来先 `setAttribute('aria-controls', menu.id || '')`
        **再**给 menu.id ⇒ aria-controls 永远拿到空串。
@@ -416,6 +501,17 @@
          留在原地会**关两次**（同一元素上的两个监听器，stopPropagation 挡不住
          同级的另一个监听器，那是 stopImmediatePropagation 的活）⇒ onClose 被调两遍。 */
 
+      /* ③b 可打印字符 ⇒ 跳到名字以它开头的项（APG 的 (Optional) 项）
+         · 空格排除：它的语义是"激活当前项"（下面 ④）
+         · 带 Ctrl / Meta / Alt 排除：那是浏览器快捷键
+         · isComposing 时排除：中文输入法正在组字，不能抢 */
+      if (k.length === 1 && k !== ' ' &&
+          !e.ctrlKey && !e.metaKey && !e.altKey && !e.isComposing) {
+        e.preventDefault();
+        typeahead.type(k);
+        return;
+      }
+
       /* ③ Tab 关闭（不拦截，让焦点自然走到下一个）*/
       if (k === 'Tab') { close(false); return; }
 
@@ -440,7 +536,10 @@
     return {
       open: open,
       close: close,
-      destroy: function () { roving.destroy(); dismiss.destroy(); menu.hidden = true; },
+      destroy: function () {
+        roving.destroy(); dismiss.destroy(); typeahead.destroy();
+        menu.hidden = true;
+      },
     };
   }
 

package/CHANGELOG.md

@@ -16,7 +16,57 @@
 
 （无）
 
-## [0.14.0] - 2026-10-30
+## [0.15.0] - 2026-10-31
+
+### 行为 · dropdown 的「打字跳项」收编 typeahead 核（**最后一个 beta 升 stable**）
+
+`ai/behaviors.json` 里最后一条真缺口是 `dropdown` 的 `typeahead:gap`：
+APG Menu 把"按字符跳到名字以它开头的项"列为 `(Optional)`，本库确实没做。
+这一轮补上，走 `typeahead` 核（不新写一份）。
+
+接线时补了两件核不管的事：
+
+- **打开/关闭都清缓冲**：上次关菜单前打了一半的前缀不该留到下次；
+- **匹配前剥掉开头的装饰符号**：带勾选的项文本是「✓ 按日期」，
+  不剥的话打「按」永远匹配不到。这和 table 列头把 `↕` 念出来是同一类问题 ——
+  装饰符号混进了"名字"里。
+
+⚠️ 一个必须写明的限制：**中文标签打不出来**。IME 组字时 `keydown` 给的是
+`Process` / `Unidentified`，拿不到字符。所以这条能力天然只对拉丁字母标签有效 ——
+这也是 APG 把它标成 Optional 的现实原因。判据因此用一张**英文夹具**测
+（只换标签、跑的是同一份 `Dropdown.create`），demo 的中文菜单不受影响。
+
+判据 6 条，每条各有独立突变体（删分支 / 去掉同字母特判 / 不累积前缀 /
+不剥装饰符号 / 没找到就跳首项 —— 每次只有对应的那条红）：
+
+| 判据 | 断言 | 只被哪个突变体打红 |
+|---|---|---|
+| ⑦ 首字母 | 打 `p` ⇒ Paste | 删掉打字分支 |
+| ⑦b 同字母循环 | `c` `c` ⇒ Copy → Cut | 去掉 `repeated()` 特判 |
+| ⑦c 前缀累积 | `s` `e` ⇒ Select all | 把 `buf +=` 改成 `buf =` |
+| ⑦d 不匹配不动 | 打 `z` 焦点不变 | `return -1` 改成 `return 0` |
+| ⑦e 关闭态 | 关着打字不开菜单 | 删掉打字分支 |
+| ⑦f 装饰符号 | 打 `c` 命中「✓ Copy」 | 去掉剥符号那一步 |
+
+### 判据 · 全库 stable 之后，ladder 怎么才算没瞎
+
+37 个组件全 stable，`maturity-gate` ③（"不得全落同一档"）按时报红。
+门禁自己写了两条路：加严判据，或显式声明台阶退役。这轮走了**第三条**，
+因为前两条都不诚实：为了"留几个 beta"而加严是拿数据凑判据，直接删掉 ③ 又是放走量具。
+
+⇒ ③ 改成：全库 stable 时先做**正向控制** —— 给一个真实组件临时塞一条合成债务，
+重算必须降成 beta；撤掉必须回到 stable。通过了才放行，并在输出里说明
+"阶梯退而不休"。**分支里唯一的证据就是"判据仍然会红"**，不是一个允许全绿的开关。
+
+反向控制也跟着换了：原来的突变体是"把矩阵洗白"（全改成 core）——
+全库达标后这已经是**合法状态**，突变消失了。改成"**把判据改松**"
+（让 `recompute` 忽略债务、一律返回 stable）⇒ 正向控制抓得到 ⇒ ③ 红，且只红这一条。
+
+### 体积
+
+`dropdown.js` 多背一份 typeahead 核（gzip **6.4 → 7.6 KB / +18.9%**）。
+全库 gzip 258.5 → 259.7 KB（**+0.46%**）。基线按显式重录记下（`size-baseline.py --record`）。
+
 
 ### 行为 · drawer / overlay 的「关得掉」收编进核（beta → stable）
 

package/README.zh-CN.md

@@ -83,7 +83,7 @@ npm install github:owain323/frontend-lib
 
 ## 组件一览
 
-共 **37** 个（stable 36 / beta 1）。每个组件目录下有 `README.md`（为什么这么做）和 `demo.html`（能直接抄的结构）。
+共 **37** 个（stable 37 · 全部通过四条判据）。每个组件目录下有 `README.md`（为什么这么做）和 `demo.html`（能直接抄的结构）。
 
 ### primitives · 基础件（15）
 

package/START-HERE.md

@@ -49,7 +49,7 @@
 | 日期区间 | `02-primitives/date-range/date-range.css` | 206 | **必需 301** (`date-range.js`) | 要选起止日期就要 |
 | 标签页 | `03-patterns/tabs/tabs.css` | 172 | **必需 316** (`tabs.js`) | 同层级内容切换就要 |
 | 折叠面板 | `03-patterns/accordion/accordion.css` | 453 | **必需 389** (`accordion.js`) | 长表单分段就要 |
-| 动作菜单（beta） | `03-patterns/dropdown/dropdown.css` | 135 | **必需 448** (`dropdown.js`) | 要一组动作（新建 / 导出 / 删除）就要 |
+| 动作菜单 | `03-patterns/dropdown/dropdown.css` | 135 | **必需 547** (`dropdown.js`) | 要一组动作（新建 / 导出 / 删除）就要 |
 | 文字提示 | `03-patterns/tooltip/tooltip.css` | 89 | **必需 280** (`tooltip.js`) | 图标按钮或缩写需要一句话解释就要 |
 | 分页 | `03-patterns/pagination/pagination.css` | 195 | **必需 401** (`pagination.js`) | 数据多到要翻页就要 |
 | 树形 | `03-patterns/tree/tree.css` | 122 | **必需 464** (`tree.js`) | 层级数据（文件 / 组织 / 分类）要展开就要 |

package/ai/START-HERE.md

@@ -30,7 +30,7 @@
 > 它的值直接从 `ai/components.json` 与目录实际内容读出来 —— **不信上面的说法，信这个**。
 
 <!-- ==== AI-INVENTORY-BEGIN ==== -->
-- 组件 **37** 个（`beta` 1 · `stable` 36）
+- 组件 **37** 个（`stable` 37）
 - `04-recipes/`（页面级示例）：`analysis-report`（组合型研究报告：正文 + 辅助栏并排，窄屏退回单栏） · `data-showcase`（四种数据表达方式对照：我到底该用哪个） · `detail-page`（实体详情页骨架：字段齐全 / 部分缺失 / 无数据，三态同构（DOM 不变）） · `longform`（单栏长文排版与阅读节奏） · `report`（报告版式系统 v1：共享基础 + 三种版式取舍（杂志 / 科研技术 / 金融研究）） · `table`（专业数据表格：列级格式与单位，三种用途预设）
 - `09-assets/`（图表与可视化）：`bar`（柱状图，含图表规范的裁剪铁律） · `echarts-adapter`（把令牌喂给 ECharts，按需引入；本库不含 ECharts） · `model-viewer`（惰性加载的 3D 模型查看器） · `scientific-plot`（二维科学绘图：坐标轴 / 误差棒 / 置信区间带 / 对数轴） · `sparkline`（迷你趋势线，没有坐标轴的走势提示）
 <!-- ==== AI-INVENTORY-END ==== -->

package/ai/behaviors.json

@@ -29,7 +29,7 @@
   },
   "budget": {
     "manual": 0,
-    "gap": 1
+    "gap": 0
   },
   "matrix": {
     "dismissable": {
@@ -316,8 +316,8 @@
         "没有候选项集合"
       ],
       "dropdown": [
-        "gap",
-        "APG 菜单支持'按首字母跳到菜单项'（可选增强），本库未实现；要做就走 typeahead 核"
+        "core",
+        "0.15.0 收编：APG Menu 的 `(Optional)` 项「按字符跳项」走 typeahead 核。删掉自写的匹配逻辑（本来也没有），接线时补了两件事：① 匹配前剥掉开头的装饰符号（带勾选的项文本是「✓ 按日期」，不剥就永远匹配不到，同 table 列头 ↕ 那类问题）；② open/close 都清缓冲。判据 dropdown-check ⑦（首字母）/ ⑦b（同字母循环）/ ⑦c（前缀累积）/ ⑦d（不匹配不动）/ ⑦e（关着时打字不开菜单）/ ⑦f（装饰符号不进匹配文本），五条各有独立突变体。"
       ],
       "flip": [
         "n/a",

package/ai/components.json

@@ -1,21 +1,20 @@
 {
   "schemaVersion": "1.0.0",
   "generatedBy": "05-audit/gen-ai-contract.py",
-  "libraryVersion": "0.14.0",
+  "libraryVersion": "0.15.0",
   "$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 36 / beta 1**（本行由生成器算出，不要手改）。",
-    "$strictImpact": "⚠️ strict 档位只放行 stable ⇒ 1 个组件在 strict 下不可用：dropdown。放宽 strict 会让「未收编的手写行为」进入生产路径。（本行由生成器算出，不要手改）"
+    "$whyFourth": "🔴 为什么第四条判据不能省：用前三条时多数组件会**全是 stable** ⇒ ladder 没有任何鉴别力（对标 Primer 六档阶梯，每档都有硬判据）。补上「行为欠账」这一条后：**stable 37 / beta 0**（本行由生成器算出，不要手改）。全库达标时 ladder 靠**正向控制**证明还有鉴别力（maturity-gate ③：塞一条合成债务必须降 beta），不是靠\"总得留几个 beta\"。",
+    "$strictImpact": "✅ strict 档位放行全部 37 个组件 —— 没有任何组件带着未收编的手写行为或未做的行为（本行由生成器算出，不要手改）"
   },
   "summary": {
     "total": 37,
     "byMaturity": {
-      "stable": 36,
-      "beta": 1
+      "stable": 37
     },
     "byTier": {
       "primitive": 15,
@@ -399,14 +398,12 @@
       "tier": "pattern",
       "purpose": "下拉菜单",
       "rootClass": "dd",
-      "maturity": "beta",
+      "maturity": "stable",
       "maturityReasons": {
         "hasDemo": true,
         "hasDedicatedGate": true,
         "statesOnDomAttributes": true,
-        "behaviorDebt": [
-          "typeahead:gap"
-        ]
+        "behaviorDebt": []
       },
       "gates": [
         "dropdown-check.js"

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

@@ -196,6 +196,68 @@ if (k >= 0) shared.stack.splice(k, 1);
 };
 };
 
+var flTypeahead = function (opts) {
+var opt = opts || {};
+var items = opt.items || function () { return []; };
+var textOf = opt.textOf || function (x) { return String((x && x.textContent) || ''); };
+var usable = opt.usable || function () { return true; };
+var timeout = opt.timeout || 500;
+var onHit = opt.onHit || function () {};
+var buf = '';
+var timer = null;
+var last = -1;
+
+function stop() {
+if (timer) { clearTimeout(timer); timer = null; }
+}
+
+function repeated(s) {
+if (s.length < 2) return false;
+for (var i = 1; i < s.length; i++) {
+if (s.charAt(i) !== s.charAt(0)) return false;
+}
+return true;
+}
+
+function find(needle) {
+var l = items() || [];
+var n = l.length;
+if (!n) return -1;
+for (var k = 0; k < n; k++) {
+var i = (last + 1 + k) % n;
+if (!usable(l[i])) continue;
+if (textOf(l[i]).toLowerCase().indexOf(needle) === 0) return i;
+}
+return -1;
+}
+
+function type(ch) {
+if (!ch) return -1;
+buf += String(ch).toLowerCase();
+stop();
+timer = setTimeout(clear, timeout);
+var needle = repeated(buf) ? buf.charAt(0) : buf;
+var i = find(needle);
+if (i >= 0) {
+last = i;
+onHit(i, (items() || [])[i], buf);
+}
+return i;
+}
+
+function clear() {
+buf = '';
+stop();
+}
+
+return {
+type: type,
+clear: clear,
+buffer: function () { return buf; },
+destroy: function () { stop(); },
+};
+};
+
 function closest(el, sel) {
 if (!el) return null;
 if (el.closest) return el.closest(sel);
@@ -269,6 +331,8 @@ btn.setAttribute('aria-expanded', 'true');
 active = -1;
 
 focusAt(0);
+
+typeahead.clear();
 flEmit(root, 'fl-open', null);
 if (opt.onOpen) opt.onOpen();
 }
@@ -278,6 +342,7 @@ function close(restoreFocus) {
 menu.hidden = true;
 btn.setAttribute('aria-expanded', 'false');
 active = -1;
+typeahead.clear();
 if (restoreFocus !== false) fr.restore();
 flEmit(root, 'fl-close', null);
 if (opt.onClose) opt.onClose();
@@ -307,6 +372,16 @@ tabindex: false,
 onMove: function (i) { focusAt(i); },
 });
 
+var typeahead = flTypeahead({
+items: function () { return itemsOf(menu); },
+textOf: function (el) {
+var s = String((el && el.textContent) || '').replace(/\s+/g, ' ').trim();
+return s.replace(/^[^0-9A-Za-z\u4e00-\u9fa5]+/, '');
+},
+usable: function (el) { return el.getAttribute('aria-disabled') !== 'true'; },
+onHit: function (i) { focusAt(i); },
+});
+
 if (!menu.id) menu.id = 'dd-menu-' + (new Date()).getTime();
 btn.setAttribute('aria-haspopup', 'true');
 btn.setAttribute('aria-expanded', 'false');
@@ -341,6 +416,13 @@ return;
 
 if (closest(e.target, '[data-dd-menu]') !== menu) return;
 
+if (k.length === 1 && k !== ' ' &&
+!e.ctrlKey && !e.metaKey && !e.altKey && !e.isComposing) {
+e.preventDefault();
+typeahead.type(k);
+return;
+}
+
 if (k === 'Tab') { close(false); return; }
 
 if (k === 'Enter' || k === ' ' || k === 'Spacebar') {
@@ -360,7 +442,10 @@ onDismiss: function (e, reason) { close(reason === 'esc'); },
 return {
 open: open,
 close: close,
-destroy: function () { roving.destroy(); dismiss.destroy(); menu.hidden = true; },
+destroy: function () {
+roving.destroy(); dismiss.destroy(); typeahead.destroy();
+menu.hidden = true;
+},
 };
 }
 

package/dist/COSTS.md

@@ -36,7 +36,7 @@
 | pattern | `accordion` | 2.7 KB | 1.3 KB | 1.8 KB | **5.8 KB** | 34.1 KB | −28.3 KB |
 | pattern | `content` | 2.7 KB | 1.0 KB | — | **3.7 KB** | 24.2 KB | −20.5 KB |
 | pattern | `drawer` | 2.7 KB | 0.8 KB | 2.4 KB | **5.9 KB** | 26.1 KB | −20.2 KB |
-| pattern | `dropdown` | 2.7 KB | 0.8 KB | 2.9 KB | **6.4 KB** | 27.9 KB | −21.5 KB |
+| pattern | `dropdown` | 2.7 KB | 0.8 KB | 3.4 KB | **6.9 KB** | 29.1 KB | −22.2 KB |
 | pattern | `form-validation` | 2.7 KB | 0.8 KB | — | **3.5 KB** | 24.1 KB | −20.7 KB |
 | pattern | `list` | 2.7 KB | 0.6 KB | — | **3.3 KB** | 22.0 KB | −18.7 KB |
 | pattern | `nav` | 2.7 KB | 1.2 KB | 2.6 KB | **6.6 KB** | 30.7 KB | −24.1 KB |
@@ -50,8 +50,8 @@
 
 ## 三、全库
 
-- 全部组件都用上（min，含 tokens 一份）：**62.1 KB**
-- 源码版（带注释）全库 gzip：304.3 KB
+- 全部组件都用上（min，含 tokens 一份）：**62.6 KB**
+- 源码版（带注释）全库 gzip：305.5 KB
 
 > ⚠️ 源码版那个数字**不是**要付的钱：它包含我们的注释（全库 CSS 有 67% 是注释，字节口径）。
 > 它的用途只有一个 —— 让人看清"dist 到底省了多少"。

package/docs/A11Y-MANUAL-PROTOCOL.md

@@ -82,10 +82,10 @@ python3 -m http.server 8000 --bind 127.0.0.1
 
 > **为什么后三行是补的**：`accordion` / `drawer` / `dropdown` 当时都是 beta 组件，
 > 而它们升 stable 的判据之一就是「行为零欠账」——人工读屏是这件事**唯一的用户侧证据**。
-> （0.14.0 把 drawer / overlay 的 dismissable 收编进核之后，两者已升 stable；
-> accordion 的 `roving:gap` 经核对 APG 原文后判定为**判据写错**（APG Accordion 没有
-> 方向键），已改为 `n/a`。`ai/components.json` 当前记 **1 个 beta**：dropdown
-> —— 它的 `typeahead:gap` 是真的：APG Menu 把"按字符跳项"列为 Optional，本库没做。）
+> （0.14.0 把 drawer / overlay 的 dismissable 收编进核；accordion 的 `roving:gap`
+> 经核对 APG 原文后判定为**判据写错**（APG Accordion 没有方向键），改为 `n/a`；
+> 0.15.0 补上 dropdown 的 typeahead。`ai/components.json` 当前 **37 个全 stable**，
+> 阶梯靠正向控制证明仍能区分有债的组件。）
 > 只覆盖 `overlay` 一个浮层，等于对其他浮层的真实表现没有任何记录。
 
 **本轮跑出来并已修掉的一条真缺陷**：`table` 的列头按钮被念成「公司 · `↕` · 按钮」——

package/docs/ACCESSIBILITY.md

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

package/index.html

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcss",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "移动 Web 组件库：CSS + 可选行为脚本，零第三方运行时依赖。样式用 bundler 引入，交互行为用 script 标签引入。",
   "keywords": [
     "css",