base-paint 0.3.13 → 0.3.15

package/dist/editableValue.js

@@ -0,0 +1,415 @@
+/** base-paint/blocks · **editableValue：就地可编辑值**（"值即入口"）。
+ *
+ * 一句话职责：把**一个已算好的值**变成可点的编辑入口——常态是「文本 ＋ 铅笔提示」，
+ * 编辑态在**同一格里**换成 `input／select`，两种状态**同一盒模型**（列 x 与行高逐值相等）。
+ *
+ * 为什么要单立这一件（第一性）：
+ *  - 既有 `renderParamForm` 是**表单优先**：每个字段占一行、标签在上、值在下，页面按"填表"读；
+ *    而「先给我看一眼、顺手改一处」的页面（预检确认页、目标预检、批量导入预览、编辑器参数面）
+ *    要的是**值优先**：值本身即入口，整块是命中区，改完不换屏、不弹层、不回对话。
+ *  - 这两件事的形状不同，硬塞进表单会同时得罪两边：表单变得零碎，值域又拿不到"字段"的语义。
+ *  - 三种实现里只有一种对：**值＋铅笔 → 同格变编辑器**。另两种都错——
+ *    另挂一颗「改」按钮（控件噪声 ×N，且按钮与值的语义打架）、
+ *    或把值整格做成常驻输入框（"未改"与"可改"失去区分，密度高的表会变成一张表单）。
+ *
+ * 三条硬边界（与 `blocks.ts` 同口径，违反即红）：
+ *  1. **模块代码零 DOM**（AC-7）：本文件编译进 `dist/editableValue.js` 的**代码**里不出现
+ *     `document.`／`window.`／`navigator.`；DOM 只允许出现在 `buildEditableValueJs()` **产出的 JS 文本**里
+ *     （与 `controls.buildSharedHelpersJs()`／`charts.buildChartsHelpersJs()` 同一处分工）。
+ *  2. **零内联脚本／零内联事件处理器**：标记只带 `data-*`，激活一律走本件的运行时（事件委派）。
+ *  3. **不进 12 区闭集**：本件**不是第 13 个区块**——它自带样式段 `editableValueCss()`，由页面
+ *     **按需注入**（照 `pageShapeCss()`／`charts` 那条先例）。不注入、不调用 ⇒ 别的页产物逐字节不变。
+ *
+ * 不变量（契约，真浏览器量过）：
+ *  - **编辑态不变形**：命中区与编辑器同 `min-height`、同内距、同字号，且宿主表格用定宽列时，
+ *    进入／退出编辑**不得**改变任何列的 x 与行高（判据见 `test/editable-value.test.mjs`）。
+ *  - **命中区 ≥44px**（`ACTION_BAR_DEFAULTS.minHeightPx` 的全宽口径，用户裁定）。
+ *  - **无脚本可读**：不跑运行时也读得到值（值是文本，不是输入框占位）——SSR／打印／纯静态页皆成立。
+ *
+ * 扩展点（调用方要"参数能力强、UI 细节可控"）：字段／值／显示字／单位／类型（text·number·select·date）／
+ *  候选项（机器值＋显示字分离）／占位／必填／min·max·step／铅笔形态（常显·悬停显·不显）／禁用／
+ *  对齐／附加类名。**配色与圆角不给参数**：只读冻结 token ＋ 局部圆角常量（与全仓样式纪律一致，
+ *  要换皮就换 token，不在组件入参上开口子）。
+ */
+import { ESCAPE_HTML_CHARS, ESCAPE_HTML_ENTITIES } from './spec/controls.js';
+/** 本件的类名根（`ilife-` 前缀 ＋ 自有命名空间，与控件／区块两族并列）。 */
+export const EDIT_VALUE_CLASS = 'ilife-edit-value';
+/** 机器键属性：值＝`EditableValueInput.name`。**运行时的发现锚**（`[data-ilife-edit]`）。 */
+export const EDIT_NAME_ATTR = 'data-ilife-edit';
+/** 输入类型：`text`｜`number`｜`select`｜`date`。 */
+export const EDIT_KIND_ATTR = 'data-ilife-edit-kind';
+/** 机器值（提交时原样送出的串）。 */
+export const EDIT_VALUE_ATTR = 'data-ilife-edit-value';
+/** 显示字（缺省＝机器值；显示字可与机器值不同：`男`/`male`、`1,800`/`1800`）。 */
+export const EDIT_DISPLAY_ATTR = 'data-ilife-edit-display';
+/** 单位（小号，跟在值后；不参与机器值）。 */
+export const EDIT_UNIT_ATTR = 'data-ilife-edit-unit';
+/** 人类可读字段名（`aria-label` 与提交事件 `detail.label` 用它）。 */
+export const EDIT_LABEL_ATTR = 'data-ilife-edit-label';
+/** 候选项（JSON：`[{value,label}]`；`kind=select` 必填）。 */
+export const EDIT_OPTIONS_ATTR = 'data-ilife-edit-options';
+/** 铅笔形态：`always`｜`hover`｜`none`（缺省 `always`）。 */
+export const EDIT_AFFORDANCE_ATTR = 'data-ilife-edit-affordance';
+/** 约束（各自独立属性，运行时逐条读；不塞 JSON 是为了让"缺省"与"给了空串"可分辨）。 */
+export const EDIT_REQUIRED_ATTR = 'data-ilife-edit-required';
+export const EDIT_PLACEHOLDER_ATTR = 'data-ilife-edit-placeholder';
+export const EDIT_MIN_ATTR = 'data-ilife-edit-min';
+export const EDIT_MAX_ATTR = 'data-ilife-edit-max';
+export const EDIT_STEP_ATTR = 'data-ilife-edit-step';
+/** 命中区标记：运行时按它找可点控件（一个值上恰一枚）。 */
+export const EDIT_HIT_ATTR = 'data-ilife-edit-hit';
+/** 绑定完成标记（运行时幂等：重复注入不重复绑定）。 */
+export const EDIT_BOUND_ATTR = 'data-ilife-edit-bound';
+/** 提交／取消事件名（冒泡 `CustomEvent`，`detail = { name, label?, value, prev, unit? }`）。
+ *  页面用 `root.addEventListener(EDIT_EVENT_COMMIT, …)` 接自己的重算逻辑——**不引入任何全局**。 */
+export const EDIT_EVENT_COMMIT = 'ilife:edit-commit';
+export const EDIT_EVENT_CANCEL = 'ilife:edit-cancel';
+/** 输入类型闭集（不给／给闭集外的值 → `bad-input`，不静默降级：静默降级会让调用方以为自己改成了下拉）。 */
+export const EDIT_KINDS = ['text', 'number', 'select', 'date'];
+/** 铅笔形态闭集。 */
+export const EDIT_AFFORDANCES = ['always', 'hover', 'none'];
+/** 本件的错误类型（与 `BlocksError` 同名同形，但**不起第二个类**：只借名字，判据走 `name`）。 */
+function badInput(message) {
+    const err = new Error(message);
+    err.name = 'BlocksError';
+    throw err;
+}
+const ESCAPE_RE = new RegExp('[' + ESCAPE_HTML_CHARS.join('') + ']', 'g');
+function esc(value) {
+    return value.replace(ESCAPE_RE, (ch) => ESCAPE_HTML_ENTITIES[ch] ?? ch);
+}
+function reqText(value, field) {
+    if (typeof value !== 'string' || value === '')
+        badInput(field + ' 必须是非空字符串');
+    return value;
+}
+function optText(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        badInput(field + ' 必须是字符串');
+    return value === '' ? undefined : value;
+}
+/** 可选数字约束：数字收 `String(value)`；字串须非空非空白且 `Number()` 有限（与 `blocks.ts` 同口径）。 */
+function optNumeric(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            badInput(field + ' 必须是有限数字');
+        return String(value);
+    }
+    if (typeof value === 'string') {
+        const s = value.trim();
+        if (s === '' || !Number.isFinite(Number(s)))
+            badInput(field + ' 必须是数字串');
+        return s;
+    }
+    badInput(field + ' 必须是数字或数字串');
+}
+function optExtraClass(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value.trim() === '')
+        badInput(field + ' 必须是非空字符串');
+    const names = value.trim().split(/\s+/);
+    for (const name of names) {
+        if (!/^-?[A-Za-z_][A-Za-z0-9_-]*$/.test(name))
+            badInput(field + ' 只许空格分隔的类名：' + name);
+    }
+    return names.join(' ');
+}
+/** 候选项归一：字符串项 → `{value,label}` 同值；对象项逐字校验。 */
+function normalizeOptions(raw) {
+    if (!Array.isArray(raw) || raw.length === 0)
+        badInput('renderEditableValue: options 必须是非空数组');
+    return raw.map((item, i) => {
+        if (typeof item === 'string') {
+            if (item === '')
+                badInput('renderEditableValue: options[' + i + '] 不得为空串');
+            return { value: item, label: item };
+        }
+        if (item === null || typeof item !== 'object' || Array.isArray(item)) {
+            badInput('renderEditableValue: options[' + i + '] 必须是字符串或 { value, label }');
+        }
+        const o = item;
+        return { value: reqText(o.value, 'renderEditableValue: options[' + i + '].value'), label: reqText(o.label, 'renderEditableValue: options[' + i + '].label') };
+    });
+}
+/** 铅笔图标（13px，`currentColor`；"可编辑"的通用记号——**不**用文字按钮，见件头注释）。 */
+const PEN_SVG = '<svg class="ilife-edit-value-pen" viewBox="0 0 24 24" width="13" height="13" fill="none"'
+    + ' stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"'
+    + ' focusable="false"><path d="M12 20h9"/><path d="M16.5 3.5a2.12 2.12 0 0 1 3 3L7 19l-4 1 1-4Z"/></svg>';
+/** ① 渲染：一个值 → 可编辑值标记（纯函数；`data-*` 是唯一对外契约，运行时按它们工作）。 */
+export function renderEditableValue(input) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input))
+        badInput('renderEditableValue: input 必须是对象');
+    const name = reqText(input.name, 'renderEditableValue: input.name');
+    const value = reqText(input.value, 'renderEditableValue: input.value');
+    const display = input.display === undefined ? value : input.display;
+    if (typeof display !== 'string')
+        badInput('renderEditableValue: input.display 必须是字符串');
+    const kind = input.kind === undefined ? 'text' : input.kind;
+    if (!EDIT_KINDS.includes(kind)) {
+        badInput('renderEditableValue: input.kind 非法（' + EDIT_KINDS.join('／') + '）：' + String(input.kind));
+    }
+    const affordance = input.affordance === undefined ? 'always' : input.affordance;
+    if (!EDIT_AFFORDANCES.includes(affordance)) {
+        badInput('renderEditableValue: input.affordance 非法（' + EDIT_AFFORDANCES.join('／') + '）：' + String(input.affordance));
+    }
+    if (input.align !== undefined && input.align !== 'left' && input.align !== 'right') {
+        badInput('renderEditableValue: input.align 只许 left／right：' + String(input.align));
+    }
+    const options = input.options === undefined ? undefined : normalizeOptions(input.options);
+    if (kind === 'select' && options === undefined)
+        badInput('renderEditableValue: kind=select 必须给 options');
+    if (kind !== 'select' && options !== undefined)
+        badInput('renderEditableValue: options 只对 kind=select 有效');
+    if (kind === 'select' && options !== undefined && !options.some((o) => o.value === value)) {
+        badInput('renderEditableValue: value 不在 options 里：' + value);
+    }
+    const min = optNumeric(input.min, 'renderEditableValue: input.min');
+    const max = optNumeric(input.max, 'renderEditableValue: input.max');
+    const step = optNumeric(input.step, 'renderEditableValue: input.step');
+    if (step !== undefined && Number(step) <= 0)
+        badInput('renderEditableValue: input.step 必须大于 0');
+    if (min !== undefined && max !== undefined && Number(min) > Number(max)) {
+        badInput('renderEditableValue: input.min 不得大于 input.max（' + min + ' > ' + max + '）');
+    }
+    if ((min !== undefined || max !== undefined || step !== undefined) && kind !== 'number') {
+        badInput('renderEditableValue: min／max／step 只对 kind=number 有效');
+    }
+    const unit = optText(input.unit, 'renderEditableValue: input.unit');
+    const label = optText(input.label, 'renderEditableValue: input.label');
+    const placeholder = optText(input.placeholder, 'renderEditableValue: input.placeholder');
+    const extraClass = optExtraClass(input.extraClass, 'renderEditableValue: input.extraClass');
+    const classes = [EDIT_VALUE_CLASS, EDIT_VALUE_CLASS + '--' + kind];
+    if (input.align === 'right')
+        classes.push(EDIT_VALUE_CLASS + '--right');
+    if (input.disabled === true)
+        classes.push(EDIT_VALUE_CLASS + '--disabled');
+    if (extraClass !== undefined)
+        classes.push(extraClass.split(' ').join(' '));
+    const attrs = [
+        'class="' + esc(classes.join(' ')) + '"',
+        EDIT_NAME_ATTR + '="' + esc(name) + '"',
+        EDIT_KIND_ATTR + '="' + esc(kind) + '"',
+        EDIT_VALUE_ATTR + '="' + esc(value) + '"',
+        EDIT_DISPLAY_ATTR + '="' + esc(display) + '"',
+        EDIT_AFFORDANCE_ATTR + '="' + esc(affordance) + '"',
+    ];
+    if (unit !== undefined)
+        attrs.push(EDIT_UNIT_ATTR + '="' + esc(unit) + '"');
+    if (label !== undefined)
+        attrs.push(EDIT_LABEL_ATTR + '="' + esc(label) + '"');
+    if (options !== undefined)
+        attrs.push(EDIT_OPTIONS_ATTR + '="' + esc(JSON.stringify(options)) + '"');
+    if (placeholder !== undefined)
+        attrs.push(EDIT_PLACEHOLDER_ATTR + '="' + esc(placeholder) + '"');
+    if (input.required === true)
+        attrs.push(EDIT_REQUIRED_ATTR + '="1"');
+    if (min !== undefined)
+        attrs.push(EDIT_MIN_ATTR + '="' + esc(min) + '"');
+    if (max !== undefined)
+        attrs.push(EDIT_MAX_ATTR + '="' + esc(max) + '"');
+    if (step !== undefined)
+        attrs.push(EDIT_STEP_ATTR + '="' + esc(step) + '"');
+    const hitAttrs = [EDIT_HIT_ATTR + '=""', 'type="button"', 'class="' + EDIT_VALUE_CLASS + '-hit"'];
+    if (label !== undefined)
+        hitAttrs.push('aria-label="改' + esc(label) + '"');
+    else
+        hitAttrs.push('aria-label="改这一个值"');
+    if (input.disabled === true)
+        hitAttrs.push('disabled', 'aria-disabled="true"');
+    const body = '<span class="' + EDIT_VALUE_CLASS + '-text">' + esc(display) + '</span>'
+        + (unit === undefined ? '' : '<span class="' + EDIT_VALUE_CLASS + '-unit">' + esc(unit) + '</span>')
+        + (input.disabled === true ? '' : PEN_SVG);
+    return '<span ' + attrs.join(' ') + '><button ' + hitAttrs.join(' ') + '>' + body + '</button></span>';
+}
+/** ② 样式：本件的唯一样式来源（**不进** 12 区闭集，由页面按需注入）。
+ *  只读冻结 token（`CSS_VAR_TOKENS`）与局部圆角常量，不新增 token 名（D-5／DB-5）。
+ *  `--right` 只改值位对齐；`--disabled` 只降调；铅笔形态三档由 `affordance` 驱动。 */
+export function editableValueCss() {
+    const c = EDIT_VALUE_CLASS;
+    return [
+        '/* editableValue（就地可编辑值）：值即入口。命中区与编辑器同盒模型 ⇒ 进出编辑不变形。 */',
+        '.' + c + '{display:inline-flex;align-items:center;min-height:44px;max-width:100%}',
+        '.' + c + '-hit{display:inline-flex;align-items:center;gap:7px;box-sizing:border-box;min-height:44px;',
+        '  padding:0 9px;margin-left:-9px;border:0;border-radius:8px;background:transparent;color:inherit;',
+        '  font:inherit;text-align:left;cursor:pointer}',
+        '.' + c + '-hit:hover{background:var(--soft)}',
+        '.' + c + '-hit:focus-visible{outline:2px solid var(--blue);outline-offset:1px}',
+        '.' + c + '-hit[disabled]{cursor:not-allowed;color:var(--fg3)}',
+        '.' + c + '-text{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
+        '.' + c + '-unit{margin-left:2px;font-size:.85em;color:var(--fg2)}',
+        '.' + c + '--right .' + c + '-hit{margin-left:auto;margin-right:-9px;flex-direction:row-reverse}',
+        '.' + c + '-pen{flex:0 0 auto;color:var(--fg3);opacity:.75}',
+        '.' + c + '-hit:hover .' + c + '-pen{color:var(--blue2);opacity:1}',
+        '.' + c + '[data-ilife-edit-affordance="hover"] .' + c + '-pen{opacity:0}',
+        '.' + c + '[data-ilife-edit-affordance="hover"] .' + c + '-hit:hover .' + c + '-pen,',
+        '.' + c + '[data-ilife-edit-affordance="hover"] .' + c + '-hit:focus-visible .' + c + '-pen{opacity:1}',
+        '.' + c + '[data-ilife-edit-affordance="none"] .' + c + '-pen{display:none}',
+        '.' + c + '-input,.' + c + '-select{box-sizing:border-box;width:100%;max-width:250px;min-height:44px;',
+        '  padding:0 9px;border:1px solid var(--blue);border-radius:8px;background:var(--card);color:var(--fg);font:inherit}',
+        '.' + c + '--invalid .' + c + '-input,.' + c + '--invalid .' + c + '-select{border-color:#c0392b}',
+        '@media print{.' + c + '-pen{display:none}}',
+    ].join('\n');
+}
+/** ③ 运行时（**产出 JS 文本**，DOM 只在这里出现；与 `buildSharedHelpersJs()`／`buildChartsHelpersJs()` 同一处分工）。
+ *
+ *  行为契约（逐条对应测试）：
+ *   · 委派＋幂等：`document` 上一枚 `click`／`keydown`／`focusout` 委派，重复注入不重复绑定（`EDIT_BOUND_ATTR`）；
+ *   · 打开：点命中区 → 同一格换成 `input`／`select`（同 `min-height`），聚焦并全选；
+ *   · 提交：`Enter`／失焦／（select 的）`change`；校验不过（必填空、数字非法、超 min／max、step）→
+ *     **留在编辑态** ＋ `--invalid`，不派发事件；
+ *   · 取消：`Esc` → 还原为原值并派发 `EDIT_EVENT_CANCEL`；
+ *   · 提交成功 → 就地改写显示（文本／单位／`data-ilife-edit-value`）＋ 焦点回到命中区 ＋ 派发
+ *     `EDIT_EVENT_COMMIT`（冒泡，`detail = { name, label, value, prev, unit }`）；
+ *   · 无脚本降级：本段不跑时，值照常可读（就是文本），只是不可改。
+ *
+ *  `input?: { doc?: Document }` 只给测试注入用（缺省走全局 `document`）——**页面侧不传**。 */
+export function buildEditableValueJs() {
+    const N = JSON.stringify(EDIT_NAME_ATTR);
+    const K = JSON.stringify(EDIT_KIND_ATTR);
+    const V = JSON.stringify(EDIT_VALUE_ATTR);
+    const D = JSON.stringify(EDIT_DISPLAY_ATTR);
+    const U = JSON.stringify(EDIT_UNIT_ATTR);
+    const L = JSON.stringify(EDIT_LABEL_ATTR);
+    const O = JSON.stringify(EDIT_OPTIONS_ATTR);
+    const A = JSON.stringify(EDIT_AFFORDANCE_ATTR);
+    const REQ = JSON.stringify(EDIT_REQUIRED_ATTR);
+    const PH = JSON.stringify(EDIT_PLACEHOLDER_ATTR);
+    const MN = JSON.stringify(EDIT_MIN_ATTR);
+    const MX = JSON.stringify(EDIT_MAX_ATTR);
+    const ST = JSON.stringify(EDIT_STEP_ATTR);
+    const HIT = JSON.stringify(EDIT_HIT_ATTR);
+    const BOUND = JSON.stringify(EDIT_BOUND_ATTR);
+    const INV = JSON.stringify(EDIT_VALUE_CLASS + '--invalid');
+    const EV_COMMIT = JSON.stringify(EDIT_EVENT_COMMIT);
+    const EV_CANCEL = JSON.stringify(EDIT_EVENT_CANCEL);
+    const C = JSON.stringify(EDIT_VALUE_CLASS);
+    return '(function(){' + '\n'
+        + '  var ATTR_NAME=' + N + ', ATTR_KIND=' + K + ', ATTR_VALUE=' + V + ', ATTR_DISPLAY=' + D + ', ATTR_UNIT=' + U + ';' + '\n'
+        + '  var ATTR_LABEL=' + L + ', ATTR_OPTIONS=' + O + ', ATTR_AFF=' + A + ', ATTR_REQ=' + REQ + ', ATTR_PH=' + PH + ';' + '\n'
+        + '  var ATTR_MIN=' + MN + ', ATTR_MAX=' + MX + ', ATTR_STEP=' + ST + ', ATTR_HIT=' + HIT + ', ATTR_BOUND=' + BOUND + ';' + '\n'
+        + '  var CLASS_INVALID=' + INV + ', EV_COMMIT=' + EV_COMMIT + ', EV_CANCEL=' + EV_CANCEL + ', CLASS_ROOT=' + C + ';' + '\n'
+        + '  var doc=document;' + '\n'
+        + '  if (doc.documentElement.getAttribute("data-ilife-edit-runtime")==="1") return;' + '\n'
+        + '  doc.documentElement.setAttribute("data-ilife-edit-runtime","1");' + '\n'
+        + '  function nodes(){ return doc.querySelectorAll("["+ATTR_NAME+"]"); }' + '\n'
+        + '  function esc(s){ return s; }' + '\n'
+        /* 显示态：重建命中区（值／单位／铅笔） */
+        + '  function paint(root, value, display){' + '\n'
+        + '    root.setAttribute(ATTR_VALUE, value);' + '\n'
+        + '    root.setAttribute(ATTR_DISPLAY, display);' + '\n'
+        + '    var hit=root.querySelector("["+ATTR_HIT+"]");' + '\n'
+        + '    if (!hit) { hit=doc.createElement("button"); hit.setAttribute(ATTR_HIT,""); hit.setAttribute("type","button");'
+        + ' hit.className=CLASS_ROOT+"-hit"; root.appendChild(hit); }' + '\n'
+        + '    var text=doc.createElement("span"); text.className=CLASS_ROOT+"-text"; text.textContent=display;' + '\n'
+        + '    hit.innerHTML=""; hit.appendChild(text);' + '\n'
+        + '    var unit=root.getAttribute(ATTR_UNIT);' + '\n'
+        + '    if (unit){ var u=doc.createElement("span"); u.className=CLASS_ROOT+"-unit"; u.textContent=unit; hit.appendChild(u); }' + '\n'
+        + '    if (root.getAttribute(ATTR_AFF)!=="none" && !root.hasAttribute("data-ilife-edit-disabled")){' + '\n'
+        + '      var pen=doc.createElementNS("http://www.w3.org/2000/svg","svg");' + '\n'
+        + '      pen.setAttribute("class",CLASS_ROOT+"-pen"); pen.setAttribute("viewBox","0 0 24 24");' + '\n'
+        + '      pen.setAttribute("width","13"); pen.setAttribute("height","13"); pen.setAttribute("fill","none");' + '\n'
+        + '      pen.setAttribute("stroke","currentColor"); pen.setAttribute("stroke-width","2");' + '\n'
+        + '      pen.setAttribute("stroke-linecap","round"); pen.setAttribute("stroke-linejoin","round");' + '\n'
+        + '      pen.setAttribute("aria-hidden","true");' + '\n'
+        + '      var p1=doc.createElementNS("http://www.w3.org/2000/svg","path"); p1.setAttribute("d","M12 20h9");' + '\n'
+        + '      var p2=doc.createElementNS("http://www.w3.org/2000/svg","path"); p2.setAttribute("d","M16.5 3.5a2.12 2.12 0 0 1 3 3L7 19l-4 1 1-4Z");' + '\n'
+        + '      pen.appendChild(p1); pen.appendChild(p2); hit.appendChild(pen);' + '\n'
+        + '    }' + '\n'
+        + '    root.classList.remove(CLASS_INVALID);' + '\n'
+        + '  }' + '\n'
+        /* 校验：必填／数字（含 min·max·step） */
+        + '  function invalidReason(root, raw){' + '\n'
+        + '    var kind=root.getAttribute(ATTR_KIND)||"text";' + '\n'
+        + '    if (root.getAttribute(ATTR_REQ)==="1" && String(raw).trim()==="") return "必填";' + '\n'
+        + '    if (kind!=="number") return null;' + '\n'
+        + '    if (String(raw).trim()==="") return null;' + '\n'
+        + '    var n=Number(raw); if (!isFinite(n)) return "不是数字";' + '\n'
+        + '    var mn=root.getAttribute(ATTR_MIN), mx=root.getAttribute(ATTR_MAX), st=root.getAttribute(ATTR_STEP);' + '\n'
+        + '    if (mn!==null && n<Number(mn)) return "小于 " + mn;' + '\n'
+        + '    if (mx!==null && n>Number(mx)) return "大于 " + mx;' + '\n'
+        + '    if (st!==null && Number(st)>0){ var base=(mn!==null?Number(mn):0);'
+        + ' if (Math.abs((n-base)/Number(st) - Math.round((n-base)/Number(st))) > 1e-9) return "步长 " + st; }' + '\n'
+        + '    return null;' + '\n'
+        + '  }' + '\n'
+        + '  function close(root){ var f=root.querySelector("."+CLASS_ROOT+"-input,."+CLASS_ROOT+"-select");'
+        + ' if (f) f.remove(); paint(root, root.getAttribute(ATTR_VALUE)||"", root.getAttribute(ATTR_DISPLAY)||""); }' + '\n'
+        /* 打开编辑器：同格、同盒模型 */
+        + '  function open(root){' + '\n'
+        + '    if (root.querySelector("."+CLASS_ROOT+"-input,."+CLASS_ROOT+"-select")) return;' + '\n'
+        + '    var kind=root.getAttribute(ATTR_KIND)||"text";' + '\n'
+        + '    var cur=root.getAttribute(ATTR_VALUE)||"";' + '\n'
+        + '    var hit=root.querySelector("["+ATTR_HIT+"]"); if (hit) hit.style.display="none";' + '\n'
+        + '    var f;' + '\n'
+        + '    if (kind==="select"){' + '\n'
+        + '      f=doc.createElement("select"); f.className=CLASS_ROOT+"-select";' + '\n'
+        + '      var raw=root.getAttribute(ATTR_OPTIONS); var opts=[]; try{ opts=JSON.parse(raw||"[]"); }catch(e){ opts=[]; }' + '\n'
+        + '      for (var i=0;i<opts.length;i+=1){ var o=doc.createElement("option"); o.value=opts[i].value; o.textContent=opts[i].label;'
+        + ' if (opts[i].value===cur) o.selected=true; f.appendChild(o); }' + '\n'
+        + '    } else {' + '\n'
+        + '      f=doc.createElement("input"); f.className=CLASS_ROOT+"-input"; f.type=(kind==="number"?"number":(kind==="date"?"date":"text"));' + '\n'
+        + '      f.value=cur;' + '\n'
+        + '      var ph=root.getAttribute(ATTR_PH); if (ph) f.placeholder=ph;' + '\n'
+        + '      var mn=root.getAttribute(ATTR_MIN); if (mn!==null) f.min=mn;' + '\n'
+        + '      var mx=root.getAttribute(ATTR_MAX); if (mx!==null) f.max=mx;' + '\n'
+        + '      var st=root.getAttribute(ATTR_STEP); if (st!==null) f.step=st;' + '\n'
+        + '    }' + '\n'
+        + '    var label=root.getAttribute(ATTR_LABEL); if (label) f.setAttribute("aria-label", label);' + '\n'
+        + '    root.appendChild(f);' + '\n'
+        + '    f.focus(); if (f.select) { try { f.select(); } catch(e){} }' + '\n'
+        + '  }' + '\n'
+        + '  function commit(root, opts){' + '\n'
+        + '    var f=root.querySelector("."+CLASS_ROOT+"-input,."+CLASS_ROOT+"-select"); if (!f) return;' + '\n'
+        + '    var kind=root.getAttribute(ATTR_KIND)||"text";' + '\n'
+        + '    var raw=(kind==="select") ? f.value : String(f.value);' + '\n'
+        + '    var prev=root.getAttribute(ATTR_VALUE)||"";' + '\n'
+        + '    var reason=invalidReason(root, raw);' + '\n'
+        + '    if (reason!==null){ root.classList.add(CLASS_INVALID); f.setAttribute("aria-invalid","true"); return; }' + '\n'
+        + '    var display=raw;' + '\n'
+        + '    if (kind==="select"){ var raw2=root.getAttribute(ATTR_OPTIONS), opts2=[];'
+        + ' try{ opts2=JSON.parse(raw2||"[]"); }catch(e){ opts2=[]; }' + '\n'
+        + '      for (var i=0;i<opts2.length;i+=1) if (opts2[i].value===raw) display=opts2[i].label; }' + '\n'
+        + '    close(root); paint(root, raw, display);' + '\n'
+        + '    var hit=root.querySelector("["+ATTR_HIT+"]"); if (hit){ hit.style.display=""; if (opts && opts.refocus!==false) hit.focus(); }' + '\n'
+        + '    if (raw!==prev){' + '\n'
+        + '      var ev=new CustomEvent(EV_COMMIT,{bubbles:true,detail:{name:root.getAttribute(ATTR_NAME),'
+        + 'label:root.getAttribute(ATTR_LABEL),value:raw,prev:prev,unit:root.getAttribute(ATTR_UNIT)}});' + '\n'
+        + '      root.dispatchEvent(ev);' + '\n'
+        + '    }' + '\n'
+        + '  }' + '\n'
+        + '  doc.addEventListener("click", function(e){' + '\n'
+        + '    var hit=e.target && e.target.closest ? e.target.closest("["+ATTR_HIT+"]") : null;' + '\n'
+        + '    if (!hit) return;' + '\n'
+        + '    var root=hit.closest("["+ATTR_NAME+"]"); if (!root) return;' + '\n'
+        + '    if (root.hasAttribute("data-ilife-edit-disabled")) return;' + '\n'
+        + '    e.preventDefault(); open(root);' + '\n'
+        + '  });' + '\n'
+        + '  doc.addEventListener("keydown", function(e){' + '\n'
+        + '    var f=e.target; if (!f || !f.classList) return;' + '\n'
+        + '    if (!f.classList.contains(CLASS_ROOT+"-input") && !f.classList.contains(CLASS_ROOT+"-select")) return;' + '\n'
+        + '    var root=f.closest("["+ATTR_NAME+"]"); if (!root) return;' + '\n'
+        + '    if (e.key==="Enter"){ e.preventDefault(); commit(root); }' + '\n'
+        + '    else if (e.key==="Escape"){ e.preventDefault(); var prev=root.getAttribute(ATTR_VALUE)||"";'
+        + ' close(root); var h=root.querySelector("["+ATTR_HIT+"]"); if (h) h.focus();' + '\n'
+        + '      root.dispatchEvent(new CustomEvent(EV_CANCEL,{bubbles:true,detail:{name:root.getAttribute(ATTR_NAME),value:prev}})); }' + '\n'
+        + '  });' + '\n'
+        + '  doc.addEventListener("change", function(e){' + '\n'
+        + '    var f=e.target; if (!f || !f.classList) return;' + '\n'
+        + '    if (!f.classList.contains(CLASS_ROOT+"-select")) return;' + '\n'
+        + '    var root=f.closest("["+ATTR_NAME+"]"); if (root) commit(root);' + '\n'
+        + '  });' + '\n'
+        + '  doc.addEventListener("focusout", function(e){' + '\n'
+        + '    var f=e.target; if (!f || !f.classList) return;' + '\n'
+        + '    if (!f.classList.contains(CLASS_ROOT+"-input")) return;' + '\n'
+        + '    var root=f.closest("["+ATTR_NAME+"]"); if (!root) return;' + '\n'
+        + '    if (e.relatedTarget && root.contains(e.relatedTarget)) return;' + '\n'
+        + '    commit(root,{refocus:false});' + '\n'
+        + '  });' + '\n'
+        + '  for (var i=0;i<nodes().length;i+=1) nodes()[i].setAttribute(ATTR_BOUND,"1");' + '\n'
+        + '}());';
+}
+//# sourceMappingURL=editableValue.js.map

package/dist/editableValue.js.map

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

package/dist/font.js

@@ -9,4 +9,3 @@
  *  `"SF Pro Display"` 提到首位、尾部补 `"Noto Sans SC"`（修 computed 回落到系统的实测）。
  *  等宽栈不在此列（各产出器自己的 `"SF Mono", monospace` 原样保留）。 */
 export const BODY_FONT_STACK = '"SF Pro Display", -apple-system, BlinkMacSystemFont, "PingFang SC", "Microsoft YaHei", "Noto Sans SC", sans-serif';
-//# sourceMappingURL=font.js.map

package/dist/help.d.ts

@@ -1,24 +1,7 @@
-import type { HelpSchemaErrorCode, HelpSchemaErrorShape, HelpShellInput } from './spec/help.js';
-import type { FillTemplateOutput } from './spec/template.js';
-/** 校验失败（形态逐字对齐冻结的 `HelpSchemaErrorShape`：`{ name, code, path, message }`）。
+/** **薄转出**（目录化批次⑥之后本件不再住实现）。
  *
- * **不从 `src/index.ts` 导出**：冻结面 `SPEC_FROZEN_SURFACE` 无该运行时条目，导出会打破
- * 「新增运行时出口恰好等于清单 implemented 的运行时项」出口面锁（与 `TemplateError`／`ControlsError` 同口径，
- * 裁定 R13）。调用方按 `name`／`code`／`path` 判定。
+ *  为什么留着：`dist/help.js` 是既有产物路径，包内与测试都按它取件；
+ *  出口名与改前逐名相同。实现住 `src/components/help/**`；等引用迁走即可删本件。
  */
-export declare class HelpSchemaError extends Error implements HelpSchemaErrorShape {
-    readonly name: 'HelpSchemaError';
-    readonly code: HelpSchemaErrorCode;
-    /** JSON 指针式路径（根为 `/`）。 */
-    readonly path: string;
-    constructor(code: HelpSchemaErrorCode, path: string, message: string);
-}
-/** HELP模板渲染（冻结签名 `(input: HelpShellInput): FillTemplateOutput`）。
- *
- * 次序：**先校验 `sceneData`**（失败抛 `HelpSchemaError`）→ 再拼内置help模板（或 `template` 覆盖）
- * → **一律走 `fillTemplate`**（共享资产与 JSON 载荷由填充器注入，help模板不得自填）。
- *
- * `strict` 原样透传给 `fillTemplate`（契约 §3.5.3「透传」）；`template` 覆盖时按调用方模板填充。
- */
-export declare function renderHelpShell(input: HelpShellInput): FillTemplateOutput;
+export * from './components/help/index.js';
 //# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAyDA,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EAaf,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAyC7D;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAM,YAAW,oBAAoB;IACxE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAqB;IACrD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKrE;AAyiBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAYzE"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,4BAA4B,CAAC"}