skill-bill 0.1.0 → 0.2.1

package/dist/setup/template-receipt.js.map

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

package/dist/setup/template-wizard.d.ts

@@ -0,0 +1,64 @@
+import type { SerializableEnvelope } from 'base-paint';
+import type { BackupEntry } from './backups.js';
+import type { BadRow, ColumnMap, CsvFile, ImportPlan } from './importer.js';
+import type { SetupBlocked } from './params.js';
+import type { SetupScene } from './scene.js';
+import type { WizardStep } from './steps.js';
+/** 公共入参：三支向导都读这几件。 */
+interface WizardCommon {
+    readonly scene: SetupScene;
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    readonly actionAt: string;
+    /** 步骤条（`./steps.js` 按状态算好的那一份）。 */
+    readonly steps: readonly WizardStep[];
+    readonly envelope: SerializableEnvelope;
+    /** 缺项（空数组＝这一趟不缺东西）。 */
+    readonly blocked: readonly SetupBlocked[];
+    /** 给助手那句口令。 */
+    readonly prompt: string;
+    /** 口令那一块的标题（三支各不相同）。 */
+    readonly promptLabel: string;
+}
+/** 初始化向导那一路的入参。 */
+export interface InitWizardInput extends WizardCommon {
+    readonly op: 'init';
+    readonly envChecks: readonly {
+        readonly label: string;
+        readonly ok: boolean;
+        readonly detail: string;
+    }[];
+    readonly ready: boolean;
+    readonly dbPath: string;
+    readonly records: number;
+    /** 这一次是新建的库（老侧 `init_wizard.html:151-153` 的完成卡那一支）。 */
+    readonly created: boolean;
+}
+/** 恢复向导那一路的入参（**选中项只有一处**：`selected`——详情卡、步骤说明、口令三处都从它派生）。 */
+export interface RestoreWizardInput extends WizardCommon {
+    readonly op: 'restore';
+    readonly entries: readonly BackupEntry[];
+    readonly selected: BackupEntry | null;
+    readonly confirmed: boolean;
+    /** 恢复前给现状造的那一份备份（空串＝还没执行）。 */
+    readonly safety: string;
+    readonly verified: boolean;
+    readonly result: string;
+}
+/** 导入向导那一路的入参。 */
+export interface ImportWizardInput extends WizardCommon {
+    readonly op: 'import';
+    readonly csv: CsvFile | null;
+    readonly map: ColumnMap;
+    readonly plan: ImportPlan | null;
+    readonly confirmed: boolean;
+    /** 导入前自动备份出来的那一份（空串＝还没执行）。 */
+    readonly backup: string;
+    readonly inserted: number;
+    readonly failed: readonly BadRow[];
+}
+export type WizardInput = InitWizardInput | RestoreWizardInput | ImportWizardInput;
+/** 向导页：一整页（三支共用同一套块序，各自只换「该步主体」那一块）。 */
+export declare function wizardDoc(input: WizardInput): string;
+export {};
+//# sourceMappingURL=template-wizard.d.ts.map

package/dist/setup/template-wizard.d.ts.map

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

package/dist/setup/template-wizard.js

@@ -0,0 +1,233 @@
+/** 开始使用域模板之三 · **向导页型**（`t685-按域页型表.md` §2.7 第 1 行／`#688` §五 5.1 的 ③ 过程型向导页）。
+ *
+ * **本件是这一片页型的块位序列唯一住所**。盖住的三条场景（老侧三张模板）：
+ *   · 初始化（`./scene-init.js`；老 `开始使用/init_wizard.html`，173 行／16 个块）；
+ *   · 从备份恢复（`./scene-restore.js`；老 `开始使用/restore.html`，184 行／13 个块）；
+ *   · 导入 CSV 账单（`./scene-import.js`；老 `开始使用/import.html`，186 行／12 个块）。
+ *  **改一次这一片页型的版式只动本件一处。**
+ *
+ * **块位序列**（照 `#688` §五 5.2 的 ③ 向导 列；● 恒出、○ 有内容才出）：
+ *   类型徽章 ●（表序第 6 行）→ 结论句 ○（第 3 行）→ 步骤条（徽章列 ●，第 6 行／`t685` §2.7 的
+ *   「徽章列 ●（步骤进度）」）→ 步骤说明小表 ●（第 12 行）→ 该步主体（第 7 行字段卡 ● ／第 12 行小表 ○）
+ *     → 缺项阻断 ○（第 16 行）→ 复制指令块 ●（第 22 行）→ 复制区 ●（第 25 行）→ 来源脚注 ●（第 26 行）
+ *   本页**不出**的四块：第 4 行页内导航（`#688` §五 5.2 明写：过程型 ①②③ 恒**不**出导航，这是全表唯一
+ *   按页类的例外）、第 13/14 行（占比条／图表）、第 27 行退出口（向导还没写库，没有可撤销的那一件事）。
+ *
+ * **「表单区 ●」那一格在本域怎么承担**（写下来免得后人以为漏了）：本仓的产物是**静态整页**，
+ *   页面本地零脚本（`#688` 裁定 7），故「该步」的可选可填那一面由两处承担——① **候选表**（备份清单／列映射表，
+ *   选中的那一行带标记）；② **复制口令**（用户要改哪一格，就照那一句跟助手说一遍）。
+ *   与账户域「候选由字段卡的下拉承担」同一条口径（`../account/scene-add.js` 第 ⑤ 条）。
+ *
+ * **D6／D7 在这里兑现**：步骤条的两件（`./steps.js` 算好的 `WizardStep[]`）由 `stepChipsOf`／`stepTableOf` 摊开，
+ *   编号与总数都由那一份数组算；空步骤不走「全部通过」那条路（`stepTableOf` 出空态句，`envChecksOf` 出「没测到就是没测到」）。
+ */
+import { renderCaliberLine, renderConclusionBar, renderDataTable } from 'base-paint/blocks';
+import { DOC_TITLE } from '../shared/pageIdentity.js';
+import { humanBytes } from './backups.js';
+import { FIELD_LABEL, IMPORT_FIELDS, PREVIEW_ROWS, REQUIRED_FIELDS } from './importer.js';
+import { SOURCE_FILE, SOURCE_FILE_TEXT, SOURCE_READ, SOURCE_READ_TEXT, SOURCE_WRITE, SOURCE_WRITE_TEXT, badgeOf, blockedOf, copyZoneOf, emptyOf, envChecksOf, promptBlockOf, setupPageShell, sourceNoteOf, stepChipsOf, stepTableOf, textOrDash, } from './pageParts.js';
+/** 初始化那一支的正文：环境检测格 ＋ 完成卡／未就绪说明。 */
+function initBody(input) {
+    const head = input.ready
+        ? renderConclusionBar('初始化完成，可以开始记账了')
+        : renderConclusionBar('还没初始化好：先把上面那几件补齐');
+    return head
+        + renderCaliberLine('数据目录：' + input.dbPath + ' · 现有记录 ' + String(input.records) + ' 条'
+            + (input.created ? ' · 这一次新建了库' : ' · 这次没有新建，用的是已有的库'))
+        + envChecksOf(input.envChecks);
+}
+/** 恢复那一支的正文：**覆盖警告（含「怎么回去」）＋ 备份清单（选中那行带标记）＋ 详情卡**。
+ *  **选中项只有一处**：`input.selected`——老侧最高危缺陷（`restore.html:141-145` 详情卡冻结在初值、
+ *  而复制文案用新选的那一个）就是从这里长出来的；新侧的详情卡与口令都由本件的同一个 `selected` 派生。 */
+function restoreBody(input) {
+    const s = input.selected;
+    if (s === null) {
+        return emptyOf({
+            title: '还没有备份可恢复',
+            text: '备份目录里一份都没有，没有可拿来恢复的东西。',
+            next: '先跟助手说一遍「备份」，把现在的数据存一份，之后就能从这里挑一份恢复。',
+        });
+    }
+    const warn = renderConclusionBar('⚠️ 恢复将覆盖当前数据')
+        + renderCaliberLine('恢复前会自动备份现状——不用你记着；若恢复后不满意，再用「恢复备份」'
+            + '挑刚刚那一份「' + (input.safety === '' ? '（这次还没造）' : input.safety) + '」就能回到现在的样子。');
+    const columns = [
+        { key: 'file', label: '备份文件' },
+        { key: 'time', label: '备份时间' },
+        { key: 'size', label: '大小', align: 'right' },
+    ];
+    const rows = input.entries.map((e) => ({
+        ...(e.file === s.file ? { marker: '选中的' } : {}),
+        file: e.file,
+        time: e.time,
+        size: humanBytes(e.bytes),
+    }));
+    const detail = renderDataTable({
+        columns: [
+            { key: 'k', label: '哪一项' },
+            { key: 'v', label: '是什么' },
+        ],
+        rows: [
+            { k: '备份名称', v: s.file },
+            { k: '备份时间', v: s.time },
+            { k: '大小', v: humanBytes(s.bytes) },
+            { k: '内容', v: s.hasGoals ? '库 ＋ 目标' : '只有库' },
+        ],
+        caption: '要恢复的就是这一份（详情与下面那句口令说的是同一份）',
+    });
+    const outcome = input.confirmed
+        ? renderConclusionBar(input.verified ? '恢复完成：' + input.result : '恢复没走完：' + input.result)
+            + renderCaliberLine('恢复前现状已备份：' + (input.safety === '' ? '没造出来' : input.safety))
+        : '';
+    return warn
+        + renderDataTable({ columns, rows, caption: input.entries.length > 1 ? '备份目录里的这些份（默认用最新的一份）' : '备份目录里只有这一份' })
+        + detail
+        + outcome;
+}
+/** 导入那一支的正文：文件卡 ＋ 列映射表 ＋ 预览表 ＋ **D2 的四件**（明示新增行数／自动备份／重复检测／结果卡）。 */
+function importBody(input) {
+    const csv = input.csv;
+    if (csv === null) {
+        return emptyOf({
+            title: '还没给文件',
+            text: '导入要先有那个 CSV 文件。',
+            next: '把文件路径填在上面那格，跟助手说一遍「导入」。',
+        });
+    }
+    const mapColumns = [
+        { key: 'field', label: '字段' },
+        { key: 'col', label: '认到第几列' },
+        { key: 'sample', label: '第一行长这样' },
+    ];
+    const first = csv.rows[0] ?? [];
+    const mapRows = IMPORT_FIELDS.map((f) => {
+        const col = input.map[f];
+        return {
+            field: FIELD_LABEL[f] + (REQUIRED_FIELDS.includes(f) ? '（必填）' : ''),
+            col: col === undefined ? '没认到' : '第 ' + String(col + 1) + ' 列（' + textOrDash(csv.header[col]) + '）',
+            sample: col === undefined ? '—' : textOrDash(first[col]),
+        };
+    });
+    const previewRows = csv.rows.slice(0, PREVIEW_ROWS).map((cells, i) => {
+        const row = { no: '第 ' + String(i + (csv.hasHeader ? 2 : 1)) + ' 行' };
+        csv.header.forEach((h, c) => { row['c' + String(c)] = textOrDash(cells[c]); });
+        return row;
+    });
+    const previewColumns = [{ key: 'no', label: '哪一行' }].concat(csv.header.map((h, c) => ({ key: 'c' + String(c), label: textOrDash(h) })));
+    // ① 明示「将新增几行、不覆盖已有记录」；③ 重复导入检测的读数也在这句里。
+    const countLine = input.plan === null
+        ? renderCaliberLine('还没排导入计划（先认下列映射）。')
+        : renderCaliberLine('本次将新增 ' + String(input.plan.newRows) + ' 行，不覆盖已有记录'
+            + (input.plan.duplicates.length > 0 ? '；另有 ' + String(input.plan.duplicates.length) + ' 行库里已经有了，跳过' : '')
+            + (input.plan.bad.length > 0 ? '；' + String(input.plan.bad.length) + ' 行读不出来，跳过' : '') + '。');
+    // ② 导入前提示或自动备份一次（本仓取「自动备份」这一支）。
+    const backupLine = renderCaliberLine(input.confirmed
+        ? (input.backup === '' ? '导入前本该自动备份一次，这次没落下来——请注意。' : '导入前已经自动备份了现状：' + input.backup)
+        : '确认之后才写库；写之前会自动备份一次现状，导错了可以拿它回去。');
+    // ④ 页面级结果卡（成功／失败行数 ＋ 失败原因）。
+    const resultBlock = input.confirmed
+        ? renderConclusionBar('导入完成：成功 ' + String(input.inserted) + ' 行'
+            + (input.failed.length > 0 ? '，失败 ' + String(input.failed.length) + ' 行' : '，没有失败行'))
+            + (input.failed.length === 0
+                ? renderCaliberLine('每一行都写进去了。')
+                : renderDataTable({
+                    columns: [{ key: 'line', label: '哪一行' }, { key: 'why', label: '为什么没进去' }],
+                    rows: input.failed.map((f) => ({ line: '第 ' + String(f.line) + ' 行', why: f.why })),
+                    caption: '没写进去的行逐条列在这里',
+                }))
+        : '';
+    return renderCaliberLine('文件：' + csv.name + ' · 数据 ' + String(csv.rows.length) + ' 行 · 编码 ' + csv.encoding)
+        + renderDataTable({ columns: mapColumns, rows: mapRows, caption: '列映射（自动认的，改就照下面那句重说一遍）' })
+        + renderDataTable({ columns: previewColumns, rows: previewRows, caption: '前 ' + String(Math.min(PREVIEW_ROWS, csv.rows.length)) + ' 行', emptyText: '这个文件没有数据行' })
+        + countLine + backupLine + resultBlock;
+}
+/** 向导页：一整页（三支共用同一套块序，各自只换「该步主体」那一块）。 */
+export function wizardDoc(input) {
+    const body = input.op === 'init' ? initBody(input)
+        : input.op === 'restore' ? restoreBody(input) : importBody(input);
+    const stepTable = stepTableOf(input.steps);
+    const reason = input.op === 'init'
+        ? (input.ready ? '初始化完成，可以记账了。' : '还差几步没走完。')
+        : input.op === 'restore'
+            ? (input.selected === null ? '还没有可恢复的备份。'
+                : (input.confirmed ? (input.verified ? '恢复完成。' : '恢复没走完。') : '要恢复的是 ' + input.selected.file + '，确认之后才动数据。'))
+            : (input.plan === null ? '先把文件的列认下来。'
+                : (input.confirmed ? '导入完成。' : '本次将新增 ' + String(input.plan.newRows) + ' 行，不覆盖已有记录。'));
+    const status = input.op === 'init'
+        ? (input.ready ? { kind: 'ok', text: '已完成' } : { kind: 'warn', text: '还没就绪' })
+        : input.op === 'restore'
+            ? (input.confirmed ? { kind: input.verified ? 'ok' : 'warn', text: input.verified ? '已恢复' : '没走完' }
+                : { kind: 'warn', text: '等你确认' })
+            : (input.confirmed ? { kind: input.failed.length === 0 ? 'ok' : 'warn', text: '已导入' }
+                : { kind: 'warn', text: '等你确认' });
+    const parts = [
+        badgeOf({ word: input.scene.title, caliber: input.scene.caliber, status: status.kind, statusText: status.text, next: '' }),
+        renderConclusionBar(reason),
+        stepChipsOf(input.steps),
+        stepTable,
+        body,
+        blockedOf({ blocked: input.blocked, command: blockedCommandText(input) }),
+        promptBlockOf(input.prompt, input.promptLabel),
+        copyZoneOf({
+            envelope: input.envelope, title: input.scene.title, key: input.key, params: input.params,
+            source: sourceOf(input), detail: logDetailOf(input), actionAt: input.actionAt,
+        }),
+    ];
+    const content = parts.filter((p) => p !== '').join('')
+        + sourceNoteOf({
+            sourceText: sourceTextOf(input),
+            start: '不限',
+            end: '不限',
+            count: countOf(input),
+        });
+    return setupPageShell({
+        docTitle: DOC_TITLE + '·' + input.scene.title,
+        title: input.scene.title,
+        subtitle: input.scene.subtitle,
+        slot: 'collect', page: 'collect', shape: 'receipt', key: input.key, content,
+    });
+}
+/** 补齐口令（缺项时给看不给复制的那一句）。 */
+function blockedCommandText(input) {
+    const filled = { op: input.op, ...input.params };
+    for (const b of input.blocked)
+        filled[b.name] = '<' + b.label + '>';
+    return 'bill.setup.run ' + JSON.stringify(filled);
+}
+/** 复制日志第 3 段（给机器看的那句来源）。 */
+function sourceOf(input) {
+    if (input.op === 'import')
+        return SOURCE_FILE;
+    if (input.op === 'restore')
+        return SOURCE_WRITE;
+    return SOURCE_READ;
+}
+/** 来源脚注那一句（只写人话）。 */
+function sourceTextOf(input) {
+    if (input.op === 'import')
+        return SOURCE_FILE_TEXT;
+    if (input.op === 'restore')
+        return SOURCE_WRITE_TEXT;
+    return SOURCE_READ_TEXT;
+}
+/** 复制日志第 4 段后半那一句（这一趟干了什么）。 */
+function logDetailOf(input) {
+    if (input.op === 'init')
+        return input.ready ? '环境检测通过，库已就绪' : '环境检测未过，库还没就绪';
+    if (input.op === 'restore')
+        return input.confirmed
+            ? '恢复 ' + String(input.selected?.file ?? '—') + '（现状已备份 ' + input.safety + '）'
+            : '预览 ' + String(input.selected?.file ?? '—') + '，等确认';
+    return input.confirmed
+        ? '导入 ' + String(input.inserted) + ' 行（失败 ' + String(input.failed.length) + ' 行）'
+        : '预览导入计划 ' + String(input.plan?.newRows ?? 0) + ' 行，等确认';
+}
+/** 来源脚注的条数那一格（这一页看了几件东西）。 */
+function countOf(input) {
+    if (input.op === 'init')
+        return input.records;
+    if (input.op === 'restore')
+        return input.entries.length;
+    return input.plan?.newRows ?? 0;
+}
+//# sourceMappingURL=template-wizard.js.map

package/dist/setup/template-wizard.js.map

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

package/dist/{policy → shared}/category.d.ts

@@ -12,12 +12,6 @@ export declare const DEFAULTS: {
 export declare function l1Of(category: string): string;
 export declare function validateCategory(raw: unknown): string;
 export declare function validateAmount(raw: unknown): number;
-export declare const DATETIME_RE: RegExp;
-export declare const DATE_RE: RegExp;
-export declare const MONTH_RE: RegExp;
-export declare function validateTime(raw: unknown): string;
-export declare function normalizeDate(d: unknown, field?: string): string;
-export declare function normalizeMonth(m: unknown, field?: string): string;
 export interface BillRecordInput {
     category: string;
     amount: number;

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

@@ -0,0 +1 @@
+{"version":3,"file":"category.d.ts","sourceRoot":"","sources":["../../src/shared/category.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,UAAU,uEAAwE,CAAC;AAChG,eAAO,MAAM,SAAS,iDAAkD,CAAC;AACzE,eAAO,MAAM,UAAU,6BAA8B,CAAC;AACtD,eAAO,MAAM,MAAM,+HAAwD,CAAC;AAC5E,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7C,eAAO,MAAM,QAAQ;;;;;CAAoE,CAAC;AAE1F,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7C;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAiBrD;AAGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQnD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CACjE;AAGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAkB5E"}

package/dist/{policy → shared}/category.js

@@ -1,6 +1,18 @@
-// 口径层·分类与金额（老家 references/categories.md + scripts/validators.py 对应）。
-// 支出 L1 10 + 收入 L1 6 + 借贷/分期/转账隔离；amount 符号即分类依据（支出负/收入正），不单设 type 列。
+/** 共用位·分类与金额口径（#689 结构搬迁第三批：从 `src/policy/category.ts` 来）。
+ *  支出 L1 10 ＋ 收入 L1 6 ＋ 借贷／分期／转账隔离；`amount` 符号即分类依据（支出负／收入正），不单设 `type` 列。
+ *  同一件拆出的另一半是 `./dateRange.ts`（日期与时间窗口），两件互不反向依赖。
+ *
+ *  谁在用（指名，路径随 #689 搬迁改成新家）：
+ *    · `src/write/`——`photoEscape.ts`（三级分类候选与 `ALL_L1`／`EXPENSE_L1`／`INCOME_L1`）·
+ *      `record.ts`（`validateCategory`／`validateAmount`／`validateRecord`）·
+ *      `prefillNote.ts`／`recentPicks.ts`／`template-batch.ts`（`DEFAULTS`）· `summaryRow.ts`（`l1Of`）；
+ *    · `src/query/read.ts`——「查分类」那条条件的 `validateCategory`；
+ *    · `src/setup/import.ts`——导入 CSV 那一支的 `validateCategory`／`validateAmount`（#731 起住能力目录；
+ *      搬迁前那一支在外壳 `src/cli/cmd_read.ts` 里，随开始使用域那张票搬走）；
+ *    · `src/shared/kpi.ts`——总览的分档前缀取 `l1Of`。
+ *  两域（write／query）＋外壳在用它 ⇒ 住共用位（归属律 2）。 */
 import { BillPolicyError } from '../fetch/errors.js';
+import { defaultTimeOn, validateTime } from './dateRange.js';
 export const EXPENSE_L1 = ['餐饮', '居家', '穿着', '出行', '玩乐', '学习', '健康', '社交', '宠物', '其他'];
 export const INCOME_L1 = ['工资', '奖金', '兼职', '投资', '其他收入', '退款'];
 export const SPECIAL_L1 = ['借贷', '分期', '转账'];
@@ -40,62 +52,12 @@ export function validateAmount(raw) {
         throw new BillPolicyError('POLICY_BAD_AMOUNT', 'amount 超界');
     return Math.round(n * 100) / 100;
 }
-export const DATETIME_RE = /^(\d{4})-(\d{2})-(\d{2})(?: (\d{2}):(\d{2}):(\d{2}))?$/;
-export const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-export const MONTH_RE = /^\d{4}-(0[1-9]|1[0-2])$/;
-function realDate(y, m, d) {
-    const dt = new Date(y, m - 1, d);
-    return dt.getFullYear() === y && dt.getMonth() === m - 1 && dt.getDate() === d;
-}
-// 时间：YYYY-MM-DD HH:mm:ss 或 YYYY-MM-DD（补 12:00:00）；非法阻断。
-export function validateTime(raw) {
-    if (typeof raw !== 'string' || raw.trim().length === 0) {
-        throw new BillPolicyError('POLICY_BAD_TIME', 'time 不能为空');
-    }
-    const s = raw.trim().replace(/\//g, '-');
-    const m = DATETIME_RE.exec(s);
-    if (!m)
-        throw new BillPolicyError('POLICY_BAD_TIME', 'time 格式非法');
-    const y = Number(m[1]);
-    const mo = Number(m[2]);
-    const d = Number(m[3]);
-    if (!realDate(y, mo, d))
-        throw new BillPolicyError('POLICY_BAD_TIME', 'time 非真实日期');
-    if (m[4] === undefined)
-        return s + ' 12:00:00';
-    const hh = Number(m[4]);
-    const mm = Number(m[5]);
-    const ss = Number(m[6]);
-    if (hh > 23 || mm > 59 || ss > 59)
-        throw new BillPolicyError('POLICY_BAD_TIME', 'time 时分秒非法');
-    return s;
-}
-export function normalizeDate(d, field = 'date') {
-    if (typeof d !== 'string' || d.trim().length === 0) {
-        throw new BillPolicyError('POLICY_BAD_TIME', field + ' 须为日期字符串');
-    }
-    let s = d.trim().replace(/\//g, '-').replace(/\./g, '-');
-    if (/^\d{8}$/.test(s))
-        s = s.slice(0, 4) + '-' + s.slice(4, 6) + '-' + s.slice(6);
-    if (!DATE_RE.test(s))
-        throw new BillPolicyError('POLICY_BAD_TIME', field + ' 格式非法');
-    const parts2 = s.split('-').map(Number);
-    if (!realDate(parts2[0], parts2[1], parts2[2]))
-        throw new BillPolicyError('POLICY_BAD_TIME', field + ' 非真实日期');
-    return s;
-}
-export function normalizeMonth(m, field = 'month') {
-    if (typeof m !== 'string' || !MONTH_RE.test(m.trim())) {
-        throw new BillPolicyError('POLICY_BAD_TIME', field + ' 格式非法');
-    }
-    return m.trim();
-}
-// 整单校验：7 字段（account/ledger/currency/note 可缺省）；坏输入阻断。
+// 整单校验：7 字段（account/ledger/currency/note 可缺省）；坏输入阻断。时刻的补法引 `./dateRange.js`（真源一处）。
 export function validateRecord(raw) {
     const category = validateCategory(raw.category);
     const amount = validateAmount(raw.amount);
     const time = raw.time === undefined || raw.time === null || raw.time === ''
-        ? new Date().toISOString().slice(0, 10) + ' 12:00:00'
+        ? defaultTimeOn(new Date().toISOString().slice(0, 10))
         : validateTime(raw.time);
     const str = (v, name) => {
         if (v === undefined || v === null)

package/dist/shared/category.js.map

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

package/dist/shared/commandSpec.d.ts

@@ -0,0 +1,75 @@
+/** 命令声明的形状（**唯一定义地**）：一条命令的事实——种类／命令名／形状／标题／可执行示例／处理函数。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/write/commands.ts`——写入域命令事实的唯一权威源（两条写命令：记一笔、改记录）；
+ *   ② `src/query/commands.ts`——查询域命令事实的唯一权威源（四条读命令：查今天／查区间／搜备注／查账单详情）；
+ *  两张声明各由本能力的 `index.ts` 转出，`src/cli/registry.ts` 汇总成一张查表供 `src/cli/cmd_read.ts` 先查。
+ *
+ * 代表唤醒词**不在本形状里**（#721 撤）：它是**派生**——按 `key` 从该域的域声明算
+ * （`projectWakeWord({ key })`，见 `src/triggers/wakeTable.ts`）。原来每条声明各写一遍代表词，
+ * 是同一件事的第二处书写位；撤掉之后「一条命令有词可路由」由 `test/t721-域声明.test.mjs` 逐键判。
+ *
+ * 口径出处：形状照 `packages/skill-calorie/src/shared/commandSpec.ts`（照结构，不照文件）。
+ * `docs/skills/skill-bill/t406-共用件依赖与提升改造清单.md` 第三节第 1 条判「`commandSpec.ts` 不上移公共层」，
+ * 理由是命令事实按 `docs/agents/命令登记纪律.md` 住各能力目录——故饼干自持这一份，不上公共层。
+ *
+ * 为什么写命令一律 `shape: 'receipt'`：写命令的产物是一次写库的事实（`ok`／`message`／回执三件），
+ * 与 `base-link-core` 的 `receipt` 形同一件事实的两种说法，测试里钉死二者等价。
+ *
+ * 读命令那一支（`ReadCommandSpec`）由查询域那张票（#411）补上：读命令的形状是**表里的形状**
+ * （`list`／`detail`，取值来自 `base-link-core` 的 `EnvelopeShape`），产物是一件已取到的事实，
+ * 与写命令的 `receipt` 不是同一种；`kind` 判别式让分派层能**静态**窄化到正确的那一支（铁律三）。
+ */
+import type { EnvelopeShape } from 'base-link-core';
+import type { BillDb } from '../fetch/db.js';
+/** 写命令的产物：回执三件（`ok`／`message`／`receipt`）＋ 整页 HTML（`html`）。
+ *  `receipt` **可缺**：必需槽位缺失时出的是过程型采集页，那一次没有写库事实可报。
+ *  `receipt` 那一格**形状由各域自己定**（写域＝`./writeParts.js` 的 `BillReceipt`，账户域＝
+ *  `../account/scene.js` 的 `AccountReceipt`）：出口把 `data` 原样交给 envelope 形状守卫，而 `receipt` 形
+ *  只校验 `ok`／`message` 两格，故共用位不收窄成某一家——收窄就要让共用位认识每一个域的界内形状
+ *  （#691 是这一格上的第一个跨域消费者，故按实测把口径写在这里）。域内读它的人照自己那份类型读。 */
+export interface WriteOut {
+    data: {
+        ok: boolean;
+        message: string;
+        receipt?: unknown;
+    };
+    html: string;
+}
+/** 写命令的处理函数。第二参是饼干的库句柄 `BillDb`（库 ＋ 路径 ＋ 是否新建）——
+ *  与卡路里同件收 `DatabaseSync` 不同：饼干的取数层 `addBill`／`updateBill`／`undoBill`／`restoreBill`
+ *  收的就是 `BillDb`（`src/fetch/db.ts:155` 起），共用件不自造第二种句柄。 */
+export type WriteHandler = (params: Record<string, unknown>, db: BillDb) => WriteOut;
+/** 写命令的声明：六件事 ＋ 处理函数。 */
+export interface WriteCommandSpec {
+    readonly kind: 'write';
+    readonly key: string;
+    readonly shape: 'receipt';
+    readonly title: string;
+    /** 照抄即能跑的一行（本票两条都在空库上真跑过，退出码 0）。 */
+    readonly example: string;
+    readonly run: WriteHandler;
+}
+/** 命令声明的联合。分派层按 `kind` 静态窄化：`write` 走写入口、`read` 走查询入口。 */
+export type CommandSpec = WriteCommandSpec | ReadCommandSpec;
+/** 读（查询）命令的产物：`data` 过 envelope 形状守卫，`html` 为整页产物（列表页／详情页）。
+ *  与卡路里同件的 `ViewOut` 同一件事的两种形状：饼干这一期不需要 `deliveryKind` 与 `target`
+ *  （查询产物只有一种形态、落点由 `--html` 逐字给），故不提前占位。 */
+export interface ViewOut {
+    data: Record<string, unknown>;
+    html: string;
+}
+/** 读命令的处理函数。第二参同 `WriteHandler` 收饼干的库句柄 `BillDb`（取数层只认这一种句柄）。 */
+export type ViewHandler = (params: Record<string, unknown>, db: BillDb) => ViewOut;
+/** 读命令的声明：与写命令同五件事，只两处不同——`kind` 是 `read`、`shape` 是**表里的形状**。 */
+export interface ReadCommandSpec {
+    readonly kind: 'read';
+    readonly key: string;
+    /** 本次 envelope 的形状（`list`＝列表页、`detail`＝单条详情页）。 */
+    readonly shape: EnvelopeShape;
+    readonly title: string;
+    /** 照抄即能跑的一行（四条都在本机临时库上真跑过，退出码 0）。 */
+    readonly example: string;
+    readonly run: ViewHandler;
+}
+//# sourceMappingURL=commandSpec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commandSpec.d.ts","sourceRoot":"","sources":["../../src/shared/commandSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;wDAKwD;AACxD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;0DAE0D;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,KAAK,QAAQ,CAAC;AAErF,yBAAyB;AACzB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;CAC5B;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE7D;;4CAE4C;AAC5C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;AAEnF,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B"}

package/dist/shared/commandSpec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=commandSpec.js.map

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/write/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;AAUD;;;;0CAI0C;AAC1C,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKjD"}