agentcss 0.25.5 → 0.26.0

package/START-HERE.md

@@ -39,39 +39,39 @@
 | 标签 / 徽章 | `02-primitives/badge/badge.css` | 141 | — | 有状态标记就要（"已披露""停牌"） |
 | 卡片 | `02-primitives/card/card.css` | 283 | — | 有分组内容就要 |
 | 单选 / 多选 | `02-primitives/choice/choice.css` | 434 | — | 单选 / 多选就要 |
-| 下拉选择 | `02-primitives/select/select.css` | 151 | **必需 631** (`select.js`) | 原生 select 的外观或交互不够用就要 |
-| 可搜索选择 | `02-primitives/combobox/combobox.css` | 223 | **必需 480** (`combobox.js`) | 选项多到要搜索，或要选多个并留成标签就要 |
+| 下拉选择 | `02-primitives/select/select.css` | 151 | **必需 652** (`select.js`) | 原生 select 的外观或交互不够用就要 |
+| 可搜索选择 | `02-primitives/combobox/combobox.css` | 223 | **必需 503** (`combobox.js`) | 选项多到要搜索，或要选多个并留成标签就要 |
 | 开关 | `02-primitives/switch/switch.css` | 429 | — | 有"立即生效的设置"就要 |
 | 分隔线 | `02-primitives/separator/separator.css` | 73 | — | 要分开内容块就要 |
 | 加载骨架 | `02-primitives/skeleton/skeleton.css` | 114 | — | 数据还没到、先把版式占住就要 |
 | 进度条 / 环 | `02-primitives/progress/progress.css` | 228 | — | 有耗时过程要给进度就要 |
-| 浮层气泡 | `02-primitives/popover/popover.css` | 187 | **必需 325** (`popover.js`) | 要一段信息贴着触发元素浮出来就要 |
-| 日期区间 | `02-primitives/date-range/date-range.css` | 206 | **必需 310** (`date-range.js`) | 要选起止日期就要 |
+| 浮层气泡 | `02-primitives/popover/popover.css` | 187 | **必需 345** (`popover.js`) | 要一段信息贴着触发元素浮出来就要 |
+| 日期区间 | `02-primitives/date-range/date-range.css` | 206 | **必需 332** (`date-range.js`) | 要选起止日期就要 |
 | 标签页 | `03-patterns/tabs/tabs.css` | 172 | **必需 316** (`tabs.js`) | 同层级内容切换就要 |
 | 折叠面板 | `03-patterns/accordion/accordion.css` | 453 | **必需 389** (`accordion.js`) | 长表单分段就要 |
-| 动作菜单 | `03-patterns/dropdown/dropdown.css` | 135 | **必需 555** (`dropdown.js`) | 要一组动作（新建 / 导出 / 删除）就要 |
-| 文字提示 | `03-patterns/tooltip/tooltip.css` | 89 | **必需 284** (`tooltip.js`) | 图标按钮或缩写需要一句话解释就要 |
-| 分页 | `03-patterns/pagination/pagination.css` | 195 | **必需 401** (`pagination.js`) | 数据多到要翻页就要 |
-| 树形 | `03-patterns/tree/tree.css` | 122 | **必需 464** (`tree.js`) | 层级数据（文件 / 组织 / 分类）要展开就要 |
-| 侧边抽屉 | `03-patterns/drawer/drawer.css` | 145 | **必需 378** (`drawer.js`) | 要从侧边滑出面板就要 |
-| 弹窗 / 吐司 | `03-patterns/overlay/overlay.css` | 338 | **必需 697** (`overlay.js`) | 需要弹层（吐司 / 模态）就要 |
+| 动作菜单 | `03-patterns/dropdown/dropdown.css` | 135 | **必需 575** (`dropdown.js`) | 要一组动作（新建 / 导出 / 删除）就要 |
+| 文字提示 | `03-patterns/tooltip/tooltip.css` | 89 | **必需 299** (`tooltip.js`) | 图标按钮或缩写需要一句话解释就要 |
+| 分页 | `03-patterns/pagination/pagination.css` | 195 | **必需 428** (`pagination.js`) | 数据多到要翻页就要 |
+| 树形 | `03-patterns/tree/tree.css` | 122 | **必需 484** (`tree.js`) | 层级数据（文件 / 组织 / 分类）要展开就要 |
+| 侧边抽屉 | `03-patterns/drawer/drawer.css` | 145 | **必需 416** (`drawer.js`) | 要从侧边滑出面板就要 |
+| 弹窗 / 吐司 | `03-patterns/overlay/overlay.css` | 338 | **必需 734** (`overlay.js`) | 需要弹层（吐司 / 模态）就要 |
 | 状态（空 / 加载 / 错 / 成功） | `03-patterns/states/states.css` | 269 | — | **凡是会异步取数就要** |
 | 表单校验 | `03-patterns/form-validation/form-validation.css` | 274 | — | 提交前要校验就要 |
 | 列表增删 | `03-patterns/list/list.css` | 162 | 可选 201 (`flip.js`，FLIP 增删动画，纯增强) | 列表会动态增删就要 |
 | 导航 / 目录 | `03-patterns/nav/nav.css` | 314 | **必需 425** (`nav.js`) · 可选 111 (`toc.js`，自动生成目录，纯增强) | 顶部要导航，或长文要目录就要 |
-| 长文排版 | `03-patterns/content/content.css` | 286 | — | 写文档 / 长文就要 |
+| 长文排版 | `03-patterns/content/content.css` | 298 | — | 写文档 / 长文就要 |
 | delta | `02-primitives/delta/delta.css` | 113 | — |  |
 | metric | `02-primitives/metric/metric.css` | 157 | — |  |
 | timeline | `02-primitives/timeline/timeline.css` | 152 | — | 有一串按时间排的事件（公告 / 大事记 / 版本记录）就要 |
-| upload | `02-primitives/upload/upload.css` | 490 | 可选 676 (`upload.js`，拖放 / 文件列表 / 校验；没有它基础形态照常工作) |  |
+| upload | `02-primitives/upload/upload.css` | 490 | 可选 709 (`upload.js`，拖放 / 文件列表 / 校验；没有它基础形态照常工作) |  |
 | reveal | `03-patterns/reveal/reveal.css` | 93 | 可选 175 (`reveal.js`，入场动效，纯增强；没有它内容直接可见) |  |
 | analysis-report | `04-recipes/analysis-report/analysis-report.css` | 226 | — |  |
 | app-shell | `04-recipes/app-shell/app-shell.css` | 588 | **必需 289** (`shell-nav.js`) |  |
 | detail-page | `04-recipes/detail-page/detail-page.css` | 190 | — |  |
 | report | `04-recipes/report/report.css` | 369 | — |  |
 | table | `04-recipes/table/table.css` | 409 | — |  |
-| bar | `09-assets/bar/bar.css` | 181 | **必需 324** (`bar.js`) |  |
-| model-viewer | `09-assets/model-viewer/model-viewer.css` | 143 | **必需 432** (`model-viewer.js`) |  |
+| bar | `09-assets/bar/bar.css` | 181 | **必需 348** (`bar.js`) |  |
+| model-viewer | `09-assets/model-viewer/model-viewer.css` | 143 | **必需 464** (`model-viewer.js`) |  |
 | scientific-plot | `09-assets/scientific-plot/scientific-plot.css` | 141 | **必需 604** (`scientific-plot.js`) |  |
 | sparkline | `09-assets/sparkline/sparkline.css` | 158 | **必需 508** (`sparkline.js`) |  |
 

package/SUPPORT.md

@@ -97,9 +97,9 @@ grep 一条都数不到），还有 `skip "…"`（这台机器跑不了的门
 
 ### 试过一次的（🔍 人工实测，无回归保护）
 
-7 行数据来自在真实设备上打开 [`capability-probe.html`](10-review/webview/capability-probe.html)。
+7 行数据来自在真实设备上打开 [`capability-probe.html`](https://github.com/owain323/frontend-lib/blob/master/10-review/webview/capability-probe.html)。
 完整 UA 与逐项结论在 [`docs/LAYER-BASELINE.md`](docs/LAYER-BASELINE.md)；
-15 项能力分别是什么、怎么自己复跑一遍，在 [`10-review/webview/RESULTS.md`](10-review/webview/RESULTS.md)。
+15 项能力分别是什么、怎么自己复跑一遍，在 [`10-review/webview/RESULTS.md`](https://github.com/owain323/frontend-lib/blob/master/10-review/webview/RESULTS.md)。
 本节 7 行**全部是 `🔍`** —— 没有一行有自动化守着。
 
 | 入口 | UA 自述的环境 | 实测 | 缺什么 |

package/ai/components.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "1.0.0",
   "generatedBy": "05-audit/gen-ai-contract.py",
-  "libraryVersion": "0.25.5",
+  "libraryVersion": "0.26.0",
   "$comment": "机器可读的组件契约。slots = BEM 元素名（在本库里元素名就是插槽名），states.enum = 组件会在 DOM 上写出的 data-* 取值，states.legacyClass = 仍未收敛到 data 属性的历史状态类（INVARIANT I-8 未达标）。printPolicy = 这个组件在纸上会发生什么（空数组 = 原样保留）；pagination = 内容是否被分页裁过（server 不许与 expand 同时出现，否则展开的只是当前一页）。",
   "maturityCriteria": {
     "alpha": "缺 demo.html 或缺 05-audit 下的专属门禁 ⇒ 还没被机器验证过，不要用",
@@ -249,11 +249,13 @@
       },
       "aria": {
         "roles": [
-          "img"
+          "img",
+          "region"
         ],
         "attrs": [
           "hidden",
-          "label"
+          "label",
+          "labelledby"
         ]
       },
       "usesOtherNamespaces": [],
@@ -2411,7 +2413,9 @@
         "legacyClass": []
       },
       "aria": {
-        "roles": [],
+        "roles": [
+          "region"
+        ],
         "attrs": [
           "hidden",
           "label"
@@ -2475,6 +2479,7 @@
       "aria": {
         "roles": [
           "alert",
+          "region",
           "status"
         ],
         "attrs": [

package/ai/pdf.js

@@ -75,6 +75,35 @@ const DEFAULT_MARGIN = '18mm 15mm';
  *    **找不到就明确报错，不许静默降级**。
  *    漂移由 `05-audit/pdf-export-gate.js` 的 E8 交叉核对（两边都找到时必须是同一个文件）。
  */
+/* Playwright 实际会用到的可执行文件名。只收这几个 —— 名字表越宽，
+   越可能在缓存目录里认错文件（例如 README、脚本）。 */
+const PW_EXE = [
+  'chrome', 'chrome.exe',
+  'chrome-headless-shell', 'chrome-headless-shell.exe',
+  'headless_shell', 'headless_shell.exe',
+  'Chromium', 'Google Chrome for Testing', 'Google Chrome for Testing.exe',
+];
+
+/** 在 Playwright 的 chromium* 目录里按文件名找可执行文件（有界递归，depth 层） */
+function scanForExe(dir, depth) {
+  let names;
+  try { names = fs.readdirSync(dir); } catch (e) { return null; }
+  const dirs = [];
+  for (const n of names) {
+    const p = path.join(dir, n);
+    let st;
+    try { st = fs.statSync(p); } catch (e) { continue; }
+    if (st.isDirectory()) { dirs.push(p); continue; }
+    if (PW_EXE.indexOf(n) !== -1) return p;
+  }
+  if (depth <= 0) return null;
+  for (const d of dirs) {
+    const hit = scanForExe(d, depth - 1);
+    if (hit) return hit;
+  }
+  return null;
+}
+
 function chromeCandidates() {
   const out = [];
   if (process.env.AGENTCSS_CHROME) out.push(process.env.AGENTCSS_CHROME);
@@ -97,18 +126,28 @@ function chromeCandidates() {
     out.push('/usr/bin/google-chrome', '/usr/bin/google-chrome-stable',
       '/usr/bin/chromium', '/usr/bin/chromium-browser', '/snap/bin/chromium');
   }
-  /* CI 上没有系统 Chrome：Playwright 装的那份也得认，否则"能导出"只在开发机上成立 */
-  for (const root of [path.join(os.homedir(), '.cache/ms-playwright'),
-    path.join(os.homedir(), 'Library/Caches/ms-playwright')]) {
+  /* CI 上没有系统 Chrome：Playwright 装的那份也得认，否则"能导出"只在开发机上成立。
+     ⚠️ **不写死目录布局**。Playwright 改过两次命名：
+          chrome-linux/chrome        → chrome-linux64/chrome
+          chrome-linux/headless_shell → chrome-headless-shell-linux64/chrome-headless-shell
+        写死布局的结果就是"某天起突然 no-chrome"（外部审计 F5 实测：
+        干净环境里 `npm ci && npx playwright install chromium` 之后依然找不到）。
+        ⇒ 在 chromium* 目录下按**可执行文件名**有界递归找，布局怎么变都还能找到。
+     ⚠️ Windows 的根目录是 %LOCALAPPDATA%\ms-playwright —— `~/.cache` 在 Windows 上不存在。 */
+  const roots = [
+    process.env.PLAYWRIGHT_BROWSERS_PATH,
+    process.env.LOCALAPPDATA && path.join(process.env.LOCALAPPDATA, 'ms-playwright'),
+    path.join(os.homedir(), '.cache/ms-playwright'),
+    path.join(os.homedir(), 'Library/Caches/ms-playwright'),
+  ].filter(Boolean);
+  for (const root of roots) {
     let names;
     try { names = fs.readdirSync(root); } catch (e) { continue; }
     for (const n of names) {
       if (!/^chromium/.test(n)) continue;
-      for (const rel of ['chrome-linux/chrome',
-        'chrome-mac/Chromium.app/Contents/MacOS/Chromium',
-        'chrome-win/chrome.exe', 'chrome-linux/headless_shell']) {
-        out.push(path.join(root, n, ...rel.split('/')));
-      }
+      /* 深度 4：macOS 的 .app 包多两层（见 browser.js 同一处注释） */
+      const hit = scanForExe(path.join(root, n), 4);
+      if (hit) out.push(hit);
     }
   }
   return out.filter(Boolean);
@@ -351,4 +390,7 @@ function overBudgetMessage(got, budget, spec, margin, out, box, injected) {
 module.exports = {
   exportPdf, resolveChrome, normalizeMargin, paperSpec, PAPERS,
   DEFAULT_PAPER, DEFAULT_MARGIN,
+  /* 只为可测性导出：浏览器发现逻辑必须在"没有系统 Chrome"的机器上也能被验证，
+     否则它只会在 CI 上坏、而开发机永远绿。 */
+  chromeCandidates,
 };

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

@@ -0,0 +1,11 @@
+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;
+};

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

@@ -119,6 +119,28 @@ return true;
 var uid = 0;
 
 function create(root, opt) {
+
+var DEFAULT_LABELS = {
+suggest: '建议',
+input: '输入',
+noMatch: function (q) { return '没有匹配「' + q + '」的选项'; },
+empty: '暂无可选'
+};
+
+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 || {};
 var input = root.querySelector('[data-combo-input]');
 var list = root.querySelector('[data-combo-list]');
@@ -147,14 +169,14 @@ var activeIdx = -1;
 var shown = [];
 
 list.setAttribute('role', 'listbox');
-list.setAttribute('aria-label', opt.label || '建议');
+list.setAttribute('aria-label', opt.label || L.suggest);
 input.setAttribute('role', 'combobox');
 input.setAttribute('aria-autocomplete', 'list');
 input.setAttribute('aria-expanded', 'false');
 input.setAttribute('aria-controls', list.id);
 if (!input.id) input.id = 'combo-input-' + seq;
 if (!input.getAttribute('aria-label') && !root.querySelector('label[for="' + input.id + '"]')) {
-input.setAttribute('aria-label', opt.label || '输入');
+input.setAttribute('aria-label', opt.label || L.input);
 }
 
 function esc(s) {
@@ -190,7 +212,7 @@ return String(s).replace(/[&<>"]/g, function (c) {
       if (!shown.length) {
         /* @html-sink escaped — 插值只有 q，且过了 esc() */
         list.innerHTML = '<li class="combo__empty" role="presentation">' +
-          (q ? '没有匹配「' + esc(q) + '」的选项' : '暂无可选') + '</li>';
+          (q ? L.noMatch(esc(q)) : L.empty) + '</li>';
         return;
       }
       var ql = q.toLowerCase();

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

@@ -94,6 +94,27 @@ return { from: iso(start), to: iso(end) };
 }
 
 function create(root, opt) {
+
+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 DEFAULT_LABELS = {
+requiredEnd: '请填写结束日期。',
+requiredStart: '请填写开始日期。',
+order: function (f, t) { return '开始日期不能晚于结束日期（当前：' + f + ' → ' + t + '）。'; },
+min: function (min) { return '开始日期不能早于 ' + min + '。'; },
+max: function (max) { return '结束日期不能晚于 ' + max + '。'; }
+};
+var L = flLabels(DEFAULT_LABELS, opt && opt.labels);
 opt = opt || {};
 var from = root.querySelector('[data-dr-from]');
 var to = root.querySelector('[data-dr-to]');
@@ -132,14 +153,14 @@ return Math.round((b - a) / 86400000) + 1;
 function validate() {
 var f = from.value, t = to.value;
 if (!f && !t) { setError(''); paintSummary(''); return true; }
-if (f && !t) { setError('请填写结束日期。'); return false; }
-if (!f && t) { setError('请填写开始日期。'); return false; }
+if (f && !t) { setError(L.requiredEnd); return false; }
+if (!f && t) { setError(L.requiredStart); return false; }
 if (f > t) {
-setError('开始日期不能晚于结束日期（当前：' + f + ' → ' + t + '）。');
+setError(L.order(f, t));
 return false;
 }
-if (opt.min && f < opt.min) { setError('开始日期不能早于 ' + opt.min + '。'); return false; }
-if (opt.max && t > opt.max) { setError('结束日期不能晚于 ' + opt.max + '。'); return false; }
+if (opt.min && f < opt.min) { setError(L.min(opt.min)); return false; }
+if (opt.max && t > opt.max) { setError(L.max(opt.max)); return false; }
 setError('');
 paintSummary(f + ' → ' + t + '（' + days(f, t) + ' 天）');
 return true;

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

@@ -148,10 +148,11 @@ box.setAttribute('inert', '');
 
 box.setAttribute('role', 'dialog');
 box.setAttribute('aria-label', opts.label || '');
+var bodyHtml = sanitizeHtml(opts.html || '', opts.sanitize);
 
 box.innerHTML =
 '<span class="popover__arrow" aria-hidden="true"></span>'+
-'<div class="popover__body">'+ (opts.html || '') + '</div>';
+'<div class="popover__body">'+ bodyHtml + '</div>';
 
 positionArrow(box, trigger);
 anchor.appendChild(box);
@@ -230,6 +231,17 @@ el: box,
 return api;
 }
 
+var SANITIZER = null;
+
+function setSanitizer(fn) {
+SANITIZER = (typeof fn === 'function') ? fn : null;
+}
+
+function sanitizeHtml(html, perCall) {
+var fn = (typeof perCall === 'function') ? perCall : SANITIZER;
+return fn ? String(fn(String(html))) : String(html);
+}
+
 function positionArrow(box, trigger) {
 var arrow = box.querySelector('.popover__arrow');
 if (!arrow) return;
@@ -256,5 +268,6 @@ closeAll: function () { if (current) current.close(); },
 get current() { return current; },
 };
 
+Popover.setSanitizer = setSanitizer;
 global.Popover = Popover;
 })(typeof window !== 'undefined' ? window : globalThis);

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

@@ -213,6 +213,26 @@ return true;
 var uid = 0;
 
 function create(root, opt) {
+
+var DEFAULT_LABELS = {
+option: '选项',
+placeholder: '请选择'
+};
+
+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 || {};
 var btn = root.querySelector('[data-select-btn]');
 var list = root.querySelector('[data-select-list]');
@@ -253,7 +273,7 @@ seed(opt.value);
 
 list.setAttribute('role', 'listbox');
 if (isMulti) list.setAttribute('aria-multiselectable', 'true');
-list.setAttribute('aria-label', opt.label || '选项');
+list.setAttribute('aria-label', opt.label || L.option);
 btn.setAttribute('aria-haspopup', 'listbox');
 btn.setAttribute('aria-expanded', 'false');
 btn.setAttribute('aria-controls', list.id);
@@ -293,7 +313,7 @@ var texts = [];
 for (var i = 0; i < options.length; i++) {
 if (hasValue(valueOfOpt(options[i]))) texts.push(optText(options[i]));
 }
-return texts.length ? texts.join('、') : (opt.placeholder || '请选择');
+return texts.length ? texts.join('、') : (opt.placeholder || L.placeholder);
 }
 
 function optText(o) {

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

@@ -32,7 +32,38 @@ error: 'M8 1.7a6.3 6.3 0 1 0 0 12.6A6.3 6.3 0 0 0 8 1.7zM8 4.9v3.4M8 11.1v.5',
 remove: 'M4.2 4.2l7.6 7.6M11.8 4.2l-7.6 7.6'
 };
 
-var STATE_TEXT = { pending: '待上传', done: '已完成', error: '失败' };
+var DEFAULT_LABELS = {
+pending: '待上传',
+done: '已完成',
+error: '失败',
+remove: function (name) { return '移除 ' + name; },
+uploading: function (pct) { return '上传中 ' + Math.round(pct) + '%'; },
+countMax: function (n) { return '最多 ' + n + ' 个文件'; },
+sizeMax: function (limit) { return '超过 ' + limit; },
+type: '类型不支持',
+folder: '请拖入文件，不支持文件夹',
+none: function (reason) { return reason ? '未添加任何文件：' + reason : '未添加任何文件'; },
+noDrop: '当前浏览器不支持拖放，请点「选择文件」',
+noDropShort: '当前浏览器不支持拖放，请点选择文件',
+summary: function (added, total, rejected) {
+var s = '已添加 ' + added + ' 个文件，共 ' + total + ' 个';
+if (rejected) s += '；' + rejected + ' 个未通过校验';
+return s;
+},
+removed: function (name, rest) { return '已移除 ' + name + '，还剩 ' + rest + ' 个'; }
+};
+
+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 humanSize(n) {
 if (typeof n !== 'number' || n < 0) return '';
@@ -110,6 +141,7 @@ function Upload(root, opts) {
 var opt = opts || {};
 
 this.root = root;
+this.labels = flLabels(DEFAULT_LABELS, opt && opt.labels);
 this.input = root.querySelector('.upload__input');
 this.list = root.querySelector('.upload__list');
 this.status = root.querySelector('.upload__status');
@@ -209,15 +241,15 @@ var accept = this.input.getAttribute('accept');
 for (var i = 0; i < incoming.length; i++) {
 var f = incoming[i];
 if (maxFiles && keep.length >= maxFiles) {
-rejected.push({ file: f, reason: 'count', text: '最多 ' + maxFiles + ' 个文件' });
+rejected.push({ file: f, reason: 'count', text: this.labels.countMax(maxFiles) });
 continue;
 }
 if (this.maxSize && f.size > this.maxSize) {
-rejected.push({ file: f, reason: 'size', text: '超过 ' + humanSize(this.maxSize) });
+rejected.push({ file: f, reason: 'size', text: this.labels.sizeMax(humanSize(this.maxSize)) });
 continue;
 }
 if (!matchesAccept(f, accept)) {
-rejected.push({ file: f, reason: 'type', text: '类型不支持' });
+rejected.push({ file: f, reason: 'type', text: this.labels.type });
 continue;
 }
 keep.push(f);
@@ -231,7 +263,7 @@ var r = this._validate(incoming);
 if (dirCount) {
 r.rejected.push({
 file: { name: dirCount + ' 个文件夹', size: 0 },
-reason: 'dir', text: '请拖入文件，不支持文件夹'
+reason: 'dir', text: this.labels.folder
 });
 }
 
@@ -239,7 +271,7 @@ if (!r.keep.length) {
 
 this.rejected = r.rejected;
 this.render();
-this.announce(r.rejected.length ? '未添加任何文件：' + r.rejected[0].text : '未添加任何文件');
+this.announce(this.labels.none(r.rejected.length ? r.rejected[0].text : ''));
 flEmit(this.root, 'fl-upload', {
 files: currentFiles(this.input), added: 0, rejected: r.rejected
 });
@@ -249,9 +281,9 @@ return false;
 if (!writeFiles(this.input, r.keep)) {
 
 this.rejected = [{ file: r.keep[0], reason: 'unsupported',
-text: '当前浏览器不支持拖放，请点「选择文件」' }];
+text: this.labels.noDrop }];
 this.render();
-this.announce('当前浏览器不支持拖放，请点选择文件');
+this.announce(this.labels.noDropShort);
 return false;
 }
 
@@ -317,7 +349,7 @@ mark.appendChild(iconEl(state === 'done' ? 'done' : state === 'error' ? 'error'
 
 var sr = document.createElement('span');
 sr.className = 'upload__status';
-sr.textContent = STATE_TEXT[state] || '';
+sr.textContent = this.labels[state] || '';
 mark.appendChild(sr);
 
 var name = document.createElement('span');
@@ -346,12 +378,12 @@ this.paintProgress(bar0, pct);
 var rm = document.createElement('button');
 rm.className = 'upload__remove';
 rm.type = 'button';
-rm.setAttribute('aria-label', '移除 ' + (file.name || ''));
+rm.setAttribute('aria-label', this.labels.remove(file.name || ''));
 rm.appendChild(iconEl('remove'));
 rm.addEventListener('click', function () { self.removeAt(index); });
 li.appendChild(rm);
 
-if (pct != null && pct >= 0) meta.textContent = '上传中 ' + Math.round(pct) + '%';
+if (pct != null && pct >= 0) meta.textContent = self.labels.uploading(pct);
 }
 
 return li;
@@ -396,7 +428,7 @@ mark.innerHTML = '';
 mark.appendChild(iconEl('done'));
 var sr = document.createElement('span');
 sr.className = 'upload__status';
-sr.textContent = STATE_TEXT.done;
+sr.textContent = this.labels.done;
 mark.appendChild(sr);
 }
 if (meta && f) meta.textContent = humanSize(f.size);
@@ -417,7 +449,7 @@ li.insertBefore(bar, rmBtn || null);
 }
 this.paintProgress(bar, pct);
 
-if (meta) meta.textContent = '上传中 ' + Math.round(pct) + '%';
+if (meta) meta.textContent = this.labels.uploading(pct);
 },
 
 removeAt: function (i) {
@@ -435,7 +467,7 @@ if (li && li.parentNode) li.parentNode.removeChild(li);
 
 this.rebind();
 this.syncCount();
-this.announce('已移除 ' + (removed.name || '文件') + '，还剩 ' + rest.length + ' 个');
+this.announce(this.labels.removed(removed.name || '文件', rest.length));
 flEmit(this.root, 'fl-upload', {
 files: rest, added: 0, removed: removed, rejected: []
 });
@@ -467,9 +499,7 @@ this._announceTimer = global.setTimeout(function () { el.textContent = msg; }, 6
 
 summary: function (added, rejected) {
 var total = currentFiles(this.input).length;
-var s = '已添加 ' + added + ' 个文件，共 ' + total + ' 个';
-if (rejected) s += '；' + rejected + ' 个未通过校验';
-return s;
+return this.labels.summary(added, total, rejected);
 },
 
 destroy: function () {

package/dist/03-patterns/content/content.css

@@ -1 +1 @@
-.prose {max-width:var(--measure-prose);color:var(--text-primary);}.prose > * + * {margin-top:var(--sp-4);}.prose > h1, .prose > h2, .prose > h3, .prose > h4, .prose > h5, .prose > h6 {font-family:var(--sans);font-weight:500;line-height:var(--lh-tight);letter-spacing:-0.008em;margin:var(--sp-7) 0 0;}.prose > h1 {font-size:var(--fs-2xl);margin-top:0;}.prose > h2 {font-size:var(--fs-lg);padding-top:var(--sp-5);border-top:2px solid var(--accent);max-width:92%;}.prose > h3 {font-size:var(--fs-md);}.prose > h4, .prose > h5, .prose > h6 {font-size:var(--fs-base);color:var(--text-secondary);}.prose > p {margin:0;line-height:1.75;}.prose > code, .prose > li > code, .prose > td > code, .prose > th > code {font-family:var(--mono);font-size:0.88em;background:var(--surface-sunken);border:1px solid var(--border-decor);border-radius:3px;padding:0.05em 0.3em;}.prose > pre > code, .prose > pre {font-family:inherit;font-size:inherit;background:none;border:none;padding:0;border-radius:0;}.prose > ul, .prose > ol {padding-inline-start:1.5em;margin:0;}.prose > ul {list-style:disc;}.prose > ol {list-style:decimal;}.prose li + li {margin-top:var(--sp-2);}.prose li > ul, .prose li > ol {margin-top:var(--sp-2);}.prose li > ul {list-style:circle;}.prose > blockquote {margin:var(--sp-5) 0;padding:0 0 0 var(--sp-4);border-inline-start:3px solid var(--accent);}.prose > blockquote > p {color:var(--text-secondary);font-size:var(--fs-md);line-height:1.6;}.prose > blockquote > blockquote {margin:var(--sp-3) 0;}.prose > pre {margin:0;padding:var(--sp-4);background:var(--surface-sunken);border-inline-start:3px solid var(--border-decor-str);border-radius:0 var(--r-sm) var(--r-sm) 0;overflow-x:auto;font-family:var(--mono);font-size:var(--fs-xs);line-height:1.6;tab-size:4;-webkit-overflow-scrolling:touch;}.prose > pre:not([class]) {border-inline-start-color:var(--border-decor);}.prose > table {width:100%;border-collapse:collapse;table-layout:auto;font-size:var(--fs-sm);}.prose > table th, .prose > table td {text-align:start;padding:var(--sp-2) var(--sp-4) var(--sp-2) 0;border-bottom:1px solid var(--border-decor);vertical-align:top;}.prose > table th {font-weight:500;font-size:var(--fs-xs);color:var(--text-secondary);}.prose > table tbody tr:last-child td {border-bottom:1px solid var(--border-decor-str);}.prose > hr {margin:var(--sp-7) 0;border:0;border-top:1px solid var(--border-decor);height:0;}.prose > img {max-width:100%;height:auto;display:block;border-radius:var(--r-sm);}.prose a {color:var(--accent);text-decoration:underline;text-underline-offset:2px;text-decoration-thickness:1px;}@media (hover:hover) and (pointer:fine) {.prose a:hover {color:var(--text-primary);}}.prose a:focus-visible {outline:2px solid var(--accent);outline-offset:2px;}.prose > a[target="_blank"]::after {content:" ↗";font-size:0.8em;vertical-align:0.1em;}.prose > del, .prose > s, .prose > li > del, .prose > li > s {color:var(--text-tertiary);}.prose .task-list-item {list-style:none;margin-inline-start:-1.5em;}.prose .task-list-item input[type="checkbox"] {margin-inline-end:var(--sp-2);vertical-align:middle;}.prose .task-list-item input[disabled] {accent-color:var(--accent);}.prose :focus-visible {outline:2px solid var(--accent);outline-offset:2px;}.prose a:visited {color:var(--accent);text-decoration:underline;text-underline-offset:2px;}
+.prose {max-width:var(--measure-prose);color:var(--text-primary);}.prose > * + * {margin-top:var(--sp-4);}.prose > h1, .prose > h2, .prose > h3, .prose > h4, .prose > h5, .prose > h6 {font-family:var(--sans);font-weight:500;line-height:var(--lh-tight);letter-spacing:-0.008em;margin:var(--sp-7) 0 0;}.prose > h1 {font-size:var(--fs-2xl);margin-top:0;}.prose > h2 {font-size:var(--fs-lg);padding-top:var(--sp-5);border-top:2px solid var(--accent);max-width:92%;}.prose > h3 {font-size:var(--fs-md);}.prose > h4, .prose > h5, .prose > h6 {font-size:var(--fs-base);color:var(--text-secondary);}.prose > p {margin:0;line-height:1.75;}.prose > code, .prose > li > code, .prose > td > code, .prose > th > code {font-family:var(--mono);font-size:0.88em;background:var(--surface-sunken);border:1px solid var(--border-decor);border-radius:3px;padding:0.05em 0.3em;}.prose > pre > code, .prose > pre {font-family:inherit;font-size:inherit;background:none;border:none;padding:0;border-radius:0;}.prose > ul, .prose > ol {padding-inline-start:1.5em;margin:0;}.prose > ul {list-style:disc;}.prose > ol {list-style:decimal;}.prose li + li {margin-top:var(--sp-2);}.prose li > ul, .prose li > ol {margin-top:var(--sp-2);}.prose li > ul {list-style:circle;}.prose > blockquote {margin:var(--sp-5) 0;padding:0 0 0 var(--sp-4);border-inline-start:3px solid var(--accent);}.prose > blockquote > p {color:var(--text-secondary);font-size:var(--fs-md);line-height:1.6;}.prose > blockquote > blockquote {margin:var(--sp-3) 0;}.prose > pre {margin:0;padding:var(--sp-4);background:var(--surface-sunken);border-inline-start:3px solid var(--border-decor-str);border-radius:0 var(--r-sm) var(--r-sm) 0;overflow-x:auto;font-family:var(--mono);font-size:var(--fs-xs);line-height:1.6;tab-size:4;-webkit-overflow-scrolling:touch;}.prose > pre:not([class]) {border-inline-start-color:var(--border-decor);}.prose > table {width:100%;border-collapse:collapse;table-layout:auto;font-size:var(--fs-sm);}.prose > table th, .prose > table td {text-align:start;padding:var(--sp-2) var(--sp-4) var(--sp-2) 0;border-bottom:1px solid var(--border-decor);vertical-align:top;}.prose > table th {font-weight:500;font-size:var(--fs-xs);color:var(--text-secondary);}.prose > table tbody tr:last-child td {border-bottom:1px solid var(--border-decor-str);}.prose > hr {margin:var(--sp-7) 0;border:0;border-top:1px solid var(--border-decor);height:0;}.prose img {max-width:100%;height:auto;display:block;border-radius:var(--r-sm);}.prose a {color:var(--accent);text-decoration:underline;text-underline-offset:2px;text-decoration-thickness:1px;}@media (hover:hover) and (pointer:fine) {.prose a:hover {color:var(--text-primary);}}.prose a:focus-visible {outline:2px solid var(--accent);outline-offset:2px;}.prose > a[target="_blank"]::after {content:" ↗";font-size:0.8em;vertical-align:0.1em;}.prose > del, .prose > s, .prose > li > del, .prose > li > s {color:var(--text-tertiary);}.prose .task-list-item {list-style:none;margin-inline-start:-1.5em;}.prose .task-list-item input[type="checkbox"] {margin-inline-end:var(--sp-2);vertical-align:middle;}.prose .task-list-item input[disabled] {accent-color:var(--accent);}.prose :focus-visible {outline:2px solid var(--accent);outline-offset:2px;}.prose a:visited {color:var(--accent);text-decoration:underline;text-underline-offset:2px;}

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

@@ -171,8 +171,34 @@ top:    'drawer--top',
 bottom: 'drawer--bottom'
 };
 
+var SANITIZER = null;
+
+function setSanitizer(fn) {
+SANITIZER = (typeof fn === 'function') ? fn : null;
+}
+
+function sanitizeHtml(html, perCall) {
+var fn = (typeof perCall === 'function') ? perCall : SANITIZER;
+return fn ? String(fn(String(html))) : String(html);
+}
+
+var DEFAULT_LABELS = { dialog: '抽屉', close: '关闭' };
+
+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 open(opt) {
 opt = opt || {};
+var L = flLabels(DEFAULT_LABELS, opt && opt.labels);
 var place = opt.place || 'right';
 var placeCls = PLACE_CLASS[place];
 if (!placeCls) placeCls = PLACE_CLASS.right;
@@ -191,7 +217,7 @@ d.setAttribute('role', 'dialog');
 d.setAttribute('aria-modal', 'true');
 if (!d.id) d.id = 'drawer-' + (new Date()).getTime();
 if (opt.title) d.setAttribute('aria-labelledby', d.id + '-title');
-else d.setAttribute('aria-label', opt.label || '抽屉');
+else d.setAttribute('aria-label', opt.label || L.dialog);
 d.tabIndex = -1;
 
 var head = document.createElement('div');
@@ -203,15 +229,17 @@ h.textContent = opt.title || '';
 var closeBtn = document.createElement('button');
 closeBtn.className = 'drawer__close';
 closeBtn.type = 'button';
-closeBtn.setAttribute('aria-label', '关闭');
+closeBtn.setAttribute('aria-label', L.close);
 closeBtn.textContent = '\u00D7';
 head.appendChild(h);
 head.appendChild(closeBtn);
 
 var body = document.createElement('div');
 body.className = 'drawer__body';
+if (typeof opt.content === 'string') {
 
-if (typeof opt.content === 'string') body.innerHTML = opt.content;
+body.innerHTML = sanitizeHtml(opt.content, opt.sanitize);
+}
 else if (opt.content) body.appendChild(opt.content);
 
 d.appendChild(head);
@@ -311,5 +339,5 @@ if (opt.onClose) opt.onClose();
 return { el: d, close: close };
 }
 
-global.Drawer = { open: open };
+global.Drawer = { open: open, setSanitizer: setSanitizer };
 })(typeof window !== 'undefined' ? window : globalThis);