base-paint 0.3.13 → 0.3.15

package/dist/controls.js

@@ -1,1419 +1,8 @@
-/** base-paint/controls：#76 控件层运行时（契约 §3.3／§6.3）。
+/** **薄转出**（目录化批次⑤之后本件不再住实现）。
  *
- * 实施冻结面 44 条里 #76 的 13 条 `pending`（10 个运行时出口 ＋ 3 个类型出口）：
- * `copyText`／`createCopyRuntime`／`bindCopyAction`／`buildSharedHelpersJs`／
- * `renderToast`／`createToastController`／`renderActionBar`／`renderStatusBadge`／
- * `renderEmptyState`／`renderErrorReceipt`。签名逐字取 `src/spec/controls.ts`，本文件不改任何冻结值。
- *
- * 三条硬边界（逐条对齐 §3.3／§6.3，违反即红）：
- *  1. **无宿主 ≠ 无浏览器**（C-1）：本层不依赖 DSH 宿主注入（无宿主 DOM 容器、无宿主全局），
- *     浏览器能力一律经**显式端口**（`CopyPorts`／`ToastHostPort`／`CopyActionHostPort`）传入；
- *  2. **模块代码不得触碰 DOM**（C-8／AC-7）：本文件（编译进 `dist/controls.js`）的**代码**里不出现
- *     `document.`／`window.`／`navigator.`——DOM 只允许出现在 `buildSharedHelpersJs` **产出的 JS 文本**里
- *     （`SHARED_HELPERS_JS_RULE.domAllowed = true`），由 §6.3 追加验收的 dist 扫描断言钉死；
- *  3. **零内联脚本**（C-2）：渲染出的按钮只带 `ACTION_ID_ATTR` 与 `DEFAULT_DATA_ATTR`，
- *     激活一律走 `bindCopyAction`（事件委派），产出 JS 必须是**经典 script** 作用域可跑的 IIFE。
- *
- * 文档未规定处的取值（本文显式记账，不留暗猜；契约 §3.3「文档无规定」项）：
- *  - 各控件 HTML 结构／类名细节 → 只冻结「`ilife-` 前缀 ＋ `CONTROL_STYLE_SECTIONS` 命名空间」；
- *    逐区尺寸／色值 owner #75，本文件**不产**任何样式常量（数值一律读 `ACTION_BAR_DEFAULTS` 等冻结常量）；
- *  - `copyText` 非空串失败的 `reason` → 通道 2 返回假值 = `'fallback-failed'`／通道 2 **同步抛错** =
- *    `'fallback-threw'`（只冻结了空串短路的 `'empty'`；两通道皆失败一律**不抛错**，§3.3）；
- *  - `copyText` 的 toast 挂载与回调**先后** → 先挂反馈（失败徽章恒在，不被回调异常吞掉），再回调一次；
- *  - `copyText('', ports)` 的判定**次序** → 先校验 `ports`（非法即 `bad-input`）再判空串短路，即
- *    `copyText('', null)` 抛 `bad-input` 而非返回 `reason:'empty'`（次序文档无规定，本文定死）；
- *  - `renderToast` 的 `actions` 数量上限 → 不截断（旧层 `slice(0, 2)` 未进冻结面）；
- *  - `renderToast` 非法 `badge.type` → 回落 `'ok'`（旧层口径）；
- *  - `renderActionBar` 的 `CopyButtonInput.text` 缺席 → 仍渲染按钮、不写 `DEFAULT_DATA_ATTR`（binder 靠
- *    `readDataText → undefined` 跳过）；`text === ''` → 仍写 `data-t=""`（binder 送进空串短路，无反馈）；
- *    场景按钮 `kind` 取冻结 `ACTION_BAR_KINDS` **全量**（含 `ghost`），不以 §3.3 表格的「primary／red」为限；
- *    `format` 不参与渲染（序列化归 #77）；
- *  - `renderActionBar` 的 `CopyButtonInput.formats`（#247 三格式形态）→ 按钮只开合菜单、**不写** `data-t`，
- *    菜单三项各写自己的 `data-t`（键取 `COPY_FORMATS`，值＝该格式已序列化文本）；菜单项的
- *    `data-action-id` **留空**（三颗逐字不同的 id 与「同次渲染内唯一」口径不合，见
- *    `CopyButtonInput.formats` 注释）；`formats` 与 `text` 同给 → `bad-input`；
- *    `formats` 缺某个格式／非字符串 → `bad-input`；`hints` 非三个串 → `bad-input`；
- *    菜单的开合／点外收起／选中后按该项 `data-t` 复制并报所选格式 → 归 helpers 运行时的委派；
- *  - `renderStatusBadge` 的 `text === ''` → 视为缺省（旧层口径）；非法 `status` 降级 `'empty'`（冻结语义）；
- *  - `renderEmptyState` 的 `actionHtml` → **受信 HTML 透传**（契约同口径，调用方负责其内容安全），可含
- *    内联 `onclick`；「零注入面」只约束 base-paint **自产**标记，不约束调用方透传的受信片段；
- *  - helpers JS 的反馈栈容量 → 恒取冻结 `TOAST_DEFAULTS.maxStack`／`mobileMaxStack`（按视口），**不读**
- *    静态 `renderToast` 产出的 `data-max`（后者供页面自建 `createToastController` 读取，两栈互不相干）；
- *  - `renderErrorReceipt` 的 `retryPrompt` → 修正重试按钮的**文案**（缺省 `修正重试`）；该按钮**不带**
- *    `ACTION_ID_ATTR`——冻结输入面没有 retry actionId，不得自造 id（§6.3 红线 8），绑定归调用方；
- *  - `copyText` 判定通道 2 成功用**真值**（旧层 `_fbCopy(s) ? ok() : fail()` 同口径）；对布尔返回值
- *    与 `=== true` 等价，只影响调用方返回非布尔真值的情形；
- *  - **「≤820px 收窄为 3」是页面运行时行为，不是模块行为**（FX-76-2 总架构师裁定）：模块侧
- *    `createToastController` 保持**宿主无关**（AC-7 不变，不读任何浏览器全局）；收窄由**页面侧**
- *    `buildSharedHelpersJs` 的**产出文本**读 `matchMedia('(max-width: mobileMaxPx)')` 承担
- *    （`domAllowed`），或由调用方经 `ToastInput.maxStack` 显式施加。旧层 `window.matchMedia`
- *    （`base.js:96`）本就是页面侧代码。两侧分工见契约 §3.3「toast 移动端收窄的分工（FX-76-2）」。
+ *  为什么留着：`src/blocks.ts`／`src/docShell.ts`／`src/help.ts`／`src/contract.ts` 等
+ *  （其中两件在并行席位的在途写集里）按 `./controls.js` 取件，`dist/controls.js` 也是既有产物路径。
+ *  留一层转出＝它们零改动；出口名与改前逐名相同（13 个）。
+ *  实现住 `src/components/controls/**`；等引用迁走即可删本件。
  */
-import { STYLE_PREFIX } from './style.js';
-import { ACTION_BAR_DEFAULTS, ACTION_BAR_KINDS, ACTION_ID_ATTR, CONTROL_STYLE_SECTIONS, COPY_ACTION_IDS, COPY_FORMATS, COPY_TEXT_DEFAULTS, DEFAULT_DATA_ATTR, ESCAPE_HTML_CHARS, ESCAPE_HTML_ENTITIES, HELP_COPY_ACTIONS, HELP_SHELL_ID, STATUS_DEFAULT_TEXT, STATUS_KINDS, TOAST_DEFAULTS, } from './spec/index.js';
-/* ── 错误形态（§3.3：与既有 RenderError 并列、互不继承、一律抛出、不返空） ── */
-/** 控件层错误。**不**从 `src/index.ts` 导出：`SPEC_FROZEN_SURFACE` 44 条内无该运行时条目，
- *  调用方按 `name === 'ControlsError'` ＋ `code` 判定（与 `fillTemplate` 的 `TemplateError` 同口径）。 */
-export class ControlsError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.name = 'ControlsError';
-        this.code = code;
-    }
-}
-function badInput(message) {
-    throw new ControlsError('bad-input', message);
-}
-/* ── 转义（AC-14：唯一口径 = 冻结的 `ESCAPE_HTML_CHARS`／`ESCAPE_HTML_ENTITIES`） ── */
-const ESCAPE_RE = new RegExp('[' + ESCAPE_HTML_CHARS.join('') + ']', 'g');
-function esc(value) {
-    return value.replace(ESCAPE_RE, (ch) => ESCAPE_HTML_ENTITIES[ch] ?? ch);
-}
-/* ── 入参校验小件（失败行为恒为 `ControlsError` code `bad-input`） ── */
-function assertPlainObject(value, field) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value))
-        badInput(field + ' 必须是对象');
-}
-function assertActionId(value, field) {
-    if (typeof value !== 'string' || value === '')
-        badInput(field + ' 必须是非空字符串');
-    return value;
-}
-/** 零注入面：含内联事件处理器字段（`onclick`／`onClick`／任何 `on*`）的入参一律拒。 */
-function assertNoInlineHandler(value, field) {
-    for (const key of Object.keys(value)) {
-        if (/^on/i.test(key))
-            badInput(field + ' 不得含内联事件处理器字段：' + key);
-    }
-}
-function isStatusKind(value) {
-    return STATUS_KINDS.includes(value);
-}
-/* ── toast（`renderToast` ＋ `createToastController`） ─────────────────── */
-/** 图标字形：`TOAST_ICONS` 是**冻结的枚举名**（不是字形），字形属文档未规定项（旧层 `base.js:74` 同值）。
- *  **导出（#154）**：区块层 B-12 的「页内静态提示」形态要把同一个图标放进浅色块里，
- *  字形只此一份（`blocks.ts` 引用本表，不另抄）；本表**不进** `src/index.ts` 出口面。 */
-export const TOAST_ICON_GLYPHS = Object.freeze({
-    copy: '📋',
-    ok: '✅',
-    warn: '⚠️',
-    danger: '❌',
-    info: '💡',
-});
-/** 图标位的**文字标签**（#733 新增）：与 `TOAST_ICON_GLYPHS` 一一对应的中文词。
- *
- *  为什么要有它：`pageUi` ⑩ 那条为了治「emoji 在手机上小且糊」，把字形用 `font-size: 0` 收起、
- *  再用 `::after { content: "已完成" }` 把词**画**在屏幕上——词只活在 CSS 里。
- *  实测（32/32 页）：整份产物里「已完成」只出现 1 次，就是那行 `content:`；`<body>` 里一次都没有。
- *  后果＝屏幕上那个词**不可选中、不可搜索、不可复制、屏读器读不到、打印与 PDF 取不到字**。
- *  改法＝词进 DOM：图标位里同时放字形与这枚标签，谁显谁隐交 CSS（见 `blocks.ts` 的 note 区 CSS
- *  与 `pageUi` ⑩）。不启用 `pageUi` 的页仍只显字形，外观与改前逐值相同。 */
-export const TOAST_ICON_LABELS = Object.freeze({
-    copy: '已复制',
-    ok: '已完成',
-    warn: '注意',
-    danger: '未通过',
-    info: '提示',
-});
-/** 徽章类型允许清单：取冻结类型 `ToastBadge['type']` 的成员（非法值回落 `'ok'`，旧层口径）。 */
-const TOAST_BADGE_TYPES = ['ok', 'warn', 'danger'];
-/** 关闭按钮文案（文档无规定；沿用旧基线 `✓ 知道了`）。 */
-const TOAST_CLOSE_LABEL = '✓ 知道了';
-/** 关闭按钮的命名空间类（helpers JS 按 `prefix` 派生同名选择器，见 `buildSharedHelpersJs`）。 */
-const TOAST_CLOSE_CLASS = 'toast-close';
-/** toast 结构类名（**静态产出器与 helpers 运行时共用同一份**，故提为常量）：
- *  `body` 包裹 `title-row`（＋ 可选 detail），close 在 body 之外 —— 与旧层
- *  `.hm-toast-icon + .hm-toast-body(> .hm-toast-title-row + .hm-toast-detail) + .hm-toast-close`
- *  **同构**（旧层取证 `.scratch/t76/old-controls.md` §1.1；返修 W1 根因修）。
- *  运行时详情类名沿用 `toast-title-detail`（既有 helpers 产出，不新增类名）。 */
-const TOAST_BODY_CLASS = 'toast-body';
-const TOAST_TITLE_ROW_CLASS = 'toast-title-row';
-const TOAST_DETAIL_CLASS = 'toast-title-detail';
-function positiveInt(value, fallback) {
-    return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : fallback;
-}
-/** 冻结签名：`renderToast(input: ToastInput): string`（`input.msg` 非字符串 → `bad-input`）。 */
-export const renderToast = (input) => {
-    assertPlainObject(input, 'renderToast: input');
-    const msg = input.msg;
-    if (typeof msg !== 'string')
-        badInput('renderToast: input.msg 必须是字符串');
-    const toast = input;
-    const icon = typeof toast.icon === 'string' && toast.icon in TOAST_ICON_GLYPHS ? toast.icon : TOAST_DEFAULTS.defaultIcon;
-    const maxStack = positiveInt(toast.maxStack, TOAST_DEFAULTS.maxStack);
-    const head = ['<span class="' + STYLE_PREFIX + 'toast-icon" aria-hidden="true">' + TOAST_ICON_GLYPHS[icon] + '</span>'];
-    const titleRow = ['<span class="' + STYLE_PREFIX + 'toast-title">' + esc(msg) + '</span>'];
-    const badge = toast.badge;
-    if (badge !== undefined && badge !== null) {
-        assertPlainObject(badge, 'renderToast: input.badge');
-        if (typeof badge.text !== 'string')
-            badInput('renderToast: input.badge.text 必须是字符串');
-        const badgeType = TOAST_BADGE_TYPES.includes(badge.type) ? badge.type : 'ok';
-        titleRow.push('<span class="' + STYLE_PREFIX + 'toast-chip ' + STYLE_PREFIX + 'toast-chip-' + badgeType + '">' + esc(badge.text) + '</span>');
-    }
-    if (typeof toast.count === 'string' && toast.count !== '') {
-        titleRow.push('<span class="' + STYLE_PREFIX + 'toast-count">' + esc(toast.count) + '</span>');
-    }
-    const actions = toast.actions;
-    if (actions !== undefined && actions !== null) {
-        if (!Array.isArray(actions))
-            badInput('renderToast: input.actions 必须是数组');
-        actions.forEach((action, i) => {
-            const field = 'renderToast: input.actions[' + i + ']';
-            assertPlainObject(action, field);
-            assertNoInlineHandler(action, field);
-            const actionId = assertActionId(action.actionId, field + '.actionId');
-            if (typeof action.label !== 'string')
-                badInput(field + '.label 必须是字符串');
-            titleRow.push('<button type="button" class="' + STYLE_PREFIX + 'toast-act" ' + ACTION_ID_ATTR + '="' + esc(actionId) + '">' + esc(action.label) + '</button>');
-        });
-    }
-    const body = ['<div class="' + STYLE_PREFIX + TOAST_TITLE_ROW_CLASS + '">' + titleRow.join('') + '</div>'];
-    if (typeof toast.detail === 'string' && toast.detail !== '') {
-        body.push('<div class="' + STYLE_PREFIX + 'toast-detail">' + esc(toast.detail) + '</div>');
-    }
-    if (Array.isArray(toast.lines) && toast.lines.length > 0) {
-        body.push('<div class="' + STYLE_PREFIX + 'toast-lines">' + toast.lines.map((line) => esc(String(line))).join('<br>') + '</div>');
-    }
-    if (typeof toast.code === 'string' && toast.code !== '') {
-        body.push('<pre class="' + STYLE_PREFIX + 'toast-code">' + esc(toast.code) + '</pre>');
-    }
-    return ('<div class="' + STYLE_PREFIX + 'toast" role="' + TOAST_DEFAULTS.role + '" aria-live="' + TOAST_DEFAULTS.ariaLive + '" data-max="' + maxStack + '">'
-        + head.join('')
-        + '<div class="' + STYLE_PREFIX + TOAST_BODY_CLASS + '">' + body.join('') + '</div>'
-        + '<button type="button" class="' + STYLE_PREFIX + TOAST_CLOSE_CLASS + '">' + TOAST_CLOSE_LABEL + '</button>'
-        + '</div>');
-};
-/** 冻结签名：`createToastController(port: ToastHostPort): ToastController`。
- *
- *  堆叠口径（旧层 `stackCap()` 同语义）：容量 = 栈内各条 `maxStack` 的**最大值**，空栈回落
- *  `TOAST_DEFAULTS.maxStack`；超容量 FIFO 挤出最旧；单条独立计时（`timeoutMs` 缺省 4500）。
- *  `flush()` 清栈；`dispose()` = `flush()` ＋ 之后 `show()` 变 no-op（幂等）。 */
-export const createToastController = (port) => {
-    assertPlainObject(port, 'createToastController: port');
-    if (typeof port.mount !== 'function')
-        badInput('createToastController: port.mount 必须是函数');
-    const entries = [];
-    let disposed = false;
-    const drop = (entry) => {
-        if (entry.timer !== null) {
-            clearTimeout(entry.timer);
-            entry.timer = null;
-        }
-        const index = entries.indexOf(entry);
-        if (index >= 0)
-            entries.splice(index, 1);
-        entry.handle.remove();
-    };
-    const capacity = () => {
-        let cap = 0;
-        for (const entry of entries)
-            if (entry.cap > cap)
-                cap = entry.cap;
-        return cap > 0 ? cap : TOAST_DEFAULTS.maxStack;
-    };
-    return {
-        show(input) {
-            if (disposed)
-                return;
-            const html = renderToast(input);
-            const cap = positiveInt(input === null || input === undefined ? undefined : input.maxStack, TOAST_DEFAULTS.maxStack);
-            const timeoutMs = positiveInt(input === null || input === undefined ? undefined : input.timeoutMs, TOAST_DEFAULTS.timeoutMs);
-            const entry = { handle: port.mount(html), cap, timer: null };
-            entries.push(entry);
-            entry.timer = setTimeout(() => drop(entry), timeoutMs);
-            while (entries.length > capacity()) {
-                const oldest = entries[0];
-                if (oldest === undefined)
-                    break;
-                drop(oldest);
-            }
-        },
-        flush() {
-            for (const entry of [...entries])
-                drop(entry);
-        },
-        dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            for (const entry of [...entries])
-                drop(entry);
-        },
-    };
-};
-/* ── copyText 双通道（Q13／AC-16①） ──────────────────────────────────── */
-function assertCopyPorts(ports, field) {
-    if (ports === null || typeof ports !== 'object')
-        badInput(field + ': ports 必填');
-    if (typeof ports.fallback !== 'function')
-        badInput(field + ': ports.fallback 必须是函数');
-    const clipboard = ports.clipboard;
-    if (clipboard !== null && clipboard !== undefined && typeof clipboard.writeText !== 'function') {
-        badInput(field + ': ports.clipboard.writeText 必须是函数');
-    }
-}
-function pickCopyText(value, fallback) {
-    return typeof value === 'string' && value !== '' ? value : fallback;
-}
-/** 成功反馈：`opts.toast.ok` 逐字段覆盖（`silent` 只静默它，不静默失败徽章）。 */
-function okToastInput(opts) {
-    const override = opts.toast === undefined || opts.toast === null ? undefined : opts.toast.ok;
-    const input = {
-        msg: pickCopyText(override?.msg, COPY_TEXT_DEFAULTS.okMessage),
-        detail: typeof override?.detail === 'string' ? override.detail : COPY_TEXT_DEFAULTS.okDetail,
-    };
-    return typeof override?.icon === 'string' ? { ...input, icon: override.icon } : input;
-}
-/** 失败反馈：徽章恒在（`badge.type` 恒 `danger`，文案取冻结的 `STATUS_DEFAULT_TEXT.danger`）。 */
-function failToastInput(opts) {
-    const override = opts.toast === undefined || opts.toast === null ? undefined : opts.toast.fail;
-    return {
-        msg: pickCopyText(override?.msg, COPY_TEXT_DEFAULTS.failMessage),
-        detail: typeof override?.detail === 'string' ? override.detail : COPY_TEXT_DEFAULTS.failDetail,
-        icon: typeof override?.icon === 'string' ? override.icon : 'danger',
-        badge: { type: 'danger', text: STATUS_DEFAULT_TEXT.danger },
-    };
-}
-/** 冻结签名：`copyText(text: string, ports: CopyPorts, opts?: CopyTextOptions): Promise<CopyTextOutcome>`。 */
-export const copyText = async (text, ports, opts) => {
-    assertCopyPorts(ports, 'copyText');
-    if (typeof text !== 'string')
-        badInput('copyText: text 必须是字符串');
-    const options = opts === null || opts === undefined || typeof opts !== 'object' ? {} : opts;
-    if (COPY_TEXT_DEFAULTS.emptyTextShortCircuit && text === '') {
-        return { ok: false, channel: null, reason: 'empty' };
-    }
-    const mountFeedback = (input) => {
-        const host = ports.toast;
-        if (host === null || host === undefined)
-            return;
-        if (typeof host.mount !== 'function')
-            badInput('copyText: ports.toast.mount 必须是函数');
-        host.mount(renderToast(input));
-    };
-    const settle = (ok, channel, reason) => {
-        if (ok) {
-            if (options.silent !== true)
-                mountFeedback(okToastInput(options));
-            if (typeof options.onOk === 'function')
-                options.onOk(channel);
-            return { ok: true, channel };
-        }
-        if (COPY_TEXT_DEFAULTS.failBadgeAlwaysOn)
-            mountFeedback(failToastInput(options));
-        if (typeof options.onFail === 'function')
-            options.onFail(reason ?? 'unknown');
-        return { ok: false, channel: null, reason };
-    };
-    const clipboard = ports.clipboard ?? null;
-    if (clipboard !== null) {
-        try {
-            await clipboard.writeText(text);
-            return settle(true, 'clipboard');
-        }
-        catch {
-            // 通道 1 失败 → 通道 2（不得只留 execCommand 的单通道，§3.3）
-        }
-    }
-    // 通道 2：**同步抛错同样不得逃出**（§3.3「两通道皆失败 → `{ok:false,…}`（不抛错）」＋「失败徽章恒在」；
-    // 旧层 `_fbCopy` 整段 try/catch、失败返回 false 同口径）。只包住 `ports.fallback` 调用本身，
-    // 不包 `settle()`——否则反馈通道抛错会被误判成「通道 2 失败」而重复出徽章。
-    let fallbackOk = false;
-    try {
-        fallbackOk = Boolean(ports.fallback(text));
-    }
-    catch {
-        return settle(false, null, 'fallback-threw');
-    }
-    return fallbackOk ? settle(true, 'fallback') : settle(false, null, 'fallback-failed');
-};
-/** 冻结签名：`createCopyRuntime(ports: CopyPorts): CopyRuntime`。
- *
- *  除转发 `copyText` 外，本 runtime 记录自己挂载的反馈节点，`dispose()` 一并移除（幂等）。
- *  「dispose 后仍可复制」是文档未规定处的取值：`dispose` 只回收反馈节点，不改端口语义。 */
-export const createCopyRuntime = (ports) => {
-    assertCopyPorts(ports, 'createCopyRuntime');
-    const handles = new Set();
-    const host = ports.toast;
-    const wrapped = host === null || host === undefined
-        ? ports
-        : {
-            clipboard: ports.clipboard,
-            fallback: ports.fallback,
-            toast: {
-                mount: (html) => {
-                    const handle = host.mount(html);
-                    handles.add(handle);
-                    return {
-                        remove: () => {
-                            handles.delete(handle);
-                            handle.remove();
-                        },
-                    };
-                },
-            },
-        };
-    return {
-        copyText: (text, opts) => copyText(text, wrapped, opts),
-        dispose: () => {
-            for (const handle of [...handles])
-                handle.remove();
-            handles.clear();
-        },
-    };
-};
-/* ── 复制接线（FX-3③／FX-17；#90 仅凭契约即可接线） ──────────────────── */
-/** 冻结签名：`bindCopyAction(port, ports, opts?): { dispose(): void }`。
- *
- *  - id 来源**只有** `port.listActionIds()`：不猜 id、不通配前缀、不订阅未列出的 id；
- *  - 重复 id 由 binder 自行去重（同一 id 只订阅一次）；
- *  - 激活时读 `port.readDataText(actionId)`：非字符串（含 `undefined`）→ 跳过（不抛错、不产 toast），
- *    非复制按钮（场景按钮）即由此跳过，不另设允许清单；
- *  - 反馈一律走 `ports.toast`（`copyText` 内部），binder 不另出反馈；
- *  - **激活回调恒不产生未处理拒绝**（FX-76-6）：`copyText` 正常路径的失败已在内部 `settle()` 处理，
- *    这里只兜「逃出 `copyText` 的异常」（端口实现抛错／`ports.toast.mount` 抛错／回调抛错）——
- *    契约 §3.3 明写 binder 不另出反馈，故不产第二份 UI 反馈，也不重入 `opts.onFail`（防重复回调）；
- *  - `dispose()` 解绑全部已订阅 id 且幂等；解绑后激活不再触发复制。 */
-export const bindCopyAction = (port, ports, opts) => {
-    assertPlainObject(port, 'bindCopyAction: port');
-    if (typeof port.listActionIds !== 'function')
-        badInput('bindCopyAction: port.listActionIds 必须是函数');
-    if (typeof port.readDataText !== 'function')
-        badInput('bindCopyAction: port.readDataText 必须是函数');
-    if (typeof port.onActivate !== 'function')
-        badInput('bindCopyAction: port.onActivate 必须是函数');
-    assertCopyPorts(ports, 'bindCopyAction');
-    const unbinds = [];
-    const seen = new Set();
-    let disposed = false;
-    const list = port.listActionIds();
-    for (const actionId of Array.isArray(list) ? list : []) {
-        if (typeof actionId !== 'string' || actionId === '' || seen.has(actionId))
-            continue;
-        seen.add(actionId);
-        const off = port.onActivate(actionId, () => {
-            if (disposed)
-                return;
-            const text = port.readDataText(actionId);
-            if (typeof text !== 'string')
-                return;
-            // FX-76-6：`void` 丢弃结果，但**必须**接住 rejection（否则端口抛错 → unhandledRejection）。
-            // 反馈只经 `ports.toast`（§3.3），故此处不产反馈、不重入 `opts.onFail`。
-            void copyText(text, ports, opts).catch(() => { });
-        });
-        unbinds.push(typeof off === 'function' ? off : () => { });
-    }
-    return {
-        dispose: () => {
-            if (disposed)
-                return;
-            disposed = true;
-            for (const off of unbinds)
-                off();
-            unbinds.length = 0;
-        },
-    };
-};
-/* ── 共享 JS 文本的唯一产出者（FX-2③／FX-18；#74 只消费） ─────────────── */
-/** JS 字符串字面量（产出文本里嵌值唯一出口）。 */
-function jsStr(value) {
-    return JSON.stringify(value);
-}
-function helpersPrefix(input) {
-    const prefix = input === undefined || input === null ? undefined : input.prefix;
-    return typeof prefix === 'string' && prefix !== '' ? prefix : STYLE_PREFIX;
-}
-function helpersDataAttr(input) {
-    const attr = input === undefined || input === null ? undefined : input.dataAttr;
-    return typeof attr === 'string' && attr !== '' ? attr : DEFAULT_DATA_ATTR;
-}
-/* ── #88 S4：HELP 速查台运行时增强的类名来源（**不引 `src/help.ts`**） ────────────
- *  helpers 运行时注入的元素必须与 `src/help.ts` 的 `cls()` 同一命名空间，否则样式落空。
- *  这里**不** `import` help.ts：help.ts 已 `import { STYLE_PREFIX } from './style.js'`，
- *  controls.ts 再引 help.ts 会形成 `controls → help → template` 的潜在模块环；改为
- *  「`CONTROL_STYLE_SECTIONS` 闭集里 kebab 后与 `HELP_SHELL_ID` 同值者」这条**与 help.ts:87-93
- *  逐条同构**的派生式，闭集漂移即在此 fail-fast（不静默换命名空间）。两侧一致性由
- *  `test/help-center-js-88.test.mjs` 机读钉死（对照 `renderHelpShell` 的真实产出类名）。 */
-/** 样式区名 kebab（`helpShell` → `help-shell`）：与 `src/help.ts:81-83` 同一映射。 */
-function styleSectionSlug(section) {
-    return section.replace(/[A-Z]/g, (ch) => '-' + ch.toLowerCase());
-}
-/** HELP模板类名命名空间 kebab 后缀（`help-shell`；缺省前缀下根 = `ilife-help-shell`）。
- *  **延迟求值**（不在模块顶层）：`style.ts → charts.ts → controls.ts → style.ts` 存在模块环，
- *  顶层读 `STYLE_PREFIX` 会在 `style.js` 初始化完成前触发 TDZ（实测 `ReferenceError`），
- *  故派生式只在 `buildSharedHelpersJs()` **调用时**执行（此时全部模块已初始化）。 */
-function helpShellSlug() {
-    const section = CONTROL_STYLE_SECTIONS.find((name) => STYLE_PREFIX + styleSectionSlug(name) === HELP_SHELL_ID);
-    if (section === undefined) {
-        throw new Error('base-paint/controls：CONTROL_STYLE_SECTIONS 闭集缺与 HELP_SHELL_ID 同 kebab 的区名（'
-            + HELP_SHELL_ID + '）');
-    }
-    return styleSectionSlug(section);
-}
-/** 回到顶部按钮的 `id`（视觉尺 H-19 逐字点名 `#backTop`；`backTop` 是**冻结规格值**）。 */
-const HELP_BACKTOP_ID = 'backTop';
-/** H-19：`scrollY > 400` 才出现（阈值逐字取规格）。 */
-const HELP_BACKTOP_MIN_Y = 400;
-/** H-19：按钮字形 `↑`（18px／600 由 CSS 承担）。 */
-const HELP_BACKTOP_LABEL = '↑';
-/** 无障碍名（文档未规定 → 本票取值，与 `TOAST_CLOSE_LABEL` 同口径记账）。 */
-const HELP_BACKTOP_ARIA = '回到顶部';
-/** 搜索框占位文案（F3 `卡路里.html` 的 `#sB` 逐字：`搜索全部场景`）。 */
-const HELP_SEARCH_PLACEHOLDER = '搜索全部场景';
-/** 搜索框无障碍名（文档未规定 → 本票取值）。 */
-const HELP_SEARCH_ARIA = '搜索全部场景';
-/** 清空按钮字形（F3 `#sClear` 逐字：`✕`）与无障碍名。 */
-const HELP_CLEAR_LABEL = '✕';
-const HELP_CLEAR_ARIA = '清空搜索';
-/** H-16 双反馈的**按钮通道**类名（#121；规格逐字 `copied`，**非** `ilife-` 前缀 → 不占样式区命名空间）。
- *  CSS 侧两处已就位：`style.ts` 的 `copyButton` 区（`.ilife-copy-btn.copied`，#75）与本区追加的
- *  helpShell 复制按钮 `.copied`（#121）；本常量只供运行时**加类**，不产第二份样式真相。 */
-const HELP_COPY_COPIED_CLASS = 'copied';
-/** 复制成功态停留时长 = 弹簧动画时长 **450ms**（`docs/visual-spec-help.md:195,197`「按钮变绿进入
- *  `copied` 态并跑 450ms 弹簧动画」）。与 `style.ts` 的 `transition: transform .45s …` 同源数值，
- *  由 `test/copy-copied-121.test.mjs` 跨文件交叉钉死（改一侧不改另一侧即红）。 */
-const HELP_COPY_COPIED_MS = 450;
-/** 命中计数文案（F3 `#hitC` 逐字：`匹配 N 个场景`）。 */
-const HELP_HIT_PREFIX = '匹配 ';
-const HELP_HIT_SUFFIX = ' 个场景';
-/** 零命中文案（F3 `#emptyC` 逐字）。 */
-const HELP_HIT_EMPTY = '没有找到相关场景,换个词试试～';
-/** 冻结签名：`buildSharedHelpersJs(input?: SharedHelpersInput): string`。
- *
- *  产出恒为**非空**、**经典 script** 作用域可跑的 IIFE（无 `import`／`export`／顶层 `await`），
- *  逐项满足 `SHARED_HELPERS_JS_RULE`：自包含（不依赖其它脚本或既有全局）／幂等（判据**只落 DOM**：
- *  标记属性 ＋ `querySelector` 早退，**不**用全局哨兵）／允许页面侧 DOM（`document.*` 读取与事件绑定）／
- *  不向 `window.<id>`／`globalThis.<id>` 赋值／不引 `node:`。
- *
- *  功能面（文档无规定，本文记账）：① 幂等挂载点标记；② 事件委派 `[ACTION_ID_ATTR]` 点击 →
- *  读 `dataAttr` 文本 → 复制（`navigator.clipboard` → `execCommand` 兜底）；③ 反馈块
- *  **与 `renderToast` 同构**（`.toast` > `.toast-icon` ＋ `.toast-body` > `.toast-title-row` ＋ 可选
- *  `.toast-title-detail`，`.toast-close` 在 body 之外；W1 根因修 ＋ F-c 图标），`prefix` 命名空间类，
- *  `maxStack`／`timeoutMs`／移动端收窄取冻结常量；④ 关闭按钮。
- *  产出文本里的文案／数值**全部**取自冻结常量（不产第二份真相）。
- *  注：`execCommand` 兜底用临时 textarea 的两个内联定位属性（`position`／`left`），属临时节点
- *  定位而非控件样式，不构成第二份样式常量。
- *
- *  **#88 S4 追加（HELP 速查台运行时增强；文档无规定 → 本文记账）**：全部挂进**既有 `boot()`**、
- *  共用**既有幂等 marker**（`MARKER_SEL` ＋ `querySelector` 早退），**不新增第二个标记**；每一项都
- *  先判 HELP模板是否在页面（helpers 被所有技能页面共享，非 HELP 页逐项早退、零副作用）：
- *  - **卡级复制按钮**（`card-copy`）：每张场景卡的**卡头**注入 1 个按钮，`actionId`／文案恒读
- *    `HELP_COPY_ACTIONS.prompt`，`dataAttr` 取同卡 `<pre class="prompt">` 的原文（＝该卡 prompt 逐字；
- *    #88 S5 起改以 `<pre>` 为**主源**，读不到才回落 Sheet 内 prompt 按钮的 data-t），
- *    复用上面的 `[ACTION_ID_ATTR]` 委派（零新增监听、零契约变更）；卡内已有该类即跳过（幂等）。
- *  - **搜索**（`tab-search` ＋ `tab-search-input` ＋ `tab-search-clear` ＋ `page-hitcount`）：跨分组过滤卡片、
- *    `<mark class="card-mark">` 高亮命中、自动展开命中卡片的 Sheet 与子功能组、命中计数、
- *    清空复原、`Enter` 在命中分组页间跳页（自动跳第一个命中页）。
- *  - **Sheet 参数实时预览**：`editable_fields` 的静态值换成输入框，输入即重组
- *    「prompt ＋ 空行 ＋ `label: value` 行」（F3 `buildPrompt` 语义），并同步 prompt／params 复制按钮的
- *    `dataAttr`（否则复制到的是编辑前的旧文本）。
- *  - **回到顶部**（`btn-backtop`，`id="backTop"`，H-19）：`scrollTop > 400` 加 `-show`，点击平滑回顶。
- *  纯度：只用 `document.*`（含只读 `document.scrollingElement`）＋ 既有只读 `window.matchMedia`；
- *  不向 `window.<id>`／`globalThis.<id>` 赋值、不引 `node:`、不用 `classList`（类名走 `className` 字符串
- *  增删，兼容 `style.test.mjs` T28 的「动效纯 CSS」断言）、不产内联 `on*`。
- *
- *  **#121 追加（H-16 双反馈的按钮通道；文档 `docs/visual-spec-help.md:195,197`）**：复制**成功**时给
- *  **被点击的那个按钮**加 `copied` 类（`HELP_COPY_COPIED_CLASS`，规格逐字、无 `ilife-` 前缀），
- *  `HELP_COPY_COPIED_MS`（450ms）后移除；失败路径**不**加类（不静默变绿）。落点仍在**既有
- *  `boot()`／既有委派**内：`onClick` 把命中的按钮一并传给 `copy()` → 两条成功通道
- *  （`navigator.clipboard`／`execCommand` 兜底）各自在成功分支调 `markCopied(btn)`，零新增监听、
- *  零新增 marker、零新签名；类名增删复用既有 `addClass`／`removeClass`（`className` 字符串口径）。 */
-export const buildSharedHelpersJs = (input) => {
-    const prefix = helpersPrefix(input);
-    const dataAttr = helpersDataAttr(input);
-    const markerAttr = 'data-' + prefix.replace(/-+$/, '') + '-helpers';
-    const markerSelector = '[' + markerAttr + '="1"]';
-    // #88 S4：HELP模板命名空间（缺省 `ilife-help-shell`；`prefix` 覆盖时随动，不残留缺省前缀）。
-    const shellClass = prefix + helpShellSlug();
-    const shellPart = (suffix) => shellClass + '-' + suffix;
-    const promptAttr = 'data-' + prefix.replace(/-+$/, '') + '-help-prompt';
-    const copyAction = HELP_COPY_ACTIONS.prompt;
-    const paramsAction = HELP_COPY_ACTIONS.params;
-    const lines = [
-        '(function () {',
-        "  'use strict';",
-        '  var MARKER_ATTR = ' + jsStr(markerAttr) + ';',
-        '  var MARKER_SEL = ' + jsStr(markerSelector) + ';',
-        '  var ACTION_ATTR = ' + jsStr(ACTION_ID_ATTR) + ';',
-        '  var TEXT_ATTR = ' + jsStr(dataAttr) + ';',
-        '  var STACK_CLASS = ' + jsStr(prefix + 'toast-stack') + ';',
-        '  var TOAST_CLASS = ' + jsStr(prefix + 'toast') + ';',
-        '  var ICON_CLASS = ' + jsStr(prefix + 'toast-icon') + ';',
-        '  var ICON_OK = ' + jsStr(TOAST_ICON_GLYPHS.copy) + ';',
-        '  var ICON_FAIL = ' + jsStr(TOAST_ICON_GLYPHS.danger) + ';',
-        '  var CHIP_CLASS = ' + jsStr(prefix + 'toast-chip') + ';',
-        '  var CHIP_DANGER_CLASS = ' + jsStr(prefix + 'toast-chip-danger') + ';',
-        '  var TITLE_CLASS = ' + jsStr(prefix + 'toast-title') + ';',
-        '  var BODY_CLASS = ' + jsStr(prefix + TOAST_BODY_CLASS) + ';',
-        '  var TITLE_ROW_CLASS = ' + jsStr(prefix + TOAST_TITLE_ROW_CLASS) + ';',
-        '  var DETAIL_CLASS = ' + jsStr(prefix + TOAST_DETAIL_CLASS) + ';',
-        '  var CLOSE_CLASS = ' + jsStr(prefix + TOAST_CLOSE_CLASS) + ';',
-        '  var OK_MSG = ' + jsStr(COPY_TEXT_DEFAULTS.okMessage) + ';',
-        '  var OK_DETAIL = ' + jsStr(COPY_TEXT_DEFAULTS.okDetail) + ';',
-        '  var FAIL_MSG = ' + jsStr(COPY_TEXT_DEFAULTS.failMessage) + ';',
-        '  var FAIL_DETAIL = ' + jsStr(COPY_TEXT_DEFAULTS.failDetail) + ';',
-        // 失败徽章文案取 `STATUS_DEFAULT_TEXT.danger`（与静态产出器 `copyText` 的失败徽章同一处常量，不产第二份真相）
-        '  var FAIL_BADGE = ' + jsStr(STATUS_DEFAULT_TEXT.danger) + ';',
-        '  var CLOSE_LABEL = ' + jsStr(TOAST_CLOSE_LABEL) + ';',
-        '  var TIMEOUT_MS = ' + TOAST_DEFAULTS.timeoutMs + ';',
-        '  var MAX_STACK = ' + TOAST_DEFAULTS.maxStack + ';',
-        '  var MOBILE_MAX_STACK = ' + TOAST_DEFAULTS.mobileMaxStack + ';',
-        '  var MOBILE_MAX_PX = ' + TOAST_DEFAULTS.mobileMaxPx + ';',
-        '  var LF = String.fromCharCode(10);',
-        '  var LF2 = LF + LF;',
-        // #247：复制数据的三格式形态（菜单开合器 ＋ 格式菜单项）。开合标记／格式键都是**属性**，
-        // 菜单容器、菜单项与按钮的共同父节点走类名——四者与渲染端（`copyMenuHtml`）逐字同值，
-        // 不产第二份真相。
-        '  var MENU_OPEN_SEL = ' + jsStr('[' + COPY_MENU_OPEN_ATTR + '="1"]') + ';',
-        '  var MENU_ITEM_SEL = ' + jsStr('[' + COPY_MENU_FMT_ATTR + ']') + ';',
-        '  var MENU_WRAP_CLASS = ' + jsStr(prefix + COPY_MENU_WRAP_CLASS) + ';',
-        '  var MENU_CLASS = ' + jsStr(prefix + COPY_MENU_CLASS) + ';',
-        '  var MENU_LABEL_CLASS = ' + jsStr(prefix + COPY_MENU_LABEL_CLASS) + ';',
-        '  var MENU_OPEN_CLASS = ' + jsStr(COPY_MENU_OPEN_CLASS) + ';',
-        '  var FORMAT_OK_MSG = ' + jsStr(COPY_FORMAT_OK_MSG) + ';',
-        // #88 S4：HELP 速查台类名／选择器（同一命名空间，逐条由 `shellClass` 派生）
-        '  var SHELL_SEL = ' + jsStr('.' + shellClass) + ';',
-        '  var CARD_CLASS = ' + jsStr(shellPart('card')) + ';',
-        '  var CARD_TOP_CLASS = ' + jsStr(shellPart('card-top')) + ';',
-        '  var CARD_COPY_CLASS = ' + jsStr(shellPart('card-copy')) + ';',
-        '  var CARD_MARK_CLASS = ' + jsStr(shellPart('card-mark')) + ';',
-        '  var CARD_HIDDEN_CLASS = ' + jsStr(shellPart('card-hidden')) + ';',
-        '  var SHEET_CLASS = ' + jsStr(shellPart('sheet')) + ';',
-        '  var PROMPT_CLASS = ' + jsStr(shellPart('prompt')) + ';',
-        '  var PROMPT_ATTR = ' + jsStr(promptAttr) + ';',
-        '  var FIELD_CLASS = ' + jsStr(shellPart('field')) + ';',
-        '  var FIELD_LABEL_CLASS = ' + jsStr(shellPart('field-label')) + ';',
-        '  var FIELD_VALUE_CLASS = ' + jsStr(shellPart('field-value')) + ';',
-        '  var FIELD_HINT_CLASS = ' + jsStr(shellPart('field-hint')) + ';',
-        '  var FIELD_INPUT_CLASS = ' + jsStr(shellPart('field-input')) + ';',
-        '  var TAB_BAR_CLASS = ' + jsStr(shellPart('tab-bar')) + ';',
-        '  var TAB_INPUT_CLASS = ' + jsStr(shellPart('tab-input')) + ';',
-        '  var SEARCH_BOX_CLASS = ' + jsStr(shellPart('tab-search')) + ';',
-        '  var SEARCH_INPUT_CLASS = ' + jsStr(shellPart('tab-search-input')) + ';',
-        '  var SEARCH_CLEAR_CLASS = ' + jsStr(shellPart('tab-search-clear')) + ';',
-        '  var HITCOUNT_CLASS = ' + jsStr(shellPart('page-hitcount')) + ';',
-        '  var PAGE_CLASS = ' + jsStr(shellPart('page')) + ';',
-        '  var SUBGROUP_CLASS = ' + jsStr(shellPart('subgroup')) + ';',
-        '  var SUBGROUP_HIDDEN_CLASS = ' + jsStr(shellPart('subgroup-hidden')) + ';',
-        '  var CLI_CLASS = ' + jsStr(shellPart('cli')) + ';',
-        '  var BACKTOP_CLASS = ' + jsStr(shellPart('btn-backtop')) + ';',
-        '  var BACKTOP_SHOW_CLASS = ' + jsStr(shellPart('btn-backtop-show')) + ';',
-        '  var BACKTOP_ID = ' + jsStr(HELP_BACKTOP_ID) + ';',
-        '  var BACKTOP_MIN_Y = ' + HELP_BACKTOP_MIN_Y + ';',
-        '  var BACKTOP_LABEL = ' + jsStr(HELP_BACKTOP_LABEL) + ';',
-        '  var BACKTOP_ARIA = ' + jsStr(HELP_BACKTOP_ARIA) + ';',
-        '  var SEARCH_PLACEHOLDER = ' + jsStr(HELP_SEARCH_PLACEHOLDER) + ';',
-        '  var SEARCH_ARIA = ' + jsStr(HELP_SEARCH_ARIA) + ';',
-        '  var CLEAR_LABEL = ' + jsStr(HELP_CLEAR_LABEL) + ';',
-        '  var CLEAR_ARIA = ' + jsStr(HELP_CLEAR_ARIA) + ';',
-        '  var HIT_PREFIX = ' + jsStr(HELP_HIT_PREFIX) + ';',
-        '  var HIT_SUFFIX = ' + jsStr(HELP_HIT_SUFFIX) + ';',
-        '  var HIT_EMPTY = ' + jsStr(HELP_HIT_EMPTY) + ';',
-        '  var COPY_ACTION = ' + jsStr(copyAction.actionId) + ';',
-        '  var COPY_LABEL = ' + jsStr(copyAction.label) + ';',
-        '  var COPIED_CLASS = ' + jsStr(HELP_COPY_COPIED_CLASS) + ';',
-        '  var COPIED_MS = ' + HELP_COPY_COPIED_MS + ';',
-        '  var PARAMS_ACTION = ' + jsStr(paramsAction.actionId) + ';',
-        '  var searchTerm = "";',
-        '  var clickBound = false;',
-        // #88 S5（B 段红队 S3-a）：委派去重的**跨实例**判据——同一页面里 helpers 被多次注入时，
-        // 每个实例各有自己的闭包（`clickBound` 管不住别人），故在**事件对象**上打一次性标记：
-        // 同一事件只会被第一个处理器消费，一次点击恒只复制 1 次／出 1 个 toast。
-        '  var HANDLED_PROP = ' + jsStr(prefix + 'help-click-handled') + ';',
-        '',
-        '  function boot() {',
-        '    if (!document.body) return;',
-        '    if (document.querySelector(MARKER_SEL)) return;',
-        '    var marker = document.createElement("span");',
-        '    marker.setAttribute(MARKER_ATTR, "1");',
-        '    marker.hidden = true;',
-        '    document.body.appendChild(marker);',
-        // #88 S5（B 段红队 S3-a）：委派**只挂一次**——marker 被删后重入 boot() 不得重复 addEventListener，
-        // 否则一次点击触发 N 次复制／N 个 toast。按钮／搜索框／#backTop 各自的幂等由自身早退保证。
-        '    if (!clickBound) { clickBound = true; document.addEventListener("click", onClick); }',
-        '    initHelpShell();',
-        '  }',
-        '',
-        '  function onClick(ev) {',
-        '    if (ev[HANDLED_PROP]) return;',
-        '    ev[HANDLED_PROP] = 1;',
-        '    var node = ev.target;',
-        '    if (!node || typeof node.closest !== "function") return;',
-        '    var close = node.closest("." + CLOSE_CLASS);',
-        '    if (close) {',
-        '      var box = close.parentNode;',
-        '      if (box && box.parentNode) box.parentNode.removeChild(box);',
-        '      return;',
-        '    }',
-        '    if (onMenuClick(node)) return;',
-        '    var btn = node.closest("[" + ACTION_ATTR + "]");',
-        '    if (!btn) return;',
-        // 点同一行另一颗复制按钮（复制日志／复制指令）时顺手收起菜单：与「点别处收起」同效，
-        // 且不影响它自己的复制（菜单与按钮是两个互不干扰的路径）。
-        '    var menuOpen = document.querySelector("." + MENU_OPEN_CLASS);',
-        '    if (menuOpen) closeMenu(menuOpen.parentNode);',
-        '    var text = btn.getAttribute(TEXT_ATTR);',
-        '    if (text === null) return;',
-        '    copy(text, btn);',
-        '  }',
-        '',
-        '  /* #247：复制数据的三格式形态——按钮（`data-fmt-open`）只开合菜单，菜单项（`data-fmt`）各自带',
-        '     自己的 `data-t`。两条分支都排在复制委派**之前**：开合器**没有** `data-action-id`，故不会与',
-        '     复制委派抢同一次点击；菜单项走复制但**不用** id 反查（读被点击元素自己的属性，与 HELP 速查台',
-        '     逐行写同一冻结 id 的口径一致）。返回真＝本次点击已被菜单消费。 */',
-        '  function onMenuClick(node) {',
-        '    var opener = node.closest(MENU_OPEN_SEL);',
-        '    if (!opener) {',
-        '      /* 菜单项：处理完**直接返回**，不下落到复制委派——它没有 `data-action-id`，落下去只会空转。',
-        '         复制仍然走同一条 `copy()`（双通道 ＋ `copied` 态 ＋ 提示），只是多了「报所选格式」这一项。 */',
-        '      var item = node.closest(MENU_ITEM_SEL);',
-        '      if (item) {',
-        '        var itemText = item.getAttribute(TEXT_ATTR);',
-        '        var itemWrap = item.closest("." + MENU_WRAP_CLASS);',
-        '        if (itemWrap) closeMenu(itemWrap);',
-        '        var itemLabel = item.querySelector("." + MENU_LABEL_CLASS);',
-        '        copy(itemText, item, itemLabel ? itemLabel.textContent : "");',
-        '        return true;',
-        '      }',
-        '      /* 点别处收起（老仓 `document` 上那条「不在 .fmt-wrap 里就收起」的同效）：',
-        '         页面上最多只开一个菜单，故扫到开着的就收。 */',
-        '      var open = document.querySelector("." + MENU_OPEN_CLASS);',
-        '      if (open) closeMenu(open.parentNode);',
-        '      return false;',
-        '    }',
-        '    var wrap = opener.closest("." + MENU_WRAP_CLASS);',
-        '    if (!wrap) return true;',
-        '    var menu = wrap.querySelector("." + MENU_CLASS);',
-        '    if (menu) toggleMenu(opener, menu);',
-        '    return true;',
-        '  }',
-        '',
-        '  /* 开合只翻**可视态**（`copy-menu-open` 类 ＋ `aria-expanded`），**不动 DOM**（#249 返修）：',
-        '     菜单是浮层，层叠归 CSS（`position:absolute` ＋ `z-index:20`），不在常规流里；而 DOM 序＝内容序',
-        '     ——ghost 行是两列网格、按序铺格，开时搬一颗，两颗就换位，且收起时回不去。 */',
-        '  function toggleMenu(opener, menu) {',
-        '    var open = hasClass(menu, MENU_OPEN_CLASS);',
-        '    if (open) {',
-        '      removeClass(menu, MENU_OPEN_CLASS);',
-        '      opener.setAttribute("aria-expanded", "false");',
-        '      return;',
-        '    }',
-        '    addClass(menu, MENU_OPEN_CLASS);',
-        '    opener.setAttribute("aria-expanded", "true");',
-        '  }',
-        '',
-        '  function closeMenu(wrap) {',
-        '    if (!wrap) return;',
-        '    var opener = wrap.querySelector(MENU_OPEN_SEL);',
-        '    var menu = wrap.querySelector("." + MENU_CLASS);',
-        '    if (!menu || !hasClass(menu, MENU_OPEN_CLASS)) return;',
-        '    removeClass(menu, MENU_OPEN_CLASS);',
-        '    if (opener) opener.setAttribute("aria-expanded", "false");',
-        '  }',
-        '',
-        '  function copy(text, btn, fmt) {',
-        '    var clip = navigator.clipboard;',
-        '    if (clip && typeof clip.writeText === "function") {',
-        '      try {',
-        '        var done = clip.writeText(text);',
-        '        if (done && typeof done.then === "function") {',
-        '          done.then(function () { markCopied(btn); feedback(OK_MSG, false, fmt); }, function () { fallback(text, btn, fmt); });',
-        '          return;',
-        '        }',
-        '        markCopied(btn);',
-        '        feedback(OK_MSG, false, fmt);',
-        '        return;',
-        '      } catch (err) {',
-        '        fallback(text, btn, fmt);',
-        '        return;',
-        '      }',
-        '    }',
-        '    fallback(text, btn, fmt);',
-        '  }',
-        '',
-        '  function fallback(text, btn, fmt) {',
-        '    var sink = document.createElement("textarea");',
-        '    sink.value = text;',
-        '    sink.setAttribute("readonly", "readonly");',
-        '    sink.setAttribute("aria-hidden", "true");',
-        '    sink.style.position = "fixed";',
-        '    sink.style.left = "-9999px";',
-        '    document.body.appendChild(sink);',
-        '    sink.select();',
-        '    var done = false;',
-        '    try { done = document.execCommand("copy"); } catch (err) { done = false; }',
-        '    if (sink.parentNode) sink.parentNode.removeChild(sink);',
-        '    if (done) markCopied(btn);',
-        '    feedback(done ? OK_MSG : FAIL_MSG, !done, fmt);',
-        '  }',
-        '',
-        '  /* #121（H-16 双反馈的按钮通道）：成功态加 `copied` 类，450ms 后移除。',
-        '     只在**成功**分支调用 → 失败路径不静默变绿；类名走 className 字符串（addClass／removeClass），',
-        '     不用 DOM 的类名列表 API（纯度口径）；按钮缺失／已离页时 removeClass 仍安全（操作的是节点自身）。 */',
-        '  function markCopied(btn) {',
-        '    if (!btn) return;',
-        '    addClass(btn, COPIED_CLASS);',
-        '    setTimeout(function () { removeClass(btn, COPIED_CLASS); }, COPIED_MS);',
-        '  }',
-        '',
-        '  function feedback(msg, bad, fmt) {',
-        '    var cap = MAX_STACK;',
-        '    if (window.matchMedia && window.matchMedia("(max-width: " + MOBILE_MAX_PX + "px)").matches) cap = MOBILE_MAX_STACK;',
-        '    var host = document.querySelector("." + STACK_CLASS);',
-        '    if (!host) {',
-        '      host = document.createElement("div");',
-        '      host.className = STACK_CLASS;',
-        '      document.body.appendChild(host);',
-        '    }',
-        '    var box = document.createElement("div");',
-        '    box.className = bad ? TOAST_CLASS + " " + TOAST_CLASS + "-danger" : TOAST_CLASS;',
-        '    box.setAttribute("role", ' + jsStr(TOAST_DEFAULTS.role) + ');',
-        '    box.setAttribute("aria-live", ' + jsStr(TOAST_DEFAULTS.ariaLive) + ');',
-        // W1 根因修（结构对齐）＋ F-c 图标：运行时 DOM 与静态产出器／旧层同构——
-        //   box > .toast-icon ＋ .toast-body(> .toast-title-row(> .toast-title) ＋ 可选 .toast-title-detail) ＋ .toast-close
-        // 旧层为 `.hm-toast-icon + .hm-toast-body(> .hm-toast-title-row + .hm-toast-detail) + .hm-toast-close`
-        // （`.scratch/t76/old-controls.md` §1.1）。图标字形取 `TOAST_ICON_GLYPHS[TOAST_DEFAULTS.defaultIcon]`
-        // （📋，旧层 `base.js:74`／契约 `:141` 缺省；与静态产出器 `renderToast` 同源，不产第二份真相）。
-        // 缺 body 包裹时标题／详情／关闭被排进同一 flex 行，
-        // 靠 `flex-wrap` ＋ `flex:1 1 100%` 补丁才勉强分层，且把关闭按钮挤到第三行（R1 实测 113px 高）。
-        // F-c 自证：新增仅用 `document.createElement／className／setAttribute／textContent／appendChild`
-        // （`SHARED_HELPERS_JS_RULE.domAllowed=true` 允许 DOM 读取；未向 `window／globalThis` 赋值、
-        // 未引 `node:`、未用 `classList／show`），故不破坏 #76 冻结产出内容契约与 T28 纯 CSS 动效断言。
-        '    var icon = document.createElement("span");',
-        '    icon.className = ICON_CLASS;',
-        '    icon.setAttribute("aria-hidden", "true");',
-        '    icon.textContent = bad ? ICON_FAIL : ICON_OK;',
-        '    var body = document.createElement("div");',
-        '    body.className = BODY_CLASS;',
-        '    var titleRow = document.createElement("div");',
-        '    titleRow.className = TITLE_ROW_CLASS;',
-        '    var title = document.createElement("span");',
-        '    title.className = TITLE_CLASS;',
-        // #247：选了格式的那条**成功**提示报所选格式（「数据复制成功（纯文本／JSON／CSV）」）——格式名取
-        // 菜单项的标签文本（渲染期写死的那个键），不在运行时里另立一张中文表，选一个格式＝一个提示。
-        // **失败提示照旧**（`FAIL_MSG` ＋ ❌ ＋「失败」徽章）：失败与格式无关，别把它也套上格式名。
-        '    title.textContent = bad ? msg : (fmt ? FORMAT_OK_MSG + "（" + fmt + "）" : msg);',
-        '    titleRow.appendChild(title);',
-        // 5a（2026-09-12 用户裁定「UI 上要统一」）：失败态与静态产出器／老仓同形——红底「失败」徽章进标题行。
-        '    if (bad) {',
-        '      var chip = document.createElement("span");',
-        '      chip.className = CHIP_CLASS + " " + CHIP_DANGER_CLASS;',
-        '      chip.textContent = FAIL_BADGE;',
-        '      titleRow.appendChild(chip);',
-        '    }',
-        '    body.appendChild(titleRow);',
-        // 详情行两态都有：成功「粘贴给 AI」、失败「长按选择文本手动复制」（都取 `COPY_TEXT_DEFAULTS`，与老仓逐字同）。
-        '    var detail = document.createElement("div");',
-        '    detail.className = DETAIL_CLASS;',
-        '    detail.textContent = bad ? FAIL_DETAIL : OK_DETAIL;',
-        '    body.appendChild(detail);',
-        '    box.appendChild(icon);',
-        '    box.appendChild(body);',
-        '    var close = document.createElement("button");',
-        '    close.type = "button";',
-        '    close.className = CLOSE_CLASS;',
-        '    close.textContent = CLOSE_LABEL;',
-        '    box.appendChild(close);',
-        '    host.appendChild(box);',
-        '    while (host.children.length > cap) host.removeChild(host.children[0]);',
-        '    setTimeout(function () {',
-        '      if (box.parentNode) box.parentNode.removeChild(box);',
-        '    }, TIMEOUT_MS);',
-        '  }',
-        '',
-        // ── #88 S4：HELP 速查台运行时增强（见上方产出内容契约的记账；全部由既有 boot() 调用） ──
-        '  function initHelpShell() {',
-        '    var shell = document.querySelector(SHELL_SEL);',
-        '    if (!shell) return;',
-        '    var cards = allOf(shell, "." + CARD_CLASS);',
-        '    if (cards.length === 0) return;',
-        '    injectCardCopy(cards);',
-        '    initSheetPreview(cards);',
-        '    initSearch(shell, cards);',
-        '    initBackTop();',
-        '  }',
-        '',
-        '  function allOf(root, sel) {',
-        '    return Array.prototype.slice.call(root.querySelectorAll(sel));',
-        '  }',
-        '',
-        '  function attrSel(name, value) {',
-        '    return "[" + name + "=\\"" + value + "\\"]";',
-        '  }',
-        '',
-        '  function hasClass(el, name) {',
-        '    return (" " + el.className + " ").indexOf(" " + name + " ") > -1;',
-        '  }',
-        '',
-        '  function addClass(el, name) {',
-        '    if (hasClass(el, name)) return;',
-        '    el.className = el.className ? el.className + " " + name : name;',
-        '  }',
-        '',
-        '  function removeClass(el, name) {',
-        '    if (!el.className) return;',
-        '    var parts = el.className.split(" ");',
-        '    var kept = [];',
-        '    for (var i = 0; i < parts.length; i++) { if (parts[i] && parts[i] !== name) kept.push(parts[i]); }',
-        '    el.className = kept.join(" ");',
-        '  }',
-        '',
-        '  /* 卡级复制按钮（#88 R1-1）：卡头注入 1 个按钮——actionId／文案恒读冻结常量，',
-        '     文本取同卡 `<pre class="prompt">` 的**原文**（＝该卡 prompt 逐字，与 F3 卡面同源）；',
-        '     读不到 <pre> 才回落同卡 Sheet 内 prompt 按钮的 data-t，两者都无才跳过',
-        '     （#88 S5／B 段红队 S3-a：真实help模板恒有 <pre>，故 436/436 恒有按钮，不静默丢卡）→ 复用既有委派。 */',
-        '  function injectCardCopy(cards) {',
-        '    for (var i = 0; i < cards.length; i++) {',
-        '      var card = cards[i];',
-        '      if (card.querySelector("." + CARD_COPY_CLASS)) continue;',
-        '      var pre = card.querySelector("." + PROMPT_CLASS);',
-        '      var src = pre !== null ? pre : card.querySelector(attrSel(ACTION_ATTR, COPY_ACTION));',
-        '      if (src === null) continue;',
-        '      var text = pre !== null ? pre.textContent : src.getAttribute(TEXT_ATTR);',
-        '      if (text === null) continue;',
-        '      var btn = document.createElement("button");',
-        '      btn.type = "button";',
-        '      btn.className = CARD_COPY_CLASS;',
-        '      btn.textContent = COPY_LABEL;',
-        '      btn.setAttribute(ACTION_ATTR, COPY_ACTION);',
-        '      btn.setAttribute(TEXT_ATTR, text);',
-        '      var head = card.querySelector("." + CARD_TOP_CLASS);',
-        '      if (head) head.appendChild(btn); else card.insertBefore(btn, card.firstChild);',
-        '    }',
-        '  }',
-        '',
-        '  /* Sheet 参数实时预览：静态值换输入框，输入即重组「prompt ＋ 空行 ＋ label: value 行」。 */',
-        '  function initSheetPreview(cards) {',
-        '    for (var i = 0; i < cards.length; i++) {',
-        '      var card = cards[i];',
-        '      var pre = card.querySelector("." + PROMPT_CLASS);',
-        '      if (!pre) continue;',
-        '      if (pre.getAttribute(PROMPT_ATTR) === null) pre.setAttribute(PROMPT_ATTR, pre.textContent);',
-        '      var fields = allOf(card, "." + FIELD_CLASS);',
-        '      for (var j = 0; j < fields.length; j++) bindField(card, fields[j]);',
-        '    }',
-        '  }',
-        '',
-        '  function bindField(card, field) {',
-        '    if (field.querySelector("." + FIELD_INPUT_CLASS)) return;',
-        '    var value = field.querySelector("." + FIELD_VALUE_CLASS);',
-        '    var input = document.createElement("input");',
-        '    input.type = "text";',
-        '    input.className = FIELD_INPUT_CLASS;',
-        '    input.value = value ? value.textContent : "";',
-        '    input.setAttribute("value", input.value);',
-        '    var hint = field.querySelector("." + FIELD_HINT_CLASS);',
-        '    if (hint) input.setAttribute("placeholder", hint.textContent);',
-        '    input.addEventListener("input", function () { refreshPreview(card); });',
-        '    if (value && value.parentNode === field) field.replaceChild(input, value);',
-        '    else field.appendChild(input);',
-        '  }',
-        '',
-        '  function refreshPreview(card) {',
-        '    var pre = card.querySelector("." + PROMPT_CLASS);',
-        '    if (!pre) return;',
-        '    var base = pre.getAttribute(PROMPT_ATTR);',
-        '    if (base === null) return;',
-        '    var lines = fieldLines(card);',
-        '    var text = lines.length > 0 ? base + LF2 + lines.join(LF) : base;',
-        '    pre.textContent = text;',
-        '    syncCopyText(card, text, lines);',
-        '    if (searchTerm !== "") markCard(card, searchTerm);',
-        '  }',
-        '',
-        '  function fieldLines(card) {',
-        '    var fields = allOf(card, "." + FIELD_CLASS);',
-        '    var lines = [];',
-        '    for (var i = 0; i < fields.length; i++) {',
-        '      var input = fields[i].querySelector("." + FIELD_INPUT_CLASS);',
-        '      var labelEl = fields[i].querySelector("." + FIELD_LABEL_CLASS);',
-        '      var label = labelEl ? labelEl.textContent : "";',
-        '      var raw = input ? input.value : "";',
-        '      var val = raw.replace(/^\\s+|\\s+$/g, "");',
-        '      if (val !== "") lines.push(label + ": " + val);',
-        '    }',
-        '    return lines;',
-        '  }',
-        '',
-        '  /* 复制按钮文本同步：prompt 目标（卡头 ＋ Sheet 内）＝ 预览文本；params 目标＝label: value 行，',
-        '     无字段时回落该卡 CLI 文本（与冻结help模板 paramsText 同口径）。 */',
-        '  function syncCopyText(card, text, lines) {',
-        '    var buttons = allOf(card, "[" + ACTION_ATTR + "]");',
-        '    for (var i = 0; i < buttons.length; i++) {',
-        '      var id = buttons[i].getAttribute(ACTION_ATTR);',
-        '      if (id === COPY_ACTION) buttons[i].setAttribute(TEXT_ATTR, text);',
-        '      else if (id === PARAMS_ACTION) buttons[i].setAttribute(TEXT_ATTR, lines.length > 0 ? lines.join(LF) : cliTextOf(card));',
-        '    }',
-        '  }',
-        '',
-        '  function cliTextOf(card) {',
-        '    var cli = card.querySelector("." + CLI_CLASS);',
-        '    return cli ? cli.textContent : "";',
-        '  }',
-        '',
-        '  /* 搜索：过滤 ＋ mark 标签高亮 ＋ 自动展开 ＋ 命中计数 ＋ 清空 ＋ 跳页。 */',
-        '  function initSearch(shell, cards) {',
-        '    var tabBar = shell.querySelector("." + TAB_BAR_CLASS);',
-        '    if (!tabBar || !tabBar.parentNode) return;',
-        '    if (shell.querySelector("." + SEARCH_BOX_CLASS)) return;',
-        '    var box = document.createElement("div");',
-        '    box.className = SEARCH_BOX_CLASS;',
-        '    var input = document.createElement("input");',
-        '    input.type = "search";',
-        '    input.className = SEARCH_INPUT_CLASS;',
-        '    input.setAttribute("placeholder", SEARCH_PLACEHOLDER);',
-        '    input.setAttribute("aria-label", SEARCH_ARIA);',
-        '    input.setAttribute("autocomplete", "off");',
-        '    var clear = document.createElement("button");',
-        '    clear.type = "button";',
-        '    clear.className = SEARCH_CLEAR_CLASS;',
-        '    clear.textContent = CLEAR_LABEL;',
-        '    clear.setAttribute("aria-label", CLEAR_ARIA);',
-        '    var count = document.createElement("span");',
-        '    count.className = HITCOUNT_CLASS;',
-        '    count.setAttribute("role", "status");',
-        '    box.appendChild(input);',
-        '    box.appendChild(clear);',
-        '    box.appendChild(count);',
-        '    tabBar.parentNode.insertBefore(box, tabBar.nextSibling);',
-        '    var state = { sheets: [], subgroups: [], pages: [], index: 0 };',
-        '    input.addEventListener("input", function () { runSearch(shell, cards, input, count, state); });',
-        '    input.addEventListener("keydown", function (ev) {',
-        '      if (ev.key !== "Enter") return;',
-        '      ev.preventDefault();',
-        '      if (state.pages.length === 0) return;',
-        '      state.index = (state.index + 1) % state.pages.length;',
-        '      jumpTo(state.pages[state.index]);',
-        '    });',
-        '    clear.addEventListener("click", function () {',
-        '      input.value = "";',
-        '      runSearch(shell, cards, input, count, state);',
-        '      input.focus();',
-        '    });',
-        '  }',
-        '',
-        '  function runSearch(shell, cards, input, count, state) {',
-        '    var term = input.value.replace(/^\\s+|\\s+$/g, "").toLowerCase();',
-        '    resetSearch(shell, cards, state);',
-        '    searchTerm = term;',
-        '    if (term === "") { count.textContent = ""; state.pages = []; state.index = 0; return; }',
-        '    var hits = [];',
-        '    var i;',
-        '    for (i = 0; i < cards.length; i++) {',
-        '      var card = cards[i];',
-        '      if (card.textContent.toLowerCase().indexOf(term) < 0) { addClass(card, CARD_HIDDEN_CLASS); continue; }',
-        '      hits.push(card);',
-        '      markCard(card, term);',
-        '      var sheet = card.querySelector("." + SHEET_CLASS);',
-        '      if (sheet && !sheet.open) { sheet.open = true; state.sheets.push(sheet); }',
-        '    }',
-        '    var subgroups = allOf(shell, "." + SUBGROUP_CLASS);',
-        '    for (i = 0; i < subgroups.length; i++) {',
-        '      var inner = allOf(subgroups[i], "." + CARD_CLASS);',
-        '      var visible = false;',
-        '      for (var j = 0; j < inner.length; j++) { if (hits.indexOf(inner[j]) > -1) { visible = true; break; } }',
-        '      if (visible) { if (!subgroups[i].open) { subgroups[i].open = true; state.subgroups.push(subgroups[i]); } }',
-        '      else addClass(subgroups[i], SUBGROUP_HIDDEN_CLASS);',
-        '    }',
-        '    var pages = allOf(shell, "." + PAGE_CLASS);',
-        '    var hitPages = [];',
-        '    for (i = 0; i < pages.length; i++) {',
-        '      var pageCards = allOf(pages[i], "." + CARD_CLASS);',
-        '      for (var k = 0; k < pageCards.length; k++) { if (hits.indexOf(pageCards[k]) > -1) { hitPages.push(pages[i]); break; } }',
-        '    }',
-        '    state.pages = hitPages;',
-        '    state.index = 0;',
-        '    count.textContent = hits.length > 0 ? HIT_PREFIX + hits.length + HIT_SUFFIX : HIT_EMPTY;',
-        '    jumpTo(hitPages[0]);',
-        '  }',
-        '',
-        '  function resetSearch(shell, cards, state) {',
-        '    var i;',
-        '    for (i = 0; i < cards.length; i++) {',
-        '      removeClass(cards[i], CARD_HIDDEN_CLASS);',
-        '      unmarkCard(cards[i]);',
-        '    }',
-        '    for (i = 0; i < state.sheets.length; i++) state.sheets[i].open = false;',
-        '    state.sheets = [];',
-        '    for (i = 0; i < state.subgroups.length; i++) state.subgroups[i].open = false;',
-        '    state.subgroups = [];',
-        '    var subgroups = allOf(shell, "." + SUBGROUP_CLASS);',
-        '    for (i = 0; i < subgroups.length; i++) removeClass(subgroups[i], SUBGROUP_HIDDEN_CLASS);',
-        '  }',
-        '',
-        '  function jumpTo(page) {',
-        '    if (!page) return;',
-        '    var radio = page.querySelector("." + TAB_INPUT_CLASS);',
-        '    if (radio && radio.checked !== true) radio.checked = true;',
-        '  }',
-        '',
-        '  function markCard(card, term) {',
-        '    unmarkCard(card);',
-        '    var nodes = [];',
-        '    collectText(card, nodes);',
-        '    for (var i = 0; i < nodes.length; i++) wrapTerm(nodes[i], term);',
-        '  }',
-        '',
-        '  function unmarkCard(card) {',
-        '    var marks = allOf(card, "." + CARD_MARK_CLASS);',
-        '    for (var i = 0; i < marks.length; i++) {',
-        '      var parent = marks[i].parentNode;',
-        '      if (!parent) continue;',
-        '      parent.replaceChild(document.createTextNode(marks[i].textContent), marks[i]);',
-        '      if (typeof parent.normalize === "function") parent.normalize();',
-        '    }',
-        '  }',
-        '',
-        '  function collectText(root, out) {',
-        '    var kids = root.childNodes;',
-        '    for (var i = 0; i < kids.length; i++) {',
-        '      var node = kids[i];',
-        '      if (node.nodeType === 3) { if (node.nodeValue) out.push(node); continue; }',
-        '      if (node.nodeType !== 1) continue;',
-        '      if (hasClass(node, CARD_MARK_CLASS)) continue;',
-        '      var tag = node.tagName;',
-        '      if (tag === "SCRIPT" || tag === "STYLE" || tag === "TEXTAREA" || tag === "INPUT") continue;',
-        '      collectText(node, out);',
-        '    }',
-        '  }',
-        '',
-        '  function wrapTerm(node, term) {',
-        '    var rest = node.nodeValue;',
-        '    var at = rest.toLowerCase().indexOf(term);',
-        '    if (at < 0) return;',
-        '    var frag = document.createDocumentFragment();',
-        '    while (at > -1) {',
-        '      if (at > 0) frag.appendChild(document.createTextNode(rest.slice(0, at)));',
-        '      var mark = document.createElement("mark");',
-        '      mark.className = CARD_MARK_CLASS;',
-        '      mark.textContent = rest.slice(at, at + term.length);',
-        '      frag.appendChild(mark);',
-        '      rest = rest.slice(at + term.length);',
-        '      at = rest.toLowerCase().indexOf(term);',
-        '    }',
-        '    if (rest !== "") frag.appendChild(document.createTextNode(rest));',
-        '    if (node.parentNode) node.parentNode.replaceChild(frag, node);',
-        '  }',
-        '',
-        '  /* 回到顶部（H-19）：scrollTop > BACKTOP_MIN_Y 才加 -show；点击平滑回顶。 */',
-        '  function initBackTop() {',
-        '    if (document.querySelector("." + BACKTOP_CLASS)) return;',
-        '    var btn = document.createElement("button");',
-        '    btn.type = "button";',
-        '    btn.id = BACKTOP_ID;',
-        '    btn.className = BACKTOP_CLASS;',
-        '    btn.textContent = BACKTOP_LABEL;',
-        '    btn.setAttribute("aria-label", BACKTOP_ARIA);',
-        '    btn.setAttribute("title", BACKTOP_ARIA);',
-        '    btn.addEventListener("click", function () {',
-        '      var root = scrollRoot();',
-        '      if (!root) return;',
-        '      if (typeof root.scrollTo === "function") {',
-        '        try { root.scrollTo({ top: 0, behavior: "smooth" }); return; } catch (err) { root.scrollTop = 0; return; }',
-        '      }',
-        '      root.scrollTop = 0;',
-        '    });',
-        '    document.body.appendChild(btn);',
-        '    document.addEventListener("scroll", syncBackTop, true);',
-        '    syncBackTop();',
-        '  }',
-        '',
-        '  function scrollRoot() {',
-        '    return document.scrollingElement || document.documentElement || document.body;',
-        '  }',
-        '',
-        '  function syncBackTop() {',
-        '    var btn = document.querySelector("." + BACKTOP_CLASS);',
-        '    if (!btn) return;',
-        '    var root = scrollRoot();',
-        '    var y = root ? root.scrollTop : 0;',
-        '    if (y > BACKTOP_MIN_Y) addClass(btn, BACKTOP_SHOW_CLASS); else removeClass(btn, BACKTOP_SHOW_CLASS);',
-        '  }',
-        '',
-        '  if (document.body) boot();',
-        '  else document.addEventListener("DOMContentLoaded", boot);',
-        '}());',
-    ];
-    return lines.join(String.fromCharCode(10));
-};
-function normalizeButtons(buttons) {
-    if (buttons === undefined || buttons === null)
-        return [];
-    if (!Array.isArray(buttons))
-        badInput('renderActionBar: input.buttons 必须是数组');
-    return buttons.map((button, i) => {
-        const field = 'renderActionBar: input.buttons[' + i + ']';
-        assertPlainObject(button, field);
-        assertNoInlineHandler(button, field);
-        if (typeof button.label !== 'string' || button.label === '')
-            badInput(field + '.label 必须是非空字符串');
-        if (!ACTION_BAR_KINDS.includes(button.kind)) {
-            badInput(field + '.kind 必须是 ' + ACTION_BAR_KINDS.join('／'));
-        }
-        return {
-            label: button.label,
-            kind: button.kind,
-            actionId: assertActionId(button.actionId, field + '.actionId'),
-            // #733：只在**真给 true** 时带这一位；不给／给假 ⇒ 产物与改前逐字节相同（旧调用方零影响）。
-            ...(button.disabled === true ? { disabled: true } : {}),
-        };
-    });
-}
-/** 菜单形态的标记属性（#247；运行时委派据它分辨「开合菜单的按钮」与「直接复制的按钮」）。
- *  该按钮**不写** `data-action-id`：它不是复制目标、也不是复制动作——点击的效果是开合菜单。
- *  `CopyActionHostPort.listActionIds()` 与 `bindCopyAction` 因此天然不碰它（无需为此改冻结签名）。 */
-const COPY_MENU_OPEN_ATTR = 'data-fmt-open';
-/** 菜单项的**格式键**承载属性（三格式形态里唯一分辨三项的东西——值取 `COPY_FORMATS`）。
- *  与老仓逐字同名：老仓 `.fmt-item` 就是靠 `data-fmt` 分辨纯文本／JSON／CSV。 */
-const COPY_MENU_FMT_ATTR = 'data-fmt';
-/** 格式菜单容器与按钮的共同父节点类名（运行时据**最近的这个父节点**开合／收起菜单）。 */
-const COPY_MENU_WRAP_CLASS = 'copy-menu-wrap';
-/** 菜单容器自身的类名（浮动那一层）。 */
-const COPY_MENU_CLASS = 'copy-menu';
-/** 菜单项的类名。 */
-const COPY_MENU_ITEM_CLASS = 'copy-menu-item';
-/** 菜单项**标签**文本的类名（`data-fmt` 只放格式键；标签是给人看的中文名，见 `COPY_FORMAT_LABELS`）。 */
-const COPY_MENU_LABEL_CLASS = 'copy-menu-label';
-/** 菜单项**可见标签**：格式键 → 中文名（#496）。
- *
- *  `data-fmt` 是机器面（键值恒为 `COPY_FORMATS` 成员，运行时与测试都按它分辨三项），
- *  **上屏的是这张表的中文名**——原先是把格式键直接印给用户看，菜单点开是 `text` / `json` / `csv`
- *  三个小写英文词，读不懂（`.scratch/t155o/text-review-P0.md` 第 20／44 条，卡路里 81 页 ＋
- *  饼干记账的复制区页同形）。`JSON` 与 `CSV` 是这个仓既有写法里的通用缩写，保留原样。
- *  运行时「数据复制成功（〈标签〉）」那条提示读回的就是这里的值，故它跟着一起变中文。 */
-const COPY_FORMAT_LABELS = { text: '纯文本', json: 'JSON', csv: 'CSV' };
-/** 菜单项**用途提示**（老仓原样：`粘贴给 AI / 自己看`／`结构化存档`／`表格导入`）的类名。
- *  老仓靠 `.fmt-item span`（后代选择器）收这行灰小字；本仓**显式给类名**——一是不用后代选择器
- *  把标签也一并染成 11px 灰（`.copy-menu-item span` 会连窗口里两个 span 一起命中），
- *  二是 CSS 里每个类名都要指得出产出者（`style.test.mjs` T10）。 */
-const COPY_MENU_HINT_CLASS = 'copy-menu-hint';
-/** 菜单**开着**时加在容器上的类（`opacity` / `visibility` 的开合开关；`aria-expanded` 同步）。 */
-const COPY_MENU_OPEN_CLASS = 'copy-menu-open';
-/** 开合器 `aria-label` 的后半句（**#525 第二轮**：可见文字里的 `▾` 已删，那句「可以选格式」改住这里）。
- *
- *  为什么删那个字符：用户裁定第 5 条逐字「该问题是用这些符号简化了 UI 展示的设计」——
- *  `复制数据 ▾` 里的三角是「这里能展开」的纯装饰，用一个字形顶替了一次设计。现在三角由
- *  `style.ts` copyButton 区的 `::after` 用 `border` ＋ `rotate` 画出来（零字符），
- *  而**语义不留白**：这句写进 `aria-label`，读屏与抓取器仍读得出「这颗按钮要选格式」。 */
-const COPY_MENU_OPENER_ARIA = '（点开选格式）';
-/** 选中某个格式后的成功提示词干（老仓 `.fmt-menu` 那张菜单当年报的是「…数据复制成功(格式)」；
- *  本仓句头沿用既有「已复制」以外的**独立**一句，避免与单格式提示混同）。格式名由运行时从菜单项
- *  标签读回（即 `COPY_FORMAT_LABELS` 的中文名），不在运行时另立第二张表。 */
-const COPY_FORMAT_OK_MSG = '数据复制成功';
-/** 三格式形态的校验 ＋ 归一（#247）：与 `text` 互斥；三格式恒齐、值恒为串；`hints` 恒三串。 */
-function normalizeFormats(formats, field, hasText) {
-    if (formats === undefined || formats === null)
-        return undefined;
-    assertPlainObject(formats, 'renderActionBar: input.' + field + '.formats');
-    if (hasText)
-        badInput('renderActionBar: input.' + field + '.formats 与 .text 只能给一个');
-    const texts = [];
-    for (const key of COPY_FORMATS) {
-        const value = formats[key];
-        if (typeof value !== 'string')
-            badInput('renderActionBar: input.' + field + '.formats.' + key + ' 必须是字符串');
-        texts.push(value);
-    }
-    const rawHints = formats.hints;
-    if (rawHints === undefined || rawHints === null)
-        return { texts, hints: [] };
-    if (!Array.isArray(rawHints) || rawHints.length !== COPY_FORMATS.length) {
-        badInput('renderActionBar: input.' + field + '.formats.hints 必须是 ' + COPY_FORMATS.length + ' 个字符串');
-    }
-    const hints = [];
-    for (const hint of rawHints) {
-        if (typeof hint !== 'string')
-            badInput('renderActionBar: input.' + field + '.formats.hints 必须是字符串');
-        hints.push(hint);
-    }
-    return { texts, hints };
-}
-function normalizeCopyButton(input, fallbackLabel, field) {
-    if (input === undefined || input === null)
-        return null;
-    assertPlainObject(input, 'renderActionBar: input.' + field);
-    assertNoInlineHandler(input, 'renderActionBar: input.' + field);
-    const button = input;
-    const formats = normalizeFormats(button.formats, field, typeof button.text === 'string');
-    return {
-        label: typeof button.label === 'string' && button.label !== '' ? button.label : fallbackLabel,
-        actionId: assertActionId(button.actionId, 'renderActionBar: input.' + field + '.actionId'),
-        text: typeof button.text === 'string' ? button.text : undefined,
-        // 三格式形态的按钮是**菜单开合器**，不是复制目标：`data-t` 恒缺（点了不直接复制）。
-        ...(formats === undefined ? {} : { formats }),
-    };
-}
-function sceneButtonHtml(button) {
-    // #733：`disabled: true` ⇒ 落 `disabled` ＋ `aria-disabled`（「标记」而非「可点控件」）。
-    //   动作条按钮没有 `data-t` 载荷位 ⇒ 凡是「该由宿主来做、这一页做不到」的动作，
-    //   不给这一位就会渲染成「看着能点、点了没反应」（记账写入域实测两颗）。
-    const disabledAttr = button.disabled === true ? ' disabled aria-disabled="true"' : '';
-    return '<button type="button" class="' + STYLE_PREFIX + 'action-btn ' + STYLE_PREFIX + 'action-btn-' + button.kind + '"'
-        + disabledAttr + ' ' + ACTION_ID_ATTR + '="' + esc(button.actionId) + '">' + esc(button.label) + '</button>';
-}
-function copyButtonHtml(button) {
-    const textAttr = button.text === undefined ? '' : ' ' + DEFAULT_DATA_ATTR + '="' + esc(button.text) + '"';
-    const disabledAttr = button.disabled === true ? ' disabled' : '';
-    return '<button type="button" class="' + STYLE_PREFIX + 'copy-btn ' + STYLE_PREFIX + 'copy-btn-ghost" '
-        + ACTION_ID_ATTR + '="' + esc(button.actionId) + '"' + textAttr + disabledAttr + '>' + esc(button.label) + '</button>';
-}
-/** 复制数据的**三格式形态**（#247）：`<div class="ilife-copy-menu-wrap">` 里一颗开合器 ＋ 一个菜单。
- *
- *  按钮：`data-fmt-open` 是**开合标记**（不是 `data-action-id`——见 `COPY_MENU_OPEN_ATTR` 注释），
- *  带 `aria-haspopup`／`aria-expanded`（`aria-expanded` 由运行时翻转）；
- *  菜单：三个格式项，每项 `data-fmt="键"`（键取 `COPY_FORMATS`）＋ 自己的 `data-t`（该格式文本），
- *  标签与用途提示取 `formats.hints`（对应位）。零内联脚本：开合与选中一律归 helpers 运行时的委派。
- *  菜单容器**不加 `hidden`**：它是浮层，用 CSS 的 `opacity` 开合（`hidden` 的 `display:none` 会让浏览器
- *  把 `opacity` 过渡整个跳过，且开合时重排整页——手机档上会看到内容跳一下）。 */
-function copyMenuHtml(button, formats) {
-    // #525 第二轮：开合器**不再把 `▾` 打上屏**（用户裁定第 5 条「用符号简化了 UI 展示的设计」是债）。
-    // 这颗三角是「这里可以展开」的纯装饰，可见文字里删掉、改由 CSS 画（`style.ts` 的 copyButton 区
-    // `.ilife-copy-menu-wrap > .ilife-copy-btn::after`，`border` ＋ `transform: rotate`，一个字符都不打）。
-    // 删字符不能删语义：`aria-label` 里把那句「可以选格式」写成文字（读屏与无图形环境仍读得出）。
-    const openLabel = button.label;
-    const items = [];
-    for (let i = 0; i < COPY_FORMATS.length; i += 1) {
-        const key = COPY_FORMATS[i];
-        const hint = formats.hints[i];
-        const hintHtml = hint === undefined || hint === '' ? '' : '<span class="' + STYLE_PREFIX + COPY_MENU_HINT_CLASS + '">' + esc(hint) + '</span>';
-        items.push('<button type="button" class="' + STYLE_PREFIX + COPY_MENU_ITEM_CLASS + '" ' + COPY_MENU_FMT_ATTR + '="' + esc(key) + '" '
-            + DEFAULT_DATA_ATTR + '="' + esc(formats.texts[i]) + '">'
-            + '<span class="' + STYLE_PREFIX + COPY_MENU_LABEL_CLASS + '">' + esc(COPY_FORMAT_LABELS[key] ?? key) + '</span>' + hintHtml + '</button>');
-    }
-    const opener = '<button type="button" class="' + STYLE_PREFIX + 'copy-btn ' + STYLE_PREFIX + 'copy-btn-ghost" '
-        + COPY_MENU_OPEN_ATTR + '="1" aria-haspopup="menu" aria-expanded="false" '
-        + 'aria-label="' + esc(openLabel + COPY_MENU_OPENER_ARIA) + '">' + esc(openLabel) + '</button>';
-    return '<div class="' + STYLE_PREFIX + COPY_MENU_WRAP_CLASS + '">' + opener
-        + '<div class="' + STYLE_PREFIX + COPY_MENU_CLASS + '" role="menu">' + items.join('') + '</div></div>';
-}
-/** 一颗复制按钮：单格式＝普通按钮（`actionId` ＋ 可选 `data-t`）；三格式＝菜单形态（见 `copyMenuHtml`）。 */
-function copyControlHtml(button) {
-    return button.formats === undefined ? copyButtonHtml(button) : copyMenuHtml(button, button.formats);
-}
-/** 冻结签名：`renderActionBar(input: ActionBarInput): string`。
- *
- *  场景按钮（`primary`／`red`／`ghost`）一行；复制数据／复制日志 ghost 按钮**独立一行**
- *  （`ACTION_BAR_DEFAULTS.ghostOwnRow`）；复制文本渲染期写入 `DEFAULT_DATA_ATTR`、id 写入 `ACTION_ID_ATTR`，
- *  零内联脚本。缺 `actionId`／空串／同次渲染内重复 → `ControlsError` code `bad-input`。
- *  逐区尺寸（`minHeightPx`／`fontSizePx`／`fontWeight`／`ghostBorderAlpha`／`evenRowPairs`）由 #75 的
- *  共享样式区消费（本文件不产样式常量）。
- *
- *  #654（负责人 2026-09-16 验收打回，**口径变更**）：**不再补**那颗禁用态「复制日志」占位。
- *  动作条只渲染**真存在**的动作；ghost 行的几何改由「列数跟着颗数走」保——只有一颗时挂
- *  `action-row-ghost-single`（`style.ts` 让它在整行轨道铺满），两颗真位时照 #247 两列平分。
- *  两边都在场／都不在场／仅日志位在场照旧；仅日志位在场不补数据位。 */
-export const renderActionBar = (input) => {
-    assertPlainObject(input, 'renderActionBar: input');
-    const bar = input;
-    const buttons = normalizeButtons(bar.buttons);
-    const copyData = normalizeCopyButton(bar.copyData, ACTION_BAR_DEFAULTS.copyDataLabel, 'copyData');
-    const copyLog = normalizeCopyButton(bar.copyLog, ACTION_BAR_DEFAULTS.copyLogLabel, 'copyLog');
-    const ids = new Set();
-    for (const button of buttons) {
-        if (ids.has(button.actionId))
-            badInput('renderActionBar: actionId 同次渲染内重复：' + button.actionId);
-        ids.add(button.actionId);
-    }
-    for (const copy of [copyData, copyLog]) {
-        if (copy === null)
-            continue;
-        if (ids.has(copy.actionId))
-            badInput('renderActionBar: actionId 同次渲染内重复：' + copy.actionId);
-        ids.add(copy.actionId);
-    }
-    const sceneHtml = buttons.map(sceneButtonHtml).join('');
-    const ghostList = [copyData, copyLog].filter((copy) => copy !== null);
-    const ghostHtml = ghostList.map(copyControlHtml).join('');
-    const rowClass = STYLE_PREFIX + 'action-row';
-    // #654：ghost 行**只有一颗**时挂单颗修饰类——`style.ts` 让它铺满整行轨道（既不占半格、
-    // 也不缩成内容宽）；两颗真位时不挂，#247 的两列平分口径一字不动。
-    const ghostRowClass = rowClass + ' ' + STYLE_PREFIX + 'action-row-ghost'
-        + (ghostList.length === 1 ? ' ' + STYLE_PREFIX + 'action-row-ghost-single' : '');
-    const rows = [];
-    if (sceneHtml !== '' && ghostHtml !== '' && !ACTION_BAR_DEFAULTS.ghostOwnRow) {
-        rows.push('<div class="' + rowClass + '">' + sceneHtml + ghostHtml + '</div>');
-    }
-    else {
-        if (sceneHtml !== '')
-            rows.push('<div class="' + rowClass + '">' + sceneHtml + '</div>');
-        if (ghostHtml !== '')
-            rows.push('<div class="' + ghostRowClass + '">' + ghostHtml + '</div>');
-    }
-    return '<div class="' + STYLE_PREFIX + 'action-bar">' + rows.join('') + '</div>';
-};
-/* ── 状态三控件 ───────────────────────────────────────────────────────── */
-/** 冻结签名：`renderStatusBadge(input: StatusBadgeInput): string`。
- *  非法 `status` 降级 `'empty'`（不抛错，防无样式徽章）；`text` 缺省／空串取 `STATUS_DEFAULT_TEXT`。 */
-export const renderStatusBadge = (input) => {
-    const badge = input === null || input === undefined || typeof input !== 'object' ? undefined : input;
-    const status = badge !== undefined && isStatusKind(badge.status) ? badge.status : 'empty';
-    const text = badge === undefined ? undefined : badge.text;
-    const label = typeof text === 'string' && text !== '' ? text : STATUS_DEFAULT_TEXT[status];
-    return '<span class="' + STYLE_PREFIX + 'status-badge ' + STYLE_PREFIX + 'status-badge-' + status + '">' + esc(label) + '</span>';
-};
-/** 冻结签名：`renderEmptyState(input: EmptyStateInput): string`。
- *  `icon`／`text`／`hint` 一律转义；`actionHtml` 受信 HTML 透传（不转义）；`text` 缺失／非字符串 → `bad-input`。 */
-export const renderEmptyState = (input) => {
-    assertPlainObject(input, 'renderEmptyState: input');
-    const state = input;
-    if (typeof state.text !== 'string')
-        badInput('renderEmptyState: input.text 必须是字符串');
-    const parts = [];
-    if (typeof state.icon === 'string' && state.icon !== '') {
-        parts.push('<div class="' + STYLE_PREFIX + 'empty-icon">' + esc(state.icon) + '</div>');
-    }
-    parts.push('<div class="' + STYLE_PREFIX + 'empty-text">' + esc(state.text) + '</div>');
-    if (typeof state.hint === 'string' && state.hint !== '') {
-        parts.push('<div class="' + STYLE_PREFIX + 'empty-hint">' + esc(state.hint) + '</div>');
-    }
-    if (typeof state.actionHtml === 'string' && state.actionHtml !== '') {
-        parts.push('<div class="' + STYLE_PREFIX + 'empty-action">' + state.actionHtml + '</div>');
-    }
-    return '<div class="' + STYLE_PREFIX + 'empty">' + parts.join('') + '</div>';
-};
-/** 修正重试按钮缺省文案（文档无规定；沿用旧基线）。 */
-const ERROR_RETRY_LABEL = '修正重试';
-/** 错误标题前缀（文档无规定；沿用旧基线 `❌ `）。 */
-const ERROR_TITLE_PREFIX = '❌ ';
-/** 冻结签名：`renderErrorReceipt(input: ErrorReceiptInput): string`。
- *  缺 `dataText`／`logText` → **不渲染**对应复制按钮（容错，不抛错）；id 缺省取
- *  `COPY_ACTION_IDS.errorReceipt.*`；**不读** `window.__hmPayload` 之类旧全局（AC-7）。 */
-export const renderErrorReceipt = (input) => {
-    assertPlainObject(input, 'renderErrorReceipt: input');
-    const receipt = input;
-    if (typeof receipt.message !== 'string')
-        badInput('renderErrorReceipt: input.message 必须是字符串');
-    const retryLabel = typeof receipt.retryPrompt === 'string' && receipt.retryPrompt !== '' ? receipt.retryPrompt : ERROR_RETRY_LABEL;
-    // #733 复现实测：这一颗**从来不带** ACTION_ID_ATTR 与 DEFAULT_DATA_ATTR（件头第 42 行自述「该按钮不带…」），
-    //   而产物内联委派的第一道 `node.closest("[data-action-id]")` 就早退 ⇒ **点了零动作、零反馈**。
-    //   记账写入域 16 张采集页上，它是整块错误回执里视觉权重最重的一颗（primary ＋ wide），
-    //   维护者逐字要求：「要么真能点，要么看起来就不能点，不许留在『看着能点、点了没反应』这一档」。
-    //   改法＝走后者：加 `disabled` ＋ `aria-disabled`，吃既有的 `.copy-btn[disabled]` 样式
-    //   （浅底 ＋ `--fg3` 字 ＋ `cursor: not-allowed`），它当场从「最响的一颗」变成明显不可点的一行。
-    //   不改成「真能点」的原因：它的文案是「补齐了，说一遍试试」，而这一页是静态文档，
-    //   「再试一次」这件事只有宿主（助手）能做——给它编一个动作才是说谎。
-    const actions = [
-        '<button type="button" class="' + STYLE_PREFIX + 'copy-btn ' + STYLE_PREFIX + 'copy-btn-primary ' + STYLE_PREFIX + 'copy-btn-wide"'
-            + ' disabled aria-disabled="true">' + esc(retryLabel) + '</button>',
-    ];
-    const ids = new Set();
-    const pushCopy = (text, rawId, fallbackId, label, field) => {
-        if (typeof text !== 'string')
-            return;
-        const actionId = rawId === undefined ? fallbackId : assertActionId(rawId, 'renderErrorReceipt: input.' + field);
-        if (ids.has(actionId))
-            badInput('renderErrorReceipt: actionId 同次渲染内重复：' + actionId);
-        ids.add(actionId);
-        actions.push('<button type="button" class="' + STYLE_PREFIX + 'copy-btn ' + STYLE_PREFIX + 'copy-btn-ghost" '
-            + ACTION_ID_ATTR + '="' + esc(actionId) + '" ' + DEFAULT_DATA_ATTR + '="' + esc(text) + '">' + esc(label) + '</button>');
-    };
-    pushCopy(receipt.dataText, receipt.dataActionId, COPY_ACTION_IDS.errorReceipt.copyData, ACTION_BAR_DEFAULTS.copyDataLabel, 'dataActionId');
-    pushCopy(receipt.logText, receipt.logActionId, COPY_ACTION_IDS.errorReceipt.copyLog, ACTION_BAR_DEFAULTS.copyLogLabel, 'logActionId');
-    return '<div class="' + STYLE_PREFIX + 'error">'
-        + '<div class="' + STYLE_PREFIX + 'error-title">' + esc(ERROR_TITLE_PREFIX + receipt.message) + '</div>'
-        + '<div class="' + STYLE_PREFIX + 'error-actions">' + actions.join('') + '</div>'
-        + '</div>';
-};
-//# sourceMappingURL=controls.js.map
+export * from './components/controls/index.js';