skill-bill 0.1.0 → 0.2.0

package/dist/shared/commandSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandSpec.js","sourceRoot":"","sources":["../../src/shared/commandSpec.ts"],"names":[],"mappings":""}

package/dist/shared/copyArea.d.ts

@@ -0,0 +1,51 @@
+import type { CopyLogFields, DataTextInput, LogTextInput } from 'base-paint';
+/** 本次执行时刻串（页面入参 `actionAt`／回执事实 `actionAt` 的**唯一定义地**）：本地时钟 `YYYY-MM-DD HH:MM:SS`。
+ *  写域与查询域两张页都读它——搬迁前它分别是 `src/record/write.ts` 的文件级函数与查询域现取的钟，
+ *  第二个用法（查询域列表页，票 #411）长出来之后收成这一处；**取时钟仍在各域处理体那一步调它**，
+ *  共用位不自己在模块顶层取时钟（那样一次调用两次读数会不一致）。 */
+export declare function actionStamp(): string;
+/** `copyArea` 的可填位：给了什么出什么，0–3 颗按钮。 */
+interface CopyAreaInput {
+    /** 给了就出「prompt 预览块 ＋ 复制按钮」。 */
+    readonly prompt?: string | {
+        readonly text: string;
+        readonly label?: string;
+    };
+    /** 给了就出「复制数据」（三格式菜单），内部走 `buildDataText`。 */
+    readonly data?: DataTextInput;
+    /** 给了就出「复制日志」，内部走 `buildLogText`。 */
+    readonly log?: LogTextInput;
+    /** 三样全没给时的那句话（缺省也有一句，见 `COPY_EMPTY_TEXT`）。 */
+    readonly emptyText?: string;
+}
+/** 复制日志的入参：本次执行的过程证据（第 1 段「场景标识」由 envelope 派生，不在这里填）。 */
+interface CopyLogInput {
+    /** 渲染本页（或写库）的命令原文，可照抄重跑。 */
+    readonly command: string;
+    /** 本次数据来源（第 3 段），如「biscuit_accountant.db · bills（写库回执）」；库文件名由调用方给。 */
+    readonly source?: string;
+    /** 写库那一行的过程说明（第 4 段后半，如「影响 1 行 · 字段 category」）。 */
+    readonly detail?: string;
+    /** 时间戳（第 5 段）：**必填，本件不自己取时钟**——共用位不反向依赖页面装配那一层，时间戳由页面层供给。 */
+    readonly actionAt: string;
+    /** 文档版本（第 5 段后半）；不给则不写这半句。 */
+    readonly version?: string;
+}
+/** ① 复制 prompt 区：prompt 预览（`renderPreBlock`）＋ 它自带的复制按钮。
+ *  **`actionId` 必给**：公共层的 `renderPreBlock` 只在给了 `actionId` 时才渲染复制按钮
+ *  （`packages/base-render/src/blocks.ts:729-736`），只给 `copyText` 会出一个「写着复制、其实没有按钮」的
+ *  有标签没按钮位——那正是本票线上实测发现的一处，本件补齐。
+ *  第二参可选：不给＝小标题「复制给助手：这一句可以直接复制」；`null`＝不出小标题；给字符串就用它。 */
+export declare function promptCopyArea(prompt: string, label?: string | null): string;
+/** ② 复制区：prompt／数据／日志给了什么出什么；三样全不给＝一句空态、**不出按钮**。 */
+export declare function copyArea(input: CopyAreaInput): string;
+/** ③ 复制日志的第 2–6 段入参：本页由哪条命令渲染、数据从哪来、写了多少行、什么时候。 */
+export declare function copyLog(input: CopyLogInput): CopyLogFields;
+/** ④ 回执页退出口：危险色出口标记 ＋ 一句去向说明（t407 根因整改二 D2 去重后）。
+ *  改前这里另带一枚「复制数据」（撤销指令直拷，`ilife-exit-undo-copy`）＋ base #336
+ *  自动补的一枚置灰「复制日志」，与下面复制区那组「复制数据／复制日志」上下重复。
+ *  改后退出口只留标记与说明、不带任何复制按钮与 `data-t`；撤销指令走下面复制区那颗
+ *  「复制数据」（复制载荷里仍带可重跑命令，`data-t` 形状不动）。 */
+export declare function undoExit(recordId: number): string;
+export {};
+//# sourceMappingURL=copyArea.d.ts.map

package/dist/shared/copyArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyArea.d.ts","sourceRoot":"","sources":["../../src/shared/copyArea.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS7E;;;sCAGsC;AACtC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAKD,uCAAuC;AACvC,UAAU,aAAa;IACrB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,yDAAyD;AACzD,UAAU,YAAY;IACpB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD;;;;0DAI0D;AAC1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAS5E;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAiBrD;AAuBD,mDAAmD;AACnD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAQ1D;AAQD;;;;0CAI0C;AAC1C,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/shared/copyArea.js

@@ -0,0 +1,122 @@
+/** 复制与提示共用件：复制 prompt 区、复制区（数据位＋日志位）、复制日志的入参。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/record/`——写入域：过程型采集页（复制 prompt 区 ＋ 复制数据／日志）与结果型回执整页（复制数据／日志）；
+ *   ② `src/query/`——查询域：通用查询列表页的复制数据／日志两条通道（不设 prompt 区——查询不写库，没有要交回助手的一句）。
+ *  （写域 32 份产物按本件的字面量冻结，查询域只引用、不改这里的任何一句。）
+ *
+ * 三件东西**只接线、不重造**：
+ *   ① 复制按钮与区块 → `base-paint/blocks` 的 `renderPreBlock`（带 `copyText` 自带复制按钮）与 `renderCopyBlock`；
+ *   ② 复制文本 → `base-paint` 的 `buildDataText`（数据投影）／`buildLogText`（六段日志）；
+ *   ③ 复制成功与失败的提示 → 页面运行时 `buildSharedHelpersJs` 自带（本文件不产第二条提示通道）。
+ *
+ * 口径出处：照 `packages/skill-calorie/src/shared/copyArea.ts`（照结构，不照文件）。
+ *   两处按饼干的情形改了口径：
+ *   - 卡路里的 `promptCopyArea` 走它包内的 `render/copy.js`（`copyActionHtml`，缺省文案是卡路里说法）；
+ *     本件改走 base 现成组件的 `renderPreBlock({copyText})`——**不新增 base 组件、不动别包**，
+ *     复制按钮与逻辑全在 base 侧；
+ *   - 日志第 3 段的库文件名**由调用方给**（`CopyLogInput.source`），共用件不取本包文件名
+ *     （`docs/skills/skill-bill/t406-共用件依赖与提升改造清单.md` 第二节 `DB_FILENAME` 行）。
+ */
+import { renderCaliberLine, renderCopyBlock, renderEmptyBlock, renderPreBlock } from 'base-paint/blocks';
+import { buildDataText, buildLogText } from 'base-paint';
+/** 日志第 2 段（助手思考链）：本仓页面一律由本地 CLI 渲染，不落 `(未知)` 占位。 */
+const LOG_THINKING = '本页由本地渲染，无助手链';
+/** 日志第 6 段（异常）：正常产出即「无」。 */
+const LOG_EXCEPTION = '无';
+/** 复制区空态缺省句（三样全没给时出这一句、不出按钮——点了没反应的死按钮就是问题）。 */
+const COPY_EMPTY_TEXT = '本页没有可复制的数据';
+/** 本次执行时刻串（页面入参 `actionAt`／回执事实 `actionAt` 的**唯一定义地**）：本地时钟 `YYYY-MM-DD HH:MM:SS`。
+ *  写域与查询域两张页都读它——搬迁前它分别是 `src/record/write.ts` 的文件级函数与查询域现取的钟，
+ *  第二个用法（查询域列表页，票 #411）长出来之后收成这一处；**取时钟仍在各域处理体那一步调它**，
+ *  共用位不自己在模块顶层取时钟（那样一次调用两次读数会不一致）。 */
+export function actionStamp() {
+    return new Date().toISOString().slice(0, 19).replace('T', ' ');
+}
+/** 复制数据三格式菜单里三项的用途提示（纯文本／JSON／CSV，顺序＝`COPY_FORMATS`）。
+ *  格式名保留（那是数据格式本来的样子，不是内部标识），只说清它拿去做什么。 */
+const MENU_HINTS = ['纯文本 粘贴给助手或自己看', 'JSON 结构化存档', 'CSV 表格导入'];
+/** 复制 prompt 区那段 prompt 的复制按钮动作号（固定一枚：同页只出一次 prompt 区）。
+ *  小标题缺省那句 `复制 prompt（必走）` 里的 `prompt` 不上屏（本轮整改）——改「复制给助手：这一句可以直接复制」
+ *  （总则②：写清这块复制走给谁；仍含老字串，护栏不断言全等只认包含）。 */
+const PROMPT_COPY_ACTION = 'ilife-copy-prompt';
+const PROMPT_COPY_HINT = '复制给助手：这一句可以直接复制';
+/** ① 复制 prompt 区：prompt 预览（`renderPreBlock`）＋ 它自带的复制按钮。
+ *  **`actionId` 必给**：公共层的 `renderPreBlock` 只在给了 `actionId` 时才渲染复制按钮
+ *  （`packages/base-render/src/blocks.ts:729-736`），只给 `copyText` 会出一个「写着复制、其实没有按钮」的
+ *  有标签没按钮位——那正是本票线上实测发现的一处，本件补齐。
+ *  第二参可选：不给＝小标题「复制给助手：这一句可以直接复制」；`null`＝不出小标题；给字符串就用它。 */
+export function promptCopyArea(prompt, label) {
+    const heading = label === undefined ? PROMPT_COPY_HINT : label;
+    return renderPreBlock({
+        ...(heading === null ? {} : { label: heading }),
+        command: prompt,
+        actionId: PROMPT_COPY_ACTION,
+        copyText: prompt,
+        copyLabel: PROMPT_COPY_HINT,
+    });
+}
+/** ② 复制区：prompt／数据／日志给了什么出什么；三样全不给＝一句空态、**不出按钮**。 */
+export function copyArea(input) {
+    const parts = [];
+    const prompt = input.prompt;
+    if (typeof prompt === 'string') {
+        if (prompt !== '')
+            parts.push(promptCopyArea(prompt));
+    }
+    else if (prompt !== undefined && prompt.text !== '') {
+        parts.push(promptCopyArea(prompt.text, prompt.label ?? null));
+    }
+    if (input.data !== undefined || input.log !== undefined) {
+        parts.push(renderCopyBlock({
+            ...(input.data === undefined ? {} : { dataFormats: formatsOf(input.data) }),
+            ...(input.log === undefined ? {} : { logText: buildLogText(input.log) }),
+        }));
+        return parts.join('');
+    }
+    if (parts.length > 0)
+        return parts.join('');
+    return renderEmptyBlock({ text: input.emptyText ?? COPY_EMPTY_TEXT });
+}
+/** 数据位的那份数据 → 三种格式各算一份 ＋ 菜单提示（`buildDataText` 是本仓复制文本的唯一出口）。
+ *  上级裁定第 2 条：复制载荷头行 `【bill · record.add】` 算上屏一并改——`text` 那份显式给 `title`，
+ *  不再让公共层按 `envelope.skill/key` 拼出命令名；`title` 只写用户说法，不带命令名与 `·`。 */
+function formatsOf(data) {
+    const title = typeof data.title === 'string'
+        && (data.title ?? '').trim() !== ''
+        ? data.title
+        : '记账数据';
+    return {
+        text: buildDataText({ ...data, format: 'text', title }),
+        json: buildDataText({ ...data, format: 'json' }),
+        csv: buildDataText({ ...data, format: 'csv' }),
+        hints: MENU_HINTS,
+    };
+}
+/** ③ 复制日志的第 2–6 段入参：本页由哪条命令渲染、数据从哪来、写了多少行、什么时候。 */
+export function copyLog(input) {
+    return {
+        thinking: LOG_THINKING,
+        dataStructure: input.source === undefined || input.source === '' ? COPY_EMPTY_TEXT : input.source,
+        callChain: input.detail === undefined || input.detail === '' ? input.command : input.command + ' ｜ ' + input.detail,
+        timestamp: input.version === undefined || input.version === '' ? input.actionAt : input.actionAt + ' · 版本 ' + input.version,
+        exception: LOG_EXCEPTION,
+    };
+}
+/** 退出口那枚危险色出口标记的动作号。**故意不绑动作**：动作条场景按钮不带 `data-t`，点了不复制也不写库。 */
+const EXIT_MARK_ACTION = 'ilife-exit-undo';
+/** 退出口的标题与说明（本轮整改：`危险色出口` 是设计自指词，`restore` 是内部词，都不上屏）。 */
+const EXIT_TITLE = '想反悔（撤销这一笔）';
+const EXIT_NOTE = '要撤销这一笔，点下面那颗「复制数据」，里面带着一句撤销的话；撤销之后记录还在，随时可以恢复。';
+/** ④ 回执页退出口：危险色出口标记 ＋ 一句去向说明（t407 根因整改二 D2 去重后）。
+ *  改前这里另带一枚「复制数据」（撤销指令直拷，`ilife-exit-undo-copy`）＋ base #336
+ *  自动补的一枚置灰「复制日志」，与下面复制区那组「复制数据／复制日志」上下重复。
+ *  改后退出口只留标记与说明、不带任何复制按钮与 `data-t`；撤销指令走下面复制区那颗
+ *  「复制数据」（复制载荷里仍带可重跑命令，`data-t` 形状不动）。 */
+export function undoExit(recordId) {
+    return renderCopyBlock({
+        title: EXIT_TITLE,
+        buttons: [{ label: '↩︎ 撤销这一笔', kind: 'red', actionId: EXIT_MARK_ACTION }],
+    }) + renderCaliberLine(EXIT_NOTE + '（记录编号 ' + recordId + '）');
+}
+//# sourceMappingURL=copyArea.js.map

package/dist/shared/copyArea.js.map

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

package/dist/shared/diffTable.d.ts

@@ -0,0 +1,26 @@
+/** 一行：哪个字段、改前、改后、算不算真改动。 */
+export interface DiffRow {
+    readonly field: string;
+    readonly before: string;
+    readonly after: string;
+    /** 原值与新值写成的文本不一样＝真改动（判定住 `diffOf`，别处不许重算）。 */
+    readonly changed: boolean;
+}
+/** 造 diff 行：按 `fields` 的顺序逐列比，**改了没改由这里算**。 */
+export declare function diffOf(input: {
+    readonly fields: readonly string[];
+    readonly before: Readonly<Record<string, unknown>>;
+    readonly after: Readonly<Record<string, unknown>>;
+}): readonly DiffRow[];
+/** diff 表整块：改了哪一项／改前／改后三列；零改动（或一个字段都没比）只出空态。行数为零时也不出空表。
+ *  R2 走映射：行名过 `fieldLabelOf`（库列名不上屏；`deleted_at`→撤销标记、`op`→这一步做什么）；
+ *  列头不再用「字段／原值／新值」这类表述。口径句与「未设置」字面沿用（护栏逐字钉着）。 */
+export declare function diffTable(input: {
+    readonly rows: readonly DiffRow[];
+    readonly caption?: string;
+}): string;
+/** 同一批改动的紧凑形态：一行「改了哪一项 ｜ 改前 → 改后」（走 base 的 `renderChangeRows`）。零改动返回空串。 */
+export declare function diffChangeRows(input: {
+    readonly rows: readonly DiffRow[];
+}): string;
+//# sourceMappingURL=diffTable.d.ts.map

package/dist/shared/diffTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffTable.d.ts","sourceRoot":"","sources":["../../src/shared/diffTable.ts"],"names":[],"mappings":"AAwBA,4BAA4B;AAC5B,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAUD,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD,GAAG,SAAS,OAAO,EAAE,CAMrB;AASD;;iDAEiD;AACjD,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkBzG;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG,MAAM,CAMnF"}

package/dist/shared/diffTable.js

@@ -0,0 +1,77 @@
+/** diff 表（缺口块之一，**唯一定义地**）：改记录用，原值／新值对照。
+ *
+ * 谁在用（本票：**不接任何页面**，理由见下；件头按将来实数写，写得出第二个用法）：
+ *  ① 批量与修正族（改记录）——落库前给一张「字段／原值／新值」，让用户核一眼再落；
+ *  ② 同族的撤销（那一件回执页）——撤销前后 `deleted_at` 这一列的原值与新值，
+ *     与改记录是同一张表、同一个判定，只是字段只有一个。
+ *  两个用法的分界：①要改的几个字段并排核（多行），②只有一列在动（一行）。
+ *
+ * 本票为什么先冻不接：本票的红线是**不改任何页面的可见行为**，接进去就会改（改记录现在出通用页）。
+ *  故本件这一票只做「件 ＋ 断言」，接入落在批量与修正族那一件场景件里（`src/record/scene-update.ts`）。
+ *
+ * 老侧出处：`templates/写入/update_confirm.html:113-116`（原值 → 新值两栏）。
+ *
+ * 判定只有一条，住 `diffOf`：**原值与新值按同一个口径写成文本，文本不一样才算改动**。
+ *  「给了一个新值但它和原值一样」不算改动（`changed: false`），`diffTable` 也就不列它——
+ *  列出来会让用户以为改了。没给这列（`undefined`）写成「未设置」，与给了空串同面。
+ *
+ * 一件不自造：表格走 `renderDataTable`、改前→改后那行紧凑形态走 base 的 `renderChangeRows`、
+ *  一行口径走 `renderCaliberLine`、零改动空态走共用位的 `./emptyNote.js`（它包 base 的 `renderEmptyBlock`）。
+ */
+import { renderCaliberLine, renderChangeRows, renderDataTable } from 'base-paint/blocks';
+import { emptyNote } from './emptyNote.js';
+import { fieldLabelOf } from './userWording.js';
+/** 一个值写成文本：`undefined`／`null`／空白串**同面**，一律写「未设置」，其余按十进制串写。
+ *  同面这条要紧：没给这一列与给了空串如果在文本上不一样，同一件事就会被算成一次改动。 */
+function textOf(v) {
+    if (v === undefined || v === null)
+        return '未设置';
+    const s = String(v);
+    return s.trim() === '' ? '未设置' : s;
+}
+/** 造 diff 行：按 `fields` 的顺序逐列比，**改了没改由这里算**。 */
+export function diffOf(input) {
+    return input.fields.map((f) => {
+        const before = textOf(input.before[f]);
+        const after = textOf(input.after[f]);
+        return { field: f, before, after, changed: before !== after };
+    });
+}
+/** 真改动那一行那一句口径。 */
+function caliberOf(rows) {
+    const changed = rows.filter((r) => r.changed).length;
+    return '共比了 ' + rows.length + ' 个字段，真改动 ' + changed + ' 个'
+        + (changed === rows.length ? '（每一个都动了）' : '（原值与新值一样的那些没列出来）') + '。';
+}
+/** diff 表整块：改了哪一项／改前／改后三列；零改动（或一个字段都没比）只出空态。行数为零时也不出空表。
+ *  R2 走映射：行名过 `fieldLabelOf`（库列名不上屏；`deleted_at`→撤销标记、`op`→这一步做什么）；
+ *  列头不再用「字段／原值／新值」这类表述。口径句与「未设置」字面沿用（护栏逐字钉着）。 */
+export function diffTable(input) {
+    const changed = input.rows.filter((r) => r.changed);
+    if (changed.length === 0) {
+        return emptyNote({
+            title: '没有一处改动',
+            text: input.rows.length === 0 ? '这一次没有要比对的字段。' : '给的新值与原值一模一样，等于没改。',
+            next: '请把要改成什么说清（改哪一项、改成什么），再跟助手说一遍。',
+        });
+    }
+    return renderDataTable({
+        columns: [
+            { key: 'field', label: '改了哪一项' },
+            { key: 'before', label: '改前' },
+            { key: 'after', label: '改后' },
+        ],
+        rows: changed.map((r) => ({ field: fieldLabelOf(r.field), before: r.before, after: r.after })),
+        caption: input.caption ?? '本次改动的字段（' + changed.length + ' 项）',
+    }) + renderCaliberLine(caliberOf(input.rows));
+}
+/** 同一批改动的紧凑形态：一行「改了哪一项 ｜ 改前 → 改后」（走 base 的 `renderChangeRows`）。零改动返回空串。 */
+export function diffChangeRows(input) {
+    const changed = input.rows.filter((r) => r.changed);
+    if (changed.length === 0)
+        return '';
+    return renderChangeRows({
+        rows: changed.map((r) => ({ label: fieldLabelOf(r.field), before: r.before, after: r.after })),
+    });
+}
+//# sourceMappingURL=diffTable.js.map

package/dist/shared/diffTable.js.map

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

package/dist/shared/docPage.d.ts

@@ -0,0 +1,17 @@
+/** 整页装配的入参。 */
+interface DocPageInput {
+    /** head 的 `<title>` 文本。 */
+    readonly docTitle: string;
+    /** 正文标题（页面模板的 H1）。 */
+    readonly title: string;
+    /** 正文眉标（空串＝不写这一行）。 */
+    readonly eyebrow: string;
+    /** 正文副标题（空串＝不写这一行）。 */
+    readonly subtitle: string;
+    /** 已组合好的区块 HTML。 */
+    readonly content: string;
+}
+/** 整页装配：区块 HTML ＋ 标题三件套 → 完整文档。 */
+export declare function assembleDocPage(input: DocPageInput): string;
+export {};
+//# sourceMappingURL=docPage.d.ts.map

package/dist/shared/docPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docPage.d.ts","sourceRoot":"","sources":["../../src/shared/docPage.ts"],"names":[],"mappings":"AAgBA,eAAe;AACf,UAAU,YAAY;IACpB,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAwFD,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAY3D"}

package/dist/shared/docPage.js

@@ -0,0 +1,111 @@
+/** 整页装配共用件：区块 HTML 拼成完整文档（最后一公里）。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/record/`——写入域：结果型回执整页与过程型采集页；
+ *   ② `src/query/`——查询域：通用查询列表页。
+ *  两域走的都是 `./pageShell.ts` 那一层，本件是它下面的文档装配层。
+ *
+ * 包裹约定（沿卡路里同件的 `docPage.ts`，不新增）：
+ *   内容＝`base-paint/blocks` 的区块；文档＝`fillTemplate` 包裹（资产**裸文本**传入＋由填充器包裹）；
+ *   `sharedCss = buildStyleSheet().css + blocksCss()`——**`blocksCss()` 必须拼进 `TemplateAssets.sharedCssText`**，
+ *   不得走 `StyleSheetInput.extraCss`（硬口径，见 `docs/skills/skill-bill/t406-base组件总表.md` 第 1.1 节 `blocksCss` 行）。
+ * 本文件不做取数、不装命令名与领域常量，只按参数拼页；零包内依赖（只 import `base-paint`）。
+ */
+import { blocksCss, renderPageShell } from 'base-paint/blocks';
+import { buildSharedHelpersJs, buildStyleSheet, fillTemplate } from 'base-paint';
+/** 整页模板（裸标记＋CONTENT 槽；`wrap ilife-page` 兼容既有 `--html` 断言）。
+ *  标记不得预包裹：资产由 `fillTemplate` 按 `ASSET_WRAPPERS` 自己包。 */
+function docShell(docTitle) {
+    return '<!DOCTYPE html>\n<html lang="zh-CN">\n<head>\n<meta charset="utf-8">\n'
+        + '<meta name="viewport" content="width=device-width,initial-scale=1">\n'
+        + '<title>' + docTitle + '</title>\n<!--SHARED-CSS-->\n</head>\n<body>\n'
+        + '<div class="wrap ilife-page">\n<!--CONTENT-->\n</div>\n<!--SHARED-HELPERS-->\n'
+        + '</body>\n</html>';
+}
+/** 桌面端补丁（t407 根因整改二 D1：内容列用满宽＋卡片网格换大格，只改呈现）。
+ *
+ * 为什么落在本件：公共层样式（`base-paint`）不许动，本页 body 后也不加样式块
+ * （机审「本页样式块／内联样式」两列要保持 0）；唯一的落点就是本件拼 `sharedCssText`
+ * 的这一处——32 份产物走同一条代码路径，head 样式仍 32/32 同一份。
+ * 只在 `@media (min-width:1200px)` 里生效：手机端（`≤640px` 两列那档）一行不动，
+ * 复量不得回退（见证据件）。 */
+const DESKTOP_CSS = [
+    '/* t407-D1：桌面端内容列与卡片网格（只 1200px 以上生效，手机端不动） */',
+    '@media (min-width:1200px) {',
+    '  .ilife-block-page-shell { max-width: 1120px; }',
+    '  .ilife-block-page-shell .ilife-block-kpi-card-grid { grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); }',
+    /* t403-P1：桌面端数据表与内容列同宽（只 1200px 以上生效，手机端不动）。
+     *  为什么落在本件：公共层 `base-paint` 的 `.ilife-block-data-table` 锁 `max-width:680px` 居中，
+     *  1120 版心下右约 40% 留白、密集页被迫折行（t403 视觉验收 D1）；base 包只建议不动，唯一的落点
+     *  就是本件拼 `sharedCssText` 的这一处（与上面 D1 同一条路）。查询域列表／详情与写入域回执
+     *  同走本件，两域的表同宽；`≤640px` 行卡化那档一行不动。 */
+    '  .ilife-block-page-shell .ilife-block-data-table { max-width: none; }',
+    '}',
+].join('\n');
+/** 手机端黑底说明块补丁（t407 第 3 轮返工 B；与上面 D1 同一处、同一条路）。
+ *
+ *  块是 `base-paint` 的 `renderToast` 那一条（`.ilife-toast`）：左栏标题（「…标签流转：这一笔打…」，
+ *  窄栏里折成两到三行）＋ 右栏标签胶囊（永远一行）。实测毛病两处：
+ *    ① 两栏不等高——标题折了行、胶囊只有一行，整条横幅一边高一边矮（评审判「栏高不齐把整页拖重」）；
+ *    ② 行距偏紧——标题行贴着下面那几行说明，只隔 2px。
+ *  只动呈现：两栏拉到同高（`stretch` ＋ 胶囊内的字居中对齐）、标题与说明的行距统一到 1.5 以上、
+ *  标题行与说明之间留 6px。文字、块序、复制载荷一处不动；公共层样式仍不许动，落点仍只在本件。 */
+const TOAST_CSS = [
+    '/* t407-r3 B：黑底说明块（.ilife-toast）两栏等高＋行距 */',
+    '.ilife-toast { line-height: 1.5; }',
+    '.ilife-toast-title-row { flex-wrap: nowrap; align-items: stretch; margin-bottom: 6px; }',
+    '.ilife-toast-title-row > .ilife-toast-title { flex: 1 1 auto; min-width: 0; margin-bottom: 0; line-height: 1.5; }',
+    '.ilife-toast-title-row > .ilife-toast-chip { flex: 0 0 auto; display: inline-flex; align-items: center; justify-content: center; border-radius: 10px; }',
+    '.ilife-toast-lines { line-height: 1.6; }',
+].join('\n');
+/** 查询详情移动版式（t403-P2：只 640px 以下生效，桌面端不动）。
+ *
+ *  为什么落在本件：详情字段表（字段／值两列）在窄屏行卡化时会逐行重复表头标签
+ *  （t403 视觉验收 D2）；`renderDataTable` 的 `data-label` 恒取列头、无逐行标签选项，
+ *  base 包只建议不动；本页 body 后也不加样式块（机审「本页样式块／内联样式」两列要保持 0），
+ *  唯一的落点就是本件拼 `sharedCssText` 的这一处（与上面 D1／TOAST 同一条路）。
+ *  桌面端（≥641px）只见表格、移动端（≤640px）只见键值列表——两者由 `display` 切换，
+ *  每端恰出一套（读屏器同 CSS 一起切，不存在两套同读）；打印走桌面那一套。 */
+const KV_CSS = [
+    '/* t403-P2：详情键值列表（桌面藏，移动端替表格） */',
+    '.ilife-query-kv-list { display: none; }',
+    '@media (max-width:640px) {',
+    '  .ilife-query-kv-table { display: none; }',
+    '  .ilife-query-kv-list { display: block; margin: 16px 0; border: 1px solid var(--line); border-radius: 14px; background: var(--card); }',
+    '  .ilife-query-kv-list > div { display: flex; align-items: baseline; justify-content: space-between; gap: 2px 10px; padding: 8px 12px; border-top: 1px solid rgba(210, 210, 215, .6); }',
+    '  .ilife-query-kv-list > div:first-child { border-top: 0; }',
+    '  .ilife-query-kv-list dt { flex: none; color: var(--fg3); font-size: 11.5px; font-weight: 600; }',
+    '  .ilife-query-kv-list dd { margin: 0; color: var(--fg); font-size: 12px; text-align: right; overflow-wrap: anywhere; }',
+    '}',
+].join('\n');
+/** 退出口单钮独占整行（t410 终审 n20：撤销页「撤销这一笔」在 390 下实测 175px 半宽）。
+ *
+ *  根因在公共层（`base-render` 的 `.ilife-action-row` 恒两列，单钮只占半格），本包不许动公共层
+ *  （#567 在途），落点只能是本件拼 `sharedCssText` 的这一处（与上面 D1／TOAST／KV 同一条路）。
+ *  只收退出口那一格（`copyArea.ts` 的 `undoExit`，动作号 `ilife-exit-undo`）：该格恒只有一颗红钮，
+ *  把它所在行的列改成单列；页上别的动作行（两颗复制按钮平分的那种）一行不动。桌面端同形
+ *  （危险动作独占一行，本就是层级所需）。`:has` 不支持时回退到半宽，不比改前差。 */
+const EXIT_CSS = [
+    '/* t410：退出口单钮独占整行（只收 ilife-exit-undo 这一格） */',
+    '.ilife-block-copy-block:has([data-action-id="ilife-exit-undo"]) .ilife-action-row {',
+    '  grid-template-columns: 1fr;',
+    '}',
+    '.ilife-block-copy-block:has([data-action-id="ilife-exit-undo"]) .ilife-action-btn {',
+    '  width: 100%;',
+    '}',
+].join('\n');
+/** 整页装配：区块 HTML ＋ 标题三件套 → 完整文档。 */
+export function assembleDocPage(input) {
+    const assets = {
+        sharedCssText: buildStyleSheet().css + '\n' + blocksCss() + '\n' + DESKTOP_CSS + '\n' + TOAST_CSS + '\n' + KV_CSS + '\n' + EXIT_CSS,
+        sharedHelpersJs: buildSharedHelpersJs(),
+    };
+    const body = renderPageShell({
+        title: input.title,
+        ...(input.eyebrow ? { eyebrow: input.eyebrow } : {}),
+        ...(input.subtitle ? { subtitle: input.subtitle } : {}),
+        content: input.content,
+    });
+    return fillTemplate({ template: docShell(input.docTitle), assets, content: body }).html;
+}
+//# sourceMappingURL=docPage.js.map

package/dist/shared/docPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docPage.js","sourceRoot":"","sources":["../../src/shared/docPage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgBjF;yDACyD;AACzD,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,wEAAwE;UAC3E,uEAAuE;UACvE,SAAS,GAAG,QAAQ,GAAG,gDAAgD;UACvE,gFAAgF;UAChF,kBAAkB,CAAC;AACzB,CAAC;AAED;;;;;;mBAMmB;AACnB,MAAM,WAAW,GAAG;IAClB,gDAAgD;IAChD,6BAA6B;IAC7B,kDAAkD;IAClD,uHAAuH;IACvH;;;;0CAIsC;IACtC,wEAAwE;IACxE,GAAG;CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;;sDAOsD;AACtD,MAAM,SAAS,GAAG;IAChB,4CAA4C;IAC5C,oCAAoC;IACpC,yFAAyF;IACzF,mHAAmH;IACnH,yJAAyJ;IACzJ,0CAA0C;CAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;;6CAO6C;AAC7C,MAAM,MAAM,GAAG;IACb,kCAAkC;IAClC,yCAAyC;IACzC,4BAA4B;IAC5B,4CAA4C;IAC5C,yIAAyI;IACzI,yLAAyL;IACzL,6DAA6D;IAC7D,mGAAmG;IACnG,yHAAyH;IACzH,GAAG;CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;iDAMiD;AACjD,MAAM,QAAQ,GAAG;IACf,8CAA8C;IAC9C,qFAAqF;IACrF,+BAA+B;IAC/B,GAAG;IACH,qFAAqF;IACrF,gBAAgB;IAChB,GAAG;CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,mCAAmC;AACnC,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,MAAM,GAAG;QACb,aAAa,EAAE,eAAe,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ;QACnI,eAAe,EAAE,oBAAoB,EAAE;KACxC,CAAC;IACF,MAAM,IAAI,GAAG,eAAe,CAAC;QAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,OAAO,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC1F,CAAC"}

package/dist/shared/duplicateNote.d.ts

@@ -0,0 +1,40 @@
+import type { BillRow } from '../fetch/db.js';
+/** 一次比对的探针：本次要写的金额／分类／日期（`account` 只用来加一格「同账户」）。 */
+export interface DuplicateProbe {
+    readonly amount: number | null;
+    readonly category: string;
+    /** 日期或时刻串，只取前十位。 */
+    readonly date: string;
+    readonly account?: string;
+    /** 本次自己那条记录（回执页用：写完再报时要把自己排除）。 */
+    readonly excludeId?: number;
+}
+/** 一条撞上的记录。 */
+export interface DuplicateHit {
+    readonly id: number;
+    readonly time: string;
+    readonly amount: number;
+    readonly category: string;
+    readonly account: string;
+    /** 账户也与本次一致（提示里加重一格）。 */
+    readonly sameAccount: boolean;
+}
+/** 判定：在「近期记录」里找出与探针撞上的那些条。**空数组＝没撞上，页上不出提示条**。
+ *  **分类没给即返回空数组**（分类是三条判据之一，缺了就不判，见件头口径）。 */
+export declare function findDuplicates(recent: readonly BillRow[], probe: DuplicateProbe): DuplicateHit[];
+/** 提示条：撞上了才出（`hits` 为空返回空串）。逐条一句话说全：编号／时刻／分类／金额／账户，
+ *  键名齐、顿号逗号断句，不拿裸空格拼字段（t410 round2：n26 弹窗整改）。
+ *
+ *  形态按页分（回执页不许出弹窗）：
+ *   - 采集页（缺省 `toast`）：写库前预警，深色卡＋关闭按钮，徽章与标题齐出；
+ *   - 回执页（传 `'static'`）：写库已成，重复信息只是补充说明，出浅色静态横幅
+ *     （`staticNotice`：无关闭按钮、不进 toast 栈；静态形态不出徽章，故不传 `badge`）。
+ *
+ *  本轮整改（照 `docs/skills/skill-bill/t407-文字审查.md` 第 48、49 条）：提示行与副行都是**版式位**，
+ *  行内不再拿 `·` 当版式——逐条那几行改「一句话说全」，标题里那句「黄条：提示，不阻断」是实现说明，删。
+ *  t410 round2 补：标题「像不像重复」与首句「看着像重复」同义反复，标题改用户动作「先核一眼再定」；
+ *  回执页转静态后徽章不再出现（`test/record-write.test.mjs` 对应针脚同步改认「看着像重复」）；
+ *  明细行不用 `·`（同文件第 309 行反向钉）。
+ */
+export declare function duplicateNote(hits: readonly DuplicateHit[], probe: DuplicateProbe, mode?: 'toast' | 'static'): string;
+//# sourceMappingURL=duplicateNote.d.ts.map

package/dist/shared/duplicateNote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateNote.d.ts","sourceRoot":"","sources":["../../src/shared/duplicateNote.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;6CAC6C;AAC7C,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,cAAc,GAAG,YAAY,EAAE,CAuBhG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,KAAK,EAAE,cAAc,EACrB,IAAI,GAAE,OAAO,GAAG,QAAkB,GACjC,MAAM,CA2BR"}

package/dist/shared/duplicateNote.js

@@ -0,0 +1,96 @@
+/** 重复检测提示条（缺口块之一，**唯一定义地**）：同日同额同分类（账户也同＝加重一格）近期已有记录时给黄条提示。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/record/collect.ts`——过程型采集页：写库前先把疑似重复亮出来（老侧 `expense_form` 的形态）；
+ *   ② `src/record/receipt.ts`——结果型回执整页：写完之后再报一次「这一笔与哪几笔撞了」（排除本次这条 id）。
+ *  第二个消费者：`src/query/`（随兄弟图 #403 的查询域一起到位，同一份判定直接调）。
+ *  本票实测：本包 `src/` 下真引用本件的就是上面两个调用点，再无第三处。
+ *  （件头原来写的「记收入／记报销／记一笔」是以后才有的调用点，不是今天的调用方，按实际改掉。）
+ *
+ * 判定口径（**一处定义**，三条判据 ＋ 一条加分项）：
+ *   - 必中三条一起：**已给分类**（整串比，三级写全才算同一类）＋ **同一天**（取 `time` 的前十位，逐字比）
+ *     ＋ **同金额**（两位小数比，避免浮点尾巴）。**分类没给＝不出条**——采集页正是还没填分类的那一步，
+ *     按「同日同额」比会把常见金额天天报成疑似重复（宁可漏提示，不误报）；
+ *   - 加分：账户也同 → 那一笔标「同账户」（老侧口径含账户，本仓把它当加重而不是门槛，免得漏报不同账户的撞单）；
+ *   - 软删记录不参与（取数层已排除 `deleted_at` 非空的行）。
+ *  提示色取黄系（`warn`），**独立一块**，不与别的提示共容器（施工图第三节第 8 行原话）。
+ *  金额的两位小数文本不在这里另写一份：走 `./summaryRow.ts` 的 `money2`。
+ */
+import { renderFeedbackBlock } from 'base-paint/blocks';
+import { money2 } from './summaryRow.js';
+/** 判定：在「近期记录」里找出与探针撞上的那些条。**空数组＝没撞上，页上不出提示条**。
+ *  **分类没给即返回空数组**（分类是三条判据之一，缺了就不判，见件头口径）。 */
+export function findDuplicates(recent, probe) {
+    const amount = probe.amount;
+    if (amount === null || !Number.isFinite(amount))
+        return [];
+    const category = probe.category.trim();
+    if (category === '')
+        return [];
+    const day = probe.date.slice(0, 10);
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(day))
+        return [];
+    const account = (probe.account ?? '').trim();
+    return recent
+        .filter((r) => {
+        if (probe.excludeId !== undefined && r.id === probe.excludeId)
+            return false;
+        if (r.time.slice(0, 10) !== day)
+            return false;
+        if (money2(r.amount) !== money2(amount))
+            return false;
+        return r.category === category;
+    })
+        .map((r) => ({
+        id: r.id,
+        time: r.time,
+        amount: r.amount,
+        category: r.category,
+        account: r.account,
+        sameAccount: account !== '' && r.account === account,
+    }));
+}
+/** 提示条：撞上了才出（`hits` 为空返回空串）。逐条一句话说全：编号／时刻／分类／金额／账户，
+ *  键名齐、顿号逗号断句，不拿裸空格拼字段（t410 round2：n26 弹窗整改）。
+ *
+ *  形态按页分（回执页不许出弹窗）：
+ *   - 采集页（缺省 `toast`）：写库前预警，深色卡＋关闭按钮，徽章与标题齐出；
+ *   - 回执页（传 `'static'`）：写库已成，重复信息只是补充说明，出浅色静态横幅
+ *     （`staticNotice`：无关闭按钮、不进 toast 栈；静态形态不出徽章，故不传 `badge`）。
+ *
+ *  本轮整改（照 `docs/skills/skill-bill/t407-文字审查.md` 第 48、49 条）：提示行与副行都是**版式位**，
+ *  行内不再拿 `·` 当版式——逐条那几行改「一句话说全」，标题里那句「黄条：提示，不阻断」是实现说明，删。
+ *  t410 round2 补：标题「像不像重复」与首句「看着像重复」同义反复，标题改用户动作「先核一眼再定」；
+ *  回执页转静态后徽章不再出现（`test/record-write.test.mjs` 对应针脚同步改认「看着像重复」）；
+ *  明细行不用 `·`（同文件第 309 行反向钉）。
+ */
+export function duplicateNote(hits, probe, mode = 'toast') {
+    if (hits.length === 0)
+        return '';
+    const lines = hits.map((h) => '记录编号 ' + h.id + '（' + h.time + '）：' + h.category
+        + '，' + money2(h.amount) + '，账户' + (h.account === '' ? '没设置' : h.account)
+        + (h.sameAccount ? '（同一个账户）' : ''));
+    const detail = '对的是 ' + probe.date.slice(0, 10) + ' 这一天，金额 ' + money2(probe.amount)
+        + '，分类 ' + probe.category.trim();
+    if (mode === 'static') {
+        return renderFeedbackBlock({
+            title: '先核一眼再定',
+            toast: {
+                msg: '看着像重复：同一天、同金额、同分类，已经有 ' + hits.length + ' 笔了',
+                detail,
+                icon: 'warn',
+                lines,
+            },
+            staticNotice: true,
+        });
+    }
+    const toast = {
+        msg: '看着像重复：同一天、同金额、同分类，已经有 ' + hits.length + ' 笔了',
+        detail,
+        icon: 'warn',
+        badge: { text: '疑似重复', type: 'warn' },
+        lines,
+    };
+    return renderFeedbackBlock({ title: '先核一眼再定', toast });
+}
+//# sourceMappingURL=duplicateNote.js.map

package/dist/shared/duplicateNote.js.map

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

package/dist/shared/emptyNote.d.ts

@@ -0,0 +1,15 @@
+/** 空态入参：`next`＝下一步（必填，非空）。 */
+interface EmptyNoteInput {
+    /** 空态小标题（如「没有可选的历史账户」）。 */
+    readonly title?: string;
+    /** 现在是什么都没有。 */
+    readonly text: string;
+    /** 接下来怎么办（必填：一句能照着做的下一步）。 */
+    readonly next: string;
+    /** 可选的补救动作 HTML（受信透传，由调用方用 base 件拼好）。 */
+    readonly actionHtml?: string;
+}
+/** 空态区块：一句「什么都没有」＋ 一句「接下来怎么办」。 */
+export declare function emptyNote(input: EmptyNoteInput): string;
+export {};
+//# sourceMappingURL=emptyNote.d.ts.map

package/dist/shared/emptyNote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emptyNote.d.ts","sourceRoot":"","sources":["../../src/shared/emptyNote.ts"],"names":[],"mappings":"AAeA,8BAA8B;AAC9B,UAAU,cAAc;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,kCAAkC;AAClC,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAUvD"}