agentcss 0.13.2 → 0.15.0

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

@@ -5,6 +5,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 () {};
 
@@ -45,7 +46,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);

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

@@ -5,6 +5,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 () {};
 
@@ -45,7 +46,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);

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

@@ -5,6 +5,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 () {};
 
@@ -45,7 +46,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);

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

@@ -55,6 +55,69 @@ clear: function () { saved = null; },
 };
 };
 
+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;
+
+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);
+}
+
+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);
+},
+};
+};
+
 var FOCUSABLE = [
 'a[href]',
 'button:not([disabled])',
@@ -176,11 +239,15 @@ else (f[0] || d).focus();
 (f[0] || d).focus();
 }
 
-function onKey(e) {
-var k = e.key;
+var dm = flDismissable({
+escOn: [d],
+inside: [d],
+when: function () { return !closed; },
+onDismiss: function () { close(); },
+});
 
-if (k === 'Escape' || k === 'Esc') { e.preventDefault(); close(); return; }
-if (k !== 'Tab') return;
+function onKey(e) {
+if (e.key !== 'Tab') return;
 
 var list = [].slice.call(d.querySelectorAll(FOCUSABLE))
 .filter(function (x) { return x.offsetParent !== null; });
@@ -192,10 +259,8 @@ e.preventDefault(); last.focus();
 e.preventDefault(); first.focus();
 }
 }
-function onBackdropClick(e) { if (e.target === host) close(); }
 
 d.addEventListener('keydown', onKey);
-host.addEventListener('click', onBackdropClick);
 closeBtn.addEventListener('click', function () { close(); });
 
 var closed = false;
@@ -204,7 +269,8 @@ if (closed) return;
 closed = true;
 d.setAttribute('data-state', 'leaving');
 d.removeEventListener('keydown', onKey);
-host.removeEventListener('click', onBackdropClick);
+
+dm.destroy();
 setBackgroundInert(false);
 unlockScroll();
 

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

@@ -137,6 +137,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 () {};
 
@@ -177,7 +178,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);
@@ -194,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);
@@ -267,6 +331,8 @@ btn.setAttribute('aria-expanded', 'true');
 active = -1;
 
 focusAt(0);
+
+typeahead.clear();
 flEmit(root, 'fl-open', null);
 if (opt.onOpen) opt.onOpen();
 }
@@ -276,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();
@@ -305,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');
@@ -339,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') {
@@ -358,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/03-patterns/nav/nav.js

@@ -59,6 +59,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 () {};
 
@@ -99,7 +100,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);

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

@@ -251,6 +251,69 @@ clear: function () { saved = null; },
 };
 };
 
+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;
+
+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);
+}
+
+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);
+},
+};
+};
+
 function dialog(opts) {
 opts = opts || {};
 
@@ -310,16 +373,16 @@ var uninstallIsolation = null;
 openStack.push(stackEntry);
 if (!useInert) uninstallIsolation = installIsolation(stackEntry);
 
+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();
-
-e.stopPropagation();
-close();
-return;
-}
 if (e.key !== 'Tab') return;
 
 var f = focusables();
@@ -370,6 +433,8 @@ function close() {
 if (closed) return;
 closed = true;
 
+dm.destroy();
+
 var ae = document.activeElement;
 var focusIsMine = !ae || ae === document.body ||
 box.contains(ae) || backdrop.contains(ae);

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

@@ -36,6 +36,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 () {};
 
@@ -76,7 +77,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);

package/dist/COSTS.md

@@ -22,36 +22,36 @@
 | primitive | `button` | 2.7 KB | 1.0 KB | — | **3.7 KB** | 26.0 KB | −22.4 KB |
 | primitive | `card` | 2.7 KB | 0.9 KB | — | **3.6 KB** | 23.1 KB | −19.5 KB |
 | primitive | `choice` | 2.7 KB | 1.1 KB | — | **3.8 KB** | 25.0 KB | −21.2 KB |
-| primitive | `combobox` | 2.7 KB | 1.0 KB | 5.4 KB | **9.0 KB** | 29.3 KB | −20.3 KB |
+| primitive | `combobox` | 2.7 KB | 1.0 KB | 5.4 KB | **9.0 KB** | 29.2 KB | −20.1 KB |
 | primitive | `date-range` | 2.7 KB | 0.8 KB | 2.5 KB | **6.1 KB** | 26.1 KB | −20.1 KB |
 | primitive | `delta` | 2.7 KB | 0.3 KB | — | **3.0 KB** | 22.4 KB | −19.4 KB |
 | primitive | `input` | 2.7 KB | 1.0 KB | — | **3.7 KB** | 23.2 KB | −19.5 KB |
 | primitive | `metric` | 2.7 KB | 0.5 KB | — | **3.2 KB** | 22.8 KB | −19.7 KB |
-| primitive | `popover` | 2.7 KB | 0.8 KB | 2.2 KB | **5.7 KB** | 27.2 KB | −21.5 KB |
+| primitive | `popover` | 2.7 KB | 0.8 KB | 2.2 KB | **5.7 KB** | 26.9 KB | −21.2 KB |
 | primitive | `progress` | 2.7 KB | 0.7 KB | — | **3.4 KB** | 22.5 KB | −19.1 KB |
-| primitive | `select` | 2.7 KB | 0.8 KB | 3.5 KB | **7.0 KB** | 29.4 KB | −22.4 KB |
+| primitive | `select` | 2.7 KB | 0.8 KB | 3.5 KB | **7.0 KB** | 29.2 KB | −22.2 KB |
 | primitive | `separator` | 2.7 KB | 0.2 KB | — | **2.9 KB** | 20.9 KB | −18.0 KB |
 | primitive | `skeleton` | 2.7 KB | 0.5 KB | — | **3.2 KB** | 21.1 KB | −17.9 KB |
 | primitive | `switch` | 2.7 KB | 0.8 KB | — | **3.4 KB** | 26.8 KB | −23.3 KB |
 | 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.0 KB | **5.4 KB** | 25.0 KB | −19.6 KB |
-| pattern | `dropdown` | 2.7 KB | 0.8 KB | 2.9 KB | **6.4 KB** | 28.1 KB | −21.7 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 | 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.5 KB** | 30.9 KB | −24.4 KB |
-| pattern | `overlay` | 2.7 KB | 1.1 KB | 2.8 KB | **6.7 KB** | 33.9 KB | −27.2 KB |
+| pattern | `nav` | 2.7 KB | 1.2 KB | 2.6 KB | **6.6 KB** | 30.7 KB | −24.1 KB |
+| pattern | `overlay` | 2.7 KB | 1.1 KB | 3.3 KB | **7.1 KB** | 34.5 KB | −27.4 KB |
 | pattern | `pagination` | 2.7 KB | 0.8 KB | 2.6 KB | **6.0 KB** | 30.1 KB | −24.1 KB |
 | pattern | `reveal` | 2.7 KB | 0.3 KB | 1.2 KB | **4.2 KB** | 24.2 KB | −20.0 KB |
 | pattern | `states` | 2.7 KB | 0.8 KB | — | **3.5 KB** | 23.6 KB | −20.1 KB |
 | pattern | `tabs` | 2.7 KB | 0.7 KB | 2.0 KB | **5.4 KB** | 26.8 KB | −21.4 KB |
-| pattern | `tooltip` | 2.7 KB | 0.5 KB | 1.9 KB | **5.1 KB** | 26.3 KB | −21.2 KB |
+| pattern | `tooltip` | 2.7 KB | 0.5 KB | 1.9 KB | **5.1 KB** | 26.0 KB | −20.9 KB |
 | pattern | `tree` | 2.7 KB | 0.6 KB | 2.9 KB | **6.2 KB** | 27.8 KB | −21.6 KB |
 
 ## 三、全库
 
-- 全部组件都用上（min，含 tokens 一份）：**61.2 KB**
-- 源码版（带注释）全库 gzip：303.0 KB
+- 全部组件都用上（min，含 tokens 一份）：**62.6 KB**
+- 源码版（带注释）全库 gzip：305.5 KB
 
 > ⚠️ 源码版那个数字**不是**要付的钱：它包含我们的注释（全库 CSS 有 67% 是注释，字节口径）。
 > 它的用途只有一个 —— 让人看清"dist 到底省了多少"。

package/docs/A11Y-MANUAL-PROTOCOL.md

@@ -4,9 +4,10 @@
 但证明不了"念出来是否**合理**"。这一页把这件事变成**可执行、可复现、可填表**的动作，
 时长约 20 分钟。
 
-**当前状态：已执行一轮（2026-10-30）。** 九个页面都跑过 Tab 遍历，浮层焦点在
-`overlay` / `drawer` 上验到，**标题层级（`H` 键逐级跳）本轮没做**，结果表里如实写着
-"未执行"。
+**当前状态：已执行两轮（2026-10-30）。** 九个页面都跑过 Tab 遍历，浮层焦点在
+`overlay` / `drawer` 上验到；**标题层级（`H` 键逐级跳）在第二轮补齐**——九个页面
+共 107 个标题，逐条与页面结构对得上。第一轮修掉的缺陷、第二轮的破坏实验，
+以及三趟才拿到干净数据的那三个操作坑，都写在第三节。
 
 证据形态要说清楚：**不是人耳旁听**，是让 NVDA 把朗读日志写到文件，逐条取它交给语音
 合成器的原始文本（`IO - speech.speech.speak`）。这比人耳更可复现、可存档，但它证明的
@@ -43,9 +44,17 @@ python3 -m http.server 8000 --bind 127.0.0.1
 
 ## 二 · 每页只做这 5 件事（NVDA 键位在括号里）
 
-1. **从页面顶部按 Tab 走一遍**，听到的每个控件都要有**说得通的名字**。
-   听到 "button"、"未标记"、"undefined"、只有图标名 ⇒ ❌ 记下来。
+1. **按 Tab 走一遍**（走的是焦点顺序，与浏览光标停在哪无关），听到的每个控件都要有
+   **说得通的名字**。听到 "button"、"未标记"、"undefined"、只有图标名 ⇒ ❌ 记下来。
 2. **用读屏的"下一个标题"跳（NVDA `H`）**，标题层级应当是 1 → 2 → 3，不跳级。
+
+   > **三个实操坑**（2026-10-30 实测，三个都踩过，踩完才拿到干净结果）：
+   > - **换一个查询串再打开**。NVDA 按文档 URL 记忆浏览光标：同一个 URL 再开一次会恢复
+   >   上次的位置，若上次停在文末，按 `H` 只会念「往下没有标题」——看起来像"本页没有标题"。
+   > - **`h1` 用 `H` 再 `SHIFT+H` 取**。加载后的光标落点不固定：有时正好在 `h1` 上
+   >   （按 `↑` 直接念出「标题 1 级 + 页面名」），有时落在紧随其后的导语段落上。
+   >   稳妥的做法是先按一次 `H` 走到第一个 `h2`，再按 `SHIFT+H` 退回来 —— 那一条必然是 `h1`。
+   > - **末端那句「往下没有标题」是证据，不是失败**。它证明 `H` 已经走过本页最后一个标题。
 3. **把焦点放到一个禁用控件上**，它应当被念成"不可用"（而不是干脆跳过或念成正常按钮）。
 4. **触发表单错误**（页面里带校验的那块），错误文字应当被**紧跟控件**念出，
    不是只在屏幕右上角飘一条。
@@ -61,28 +70,48 @@ python3 -m http.server 8000 --bind 127.0.0.1
 
 | 页面 | ① 名字 | ② 标题层级 | ③ 禁用态 | ④ 错误说明 | ⑤ 浮层焦点 | 备注（听到了什么） |
 |---|---|---|---|---|---|---|
-| button | 通过 | 未执行 | 未执行 | — | — | 12 个按钮全部念出名字；加载态念「忙碌中」 |
-| input | 通过 | 未执行 | 未执行 | 通过 | — | 只读念「只读」；错误念「错误的输入 · 请输入有效金额」，紧跟控件 |
-| choice | 通过 | 未执行 | — | — | — | 「全选（下面 3 项）」念「部分选中」；单选念「时间范围 · 分组 · 已选中 · 3 之 1 项」 |
-| tabs | 通过 | 未执行 | — | — | — | 念「选项卡组 · 选项卡 · 已选中 · 2 之 1 项」；错例组三个 `tabindex=0` 各停一次，正例组只停一次 —— 对照成立 |
-| overlay | 通过 | 通过（对话框标题念成 2 级） | — | — | 通过 | 打开后焦点进对话框（取消 / 确认标记），Esc 后回到「普通确认」，再 Tab 落到「删除这份报告」 |
-| table | 通过 | 未执行 | — | — | — | 表格念「共 7 行 7 列 · 1 行 1 列」；🔴 **列头按钮把 `↕` 念了出来**（见下） |
-| **accordion** | 通过 | 通过（标题念成 3 级） | 通过 | — | — | 「公司基本信息 · 按钮 · 已展开 · 标题 3 级」→ 回车念「已折叠」→ 再回车念「已展开」；`aria-disabled` 那栏念「不可用」 |
-| **drawer** | 通过 | 未执行 | — | — | 通过 | 打开念「从left进来的抽屉 · 对话框」；Tab 在「取消 → 确定 → 关闭」之间循环；Esc 后回到「左侧 · 按钮」 |
-| **dropdown** | 通过 | 未执行 | — | — | 通过（修复后） | 按钮念「菜单按钮 · 已折叠 · 子菜单」，展开念「已展开 · 菜单」。**修复前**：按 Enter 打开后焦点留在按钮上（读屏在浏览模式下把 Enter 变成点击，走 click 分支），修复后真机复测焦点落在「✓ 按日期」。方向键仍无法在项间移动 —— 极简 APG 对照页表现相同，属读屏浏览模式限制 |
-
-> **为什么后三行是补的**：`accordion` / `drawer` / `dropdown` 这三个都是 beta 组件
-> （`ai/components.json` 当前记 4 个 beta），而它们升 stable 的判据之一就是「行为零欠账」
-> ——人工读屏是这件事**唯一的用户侧证据**。
+| button | 通过 | 通过（19/19） | 未执行 | — | — | 12 个按钮全部念出名字；加载态念「忙碌中」。标题从「1 级 button · 七态矩阵」→「2 级 七态」→「3 级 1. default …」，末条念「往下没有标题」 |
+| input | 通过 | 通过（13/13） | 未执行 | 通过 | — | 只读念「只读」；错误念「错误的输入 · 请输入有效金额」，紧跟控件。标题 1 → 2 → 3 → 2 → 3 → 2 → 2，与结构一致 |
+| choice | 通过 | 通过（10/10） | — | — | — | 「全选（下面 3 项）」念「部分选中」；单选念「时间范围 · 分组 · 已选中 · 3 之 1 项」。标题 1 → 2×6 → 3 → 3 → 2 |
+| tabs | 通过 | 通过（10/10） | — | — | — | 念「选项卡组 · 选项卡 · 已选中 · 2 之 1 项」；错例组三个 `tabindex=0` 各停一次，正例组只停一次 —— 对照成立。标题 1 → 2×5 → 3×4 |
+| overlay | 通过 | 通过（11/11，对话框标题念成 2 级） | — | — | 通过 | 打开后焦点进对话框（取消 / 确认标记），Esc 后回到「普通确认」，再 Tab 落到「删除这份报告」。标题 1 → 2×3 → 3×2 → 2×2 → 3×2 → 2 |
+| table | 通过 | 通过（10/10） | — | — | — | 表格念「共 7 行 7 列 · 1 行 1 列」；🔴 **列头按钮把 `↕` 念了出来**（见下，已修）。标题 1 → 2×7 → 3 → 3 |
+| **accordion** | 通过 | 通过（21/21） | 通过 | — | — | 「公司基本信息 · 按钮 · 已展开 · 标题 3 级」→ 回车念「已折叠」→ 再回车念「已展开」；`aria-disabled` 那栏念「不可用」。标题 1 → 2 → 3×3 → 2 → 3×3 → 2 → 3×3 → 2×4 → 3×5 |
+| **drawer** | 通过 | 通过（6/6） | — | — | 通过 | 打开念「从left进来的抽屉 · 对话框」；Tab 在「取消 → 确定 → 关闭」之间循环；Esc 后回到「左侧 · 按钮」。标题 1 → 2×3 → 3×2 |
+| **dropdown** | 通过 | 通过（7/7） | — | — | 通过（修复后） | 按钮念「菜单按钮 · 已折叠 · 子菜单」，展开念「已展开 · 菜单」。**修复前**：按 Enter 打开后焦点留在按钮上（读屏在浏览模式下把 Enter 变成点击，走 click 分支），修复后真机复测焦点落在「✓ 按日期」。方向键仍无法在项间移动 —— 极简 APG 对照页表现相同，属读屏浏览模式限制。标题 1 → 2×4 → 3×2 |
+
+> **为什么后三行是补的**：`accordion` / `drawer` / `dropdown` 当时都是 beta 组件，
+> 而它们升 stable 的判据之一就是「行为零欠账」——人工读屏是这件事**唯一的用户侧证据**。
+> （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` 的列头按钮被念成「公司 · `↕` · 按钮」——
 那个 `↕` 来自 `table.css` 里 `.table__sort::after` 的 `content`，Chromium 把伪元素文本算进了
-可访问名。**自动检查抓不到它**（可访问名"非空"就算过），212 道门禁里也没有一道看这个。
+可访问名。**自动检查抓不到它**（可访问名"非空"就算过），当时那 212 道门禁里也没有一道看这个。
 
 改法：把字形换成 `mask` 图像（`content` 留空），三态形状仍是 `↕ / ↑ / ↓`，
 颜色靠 `currentColor` 跟着主题走，标记结构一个字符都不用动。
-⚠️ 不走 `content: "↕" / ""` 那条路 —— 替代文本语法 Firefox 不支持，箭头会直接消失。
+
+**为什么不用 `content: "↕" / ""` 那个一行改法**（2026-10-30 实测更正）：
+早先这里写着"Firefox 不支持替代文本语法"——**那是错的**。三个引擎实测下来都被接受，
+而且都能把 `↕` 从可访问名里去掉：
+
+| 写法 | Chromium | Firefox | WebKit |
+|---|---|---|---|
+| `content: "↕" / ""` | 显示 · 名=`公司` | 显示 · 名=`公司` | 显示 · 名=`公司` |
+| `content: "↕" / "排序"` | 显示 · 名=`公司 排序` | 显示 · 名=`公司排序` | 显示 · 名=`公司排序` |
+| `mask`（本库） | 显示 · 名=`公司` | 显示 · 名=`公司` | 显示 · 名=`公司` |
+| `content: "↕"`（原写法） | 显示 · 名=`公司↕` | 显示 · 名=`公司↕` | 显示 · 名=`公司↕` |
+
+真正拦住它的是**老引擎**：这套语法要 Chromium 108 / Firefox 128 / Safari 17.4 起才认，
+而不认的引擎会**把整条声明丢掉** ⇒ 箭头彻底消失（比念出符号更糟）。
+支持矩阵里有 Android 百度浏览器（Chromium 97，见 [LAYER-BASELINE](LAYER-BASELINE.md)），
+落在门槛之外。🔴 **这一条是按版本门槛推断的，没有在 Chromium 97 上实测过** ——
+说的就是"没测的不算已验证"。
+
 改完用 NVDA 复听：表头只剩「公司 · 按钮」；`table-check` 的排序判据也跟着改成
 读 `mask` 的自定义属性（破坏实验验证过：把降序箭头改成升序形状，判据当场红）。
 
@@ -93,11 +122,42 @@ python3 -m http.server 8000 --bind 127.0.0.1
 自动门禁当时是绿的，因为它只测了 `↓` 这条键盘路径。
 **修法与判据**：把聚焦首项收进 `open()`（两条路径共用），并补一条"点击打开也聚焦首项"。
 
+### ② 那一格是怎么填的：两条通道，各测一半
+
+标题层级容易被当成"看一眼 DOM 就知道"的事，但**"结构对不对"和"读屏跳得对不对"
+是两件事**。所以这一格用两条互不依赖的通道各测一遍：
+
+| 通道 | 覆盖 | 这一轮的结果 |
+|---|---|---|
+| 机器 · 运行时 DOM + 可访问性树 | **96 个页面、887 个标题**（`node_modules` / `dist` 之外的全部 HTML，空夹具除外） | 每页恰好一个 `h1`；跳级 0 处、空名 0 个；层级分布 `h1×96 · h2×581 · h3×210`（没有 h4–h6）；DOM 里的标题数与无障碍树里的 heading 节点数**逐页相等** |
+| 读屏 · NVDA `H` 键实录 | 协议表里的 **9 页、107 个标题** | **107/107 条**念出的级别与页面结构逐条一致；九页走到底时都念「往下没有标题」 |
+
+机器侧不是"跑绿了就算"。这三条 axe 规则（`heading-order` /
+`page-has-heading-one` / `empty-heading`）都做过破坏实验：
+
+| 注入的破坏 | `heading-order` | `page-has-heading-one` | `empty-heading` |
+|---|---|---|---|
+| 基线（不动） | 绿 | 绿 | 绿 |
+| `h2` 后插 `h4`（跳级） | **红** | 绿 | 绿 |
+| 删掉唯一的 `h1` | 绿 | **红** | 绿 |
+| 清空一个 `h3` 的文本 | 绿 | 绿 | **红** |
+| 反向对照：`h3` 后插 `h4`（合法） | 绿 | 绿 | 绿 |
+
+最后一行是关键：合法层级仍然全绿，说明它不是"见到 `h4` 就报"。
+
+> **机器侧可复跑**：`node 05-audit/heading-outline.js`（先起本地静态服务），
+> 末行会打印 `96 页 · 887 个标题（h1×96 · h2×581 · h3×210）· 0 页异常`。
+> 它不是门禁，是取证工具：结构本身已由 axe 那三条规则守着，它负责的是
+> "把整站每个标题都数一遍"这件事，以及第四条判据（DOM 标题数 == 无障碍树 heading 数）。
+>
+> **读屏侧不进仓库**：实录脚本依赖一台装了 NVDA 的 Windows 机。复核方式是按第二节
+> 第 2 条自己走一遍——九页的层级序列在上表每行的备注里都抄了，对不上就是有问题。
+
 状态只填三种：**通过** / **失败（附听到的内容）** / **未执行**。
 "大概没问题"不属于这三种，不要写。
 
 填写人 / 日期 / 系统与读屏版本：
-`脚本驱动 NVDA（朗读取自 speech 日志原文，非人耳旁听）/ 2026-10-30 / Windows 10 22H2 19045 · NVDA 2026.3 · Edge`
+`脚本驱动 NVDA（朗读取自 speech 日志原文，非人耳旁听）/ 2026-10-30，两轮 / Windows 10 22H2 19045 · NVDA 2026.3 · Edge`
 
 ---
 
@@ -113,5 +173,6 @@ python3 -m http.server 8000 --bind 127.0.0.1
 ## 五 · 为什么这份协议要写进仓库
 
 因为"我们打算做读屏测试"和"我们做过读屏测试"在仓库里长得一模一样 ——
-除非有一张**带状态列的表**。这张表现在全部写着"未执行"，
-它记录的不是进度，而是**边界**：本库目前能承诺的东西到哪为止。
+除非有一张**带状态列的表**。第一轮填这张表时，九页里有六页的"标题层级"写着"未执行"；
+那一列记录的不是进度，而是**边界**。第二轮把那一列填满，边界就移动了一格 ——
+现在还剩 macOS VoiceOver 与 Android TalkBack 两格空白（见第四节第 2 条）。