agentcss 0.13.2 → 0.15.0

package/03-patterns/overlay/overlay.js

@@ -357,6 +357,73 @@
     };
   };
   /* ==== BEHAVIOR INJECT END: focus-return ==== */
+
+  /* ==== BEHAVIOR INJECT BEGIN: dismissable ==== */
+  var flDismissable = function (opts) {
+    var opt = opts || {};
+    var escOn = opt.escOn || [];
+    var inside = opt.inside || [];
+    var outside = opt.outside !== false;
+    var when = opt.when || function () { return true; };
+    var onDismiss = opt.onDismiss || function () {};
+
+    var shared = window.__flDismiss || (window.__flDismiss = { stack: [], bound: false });
+
+    function isInside(node) {
+      if (!node) return false;
+      for (var i = 0; i < inside.length; i++) {
+        var el = inside[i];
+        if (!el || !el.contains) continue;
+        if (el === node || el.contains(node)) return true;
+      }
+      return false;
+    }
+
+    function onKey(e) {
+      if (!when()) return;
+      var k = e.key;
+      if (k !== 'Escape' && k !== 'Esc' && e.keyCode !== 27) return;
+      /* 先问 onDismiss，它返回 false 就不干预（分级 Esc，见文件头 ⑤） */
+      var closed = onDismiss(e, 'esc');
+      if (closed === false) return;
+      if (e.preventDefault) e.preventDefault();
+      if (e.stopPropagation) e.stopPropagation();
+    }
+
+    function onDocClick(e) {
+      var top = null;
+      for (var i = shared.stack.length - 1; i >= 0; i--) {
+        if (shared.stack[i].when()) { top = shared.stack[i]; break; }
+      }
+      if (!top || top.isInside(e.target)) return;
+      top.onDismiss(e, 'outside');
+    }
+
+    var rec = { when: when, isInside: isInside, onDismiss: onDismiss };
+
+    for (var j = 0; j < escOn.length; j++) {
+      if (escOn[j]) escOn[j].addEventListener('keydown', onKey);
+    }
+    /* 只有"点外部要关"的层才进栈：栈是给 onDocClick 挑最内层用的，
+       模态层不该被这条规则选中（见文件头 ④）。
+       ⚠️ Esc 不依赖栈（它挂在元素上），所以不进栈不影响 Esc。 */
+    if (outside) shared.stack.push(rec);
+    if (!shared.bound) {
+      shared.bound = true;
+      document.addEventListener('click', onDocClick, true);
+    }
+
+    return {
+      destroy: function () {
+        for (var j = 0; j < escOn.length; j++) {
+          if (escOn[j]) escOn[j].removeEventListener('keydown', onKey);
+        }
+        var k = shared.stack.indexOf(rec);
+        if (k >= 0) shared.stack.splice(k, 1);
+      },
+    };
+  };
+  /* ==== BEHAVIOR INJECT END: dismissable ==== */
   function dialog(opts) {
     opts = opts || {};
 
@@ -432,26 +499,25 @@
     openStack.push(stackEntry);
     if (!useInert) uninstallIsolation = installIsolation(stackEntry);
 
+    /* ① Esc 走 dismissable 核（0.14.0 收编）。
+       `outside: false` 是模态的定义：点外部**不该关**。核里这个开关专门
+       为它加的（不进栈 ⇒ 不参与"点外部关最内层"的仲裁）。
+       ⚠️ 点遮罩关闭是**另一件事**，不归核管：它带 danger / closeOnBackdrop
+          两个前置条件，是组件自己的语义（见下方 mousedown）。
+       关于"为什么不再手写 stopPropagation"：核在 onDismiss 之后统一
+       preventDefault + stopPropagation，一次 Esc 只关最内层的语义与
+       以前实测一致（两个 backdrop 是兄弟节点，本来也冒泡不到外层）。 */
+    var dm = flDismissable({
+      escOn: [box],
+      outside: false,
+      when: function () { return !closed; },
+      onDismiss: function () { close(); },
+    });
+
     /* ------------------------------------------------------------ 焦点 */
     function focusables() { return focusableIn(box); }
 
     box.addEventListener('keydown', function (e) {
-      if (e.key === 'Escape') {
-        e.preventDefault();
-        /* ⚠️ 防御性 stopPropagation —— 保留，但**当前结构下它不改变任何行为**。
-         * 等价突变体实测：删掉这一行，一次 Esc 仍然只关最内层。
-         * 原因：两个 `.dialog-backdrop` 是 `body` 的**兄弟**节点，外层 box 不是
-         * 内层的祖先，所以内层按钮的 keydown 冒泡路径是
-         *      button → .dialog → .dialog-backdrop → body
-         * —— 根本到不了外层的 `.dialog`（实测 `outer.contains(inner) === false`）。
-         * 原注释写「不拦住会一次关两层」，那是**假设了 DOM 嵌套**，与实现不符。
-         * 保留理由：若将来改成「内层放进外层 box」的真嵌套，这行就必需。
-         * 判据 `pattern-behavior-check.js ⑬` 验证的是**行为**（只关最内层），
-         * 它抓不到删除本行的突变 —— 那是等价突变体，不是判据失效。 */
-        e.stopPropagation();
-        close();
-        return;
-      }
       if (e.key !== 'Tab') return;
 
       /* focus trap：Tab 在弹层内循环，绝不跑到背后的页面去 */
@@ -527,6 +593,9 @@
     function close() {
       if (closed) return;
       closed = true;
+      /* 核的 Esc 监听器要摘（outside:false ⇒ 它本来就没进栈，
+         但 destroy 仍然必须调用：摘监听器与摘栈是同一件事的两半）。 */
+      dm.destroy();
 
       /* 🔴 焦点归还前先看清**焦点现在在谁手里**（必须在移除 backdrop 之前读，
          移除之后 activeElement 会变成 body）。

package/03-patterns/tooltip/tooltip.js

@@ -60,6 +60,7 @@ var flDismissable = function (opts) {
   var opt = opts || {};
   var escOn = opt.escOn || [];
   var inside = opt.inside || [];
+  var outside = opt.outside !== false;
   var when = opt.when || function () { return true; };
   var onDismiss = opt.onDismiss || function () {};
 
@@ -79,19 +80,7 @@ var flDismissable = function (opts) {
     if (!when()) return;
     var k = e.key;
     if (k !== 'Escape' && k !== 'Esc' && e.keyCode !== 27) return;
-    /* 🔴 为什么 onDismiss 在前、preventDefault/stopPropagation 在后
-       （0.8.8 改）：**分级 Esc** 需要核让组件有机会说"这次我没关"。
-       combobox 的 Esc 是三级的：
-         ① 列表开着 → 关列表
-         ② 列表关了、输入有字 → 清空输入
-         ③ 都没了 → 什么都不做（此时**不该**阻止默认行为，
-            让 Esc 能继续传给外层浮层）
-       而原实现是「无条件 preventDefault + stopPropagation，再调 onDismiss」
-       ⇒ 组件根本无法表达"这次我没关"。
-       ⇒ 改成：先问onDismiss，它返回 false 就**不干预**默认行为。
-       ⚠️ 顺序安全性：stopPropagation 只需在**本次监听器执行期间**被调用即可
-          阻止冒泡到外层，放在 onDismiss 之后仍然有效。
-    */
+    /* 先问 onDismiss，它返回 false 就不干预（分级 Esc，见文件头 ⑤） */
     var closed = onDismiss(e, 'esc');
     if (closed === false) return;
     if (e.preventDefault) e.preventDefault();
@@ -112,7 +101,10 @@ var flDismissable = function (opts) {
   for (var j = 0; j < escOn.length; j++) {
     if (escOn[j]) escOn[j].addEventListener('keydown', onKey);
   }
-  shared.stack.push(rec);
+  /* 只有"点外部要关"的层才进栈：栈是给 onDocClick 挑最内层用的，
+     模态层不该被这条规则选中（见文件头 ④）。
+     ⚠️ Esc 不依赖栈（它挂在元素上），所以不进栈不影响 Esc。 */
+  if (outside) shared.stack.push(rec);
   if (!shared.bound) {
     shared.bound = true;
     document.addEventListener('click', onDocClick, true);

package/04-recipes/table/table.css

@@ -73,10 +73,14 @@
 }
 
 /* ⭐ 排序指示符改用 mask 画，不再用文字字形。
-   原因：Chromium 会把 ::after 的 `content` 文本算进**可访问名**，读屏于是念出
-   「公司 · ↕ · 按钮」—— 这个符号对用户毫无意义，而且自动检查抓不到（名字非空即过）。
-   换成图像后字形不进无障碍树；三态形状、`opacity`、暗色跟随（currentColor）全不变。
-   ⚠️ 不要改回 `content: "↕" / ""` 这种替代文本语法：Firefox 不支持，箭头会直接消失。 */
+   原因：浏览器会把 ::after 的 `content` 文本算进**可访问名**（name-from-contents，
+   `<button>` / `<a>` 这类），读屏于是念出「公司 · ↕ · 按钮」—— 这个符号对用户毫无意义，
+   而且自动检查抓不到（名字非空即过）。换成图像后字形不进无障碍树。
+   ⚠️ 不要改回 `content: "↕"` 的字形写法，那会把符号念出来。
+   ⚠️ 也先别改成 `content: "↕" / ""` 的替代文本语法：三引擎实测**都支持**、也都能清掉 ↕，
+     但它要 Chromium 108 / Firefox 128 / Safari 17.4 起才认，更老的引擎会丢掉整条声明
+     ⇒ 箭头彻底消失（支持矩阵里有 Chromium 97，正好在门槛外）。
+     实测矩阵见 docs/A11Y-MANUAL-PROTOCOL.md。 */
 .table__sort::after {
   content: "";                       /* 空内容 ⇒ 不进可访问名 */
   inline-size: .85em;

package/CHANGELOG.md

@@ -16,6 +16,163 @@
 
 （无）
 
+## [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）
+
+`ai/behaviors.json` 里这两格写着 `manual` 已经很久了，理由也很诚实：0.8.6 评估过，
+但核当时只有"点外部一律关"，而这两个都是**模态** —— 收编等于给它们引入错误行为。
+于是 Esc 各留一份手写实现，I-14 的病留在原地。
+
+这次补的是核缺的那一半：`outside: false`（模态层**不进栈**）。
+不进栈的后果写进了核文件头：模态层不再参与"点外部关最内层"的仲裁 ——
+它压根不该被这条规则选中；Esc 走元素监听器，与栈无关。
+
+- `drawer`：删掉手写的 Esc 分支与 `if (e.target === host) close()`；
+  `inside` 只放抽屉本体，遮罩**不在** inside 里（放进去就等于声明"点遮罩算内部"）。
+- `overlay`：删掉手写的 Esc 分支；点遮罩关闭仍是它自己的语义
+  （带 `danger` / `closeOnBackdrop` 两个前置条件），没并进核。
+
+判据跟着补，且都不是"改完再看一眼"：
+
+- `dismissable-check` ⑧ 模态点外部不关、⑧b Esc 仍关得掉（两半分开断 ——
+  只断"不关"的话，把关闭路径整条删掉也能过）、⑨ 模态不进栈（模态里开菜单，
+  点外面只关菜单）。自检突变从 3 个加到 **5 个**，新增的两个专打 `outside`。
+- `drawer-check` ⑧ 点抽屉内部不关、⑨ 点遮罩关闭。
+- `overlay-check` ⑤c `body` 上的外部点击不关模态。
+- 反向实验：把遮罩写进 drawer 的 `inside` ⇒ ⑨ 红；把 overlay 的 `outside` 改回
+  `true` ⇒ ⑤c 红。
+
+成熟度：**stable 36 / beta 1**（原 33 / 4），`strict` 档位下不可用的组件从 4 个降到 1 个
+（只剩 `dropdown` 的 `typeahead:gap`）。`budget.manual` 棘轮从 2 收到 **0**。
+
+### 判据 · accordion 那格 `roving:gap` 是**写错了**，不是没做
+
+同一轮里核对 APG 原文才发现：`ai/behaviors.json` 里 accordion 的 roving 写着
+"APG 把方向键列为**可选**增强，本库未实现" —— 这句话不成立。APG Accordion 的
+Keyboard Interaction 只有 `Enter`/`Space`、`Tab`、`Shift+Tab` 三项，
+**没有**方向键 / Home / End，也没有"可选"字样（w3.org 原文，2026-10-30 取）。
+
+而组件 README 第 68 行早就写了同一个结论，还多给了一条更硬的理由：
+移动端的方向键就是**页面滚动键**，抢过来会直接和滚动打架。
+⇒ 矩阵没跟上组件自己的文档，让 accordion 白背了一个 beta。
+
+改成 `n/a`（附核对日期与链接），不是"为了升 stable 而改判据"——同一轮里
+`dropdown` 的 `typeahead:gap` **保留**：APG Menu 明确把"按字符跳项"列为
+`(Optional)`，本库确实没做。两格按同一条标准判：矩阵记的是**规范要求什么**，
+不是我们想不想做。
+
+**体积代价**：两个组件各多背一份核 ⇒ gzip 总体积 **+0.49%**（257.2 → 258.5 KB），
+`drawer.js` 单文件 gzip 3.4 → 4.5 KB（+32.7%）。这是「注入而非运行时依赖」的既定代价，
+`size-baseline` 已按显式重录记下。顺带把注入块里 429 字节的长注释挪回核文件头
+（8 个使用点都背一份），把原本 +1.53% 压回 +0.49%。
+
+### 判据 · 「打开」的三条输入路径现在有一张矩阵
+
+起因不是新 bug，是**判据的覆盖面**：`dropdown` 的菜单开了、焦点留在按钮上，
+而当时 212 道门禁全绿 —— 因为那条判据只按了 `↓`。读屏在浏览模式按 Enter，
+浏览器把它变成**一次点击**，走的是另一条分支。
+
+新增 `05-audit/opener-path-check.js`：`dropdown` / `select` / `popover` / `overlay` /
+`drawer` 五个"点一下就开"的组件 × 三条路径（键盘 / 鼠标点击 / 读屏合成点击），
+每格断言「打开 + 焦点到位」，并额外判**三条路径结果必须一致**——不一致本身就是缺陷，
+哪怕每种结果单独看都能自圆其说。
+
+「焦点到位」按组件各自的合法形态断：菜单 / 对话框 / 气泡是**焦点移进弹层**；
+select-only combobox 是**焦点留在按钮 + `aria-activedescendant` 指向选中项**。
+后者是这一轮实测出来的：拿"DOM 焦点必须进列表"去要求它，会把自己判成缺陷。
+
+`--selftest` 用一张故意写坏的夹具证明它分得清三条路：只监听 `keydown` 的实现在
+键盘上绿、在另两条上红；只监听 `pointerdown` 的只在鼠标上绿；开得了但不动焦点的
+三条全红，且**"没打开"与"打开了没移焦"分开判**。
+
+结论：五个组件 15 格全绿 —— 这一类没有新缺陷，变的是判据，不是实现。
+
+### 文档 · select 的「焦点落在选中项」说清了是哪一种焦点
+
+原文只写"落在选中项（不是第一项，也不是按钮）"。实际实现是
+`aria-activedescendant` 指过去、DOM 焦点留在按钮上 —— 这是 APG 对
+select-only combobox 的合法形态，但按字面拿 `document.activeElement` 去核对会判成缺陷。
+已补一段说明「活动项 ≠ DOM 焦点」，并指出判据是按哪一种断的。
+
+### 文档 · 无障碍人工测试补上「标题层级」这一格
+
+九个页面的 `H` 键逐级跳从"未执行"变成实测结论：NVDA 念出的 **107/107 条**级别与页面
+结构逐条一致，九页走到底都念「往下没有标题」。证据是读屏交给语音合成器的原文，不是
+人耳旁听 —— 与第一轮同样的口径。
+
+同一轮把机器侧的结构扫描从 9 页扩到**全站 96 页 / 887 个标题**：每页恰好一个 `h1`、
+跳级 0 处、空名 0 个，层级只到 3 级（`h1×96 · h2×581 · h3×210`），DOM 里的标题数与
+无障碍树里的 heading 节点数逐页相等。
+
+三条 axe 规则（`heading-order` / `page-has-heading-one` / `empty-heading`）各做了一次
+破坏实验，确认真的会红；外加一条反向对照（合法的 `h3 → h4` 仍然全绿），
+证明它们不是"见到 `h4` 就报"。实验表在
+[docs/A11Y-MANUAL-PROTOCOL.md](docs/A11Y-MANUAL-PROTOCOL.md)。
+
+### 文档 · 协议页补了三个实操坑，都是这一轮踩出来的
+
+1. 读屏按 **URL** 记忆浏览光标，复用同一个 URL 会从上次的位置继续 ⇒ 看起来像"本页没有标题"。
+2. 加载后按 `↑` **不一定**读到 `h1`（有时落在导语段落上）⇒ 用 `H` 再 `SHIFT+H` 取。
+3. 末端那句「往下没有标题」是**证据**不是失败。
+
+### 更正 · 一句话当时没有证据
+
+协议页原来写"九个页面都跑过 Tab 遍历……标题层级本轮没做"。前半句没错，但
+"**从页面顶部**按 Tab 走一遍"里的"从页面顶部"没有证据：脚本里那行 `CTRL+HOME` 走的是
+一个不支持 `HOME` 的按键通道，一直返回 `rc=1`，等于空操作。
+Tab 遍历本身走焦点顺序、不依赖浏览光标，所以结论不受影响；这句话已改成它真正证明的东西。
+
 ## [0.13.2] - 2026-10-30
 
 ### 修复 · 下拉菜单打开时，焦点没有交给第一项
@@ -30,10 +187,17 @@
 
 列头按钮的可访问名里混着 `↕`，读屏念成「公司 · ↕ · 按钮」。
 来源是 `.table__sort::after { content: "↕" }` —— Chromium 把伪元素文本算进了
-可访问名。改为 `content: ""` + `mask` 图像画箭头：三态形状不变、颜色走
+可访问名。改为 `content: ""` + `mask` 图像画箭头：仍是 ↕ / ↑ / ↓ 三种形状、颜色走
 `currentColor`，**标记结构不用改**（外部集成方无需动 HTML）。
 
-⚠️ 不要改用 `content: "↕" / ""` 那种替代文本语法 —— Firefox 不支持，箭头会消失。
+尺寸不是零差异：箭头 5×12 → 4×10 px（393 视口实测），墨量反而更足（3.7 → 4.9），
+垂直居中也更准；但它的盒子宽了 2px，同一表内右对齐各列最多右移 6px。
+
+🔴 2026-10-30 更正：这条原本写着「不要改用 `content: "↕" / ""` —— Firefox 不支持」。
+**那句是错的**：三个引擎实测都接受该语法，也都把 ↕ 从可访问名里去掉了。
+真正的理由是**老引擎**——该语法要 Chromium 108 / Firefox 128 / Safari 17.4，
+不认的引擎会丢掉整条声明、箭头彻底消失，而支持矩阵里有 Chromium 97（Android 百度浏览器）。
+实测矩阵见 [docs/A11Y-MANUAL-PROTOCOL.md](docs/A11Y-MANUAL-PROTOCOL.md)。
 
 ### 判据 · 两处都补了能抓住它的检查
 

package/CONTRIBUTING.md

@@ -8,7 +8,7 @@ npm run gate           # 全量：含浏览器类
 npm run gate:fast      # 只跑静态层，不用装浏览器
 ```
 
-全量是 **212 道门禁**（4 路并发实测约 9 分钟 / 退出码 0；单道耗时累加 1691 秒，
+全量是 **214 道门禁**（4 路并发实测约 9 分钟 / 退出码 0；单道耗时累加 1691 秒，
 组件层要起浏览器，还要逐张比 96 张视觉截图。0.11.15 起默认 4 路并发）。
 只想确认没改坏静态契约的话用 `gate:fast`，几秒到几分钟。
 

package/README.zh-CN.md

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

package/START-HERE.md

@@ -39,26 +39,26 @@
 | 标签 / 徽章 | `02-primitives/badge/badge.css` | 141 | — | 有状态标记就要（"已披露""停牌"） |
 | 卡片 | `02-primitives/card/card.css` | 246 | — | 有分组内容就要 |
 | 单选 / 多选 | `02-primitives/choice/choice.css` | 395 | — | 单选 / 多选就要 |
-| 下拉选择 | `02-primitives/select/select.css` | 151 | **必需 549** (`select.js`) | 原生 select 的外观或交互不够用就要 |
-| 可搜索选择 | `02-primitives/combobox/combobox.css` | 223 | **必需 485** (`combobox.js`) | 选项多到要搜索，或要选多个并留成标签就要 |
+| 下拉选择 | `02-primitives/select/select.css` | 151 | **必需 541** (`select.js`) | 原生 select 的外观或交互不够用就要 |
+| 可搜索选择 | `02-primitives/combobox/combobox.css` | 223 | **必需 477** (`combobox.js`) | 选项多到要搜索，或要选多个并留成标签就要 |
 | 开关 | `02-primitives/switch/switch.css` | 370 | — | 有"立即生效的设置"就要 |
 | 分隔线 | `02-primitives/separator/separator.css` | 73 | — | 要分开内容块就要 |
 | 加载骨架 | `02-primitives/skeleton/skeleton.css` | 96 | — | 数据还没到、先把版式占住就要 |
 | 进度条 / 环 | `02-primitives/progress/progress.css` | 172 | — | 有耗时过程要给进度就要 |
-| 浮层气泡 | `02-primitives/popover/popover.css` | 187 | **必需 331** (`popover.js`) | 要一段信息贴着触发元素浮出来就要 |
+| 浮层气泡 | `02-primitives/popover/popover.css` | 187 | **必需 323** (`popover.js`) | 要一段信息贴着触发元素浮出来就要 |
 | 日期区间 | `02-primitives/date-range/date-range.css` | 206 | **必需 301** (`date-range.js`) | 要选起止日期就要 |
 | 标签页 | `03-patterns/tabs/tabs.css` | 172 | **必需 316** (`tabs.js`) | 同层级内容切换就要 |
-| 折叠面板（beta） | `03-patterns/accordion/accordion.css` | 453 | **必需 389** (`accordion.js`) | 长表单分段就要 |
-| 动作菜单（beta） | `03-patterns/dropdown/dropdown.css` | 135 | **必需 456** (`dropdown.js`) | 要一组动作（新建 / 导出 / 删除）就要 |
-| 文字提示 | `03-patterns/tooltip/tooltip.css` | 89 | **必需 288** (`tooltip.js`) | 图标按钮或缩写需要一句话解释就要 |
+| 折叠面板 | `03-patterns/accordion/accordion.css` | 453 | **必需 389** (`accordion.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`) | 层级数据（文件 / 组织 / 分类）要展开就要 |
-| 侧边抽屉（beta） | `03-patterns/drawer/drawer.css` | 129 | **必需 258** (`drawer.js`) | 要从侧边滑出面板就要 |
-| 弹窗 / 吐司（beta） | `03-patterns/overlay/overlay.css` | 319 | **必需 569** (`overlay.js`) | 需要弹层（吐司 / 模态）就要 |
+| 侧边抽屉 | `03-patterns/drawer/drawer.css` | 129 | **必需 336** (`drawer.js`) | 要从侧边滑出面板就要 |
+| 弹窗 / 吐司 | `03-patterns/overlay/overlay.css` | 319 | **必需 638** (`overlay.js`) | 需要弹层（吐司 / 模态）就要 |
 | 状态（空 / 加载 / 错 / 成功） | `03-patterns/states/states.css` | 252 | — | **凡是会异步取数就要** |
 | 表单校验 | `03-patterns/form-validation/form-validation.css` | 263 | — | 提交前要校验就要 |
 | 列表增删 | `03-patterns/list/list.css` | 162 | 可选 201 (`flip.js`，FLIP 增删动画，纯增强) | 列表会动态增删就要 |
-| 导航 / 目录 | `03-patterns/nav/nav.css` | 314 | **必需 433** (`nav.js`) · 可选 111 (`toc.js`，自动生成目录，纯增强) | 顶部要导航，或长文要目录就要 |
+| 导航 / 目录 | `03-patterns/nav/nav.css` | 314 | **必需 425** (`nav.js`) · 可选 111 (`toc.js`，自动生成目录，纯增强) | 顶部要导航，或长文要目录就要 |
 | 长文排版 | `03-patterns/content/content.css` | 286 | — | 写文档 / 长文就要 |
 | delta | `02-primitives/delta/delta.css` | 113 | — |  |
 | metric | `02-primitives/metric/metric.css` | 157 | — |  |
@@ -66,7 +66,7 @@
 | analysis-report | `04-recipes/analysis-report/analysis-report.css` | 187 | — |  |
 | detail-page | `04-recipes/detail-page/detail-page.css` | 190 | — |  |
 | report | `04-recipes/report/report.css` | 364 | — |  |
-| table | `04-recipes/table/table.css` | 383 | — |  |
+| table | `04-recipes/table/table.css` | 387 | — |  |
 | bar | `09-assets/bar/bar.css` | 166 | **必需 320** (`bar.js`) |  |
 | model-viewer | `09-assets/model-viewer/model-viewer.css` | 143 | **必需 423** (`model-viewer.js`) |  |
 | scientific-plot | `09-assets/scientific-plot/scientific-plot.css` | 141 | **必需 610** (`scientific-plot.js`) |  |

package/SUPPORT.md

@@ -11,6 +11,12 @@
 >   ⇒ 这比"没验证"更糟：它给了一个**错误的**证据来源，
 >     读者会以为"至少 Firefox 跑过了"。
 >   现在引擎是真的切换了，并且每个作业都要**自己报 UA** 自证（见下）。
+>
+> 🔴 2026-10-30 更正（反方向）：
+>   这一页曾把桌面 Firefox 标成 ⚠️，理由是「没装 firefox 时门禁显式 SKIP」。
+>   **那句推测是错的**：CI 的 `浏览器矩阵（firefox）` 作业一直在跑，而且是绿的
+>   （UA 自报 `X11; Linux x86_64; rv:155.0 Gecko/20100101 Firefox/155.0`）。
+>   ⚠️ 与 ❌ 都会低估覆盖面，和 ✅ 高估一样是失真。
 
 ## 状态定义
 
@@ -31,7 +37,7 @@
 |---|---|---|---|
 | 桌面 | Chromium | ✅ | 全部组件契约、暗色对比度、响应式三档、视觉回归 |
 | 桌面 | WebKit | ✅ | nightly 矩阵的组件契约（select / combobox / date-range / overlay / tree / dropdown / popover / tooltip） |
-| 桌面 | Firefox | ⚠️ | 矩阵里**已声明并自证**，但本机/CI 需要先 `npx playwright install firefox`；没装时门禁显式 SKIP，不假装通过 |
+| 桌面 | Firefox | ✅ | 与 WebKit 同一批组件契约（select / combobox / date-range / overlay / tree / dropdown / popover / tooltip），CI 作业自报 Gecko UA；另外 8 个组件（accordion / drawer / table / tabs / choice / input / overlay / dropdown）用 `FL_ENGINE=firefox` 在本机复跑同样全绿 |
 
 ### 🔴 怎么知道"跑的真的是这个引擎"
 

package/ai/START-HERE.md

@@ -30,7 +30,7 @@
 > 它的值直接从 `ai/components.json` 与目录实际内容读出来 —— **不信上面的说法，信这个**。
 
 <!-- ==== AI-INVENTORY-BEGIN ==== -->
-- 组件 **37** 个（`beta` 4 · `stable` 33）
+- 组件 **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

@@ -28,8 +28,8 @@
     }
   },
   "budget": {
-    "manual": 2,
-    "gap": 2
+    "manual": 0,
+    "gap": 0
   },
   "matrix": {
     "dismissable": {
@@ -54,8 +54,8 @@
         "展开/收起是内容显隐，没有'关闭'语义；Esc 不参与"
       ],
       "drawer": [
-        "manual",
-        "0.8.6 评估后**决定不收编**：drawer 已经是**模态**弹层，它的 dismissable 只含 Esc；点遮罩关闭是它自己的语义（overlay 负责遮罩）。核的 onDocClick 会把「点遮罩」当成 outside 触发，而 drawer 想忽略非Esc 的关闭原因 ⇒ 需要给核加\"忽略 outside\"的开关，属于改核而不是接线。暂不做。"
+        "core",
+        "0.14.0 收编（推翻 0.8.6 的\"暂不做\"）：核新增 `outside` 开关，模态层不进栈，于是\"点遮罩关闭\"仍然成立而\"点其它地方\"不会被判成 outside。删掉手写的 Esc 分支与 `if (e.target === host) close()`；inside 只放抽屉本体，遮罩**不在** inside 里（放进去就等于声明\"点遮罩算内部\"）。判据 drawer-check ⑧（点内部不关）/ ⑨（点遮罩关）。"
       ],
       "dropdown": [
         "core",
@@ -74,8 +74,8 @@
         "0.11.2 收编：抽屉的「Esc 关闭」直接走核。⚠️ 遮罩**不能**写进 inside —— 写进去就等于声明\"点遮罩算内部\"，那一句\"点遮罩关闭\"的注释会立刻变成谎话（实测过，关不掉）"
       ],
       "overlay": [
-        "manual",
-        "0.8.6 评估后**决定不收编**：dialog 是模态，**点外部不该关闭**（那是 modal 的定义）。核的 onDocClick 天然会处理 outside ⇒ 收编等于给 dialog 引入错误行为。overlay 只需 Esc 那一半，Esc 已在组件内正确实现（不依赖全局栈）。"
+        "core",
+        "0.14.0 收编（推翻 0.8.6 的\"不收编\"）：dialog 是模态，点外部不关 —— 这正是核新开关 `outside:false` 的语义（模态层不进栈）。Esc 走核；点遮罩带 danger / closeOnBackdrop 两个前置条件，仍是组件自己的语义，没并进核。判据 overlay-check ⑤c（body 上的外部点击不关）/ ⑤b（点遮罩关且焦点归位）。"
       ],
       "pagination": [
         "n/a",
@@ -222,8 +222,8 @@
         "aria-activedescendant 模式：焦点常驻按钮"
       ],
       "accordion": [
-        "gap",
-        "APG 把方向键列为**可选**增强，本库未实现；要做就应走 roving 核，不该再手写一份"
+        "n/a",
+        "**判据纠正（2026-10-30 核对 APG 原文）**：此前这里写 `gap`，理由是\"APG 把方向键列为可选增强，本库未实现\"。核对后这条不成立 —— APG Accordion 的 Keyboard Interaction 只有 `Enter`/`Space`、`Tab`、`Shift+Tab` 三项，**没有**方向键 / Home / End，也没有\"可选\"字样（w3.org/WAI/ARIA/apg/patterns/accordion，2026-10-30 取）。加上本库是移动端组件：方向键就是页面滚动键，抢过来会直接和滚动打架。⇒ 不适用，不是缺口。组件 README 第 68 行早就写了同一个结论，是矩阵没跟上。"
       ],
       "drawer": [
         "n/a",
@@ -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.13.2",
+  "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 33 / beta 4**（本行由生成器算出，不要手改）。",
-    "$strictImpact": "⚠️ strict 档位只放行 stable ⇒ 4 个组件在 strict 下不可用：accordion / drawer / dropdown / overlay。放宽 strict 会让「未收编的手写行为」进入生产路径。（本行由生成器算出，不要手改）"
+    "$whyFourth": "🔴 为什么第四条判据不能省：用前三条时多数组件会**全是 stable** ⇒ ladder 没有任何鉴别力（对标 Primer 六档阶梯，每档都有硬判据）。补上「行为欠账」这一条后：**stable 37 / beta 0**（本行由生成器算出，不要手改）。全库达标时 ladder 靠**正向控制**证明还有鉴别力（maturity-gate ③：塞一条合成债务必须降 beta），不是靠\"总得留几个 beta\"。",
+    "$strictImpact": "✅ strict 档位放行全部 37 个组件 —— 没有任何组件带着未收编的手写行为或未做的行为（本行由生成器算出，不要手改）"
   },
   "summary": {
     "total": 37,
     "byMaturity": {
-      "stable": 33,
-      "beta": 4
+      "stable": 37
     },
     "byTier": {
       "primitive": 15,
@@ -244,14 +243,12 @@
       "tier": "pattern",
       "purpose": "可折叠分组",
       "rootClass": "accordion",
-      "maturity": "beta",
+      "maturity": "stable",
       "maturityReasons": {
         "hasDemo": true,
         "hasDedicatedGate": true,
         "statesOnDomAttributes": true,
-        "behaviorDebt": [
-          "roving:gap"
-        ]
+        "behaviorDebt": []
       },
       "gates": [
         "accordion-contract.js"
@@ -346,14 +343,12 @@
       "tier": "pattern",
       "purpose": "侧边抽屉，含遮罩",
       "rootClass": "drawer",
-      "maturity": "beta",
+      "maturity": "stable",
       "maturityReasons": {
         "hasDemo": true,
         "hasDedicatedGate": true,
         "statesOnDomAttributes": true,
-        "behaviorDebt": [
-          "dismissable:manual"
-        ]
+        "behaviorDebt": []
       },
       "gates": [
         "drawer-check.js"
@@ -403,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"
@@ -636,14 +629,12 @@
       "tier": "pattern",
       "purpose": "吐司提示与模态遮罩",
       "rootClass": "toast",
-      "maturity": "beta",
+      "maturity": "stable",
       "maturityReasons": {
         "hasDemo": true,
         "hasDedicatedGate": true,
         "statesOnDomAttributes": true,
-        "behaviorDebt": [
-          "dismissable:manual"
-        ]
+        "behaviorDebt": []
       },
       "gates": [
         "overlay-check.js",

package/dist/01-tokens/behavior/dismissable.js

@@ -2,6 +2,7 @@ var flDismissable = function (opts) {
 var opt = opts || {};
 var escOn = opt.escOn || [];
 var inside = opt.inside || [];
+var outside = opt.outside !== false;
 var when = opt.when || function () { return true; };
 var onDismiss = opt.onDismiss || function () {};
 
@@ -42,7 +43,8 @@ var rec = { when: when, isInside: isInside, onDismiss: onDismiss };
 for (var j = 0; j < escOn.length; j++) {
 if (escOn[j]) escOn[j].addEventListener('keydown', onKey);
 }
-shared.stack.push(rec);
+
+if (outside) shared.stack.push(rec);
 if (!shared.bound) {
 shared.bound = true;
 document.addEventListener('click', onDocClick, true);