skill-bill 0.2.0 → 0.2.1

package/dist/write/template-installment.js

@@ -0,0 +1,240 @@
+import { renderChips, renderChipRow, renderDataTable, renderDisclosure, renderFeedbackBlock, renderKpiGrid, renderParamForm } from 'base-paint/blocks';
+import { blockedBar, blockedItems, blockedMessage } from './blockedSlots.js';
+import { collectMissingTags, collectSectionTitle } from './collectFrame.js';
+import { copyArea, copyLog, undoExit } from '../shared/copyArea.js';
+import { installmentPreview, installmentShares } from './installmentPreview.js';
+import { DOC_SKILL, DOC_VERSION, docTitleOf, sceneKeyOf } from '../shared/pageIdentity.js';
+import { writePageShell as pageShell } from './pageParts.js';
+import { receiptStatusCard, reconcileDisclosure } from './receiptParts.js';
+import { summaryCards } from './summaryRow.js';
+import { typeBadge } from './typeBadge.js';
+import { fieldLabelOf } from './userWording.js';
+import { commandLine } from '../shared/writeParts.js';
+import { navBlock, pageBody, pageNav } from '../shared/pageSections.js';
+import { collectSourceNote, receiptSourceNote } from './sourceNote.js';
+/** 场景件拿到手的两张页（`Scene` 的 `collect`／`receipt` 两格）。 */
+export function bindInstallmentPages(spec) {
+    return { collect: (input) => collectPage(spec, input), receipt: (input) => receiptPage(spec, input) };
+}
+/** 一个值的字符串形态。 */
+function textOf(v) {
+    if (typeof v === 'string')
+        return v.trim();
+    return typeof v === 'number' ? String(v) : '';
+}
+/** 金额：数字或数字串；解析不出给 `null`。 */
+function amountOf(v) {
+    const n = typeof v === 'number' ? v : Number(textOf(v));
+    return Number.isFinite(n) ? n : null;
+}
+/** 页面内置 envelope（采集页 `ok:false`、回执页 `ok:true`；两页同一形状）。 */
+function envelopeOf(key, ok, message) {
+    return {
+        version: DOC_VERSION, skill: DOC_SKILL, shape: 'receipt', key: sceneKeyOf(key),
+        data: { ok, message },
+    };
+}
+/** 缺项阻断条整条收进折叠区：首屏只留缺项标签与一行副标题，口令原文不再常驻版面。
+ *  内容与判定一字不动（仍是共用件 `blockedBar` 的产出），只换摆法；折叠与否那枚置灰按钮都点不动。 */
+function blockedFold(title, items, command) {
+    if (items.length === 0)
+        return '';
+    return renderDisclosure({
+        title,
+        contentHtml: blockedBar({ items, command }),
+    });
+}
+/** 分摊那一格：三样齐了才算得出来；齐了就交给共用件算，算不动（解析失败）把那句话原样报回来。 */
+function previewOrNote(spec, params) {
+    const total = textOf(params[spec.totalName]);
+    const periods = textOf(params[spec.periodsName]);
+    const first = textOf(params[spec.firstDateName]);
+    if (total === '' || periods === '' || first === '') {
+        return { html: '', err: '' };
+    }
+    try {
+        return { html: installmentPreview({ total, periods, startDate: first }), err: '' };
+    }
+    catch (e) {
+        return { html: '', err: e instanceof Error ? e.message : String(e) };
+    }
+}
+/** 采集页正文：参数只读回显 ＋ 期数角标 ＋ 分摊预览表 ＋ 阻断条 ＋ 两段复制区。块序见件头。 */
+function collectPage(spec, input) {
+    const { key, params, missing } = input;
+    const total = textOf(params[spec.totalName]);
+    const periods = textOf(params[spec.periodsName]);
+    const first = textOf(params[spec.firstDateName]);
+    const amount = amountOf(params.amount);
+    const base = blockedItems({ params, missing, kind: spec.kind });
+    const extra = [];
+    if (total === '')
+        extra.push({ name: spec.totalName, label: spec.totalLabel, why: spec.totalWhy });
+    if (periods === '')
+        extra.push({ name: spec.periodsName, label: spec.periodsLabel, why: spec.periodsWhy });
+    if (first === '')
+        extra.push({ name: spec.firstDateName, label: spec.firstDateLabel, why: spec.firstDateWhy });
+    const preview = previewOrNote(spec, params);
+    if (preview.err !== '') {
+        // 解析失败照实报错（不静默当空、不拿 0 顶）：这一格进了阻断条，复制指令就不出。
+        extra.push({ name: spec.totalName, label: spec.totalLabel, why: preview.err });
+    }
+    const blocked = [...base, ...extra];
+    const message = blockedMessage(missing, base)
+        + (extra.length === 0 ? '' : '。本型另需 ' + extra.length + ' 项，见下面的缺项徽章');
+    /** 副标题只报计数（进度形状）；缺项明细在标签组与阻断表明细两处形状里。 */
+    const subtitle = spec.word + '还差 ' + blocked.length + ' 项';
+    const envelope = envelopeOf(key, false, message);
+    const facts = {
+        amount,
+        category: textOf(params.category),
+        account: textOf(params.account),
+        ledger: textOf(params.ledger),
+        time: textOf(params.time),
+    };
+    const shares = preview.err === '' && preview.html !== ''
+        ? installmentShares({ total, periods, startDate: first })
+        : [];
+    const filled = { ...params };
+    for (const b of blocked)
+        filled[b.name] = '<' + b.label + '>';
+    // 缺项逐项一行（一行一件事），不带库列名、不用顿号连写。
+    const lackLines = blocked.map((i) => i.label + '：' + (i.why === '没给' ? '没给' : i.why)).join('\n');
+    const prompt = (blocked.length === 0
+        ? '照下面这个口径记这一笔分期，每期金额与日期按预览表来。'
+        : '这一笔还差 ' + blocked.length + ' 项，逐项补齐：\n' + lackLines)
+        + '\n请加载「饼干记账」技能，帮我记一笔分期。\n唤醒词：' + spec.word + '\n'
+        + spec.totalLabel + '：' + (total || '<' + spec.totalLabel + '>') + '\n'
+        + spec.periodsLabel + '：' + (periods || '<' + spec.periodsLabel + '>') + '\n'
+        + spec.firstDateLabel + '：' + (first || '<' + spec.firstDateLabel + '>') + '\n'
+        + '分类：' + (facts.category || '<三级分类>') + '\n'
+        + '账户：' + (facts.account || '<账户>') + '\n'
+        + '账本：' + (facts.ledger || '<账本>') + '\n'
+        + (shares.length === 0 ? '分摊预览还没算出来，三样齐了才算。' : '分摊预览见上面那张表。')
+        + '\n每期按上面那张表逐期记，尾差归最后一期。';
+    const content = [
+        typeBadge({
+            kind: spec.kind,
+            pageKind: '采集页',
+            status: blocked.length > 0 ? 'danger' : 'warn',
+            state: blocked.length > 0 ? '待补槽位 · 未写库（已阻断）' : '待核对 · 未写库',
+            next: '',
+        }),
+        blocked.length === 0 ? '' : collectSectionTitle({ no: 1, title: spec.section1 }),
+        collectMissingTags({ labels: blocked.map((i) => i.label) }),
+        renderKpiGrid(summaryCards(facts)),
+        renderChipRow({ items: spec.chips.map((text) => ({ text })) }),
+        collectSectionTitle({ no: 2, title: spec.section2 }),
+        renderParamForm({
+            description: spec.description,
+            fields: [
+                { name: spec.totalName, label: spec.totalLabel, readonly: true, value: total, hint: spec.totalHint },
+                { name: spec.periodsName, label: spec.periodsLabel, readonly: true, value: periods, hint: spec.periodsHint },
+                { name: spec.firstDateName, label: spec.firstDateLabel, readonly: true, value: first, hint: spec.firstDateHint },
+            ],
+        }),
+        collectSectionTitle({ no: 3, title: spec.section3 }),
+        shares.length === 0
+            ? ''
+            : renderFeedbackBlock({
+                toast: {
+                    msg: '共 ' + shares.length + ' 期，已摊出来',
+                    detail: shares.length > 24 ? '本页先显前 12 期，其余折在下面那一格里。' : '全列在下面那张表里。',
+                    icon: 'info',
+                },
+                staticNotice: true,
+            }),
+        preview.html,
+        preview.html === ''
+            ? renderChips({ items: [{ text: spec.noSharesChip }] })
+            : '',
+        blockedFold(spec.foldTitle, blocked, commandLine(key, filled)),
+        copyArea({
+            prompt: { text: prompt, label: blocked.length === 0 ? spec.promptLabel : spec.promptLabelBlocked },
+            data: { envelope },
+            log: {
+                envelope,
+                copyLog: copyLog({
+                    command: commandLine(key, params),
+                    source: input.source,
+                    detail: '没写库（采集页）',
+                    actionAt: input.actionAt,
+                    version: DOC_VERSION,
+                }),
+            },
+        }),
+        collectSourceNote(facts.time),
+    ].join('');
+    return pageShell({
+        docTitle: docTitleOf(spec.word + ' 采集页'), title: spec.word, subtitle,
+        slot: 'collect', page: 'collect', shape: envelope.shape, key, content,
+    });
+}
+/** 回执页正文：分摊预览表（写库那一笔按期数摊开的同一张）＋ 写入明细表 ＋ 对账折叠区 ＋ 退出口 ＋ 复制区。
+ *  块清单既拼正文也派生页内导航（共用位 `../shared/pageSections.js`）；块序见件头。 */
+function receiptPage(spec, input) {
+    const { key, params, receipt } = input;
+    const preview = previewOrNote(spec, params);
+    const total = textOf(params[spec.totalName]);
+    const periods = textOf(params[spec.periodsName]);
+    const envelope = envelopeOf(key, true, receipt.summary);
+    const blocks = [
+        navBlock(renderKpiGrid([
+            ...summaryCards(input.facts),
+            receiptStatusCard(receipt, input.writtenDetail),
+            { label: spec.receiptRowsLabel, value: receipt.affectedRows + ' 笔', detail: spec.receiptRowsDetail },
+            {
+                label: spec.receiptPeriodsLabel,
+                value: (total || '未给') + ' ÷ ' + (periods || '未给') + ' 期',
+                detail: spec.firstDateLabel + ' ' + (textOf(params[spec.firstDateName]) || '未给'),
+            },
+        ]), 'sec-kpi', '读数'),
+        {
+            html: renderFeedbackBlock({
+                toast: {
+                    msg: '这一笔按 ' + (periods || '未给') + ' 期摊，尾差归最后一期',
+                    detail: spec.receiptFeedbackDetail,
+                    icon: 'ok',
+                },
+                staticNotice: true,
+            }),
+        },
+        navBlock(preview.html === ''
+            ? renderChips({ items: [{ text: preview.err === '' ? spec.receiptNoSharesChip : '分摊没算出来：' + preview.err }] })
+            : preview.html, 'sec-shares', '分期表'),
+        navBlock(renderDataTable({
+            columns: [{ key: 'k', label: '哪一项' }, { key: 'v', label: '记成什么' }],
+            rows: input.detail,
+            caption: spec.receiptCaption,
+        }), 'sec-detail', '明细'),
+        navBlock(reconcileDisclosure(receipt), 'sec-reconcile', '对账'),
+        { html: receipt.recordId === null ? '' : undoExit(receipt.recordId) },
+        navBlock(copyArea({
+            data: { envelope },
+            log: {
+                envelope,
+                copyLog: copyLog({
+                    command: commandLine(key, params),
+                    source: receipt.source,
+                    detail: '改了 ' + receipt.affectedRows + ' 笔，写进去 '
+                        + (receipt.writtenFields.map((f) => fieldLabelOf(f)).join('、') || '没改到任何一项'),
+                    actionAt: receipt.actionAt,
+                    version: DOC_VERSION,
+                }),
+            },
+        }), 'sec-copy', '复制'),
+        { html: receiptSourceNote(input.facts.time, receipt.affectedRows) },
+    ];
+    const content = typeBadge({
+        kind: spec.kind,
+        pageKind: '回执',
+        status: 'ok',
+        state: spec.receiptState,
+        next: spec.receiptNext,
+    }) + pageNav(blocks) + pageBody(blocks);
+    return pageShell({
+        docTitle: docTitleOf(spec.word + ' 回执'), title: spec.word, subtitle: receipt.summary,
+        slot: 'receipt', page: 'receipt', shape: envelope.shape, key, content,
+    });
+}
+//# sourceMappingURL=template-installment.js.map

package/dist/write/template-installment.js.map

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

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

@@ -0,0 +1,83 @@
+import type { BlockedItem } from './blockedSlots.js';
+import type { Scene } from './scene.js';
+/** 采集页文案函数读到的那一份事实（形态判定只在本件做一次）。 */
+interface UpdatePage {
+    /** 页上认到的记录编号（没给＝null）＋ 被认到的那一行编号（读不到＝null）与撤销标记原文（读不到＝空串）。 */
+    readonly id: number | null;
+    readonly rowId: number | null;
+    readonly deletedAt: string;
+    /** 那一行是不是已带撤销标记（软删口径取 `../shared/recordPicker.js`，本件不重判一次）。 */
+    readonly deleted: boolean;
+    /** 读那一条那一路上的库报错收尾（读通了＝空串；空态正文后面缀的它）。 */
+    readonly readFailure: string;
+    /** 本次缺的槽位与本次参数（徽章状态那几句、照抄写库指令那几处文案读它们）。 */
+    readonly blocked: readonly BlockedItem[];
+    readonly params: Record<string, unknown>;
+}
+/** 中段只读回显之后那一岔：`none`＝不出／`diff`＝改前改后对照表／`caliber`＝一行口径／`note`＝一块说明。 */
+type MiddleExtra = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'diff';
+    readonly caption: string;
+} | {
+    readonly kind: 'caliber';
+    readonly text: (page: UpdatePage) => string;
+} | {
+    readonly kind: 'note';
+    readonly title: string;
+    readonly text: (page: UpdatePage) => string;
+    readonly next: string;
+};
+/** 采集页中段（第 2 段标题下面那一格）的四种形态：缺编号先挑一条，选定之后按库内那一行分三岔。 */
+interface MiddleSpec {
+    /** 缺编号时那块候选单选认哪些记录（`update`／`undo`／`restore` 三种过筛条件）＋ 换一句话说这一格。 */
+    readonly pick: {
+        readonly mode: 'update' | 'undo' | 'restore';
+        readonly hint?: string;
+    };
+    /** 那一条已带撤销标记：只读回显的标题 ＋ 回显之后那一岔。 */
+    readonly markedCaption: (page: UpdatePage) => string;
+    readonly marked: MiddleExtra;
+    /** 那一条读不到：空态标题 ＋ 正文头半句（库报错那句收尾由本件缀上，三条词共用一个写法）。 */
+    readonly noRowTitle: string;
+    readonly noRowText: (page: UpdatePage) => string;
+    /** 那一条读到了、也没带标记：只读回显的标题 ＋ 回显之后那一岔。 */
+    readonly plainCaption: (page: UpdatePage) => string;
+    readonly plain: MiddleExtra;
+}
+/** 场景给模板的**差异声明**：值、文案与「哪个可选块出不出」，**不含任何块位拼装**。 */
+export interface UpdateSpec {
+    /** 唤醒词（页标题与几句文案里都写它；带 `op` 的两件词面不同）。 */
+    readonly wake: string;
+    /** 命令全名（三条词同一条 `bill.record.update`；复制指令与信封都引它一份）。 */
+    readonly key: string;
+    /** 采集页：类型徽章那枚状态（改记录报「三形态之一…」，撤销／恢复报缺没缺项）。 */
+    readonly collectState: (page: UpdatePage) => string;
+    /** 采集页：选定编号之后页标题里那句「确认什么」。 */
+    readonly confirmTitle: string;
+    /** 采集页：摘要行之后那一行口径（空串＝本场景不出这一行）。 */
+    readonly caliber: string;
+    /** 采集页：中段（候选那一格与三种选定形态各自的文案与块岔）。 */
+    readonly middle: MiddleSpec;
+    /** 采集页：复制 prompt 区那段话（按页上认到的编号与那一行的值算）。 */
+    readonly prompt: (page: UpdatePage) => string;
+    /** 回执页：类型徽章那枚状态（`ok`＝绿档、`warn`＝黄档）。 */
+    readonly receiptStatus: 'ok' | 'warn';
+    /** 回执页：类型徽章那句下一步。 */
+    readonly receiptNext: string;
+    /** 回执页：读数行之后那一行口径（空串＝本场景不出这一行）。 */
+    readonly receiptCaliber: string;
+    /** 回执页：明细表之前那块结果表取哪一种（`none`＝改记录不出／`undo`＝撤销标记对照／`restore`＝标记现值）。 */
+    readonly receiptResult: 'none' | 'undo' | 'restore';
+    /** 回执页：退出口那枚给哪件事（`undo`＝「撤销这一笔」；`restore`＝「恢复这一笔」）。 */
+    readonly receiptExit: 'undo' | 'restore';
+}
+/** 场景件拿到手的两张页（`Scene` 的 `collect`／`receipt` 两格）。 */
+export declare function bindUpdatePages(spec: UpdateSpec): Pick<Scene, 'collect' | 'receipt'>;
+/** 撤销／恢复两件共用的徽章状态（缺项就报「已阻断」，不缺报「待核对」；改记录那一件另有三种形态的说法）。 */
+export declare function blockedStateOf(page: UpdatePage): string;
+/** 撤销／恢复两件共用的「这个编号读不到」那句（编号照实写；库报错那句收尾由本件缀在话后）。 */
+export declare function missingRowText(page: UpdatePage): string;
+export {};
+//# sourceMappingURL=template-update.d.ts.map

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

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

package/dist/write/template-update.js

@@ -0,0 +1,263 @@
+/** 写入域模板之二 · **改记录确认**（`t685-按域页型表.md` §2.1 第 5 张）。
+ *
+ * **本件是块位序列的唯一住所**：两张页的块序、每块的出现条件、每块吃到的数据都写在这里；场景件
+ *  （`scene-update`／`scene-undo`／`scene-restore`）只给差异值——唤醒词、几句文案、中段按形态出哪一岔、
+ *  回执页的结果表与退出口取哪一种。改一次版式只动本件一处，三张页同时跟着改。
+ * 盖住的场景（老侧一张 `update_confirm.html` 扛三条词，本仓按「一命令一页」拆开、装配体共用一份）：
+ *  改记录 `update` · 撤销 `undo` · 恢复 `restore`——三条都是 `bill.record.update` 的一支，靠 `op` 分。
+ *
+ * **块位序列**（照 #688 §五 5.2 的 ① 采集／④ 回执 两类；● 恒出、○ 有内容才出）：
+ *   采集页：类型徽章 ● → 第 1 段标题 ○（缺项才出）→ 缺项标签 ● → 摘要行 ● → 口径行 ○（改记录不出）→
+ *     第 2 段标题 ● → 缺项阻断条（折叠）● → 中段 ●（缺编号＝候选单选；选定＝只读回显 ＋ 一岔：
+ *     diff 表／说明块／一行口径／不出）→ 复制 prompt 区 ● → 复制区 ● → 来源脚注 ●（#688 §五 第 26 行）
+ *   回执页：类型徽章 ● → 页内导航 ●（表序第 4 行；回执页＝结果型 ④，采集页＝过程型 ① 故不出）→ 读数行 ● →
+ *     口径行 ○ → 结果表 ○（撤销＝撤销标记对照、恢复＝标记现值）→ 明细表 ● → 对账折叠区 ● →
+ *     退出口 ○ → 复制区 ● → 来源脚注 ●（第 26 行）
+ * 谁在用（三个调用点，指名）：`src/write/scene-{update,undo,restore}.ts`——各件的 `Scene.collect`／`Scene.receipt`
+ *  都是 `bindUpdatePages(spec)` 的产物，本件不自己出页。
+ */
+import { renderCaliberLine, renderCopyBlock, renderDataTable, renderDisclosure, renderKpiGrid } from 'base-paint/blocks';
+import { blockedBar, blockedItems, blockedMessage } from './blockedSlots.js';
+import { collectMissingTags, collectSectionTitle } from './collectFrame.js';
+import { copyArea, copyLog, promptCopyArea, undoExit } from '../shared/copyArea.js';
+import { diffOf, diffTable } from './diffTable.js';
+import { emptyNote } from './emptyNote.js';
+import { DOC_SKILL, DOC_VERSION, docTitleOf, sceneKeyOf } from '../shared/pageIdentity.js';
+import { writePageShell as pageShell } from './pageParts.js';
+import { diffRowsFor, pickerBlock, readRowById, snapshotTable } from './recordPicker.js';
+import { receiptStatusCard, reconcileDisclosure } from './receiptParts.js';
+import { summaryCards, summaryRow } from './summaryRow.js';
+import { typeBadge } from './typeBadge.js';
+import { fieldLabelOf } from './userWording.js';
+import { commandLine } from '../shared/writeParts.js';
+import { navBlock, pageBody, pageNav } from '../shared/pageSections.js';
+import { collectSourceNote, receiptSourceNote } from './sourceNote.js';
+/** 场景件拿到手的两张页（`Scene` 的 `collect`／`receipt` 两格）。 */
+export function bindUpdatePages(spec) {
+    return { collect: (input) => collectPage(spec, input), receipt: (input) => receiptPage(spec, input) };
+}
+/** 撤销／恢复两件共用的徽章状态（缺项就报「已阻断」，不缺报「待核对」；改记录那一件另有三种形态的说法）。 */
+export function blockedStateOf(page) {
+    return page.blocked.length > 0 ? '待补槽位 · 未写库（已阻断）' : '待核对 · 未写库';
+}
+/** 撤销／恢复两件共用的「这个编号读不到」那句（编号照实写；库报错那句收尾由本件缀在话后）。 */
+export function missingRowText(page) {
+    return '记录编号 ' + page.id + ' 在库里读不到。';
+}
+/** 一个值的字符串形态（数字写十进制串，其余形态按空串用）。 */
+function textOf(v) {
+    if (typeof v === 'string')
+        return v.trim();
+    return typeof v === 'number' ? String(v) : '';
+}
+/** 记录编号：`params.id` 是正整数才算给了（其余形态一律当没给，不猜）。 */
+function idOf(params) {
+    const raw = params['id'];
+    const n = typeof raw === 'number' ? raw : textOf(raw) === '' ? NaN : Number(textOf(raw));
+    return Number.isInteger(n) && n > 0 ? n : null;
+}
+/** 摘要行的事实：有原记录就取库内那一行（页面说的是那一条的现状），没有就取本次参数。 */
+function factsOf(row, params) {
+    if (row !== null) {
+        return { amount: row.amount, category: row.category, account: row.account, ledger: row.ledger, time: row.time };
+    }
+    const raw = params['amount'];
+    const n = typeof raw === 'number' ? raw : textOf(raw) === '' ? NaN : Number(textOf(raw));
+    return {
+        amount: Number.isFinite(n) ? n : null, category: textOf(params['category']), account: textOf(params['account']),
+        ledger: textOf(params['ledger']), time: textOf(params['time']),
+    };
+}
+/** 缺项时那条写库指令原文：缺的值留成尖括号占位符，**只给看不给复制**。 */
+function blockedCommand(key, params, blocked) {
+    const filled = { ...params };
+    for (const b of blocked)
+        filled[b.name] = '<' + b.label + '>';
+    return commandLine(key, filled);
+}
+/** 缺项阻断条整条收进折叠区（判定与文案一字不动，仍是共用件 `blockedBar` 的产出，只换摆法）。 */
+function blockedFold(items, command) {
+    if (items.length === 0)
+        return '';
+    return renderDisclosure({ title: '还缺什么，以及补齐后照抄的那条', contentHtml: blockedBar({ items, command }) });
+}
+/** 页面内置 envelope（采集页 `ok:false`、回执页 `ok:true`；两页同一形状）。 */
+function envelopeOf(key, ok, message) {
+    return { version: DOC_VERSION, skill: DOC_SKILL, shape: 'receipt', key: sceneKeyOf(key), data: { ok, message } };
+}
+/** 允许改的字段名单：取自槽位表（`id`／`op` 两格不是被改的字段），本件不另抄一份。 */
+function changeFieldsOf(input) {
+    return input.slots.filter((s) => s.name !== 'id' && s.name !== 'op').map((s) => s.name);
+}
+/** 采集页上认到的那一份事实：文案函数读的那一格 ＋ 那一行本身（摘要行与 diff 表要整行，只读一次库）。 */
+function pageOf(input) {
+    const id = idOf(input.params);
+    const probe = id === null ? null : readRowById(id);
+    const row = probe === null ? null : probe.row;
+    return {
+        row,
+        page: {
+            id, rowId: row === null ? null : row.id, deletedAt: row === null ? '' : String(row.deleted_at),
+            deleted: probe !== null && probe.deleted,
+            readFailure: probe !== null && !probe.ok ? probe.reason + '。' : '',
+            blocked: blockedItems({ params: input.params, missing: input.missing, kind: '' }),
+            params: input.params,
+        },
+    };
+}
+/** 中段：缺编号先挑一条；选定之后按库内那一行分三岔，每岔＝只读回显 ＋ 只读回显之后那一岔块。 */
+function middleBlock(spec, page, row, input) {
+    if (page.id === null) {
+        return pickerBlock({ mode: spec.pick.mode, ...(spec.pick.hint === undefined ? {} : { hint: spec.pick.hint }) });
+    }
+    if (row === null) {
+        return emptyNote({
+            title: spec.noRowTitle, text: spec.noRowText(page) + page.readFailure,
+            next: '核一下编号，或先说清是哪一笔。',
+        });
+    }
+    if (page.deleted)
+        return snapshotTable(row, spec.markedCaption(page)) + extraBlock(spec.marked, page, row, input);
+    return snapshotTable(row, spec.plainCaption(page)) + extraBlock(spec.plain, page, row, input);
+}
+/** 只读回显之后那一岔：`none` 不出／`caliber` 一行口径／`note` 一块说明／`diff` 改前改后对照表。 */
+function extraBlock(extra, page, row, input) {
+    if (extra.kind === 'none')
+        return '';
+    if (extra.kind === 'caliber')
+        return renderCaliberLine(extra.text(page));
+    if (extra.kind === 'note')
+        return emptyNote({ title: extra.title, text: extra.text(page), next: extra.next });
+    return diffTable({ rows: diffRowsFor({ row, params: input.params, fields: changeFieldsOf(input) }), caption: extra.caption });
+}
+/** 过程型采集页：缺项或缺编号时出这一页（只采集、不写库）。 */
+function collectPage(spec, input) {
+    const { page, row } = pageOf(input);
+    const facts = factsOf(row, input.params);
+    const envelope = envelopeOf(spec.key, false, blockedMessage(input.missing, page.blocked));
+    /** 副标题只报缺哪一项（不重复「已出采集页，补齐之后跟助手说一遍」那句）。 */
+    const subtitle = page.blocked.length === 0 ? '' : '还差 ' + page.blocked.length + ' 项必需项';
+    const content = [
+        typeBadge({ kind: '', status: 'danger', state: spec.collectState(page), pageKind: page.id === null ? '挑一条记录' : '核对这一条', next: '' }),
+        page.blocked.length === 0 ? '' : collectSectionTitle({ no: 1, title: '先看这一笔缺什么' }),
+        collectMissingTags({ labels: page.blocked.map((i) => i.label) }),
+        summaryRow(facts),
+        spec.caliber === '' ? '' : renderCaliberLine(spec.caliber),
+        collectSectionTitle({ no: 2, title: page.id === null ? '先挑一条记录' : '核对这一条' }),
+        blockedFold(page.blocked, blockedCommand(spec.key, input.params, page.blocked)),
+        middleBlock(spec.middle, page, row, input),
+        promptCopyArea(spec.prompt(page), '挑好记录后照这句跟助手说一遍'),
+        copyArea({
+            data: { envelope },
+            log: {
+                envelope,
+                copyLog: copyLog({
+                    command: commandLine(spec.key, input.params), source: input.source, detail: '没写库（采集页）',
+                    actionAt: input.actionAt, version: DOC_VERSION,
+                }),
+            },
+        }),
+        collectSourceNote(facts.time),
+    ].join('');
+    return pageShell({
+        docTitle: docTitleOf(spec.wake + ' 补齐槽位'),
+        title: spec.wake,
+        subtitle, slot: 'collect', page: 'collect', shape: envelope.shape, key: spec.key, content,
+    });
+}
+/** 回执页的结果表：改记录不出；撤销出「撤销标记」对照（写库后再读一次那一条），恢复出标记现值。 */
+function resultBlock(spec, receipt) {
+    if (spec.receiptResult === 'none')
+        return '';
+    const after = receipt.recordId === null ? null : readRowById(receipt.recordId);
+    const readAt = after !== null && after.ok && after.row !== null ? after.row.deleted_at : undefined;
+    if (spec.receiptResult === 'restore') {
+        return renderDataTable({
+            columns: [{ key: 'k', label: '哪一项' }, { key: 'v', label: '记成什么' }],
+            rows: [
+                { k: fieldLabelOf('id'), v: receipt.recordId === null ? '还没有' : String(receipt.recordId) },
+                { k: fieldLabelOf('deleted_at') + '现在是什么样', v: readAt === undefined
+                        ? '这一页读不回这一条，以写库回执为准'
+                        : readAt === null || String(readAt).trim() === '' ? '已清掉，这一笔已恢复正常' : '还带着：' + String(readAt) },
+                { k: '清掉之后', v: '这一笔回到查询和统计里。想再撤走就说「撤销」' },
+            ],
+            caption: '恢复结果',
+        });
+    }
+    const stamped = after !== null && after.ok && after.row !== null && after.row.deleted_at !== null
+        ? String(after.row.deleted_at) : '';
+    const rows = stamped === ''
+        ? []
+        : diffOf({ fields: ['撤销标记'], before: { 撤销标记: null }, after: { 撤销标记: stamped } });
+    if (rows.length > 0)
+        return diffTable({ rows, caption: '改前改后对照　只动「撤销标记」这一项' });
+    return renderDataTable({
+        columns: [{ key: 'k', label: '哪一项' }, { key: 'v', label: '记成什么' }],
+        rows: [
+            { k: fieldLabelOf('deleted_at'), v: '已打上（本页再读时已看不到这一条）' },
+            { k: '撤销后能不能找回来', v: '能：点「恢复」把它找回来' },
+        ],
+        caption: '撤销结果',
+    });
+}
+/** 回执页的退出口：`undo`＝「撤销这一笔」（走共用件 `../shared/copyArea.js`）；`restore`＝撤销那一张页专用的
+ *  「恢复这一笔」——只留那枚按钮与一句去向说明，不带复制按钮、不带 `data-t`（复制按钮走下面复制区那一组）。 */
+function exitBlock(kind, recordId) {
+    if (kind === 'undo')
+        return undoExit(recordId);
+    return renderCopyBlock({
+        title: '想反悔（把这一笔找回来）',
+        buttons: [{ label: '↩︎ 恢复这一笔', kind: 'red', actionId: 'ilife-exit-restore' }],
+    }) + renderCaliberLine('想反悔就用下面那颗「复制数据」，里面带着一句恢复的话。');
+}
+/** 回执页的结果表那一块：**有内容才进导航**（改记录不出这一块，进导航就会留一枚指向空区块的条目）。 */
+function resultBlockOf(spec, receipt) {
+    const html = resultBlock(spec, receipt);
+    return html === '' ? [] : [navBlock(html, 'sec-result', '结果')];
+}
+/** 结果型回执页：写库成功后出这一页（写库那一半在 `./write.ts`）。
+ *  块清单既拼正文也派生页内导航（共用位 `../shared/pageSections.js`）；块序见件头。 */
+function receiptPage(spec, input) {
+    const { receipt } = input;
+    const envelope = envelopeOf(spec.key, true, receipt.summary);
+    const blocks = [
+        navBlock(renderKpiGrid([
+            ...summaryCards(input.facts),
+            receiptStatusCard(receipt, input.writtenDetail),
+            { label: '这次记了几笔', value: receipt.affectedRows + ' 笔', detail: '按库里的改动算' },
+            {
+                label: '写进去的项', value: receipt.writtenFields.length + ' 项',
+                detail: receipt.writtenFields.length === 0 ? '没改到任何一项' : '逐项见下面的明细表',
+            },
+        ]), 'sec-kpi', '读数'),
+        { html: spec.receiptCaliber === '' ? '' : renderCaliberLine(spec.receiptCaliber) },
+        ...resultBlockOf(spec, receipt),
+        navBlock(renderDataTable({
+            columns: [{ key: 'k', label: '哪一项' }, { key: 'v', label: '记成什么' }],
+            rows: input.detail, caption: '写进去的项与值',
+        }), 'sec-detail', '明细'),
+        navBlock(reconcileDisclosure(receipt), 'sec-reconcile', '对账'),
+        { html: receipt.recordId === null ? '' : exitBlock(spec.receiptExit, receipt.recordId) },
+        navBlock(copyArea({
+            data: { envelope },
+            log: {
+                envelope,
+                copyLog: copyLog({
+                    command: commandLine(spec.key, input.params), source: receipt.source,
+                    detail: '改了 ' + receipt.affectedRows + ' 笔，写进去 '
+                        + (receipt.writtenFields.map((f) => fieldLabelOf(f)).join('、') || '没改到任何一项'),
+                    actionAt: receipt.actionAt, version: DOC_VERSION,
+                }),
+            },
+        }), 'sec-copy', '复制'),
+        { html: receiptSourceNote(input.facts.time, receipt.affectedRows) },
+    ];
+    const content = typeBadge({ kind: '', status: spec.receiptStatus, state: '写库成功', pageKind: '回执', next: spec.receiptNext })
+        + pageNav(blocks) + pageBody(blocks);
+    return pageShell({
+        docTitle: docTitleOf(spec.wake + ' 回执'),
+        title: spec.wake,
+        subtitle: receipt.summary, slot: 'receipt', page: 'receipt', shape: envelope.shape, key: spec.key, content,
+    });
+}
+//# sourceMappingURL=template-update.js.map