skill-bill 0.1.0 → 0.2.1

package/dist/write/receiptOut.js

@@ -0,0 +1,13 @@
+/** 写入域·写命令的结果载荷（#689 结构搬迁第三批：从 `src/render/views.ts` 的 `buildRecordReceipt` 来）。
+ *  一件事实：写类命令的 envelope 载荷 `{ ok: true, message }`（形状照 `src/shared/commandSpec.ts` 的
+ *  `WriteOut['data']` 前两格：`ok` ＋ `message`；`receipt` 那一格由 `./write.ts` 另加）。
+ *  `src/render/views.ts` 已随本批拆散删除，载荷的唯一书写位就是本件。
+ *
+ *  谁在用（指名）：
+ *    · `./write.ts`——记一笔／改记录两条命令写库成功后的回执载荷；
+ *    · `src/cli/cmd_read.ts`——goal／account／link／setup 四族**尚未迁移**命令的分派（经 `./index.js` 门取），
+ *      以及 setup 的导入分支；这些命令各自搬进本域后，那一处消费随之消失。 */
+export function buildRecordReceipt(message) {
+    return { ok: true, message };
+}
+//# sourceMappingURL=receiptOut.js.map

package/dist/write/receiptOut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiptOut.js","sourceRoot":"","sources":["../../src/write/receiptOut.ts"],"names":[],"mappings":"AAAA;;;;;;;;gDAQgD;AAChD,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/write/receiptParts.d.ts

@@ -0,0 +1,12 @@
+import type { KpiCardInput } from 'base-paint/blocks';
+import type { BillReceipt } from '../shared/writeParts.js';
+/** 一格的状态值：值 ＋ 一句说明（说明由调用方按本页措辞传入）。 */
+export declare function statusCard(value: string, detail: string): KpiCardInput;
+/** 回执页的状态卡：无改动／已改动 ＋ 一句写入去向的说明。 */
+export declare function receiptStatusCard(receipt: BillReceipt, writtenDetail: string): KpiCardInput;
+/** 页尾「对账信息」折叠区：本次写入的**可核对信息**——记录编号／写入时间。
+ *  这次记了几笔与写进去的项已在上方卡片上，这里不重写。
+ *  本轮整改删掉两行内部话（照 `docs/skills/skill-bill/t407-文字审查.md` 第 54 条）：
+ *  `本地时钟` 与 `回执格式 / v1（写库回执）`——前者是实现细节，后者是版本自指，用户都拿它没动作可做。 */
+export declare function reconcileDisclosure(receipt: BillReceipt): string;
+//# sourceMappingURL=receiptParts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"receiptParts.d.ts","sourceRoot":"","sources":["../../src/write/receiptParts.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,sCAAsC;AACtC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAEtE;AAED,mCAAmC;AACnC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CAK3F;AAED;;;8DAG8D;AAC9D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAWhE"}

package/dist/write/receiptParts.js

@@ -0,0 +1,38 @@
+/** 写后回执页与采集页的两块共用件：状态卡 ＋ 页尾「对账信息」折叠区。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/write/receipt.ts`——结果型回执整页：`receiptStatusCard`（已改动／无改动）＋ `reconcileDisclosure`；
+ *   ② `src/write/collect.ts`——过程型采集页：`statusCard`（那一格写「待补槽位」）。
+ *  第二个消费者：`src/query/`（随兄弟图 #403 的查询域一起到位，出来的是同一套采集页／回执页／复制区）。
+ *
+ * 口径出处：照 `packages/skill-calorie/src/write/receiptParts.ts` 的两块（状态卡＋页尾对账折叠区），
+ *   分「块」与「整页」的分工也照它：整页装配住同目录 `docPage.ts`，本文件只出页内的两块。
+ * 一处由调用方给的措辞：**写入去向那句说明**（`writtenDetail`）——记一笔写的是账单、改记录改的是同一条，
+ *   两边说法不同，故它是必填参数，不给默认值，免得哪张页悄悄用了别处的说法。
+ */
+import { renderDataTable, renderDisclosure } from 'base-paint/blocks';
+/** 一格的状态值：值 ＋ 一句说明（说明由调用方按本页措辞传入）。 */
+export function statusCard(value, detail) {
+    return { label: '状态', value, detail };
+}
+/** 回执页的状态卡：无改动／已改动 ＋ 一句写入去向的说明。 */
+export function receiptStatusCard(receipt, writtenDetail) {
+    return statusCard(receipt.noChange ? '无改动' : '已改动', receipt.noChange ? '值与改前一致' : writtenDetail);
+}
+/** 页尾「对账信息」折叠区：本次写入的**可核对信息**——记录编号／写入时间。
+ *  这次记了几笔与写进去的项已在上方卡片上，这里不重写。
+ *  本轮整改删掉两行内部话（照 `docs/skills/skill-bill/t407-文字审查.md` 第 54 条）：
+ *  `本地时钟` 与 `回执格式 / v1（写库回执）`——前者是实现细节，后者是版本自指，用户都拿它没动作可做。 */
+export function reconcileDisclosure(receipt) {
+    return renderDisclosure({
+        title: '对账信息',
+        contentHtml: renderDataTable({
+            columns: [{ key: 'k', label: '哪一项' }, { key: 'v', label: '记成什么' }],
+            rows: [
+                { k: '记录编号', v: receipt.recordId === null ? '还没有' : String(receipt.recordId) },
+                { k: '写入时间', v: receipt.actionAt },
+            ],
+        }),
+    });
+}
+//# sourceMappingURL=receiptParts.js.map

package/dist/write/receiptParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiptParts.js","sourceRoot":"","sources":["../../src/write/receiptParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKtE,sCAAsC;AACtC,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAc;IACtD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,iBAAiB,CAAC,OAAoB,EAAE,aAAqB;IAC3E,OAAO,UAAU,CACf,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAChC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAC5C,CAAC;AACJ,CAAC;AAED;;;8DAG8D;AAC9D,MAAM,UAAU,mBAAmB,CAAC,OAAoB;IACtD,OAAO,gBAAgB,CAAC;QACtB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,eAAe,CAAC;YAC3B,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAClE,IAAI,EAAE;gBACJ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAC9E,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;aACnC;SACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/write/recentPicks.d.ts

@@ -0,0 +1,34 @@
+/** 近期记录取候选值（**唯一定义地**）：三枚选择器（分类／账户／账本）的候选怎么取——值转字符串、
+ *  按最近在先去重、剔掉没给的、取前十二个；再把本次已给的值并进那一格。
+
+ * 谁在用（两处，指名；两处原先各写一份同形同名的取数，本次提到本件一处）：
+ *   ① `src/write/photoEscape.ts`——三级分类候选那一格，它的 `pickOf` 一行转发到本件；
+ *   ② `src/write/template-expense.ts` 的采集页那一格，它的 `pickOf` 同样一行转发到本件
+ *      （那一格原住已删除的 `src/write/collectBody.ts`）。
+
+ * 本件只吃普通数据、零跨目录引用：入参是「近期记录那几列」与「本次参数」这种普通数据，
+ *  **不引** `src/write/` 下的件，也不认 `CollectInput` 这类页面入参形状。可引的只有
+ *  `src/fetch/db.ts`（记录行的数据形状）与 `src/shared/category.ts`（缺省那一格）。
+
+ * 口径（一处定义，别处不许再写第二份）：
+ *   - 候选上限**十二个**（`PICK_LIMIT`）：三枚选择器共用这一个数；
+ *   - 取值口径：非字符串按空串用、数字写成十进制串、两头空白剪掉；空白串不算一个候选；
+ *   - 分类一条历史都没有时退到**调用方给的 L1 名单**（哪一侧由调用方定，本件不判方向）；
+ *   - 一个字段的选项＝候选 ＋ 本次已给的值（已给的值不在候选里时并到队首，免得表单把它显示没了）。
+ */
+import type { BillRow } from '../fetch/db.js';
+/** 一个值的字符串形态（非字符串按空串用；数字写成十进制串）。 */
+export declare function textOf(v: unknown): string;
+/** 三枚选择器的候选：分类（近期有历史就用历史，一条历史都没有就退到 `fallbackCategory` 给的名单）／
+ *  账户／账本（缺省「生活」）。**分类退到哪一侧由调用方定**：本件不收方向这一格。 */
+export declare function pickOf(recent: readonly BillRow[], fallbackCategory: readonly string[]): Record<string, readonly string[]>;
+/** 一个值的显示写法（见上）。 */
+export declare function optionLabelOf(value: string): string;
+/** 一个字段的选项：选择器候选 ＋ 本次已给的值（已给的值不在候选里时并到队首，免得表单把它显示没了）。
+ *  带层级斜线的值落 `{ value, label }` 对象项（#474 的对照项：`value` 是机器值、`label` 给人看）；
+ *  不带层级的仍是普通字符串项，调用方与产物都不变。 */
+export declare function optionsFor(pick: Record<string, readonly string[]>, name: string, value: string): readonly (string | {
+    readonly value: string;
+    readonly label: string;
+})[] | undefined;
+//# sourceMappingURL=recentPicks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recentPicks.d.ts","sourceRoot":"","sources":["../../src/write/recentPicks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAGzC;AAaD;gDACgD;AAChD,wBAAgB,MAAM,CACpB,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CASnC;AAcD,oBAAoB;AACpB,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;+BAE+B;AAC/B,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,SAAS,CAAC,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,GAAG,SAAS,CAQtF"}

package/dist/write/recentPicks.js

@@ -0,0 +1,65 @@
+import { DEFAULTS } from '../shared/category.js';
+/** 候选选择器的取数上限（三枚选择器：分类／账户／账本）。**收在件内**：外面不需要知道这个数。 */
+const PICK_LIMIT = 12;
+/** 一个值的字符串形态（非字符串按空串用；数字写成十进制串）。 */
+export function textOf(v) {
+    if (typeof v === 'string')
+        return v.trim();
+    return typeof v === 'number' ? String(v) : '';
+}
+/** 近期记录里某个字段的取值（按最近在先去重，取前 `PICK_LIMIT` 个）——三枚选择器的候选。**收在件内**。 */
+function distinctOf(recent, field) {
+    const out = [];
+    for (const r of recent) {
+        const v = textOf(r[field]);
+        if (v !== '' && !out.includes(v))
+            out.push(v);
+        if (out.length >= PICK_LIMIT)
+            break;
+    }
+    return out;
+}
+/** 三枚选择器的候选：分类（近期有历史就用历史，一条历史都没有就退到 `fallbackCategory` 给的名单）／
+ *  账户／账本（缺省「生活」）。**分类退到哪一侧由调用方定**：本件不收方向这一格。 */
+export function pickOf(recent, fallbackCategory) {
+    const category = distinctOf(recent, 'category');
+    const account = distinctOf(recent, 'account');
+    const ledger = distinctOf(recent, 'ledger');
+    return {
+        category: category.length > 0 ? category : fallbackCategory,
+        account,
+        ledger: ledger.length > 0 ? ledger : [DEFAULTS.ledger],
+    };
+}
+/** 三级分类路径在页面上的**显示写法**：`借贷/偿还` → `借贷 › 偿还`。**t728 新增**。
+ *
+ *  为什么要有这一条：库里存的是 `一级/二级[/三级]` 的**层级值**——那是事实，一个字不改；
+ *  而原样上屏就等于把「这是三层」这件事交给一个斜线去排版，正是用户逐字点名的那类写法
+ *  （「当一个内容需要通过 `；`／`|`／`·` 分割时代表需要进行 UI 上的设计」）。层级值改用
+ *  **层级字形** `›`（U+203A，面包屑的惯用写法），一眼看出「右边比左边细一级」。
+ *  机器值仍是原来那一个：`<option value="借贷/偿还">` 不动，选完递回宿主的还是库里的原值——
+ *  只改给人看的那一面，页面事实与复制载荷文本一个字不变。
+ *  判据：只在值里真带层级斜线时才改标签；普通值原样返回（调用方据此决定落对象项还是字符串项，
+ *  不带层级的值走的还是原来那条路，产物逐字节不变）。 */
+const LEVEL_MARK = '›';
+/** 一个值的显示写法（见上）。 */
+export function optionLabelOf(value) {
+    if (!value.includes('/'))
+        return value;
+    const segs = value.split('/').map((s) => s.trim()).filter((s) => s !== '');
+    return segs.length < 2 ? value : segs.join(' ' + LEVEL_MARK + ' ');
+}
+/** 一个字段的选项：选择器候选 ＋ 本次已给的值（已给的值不在候选里时并到队首，免得表单把它显示没了）。
+ *  带层级斜线的值落 `{ value, label }` 对象项（#474 的对照项：`value` 是机器值、`label` 给人看）；
+ *  不带层级的仍是普通字符串项，调用方与产物都不变。 */
+export function optionsFor(pick, name, value) {
+    const list = pick[name];
+    if (list === undefined || list.length === 0)
+        return undefined;
+    const merged = value !== '' && !list.includes(value) ? [value, ...list] : [...list];
+    return merged.map((v) => {
+        const label = optionLabelOf(v);
+        return label === v ? v : { value: v, label };
+    });
+}
+//# sourceMappingURL=recentPicks.js.map

package/dist/write/recentPicks.js.map

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

package/dist/write/record.d.ts

@@ -0,0 +1,13 @@
+import { validateRecord } from '../shared/category.js';
+import { needId } from '../shared/params.js';
+import type { RecordOp } from '../shared/params.js';
+/** `id` 槽位与 `op` 取值集（口径住 `../shared/params.js`），本件照写域的门面转出。 */
+export { needId };
+export type { RecordOp };
+export declare function parseRecordOp(params: Record<string, unknown>): RecordOp;
+export declare function validateAddInput(params: Record<string, unknown>): ReturnType<typeof validateRecord>;
+export declare function validateUpdateInput(params: Record<string, unknown>): {
+    id: number;
+    patch: Record<string, unknown>;
+};
+//# sourceMappingURL=record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/write/record.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoC,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEzF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,+DAA+D;AAC/D,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAIvE;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAEnG;AAGD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAgBnH"}

package/dist/{policy → write}/record.js

@@ -1,20 +1,22 @@
-// 口径层·记账 params 校验（老家 record_bill.py + write/cli.py 对应）。
-// op 分流：add（单笔/批量逐笔）/ update / undo（软删）/ restore；拍账单图片识别以外置为准。
+/** 写入域·记账命令 params 校验（#689 结构搬迁第三批：从 `src/policy/record.ts` 的写校验半来）。
+ *  op 分流：add（单笔/批量逐笔）/ update / undo（软删）/ restore；拍账单图片识别以外置为准。
+ *  日期与时间窗口那半另住 `src/shared/dateRange.ts`（查询／分析／目标三处也在用）；`id` 槽位守卫与
+ *  `op` 取值集住 `src/shared/params.ts`（写域与查询域两边都在取，本件照本域门面转出这两件）。
+ *
+ *  谁在用（指名）：`src/write/write.ts`——两条写命令的处理体（`parseRecordOp`／`needId`／
+ *    `validateAddInput`／`validateUpdateInput`）与回执事实里的 `RecordOp`。 */
 import { BillPolicyError } from '../fetch/errors.js';
-import { validateAmount, validateCategory, validateTime, validateRecord, normalizeDate } from './category.js';
+import { validateAmount, validateCategory, validateRecord } from '../shared/category.js';
+import { validateTime } from '../shared/dateRange.js';
+import { needId } from '../shared/params.js';
+/** `id` 槽位与 `op` 取值集（口径住 `../shared/params.js`），本件照写域的门面转出。 */
+export { needId };
 export function parseRecordOp(params) {
     const op = params.op === undefined ? 'add' : params.op;
     if (op === 'add' || op === 'update' || op === 'undo' || op === 'restore')
         return op;
     throw new BillPolicyError('POLICY_BAD_INPUT', 'op 非法（期望 add/update/undo/restore）：' + JSON.stringify(op));
 }
-export function needId(params) {
-    const id = params.id;
-    if (!Number.isInteger(id) || id <= 0) {
-        throw new BillPolicyError('POLICY_BAD_INPUT', '须给正整数 id');
-    }
-    return id;
-}
 // add：7 字段强校验（批量由调用方逐笔调本函数，不在此展开数组）。
 export function validateAddInput(params) {
     return validateRecord(params);
@@ -41,22 +43,4 @@ export function validateUpdateInput(params) {
     }
     return { id, patch };
 }
-export function resolveQueryDate(params) {
-    if (params.date === undefined || params.date === null || params.date === '') {
-        return new Date().toISOString().slice(0, 10);
-    }
-    if (typeof params.date !== 'string')
-        throw new BillPolicyError('POLICY_BAD_TIME', 'date 须为字符串');
-    return normalizeDate(params.date);
-}
-export function resolveRange(params) {
-    if (params.start === undefined || params.end === undefined) {
-        throw new BillPolicyError('POLICY_MISSING_SLOT', '缺槽位 start/end（期望 YYYY-MM-DD）');
-    }
-    const start = normalizeDate(params.start, 'start');
-    const end = normalizeDate(params.end, 'end');
-    if (start > end)
-        throw new BillPolicyError('POLICY_BAD_INPUT', 'start 不得晚于 end：' + start + '~' + end);
-    return { start, end };
-}
 //# sourceMappingURL=record.js.map

package/dist/write/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/write/record.ts"],"names":[],"mappings":"AAAA;;;;;;qEAMqE;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,+DAA+D;AAC/D,OAAO,EAAE,MAAM,EAAE,CAAC;AAGlB,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACvD,IAAI,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACpF,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,oCAAoC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,gBAAgB,CAAC,MAA+B;IAC9D,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtE,KAAK,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;QAC1D,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ;gBAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC;YAC/F,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,mEAAmE,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AACvB,CAAC"}

package/dist/write/recordPicker.d.ts

@@ -0,0 +1,32 @@
+import type { BillRow } from '../fetch/db.js';
+import type { DiffRow } from './diffTable.js';
+/** `params.op` 落哪一种过筛条件（缺省＝改字段那一条）。 */
+export declare function pickModeOf(op: unknown): 'update' | 'undo' | 'restore';
+/** 候选格整块：单选 ＋ 候选记录表 ＋「为什么是它」＋ 一行口径；候选为空或读不通都出空态（不拿最近一笔兜底）。 */
+export declare function pickerBlock(input: {
+    readonly mode: 'update' | 'undo' | 'restore';
+    /** 本次已经认准的那条（不给＝不预选）。 */
+    readonly selectedId?: number | null;
+    /** 换一句话说这一格（不给＝按 `mode` 的缺省那句）。 */
+    readonly hint?: string;
+}): string;
+/** 按编号读一条记录（**含已打标撤销的**，`getById` 读不到软删行，故本件走 `fetchAll` 自己筛）。
+ *  `deleted` 与 `row` 一次给全：软删口径只有 `isDeleted` 一处定义，调用方不再各判一次。 */
+export declare function readRowById(id: number): {
+    readonly ok: boolean;
+    readonly reason: string;
+    readonly row: BillRow | null;
+    readonly deleted: boolean;
+};
+/** 一条记录的只读表（列名与 `renderDataTable` 的两列同形）。
+ *  表头说明里那个 `·` 改全角空格（本轮整改：表头说明是版式位，行内不再拿 `·` 当版式）。 */
+export declare function snapshotTable(row: BillRow, caption?: string): string;
+/** 本次打算改的那几个字段的对照：**只比给了的那些字段**。
+ *  没给的字段不许进这张表——拿「未设置」当新值比，会把「这一格没动」算成「把这一格清空了」。 */
+export declare function diffRowsFor(input: {
+    readonly row: BillRow;
+    readonly params: Record<string, unknown>;
+    /** 允许改的字段名单（取自槽位表，本件不另抄一份）。 */
+    readonly fields: readonly string[];
+}): readonly DiffRow[];
+//# sourceMappingURL=recordPicker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recordPicker.d.ts","sourceRoot":"","sources":["../../src/write/recordPicker.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,gBAAgB,CAAC;AAMtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAoC9C,uCAAuC;AACvC,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAErE;AAwED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,yBAAyB;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CA2BT;AAED;gEACgE;AAChE,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG;IACvC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAWA;AAqBD;sDACsD;AACtD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpE;AAQD;oDACoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,GAAG,SAAS,OAAO,EAAE,CAGrB"}

package/dist/write/recordPicker.js

@@ -0,0 +1,201 @@
+/** 候选记录列表（**唯一定义地**）：改记录／撤销／恢复三条唤醒词共用的「挑哪一条记录」那一格，连它的取数。
+ *
+ * 谁在用（本票实数，三个调用点，指名）：
+ *   ① `src/write/scene-update.ts`——缺 `id` 时列候选（未撤销的那些），挑完再说改哪个字段；
+ *   ② `src/write/scene-undo.ts`——缺 `id` 时列候选（未撤销的那些；撤销＝软删打标，打完还能恢复）；
+ *   ③ `src/write/scene-restore.ts`——缺 `id` 时列候选（**只列已打标撤销的那些**）。
+ *  三条词挑的是同一件事（「哪一条记录」），不同的只是过筛条件：换 `mode`，不换件。
+ *
+ * 本件对外的名字**五个**（照 `docs/agents/structure.md` 的「一个文件对外给的东西不多于五个」）：
+ *   `pickModeOf`（`params.op` 落哪种过筛条件）、`pickerBlock`（那一格整块）、`readRowById`（按编号读一条，
+ *   连「是否已打标撤销」一次给全）、`snapshotTable`（一条记录的只读回显）、`diffRowsFor`（本次打算改的字段对照）。
+ *   其余五样收在件内、不外给：`PickMode`／`CandidateRead`（两个内部别名）、`isDeleted`（软删口径的唯一定义地）、
+ *   `readCandidates`（`pickerBlock` 的取数那一半）、`snapshotRows`（`snapshotTable` 的行）。
+ *   计数口径：只数真被本目录之外的件引用的名字，零跨目录引用的导出不算。
+ *
+ * 取数用**写入侧已有的读能力**（`src/fetch/` 的 `openBillDb`／`fetchAll`／`closeBillDb`）：
+ *  不新增查询命令、不等查询图 #403——列候选是写入流程内部的一步（挑完仍走同一条写命令）。
+ *  「撤销候选＝未删记录／恢复候选＝已软删记录」这条口径住本件，页面不再各判一次：
+ *  `fetchAll` 传 `includeDeleted: true` 才看得到软删行（`fetchAll` 的缺省口径把软删排除在外）。
+ *
+ * 一件不自造：单选与记录表走 `./candidatePick.js`（它自己包 base 的 `renderDataTable` 与
+ *  `renderParamForm` 的单选项），空态走 `./emptyNote.js`，金额文本走 `./summaryRow.js` 的 `money2`，
+ *  原值与新值的比对走 `./diffTable.js` 的 `diffOf`——三条词与改记录的回执都用同一份判定。
+ *
+ * 读不通不许静默：库路径没设、库打不开这些情形由本件报出来（`ok:false` ＋ `reason`），
+ *  页面据此出空态并把原因写在话里，不拿一张空表冒充「库里没有记录」。
+ */
+import { renderCaliberLine, renderDataTable } from 'base-paint/blocks';
+import { closeBillDb, fetchAll, openBillDb } from '../fetch/index.js';
+import { resolveDbPath } from '../fetch/paths.js';
+import { candidatePick } from './candidatePick.js';
+import { diffOf } from './diffTable.js';
+import { emptyNote } from './emptyNote.js';
+import { money2 } from './summaryRow.js';
+import { fieldLabelOf } from './userWording.js';
+/** 候选列表一页最多列几条（按时间倒序取最近的这些条）。 */
+const PICK_LIMIT = 20;
+const LABELS = {
+    update: {
+        label: '要改的那条记录',
+        what: '没撤销过的记录',
+        hint: '从下面列出的记录里挑一条，再说清要改哪一项、改成什么，跟助手说一遍。',
+    },
+    undo: {
+        label: '要撤销的那条记录',
+        what: '没撤销过的记录',
+        hint: '从下面列出的记录里挑一条：撤销只是打个标记，记录还在，随时可以恢复。',
+    },
+    restore: {
+        label: '要恢复的那条记录',
+        what: '已经撤销过的记录',
+        hint: '只列已经撤销过的那些：恢复＝把撤销标记清掉，这一笔回到查询与统计里。',
+    },
+};
+/** `params.op` 落哪一种过筛条件（缺省＝改字段那一条）。 */
+export function pickModeOf(op) {
+    return op === 'undo' ? 'undo' : op === 'restore' ? 'restore' : 'update';
+}
+/** 一条记录是不是打过软删标记。**软删口径的唯一定义地**：取数（`keeps`）与读一条（`readRowById`）都走它。 */
+function isDeleted(row) {
+    return row.deleted_at !== null && String(row.deleted_at).trim() !== '';
+}
+/** 这一条算不算这种 `mode` 的候选：恢复只认已打标的，其余两种只认没打标的。 */
+function keeps(mode, row) {
+    return mode === 'restore' ? isDeleted(row) : !isDeleted(row);
+}
+/** 时间倒序（同一时刻按编号倒序）：最近的一条摆在最前面。 */
+function byTimeDesc(a, b) {
+    if (a.time === b.time)
+        return b.id - a.id;
+    return a.time < b.time ? 1 : -1;
+}
+/** 一条候选为什么是它（**必填**：写不出依据的候选，用户没法判断该不该选）。
+ *  本轮整改把工程话换成用户说法（原文见 `docs/skills/skill-bill/t407-文字审查.md` 第 25、30 条）：
+ *  `未撤销（deleted_at 为空）· 就躺在库里等你处置` → 「还没撤销过 可以改」；
+ *  `已于 X 打标撤销（软删：行还在库里，置 NULL 即可恢复）` → 「已于 X 撤销过（记录还在，点恢复就回来）」。 */
+function whyOf(mode, row) {
+    if (mode === 'restore') {
+        return '已于 ' + String(row.deleted_at) + ' 撤销过（记录还在，点恢复就回来）';
+    }
+    return mode === 'update' ? '还没撤销过 可以改' : '还没撤销过 可以撤';
+}
+/** 候选行那一列的摘要：分类 ＋ 备注。
+ *  **不带账户**（本轮整改）：账户就在同页那张只读回显表的「账户」那一项里逐项列着，
+ *  候选表再抄一遍，同一句话在页上就印了两遍（机审判成重复句）。 */
+function pickLabelOf(row) {
+    return row.category + (row.note.trim() === '' ? '' : '　' + row.note.trim());
+}
+/** 单选选项那一格用的全量摘要：分类 ＋ 账户 ＋ 备注（分隔符用全角空格，行内不再拿 `·` 当版式）。 */
+function labelOf(row) {
+    const note = row.note.trim() === '' ? '' : '　' + row.note.trim();
+    return row.category + (row.account.trim() === '' ? '' : '　' + row.account) + note;
+}
+/** 读候选：开库读一遍、按 `mode` 过筛、按时间倒序取最近 `PICK_LIMIT` 条，读完关库。读不通照实报。 */
+function readCandidates(mode) {
+    let handle = null;
+    try {
+        handle = openBillDb(resolveDbPath());
+        const kept = fetchAll(handle, { includeDeleted: true }).filter((r) => keeps(mode, r));
+        const sorted = [...kept].sort(byTimeDesc);
+        const items = sorted.slice(0, PICK_LIMIT).map((r) => ({
+            id: r.id,
+            label: pickLabelOf(r),
+            amount: money2(r.amount),
+            time: r.time,
+            why: whyOf(mode, r),
+        }));
+        return { ok: true, reason: '', items, total: sorted.length };
+    }
+    catch (e) {
+        return { ok: false, reason: e instanceof Error ? e.message : String(e), items: [], total: 0 };
+    }
+    finally {
+        if (handle !== null)
+            closeBillDb(handle);
+    }
+}
+/** 候选格整块：单选 ＋ 候选记录表 ＋「为什么是它」＋ 一行口径；候选为空或读不通都出空态（不拿最近一笔兜底）。 */
+export function pickerBlock(input) {
+    const meta = LABELS[input.mode];
+    const read = readCandidates(input.mode);
+    if (!read.ok) {
+        return emptyNote({
+            title: '候选读不出来',
+            text: '这一格要的候选没能从库里读出来：' + read.reason + '。',
+            next: '请先在能读库的环境里跑（库路径指向那个库），再说一遍。',
+        });
+    }
+    if (read.items.length === 0) {
+        return emptyNote({
+            title: '没有可选的' + meta.label,
+            text: '这一格要的是' + meta.what + '，库里一条都没有。',
+            next: '不拿最近一笔顶替。请先说清是哪一笔（或先记一笔），再说一遍。',
+        });
+    }
+    return candidatePick({
+        name: 'id',
+        label: meta.label,
+        candidates: read.items,
+        selectedId: input.selectedId ?? null,
+        hint: input.hint ?? meta.hint,
+    }) + renderCaliberLine('库里共 ' + read.total + ' 条' + (input.mode === 'restore' ? '已打标撤销' : '未撤销')
+        + '的记录，本页列最近 ' + read.items.length + ' 条（按时间倒序）。');
+}
+/** 按编号读一条记录（**含已打标撤销的**，`getById` 读不到软删行，故本件走 `fetchAll` 自己筛）。
+ *  `deleted` 与 `row` 一次给全：软删口径只有 `isDeleted` 一处定义，调用方不再各判一次。 */
+export function readRowById(id) {
+    let handle = null;
+    try {
+        handle = openBillDb(resolveDbPath());
+        const hit = fetchAll(handle, { includeDeleted: true }).find((r) => r.id === id) ?? null;
+        return { ok: true, reason: '', row: hit, deleted: hit !== null && isDeleted(hit) };
+    }
+    catch (e) {
+        return { ok: false, reason: e instanceof Error ? e.message : String(e), row: null, deleted: false };
+    }
+    finally {
+        if (handle !== null)
+            closeBillDb(handle);
+    }
+}
+/** 一条记录的只读回显（改记录的原记录那一格、撤销／恢复选定后那一格都用它）。
+ *  行名走 `./userWording.js` 的 `fieldLabelOf`（库列名不上屏）；撤销标记那一格照实说有没有打标。 */
+function snapshotRows(row) {
+    return [
+        { k: fieldLabelOf('id'), v: String(row.id) },
+        { k: fieldLabelOf('category'), v: row.category },
+        { k: fieldLabelOf('amount'), v: row.amount.toFixed(2) },
+        { k: fieldLabelOf('time'), v: row.time },
+        { k: fieldLabelOf('account'), v: row.account },
+        { k: fieldLabelOf('ledger'), v: row.ledger },
+        { k: fieldLabelOf('currency'), v: row.currency },
+        { k: fieldLabelOf('note'), v: row.note },
+        {
+            k: fieldLabelOf('deleted_at'),
+            v: isDeleted(row) ? '已撤销（' + String(row.deleted_at) + '）' : '没撤销过',
+        },
+    ];
+}
+/** 一条记录的只读表（列名与 `renderDataTable` 的两列同形）。
+ *  表头说明里那个 `·` 改全角空格（本轮整改：表头说明是版式位，行内不再拿 `·` 当版式）。 */
+export function snapshotTable(row, caption) {
+    return renderDataTable({
+        columns: [{ key: 'k', label: '哪一项' }, { key: 'v', label: '记成什么' }],
+        rows: snapshotRows(row),
+        caption: caption ?? '这一条记录（记录编号 ' + row.id + '　只读回显）',
+    });
+}
+/** 库内那一行是不是给了这一格（`undefined`／`null`／空白串都不算给，0 算给）。 */
+function given(v) {
+    if (v === undefined || v === null)
+        return false;
+    return !(typeof v === 'string' && v.trim() === '');
+}
+/** 本次打算改的那几个字段的对照：**只比给了的那些字段**。
+ *  没给的字段不许进这张表——拿「未设置」当新值比，会把「这一格没动」算成「把这一格清空了」。 */
+export function diffRowsFor(input) {
+    const fields = input.fields.filter((f) => given(input.params[f]));
+    return diffOf({ fields, before: { ...input.row }, after: input.params });
+}
+//# sourceMappingURL=recordPicker.js.map

package/dist/write/recordPicker.js.map

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

package/dist/write/rowEditorTable.d.ts

@@ -0,0 +1,31 @@
+/** 一列：参数名／中文名／提示／这一列是不是必需。 */
+export interface RowEditorField {
+    readonly name: string;
+    readonly label: string;
+    readonly hint?: string;
+    /** 必需的那一列空着，这一行就算缺项（红标与「不给复制」都看它）。 */
+    readonly required?: boolean;
+}
+/** 逐行可编辑表的入参。 */
+export interface RowEditorInput {
+    /** 这张表的标识（每行控件的 `name` 是它 ＋ 行号 ＋ 列名，免得两行同名打架）。 */
+    readonly name: string;
+    readonly fields: readonly RowEditorField[];
+    /** 行：一张表一行，每一格按列名取值；缺的格写成空串，或干脆不给这一列。 */
+    readonly rows: readonly Readonly<Record<string, string>>[];
+    /** 哪一列求和（给了才出合计行；解析不出数的格不算进合计）。 */
+    readonly totalOf?: string;
+    /** 合计那一行前面那句（缺省「合计」）。 */
+    readonly totalLabel?: string;
+}
+/** 逐行缺项：第几行缺哪几列。**判定只此一处**（红标与「给不给复制」都引它）。零行返回空数组。 */
+export declare function rowEditorMissing(input: {
+    readonly fields: readonly RowEditorField[];
+    readonly rows: readonly Readonly<Record<string, string>>[];
+}): readonly {
+    readonly row: number;
+    readonly fields: readonly string[];
+}[];
+/** 逐行可编辑表整块：逐行一张小表单 ＋ 缺项逐行标红 ＋ 合计行；零行只出空态。 */
+export declare function rowEditorTable(input: RowEditorInput): string;
+//# sourceMappingURL=rowEditorTable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowEditorTable.d.ts","sourceRoot":"","sources":["../../src/write/rowEditorTable.ts"],"names":[],"mappings":"AA2BA,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,iBAAiB;AACjB,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC3D,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAOD,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;CAC5D,GAAG,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,CAS1E;AA+CD,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAsB5D"}