skill-bill 0.1.0 → 0.2.0

package/dist/shared/pageShell.d.ts

@@ -0,0 +1,24 @@
+/** 页面模板与页头的入参：标题三件套 ＋ 已组合好的正文 ＋ 页面标记五件。 */
+export interface PageShellInput {
+    /** head 的 `<title>` 文本。 */
+    readonly docTitle: string;
+    /** 正文 H1。 */
+    readonly title: string;
+    /** 正文副标题（空串＝不写这一行）。 */
+    readonly subtitle: string;
+    /** `<section>` 上的槽位：`collect`＝过程型采集页、`receipt`＝结果型回执整页、`list`＝查询域列表页。 */
+    readonly slot: 'collect' | 'receipt' | 'list';
+    /** `<section>` 上**选页用的那一枚**：`collect`／`receipt`／`list`；与 `slot` 同值，下游选页读它。 */
+    readonly page: 'collect' | 'receipt' | 'list';
+    /** `<section>` 上的形状（＝本次 envelope 的形状，与老回执页同一枚；契约，不随页型改）。 */
+    readonly shape: string;
+    /** `<section>` 上的命令名（对外全名）。 */
+    readonly key: string;
+    /** 已组合好的页内块序列。 */
+    readonly content: string;
+    /** 这一页属于哪个域（眉标那一行）：缺省 `write`＝写入域；查询域给 `query`。 */
+    readonly domain?: 'write' | 'query';
+}
+/** 页面模板与页头：`<section>` 段 ＋ 标题三件套 ＋ 整页装配。一页只调一次。 */
+export declare function pageShell(input: PageShellInput): string;
+//# sourceMappingURL=pageShell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageShell.d.ts","sourceRoot":"","sources":["../../src/shared/pageShell.ts"],"names":[],"mappings":"AA0BA,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,aAAa;IACb,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACrC;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAevD"}

package/dist/shared/pageShell.js

@@ -0,0 +1,42 @@
+/** 页面模板与页头（每张页都有的第一件，**唯一定义地**）：`<section>` 段 ＋ 标题三件套 ＋ 整页装配。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/record/`——写入域：过程型采集页（页头 ＋ 九块正文）与结果型回执整页（页头 ＋ 回执块序列）；
+ *   ② `src/query/`——查询域：通用查询列表页（页头 ＋ KPI 行 ＋ 数据表 ＋ 复制区）同走本件，
+ *      眉标给 `domain: 'query'`。
+ *  本票实测：本包 `src/` 下真引用本件的就是上面两个域，再无第三处。
+ *
+ * 分工（三件不要混）：
+ *   - `./docPage.ts`＝文档装配那一层（`fillTemplate` 包裹、样式资产注入），本件往下调它，不重写；
+ *   - 本件＝页面模板与页头的取值口径（**眉标两域各一句**、标题三件套只出一处；`data-page` 是选页那一枚标记）；
+ *   - 页内块序列（表单／摘要行／复制区…）归各域自己，本件不管；类型徽章另立 `./typeBadge.ts`。
+ *
+ * 口径出处：`docs/skills/skill-bill/t407-页面块清单-16词.md` 第一节第 1 行。
+ * 1.1 节硬口径照旧：`blocksCss()` 拼进 `TemplateAssets.sharedCssText` 再交 `fillTemplate`（住 `./docPage.ts`），
+ * 不得走 `StyleSheetInput.extraCss`。
+ */
+import { assembleDocPage } from './docPage.js';
+import { writeSection } from './writeParts.js';
+/** 眉标（正文标题上方那一行）：每域一句，**取值只在本件**，别处不得再写这些字面量。 */
+const PAGE_EYEBROW = {
+    write: '记账 · 写入域',
+    query: '记账 · 查询域',
+};
+/** 页面模板与页头：`<section>` 段 ＋ 标题三件套 ＋ 整页装配。一页只调一次。 */
+export function pageShell(input) {
+    const body = writeSection({
+        slot: input.slot,
+        page: input.page,
+        shape: input.shape,
+        key: input.key,
+        content: input.content,
+    });
+    return assembleDocPage({
+        docTitle: input.docTitle,
+        title: input.title,
+        eyebrow: PAGE_EYEBROW[input.domain ?? 'write'],
+        subtitle: input.subtitle,
+        content: body,
+    });
+}
+//# sourceMappingURL=pageShell.js.map

package/dist/shared/pageShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageShell.js","sourceRoot":"","sources":["../../src/shared/pageShell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,iDAAiD;AACjD,MAAM,YAAY,GAAgD;IAChE,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;CAClB,CAAC;AAwBF,mDAAmD;AACnD,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,IAAI,GAAG,YAAY,CAAC;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,OAAO,eAAe,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;QAC9C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/photoEscape.d.ts

@@ -0,0 +1,53 @@
+import type { BillRow } from '../fetch/db.js';
+import type { DuplicateProbe } from './duplicateNote.js';
+import type { PrefillMark } from './prefillNote.js';
+import type { SummaryFacts } from './summaryRow.js';
+/** 采集页那几格取值，一次给全（`pickOf`／`probeOf`／`factsOf` 三个名字合成这一个粗入口）：
+ *  ① `pick` 三枚选择器的候选（分类退到哪一侧由 `kind` 定）；② `probe` 重复检测的探针；
+ *  ③ `facts` 摘要行的事实。三个都只读本次参数与近期记录，不碰库。 */
+export declare function valuesOf(input: {
+    readonly recent: readonly BillRow[];
+    readonly params: Record<string, unknown>;
+    readonly kind: string;
+    readonly today: string;
+}): {
+    readonly pick: Record<string, readonly string[]>;
+    readonly probe: DuplicateProbe;
+    readonly facts: SummaryFacts;
+};
+/** 字段卡要的一格（普通数据：名字／中文名／怎么给／是否必需）。**收在件内**：外面照这个形状给普通对象。 */
+interface FieldSlot {
+    readonly name: string;
+    readonly label: string;
+    readonly hint: string;
+    readonly required: boolean;
+}
+/** 采集页字段卡那块（`renderParamForm` ＋ 本场景那句操作说明）。候选那一格由 `valuesOf` 出的 `pick` 给。 */
+export declare function fieldCardOf(input: {
+    readonly description: string;
+    readonly slots: readonly FieldSlot[];
+    readonly params: Record<string, unknown>;
+    readonly marks: readonly PrefillMark[];
+    readonly pick: Record<string, readonly string[]>;
+}): string;
+/** 缺项那两处的原文，一次给全（两个名字合成一个粗入口）：
+ *  ① `command` 是缺项时那条写库指令原文——缺的值留成尖括号占位符，**只给看不给复制**（复制按钮在阻断条里被拿掉）；
+ *  ② `prompt` 是「照这句跟助手说一遍」那块话：说清缺什么、这一页先不写库、补齐之后说哪句——
+ *     **不给可跑的写库指令**。本轮整改：缺项清单里不再印参数名（库列名不上屏），
+ *     `重跑同一条命令` 换「跟助手说一遍」。
+ *  `replaces` 给「按中文名占位」以外的写法（拍账单的要素名）。 */
+export declare function blockedPromptOf(input: {
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    readonly blocked: readonly {
+        readonly name: string;
+        readonly label: string;
+        readonly why: string;
+    }[];
+    readonly replaces?: Readonly<Record<string, string>>;
+}): {
+    readonly command: string;
+    readonly prompt: string;
+};
+export {};
+//# sourceMappingURL=photoEscape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"photoEscape.d.ts","sourceRoot":"","sources":["../../src/shared/photoEscape.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAkDpD;;2CAE2C;AAC3C,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GAAG;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B,CAMA;AAED,2DAA2D;AAC3D,UAAU,SAAS;IACjB,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;AAwBD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CAClD,GAAG,MAAM,CAKT;AAED;;;;;0CAK0C;AAC1C,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrG,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CASxD"}

package/dist/shared/photoEscape.js

@@ -0,0 +1,139 @@
+/** 记账族四个场景件共用的采集页表单积木（**唯一定义地**）：表单取值判定、字段卡、复制 prompt 区那段话
+ *  与缺项时那条写库指令原文。四个场景件（记收入／记报销／记一笔／拍账单）的采集页要**同一套积木**，
+ *  抄四份就会改一处漏三处，故收在一处。
+
+ * 本件对外的名字**三个**（照 `docs/agents/structure.md` 的「一个文件对外给的东西不多于五个」，
+ *  只数真被本目录之外的件引用的名字）：
+ *  `valuesOf`（采集页那几格取值：候选／重复检测探针／摘要行事实）、`fieldCardOf`（字段卡）、
+ *  `blockedPromptOf`（缺项那条 ＋ 复制 prompt 区那段话，一次给全）。
+ *  其余收在件内、不外给：`pickOf`（三枚选择器的候选，一行转发到共用位 `recentPicks.ts`）、
+ *  `categorySideOf`（分类侧别的唯一落点）、`probeOf`、`factsOf`、`FieldSlot`（字段卡要的一格；只有本件
+ *  `fieldCardOf` 的签名与件内的 `formFieldsOf` 认它，外面照形状给普通对象即可）、`isGiven`、`formFieldsOf`。
+ *  **本次由 12 名收到 3 名**，两刀：① 外部识别那五样（拍账单的图片识别外置通道）搬去
+ *  `src/shared/outsideScan.ts`；② 表单那六个名字并成三个粗入口（`pickOf`＋`probeOf`＋`factsOf` 合成
+ *  `valuesOf`；`commandsOf` 与 `promptOf` 合成 `blockedPromptOf`）。
+
+ * 谁在用（四个调用点，指名；每个调用点后头写明它取哪几个名字）：
+ *   ① `src/record/scene-income.ts`——记收入：`valuesOf`（候选落收入侧）／`fieldCardOf`／`blockedPromptOf`；
+ *   ② `src/record/scene-reimburse.ts`——记报销：同一套三个名字，只是 `kind` 换成 `reimburse`；
+ *   ③ `src/record/scene-plain.ts`——记一笔：同一套三个名字，`kind` 给空串（分类候选两侧都给，方向按金额符号判）；
+ *   ④ `src/record/scene-photo.ts`——拍账单：同一套三个名字，`kind` 给 `photo`；
+ *     外部识别通道的五个名字走 `src/shared/outsideScan.ts`。
+
+ * **本件只吃普通数据、零跨目录引用**（与已冻的 `candidatePick.ts`／`rowEditorTable.ts`／`diffTable.ts` 同形状）：
+ *  入参是「要展示的字段名与文案」「本次参数」「近期记录那几列」这类普通数据，**不引** `src/record/` 下的件，
+ *  也不认 `CollectInput`／`ReceiptInput`——那两张页的入参形状由 `src/record/scene.ts` 定义，由各场景件自己解成普通数据传进来。
+ *  本件可引的只有：`base-paint`／`base-paint/blocks`（现成组件）、`src/policy/category.ts`（口径层）、
+ *  `src/fetch/db.ts`（记录行的数据形状）、`src/shared/` 同目录的共用件。
+ *
+ * 口径（一处定义，别处不许再写第二份）：
+ *   - **一个值算不算「给了」**：`undefined`／`null`／空白串都不算，0 算给了（金额 0 是合法值）；
+ *   - **候选取值**：按最近在先去重、取前十二个、分类一条历史都没有时退到本型的 L1 名单——
+ *     这一半的唯一定义地是 `src/shared/recentPicks.ts`，本件的 `pickOf` 只留一行转发；
+ *   - **缺项即不出复制指令**：阻断判定在 `src/shared/blockedSlots.ts`，写库指令原文在本件的
+ *     `blockedPromptOf`；复制 prompt 区那段话里**没有可跑的写库指令**。
+ *
+ * 本件不自造任何页面骨架与样式：字段卡走 `base-paint/blocks` 的 `renderParamForm`，其余块由各场景件
+ *  从代表页那套共用件里取。
+ */
+import { renderParamForm } from 'base-paint/blocks';
+import { ALL_L1, EXPENSE_L1, INCOME_L1 } from '../policy/category.js';
+import { prefillHint } from './prefillNote.js';
+import { optionsFor, pickOf as pickValues, textOf } from './recentPicks.js';
+import { commandLine } from './writeParts.js';
+/** 分类一侧的 L1 名单：收入词落收入侧、支出型词落支出侧、通用词两侧都给。**这一处是分类侧别的唯一落点**。 */
+function categorySideOf(kind) {
+    if (kind === 'income')
+        return INCOME_L1;
+    if (kind === 'expense' || kind === 'reimburse' || kind === 'photo' || kind === 'refund')
+        return EXPENSE_L1;
+    return ALL_L1;
+}
+/** 三枚选择器的候选（**转发到 `recentPicks.ts`，本件不另写一份取数**）：分类退到哪一侧由 `categorySideOf` 定。 */
+function pickOf(recent, kind) {
+    return pickValues(recent, categorySideOf(kind));
+}
+/** 一个值算不算「给了」：`undefined`／`null`／空白串都不算，0 算给了（金额 0 是合法值）。
+ *  与 `src/record/slots.ts` 的 `isGiven` 同一口径；本件只吃普通数据，故照这条口径在本件内重写一遍，
+ *  不从能力目录里引件（`src/shared/` 与 `src/record/` 之间不互相引）。 */
+function isGiven(v) {
+    if (v === undefined || v === null)
+        return false;
+    return !(typeof v === 'string' && v.trim() === '');
+}
+/** 重复检测的探针（四件同一口径：日期缺省取本页执行那天）。**收在件内**，对外由 `valuesOf` 一次给。 */
+function probeOf(params, today) {
+    const raw = textOf(params['amount']);
+    const n = raw === '' ? Number.NaN : Number(raw);
+    const time = textOf(params['time']);
+    return {
+        amount: Number.isFinite(n) ? n : null,
+        category: textOf(params['category']),
+        date: time === '' ? today : time,
+        account: textOf(params['account']),
+    };
+}
+/** 摘要行的事实（四件同一口径：事实取自本次参数，缺的格写「未给」）。**收在件内**，对外由 `valuesOf` 一次给。 */
+function factsOf(params, date) {
+    const raw = textOf(params['amount']);
+    const n = raw === '' ? Number.NaN : Number(raw);
+    const time = textOf(params['time']);
+    return {
+        amount: Number.isFinite(n) ? n : null,
+        category: textOf(params['category']),
+        account: textOf(params['account']),
+        ledger: textOf(params['ledger']),
+        time: time === '' ? date : time,
+    };
+}
+/** 采集页那几格取值，一次给全（`pickOf`／`probeOf`／`factsOf` 三个名字合成这一个粗入口）：
+ *  ① `pick` 三枚选择器的候选（分类退到哪一侧由 `kind` 定）；② `probe` 重复检测的探针；
+ *  ③ `facts` 摘要行的事实。三个都只读本次参数与近期记录，不碰库。 */
+export function valuesOf(input) {
+    return {
+        pick: pickOf(input.recent, input.kind),
+        probe: probeOf(input.params, input.today),
+        facts: factsOf(input.params, input.today),
+    };
+}
+/** 字段卡的每一格：一律由 `renderParamForm` 出（标签与控件配对、每格带 `name`）。收在件内，对外只给 `fieldCardOf`。 */
+function formFieldsOf(input) {
+    return input.slots.map((s) => {
+        const mark = input.marks.find((m) => m.name === s.name);
+        const value = isGiven(input.params[s.name]) ? String(input.params[s.name]) : (mark?.value ?? '');
+        const options = optionsFor(input.pick, s.name, value);
+        return {
+            name: s.name,
+            label: s.label,
+            hint: prefillHint(input.marks, s.name) ?? s.hint,
+            ...(options === undefined ? {} : { options }),
+            ...(s.required ? { required: true } : {}),
+            ...(value === '' ? {} : { value }),
+        };
+    });
+}
+/** 采集页字段卡那块（`renderParamForm` ＋ 本场景那句操作说明）。候选那一格由 `valuesOf` 出的 `pick` 给。 */
+export function fieldCardOf(input) {
+    return renderParamForm({
+        description: input.description,
+        fields: formFieldsOf({ slots: input.slots, params: input.params, marks: input.marks, pick: input.pick }),
+    });
+}
+/** 缺项那两处的原文，一次给全（两个名字合成一个粗入口）：
+ *  ① `command` 是缺项时那条写库指令原文——缺的值留成尖括号占位符，**只给看不给复制**（复制按钮在阻断条里被拿掉）；
+ *  ② `prompt` 是「照这句跟助手说一遍」那块话：说清缺什么、这一页先不写库、补齐之后说哪句——
+ *     **不给可跑的写库指令**。本轮整改：缺项清单里不再印参数名（库列名不上屏），
+ *     `重跑同一条命令` 换「跟助手说一遍」。
+ *  `replaces` 给「按中文名占位」以外的写法（拍账单的要素名）。 */
+export function blockedPromptOf(input) {
+    const filled = { ...input.params };
+    for (const b of input.blocked)
+        filled[b.name] = input.replaces?.[b.name] ?? '<' + b.label + '>';
+    return {
+        command: commandLine(input.key, filled),
+        prompt: '这一笔还差 ' + input.blocked.length + ' 项：'
+            + input.blocked.map((i) => i.label + '（' + i.why + '）').join('、')
+            + '。\n这一页先不写库；补齐之后跟助手说一遍，照这条说：' + input.key + '。',
+    };
+}
+//# sourceMappingURL=photoEscape.js.map

package/dist/shared/photoEscape.js.map

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

package/dist/shared/prefillNote.d.ts

@@ -0,0 +1,21 @@
+import type { BillRow } from '../fetch/db.js';
+/** 一条预填标注：哪一格／中文名／顶上去的值／来源。 */
+export interface PrefillMark {
+    readonly name: string;
+    readonly label: string;
+    readonly value: string;
+    readonly from: string;
+}
+/** 预填判定：`params` 里没给的字段，按近期最近一笔顶；历史也没有就按缺省顶。`today`＝本页执行那天（`YYYY-MM-DD`）。 */
+export declare function prefillOf(input: {
+    readonly params: Record<string, unknown>;
+    readonly recent: readonly BillRow[];
+    readonly today: string;
+}): PrefillMark[];
+/** 某一格的来源一句（给表单字段的提示用）；没有这一格＝返回 `undefined`。
+ *  本轮整改：原来的 `预填 支付宝 · 来自记录编号 1` 里那个 `·` 落在选择器回显上（版式位），
+ *  改一句连读的「已经替你填上 支付宝，来自…」——一句话说清，不用分隔符。 */
+export declare function prefillHint(marks: readonly PrefillMark[], name: string): string | undefined;
+/** 预填标注表：字段／取值／来源三列。**空数组＝没有预填，页上不出这一段**（返回空串）。 */
+export declare function prefillNote(marks: readonly PrefillMark[]): string;
+//# sourceMappingURL=prefillNote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefillNote.d.ts","sourceRoot":"","sources":["../../src/shared/prefillNote.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAeD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GAAG,WAAW,EAAE,CAsBhB;AAED;;2CAE2C;AAC3C,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3F;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAWjE"}

package/dist/shared/prefillNote.js

@@ -0,0 +1,78 @@
+/** 预填标注（缺口块之一，**唯一定义地**）：每个被历史数据预填的字段标出来源（老侧 `prefillBox` 的形态）。
+ *
+ * 谁在用（按实际写，别写名义调用点）：
+ *   ① `src/record/collect.ts`——过程型采集页：账户／账本／币种／时间这四格能由历史与缺省顶上，
+ *      顶上哪一格就在表单那一格的提示里写「预填·来源」，另出一张「预填标注」表把来源逐条列清（本件真调用点）；
+ *   ② **本票没有第二个调用点**：回执页报的是已写入的值，不预填，`src/record/receipt.ts` 不引本件
+ *      （件头原来写它「会引但本件不出」，那是名义调用点，按实际改掉）。
+ *  第二个消费者：`src/query/`（随兄弟图 #403 的查询域一起到位，同一套采集页／回执页／复制区要同一条口径）。
+ *  本票实测：本包 `src/` 下真引用本件的只有 `collect.ts` 一处。
+ *
+ * 口径（三件事一处定义）：
+ *   - **只预填四项**：账户／账本／币种（来源＝近期最近一笔的库内值）＋ 时间（来源＝本页执行那天的缺省时刻）；
+ *     分类**一律不预填**（施工图第四节第 10 条：分类不许留空交给助手猜），备注是自由文本也不预填；
+ *   - **缺省值不在本件另立一份**：账本「生活」／币种「人民币」引 `src/policy/category.ts` 的 `DEFAULTS`；
+ *     时间引同一件的 `defaultTimeOn`（`12:00:00` 的真源在口径层，本件不写第二份字面量）；
+ *   - **来源逐格可追**：库里顶来的写「来自记录编号 N（最近一笔）」，缺省顶的写「缺省值（库里还没有可用的…）」，
+ *     两种来源不许混成一句「自动填的」。
+ */
+import { renderDataTable } from 'base-paint/blocks';
+import { DEFAULTS, DEFAULT_TIME_SUFFIX, defaultTimeOn } from '../policy/category.js';
+/** 采集页要的四格（值 ＋ 中文名 ＋ 来源后缀）。缺省值一处定义：账本／币种／账户引口径层的 `DEFAULTS`
+ *  （账户缺省是空串＝落库默认，不走「缺省值（账户）」那一岔）。 */
+const PREFILL_FIELDS = [
+    { name: 'account', label: '账户', fallback: DEFAULTS.account, what: '账户' },
+    { name: 'ledger', label: '账本', fallback: DEFAULTS.ledger, what: '账本' },
+    { name: 'currency', label: '币种', fallback: DEFAULTS.currency, what: '币种' },
+];
+/** 取一个字段的字符串值（非字符串／空串一律当没给）。 */
+function textOf(v) {
+    return typeof v === 'string' ? v.trim() : '';
+}
+/** 预填判定：`params` 里没给的字段，按近期最近一笔顶；历史也没有就按缺省顶。`today`＝本页执行那天（`YYYY-MM-DD`）。 */
+export function prefillOf(input) {
+    const marks = [];
+    const last = input.recent.length > 0 ? input.recent[0] : undefined;
+    for (const f of PREFILL_FIELDS) {
+        if (textOf(input.params[f.name]) !== '')
+            continue;
+        const fromHistory = last === undefined ? '' : textOf(last[f.name]);
+        if (fromHistory !== '') {
+            marks.push({ name: f.name, label: f.label, value: fromHistory, from: '来自记录编号 ' + last?.id + '（最近一笔）' });
+            continue;
+        }
+        marks.push({
+            name: f.name, label: f.label, value: f.fallback,
+            from: f.fallback === '' ? '缺省值（库里还没有可用的' + f.what + '，留空＝落库默认）' : '缺省值（' + f.what + '）',
+        });
+    }
+    if (textOf(input.params['time']) === '') {
+        marks.push({
+            name: 'time', label: '时间', value: defaultTimeOn(input.today),
+            from: '缺省值（本页执行那天 ' + DEFAULT_TIME_SUFFIX + '）',
+        });
+    }
+    return marks;
+}
+/** 某一格的来源一句（给表单字段的提示用）；没有这一格＝返回 `undefined`。
+ *  本轮整改：原来的 `预填 支付宝 · 来自记录编号 1` 里那个 `·` 落在选择器回显上（版式位），
+ *  改一句连读的「已经替你填上 支付宝，来自…」——一句话说清，不用分隔符。 */
+export function prefillHint(marks, name) {
+    const hit = marks.find((m) => m.name === name);
+    return hit === undefined ? undefined : '已经替你填上 ' + hit.value + '，' + hit.from;
+}
+/** 预填标注表：字段／取值／来源三列。**空数组＝没有预填，页上不出这一段**（返回空串）。 */
+export function prefillNote(marks) {
+    if (marks.length === 0)
+        return '';
+    return renderDataTable({
+        columns: [
+            { key: 'label', label: '预填的格' },
+            { key: 'value', label: '顶上去的值' },
+            { key: 'from', label: '来源' },
+        ],
+        rows: marks.map((m) => ({ label: m.label, value: m.value === '' ? '（留空＝落库默认）' : m.value, from: m.from })),
+        caption: '预填标注（每个被顶上的格都写清来源）',
+    });
+}
+//# sourceMappingURL=prefillNote.js.map

package/dist/shared/prefillNote.js.map

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

package/dist/shared/receiptParts.d.ts

@@ -0,0 +1,12 @@
+import type { KpiCardInput } from 'base-paint/blocks';
+import type { BillReceipt } from './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/shared/receiptParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiptParts.d.ts","sourceRoot":"","sources":["../../src/shared/receiptParts.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,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/shared/receiptParts.js

@@ -0,0 +1,38 @@
+/** 写后回执页与采集页的两块共用件：状态卡 ＋ 页尾「对账信息」折叠区。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/record/receipt.ts`——结果型回执整页：`receiptStatusCard`（已改动／无改动）＋ `reconcileDisclosure`；
+ *   ② `src/record/collect.ts`——过程型采集页：`statusCard`（那一格写「待补槽位」）。
+ *  第二个消费者：`src/query/`（随兄弟图 #403 的查询域一起到位，出来的是同一套采集页／回执页／复制区）。
+ *
+ * 口径出处：照 `packages/skill-calorie/src/shared/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/shared/receiptParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiptParts.js","sourceRoot":"","sources":["../../src/shared/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/shared/recentPicks.d.ts

@@ -0,0 +1,26 @@
+/** 近期记录取候选值（**唯一定义地**）：三枚选择器（分类／账户／账本）的候选怎么取——值转字符串、
+ *  按最近在先去重、剔掉没给的、取前十二个；再把本次已给的值并进那一格。
+
+ * 谁在用（两处，指名；两处原先各写一份同形同名的取数，本次提到本件一处）：
+ *   ① `src/shared/photoEscape.ts`——记收入／记报销／记一笔／拍账单四个场景件的字段卡，它的 `pickOf` 一行转发到本件；
+ *   ② `src/record/collectBody.ts`——通用采集页装配体的那一格，它的 `pickOf` 同样一行转发到本件。
+
+ * 本件只吃普通数据、零跨目录引用：入参是「近期记录那几列」与「本次参数」这种普通数据，
+ *  **不引** `src/record/` 下的件，也不认 `CollectInput` 这类页面入参形状。可引的只有
+ *  `src/fetch/db.ts`（记录行的数据形状）与 `src/policy/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 optionsFor(pick: Record<string, readonly string[]>, name: string, value: string): readonly string[] | undefined;
+//# sourceMappingURL=recentPicks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recentPicks.d.ts","sourceRoot":"","sources":["../../src/shared/recentPicks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;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;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,SAAS,MAAM,EAAE,GAAG,SAAS,CAI/B"}

package/dist/shared/recentPicks.js

@@ -0,0 +1,41 @@
+import { DEFAULTS } from '../policy/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],
+    };
+}
+/** 一个字段的选项：选择器候选 ＋ 本次已给的值（已给的值不在候选里时并到队首，免得表单把它显示没了）。 */
+export function optionsFor(pick, name, value) {
+    const list = pick[name];
+    if (list === undefined || list.length === 0)
+        return undefined;
+    return value !== '' && !list.includes(value) ? [value, ...list] : [...list];
+}
+//# sourceMappingURL=recentPicks.js.map

package/dist/shared/recentPicks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recentPicks.js","sourceRoot":"","sources":["../../src/shared/recentPicks.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,sDAAsD;AACtD,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,oCAAoC;AACpC,MAAM,UAAU,MAAM,CAAC,CAAU;IAC/B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,kEAAkE;AAClE,SAAS,UAAU,CAAC,MAA0B,EAAE,KAAwC;IACtF,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,GAAG,CAAC,MAAM,IAAI,UAAU;YAAE,MAAM;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;gDACgD;AAChD,MAAM,UAAU,MAAM,CACpB,MAA0B,EAC1B,gBAAmC;IAEnC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB;QAC3D,OAAO;QACP,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,UAAU,CACxB,IAAuC,EACvC,IAAY,EACZ,KAAa;IAEb,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9D,OAAO,KAAK,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/dist/shared/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/shared/recordPicker.d.ts.map

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