skill-bill 0.1.0 → 0.2.1

package/dist/write/scene-restore.js

@@ -0,0 +1,59 @@
+/** 场景件：恢复（`op=restore`）——本件只是差异声明，块位序列住 `./template-update.ts`。
+ *
+ * 本件的差异：采集页的候选**只列已经撤销过的**那些（`recordPicker` 的 `mode='restore'`），选中之后出只读回显
+ *  ＋ 一行「它现在带着撤销标记」的口径；摘要行之后那一行口径说清「恢复＝清掉标记、这一笔回到查询与统计」；
+ *  回执页出「恢复结果」那张表（标记现值），退出口给的是「撤销这一笔」。
+ */
+import { commandLine } from '../shared/writeParts.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { bindUpdatePages, blockedStateOf, missingRowText } from './template-update.js';
+/** 恢复这件事那句说明（采集页与回执页各出一处，同一句话只写在这里一份）。 */
+const RESTORE_NOTE = '恢复就是清掉那个撤销标记，这一笔回到查询和统计里。'
+    + '候选只列已经撤销过的记录，没撤销过的不进来。';
+const WAKE = projectWakeWord({ key: 'bill.record.update', op: 'restore' });
+const KEY = 'bill.record.update';
+export const SCENE = {
+    id: 'restore',
+    key: KEY,
+    kind: '',
+    op: 'restore',
+    family: '批量与修正族',
+    ...bindUpdatePages({
+        wake: WAKE,
+        key: KEY,
+        collectState: blockedStateOf,
+        confirmTitle: '确认恢复',
+        caliber: RESTORE_NOTE,
+        middle: {
+            pick: { mode: 'restore', hint: '候选只列已经撤销过的记录，挑一条即可。' },
+            markedCaption: (page) => '这一条就是要恢复的记录　只读回显　记录编号 ' + page.rowId,
+            marked: {
+                kind: 'caliber',
+                text: (page) => '它现在带着撤销标记，' + page.deletedAt + ' 撤销的。恢复之后标记清掉，这一笔回到查询和统计里。',
+            },
+            noRowTitle: '这个编号没有可恢复的记录',
+            noRowText: missingRowText,
+            plainCaption: () => '这一条记录　没撤销过，只读回显',
+            plain: {
+                kind: 'note', title: '这一条没撤销过',
+                text: (page) => '记录编号 ' + page.id + ' 没有撤销标记，没有可清的东西。',
+                next: '要撤它就说「撤销」。要改它就说「改记录」。',
+            },
+        },
+        prompt: (page) => {
+            if (page.id === null)
+                return '这一页先不写库。从候选里指定一条已经撤销过的记录，再跟助手说一遍「恢复」。';
+            if (!page.deleted)
+                return '记录编号 ' + page.id + ' 那一条没撤销过，没有标记可清。\n'
+                    + '要撤它就说「撤销」：' + commandLine(KEY, { op: 'undo', id: page.id }) + '。';
+            return '这一条就是这次要恢复的目标。恢复只把撤销标记清掉，别的项一概不动。照这条说：\n'
+                + commandLine(KEY, page.params);
+        },
+        receiptStatus: 'ok',
+        receiptNext: '这一笔已恢复正常，撤销见下方按钮。',
+        receiptCaliber: '',
+        receiptResult: 'restore',
+        receiptExit: 'undo',
+    }),
+};
+//# sourceMappingURL=scene-restore.js.map

package/dist/write/scene-restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-restore.js","sourceRoot":"","sources":["../../src/write/scene-restore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvF,0CAA0C;AAC1C,MAAM,YAAY,GAAG,2BAA2B;MAC5C,wBAAwB,CAAC;AAC7B,MAAM,IAAI,GAAW,eAAe,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AACnF,MAAM,GAAG,GAAG,oBAAoB,CAAC;AAEjC,MAAM,CAAC,MAAM,KAAK,GAAU;IAC1B,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,EAAE;IACR,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,QAAQ;IAChB,GAAG,eAAe,CAAC;QACjB,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,GAAG;QACR,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE;YACN,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,qBAAqB,EAAE;YACtD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,GAAG,IAAI,CAAC,KAAK;YAC9D,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,GAAG,IAAI,CAAC,SAAS,GAAG,4BAA4B;aAC7E;YACD,UAAU,EAAE,cAAc;YAC1B,SAAS,EAAE,cAAc;YACzB,YAAY,EAAE,GAAG,EAAE,CAAC,iBAAiB;YACrC,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS;gBAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,kBAAkB;gBACtD,IAAI,EAAE,uBAAuB;aAC9B;SACF;QACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI;gBAAE,OAAO,uCAAuC,CAAC;YACrE,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,oBAAoB;sBAC9D,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;YACvE,OAAO,0CAA0C;kBAC7C,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,mBAAmB;QAChC,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,MAAM;KACpB,CAAC;CACH,CAAC"}

package/dist/write/scene-undo.d.ts

@@ -0,0 +1,3 @@
+import type { Scene } from './scene.js';
+export declare const SCENE: Scene;
+//# sourceMappingURL=scene-undo.d.ts.map

package/dist/write/scene-undo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-undo.d.ts","sourceRoot":"","sources":["../../src/write/scene-undo.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AASxC,eAAO,MAAM,KAAK,EAAE,KAuCnB,CAAC"}

package/dist/write/scene-undo.js

@@ -0,0 +1,57 @@
+/** 场景件：撤销（`op=undo`）——本件只是差异声明，块位序列住 `./template-update.ts`。
+ *
+ * 本件的差异：采集页的候选只列**没撤销过的**那些，选中之后只出只读回显（不出 diff 表）；
+ *  摘要行之后那一行口径说清「撤销只打标、不删数据、要回来就说恢复」（采集页与回执页各出一处，同一句只写一份）；
+ *  回执页出「撤销标记」那张对照表，退出口给的是「恢复这一笔」。
+ */
+import { commandLine } from '../shared/writeParts.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { bindUpdatePages, blockedStateOf, missingRowText } from './template-update.js';
+/** 撤销这件事那句说明（采集页与回执页各出一处，同一句话只写在这里一份）。 */
+const SOFT_DELETE_NOTE = '撤销只打标，不删数据，记录还在库里。'
+    + '撤销过的那一笔不算进查询和统计，要回来就说「恢复」。';
+const WAKE = projectWakeWord({ key: 'bill.record.update', op: 'undo' });
+const KEY = 'bill.record.update';
+export const SCENE = {
+    id: 'undo',
+    key: KEY,
+    kind: '',
+    op: 'undo',
+    family: '批量与修正族',
+    ...bindUpdatePages({
+        wake: WAKE,
+        key: KEY,
+        collectState: blockedStateOf,
+        confirmTitle: '确认撤销',
+        caliber: SOFT_DELETE_NOTE,
+        middle: {
+            pick: { mode: 'undo', hint: '候选只列没撤销过的记录，挑一条即可。' },
+            markedCaption: () => '这一条记录　已打标撤销，只读回显',
+            marked: {
+                kind: 'note',
+                title: '这一条已经撤销过',
+                text: (page) => '记录编号 ' + page.id + ' 在 ' + page.deletedAt + ' 已经撤销过了，这一支不再重复撤销。',
+                next: '要它回到库里就说「恢复」。要撤别的记录就换一个编号。',
+            },
+            noRowTitle: '这个编号没有可撤销的记录',
+            noRowText: missingRowText,
+            plainCaption: (page) => '这一条就是要撤销的记录　只读回显　记录编号 ' + page.rowId,
+            plain: { kind: 'none' },
+        },
+        prompt: (page) => {
+            if (page.id === null)
+                return '这一页先不写库。从候选里指定一条记录，再跟助手说一遍「撤销」。';
+            if (page.deleted)
+                return '记录编号 ' + page.id + ' 那一条已经撤销过，再撤一次无事可做。\n'
+                    + '要它回到库里就说「恢复」：' + commandLine(KEY, { op: 'restore', id: page.id }) + '。';
+            return '这一条就是这次要撤销的目标。撤销只打标记、不删记录，撤完还能恢复。照这条说：\n'
+                + commandLine(KEY, page.params);
+        },
+        receiptStatus: 'warn',
+        receiptNext: '这一笔已标记撤销，记录还在。恢复见下方按钮。',
+        receiptCaliber: SOFT_DELETE_NOTE,
+        receiptResult: 'undo',
+        receiptExit: 'restore',
+    }),
+};
+//# sourceMappingURL=scene-undo.js.map

package/dist/write/scene-undo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-undo.js","sourceRoot":"","sources":["../../src/write/scene-undo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvF,0CAA0C;AAC1C,MAAM,gBAAgB,GAAG,oBAAoB;MACzC,4BAA4B,CAAC;AACjC,MAAM,IAAI,GAAW,eAAe,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAChF,MAAM,GAAG,GAAG,oBAAoB,CAAC;AAEjC,MAAM,CAAC,MAAM,KAAK,GAAU;IAC1B,EAAE,EAAE,MAAM;IACV,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,EAAE;IACR,EAAE,EAAE,MAAM;IACV,MAAM,EAAE,QAAQ;IAChB,GAAG,eAAe,CAAC;QACjB,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,GAAG;QACR,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,gBAAgB;QACzB,MAAM,EAAE;YACN,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE;YAClD,aAAa,EAAE,GAAG,EAAE,CAAC,kBAAkB;YACvC,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,SAAS,GAAG,oBAAoB;gBACjF,IAAI,EAAE,4BAA4B;aACnC;YACD,UAAU,EAAE,cAAc;YAC1B,SAAS,EAAE,cAAc;YACzB,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,GAAG,IAAI,CAAC,KAAK;YAC7D,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SACxB;QACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI;gBAAE,OAAO,iCAAiC,CAAC;YAC/D,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,uBAAuB;sBAChE,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;YAC7E,OAAO,0CAA0C;kBAC7C,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,aAAa,EAAE,MAAM;QACrB,WAAW,EAAE,wBAAwB;QACrC,cAAc,EAAE,gBAAgB;QAChC,aAAa,EAAE,MAAM;QACrB,WAAW,EAAE,SAAS;KACvB,CAAC;CACH,CAAC"}

package/dist/write/scene-update.d.ts

@@ -0,0 +1,3 @@
+import type { Scene } from './scene.js';
+export declare const SCENE: Scene;
+//# sourceMappingURL=scene-update.d.ts.map

package/dist/write/scene-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-update.d.ts","sourceRoot":"","sources":["../../src/write/scene-update.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC,eAAO,MAAM,KAAK,EAAE,KAyCnB,CAAC"}

package/dist/write/scene-update.js

@@ -0,0 +1,57 @@
+/** 场景件：改记录（`bill.record.update` 的缺省那一支，`op` 空＝改字段）——本件只是差异声明，块位序列住 `./template-update.ts`。
+ *
+ * 本件的差异：采集页分**三形态**（缺编号先挑一条／那一条已撤销过／带编号出确认面），选定之后中段出
+ *  **原记录只读回显 ＋ 改前改后对照**（改哪几个字段取自槽位表，`id`／`op` 两格不算）；采集页不出摘要行后那一行口径，
+ *  回执页出「改前改后对照落在写库前那一面」那句，也不出撤销／恢复那种结果表。
+ */
+import { commandLine } from '../shared/writeParts.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { bindUpdatePages } from './template-update.js';
+const WAKE = projectWakeWord({ key: 'bill.record.update' });
+const KEY = 'bill.record.update';
+export const SCENE = {
+    id: 'update',
+    key: KEY,
+    kind: '',
+    op: '',
+    family: '批量与修正族',
+    ...bindUpdatePages({
+        wake: WAKE,
+        key: KEY,
+        collectState: (page) => (page.id === null ? '三形态之一：缺记录编号 · 先挑一条' : '待核对 · 未写库'),
+        confirmTitle: '确认改动',
+        caliber: '',
+        middle: {
+            pick: { mode: 'update' },
+            markedCaption: () => '这一条记录　已撤销过，只读回显',
+            marked: {
+                kind: 'note',
+                title: '这一条已经撤销过',
+                text: (page) => '记录编号 ' + page.id + ' 在 ' + page.deletedAt + ' 撤销过，改记录这一支不动已撤销的记录。',
+                next: '要它回到库里就说「恢复」，恢复之后再改。要改别的记录就换一个编号。',
+            },
+            noRowTitle: '这个编号没有记录',
+            noRowText: (page) => '记录编号 ' + page.id + ' 在库里一条都没读到。',
+            plainCaption: (page) => '原记录　只读回显　记录编号 ' + page.rowId,
+            plain: { kind: 'diff', caption: '改前改后对照（本次打算改的那几项）' },
+        },
+        prompt: (page) => {
+            if (page.id === null)
+                return '这一页先不写库。挑一条记录，说清要改哪一项、改成什么，再跟助手说一遍「改记录」。';
+            if (page.deleted)
+                return '记录编号 ' + page.id + ' 那一条已经撤销过，改记录这一支不动它。\n'
+                    + '要它回到库里就说「恢复」：' + commandLine(KEY, { op: 'restore', id: page.id }) + '。';
+            if (page.rowId === null)
+                return '记录编号 ' + page.id + ' 在库里读不到，可能已不在这个库。\n'
+                    + '核一下编号，或先说清是哪一笔，再跟助手说一遍「改记录」。';
+            return '原记录与改动对照都在下面：核一眼「原值／新值」，没问题就照这条说。\n'
+                + commandLine(KEY, page.params);
+        },
+        receiptStatus: 'ok',
+        receiptNext: '这一笔已记下，撤销见下方按钮。',
+        receiptCaliber: '这一页只报写后的真值，改前改后对照落在写库前那一面。',
+        receiptResult: 'none',
+        receiptExit: 'undo',
+    }),
+};
+//# sourceMappingURL=scene-update.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene-update.js","sourceRoot":"","sources":["../../src/write/scene-update.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,IAAI,GAAW,eAAe,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,CAAC,CAAC;AACpE,MAAM,GAAG,GAAG,oBAAoB,CAAC;AAEjC,MAAM,CAAC,MAAM,KAAK,GAAU;IAC1B,EAAE,EAAE,QAAQ;IACZ,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,EAAE;IACR,EAAE,EAAE,EAAE;IACN,MAAM,EAAE,QAAQ;IAChB,GAAG,eAAe,CAAC;QACjB,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,GAAG;QACR,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC;QAC/E,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,EAAE;QACX,MAAM,EAAE;YACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,aAAa,EAAE,GAAG,EAAE,CAAC,iBAAiB;YACtC,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,SAAS,GAAG,sBAAsB;gBACnF,IAAI,EAAE,mCAAmC;aAC1C;YACD,UAAU,EAAE,UAAU;YACtB,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,aAAa;YACtD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK;YACrD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE;SACtD;QACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI;gBAAE,OAAO,0CAA0C,CAAC;YACxE,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,wBAAwB;sBACjE,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;YAC7E,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;gBAAE,OAAO,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,qBAAqB;sBACrE,8BAA8B,CAAC;YACnC,OAAO,qCAAqC;kBACxC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,iBAAiB;QAC9B,cAAc,EAAE,4BAA4B;QAC5C,aAAa,EAAE,MAAM;QACrB,WAAW,EAAE,MAAM;KACpB,CAAC;CACH,CAAC"}

package/dist/write/scene.d.ts

@@ -0,0 +1,86 @@
+/** 写入域场景件的公共契约与落点表（**唯一定义地**）。
+ *
+ * 本件回答两件事：
+ *   ① 一件场景件长什么样——`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 件现在都只声明差异值，两张页由**五张模板件**按页型装配
+ *  （`./template-{expense,flow,batch,installment,update}.ts`；原先那一对通用装配体
+ *  `./collectBody.ts`／`./receiptBody.ts` 已随票删除），逐条真跑的产物与拆件前逐字节同量级
+ *  （读数见 `t407-拆件与三个缺口块-证据.md` 第六节）。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/write/collect.ts`——采集页分派：`sceneFor` 取件，叫它的 `collect`；
+ *   ② `src/write/receipt.ts`——回执页分派：同一件，叫它的 `receipt`。
+ */
+import type { BillRow } from '../fetch/db.js';
+import type { SummaryFacts } from './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`：公共层的表格件收
+     *  `readonly Record<string, unknown>[]`，字面量类型自带隐式索引签名、能直接过（同口径见
+     *  `../query/list.js` 的 `QueryTableRow`）。 */
+    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;
+    /** 命令全名（`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 条修正词。
+ *
+ * 表里**不写唤醒词**（#721 撤）：这一件认哪些 `kind`／`op` 是**处理方声明**（`sceneFor` 靠它选件，
+ * 不走词表），而「这一件服务哪条词」是**词条**的事实、由域声明拥有。要那一行词就现算：
+ * `projectWakeWord({ key: s.key, kind: s.kind, op: s.op })`（`src/triggers/wakeTable.ts`）；
+ * 两者的一致性由 `test/t721-域声明.test.mjs` 的「落点表 ↔ 词条」逐件断言钉住。 */
+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/write/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/write/scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,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;;iDAE6C;IAC7C,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,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;;;;;yDAKyD;AACzD,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/write/scene.js

@@ -0,0 +1,44 @@
+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 条修正词。
+ *
+ * 表里**不写唤醒词**（#721 撤）：这一件认哪些 `kind`／`op` 是**处理方声明**（`sceneFor` 靠它选件，
+ * 不走词表），而「这一件服务哪条词」是**词条**的事实、由域声明拥有。要那一行词就现算：
+ * `projectWakeWord({ key: s.key, kind: s.kind, op: s.op })`（`src/triggers/wakeTable.ts`）；
+ * 两者的一致性由 `test/t721-域声明.test.mjs` 的「落点表 ↔ 词条」逐件断言钉住。 */
+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/write/scene.js.map

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

package/dist/write/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/write/slots.d.ts.map

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

@@ -0,0 +1,73 @@
+/** 写入域两条写命令的槽位表与缺项探针（**唯一定义地**，本票从 `collect.ts` 原样搬来）。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/write/write.ts`——两条写命令的处理体：拿 `missingSlots` 探「必需槽位在不在」，
+ *      拿 `RECORD_SLOTS` 派生「记一笔写进库的列全集」；
+ *   ② `src/write/collect.ts`——采集页分派位（经它转出给三套测试），它把这一张表当 `CollectInput.slots`
+ *      交给场景件与五张模板件，字段卡照它出表单。
+ *  第二个消费者：`src/query/`（随兄弟图 #403 的查询域一起到位，同一套采集页要同一张槽位表）。
+ *
+ * 「一条命令要哪些槽位、哪个必需」与「表单怎么摆」原本同住一件；本票按场景拆件时把前者单独搬到这里，
+ *  理由：场景件只管自己那张页怎么摆，槽位表是两条命令共有的**事实**，搬进场景件就会各抄一份。
+ *
+ * 必需性照 `src/shared/category.ts` 的 `validateRecord`：分类与金额没有缺省值（必需），
+ *  时间／账户／账本／币种／备注都有缺省值（可缺）。七槽里的「名目」没有库列：它落在三级分类的最后一段
+ *  （如 `餐饮/外卖/午餐`）或备注里，提示里写明。
+ *  `missingSlots` 只做「在不在」的探针；方向不符那一半住 `../shared/blockedSlots.ts` 的 `blockedItems`，
+ *  **只服务录入路径**（`bill.record.add` 采集页传 `kind`；`bill.record.update` 那一支不判方向）。
+ *  真值校验仍走 `./record.js` 的 `validateAddInput`／`validateUpdateInput`（阻断项清空后才走到那一步）。
+ */
+import { fieldLabelOf } from './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/write/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../src/write/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAYhD,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,gBAAgB,EAAE,IAAI,CAAC;QACxC,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,6BAA6B,EAAE,KAAK,CAAC;QAChD,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/write/sourceNote.d.ts

@@ -0,0 +1,5 @@
+/** 结果型回执页（④）的来源脚注：窗口＝这一笔的时间、条数＝本次改动笔数。 */
+export declare function receiptSourceNote(time: string, changed: number): string;
+/** 过程型采集页（①）的来源脚注：窗口＝这一笔的时间、条数＝本次改动笔数（这一页没写库 ⇒ 0）。 */
+export declare function collectSourceNote(time: string): string;
+//# sourceMappingURL=sourceNote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceNote.d.ts","sourceRoot":"","sources":["../../src/write/sourceNote.ts"],"names":[],"mappings":"AAiCA,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/write/sourceNote.js

@@ -0,0 +1,37 @@
+/** 来源脚注（写入域取值口径）：**两页型的「数据来源 · 窗口 · 条数」三样各取什么值，只在本件写一份**。
+ *
+ * 出处：`docs/skills/skill-bill/688-融合基准.md` §五 5.2 第 26 行——`●` **七类恒出** ⇒ 写入域的结果型
+ *  回执页（④）与过程型采集页（①）都要出，位置照表序（在复制区之后）；版面走共用位 `../shared/sourceLine.js`，
+ *  本件只给那三样值（该件不认库名、不认命令名，照裁定 1 不把内部标识带上屏）。
+ *
+ * 三样值照写入域的真事实给：
+ *   来源＝复制日志第 3 段那句「库文件名 ＋ 用途」的**人话版**——日志给机器看、可带库文件名；
+ *     脚注给人看，故只写「记账库」这一句（裁定 1：**库文件名、命令名与脚本路径一律不上屏**，
+ *     老侧把 `scripts/record_bill.py` 印进页脚就是反面那条）；
+ *   窗口＝这一笔的时间（同一串给起止两端：这回记的是**一笔**，不是一段）；这一格没给写 `—`（裁定 4）；
+ *   条数＝本次改动笔数（`BillReceipt.affectedRows`）；采集页没写库 ⇒ 0（照实报，不拿 1 顶）。
+ *
+ * 谁在用（五个调用点，指名）：`src/write/template-{expense,flow,batch,installment,update}.ts`——
+ *  每张模板的两页各引它一次（回执页 `receiptSourceNote`、采集页 `collectSourceNote`）。
+ */
+import { sourceLine } from '../shared/sourceLine.js';
+/** 回执页那句来源（＝`./write.ts` 的 `SOURCE_RECEIPT` 那句的人话版）。 */
+const SOURCE_RECEIPT_TEXT = '记账库（写入）';
+/** 采集页那句来源（＝`./write.ts` 的 `SOURCE_COLLECT` 那句的人话版：这一页只读、不写库）。 */
+const SOURCE_COLLECT_TEXT = '记账库（只读）';
+/** 缺值占位（照裁定 4「缺值一律 `—`」，不写 0、不写空串、不拿缺省值顶替）。 */
+const MISSING = '—';
+/** 三样值合成那一行：窗口起止同一串（一笔事）、条数非负整数、来源由调用方按页型给。 */
+function sourceNote(time, count, source) {
+    const at = time.trim() === '' ? MISSING : time.trim();
+    return sourceLine({ source, start: at, end: at, count });
+}
+/** 结果型回执页（④）的来源脚注：窗口＝这一笔的时间、条数＝本次改动笔数。 */
+export function receiptSourceNote(time, changed) {
+    return sourceNote(time, changed, SOURCE_RECEIPT_TEXT);
+}
+/** 过程型采集页（①）的来源脚注：窗口＝这一笔的时间、条数＝本次改动笔数（这一页没写库 ⇒ 0）。 */
+export function collectSourceNote(time) {
+    return sourceNote(time, 0, SOURCE_COLLECT_TEXT);
+}
+//# sourceMappingURL=sourceNote.js.map

package/dist/write/sourceNote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceNote.js","sourceRoot":"","sources":["../../src/write/sourceNote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,wDAAwD;AACxD,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAEtC,kEAAkE;AAClE,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAEtC,+CAA+C;AAC/C,MAAM,OAAO,GAAG,GAAG,CAAC;AAEpB,+CAA+C;AAC/C,SAAS,UAAU,CAAC,IAAY,EAAE,KAAa,EAAE,MAAc;IAC7D,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe;IAC7D,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACxD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAClD,CAAC"}

package/dist/write/summaryRow.d.ts

@@ -0,0 +1,44 @@
+import type { KpiCardInput } from 'base-paint/blocks';
+/** 一型的方向口径（**唯一定义地**，四处引用都走这里）：
+ *  `sign`＝这一型要的金额符号（`Math.sign` 的值），`require`＝「这一型为什么得是这个符号」那一句，
+ *  `word`＝这一型的方向词（摘要行与组合徽章共用）。 */
+export interface DirectionRule {
+    readonly word: string;
+    readonly sign: number;
+    readonly require: string;
+}
+/** 一型的方向口径（没有这一型＝返回 `undefined`，调用方照实当「本型不管方向」）。 */
+export declare function directionOf(kind: string): DirectionRule | undefined;
+/** 金额一律两位小数（**唯一定义地**，比对与展示同一份口径）。`null`／非有限数／`0`＝未给；`+` 只给正数。
+ *  上级裁定第 3 条：金额 `0.00` 配「零（本仓不记零）」自相矛盾，值栏一律写「未给」。 */
+export declare function money2(amount: number | null): string;
+/** 方向那句话（**唯一定义地**）：符号即方向——支出负数、收入正数。零与「还没给」都照实说，不拿 0 顶。
+ *  用户说法照 `docs/skills/skill-bill/t407-文字审查.md` 第 43、44 条的判法：`未判（金额还没给）` 改「还没给」，
+ *  `零（本仓不记零）` 改「还没给」（值栏摆 0.00 配「本仓不记零」自相矛盾，本级不再这么写）。 */
+export declare function moneyDirection(amount: number | null): string;
+/** 摘要行的事实：六格取值。`amount` 用 `null` 表示「还没给」；数字 `0` 视同没给（本仓不记零，裁定第 3 条）。 */
+export interface SummaryFacts {
+    readonly amount: number | null;
+    readonly category: string;
+    readonly account: string;
+    readonly ledger: string;
+    readonly time: string;
+}
+/** 结论摘要行的几格（**唯一定义地**）：采集页直接出网格，回执页把它们并进自己那张网格里。
+ *  `amount` 未给时那一格写「未给」，不拿 0 顶替。时间缺省那句取口径层的缺省时刻，本件不抄第二份。
+ *
+ *  三处口径句改成用户说法（本轮整改，原文见 `docs/skills/skill-bill/t407-文字审查.md` 第 40、42、43、60 条）：
+ *   `L1/L2/L3 三级` 改成「分类要选到最细那一级」（内部层级名不上屏）；`缺省＝…` 改成「不填就记到…」；
+ *   采集页那一格给的是**真值**（这一笔打算记成什么），所以不再配「不填就记成…」——那是没给时才成立的话。 */
+export declare function summaryCards(facts: SummaryFacts): readonly KpiCardInput[];
+/** 结论摘要行：那张网格 ＋ 方向两枚胶囊 ＋ 分类一行口径。
+ *  R3 改形状：原先一句 `支出的金额记成负数、收入记成正数；分类要选到最细那一级。`
+ *  拿顿号分方向、用分号缀分类，三件事挤一句（采集 10 页同句）。现拆三枚独立形状：
+ *  方向两条各一枚胶囊（分行并列），分类单独一行口径；不再用连接符串版式。
+ *
+ *  第 3 轮返工：记借入-采集页要把「必需项置顶、可选项折叠」重排进自己那张网格（首屏 8 张同形卡太挤），
+ *  故允许只取后面两件（`cards: false`）——那两枚胶囊与那一行口径的字面量仍只此一份，调用方不另抄一遍。 */
+export declare function summaryRow(facts: SummaryFacts, options?: {
+    readonly cards?: boolean;
+}): string;
+//# sourceMappingURL=summaryRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summaryRow.d.ts","sourceRoot":"","sources":["../../src/write/summaryRow.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD;;kCAEkC;AAClC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAOD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnE;AAED;qDACqD;AACrD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGpD;AAED;;wDAEwD;AACxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAK5D;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;6DAK6D;AAC7D,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,CAezE;AAED;;;;;;gEAMgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAI9F"}