agentcss 0.25.6 → 0.26.0

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

@@ -61,12 +61,36 @@ if (total > 1) out.push(total);
 return out;
 }
 
-function Pagination(node) {
+var DEFAULT_LABELS = {
+nav: '分页',
+prev: '上一页',
+next: '下一页',
+page: function (p, isCurrent) {
+return '第 ' + p + ' 页' + (isCurrent ? '（当前页）' : '');
+},
+status: function (page, pages) { return '第 ' + page + ' 页 / 共 ' + pages + ' 页'; },
+live: function (page, pages) { return '第 ' + page + ' 页，共 ' + pages + ' 页'; }
+};
+
+var flLabels = function (defaults, src) {
+src = src || {};
+var out = {};
+var k;
+for (k in defaults) {
+if (Object.prototype.hasOwnProperty.call(defaults, k)) {
+out[k] = (src[k] === undefined || src[k] === null) ? defaults[k] : src[k];
+}
+}
+return out;
+};
+
+function Pagination(node, opts) {
 this.node = node;
+this.labels = flLabels(DEFAULT_LABELS, opts && opts.labels);
 this.total = Math.max(1, parseInt(node.getAttribute('data-total') || '1', 10));
 this.size = Math.max(1, parseInt(node.getAttribute('data-page-size') || '20', 10));
 this.page = Math.max(1, parseInt(node.getAttribute('data-page') || '1', 10));
-this.label = node.getAttribute('aria-label') || '分页';
+this.label = node.getAttribute('aria-label') || this.labels.nav;
 this.pages = Math.max(1, Math.ceil(this.total / this.size));
 this.onChange = null;
 
@@ -186,7 +210,7 @@ if (cur && cur.focus) cur.focus();
 
 Pagination.prototype.announce = function () {
 if (!this.liveNode) return;
-this.liveNode.textContent = '第 ' + this.page + ' 页，共 ' + this.pages + ' 页';
+this.liveNode.textContent = this.labels.live(this.page, this.pages);
 };
 
 Pagination.prototype.render = function () {
@@ -194,6 +218,7 @@ if (!this.listNode) return;
 var L = this.listNode;
 while (L.firstChild) L.removeChild(L.firstChild);
 var self = this;
+var T = this.labels;
 
 function addBtn(text, ariaLabel, goto, disabled) {
 var li = el('li', 'pagination__item');
@@ -208,7 +233,7 @@ L.appendChild(li);
 return b;
 }
 
-addBtn('‹', '上一页', 'prev', self.page <= 1);
+addBtn('‹', T.prev, 'prev', self.page <= 1);
 
 var win = pageWindow(self.page, self.pages, SLOTS);
 for (var i = 0; i < win.length; i++) {
@@ -227,7 +252,7 @@ var li2 = el('li', 'pagination__item');
 var b2 = el('button', 'pagination__link', String(p));
 b2.type = 'button';
 b2.setAttribute('data-goto', String(p));
-b2.setAttribute('aria-label', '第 ' + p + ' 页' + (isCur ? '（当前页）' : ''));
+b2.setAttribute('aria-label', T.page(p, isCur));
 if (isCur) {
 b2.setAttribute('aria-current', 'page');
 b2.setAttribute('aria-disabled', 'true');
@@ -236,20 +261,19 @@ li2.appendChild(b2);
 L.appendChild(li2);
 }
 
-addBtn('›', '下一页', 'next', self.page >= self.pages);
+addBtn('›', T.next, 'next', self.page >= self.pages);
 
 if (this.statusNode) {
-this.statusNode.textContent =
-'第 '+ self.page + ' 页 / 共 ' + self.pages + ' 页';
+this.statusNode.textContent = T.status(self.page, self.pages);
 }
 };
 
 var API = {
 
-create: function (node) {
+create: function (node, opts) {
 if (!node) return null;
 if (node.__pg) return node.__pg;
-node.__pg = new Pagination(node);
+node.__pg = new Pagination(node, opts);
 return node.__pg;
 },
 

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

@@ -99,6 +99,18 @@ if (k >= 0) shared.stack.splice(k, 1);
 
 var uid = 0;
 
+var LABELS = { region: '组件提示' };
+
+function setLabels(patch) {
+if (!patch) return;
+for (var k in LABELS) {
+if (Object.prototype.hasOwnProperty.call(LABELS, k)
+&& patch[k] !== undefined && patch[k] !== null) {
+LABELS[k] = patch[k];
+}
+}
+}
+
 function ensureStyle() {
 if (document.getElementById('tooltip-css')) return;
 
@@ -115,7 +127,7 @@ r.setAttribute('role', 'tooltip');
 r.setAttribute('aria-live', 'polite');
 r.setAttribute('aria-atomic', 'true');
 
-r.setAttribute('aria-label', '组件提示');
+r.setAttribute('aria-label', LABELS.region);
 r.style.cssText =
 'position:absolute;width:1px;height:1px;padding:0;margin:-1px;'+
 'overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0';
@@ -211,5 +223,5 @@ el.setAttribute('aria-describedby', cur ? (cur + ' ' + id) : id);
 el.setAttribute('data-tooltip', text);
 }
 
-global.Tooltip = { attach: attach };
+global.Tooltip = { attach: attach, setLabels: setLabels };
 })(typeof window !== 'undefined' ? window : globalThis);

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

@@ -196,11 +196,30 @@ return true;
 var uid = 0;
 
 function create(root, opt) {
+
+var DEFAULT_LABELS = {
+tree: '树形视图'
+};
+
+var flLabels = function (defaults, src) {
+src = src || {};
+var out = {};
+var k;
+for (k in defaults) {
+if (Object.prototype.hasOwnProperty.call(defaults, k)) {
+out[k] = (src[k] === undefined || src[k] === null) ? defaults[k] : src[k];
+}
+}
+return out;
+};
+
+var L = flLabels(DEFAULT_LABELS, opt && opt.labels);
+
 opt = opt || {};
 root.classList.add('tree');
 if (!root.getAttribute('role')) root.setAttribute('role', 'tree');
 if (!root.getAttribute('aria-label') && !root.getAttribute('aria-labelledby')) {
-root.setAttribute('aria-label', opt.label || '树形视图');
+root.setAttribute('aria-label', opt.label || L.tree);
 }
 
 var items = [];

package/dist/09-assets/bar/bar.js

@@ -27,9 +27,30 @@ e.setAttribute(k, String(attrs[k]));
 return e;
 }
 
+var DEFAULT_TEXT = {
+series: function (i) { return '系列 ' + i; },
+clipped: function (n, isStack, max) {
+return '有 ' + n + ' 个' + (isStack ? '类目的合计' : '数据')
++ '超出量程（上限 ' + max + '），已按上限截断显示。';
+}
+};
+
+var flLabels = function (defaults, src) {
+src = src || {};
+var out = {};
+var k;
+for (k in defaults) {
+if (Object.prototype.hasOwnProperty.call(defaults, k)) {
+out[k] = (src[k] === undefined || src[k] === null) ? defaults[k] : src[k];
+}
+}
+return out;
+};
+
 function draw(opt) {
 opt = opt || {};
 var host = opt.host;
+var T = flLabels(DEFAULT_TEXT, opt && opt.text);
 if (!host) throw new Error('bar.draw: 缺少 host');
 if (opt.max === undefined || opt.max === null) {
 
@@ -187,7 +208,7 @@ sw.className = 'bar__legend-swatch ' + SERIES_CLS[si % SERIES_STYLES] +
 
 li.appendChild(sw);
 var tx = document.createElement('span');
-tx.textContent = se.name || ('系列 ' + (si + 1));
+tx.textContent = se.name || T.series(si + 1);
 li.appendChild(tx);
 legendEl.appendChild(li);
 });
@@ -202,9 +223,7 @@ host.appendChild(p);
 } else if (clipped.length) {
 var p2 = document.createElement('p');
 p2.className = 'bar__note';
-p2.textContent = '有 ' + clipped.length + ' 个' +
-(mode === 'stack' ? '类目的合计' : '数据') +
-'超出量程（上限 '+ max + '），已按上限截断显示。';
+p2.textContent = T.clipped(clipped.length, mode === 'stack', max);
 host.appendChild(p2);
 }
 

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

@@ -62,7 +62,7 @@ this.ui = el('div', 'mv__ui');
 this.ui.appendChild(this.makeIdle());
 n.appendChild(this.ui);
 
-this.btn = el('button', 'mv__btn', '加载 3D 模型');
+this.btn = el('button', 'mv__btn', LABELS.load);
 this.btn.type = 'button';
 this.btn.addEventListener('click', function () { self.load(); });
 this.ui.appendChild(this.btn);
@@ -70,23 +70,23 @@ this.ui.appendChild(this.btn);
 this.hint = el('p', 'mv__hint');
 
 var fname = el('code', null, this.src.split('/').pop() || '—');
-var strong = el('b', null, '点击后才下载');
-this.hint.appendChild(document.createTextNode('模型 '));
+var strong = el('b', null, LABELS.hintStrong);
+this.hint.appendChild(document.createTextNode(LABELS.hintBefore));
 this.hint.appendChild(fname);
-this.hint.appendChild(document.createTextNode(' 会'));
+this.hint.appendChild(document.createTextNode(LABELS.hintBetween));
 this.hint.appendChild(strong);
-this.hint.appendChild(document.createTextNode('，首屏不占流量。'));
+this.hint.appendChild(document.createTextNode(LABELS.hintTail));
 this.ui.appendChild(this.hint);
 
 if (!hasWebGL()) {
-this.fail('这台设备的浏览器不支持 WebGL，无法显示 3D 模型。');
+this.fail(LABELS.noWebGL);
 this.btn.disabled = true;
 }
 };
 
 Viewer.prototype.makeIdle = function () {
 var box = el('div', 'mv__stage');
-box.appendChild(el('div', 'mv__ph', '3D 模型'));
+box.appendChild(el('div', 'mv__ph', LABELS.placeholder));
 return box;
 };
 
@@ -95,14 +95,14 @@ if (this.timer) { clearTimeout(this.timer); this.timer = null; }
 this.state = 'error';
 this.ui.innerHTML = '';
 var s = el('div', 'mv__stage mv__stage--err');
-s.appendChild(el('div', 'mv__ph', '3D 模型'));
+s.appendChild(el('div', 'mv__ph', LABELS.placeholder));
 var p = el('p', 'mv__err', msg);
 s.appendChild(p);
 this.ui.appendChild(s);
 if (this.btn) this.ui.appendChild(this.btn);
 if (this.btn) {
 this.btn.disabled = false;
-this.btn.textContent = '重试';
+this.btn.textContent = LABELS.retry;
 }
 };
 
@@ -117,12 +117,12 @@ this.state = 'loading';
 
 this.ui.innerHTML = '';
 var stage = el('div', 'mv__stage');
-this.statusNode = el('p', 'mv__status', '正在准备…');
+this.statusNode = el('p', 'mv__status', LABELS.preparing);
 stage.appendChild(this.statusNode);
 this.ui.appendChild(stage);
 
 var t0 = (window.performance && performance.now) ? performance.now() : Date.now();
-this.status('正在准备 3D 引擎…');
+this.status(LABELS.preparingEngine);
 this.boot(null, t0, 0);
 
 var self0 = this;
@@ -205,7 +205,7 @@ xhr.open('GET', this.src, true);
 xhr.onprogress = function (e) {
 if (e.lengthComputable && e.total) {
 self1.lastBytes = e.total;
-self1.status('正在下载模型 ' + Math.round(e.loaded / e.total * 100) + '%');
+self1.status(LABELS.downloading(Math.round(e.loaded / e.total * 100)));
 }
 };
 xhr.onload = function () {
@@ -292,6 +292,30 @@ self.fail('模型加载失败：' + msg + '。请确认 ' + self.src + ' 已部
 }
 };
 
+var LABELS = {
+load: '加载 3D 模型',
+placeholder: '3D 模型',
+retry: '重试',
+preparing: '正在准备…',
+preparingEngine: '正在准备 3D 引擎…',
+hintBefore: '模型 ',
+hintBetween: ' 会',
+hintStrong: '点击后才下载',
+hintTail: '，首屏不占流量。',
+downloading: function (pct) { return '正在下载模型 ' + pct + '%'; },
+noWebGL: '这台设备的浏览器不支持 WebGL，无法显示 3D 模型。'
+};
+
+function setLabels(patch) {
+if (!patch) return;
+for (var k in LABELS) {
+if (Object.prototype.hasOwnProperty.call(LABELS, k)
+&& patch[k] !== undefined && patch[k] !== null) {
+LABELS[k] = patch[k];
+}
+}
+}
+
 var ModelViewer = {
 
 update: function (root) {
@@ -317,6 +341,8 @@ list[i].__mv = new Viewer(list[i]);
 },
 };
 
+ModelViewer.setLabels = setLabels;
+
 if (typeof window !== 'undefined') window.ModelViewer = ModelViewer;
 
 if (document.readyState === 'loading') {

package/dist/COSTS.md

@@ -22,38 +22,38 @@
 | 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.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 | `combobox` | 2.9 KB | 1.0 KB | 5.7 KB | **9.6 KB** | 31.8 KB | −22.2 KB |
+| primitive | `date-range` | 2.9 KB | 0.8 KB | 2.8 KB | **6.6 KB** | 28.9 KB | −22.4 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.3 KB | −23.4 KB |
+| primitive | `popover` | 2.9 KB | 0.8 KB | 2.3 KB | **6.1 KB** | 29.7 KB | −23.7 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 | `select` | 2.9 KB | 0.8 KB | 4.3 KB | **8.1 KB** | 33.1 KB | −25.0 KB |
 | primitive | `separator` | 2.9 KB | 0.2 KB | — | **3.2 KB** | 23.2 KB | −20.0 KB |
 | primitive | `skeleton` | 2.9 KB | 0.5 KB | — | **3.4 KB** | 23.8 KB | −20.4 KB |
 | primitive | `switch` | 2.9 KB | 0.8 KB | — | **3.7 KB** | 30.3 KB | −26.5 KB |
 | primitive | `timeline` | 2.9 KB | 0.5 KB | — | **3.4 KB** | 25.2 KB | −21.7 KB |
-| primitive | `upload` | 2.9 KB | 1.4 KB | 4.2 KB | **8.5 KB** | 39.3 KB | −30.8 KB |
+| primitive | `upload` | 2.9 KB | 1.4 KB | 4.5 KB | **8.8 KB** | 39.7 KB | −30.9 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.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 | `content` | 2.9 KB | 1.0 KB | — | **4.0 KB** | 26.8 KB | −22.9 KB |
+| pattern | `drawer` | 2.9 KB | 0.8 KB | 2.8 KB | **6.6 KB** | 30.8 KB | −24.3 KB |
+| pattern | `dropdown` | 2.9 KB | 0.8 KB | 3.6 KB | **7.3 KB** | 31.8 KB | −24.5 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 |
 | pattern | `nav` | 2.9 KB | 1.2 KB | 2.6 KB | **6.8 KB** | 33.0 KB | −26.2 KB |
-| pattern | `overlay` | 2.9 KB | 1.2 KB | 3.6 KB | **7.7 KB** | 38.5 KB | −30.8 KB |
-| pattern | `pagination` | 2.9 KB | 0.8 KB | 2.6 KB | **6.3 KB** | 32.4 KB | −26.1 KB |
+| pattern | `overlay` | 2.9 KB | 1.2 KB | 3.8 KB | **7.9 KB** | 39.3 KB | −31.3 KB |
+| pattern | `pagination` | 2.9 KB | 0.8 KB | 2.8 KB | **6.5 KB** | 32.8 KB | −26.3 KB |
 | pattern | `reveal` | 2.9 KB | 0.3 KB | 1.2 KB | **4.4 KB** | 26.5 KB | −22.0 KB |
 | pattern | `states` | 2.9 KB | 0.9 KB | — | **3.8 KB** | 26.3 KB | −22.5 KB |
 | pattern | `tabs` | 2.9 KB | 0.7 KB | 2.0 KB | **5.6 KB** | 29.1 KB | −23.5 KB |
-| pattern | `tooltip` | 2.9 KB | 0.5 KB | 1.9 KB | **5.3 KB** | 28.5 KB | −23.2 KB |
-| pattern | `tree` | 2.9 KB | 0.6 KB | 2.9 KB | **6.5 KB** | 30.1 KB | −23.6 KB |
+| pattern | `tooltip` | 2.9 KB | 0.5 KB | 2.0 KB | **5.4 KB** | 28.7 KB | −23.3 KB |
+| pattern | `tree` | 2.9 KB | 0.6 KB | 3.1 KB | **6.6 KB** | 30.3 KB | −23.7 KB |
 
 ## 三、全库
 
-- 全部组件都用上（min，含 tokens 一份）：**70.6 KB**
-- 源码版（带注释）全库 gzip：380.1 KB
+- 全部组件都用上（min，含 tokens 一份）：**72.6 KB**
+- 源码版（带注释）全库 gzip：386.4 KB
 
 > ⚠️ 源码版那个数字**不是**要付的钱：它包含我们的注释（全库 CSS 有 69% 是注释，字节口径）。
 > 它的用途只有一个 —— 让人看清"dist 到底省了多少"。

package/docs/ACCESSIBILITY.md

@@ -5,7 +5,7 @@
 
 | 项目 | 值 |
 |---|---|
-| 声明适用版本 | agentcss `0.25.6` |
+| 声明适用版本 | agentcss `0.26.0` |
 | 声明日期 | 2026-11-04 |
 | 复核节奏 | 每次发版前重跑（`npm run gate` 内含全部证据） |
 | 范围 | 本库交付的 CSS / JS、全部 `demo.html`（组件页 + 图表页 + 组合页）、以及文档站生成的页面 |
@@ -39,7 +39,7 @@
 | 1.4.11 | 非文本对比度 | ✅ | 控件边框 / 焦点环 / 图表色阶单独实算 |
 | 1.4.12 | 文本间距 | ◐ | 组件不写死行高与段距（都用令牌），但**未**按"行高 1.5 倍 / 段距 2 倍"的极端注入逐组件验证 |
 | 1.4.13 | 内容悬停或聚焦 | ◐ | tooltip 可 Esc 关闭、可悬停保持；**未**验证"可选中提示内文字"这一分支 |
-| 2.1.1 | 键盘 | ✅ | `keyboard-nav.js`：Tab 顺序、Enter/Space、Esc 关闭 |
+| 2.1.1 | 键盘 | ✅ | `keyboard-nav.js`：Tab 顺序、Enter/Space、Esc 关闭；**滚动容器**（`.table` / `<pre>` / 图框）在 320px 下可 Tab 进入 —— `table-check` ⑮ + `a11y-scan` 的 320px `scrollable-region-focusable` 补扫 |
 | 2.1.2 | 无键盘陷阱 | ✅ | `keyboard-nav.js`：浮层关闭后焦点可继续移动，不困在层内 |
 | 2.1.4 | 字符快捷键 | — | 库不注册单字符快捷键 |
 | 2.2.1 | 计时可调 | ◐ | toast 自动消失时长可配但有上限；**未**提供"暂停计时"控件 |

package/docs/L10N.md

@@ -0,0 +1,92 @@
+# 本地化（L10N）文案覆盖
+
+> **一句话**：库默认输出中文；把 `labels` 传进去就能换掉**用户看得见、读屏会念到**的文案。
+> 不传时输出与 0.25.x **逐字相同** —— 升级不会静默改变界面文字。
+
+```html
+<script src="03-patterns/pagination/pagination.js"></script>
+<script>
+  Pagination.create(document.querySelector('[data-pagination]'), {
+    labels: { prev: 'Previous', next: 'Next',
+              page: function (p, cur) { return 'Page ' + p + (cur ? ' (current)' : ''); } }
+  });
+</script>
+```
+
+值可以是字符串，也可以是函数（动态量用函数，例如页码、百分比）。
+
+---
+
+## 一、哪些文案**在**覆盖范围内
+
+| 组件 | 入口 | 键 |
+|---|---|---|
+| `overlay` | `Overlay.toast({ labels })` | `closeToast` |
+| `drawer` | `Drawer.open({ labels })` | `dialog`（无标题时的名字）、`close` |
+| `pagination` | `Pagination.create(node, { labels })` | `nav`、`prev`、`next`、`page(p, isCurrent)`、`status(page, pages)`、`live(page, pages)` |
+| `upload` | `new Upload(root, { labels })` | `pending`、`done`、`error`、`remove(name)`、`uploading(pct)`、`countMax(n)`、`sizeMax(limit)`、`type`、`folder`、`none(reason)`、`noDrop`、`noDropShort`、`summary(added,total,rejected)`、`removed(name,rest)` |
+| `select` | `Select.create(root, { labels })` | `option`、`placeholder` |
+| `combobox` | `Combobox.create(root, { labels })` | `suggest`、`input`、`noMatch(query)`、`empty` |
+| `date-range` | `DateRange.create(root, { labels })` | `requiredEnd`、`requiredStart`、`order(from,to)`、`min(min)`、`max(max)` |
+| `dropdown` | `Dropdown.create(root, { labels })` | `menu` |
+| `tree` | `Tree.create(root, { labels })` | `tree` |
+| `nav` | `Nav.attach(root, { labels })` | `open`、`close` |
+| `tooltip` | `Tooltip.setLabels({ region })` | `region` |
+| `model-viewer` | `ModelViewer.setLabels({ … })` | `load`、`placeholder`、`retry`、`preparing`、`preparingEngine`、`hintBefore`、`hintBetween`、`hintStrong`、`hintTail`、`downloading(pct)`、`noWebGL` |
+| `bar` | `Bar.draw({ text })` ⚠️ | `series(i)`、`clipped(n, isStack, max)` |
+
+`label` / `ariaLabel` 这类**单值**参数仍然有效，且优先于 `labels` ——
+它们是既有 API，不为统一而破坏兼容。
+
+### ⚠️ `bar` 为什么叫 `text` 而不是 `labels`
+
+`bar.draw` 的 `labels` **早就是「X 轴标签」这个数据参数**（`labels: string[]`）。
+把同一个名字改成文案对象是破坏性变更，所以这里的文案覆盖用 `text`。
+全库只此一处例外，`types/index.d.ts` 里 `BarText` 有同样的注释。
+
+### 没有逐实例入口的组件
+
+`tooltip` 与 `model-viewer` 由属性自动初始化（`data-tooltip` / `data-mv`），
+没有"传 opts 的地方"，所以用**模块级**的 `setLabels()`。
+设置一次影响该页面上后续创建的所有实例；已经创建的不受影响。
+
+---
+
+## 二、哪些**不在**覆盖范围内（不假装已做完）
+
+1. **开发期错误信息**：`throw new Error('upload: 缺少 .upload__input …')`。
+   它们面向调用方（写代码的人），不经过 UI，也不该由终端用户看到。
+   要统一英文请改源码 —— 这不属于 L10N。
+2. **`model-viewer` 的失败说明与底部说明句**：
+   `fail()` 的几条错误文案、`mv__cap` 里的「引擎就绪耗时 … ms」。
+   它们含 `<b>` 结构与多个动态量，要安全本地化得先改成节点拼装，
+   属独立改造，**当前仍是中文**。
+3. **`echarts-adapter` 的控制台提示**：`[frontend-lib] 系列数 …`，
+   属开发者提示，同上。
+
+这份清单由 `05-audit/i18n-labels-gate.js` 守着：库代码里再出现
+「中文字面量直接进 `aria-label` / `textContent` / `el()` 文本位」就红，
+要新增必须先回答"用户会看到吗"。
+
+---
+
+## 三、为什么默认不改英文
+
+- **不制造惊喜**：升级补丁版本就换掉界面语言，是比"没本地化"更糟的破坏。
+- **不猜语言环境**：`navigator.language` 在 SSR、WebView、隐私模式下都不可靠，
+  自动切换会让同一份代码在不同机器上显示不同语言，问题极难复现。
+- **真要做多语言**，正确做法是调用方在启动时按自己的语言包调 `setLabels` /
+  传 `labels` —— 词汇表由产品决定，不由组件库猜。
+
+---
+
+## 四、门禁
+
+| 门禁 | 判什么 |
+|---|---|
+| `i18n-labels` | 静态：库代码 0 处硬编码用户文案（注释与 `throw` 不在视野） |
+| `i18n-labels`（运行时） | 真浏览器里传 `labels` ⇒ DOM 真的变了；不传 ⇒ 仍是各组件的中文默认值 |
+| `i18n-labels-rev` | 判据自检：三种写法都要抓到；变量/注释/`throw` 不误报；元反向 |
+
+运行时那半条**必须先看默认值**：只断言"覆盖后等于测试串"是不够的 ——
+如果把测试串直接写进源码，那条断言照样绿。

package/docs/RELEASE-PROCESS.md

@@ -264,7 +264,13 @@ npm 与 Release 都是 absent ⇒ 删 tag、修夹具、在同一提交树上重
 
 ### 7.3 下一次真实发布要验的六条（提前固定，不许事后放宽）
 
-回执的重试逻辑还没被真实发布走过。下一次打 tag 时，按这张表逐条判定：
+`0.25.6` 的真实发布走通了**第 2 条**：`npm publish` 成功后 registry 索引延迟，
+回执对 `absent` 连续重试 13 次（每次约 10 秒）后拿到
+`npm=present provenance=ok release=present`，退出码 0；既没误入
+`unreadable` 分支，也没把重试次数用尽。这是这条修复第一次被真实发布走过。
+
+其余五条**仍只有 `release-run.sh --selftest` 的合成用例**，没有真实样本 ——
+"没被触发过"不等于"验过了"。后续打 tag 继续按这张表逐条判定：
 
 | # | 场景 | 通过条件 |
 |---|---|---|

package/docs/VERIFY-RELEASE.md

@@ -110,12 +110,17 @@ gh api 'repos/{owner}/{repo}/deployments?environment=github-pages&per_page=1' \
 |---|---|---|---|
 | L0 声明 | 「我声明它来自 X」 | 文档、CHANGELOG、tag 消息 | 声明是否为真 |
 | L1 抽样 | 「我抽查了 N 个文件，都与 X 一致」 | 有人做过小样本抽查 | 未抽查的文件是否一致 |
-| L2 全量 | 「每一个文件都与 X 的对应文件一致」 | **不存在** | 构建过程是否被污染 |
+| L2 全量 | 「每一个文件都与 X 的对应文件一致」 | `0.25.6` 起：npm 包的 335 个文件与提交树逐字节比对，0 处不一致；**站点全量仍未做** | 构建过程是否被污染 |
 | L3 密码学 | 「这个 tarball 由这条 workflow、这个提交构建」 | npm provenance（SLSA provenance v1） | 仓库之外的东西 |
 
 三条必须说清的话：
 
-1. **没有 L2。** 既没有逐个文件比对过 tarball 与提交，也没有比对过站点全量。因此「包内每个文件都来自该提交」这句话目前**说不出口**。
+1. **L2 只覆盖 npm 包，而且锚定在版本快照上。** `0.25.6` 发布后把真 tarball
+   的 335 个文件逐个与 `0668838…` 提交树比对，0 处不一致 ⇒ 对**那一版**
+   可以说「包内每个文件都来自该提交」。两个边界必须一起说清：
+   ① 站点全量从来没有比过；② 主分支后续的文档修正属于滚动更新，
+   不改变已发布快照，也不让这句结论自动延伸到以后的版本。
+   每次发布都要重新做一次全量比对，不能拿上一次的结果顶。
 2. **站点不是 npm 包的镜像。** 两个渠道发布的文件集本来就不同（包里有 `dist/`、没有 `guide/`；站点有 `guide/` 与演示页、没有构建清单）。
 3. **同一版本号不保证同一内容。** 历史上出现过一次，见下一节。
 

package/index.html

@@ -97,7 +97,7 @@ li a:active { background: var(--surface-sunken); }
   </p>
 </main>
 <footer class="wrap">
-  <p class="note">0.25.6 · 零第三方运行时依赖</p>
+  <p class="note">0.26.0 · 零第三方运行时依赖</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.6**.
+> Generated from `ai/components.json` + `ai/pitfalls*.json` + `ai/behaviors.json` at version **0.26.0**.
 > Do not edit by hand: run `python 05-audit/gen-llms.py` (freshness is gated).
 > Short version: `llms.txt`. Machine contract: `ai/*.json`.
 
@@ -32,7 +32,7 @@ Every subcommand accepts `--json`; failures print `{"ok":false,...}` and exit no
 | `scientific-plot` | `splot` | asset | stable | 3.9 KB | `scientific-plot.js` | 二维科学绘图：折线/区间带/对数轴，纯令牌驱动、零依赖 | `chart-multiline-label` |
 | `sparkline` | `sparkline` | asset | stable | 7.2 KB | `sparkline.js` | 迷你趋势图：无坐标轴、纯形状，适合表格内嵌的一行走势 | `chart-multiline-label` |
 | `accordion` | `accordion` | pattern | stable | 18.0 KB | `accordion.js` | 可折叠分组 | — |
-| `content` | `prose` | pattern | stable | 11.1 KB | — | 长文排版容器（标题/段落/列表/引用/代码） | `single-scroll-container` `line-height-constant-sync` |
+| `content` | `prose` | pattern | stable | 11.9 KB | — | 长文排版容器（标题/段落/列表/引用/代码） | `single-scroll-container` `line-height-constant-sync` |
 | `drawer` | `drawer` | pattern | stable | 5.9 KB | `drawer.js` | 侧边抽屉，含遮罩 | `fixed-element-inventory` |
 | `dropdown` | `dd` | pattern | stable | 3.9 KB | `dropdown.js` | 下拉菜单 | `popover-measure-after-render` |
 | `form-validation` | `form` | pattern | stable | 11.8 KB | — | 表单校验反馈与错误汇总 | — |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcss",
-  "version": "0.25.6",
+  "version": "0.26.0",
   "description": "移动 Web 组件库：CSS + 可选行为脚本，零第三方运行时依赖。样式用 bundler 引入，交互行为用 script 标签引入。",
   "keywords": [
     "css",
@@ -20,6 +20,7 @@
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
+      "import": "./esm/index.mjs",
       "default": "./esm/index.mjs"
     },
     "./tokens.css": "./dist/01-tokens/tokens.css",
@@ -116,7 +117,7 @@
     "pixelmatch": "^5.3.0",
     "playwright": "^1.49.1",
     "pngjs": "^7.0.0",
-    "puppeteer-core": "^23.11.1",
+    "puppeteer-core": "^25.16.0",
     "typescript": "^5.9.3",
     "yaml": "^2.9.1"
   },