base-paint 0.3.13 → 0.3.15

package/dist/components/text/input.js

@@ -0,0 +1,114 @@
+/** text · input
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { fail } from './shared.js';
+import { COPY_FORMATS, SERIALIZABLE_SHAPES } from '../../spec/text.js';
+/* ── 输入形态与校验 ─────────────────────────────────────────── */
+/** 纯对象收窄（数组与 `null` 不算对象）。 */
+export function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+/** 错误文案里的值描述（一码多义由 `message` 辨因，§3.1.2⑤ 同口径）。 */
+export function describeValue(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return '数组';
+    if (typeof value === 'object')
+        return '对象';
+    return typeof value + ' ' + String(value);
+}
+/** `format` 闭集判定（缺省 `text`）；不在 `COPY_FORMATS` 内 → `format-unknown`。 */
+export function resolveFormat(value) {
+    if (value === undefined)
+        return 'text';
+    if (typeof value === 'string' && COPY_FORMATS.indexOf(value) >= 0) {
+        return value;
+    }
+    fail('format-unknown', 'format 不在 COPY_FORMATS 内：' + describeValue(value)
+        + '（允许：' + COPY_FORMATS.join('、') + '）');
+}
+/** `shape` 闭集判定：不在 `SERIALIZABLE_SHAPES`（含 `fallback`）→ `shape-unsupported`。 */
+export function resolveShape(value) {
+    if (typeof value === 'string' && SERIALIZABLE_SHAPES.indexOf(value) >= 0) {
+        return value;
+    }
+    fail('shape-unsupported', 'shape 不进复制文本：' + describeValue(value)
+        + '（可序列化：' + SERIALIZABLE_SHAPES.join('、') + '）');
+}
+/** `title`／`occurredAt` 类型校验（非字符串 → `structure-invalid`；缺省放行）。 */
+export function optionalString(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string') {
+        fail('structure-invalid', field + ' 必须是字符串，实为 ' + describeValue(value));
+    }
+    return value;
+}
+/** 逐 shape 结构校验（判据逐条对齐 `contract:624`，恒以 `EnvelopeDataByShape[shape]` 为准）。
+ *
+ * **不校验** `stat.metrics` 的逐值类型：敏感行包装 `{ text, sensitive: true }` 必须放行
+ * （`contract:612`／`:615`，FX-23），故只判容器形态。
+ */
+export function requireShapeData(shape, value) {
+    const data = asRecord(value);
+    if (data === null) {
+        fail('structure-invalid', shape + ' 形 data 必须是对象，实为 ' + describeValue(value));
+    }
+    switch (shape) {
+        case 'stat':
+            if (asRecord(data.metrics) === null) {
+                fail('structure-invalid', 'stat 形缺 metrics 对象（EnvelopeDataByShape.stat）');
+            }
+            break;
+        case 'list':
+            if (!Array.isArray(data.items)) {
+                fail('structure-invalid', 'list 形 items 必须是数组（EnvelopeDataByShape.list）');
+            }
+            break;
+        case 'detail':
+            if (asRecord(data.item) === null) {
+                fail('structure-invalid', 'detail 形缺 item 对象（EnvelopeDataByShape.detail）');
+            }
+            break;
+        case 'receipt':
+            if (typeof data.ok !== 'boolean' || typeof data.message !== 'string') {
+                fail('structure-invalid', 'receipt 形缺 ok（boolean）／message（string）（EnvelopeDataByShape.receipt）');
+            }
+            break;
+        case 'analysis':
+            if (typeof data.summary !== 'string' || data.summary.length === 0) {
+                fail('structure-invalid', 'analysis 形缺非空 summary（EnvelopeDataByShape.analysis）');
+            }
+            break;
+        default: {
+            // 穷尽性兜底（FX-77-7）：冻结面日后新增可序列化 shape 时**不得静默跳过**校验。
+            const unreached = shape;
+            fail('structure-invalid', '未覆盖的可序列化 shape：' + String(unreached));
+        }
+    }
+    return data;
+}
+/** `copyLog` 形态校验：整体非对象／字段非字符串 → `structure-invalid`（`null`／`undefined` 视同缺失）。 */
+export function resolveCopyLog(value) {
+    if (value === undefined || value === null)
+        return null;
+    const record = asRecord(value);
+    if (record === null) {
+        fail('structure-invalid', 'copyLog 必须是对象，实为 ' + describeValue(value));
+    }
+    for (const [field, fieldValue] of Object.entries(record)) {
+        if (fieldValue === undefined || fieldValue === null)
+            continue;
+        if (typeof fieldValue !== 'string') {
+            fail('structure-invalid', 'copyLog.' + field + ' 必须是字符串，实为 ' + describeValue(fieldValue));
+        }
+    }
+    return record;
+}

package/dist/components/text/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/components/text/input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,YAAY,EAAc,mBAAmB,EAAqB,MAAM,oBAAoB,CAAC;AAEtG,4DAA4D;AAE5D,8BAA8B;AAC9B,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,OAAO,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,YAAkC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzF,OAAO,KAAmB,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC,gBAAgB,EAAE,2BAA2B,GAAG,aAAa,CAAC,KAAK,CAAC;UACrE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,mBAAyC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChG,OAAO,KAA0B,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,mBAAmB,EAAE,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC;UAC5D,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,KAAa;IAC1D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAwB,EAAE,KAAc;IACvE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,mBAAmB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC;IACD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;gBACpC,IAAI,CAAC,mBAAmB,EAAE,8CAA8C,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM;QACR,KAAK,MAAM;YACT,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,mBAAmB,EAAE,8CAA8C,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM;QACR,KAAK,QAAQ;YACX,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBACjC,IAAI,CAAC,mBAAmB,EAAE,+CAA+C,CAAC,CAAC;YAC7E,CAAC;YACD,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACrE,IAAI,CAAC,mBAAmB,EAAE,qEAAqE,CAAC,CAAC;YACnG,CAAC;YACD,MAAM;QACR,KAAK,UAAU;YACb,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClE,IAAI,CAAC,mBAAmB,EAAE,qDAAqD,CAAC,CAAC;YACnF,CAAC;YACD,MAAM;QACR,OAAO,CAAC,CAAC,CAAC;YACR,kDAAkD;YAClD,MAAM,SAAS,GAAU,KAAK,CAAC;YAC/B,IAAI,CAAC,mBAAmB,EAAE,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,IAAI,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI;YAAE,SAAS;QAC9D,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,KAAK,GAAG,aAAa,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/components/text/log.d.ts

@@ -0,0 +1,12 @@
+/** text · log
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { LogSection, SerializableShape } from '../../spec/text.js';
+/** 6 段文本：`scene` 由 envelope 派生，其余 5 段取 `CopyLogFields`（字段名从 `LOG_SECTION_SOURCES` 派生）。
+ *  缺失（未给／非字符串／空串）→ `null`，由各 format 自行落空值口径。 */
+export declare function logTexts(envelope: Record<string, unknown>, shape: SerializableShape, copyLog: Record<string, unknown> | null): Record<LogSection, string | null>;
+//# sourceMappingURL=log.d.ts.map

package/dist/components/text/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/components/text/log.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAqC,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAItG;gDACgD;AAChD,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACtC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC,CAcnC"}

package/dist/components/text/log.js

@@ -0,0 +1,28 @@
+/** text · log
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { sceneText } from './rows.js';
+import { ENVELOPE_SOURCE } from './shared.js';
+import { LOG_SECTIONS, LOG_SECTION_SOURCES } from '../../spec/text.js';
+/* ── 6 段日志 ───────────────────────────────────────────────── */
+/** 6 段文本：`scene` 由 envelope 派生，其余 5 段取 `CopyLogFields`（字段名从 `LOG_SECTION_SOURCES` 派生）。
+ *  缺失（未给／非字符串／空串）→ `null`，由各 format 自行落空值口径。 */
+export function logTexts(envelope, shape, copyLog) {
+    const out = {};
+    for (const section of LOG_SECTIONS) {
+        const source = LOG_SECTION_SOURCES[section];
+        if (source === ENVELOPE_SOURCE) {
+            out[section] = sceneText(envelope, shape);
+            continue;
+        }
+        const dot = source.indexOf('.');
+        const field = dot >= 0 ? source.slice(dot + 1) : source;
+        const value = copyLog === null ? undefined : copyLog[field];
+        out[section] = typeof value === 'string' && value !== '' ? value : null;
+    }
+    return out;
+}

package/dist/components/text/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/components/text/log.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAiC,MAAM,oBAAoB,CAAC;AAEtG,gEAAgE;AAEhE;gDACgD;AAChD,MAAM,UAAU,QAAQ,CACtB,QAAiC,EACjC,KAAwB,EACxB,OAAuC;IAEvC,MAAM,GAAG,GAAG,EAAuC,CAAC;IACpD,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;YAC/B,GAAG,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACxD,MAAM,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5D,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/components/text/rows.d.ts

@@ -0,0 +1,27 @@
+/** text · rows
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { DataRows } from './shared.js';
+import { DataProjectionSpec, SerializableShape } from '../../spec/text.js';
+/** 敏感行判定：只看 `SENSITIVE_ROW_RULE.flagField` 是否为**字面** `flagValue`（非真值判定）。 */
+export declare function isSensitive(value: unknown): boolean;
+export declare function dataRows(projection: DataProjectionSpec, data: Record<string, unknown>, empty: string): DataRows;
+/** `text` 口径：行内换行（CR／LF）替换为空格（`contract:608`）。 */
+export declare function sanitizeLine(text: string): string;
+/** 输出头：`DataTextInput.title` 非空时覆盖，否则 `TEXT_HEADER_TEMPLATE` **单趟**展开。
+ *
+ *  - 替换位从模板本身派生（`{字段}` → `envelope[字段]`），**无第二份字段清单**（FX-77-8）。
+ *  - **单趟**：插入的值不再被扫描（`skill: '{key}'` → `【{key} KK】`，不二次展开，FX-77-8）。
+ *  - 空串 `title` 视同缺省（FX-77-6）：输出头行恒存在、恒非空（模板含 `【】` 与 ` · `，
+ *    `skill`／`key` 为空／非字符串时按空串替换，得 `【 】`）。
+ */
+export declare function headerLine(envelope: Record<string, unknown>, title: string | undefined): string;
+/** `scene` 段：恒由 envelope 派生（`contract:595`）。
+ * 甲幂等（#555）：`key` 已以 `skill + '.'` 开头不再重复补技能名；
+ * 不带前缀仍补足，两种给法输出同一形状。 */
+export declare function sceneText(envelope: Record<string, unknown>, shape: SerializableShape): string;
+//# sourceMappingURL=rows.d.ts.map

package/dist/components/text/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../src/components/text/rows.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAM,QAAQ,EAAe,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAsB,iBAAiB,EAAwB,MAAM,oBAAoB,CAAC;AAIrH,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGnD;AAsCD,wBAAgB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE/G;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AASD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAY/F;AAED;;yBAEyB;AACzB,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAK7F"}

package/dist/components/text/rows.js

@@ -0,0 +1,100 @@
+/** text · rows
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { stringifyJson } from './formats.js';
+import { asRecord } from './input.js';
+import { CR, LF } from './shared.js';
+import { SENSITIVE_ROW_RULE, TEXT_HEADER_TEMPLATE } from '../../spec/text.js';
+/* ── 行文本渲染（一行 = 一个投影值） ─────────────────────────── */
+/** 敏感行判定：只看 `SENSITIVE_ROW_RULE.flagField` 是否为**字面** `flagValue`（非真值判定）。 */
+export function isSensitive(value) {
+    const record = asRecord(value);
+    return record !== null && record[SENSITIVE_ROW_RULE.flagField] === SENSITIVE_ROW_RULE.flagValue;
+}
+/** 单值 → 文本（三 format 共用的「值文本化」口径；空值文本由调用方按 format 传入）。 */
+function valueText(value, empty) {
+    if (value === null || value === undefined)
+        return empty;
+    if (typeof value === 'string')
+        return value === '' ? empty : value;
+    if (typeof value === 'object') {
+        const text = stringifyJson(value, '投影值');
+        return text === undefined ? empty : text;
+    }
+    return String(value);
+}
+/** 投影值 → 一行（敏感行整行恒为 `mask`，不带键名）。 */
+function rowOf(value, label, empty) {
+    if (isSensitive(value))
+        return { text: SENSITIVE_ROW_RULE.mask, sensitive: true };
+    const text = valueText(value, empty);
+    return { text: label === null ? text : label + ': ' + text, sensitive: false };
+}
+/** 主体行：字段值按 `EnvelopeDataByShape` 的形态推导展开策略，字段名恒取投影表。 */
+function bodyRows(projection, data, empty) {
+    const value = data[projection.body];
+    if (Array.isArray(value))
+        return value.map((item) => rowOf(item, null, empty));
+    const map = asRecord(value);
+    if (map !== null)
+        return Object.entries(map).map(([key, item]) => rowOf(item, key, empty));
+    return [rowOf(value, projection.body, empty)];
+}
+/** 收尾行：`tail` 为 `null` 或该字段**缺省**（`undefined`）→ 省略，不报错（U1 定案）；
+ *  显式 `null` 是「空值」而非「缺省」，按各 format 的空值口径渲染（text 占位符／json `null`／csv 空串）。 */
+function tailRow(projection, data, empty) {
+    if (projection.tail === null)
+        return null;
+    const value = data[projection.tail];
+    if (value === undefined)
+        return null;
+    return rowOf(value, projection.tail, empty);
+}
+export function dataRows(projection, data, empty) {
+    return { body: bodyRows(projection, data, empty), tail: tailRow(projection, data, empty) };
+}
+/** `text` 口径：行内换行（CR／LF）替换为空格（`contract:608`）。 */
+export function sanitizeLine(text) {
+    return text.split(CR).join(' ').split(LF).join(' ');
+}
+/* ── 输出头与 scene 段 ─────────────────────────────────────── */
+/** 非字符串字段按空串渲染（`text` 口径的人类可读面，避免出现 `undefined`）。 */
+function fieldText(value) {
+    return typeof value === 'string' ? value : '';
+}
+/** 输出头：`DataTextInput.title` 非空时覆盖，否则 `TEXT_HEADER_TEMPLATE` **单趟**展开。
+ *
+ *  - 替换位从模板本身派生（`{字段}` → `envelope[字段]`），**无第二份字段清单**（FX-77-8）。
+ *  - **单趟**：插入的值不再被扫描（`skill: '{key}'` → `【{key} KK】`，不二次展开，FX-77-8）。
+ *  - 空串 `title` 视同缺省（FX-77-6）：输出头行恒存在、恒非空（模板含 `【】` 与 ` · `，
+ *    `skill`／`key` 为空／非字符串时按空串替换，得 `【 】`）。
+ */
+export function headerLine(envelope, title) {
+    if (title !== undefined && title !== '')
+        return title;
+    let out = '';
+    let rest = TEXT_HEADER_TEMPLATE;
+    for (;;) {
+        const open = rest.indexOf('{');
+        if (open < 0)
+            return out + rest;
+        const close = rest.indexOf('}', open + 1);
+        if (close < 0)
+            return out + rest;
+        out += rest.slice(0, open) + fieldText(envelope[rest.slice(open + 1, close)]);
+        rest = rest.slice(close + 1);
+    }
+}
+/** `scene` 段：恒由 envelope 派生（`contract:595`）。
+ * 甲幂等（#555）：`key` 已以 `skill + '.'` 开头不再重复补技能名；
+ * 不带前缀仍补足，两种给法输出同一形状。 */
+export function sceneText(envelope, shape) {
+    const skill = fieldText(envelope.skill);
+    const key = fieldText(envelope.key);
+    const head = skill !== '' && key.indexOf(skill + '.') === 0 ? key : skill + '.' + key;
+    return head + '（' + shape + '）';
+}

package/dist/components/text/rows.js.map

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

package/dist/components/text/shared.d.ts

@@ -0,0 +1,35 @@
+/** text · shared
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { TextErrorCode } from '../../spec/text.js';
+export declare class TextError extends Error {
+    /** 逐字对齐 `TextErrorShape.name`。 */
+    readonly name = "TextError";
+    readonly code: TextErrorCode;
+    constructor(code: TextErrorCode, message: string);
+}
+/** 抛错并收窄控制流（`never` 返回，便于 TS 在断言后收窄）。 */
+export declare function fail(code: TextErrorCode, message: string): never;
+export declare const LF: string;
+export declare const CR: string;
+/** 时间行前缀（契约未规定文案；沿用旧基线 `base.js:254` 的 `'时间: '`，见 §3.4 行为补遗）。 */
+export declare const TIME_LABEL = "\u65F6\u95F4: ";
+/** `csv` 口径的空值（`contract:610`：机器可读，写空字符串、不写占位符）。 */
+export declare const CSV_EMPTY = "";
+/** 「由 envelope 派生」的段源哨兵：恒读冻结常量 `LOG_SECTION_SOURCES.scene`，不写第二份字面量。 */
+export declare const ENVELOPE_SOURCE: string;
+/** 一行文本 ＋ 是否敏感行（敏感行的 `text` 恒为 `SENSITIVE_ROW_RULE.mask`）。 */
+export interface TextRow {
+    readonly text: string;
+    readonly sensitive: boolean;
+}
+/** 投影行分组：主体行（投影表 `body`）＋ 至多一条收尾行（投影表 `tail`）。 */
+export interface DataRows {
+    readonly body: readonly TextRow[];
+    readonly tail: TextRow | null;
+}
+//# sourceMappingURL=shared.d.ts.map

package/dist/components/text/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/components/text/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAuB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExE,qBAAa,SAAU,SAAQ,KAAK;IAClC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAEjB,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;CAIjD;AAED,yCAAyC;AACzC,wBAAgB,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAEhE;AAED,eAAO,MAAM,EAAE,QAA0B,CAAC;AAC1C,eAAO,MAAM,EAAE,QAA0B,CAAC;AAC1C,iEAAiE;AACjE,eAAO,MAAM,UAAU,mBAAS,CAAC;AACjC,oDAAoD;AACpD,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,MAAkC,CAAC;AAEjE,8DAA8D;AAC9D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B"}

package/dist/components/text/shared.js

@@ -0,0 +1,29 @@
+/** text · shared
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { LOG_SECTION_SOURCES } from '../../spec/text.js';
+export class TextError extends Error {
+    /** 逐字对齐 `TextErrorShape.name`。 */
+    name = 'TextError';
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+/** 抛错并收窄控制流（`never` 返回，便于 TS 在断言后收窄）。 */
+export function fail(code, message) {
+    throw new TextError(code, message);
+}
+export const LF = String.fromCharCode(10);
+export const CR = String.fromCharCode(13);
+/** 时间行前缀（契约未规定文案；沿用旧基线 `base.js:254` 的 `'时间: '`，见 §3.4 行为补遗）。 */
+export const TIME_LABEL = '时间: ';
+/** `csv` 口径的空值（`contract:610`：机器可读，写空字符串、不写占位符）。 */
+export const CSV_EMPTY = '';
+/** 「由 envelope 派生」的段源哨兵：恒读冻结常量 `LOG_SECTION_SOURCES.scene`，不写第二份字面量。 */
+export const ENVELOPE_SOURCE = LOG_SECTION_SOURCES.scene;

package/dist/components/text/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/components/text/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAiB,MAAM,oBAAoB,CAAC;AAExE,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,kCAAkC;IACzB,IAAI,GAAG,WAAW,CAAC;IACnB,IAAI,CAAgB;IAE7B,YAAY,IAAmB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,UAAU,IAAI,CAAC,IAAmB,EAAE,OAAe;IACvD,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAC1C,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AACjC,oDAAoD;AACpD,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAW,mBAAmB,CAAC,KAAK,CAAC"}

package/dist/components/timer-card/attrs.d.ts

@@ -0,0 +1,99 @@
+/** timer-card · **标记契约**（渲染与运行时共用的唯一事实：类名／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-06-状态与台账.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「卡式大数字」**——剩余时间当卡上的主读数（大数字 ＋ 进度条 ＋ 已过／还剩），
+ *  底下开始／暂停／重置，并写明"这一锅在等什么"。等的那几分钟（私家大厨）与运动计时（卡路里）都用它。
+ *
+ *  **它是交互件（真计时）**：状态机（待开始 → 计时中 ⇄ 已暂停 → 到点了）走 `runtime.ts` 产出的 JS 文本，
+ *  按 `Date.now()` 记账（不是数 tick 次数 ⇒ 标签页被节流也不漂）。标记与运行时只通过本文件的名字耦合。
+ *
+ *  状态一样是「字 ＋ 形 ＋ 色」：状态字（待开始／计时中／已暂停／到点了）＋ 标签形状（底线／实底／描边／双线框）。
+ */
+export declare const TIMER_CARD_CLASS = "ilife-block-timer-card";
+/** 槽位闭集（数组里带注释 ⇒ 不会被当成"形态闭集"）。 */
+export declare const TIMER_CARD_SLOTS: readonly ["head", "title", "tag", "display", "display-value", "display-unit", "bar", "bar-fill", "readouts", "hint", "acts", "button", "error", "absent"];
+export type TimerCardSlot = (typeof TIMER_CARD_SLOTS)[number];
+/** 类名根。 */
+export declare function timerCardClass(prefix?: string): string;
+/** 槽类的唯一拼法。 */
+export declare function timerCardSlot(slot: TimerCardSlot, prefix?: string): string;
+/** 形态闭集：本件只落地形态 A「卡式大数字」。 */
+export declare const TIMER_CARD_FORMS: readonly ["card"];
+export type TimerCardForm = (typeof TIMER_CARD_FORMS)[number];
+/** 状态闭集：待开始 → 计时中 ⇄ 已暂停 → 到点了。闭集外的值一律 `badInput`。 */
+export declare const TIMER_STATES: readonly ["idle", "running", "paused", "done"];
+export type TimerState = (typeof TIMER_STATES)[number];
+/** 状态字（四态各有自己的标签形状，见 `style.ts`；也是运行时换的那个词）。 */
+export declare const TIMER_STATE_WORDS: Readonly<Record<TimerState, string>>;
+/** 主按钮在各状态下的字（**同一个按钮原地换字**；宽度由 `TIMER_CARD_BUTTON_MIN_WIDTH_PX` 锁住）。 */
+export declare const TIMER_PRIMARY_LABELS: Readonly<Record<TimerState, string>>;
+/** 第二个按钮的字。 */
+export declare const TIMER_RESET_LABEL = "\u91CD\u7F6E";
+/** 正在处理时主按钮上的字（原地换字，宽度不跳）。 */
+export declare const TIMER_LOADING_LABEL = "\u5F00\u59CB\u4E2D\u2026";
+/** 还没设时长时显示的那个记号（缺值写法：写 `—`，不写 0、不留空）。 */
+export declare const TIMER_CARD_MISSING = "\u2014";
+/** 还没设时长时那句话（调用方可以覆盖）。 */
+export declare const TIMER_CARD_EMPTY_LINE = "\u8FD8\u6CA1\u8BBE\u65F6\u957F\uFF1A\u5148\u5B9A\u4E00\u4E2A\u518D\u8BA1\u65F6";
+/** 行的机器键（**运行时的发现锚**：`[data-ilife-timer]` 即一张计时卡）。 */
+export declare const TIMER_KEY_ATTR = "data-ilife-timer";
+/** 状态（`idle`／`running`／`paused`／`done`）：**运行时写的唯一事实**，页面按它判断。 */
+export declare const TIMER_STATE_ATTR = "data-ilife-timer-state";
+/** 剩余毫秒（运行时每次心跳写它；暂停时它就是冻结的那个值）。 */
+export declare const TIMER_REMAIN_ATTR = "data-ilife-timer-remaining-ms";
+/** 总毫秒（渲染时定下，从不改）。 */
+export declare const TIMER_TOTAL_ATTR = "data-ilife-timer-total-ms";
+/** 大数字节点（运行时按它换字）。 */
+export declare const TIMER_DISPLAY_ATTR = "data-ilife-timer-display";
+/** 进度条填充（运行时只动它的 `transform: scaleX()`）。 */
+export declare const TIMER_BAR_ATTR = "data-ilife-timer-bar";
+/** 状态标签节点（运行时按它换字与换形状类）。 */
+export declare const TIMER_TAG_ATTR = "data-ilife-timer-tag";
+/** 已过读数节点（运行时按它换字）。 */
+export declare const TIMER_ELAPSED_ATTR = "data-ilife-timer-elapsed";
+/** 还剩读数节点（运行时按它换字）。 */
+export declare const TIMER_REST_ATTR = "data-ilife-timer-rest";
+/** 动作按钮（值＝动作键：`toggle`／`reset`）。 */
+export declare const TIMER_ACT_ATTR = "data-ilife-timer-act";
+/** 整卡禁用（按钮按不动，`cursor:not-allowed`；为什么写在卡上）。 */
+export declare const TIMER_DISABLED_ATTR = "data-ilife-timer-disabled";
+/** 正在处理（主按钮换成 `TIMER_LOADING_LABEL` ＋ `aria-busy`）。 */
+export declare const TIMER_BUSY_ATTR = "data-ilife-timer-busy";
+/** 绑定完成标记（运行时幂等：重复注入只绑一次）。 */
+export declare const TIMER_BOUND_ATTR = "data-ilife-timer-bound";
+/** 动作键闭集：主按钮（开始／暂停／继续／重新开始按状态定）与重置。 */
+export declare const TIMER_ACTS: readonly ["toggle", "reset"];
+export type TimerAct = (typeof TIMER_ACTS)[number];
+/** 心跳（毫秒）：运行时的驱动间隔，也是判据里的读数。 */
+export declare const TIMER_CARD_TICK_MS = 250;
+/** 状态变化事件（冒泡 `CustomEvent`，`detail = { key, state, remainingMs, totalMs }`）。 */
+export declare const TIMER_EVENT_STATE = "ilife:timer-state";
+/** 到点了事件（冒泡 `CustomEvent`，`detail` 同上，`state = 'done'`）。 */
+export declare const TIMER_EVENT_DONE = "ilife:timer-done";
+export interface TimerCardInput {
+    /** 机器键（同页唯一；运行时按它派发）。必填非空。 */
+    readonly key: string;
+    /** 这一锅／这一组是什么（`第 3 步 · 煸炒五花肉`）。必填非空。 */
+    readonly title: string;
+    /** 总时长（秒）。**必填**：`0` ＝ 还没设时长（走空态：大数字写 `—`、按钮按不动）。 */
+    readonly totalSeconds: number;
+    /** 已过（秒）：缺省 0；必须 ≥0 且 ≤ `totalSeconds`。 */
+    readonly elapsedSeconds?: number;
+    /** 初始状态（缺省 `idle`）；`totalSeconds` 为 0 时只许 `idle`。 */
+    readonly state?: TimerState;
+    /** 一句人话提示（`这一步结束后紧接着下豆豉`）。 */
+    readonly hint?: string;
+    /** 错态（`没连上：再试一次`）：写在按钮旁边 ＋ `aria-describedby` 指过去。 */
+    readonly error?: string;
+    /** 正在处理（主按钮原地换字，宽度锁住）。 */
+    readonly loading?: boolean;
+    /** 整卡禁用（按钮按不动；为什么写在卡上）。 */
+    readonly disabled?: boolean;
+    /** 空态（`totalSeconds` 为 0）时那句话；缺省 `TIMER_CARD_EMPTY_LINE`。 */
+    readonly absentLine?: string;
+    /** 形态键（闭集，缺省 `card`）。 */
+    readonly form?: TimerCardForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/timer-card/attrs.d.ts.map

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

package/dist/components/timer-card/attrs.js

@@ -0,0 +1,97 @@
+/** timer-card · **标记契约**（渲染与运行时共用的唯一事实：类名／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-06-状态与台账.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「卡式大数字」**——剩余时间当卡上的主读数（大数字 ＋ 进度条 ＋ 已过／还剩），
+ *  底下开始／暂停／重置，并写明"这一锅在等什么"。等的那几分钟（私家大厨）与运动计时（卡路里）都用它。
+ *
+ *  **它是交互件（真计时）**：状态机（待开始 → 计时中 ⇄ 已暂停 → 到点了）走 `runtime.ts` 产出的 JS 文本，
+ *  按 `Date.now()` 记账（不是数 tick 次数 ⇒ 标签页被节流也不漂）。标记与运行时只通过本文件的名字耦合。
+ *
+ *  状态一样是「字 ＋ 形 ＋ 色」：状态字（待开始／计时中／已暂停／到点了）＋ 标签形状（底线／实底／描边／双线框）。
+ */
+export const TIMER_CARD_CLASS = 'ilife-block-timer-card';
+/** 槽位闭集（数组里带注释 ⇒ 不会被当成"形态闭集"）。 */
+export const TIMER_CARD_SLOTS = [
+    'head',
+    'title',
+    'tag',
+    'display',
+    'display-value',
+    'display-unit',
+    'bar',
+    'bar-fill',
+    'readouts',
+    'hint',
+    'acts',
+    'button',
+    'error',
+    'absent',
+];
+/** 类名根。 */
+export function timerCardClass(prefix = 'ilife-') {
+    return prefix + 'block-timer-card';
+}
+/** 槽类的唯一拼法。 */
+export function timerCardSlot(slot, prefix = 'ilife-') {
+    return timerCardClass(prefix) + '-' + slot;
+}
+/** 形态闭集：本件只落地形态 A「卡式大数字」。 */
+export const TIMER_CARD_FORMS = ['card'];
+/** 状态闭集：待开始 → 计时中 ⇄ 已暂停 → 到点了。闭集外的值一律 `badInput`。 */
+export const TIMER_STATES = ['idle', 'running', 'paused', 'done'];
+/** 状态字（四态各有自己的标签形状，见 `style.ts`；也是运行时换的那个词）。 */
+export const TIMER_STATE_WORDS = Object.freeze({
+    idle: '待开始',
+    running: '计时中',
+    paused: '已暂停',
+    done: '到点了',
+});
+/** 主按钮在各状态下的字（**同一个按钮原地换字**；宽度由 `TIMER_CARD_BUTTON_MIN_WIDTH_PX` 锁住）。 */
+export const TIMER_PRIMARY_LABELS = Object.freeze({
+    idle: '开始',
+    running: '暂停',
+    paused: '继续',
+    done: '重新开始',
+});
+/** 第二个按钮的字。 */
+export const TIMER_RESET_LABEL = '重置';
+/** 正在处理时主按钮上的字（原地换字，宽度不跳）。 */
+export const TIMER_LOADING_LABEL = '开始中…';
+/** 还没设时长时显示的那个记号（缺值写法：写 `—`，不写 0、不留空）。 */
+export const TIMER_CARD_MISSING = '—';
+/** 还没设时长时那句话（调用方可以覆盖）。 */
+export const TIMER_CARD_EMPTY_LINE = '还没设时长：先定一个再计时';
+/** 行的机器键（**运行时的发现锚**：`[data-ilife-timer]` 即一张计时卡）。 */
+export const TIMER_KEY_ATTR = 'data-ilife-timer';
+/** 状态（`idle`／`running`／`paused`／`done`）：**运行时写的唯一事实**，页面按它判断。 */
+export const TIMER_STATE_ATTR = 'data-ilife-timer-state';
+/** 剩余毫秒（运行时每次心跳写它；暂停时它就是冻结的那个值）。 */
+export const TIMER_REMAIN_ATTR = 'data-ilife-timer-remaining-ms';
+/** 总毫秒（渲染时定下，从不改）。 */
+export const TIMER_TOTAL_ATTR = 'data-ilife-timer-total-ms';
+/** 大数字节点（运行时按它换字）。 */
+export const TIMER_DISPLAY_ATTR = 'data-ilife-timer-display';
+/** 进度条填充（运行时只动它的 `transform: scaleX()`）。 */
+export const TIMER_BAR_ATTR = 'data-ilife-timer-bar';
+/** 状态标签节点（运行时按它换字与换形状类）。 */
+export const TIMER_TAG_ATTR = 'data-ilife-timer-tag';
+/** 已过读数节点（运行时按它换字）。 */
+export const TIMER_ELAPSED_ATTR = 'data-ilife-timer-elapsed';
+/** 还剩读数节点（运行时按它换字）。 */
+export const TIMER_REST_ATTR = 'data-ilife-timer-rest';
+/** 动作按钮（值＝动作键：`toggle`／`reset`）。 */
+export const TIMER_ACT_ATTR = 'data-ilife-timer-act';
+/** 整卡禁用（按钮按不动，`cursor:not-allowed`；为什么写在卡上）。 */
+export const TIMER_DISABLED_ATTR = 'data-ilife-timer-disabled';
+/** 正在处理（主按钮换成 `TIMER_LOADING_LABEL` ＋ `aria-busy`）。 */
+export const TIMER_BUSY_ATTR = 'data-ilife-timer-busy';
+/** 绑定完成标记（运行时幂等：重复注入只绑一次）。 */
+export const TIMER_BOUND_ATTR = 'data-ilife-timer-bound';
+/** 动作键闭集：主按钮（开始／暂停／继续／重新开始按状态定）与重置。 */
+export const TIMER_ACTS = ['toggle', 'reset'];
+/** 心跳（毫秒）：运行时的驱动间隔，也是判据里的读数。 */
+export const TIMER_CARD_TICK_MS = 250;
+/** 状态变化事件（冒泡 `CustomEvent`，`detail = { key, state, remainingMs, totalMs }`）。 */
+export const TIMER_EVENT_STATE = 'ilife:timer-state';
+/** 到点了事件（冒泡 `CustomEvent`，`detail` 同上，`state = 'done'`）。 */
+export const TIMER_EVENT_DONE = 'ilife:timer-done';

package/dist/components/timer-card/attrs.js.map

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