base-paint 0.3.14 → 0.3.16

package/dist/components/controls/action-bar.js

@@ -0,0 +1,217 @@
+/** controls · action-bar
+ *
+ *  自 `src/controls.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑤把 `src/controls.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（五个渲染器 ＋ 共享 helpers JS ＋ 出口名单），
+ *  见 `docs/base/base-render/组件目录架构.md`。
+ */
+import { assertActionId, assertNoInlineHandler, assertPlainObject, badInput, esc } from './shared.js';
+import { ACTION_BAR_DEFAULTS, ACTION_BAR_KINDS, ACTION_ID_ATTR, COPY_FORMATS, DEFAULT_DATA_ATTR } from '../../spec/index.js';
+import { STYLE_PREFIX } from '../../style.js';
+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` 因此天然不碰它（无需为此改冻结签名）。 */
+export const COPY_MENU_OPEN_ATTR = 'data-fmt-open';
+/** 菜单项的**格式键**承载属性（三格式形态里唯一分辨三项的东西——值取 `COPY_FORMATS`）。
+ *  与老仓逐字同名：老仓 `.fmt-item` 就是靠 `data-fmt` 分辨纯文本／JSON／CSV。 */
+export const COPY_MENU_FMT_ATTR = 'data-fmt';
+/** 格式菜单容器与按钮的共同父节点类名（运行时据**最近的这个父节点**开合／收起菜单）。 */
+export const COPY_MENU_WRAP_CLASS = 'copy-menu-wrap';
+/** 菜单容器自身的类名（浮动那一层）。 */
+export const COPY_MENU_CLASS = 'copy-menu';
+/** 菜单项的类名。 */
+const COPY_MENU_ITEM_CLASS = 'copy-menu-item';
+/** 菜单项**标签**文本的类名（`data-fmt` 只放格式键；标签是给人看的中文名，见 `COPY_FORMAT_LABELS`）。 */
+export 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` 同步）。 */
+export 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` 的中文名），不在运行时另立第二张表。 */
+export 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>';
+};
+//# sourceMappingURL=action-bar.js.map

package/dist/components/controls/action-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-bar.js","sourceRoot":"","sources":["../../../src/components/controls/action-bar.ts"],"names":[],"mappings":"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"}

package/dist/components/controls/bind.d.ts

@@ -0,0 +1,22 @@
+/** controls · bind
+ *
+ *  自 `src/controls.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑤把 `src/controls.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（五个渲染器 ＋ 共享 helpers JS ＋ 出口名单），
+ *  见 `docs/base/base-render/组件目录架构.md`。
+ */
+import { BindCopyAction } from '../../spec/index.js';
+/** 冻结签名：`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 declare const bindCopyAction: BindCopyAction;
+//# sourceMappingURL=bind.d.ts.map

package/dist/components/controls/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../../src/components/controls/bind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD;;;;;;;;;;gDAUgD;AAChD,eAAO,MAAM,cAAc,EAAE,cAkC5B,CAAC"}

package/dist/components/controls/bind.js

@@ -0,0 +1,63 @@
+/** controls · bind
+ *
+ *  自 `src/controls.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑤把 `src/controls.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（五个渲染器 ＋ 共享 helpers JS ＋ 出口名单），
+ *  见 `docs/base/base-render/组件目录架构.md`。
+ */
+import { assertCopyPorts, copyText } from './copy.js';
+import { assertPlainObject, badInput } from './shared.js';
+/* ── 复制接线（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;
+        },
+    };
+};
+//# sourceMappingURL=bind.js.map

package/dist/components/controls/bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.js","sourceRoot":"","sources":["../../../src/components/controls/bind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG1D,4DAA4D;AAE5D;;;;;;;;;;gDAUgD;AAChD,MAAM,CAAC,MAAM,cAAc,GAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAClE,iBAAiB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;IAChD,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,UAAU;QAAE,QAAQ,CAAC,0CAA0C,CAAC,CAAC;IACnG,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU;QAAE,QAAQ,CAAC,yCAAyC,CAAC,CAAC;IACjG,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU;QAAE,QAAQ,CAAC,uCAAuC,CAAC,CAAC;IAC7F,eAAe,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IAClC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACvD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QACpF,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE;YACzC,IAAI,QAAQ;gBAAE,OAAO;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACzC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO;YACrC,wEAAwE;YACxE,sDAAsD;YACtD,KAAK,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,OAAO;gBAAE,GAAG,EAAE,CAAC;YACjC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/components/controls/copy.d.ts

@@ -0,0 +1,18 @@
+/** controls · copy
+ *
+ *  自 `src/controls.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑤把 `src/controls.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（五个渲染器 ＋ 共享 helpers JS ＋ 出口名单），
+ *  见 `docs/base/base-render/组件目录架构.md`。
+ */
+import { CopyPorts, CopyRuntime, CopyText } from '../../spec/index.js';
+export declare function assertCopyPorts(ports: CopyPorts, field: string): void;
+/** 冻结签名：`copyText(text: string, ports: CopyPorts, opts?: CopyTextOptions): Promise<CopyTextOutcome>`。 */
+export declare const copyText: CopyText;
+/** 冻结签名：`createCopyRuntime(ports: CopyPorts): CopyRuntime`。
+ *
+ *  除转发 `copyText` 外，本 runtime 记录自己挂载的反馈节点，`dispose()` 一并移除（幂等）。
+ *  「dispose 后仍可复制」是文档未规定处的取值：`dispose` 只回收反馈节点，不改端口语义。 */
+export declare const createCopyRuntime: (ports: CopyPorts) => CopyRuntime;
+//# sourceMappingURL=copy.d.ts.map

package/dist/components/controls/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/components/controls/copy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAmC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAqE,MAAM,qBAAqB,CAAC;AAI3K,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOrE;AA2BD,yGAAyG;AACzG,eAAO,MAAM,QAAQ,EAAE,QA8CtB,CAAC;AAEF;;;0DAG0D;AAC1D,eAAO,MAAM,iBAAiB,GAAI,OAAO,SAAS,KAAG,WA6BpD,CAAC"}

package/dist/components/controls/copy.js

@@ -0,0 +1,133 @@
+/** controls · copy
+ *
+ *  自 `src/controls.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑤把 `src/controls.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（五个渲染器 ＋ 共享 helpers JS ＋ 出口名单），
+ *  见 `docs/base/base-render/组件目录架构.md`。
+ */
+import { badInput } from './shared.js';
+import { renderToast } from './toast.js';
+import { COPY_TEXT_DEFAULTS, STATUS_DEFAULT_TEXT } from '../../spec/index.js';
+/* ── copyText 双通道（Q13／AC-16①） ──────────────────────────────────── */
+export 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();
+        },
+    };
+};
+//# sourceMappingURL=copy.js.map

package/dist/components/controls/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/components/controls/copy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAmF,mBAAmB,EAAc,MAAM,qBAAqB,CAAC;AAE3K,sEAAsE;AAEtE,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,KAAa;IAC7D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,QAAQ,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC;IAChF,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;QAAE,QAAQ,CAAC,KAAK,GAAG,wBAAwB,CAAC,CAAC;IACrF,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,SAAS,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC/F,QAAQ,CAAC,KAAK,GAAG,mCAAmC,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB,EAAE,QAAgB;IAC/D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtE,CAAC;AAED,yDAAyD;AACzD,SAAS,YAAY,CAAC,IAAqB;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7F,MAAM,KAAK,GAAe;QACxB,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,kBAAkB,CAAC,SAAS,CAAC;QAC9D,MAAM,EAAE,OAAO,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ;KAC7F,CAAC;IACF,OAAO,OAAO,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACxF,CAAC;AAED,8EAA8E;AAC9E,SAAS,cAAc,CAAC,IAAqB;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC/F,OAAO;QACL,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,kBAAkB,CAAC,WAAW,CAAC;QAChE,MAAM,EAAE,OAAO,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,UAAU;QAC9F,IAAI,EAAE,OAAO,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;QACnE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,CAAC,MAAM,EAAE;KAC5D,CAAC;AACJ,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,MAAM,QAAQ,GAAa,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAC5D,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACnC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAChE,MAAM,OAAO,GAAoB,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7G,IAAI,kBAAkB,CAAC,qBAAqB,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAC5D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,KAAiB,EAAQ,EAAE;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAChD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU;YAAE,QAAQ,CAAC,mCAAmC,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,EAAW,EAAE,OAA2B,EAAE,MAAe,EAAmB,EAAE;QAC5F,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI;gBAAE,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YAClE,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAsB,CAAC,CAAC;YAC7E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,kBAAkB,CAAC,iBAAiB;YAAE,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QACjF,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;QAC9E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC9C,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;IAC1C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC;IACD,mEAAmE;IACnE,uEAAuE;IACvE,+CAA+C;IAC/C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACxF,CAAC,CAAC;AAEF;;;0DAG0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAgB,EAAe,EAAE;IACjE,eAAe,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;IACzB,MAAM,OAAO,GAAc,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAC5D,CAAC,CAAC,KAAK;QACP,CAAC,CAAC;YACA,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE;gBACL,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE;oBACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAChC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACpB,OAAO;wBACL,MAAM,EAAE,GAAG,EAAE;4BACX,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;4BACvB,MAAM,CAAC,MAAM,EAAE,CAAC;wBAClB,CAAC;qBACF,CAAC;gBACJ,CAAC;aACF;SACF,CAAC;IACJ,OAAO;QACL,QAAQ,EAAE,CAAC,IAAY,EAAE,IAAsB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;QACjF,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC;gBAAE,MAAM,CAAC,MAAM,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/components/controls/helpers-meta.d.ts

@@ -0,0 +1,87 @@
+/** controls · helpers-meta
+ *
+ *  自 `src/controls.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑤把 `src/controls.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（五个渲染器 ＋ 共享 helpers JS ＋ 出口名单），
+ *  见 `docs/base/base-render/组件目录架构.md`。
+ */
+import { SharedHelpersInput } from '../../spec/index.js';
+/** JS 字符串字面量（产出文本里嵌值唯一出口）。 */
+export declare function jsStr(value: string): string;
+export declare function helpersPrefix(input?: SharedHelpersInput): string;
+export declare function helpersDataAttr(input?: SharedHelpersInput): string;
+/** HELP模板类名命名空间 kebab 后缀（`help-shell`；缺省前缀下根 = `ilife-help-shell`）。
+ *  **延迟求值**（不在模块顶层）：`style.ts → charts.ts → controls.ts → style.ts` 存在模块环，
+ *  顶层读 `STYLE_PREFIX` 会在 `style.js` 初始化完成前触发 TDZ（实测 `ReferenceError`），
+ *  故派生式只在 `buildSharedHelpersJs()` **调用时**执行（此时全部模块已初始化）。 */
+export declare function helpShellSlug(): string;
+/** 回到顶部按钮的 `id`（视觉尺 H-19 逐字点名 `#backTop`；`backTop` 是**冻结规格值**）。 */
+export declare const HELP_BACKTOP_ID = "backTop";
+/** H-19：`scrollY > 400` 才出现（阈值逐字取规格）。 */
+export declare const HELP_BACKTOP_MIN_Y = 400;
+/** H-19：按钮字形 `↑`（18px／600 由 CSS 承担）。 */
+export declare const HELP_BACKTOP_LABEL = "\u2191";
+/** 无障碍名（文档未规定 → 本票取值，与 `TOAST_CLOSE_LABEL` 同口径记账）。 */
+export declare const HELP_BACKTOP_ARIA = "\u56DE\u5230\u9876\u90E8";
+/** 搜索框占位文案（F3 `卡路里.html` 的 `#sB` 逐字：`搜索全部场景`）。 */
+export declare const HELP_SEARCH_PLACEHOLDER = "\u641C\u7D22\u5168\u90E8\u573A\u666F";
+/** 搜索框无障碍名（文档未规定 → 本票取值）。 */
+export declare const HELP_SEARCH_ARIA = "\u641C\u7D22\u5168\u90E8\u573A\u666F";
+/** 清空按钮字形（F3 `#sClear` 逐字：`✕`）与无障碍名。 */
+export declare const HELP_CLEAR_LABEL = "\u2715";
+export declare const HELP_CLEAR_ARIA = "\u6E05\u7A7A\u641C\u7D22";
+/** H-16 双反馈的**按钮通道**类名（#121；规格逐字 `copied`，**非** `ilife-` 前缀 → 不占样式区命名空间）。
+ *  CSS 侧两处已就位：`style.ts` 的 `copyButton` 区（`.ilife-copy-btn.copied`，#75）与本区追加的
+ *  helpShell 复制按钮 `.copied`（#121）；本常量只供运行时**加类**，不产第二份样式真相。 */
+export declare 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` 跨文件交叉钉死（改一侧不改另一侧即红）。 */
+export declare const HELP_COPY_COPIED_MS = 450;
+/** 命中计数文案（F3 `#hitC` 逐字：`匹配 N 个场景`）。 */
+export declare const HELP_HIT_PREFIX = "\u5339\u914D ";
+export declare const HELP_HIT_SUFFIX = " \u4E2A\u573A\u666F";
+/** 零命中文案（F3 `#emptyC` 逐字）。 */
+export declare const HELP_HIT_EMPTY = "\u6CA1\u6709\u627E\u5230\u76F8\u5173\u573A\u666F,\u6362\u4E2A\u8BCD\u8BD5\u8BD5\uFF5E";
+/** 冻结签名：`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` 字符串口径）。 */
+//# sourceMappingURL=helpers-meta.d.ts.map

package/dist/components/controls/helpers-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers-meta.d.ts","sourceRoot":"","sources":["../../../src/components/controls/helpers-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA4D,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAKnH,8BAA8B;AAC9B,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAGhE;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAGlE;AAeD;;;6DAG6D;AAC7D,wBAAgB,aAAa,IAAI,MAAM,CAStC;AAED,mEAAmE;AACnE,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,yCAAyC;AACzC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,WAAM,CAAC;AACtC,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,6BAAS,CAAC;AACxC,kDAAkD;AAClD,eAAO,MAAM,uBAAuB,yCAAW,CAAC;AAChD,6BAA6B;AAC7B,eAAO,MAAM,gBAAgB,yCAAW,CAAC;AACzC,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,WAAM,CAAC;AACpC,eAAO,MAAM,eAAe,6BAAS,CAAC;AACtC;;+DAE+D;AAC/D,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAC/C;;6DAE6D;AAC7D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,wCAAwC;AACxC,eAAO,MAAM,eAAe,kBAAQ,CAAC;AACrC,eAAO,MAAM,eAAe,wBAAS,CAAC;AACtC,8BAA8B;AAC9B,eAAO,MAAM,cAAc,0FAAoB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAuC4E"}