skill-bill 0.1.0 → 0.2.0

package/dist/record/scene-update.js

@@ -0,0 +1,249 @@
+/** 场景件：改记录（`bill.record.update` 的缺省那一支，`op` 空＝改字段）。**本票：两格都换成这一件自己的装配体**。
+ *
+ * 服务哪条唤醒词：改记录（`src/policy/wakewords.ts` 的 `WAKE_TABLE` 里不带 `op` preset 的那一条）。
+ * 现在出哪张页：采集页＝本件 `collectOf`（**三形态**：缺 `id` 列候选／带 `id` 出确认面／`id` 那一条已打标撤销），
+ *  回执页＝本件 `receiptOf`（落库后那一张）。三形态由 `id` 给没给 ＋ 那一条读不读得到判出来，判定只在本件。
+ * 施工图那一行（`docs/skills/skill-bill/t407-页面块清单-16词.md` 第二节「改记录」）要的块，逐块落位：
+ *  类型徽章（改记录）／原记录只读回显（`../shared/recordPicker.ts` 的 `snapshotTable`）／
+ *  diff 表（`../shared/diffTable.ts`，字段／原值／新值）／候选单选（缺 `id` 时，`../shared/recordPicker.ts`）／
+ *  复制指令块／动作区／错误回执（缺项阻断条里那一件，`../shared/blockedSlots.ts`）。
+ *
+ * 缺 `id` 不再由路由层报错（那是本票修的破口）：路由只说「改记录」时落这一页，由**候选记录列表**让用户挑一条，
+ *  挑完仍走同一条写命令。**没给 `id` 就不出可跑的写库指令**（阻断条里那条指令带尖括号占位符、只给看不给复制）。
+ */
+import { renderCaliberLine, renderDataTable, renderDisclosure, renderKpiGrid } from 'base-paint/blocks';
+import { blockedBar, blockedItems, blockedMessage } from '../shared/blockedSlots.js';
+import { collectMissingTags, collectSectionTitle } from '../shared/collectFrame.js';
+import { copyArea, copyLog, promptCopyArea, undoExit } from '../shared/copyArea.js';
+import { diffTable } from '../shared/diffTable.js';
+import { emptyNote } from '../shared/emptyNote.js';
+import { DOC_SKILL, DOC_TITLE, DOC_VERSION, sceneKeyOf } from '../shared/pageIdentity.js';
+import { pageShell } from '../shared/pageShell.js';
+import { diffRowsFor, pickModeOf, pickerBlock, readRowById, snapshotTable } from '../shared/recordPicker.js';
+import { receiptStatusCard, reconcileDisclosure } from '../shared/receiptParts.js';
+import { summaryCards, summaryRow } from '../shared/summaryRow.js';
+import { typeBadge } from '../shared/typeBadge.js';
+import { fieldLabelOf } from '../shared/userWording.js';
+import { commandLine } from '../shared/writeParts.js';
+/** 一条唤醒词一件：本件服务的那条。 */
+const WAKE = '改记录';
+/** 本件的命令名（两条页与复制指令都引它一份）。 */
+const KEY = 'bill.record.update';
+/** 一个值的字符串形态（数字写十进制串，其余形态按空串用）。 */
+function textOf(v) {
+    if (typeof v === 'string')
+        return v.trim();
+    return typeof v === 'number' ? String(v) : '';
+}
+/** 记录编号：`params.id` 是正整数才算给了（其余形态一律当没给，不猜）。 */
+function idOf(params) {
+    const raw = params['id'];
+    const n = typeof raw === 'number' ? raw : textOf(raw) === '' ? NaN : Number(textOf(raw));
+    return Number.isInteger(n) && n > 0 ? n : null;
+}
+/** 允许改的字段名单：取自槽位表（`id`／`op` 两格不是被改的字段），本件不另抄一份。 */
+function changeFieldsOf(slots) {
+    return slots.filter((s) => s.name !== 'id' && s.name !== 'op').map((s) => s.name);
+}
+/** 摘要行的事实：有原记录就取库内那一行（页面说的是那一条的现状），没有就取本次参数。 */
+function factsOf(row, params) {
+    if (row !== null) {
+        return { amount: row.amount, category: row.category, account: row.account, ledger: row.ledger, time: row.time };
+    }
+    const raw = params['amount'];
+    const n = typeof raw === 'number' ? raw : textOf(raw) === '' ? NaN : Number(textOf(raw));
+    return {
+        amount: Number.isFinite(n) ? n : null,
+        category: textOf(params['category']),
+        account: textOf(params['account']),
+        ledger: textOf(params['ledger']),
+        time: textOf(params['time']),
+    };
+}
+/** 缺项时那条写库指令原文：缺的值留成尖括号占位符，**只给看不给复制**。 */
+function blockedCommand(params, blocked) {
+    const filled = { ...params };
+    for (const b of blocked)
+        filled[b.name] = '<' + b.label + '>';
+    return commandLine(KEY, filled);
+}
+/** 缺项阻断条整条收进折叠区：首屏只留缺项标签与一行副标题，口令原文不再常驻版面。
+ *  内容与判定一字不动（仍是共用件 `blockedBar` 的产出），只换摆法；折叠与否那枚置灰按钮都点不动。 */
+function blockedFold(items, command) {
+    if (items.length === 0)
+        return '';
+    return renderDisclosure({
+        title: '还缺什么，以及补齐后照抄的那条',
+        contentHtml: blockedBar({ items, command }),
+    });
+}
+/** 「照这句跟助手说一遍」那块话：这一页是哪一形态、接下来怎么办、补齐后重跑哪条命令。 */
+function promptOf(input) {
+    if (input.id === null) {
+        return '这一页先不写库。挑一条记录，说清要改哪一项、改成什么，再跟助手说一遍「改记录」。';
+    }
+    if (input.deleted) {
+        return '记录编号 ' + input.id + ' 那一条已经撤销过，改记录这一支不动它。\n'
+            + '要它回到库里就说「恢复」：' + commandLine(KEY, { op: 'restore', id: input.id }) + '。';
+    }
+    if (input.row === null) {
+        return '记录编号 ' + input.id + ' 在库里读不到，可能已不在这个库。\n'
+            + '核一下编号，或先说清是哪一笔，再跟助手说一遍「改记录」。';
+    }
+    return '原记录与改动对照都在下面：核一眼「原值／新值」，没问题就照这条说。\n'
+        + commandLine(KEY, input.params);
+}
+/** 采集页整页：三形态共用同一串头的块，中段按形态换（候选表／原记录＋diff 表／空态）。 */
+function collectOf(input) {
+    const { params, slots, missing } = input;
+    const blocked = blockedItems({ params, missing, kind: '' });
+    const message = blockedMessage(missing, blocked);
+    /** 副标题只报缺哪一项（不重复「已出采集页，补齐之后跟助手说一遍」那句）。 */
+    const subtitle = blocked.length === 0 ? '' : '缺必需槽位：' + blocked.map((i) => i.label).join('、');
+    const envelope = {
+        version: DOC_VERSION, skill: DOC_SKILL, shape: 'receipt', key: sceneKeyOf(KEY),
+        data: { ok: false, message },
+    };
+    const id = idOf(params);
+    const probe = id === null
+        ? { ok: true, reason: '', row: null, deleted: false }
+        : readRowById(id);
+    const row = probe.row;
+    // 撤销标记口径取自 `../shared/recordPicker.ts` 的 `isDeleted`（读一条时一次算好，本件不重判一次）。
+    const deleted = probe.deleted;
+    const form = id === null ? '缺记录编号，先挑一条' : deleted ? '那一条已撤销过' : row === null ? '那一条读不到' : '带记录编号，待确认';
+    const middle = [];
+    if (id === null) {
+        middle.push(pickerBlock({ mode: pickModeOf(params['op']) }));
+    }
+    else if (deleted && row !== null) {
+        middle.push(snapshotTable(row, '这一条记录　已撤销过，只读回显'));
+        middle.push(emptyNote({
+            title: '这一条已经撤销过',
+            text: '记录编号 ' + id + ' 在 ' + String(row.deleted_at) + ' 撤销过，改记录这一支不动已撤销的记录。',
+            next: '要它回到库里就说「恢复」，恢复之后再改。要改别的记录就换一个编号。',
+        }));
+    }
+    else if (row === null) {
+        middle.push(emptyNote({
+            title: '这个编号没有记录',
+            text: '记录编号 ' + id + ' 在库里一条都没读到。' + (probe.ok ? '' : probe.reason + '。'),
+            next: '核一下编号，或先说清是哪一笔。',
+        }));
+    }
+    else {
+        middle.push(snapshotTable(row, '原记录　只读回显　记录编号 ' + row.id));
+        middle.push(diffTable({
+            rows: diffRowsFor({ row, params, fields: changeFieldsOf(slots) }),
+            caption: '改前改后对照（本次打算改的那几项）',
+        }));
+    }
+    const content = [
+        typeBadge({
+            kind: '',
+            status: 'danger',
+            state: form === '缺记录编号，先挑一条' ? '三形态之一：缺记录编号 · 先挑一条' : '待核对 · 未写库',
+            next: '',
+        }),
+        blocked.length === 0 ? '' : collectSectionTitle({ no: 1, title: '先看这一笔缺什么' }),
+        collectMissingTags({ labels: blocked.map((i) => i.label) }),
+        summaryRow(factsOf(row, params)),
+        collectSectionTitle({ no: 2, title: id === null ? '先挑一条记录' : '核对这一条' }),
+        blockedFold(blocked, blockedCommand(params, blocked)),
+        middle.join(''),
+        promptCopyArea(promptOf({ id, row, deleted, blocked, params }), '挑好记录后照这句跟助手说一遍'),
+        copyArea({
+            data: { envelope },
+            log: {
+                envelope,
+                copyLog: copyLog({
+                    command: commandLine(KEY, params),
+                    source: input.source,
+                    detail: '没写库（采集页）',
+                    actionAt: input.actionAt,
+                    version: DOC_VERSION,
+                }),
+            },
+        }),
+    ].join('');
+    return pageShell({
+        docTitle: DOC_TITLE + '·补齐槽位',
+        title: WAKE + ' · ' + (id === null ? '挑一条记录' : '确认改动'),
+        subtitle,
+        slot: 'collect',
+        page: 'collect',
+        shape: envelope.shape,
+        key: KEY,
+        content,
+    });
+}
+/** 回执页整页：类型徽章（写库成功）→ 一张大网格 → 写入明细表 → 对账折叠区 → 退出口 → 复制区三件。
+ *  diff 表落在**落库前**那一面（回执这一面拿不到原值，`ReceiptInput` 只给写后的真值），页上照实说清。 */
+function receiptOf(input) {
+    const { params, receipt } = input;
+    const envelope = {
+        version: DOC_VERSION, skill: DOC_SKILL, shape: 'receipt', key: sceneKeyOf(KEY),
+        data: { ok: true, message: receipt.summary },
+    };
+    const content = [
+        typeBadge({
+            kind: '',
+            status: 'ok',
+            state: '写库成功',
+            next: '这一笔已记下，撤销见下方按钮。',
+        }),
+        renderKpiGrid([
+            ...summaryCards(input.facts),
+            receiptStatusCard(receipt, input.writtenDetail),
+            { label: '这次记了几笔', value: receipt.affectedRows + ' 笔', detail: '按库里的改动算' },
+            {
+                label: '写进去的项',
+                value: receipt.writtenFields.length + ' 项',
+                detail: receipt.writtenFields.map((f) => fieldLabelOf(f)).join('、') || '没改到任何一项',
+            },
+        ]),
+        renderCaliberLine('这一页只报写后的真值，改前改后对照落在写库前那一面。'),
+        renderDataTable({
+            columns: [{ key: 'k', label: '哪一项' }, { key: 'v', label: '记成什么' }],
+            rows: input.detail,
+            caption: '写进去的项与值',
+        }),
+        reconcileDisclosure(receipt),
+        receipt.recordId === null ? '' : undoExit(receipt.recordId),
+        copyArea({
+            data: { envelope },
+            log: {
+                envelope,
+                copyLog: copyLog({
+                    command: commandLine(KEY, params),
+                    source: receipt.source,
+                    detail: '改了 ' + receipt.affectedRows + ' 笔，写进去 '
+                        + (receipt.writtenFields.map((f) => fieldLabelOf(f)).join('、') || '没改到任何一项'),
+                    actionAt: receipt.actionAt,
+                    version: DOC_VERSION,
+                }),
+            },
+        }),
+    ].join('');
+    return pageShell({
+        docTitle: DOC_TITLE + '·写库回执',
+        title: WAKE + ' · 回执',
+        subtitle: receipt.summary,
+        slot: 'receipt',
+        page: 'receipt',
+        shape: envelope.shape,
+        key: KEY,
+        content,
+    });
+}
+export const SCENE = {
+    id: 'update',
+    wakeWord: WAKE,
+    key: KEY,
+    kind: '',
+    op: '',
+    family: '批量与修正族',
+    collect: collectOf,
+    receipt: receiptOf,
+};
+//# sourceMappingURL=scene-update.js.map

package/dist/record/scene-update.js.map

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

package/dist/record/scene.d.ts

@@ -0,0 +1,79 @@
+/** 写入域场景件的公共契约与落点表（**唯一定义地**）。
+ *
+ * 本件回答两件事：
+ *   ① 一件场景件长什么样——`Scene`（id／唤醒词／命令全名／认的 kind／认的 op／待哪一族窗口来填／两张页的装配函数）；
+ *   ② 一条命令该落哪一件——`sceneFor`，判定只有四条（见该函数）。
+ *
+ * `SCENES` 是 16 行的落点表：13 条 `bill.record.add`（含无 kind 的通用词「记一笔」）＋
+ *  `bill.record.update` 的改记录／撤销／恢复三支，一条词一行、一件。这张表与
+ *  `docs/skills/skill-bill/t407-场景落点清单.md` 是同一件事的两面：清单给人看，这张表给分派看。
+ *
+ * 拆件的用意：拆件前 16 条词共用 `collect.ts`／`receipt.ts` 两个件里的装配体，同一时刻只允许一个执行者在写，
+ *  15 张页只能串行；拆成一场景一件之后，三族窗口各改各那一件，零文件重叠。
+ * 本票**只搬不改行为**：16 件现在都指同一对通用装配体（`./collectBody.ts`／`./receiptBody.ts`），
+ *  逐条真跑的产物与拆件前逐字节同量级（读数见 `t407-拆件与三个缺口块-证据.md` 第六节）。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/record/collect.ts`——采集页分派：`sceneFor` 取件，叫它的 `collect`；
+ *   ② `src/record/receipt.ts`——回执页分派：同一件，叫它的 `receipt`。
+ */
+import type { BillRow } from '../fetch/db.js';
+import type { SummaryFacts } from '../shared/summaryRow.js';
+import type { BillReceipt } from '../shared/writeParts.js';
+import type { RecordSlot } from './slots.js';
+/** 采集页入参：时刻与来源由调用方给（共用位不取时钟、不取库文件名）；`recent`＝近期记录（预填／重复检测／候选三处共用）。 */
+export interface CollectInput {
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    readonly slots: readonly RecordSlot[];
+    readonly missing: readonly RecordSlot[];
+    readonly source: string;
+    readonly actionAt: string;
+    /** 本页执行那天（`YYYY-MM-DD`）：缺省时间的取值、重复检测的比对面都用它。 */
+    readonly today: string;
+    /** 近期记录（按时间倒序，最近在先）；取数由处理体给，页面不碰库。 */
+    readonly recent: readonly BillRow[];
+}
+/** 回执页入参：回执事实 ＋ 本次写入的明细行 ＋ 一句写入去向的说明（`receiptStatusCard` 要它）
+ *  ＋ 摘要行的六个事实 ＋ 近期记录（重复检测用；取数由处理体给，页面不碰库）。 */
+export interface ReceiptInput {
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    readonly receipt: BillReceipt;
+    readonly writtenDetail: string;
+    /** 明细表的行（本次写入的字段与值）；写成字面量类型（不是 interface）的理由见 `receiptBody.ts`。 */
+    readonly detail: readonly {
+        readonly k: string;
+        readonly v: string;
+    }[];
+    readonly facts: SummaryFacts;
+    readonly recent: readonly BillRow[];
+}
+/** 一件场景件：一条唤醒词的落点。 */
+export interface Scene {
+    /** 件的名字（与文件名 `scene-<id>.ts` 对得上）。 */
+    readonly id: string;
+    /** 这一件服务的唤醒词（一条词一件）。 */
+    readonly wakeWord: string;
+    /** 命令全名（`bill.record.add` 或 `bill.record.update`）。 */
+    readonly key: string;
+    /** 认的 `kind` 值（空串＝这一件不按 kind 认，靠命令名落）。 */
+    readonly kind: string;
+    /** 认的 `op` 值（空串＝这一件不按 op 认）。 */
+    readonly op: string;
+    /** 待哪一族窗口来填这一件的页（三族：基础收支族／特殊收支族／批量与修正族）。 */
+    readonly family: string;
+    /** 这一件的过程型采集页（缺项那一支）。 */
+    readonly collect: (input: CollectInput) => string;
+    /** 这一件的结果型回执页（写库成功那一支）。 */
+    readonly receipt: (input: ReceiptInput) => string;
+}
+/** 16 行的落点表（**唯一定义地**）。顺序与 `t407-场景落点清单.md` 一致：先 13 条录入词，后 3 条修正词。 */
+export declare const SCENES: readonly Scene[];
+/** 取件（判定只有四条，见件头；认不得的 kind 落「记一笔」，不猜、不抛——命令本身已由注册表拦过）。 */
+export declare function sceneFor(input: {
+    readonly key: string;
+    readonly kind?: string;
+    readonly op?: string;
+}): Scene;
+//# sourceMappingURL=scene.d.ts.map

package/dist/record/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/record/scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkB7C,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED;8CAC8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED,sBAAsB;AACtB,MAAM,WAAW,KAAK;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,CAAC;IAClD,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,CAAC;CACnD;AAED,sEAAsE;AACtE,eAAO,MAAM,MAAM,EAAE,SAAS,KAAK,EAIlC,CAAC;AAKF,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAS7G"}

package/dist/record/scene.js

@@ -0,0 +1,39 @@
+import { SCENE as sceneBorrow } from './scene-borrow.js';
+import { SCENE as sceneBatch } from './scene-batch.js';
+import { SCENE as sceneCollect } from './scene-collect.js';
+import { SCENE as sceneExpense } from './scene-expense.js';
+import { SCENE as sceneIncome } from './scene-income.js';
+import { SCENE as sceneInstallment } from './scene-installment.js';
+import { SCENE as sceneLend } from './scene-lend.js';
+import { SCENE as scenePhoto } from './scene-photo.js';
+import { SCENE as scenePlain } from './scene-plain.js';
+import { SCENE as sceneRefund } from './scene-refund.js';
+import { SCENE as sceneReimburse } from './scene-reimburse.js';
+import { SCENE as sceneReimburseDone } from './scene-reimburse-done.js';
+import { SCENE as sceneRepay } from './scene-repay.js';
+import { SCENE as sceneRestore } from './scene-restore.js';
+import { SCENE as sceneUndo } from './scene-undo.js';
+import { SCENE as sceneUpdate } from './scene-update.js';
+/** 16 行的落点表（**唯一定义地**）。顺序与 `t407-场景落点清单.md` 一致：先 13 条录入词，后 3 条修正词。 */
+export const SCENES = [
+    sceneExpense, sceneIncome, scenePhoto, sceneBatch, sceneRefund, sceneReimburse, sceneReimburseDone,
+    sceneLend, sceneBorrow, sceneCollect, sceneRepay, sceneInstallment, scenePlain,
+    sceneUpdate, sceneUndo, sceneRestore,
+];
+const BY_KIND = new Map(SCENES.filter((s) => s.kind !== '').map((s) => [s.kind, s]));
+const BY_OP = new Map(SCENES.filter((s) => s.op !== '').map((s) => [s.op, s]));
+/** 取件（判定只有四条，见件头；认不得的 kind 落「记一笔」，不猜、不抛——命令本身已由注册表拦过）。 */
+export function sceneFor(input) {
+    const kind = typeof input.kind === 'string' ? input.kind : '';
+    const op = typeof input.op === 'string' ? input.op : '';
+    const byKind = BY_KIND.get(kind);
+    if (kind !== '' && byKind !== undefined)
+        return byKind;
+    const byOp = BY_OP.get(op);
+    if (byOp !== undefined)
+        return byOp;
+    if (input.key === 'bill.record.update')
+        return sceneUpdate;
+    return scenePlain;
+}
+//# sourceMappingURL=scene.js.map

package/dist/record/scene.js.map

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

package/dist/record/slots.d.ts

@@ -0,0 +1,16 @@
+/** 一个槽位：参数名／中文名／怎么给／是否必需。
+ *  中文名的**唯一定义地**是 `../shared/userWording.js` 的 `fieldLabelOf`（库列名与用户说法只在那里对照一次）：
+ *  本表只写参数名与怎么给，中文名由它派生——两处各写一份中文名就会走散。 */
+export interface RecordSlot {
+    readonly name: string;
+    readonly label: string;
+    readonly hint: string;
+    readonly required: boolean;
+}
+/** 两条写命令的槽位表。提示句都是**用户说法**：`缺省＝…` 这类口径词不上屏（本轮整改）。 */
+export declare const RECORD_SLOTS: Record<string, readonly RecordSlot[]>;
+/** 一个值算不算「给了」：`undefined`／`null`／空白串都不算。数字 `0` 视同没给（金额 0 本仓不记，裁定第 3 条）。 */
+export declare function isGiven(v: unknown): boolean;
+/** 必需槽位里哪些没给（**只探针，不做真值校验**）。金额栏另判数字 `0` 与 `"0"` 串：它们视同没给。 */
+export declare function missingSlots(params: Record<string, unknown>, slots: readonly RecordSlot[]): RecordSlot[];
+//# sourceMappingURL=slots.d.ts.map

package/dist/record/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/record/slots.ts"],"names":[],"mappings":"AAoBA;;0CAE0C;AAC1C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAOD,qDAAqD;AACrD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAqB9D,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAI3C;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAWxG"}

package/dist/record/slots.js

@@ -0,0 +1,72 @@
+/** 写入域两条写命令的槽位表与缺项探针（**唯一定义地**，本票从 `collect.ts` 原样搬来）。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/record/write.ts`——两条写命令的处理体：拿 `missingSlots` 探「必需槽位在不在」，
+ *      拿 `RECORD_SLOTS` 派生「记一笔写进库的列全集」；
+ *   ② `src/record/collect.ts`（经它转出给三套测试）与 `src/record/collectBody.ts`——采集页按槽位表出表单。
+ *  第二个消费者：`src/query/`（随兄弟图 #403 的查询域一起到位，同一套采集页要同一张槽位表）。
+ *
+ * 「一条命令要哪些槽位、哪个必需」与「表单怎么摆」原本同住一件；本票按场景拆件时把前者单独搬到这里，
+ *  理由：场景件只管自己那张页怎么摆，槽位表是两条命令共有的**事实**，搬进场景件就会各抄一份。
+ *
+ * 必需性照 `src/policy/category.ts` 的 `validateRecord`：分类与金额没有缺省值（必需），
+ *  时间／账户／账本／币种／备注都有缺省值（可缺）。七槽里的「名目」没有库列：它落在三级分类的最后一段
+ *  （如 `餐饮/外卖/午餐`）或备注里，提示里写明。
+ *  `missingSlots` 只做「在不在」的探针；方向不符那一半住 `../shared/blockedSlots.ts` 的 `blockedItems`，
+ *  **只服务录入路径**（`bill.record.add` 采集页传 `kind`；`bill.record.update` 那一支不判方向）。
+ *  真值校验仍走 `src/policy` 的 `validateAddInput`／`validateUpdateInput`（阻断项清空后才走到那一步）。
+ */
+import { fieldLabelOf } from '../shared/userWording.js';
+/** 一条槽位（中文名走映射件，不在这里另写一份对照）。 */
+function slot(name, hint, required) {
+    return { name, label: fieldLabelOf(name), hint, required };
+}
+/** 两条写命令的槽位表。提示句都是**用户说法**：`缺省＝…` 这类口径词不上屏（本轮整改）。 */
+export const RECORD_SLOTS = {
+    'bill.record.add': [
+        slot('category', '三级分类，如 餐饮/外卖/午餐。要选到最细那一级', true),
+        slot('amount', '支出记负数、收入记正数，如 -12.5', true),
+        slot('time', '不填就记成今天 12:00:00', false),
+        slot('account', '不填就记到默认账户', false),
+        slot('ledger', '不填就记到默认账本', false),
+        slot('currency', '不填就用默认币种', false),
+        slot('note', '自由文本；名目写在这里，可带 #标签', false),
+    ],
+    'bill.record.update': [
+        slot('id', '要改的那条记录的编号（撤销／恢复同样要它）', true),
+        slot('op', '不填＝改字段；undo＝撤销／restore＝恢复', false),
+        slot('category', '不改就别给', false),
+        slot('amount', '不改就别给', false),
+        slot('time', '不改就别给', false),
+        slot('account', '不改就别给', false),
+        slot('ledger', '不改就别给', false),
+        slot('currency', '不改就别给', false),
+        slot('note', '不改就别给', false),
+    ],
+};
+/** 一个值算不算「给了」：`undefined`／`null`／空白串都不算。数字 `0` 视同没给（金额 0 本仓不记，裁定第 3 条）。 */
+export function isGiven(v) {
+    if (v === undefined || v === null)
+        return false;
+    if (typeof v === 'number' && v === 0)
+        return false;
+    return !(typeof v === 'string' && v.trim() === '');
+}
+/** 必需槽位里哪些没给（**只探针，不做真值校验**）。金额栏另判数字 `0` 与 `"0"` 串：它们视同没给。 */
+export function missingSlots(params, slots) {
+    return slots.filter((s) => {
+        if (!s.required)
+            return false;
+        const v = params[s.name];
+        if (!isGiven(v))
+            return true;
+        if (s.name === 'amount') {
+            if (typeof v === 'number' && v === 0)
+                return true;
+            if (typeof v === 'string' && v.trim() !== '' && Number(v.trim()) === 0)
+                return true;
+        }
+        return false;
+    });
+}
+//# sourceMappingURL=slots.js.map

package/dist/record/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../src/record/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYxD,gCAAgC;AAChC,SAAS,IAAI,CAAC,IAAY,EAAE,IAAY,EAAE,QAAiB;IACzD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC7D,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAA0C;IACjE,iBAAiB,EAAE;QACjB,IAAI,CAAC,UAAU,EAAE,0BAA0B,EAAE,IAAI,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,qBAAqB,EAAE,IAAI,CAAC;QAC3C,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC;QAClC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,CAAC;KAC1C;IACD,oBAAoB,EAAE;QACpB,IAAI,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,2BAA2B,EAAE,KAAK,CAAC;QAC9C,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC;QAChC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC;QAC9B,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;QAC5B,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC;QAC/B,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC;QAC9B,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;KAC7B;CACF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,UAAU,OAAO,CAAC,CAAU;IAChC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,MAA+B,EAAE,KAA4B;IACxF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,IAAI,CAAC,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7B,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAClD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QACtF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/record/write.d.ts

@@ -0,0 +1,9 @@
+import type { BillDb } from '../fetch/index.js';
+import type { WriteOut } from '../shared/commandSpec.js';
+/** `bill.record.add`（记一笔，**录入路径**）：有阻断项（缺分类或金额／金额符号与这一型不符）即出采集页，
+ *  清空即写库出回执整页。方向判定只在这一支传 `kind`。 */
+export declare function writeRecordAdd(params: Record<string, unknown>, db: BillDb): WriteOut;
+/** `bill.record.update`（改记录）：有阻断项（缺 `id`）即出采集页；op 决定改字段／撤销／恢复三支。
+ *  **这一支不判金额方向**：撤销／恢复本来就不带 `kind`＋`amount`，带上也不该被方向判定拦下、改出采集页。 */
+export declare function writeRecordUpdate(params: Record<string, unknown>, db: BillDb): WriteOut;
+//# sourceMappingURL=write.d.ts.map

package/dist/record/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/record/write.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,MAAM,EAAW,MAAM,mBAAmB,CAAC;AAIzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAoIzD;oCACoC;AACpC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAqBpF;AAED;mEACmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CA0CvF"}