skill-bill 0.1.0 → 0.2.1

package/dist/goal/scene-budget.d.ts

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

package/dist/goal/scene-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-budget.d.ts","sourceRoot":"","sources":["../../src/goal/scene-budget.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAqB,aAAa,EAAE,MAAM,YAAY,CAAC;AAanE,eAAO,MAAM,KAAK,EAAE,aAgDnB,CAAC"}

package/dist/goal/scene-budget.js

@@ -0,0 +1,125 @@
+/** 场景件：**看预算**（`op=budget`）——本件只是差异声明，块位序列住 `./template-progress.ts`。
+ *
+ * 本件的差异（老侧 `templates/目标/budget_view.html`）：
+ *   ① 4 张读数卡同数同序：预算总额／实际支出／剩余／超支项（`:193-196`）；
+ *      **超支项为 0 时写「✓ 无」而不是画一个 0**（`:196`，老侧长板，照抄）；
+ *   ② 每条预算一张带进度条的卡：状态徽章 ＋ 预算／已用／笔数 ＋ 进度 ＋ 剩余或超出 ＋ **月底预测三态**
+ *      （`:207-235`；三态阈值 ±0.01 照 `:216-217`，那句话的取值为 `./pageParts.js` 的 `monthEndHintOf`）；
+ *   ③ **进度百分比双端夹取**：老侧这一张只有上界（`:209` 的 `Math.min(b.pct,100)`），而显示那一处 `:228`
+ *      连下界都没有——负 pct 会画负宽度 ＋ 印负百分比；同域的 `saving_view.html:208` 是双端
+ *      ⇒ **同域两套下界口径，新侧取双端**（口径住 `./pageParts.js` 的 `clampPct`）。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { MONTH_RE } from '../shared/dateRange.js';
+import { BUDGET_STATUS_META, clampPct, money, monthEndHintOf, pctText } from './pageParts.js';
+import { localMonth, textOf } from './params.js';
+import { bindGoalProgressPage } from './template-progress.js';
+const WORD = projectWakeWord({ key: 'bill.goal.query', op: 'budget' });
+const WRITE_WORD = projectWakeWord({ key: 'bill.goal.write', op: 'set-budget' });
+const KEY = 'bill.goal.query';
+/** 这一页看的是哪个月（参数给的月份归一不了就按本月——与写命令那一支同一处口径）。 */
+function monthOf(params) {
+    const raw = textOf(params['month']);
+    return MONTH_RE.test(raw) ? raw : localMonth();
+}
+export const SCENE = {
+    id: 'budget',
+    key: KEY,
+    op: 'budget',
+    family: '进度',
+    ...bindGoalProgressPage({
+        word: WORD,
+        docSuffix: '·预算执行',
+        window: (input) => monthOf(input.params) + ' 的预算执行（当月支出实时合计）',
+        conclusion: (input) => {
+            const e = input.budget;
+            if (e === null || e.budgets.length === 0)
+                return monthOf(input.params) + ' 还没有设置预算，这个月花多少都还没有上限。';
+            const t = e.totals;
+            const head = '一共 ' + String(e.budgets.length) + ' 条预算，加起来 ' + money(t.budget) + ' 元，已经用掉 '
+                + money(t.actual) + ' 元。';
+            if (t.budget <= 0)
+                return head;
+            return head + '整体用掉 ' + pctText(clampPct(t.actual / t.budget * 100))
+                + (t.over_count > 0 ? '，其中 ' + String(t.over_count) + ' 条已经超了。' : '，都还在预算内。');
+        },
+        caliber: (input) => {
+            const e = input.budget;
+            if (e === null || e.budgets.length === 0)
+                return '还没有预算';
+            return String(e.budgets.length) + ' 条预算 ／ '
+                + (e.totals.over_count > 0 ? String(e.totals.over_count) + ' 条超支' : '都在预算内');
+        },
+        kpi: (input) => budgetKpi(input),
+        cardsTitle: '各条预算执行',
+        cards: (input) => (input.budget?.budgets ?? []).map(budgetCard),
+        bars: (input) => {
+            const items = input.budget?.budgets ?? [];
+            const total = items.reduce((s, b) => s + Math.abs(b.amount), 0);
+            const rows = items.length === 0 || total === 0 ? []
+                : items.map((b) => ({ label: b.category_cn, value: money(b.amount) + ' 元', pct: Math.abs(b.amount) / total * 100 }));
+            return { title: '各条预算占了多少', rows };
+        },
+        counts: (input) => ({ items: input.budget?.budgets.length ?? 0, records: input.budget?.records ?? 0 }),
+        empty: (input) => ({
+            icon: '🎯',
+            text: monthOf(input.params) + ' 还没有设置预算',
+            next: '说「' + WRITE_WORD + '」就能开始',
+        }),
+        caliberLines: '预算按当月算，不跨月累计：填了分类就看这一类的支出，没填分类就看当月全部支出。'
+            + '进度是「已经用掉的钱 ÷ 预算」，超过 100% 就是已经超支，条与百分数都按 0–100% 夹住画。'
+            + '月底预测按这个月已经过去的几天外推，说的是照现在的花法继续下去会怎样。',
+        source: '预算表与账本（只读：算预算执行）',
+        sourceText: '预算表与账本（只读）',
+        logDetail: (input) => '查到 ' + String(input.budget?.budgets.length ?? 0) + ' 条预算',
+    }),
+};
+/** 读数行四格（老侧 `budget_view.html:193-196` 同数同序；超支项为 0 出「✓ 无」）。 */
+function budgetKpi(input) {
+    const t = input.budget?.totals ?? { budget: 0, actual: 0, remaining: 0, over_count: 0 };
+    const used = t.budget > 0 ? clampPct(t.actual / t.budget * 100) : 0;
+    return [
+        {
+            label: '预算总额', value: money(t.budget), unit: '元',
+            detail: t.budget > 0 ? '已经用掉 ' + pctText(used) : '这个月还没有预算',
+            ...(t.budget > 0 ? { bar: { pct: used } } : {}),
+        },
+        { label: '实际支出', value: money(t.actual), unit: '元', detail: '当月所有支出都在内' },
+        {
+            label: '剩余', value: money(t.remaining), unit: '元',
+            detail: t.remaining < 0 ? '已经超了 ' + money(Math.abs(t.remaining)) + ' 元' : '还能再用这么多',
+            status: t.remaining < 0 ? 'danger' : 'ok',
+            statusText: t.remaining < 0 ? '超支' : '在预算内',
+        },
+        {
+            label: '超支项', value: t.over_count > 0 ? String(t.over_count) : '✓ 无',
+            ...(t.over_count > 0 ? { unit: '条' } : {}),
+            detail: t.over_count > 0 ? '这几条要收着点花' : '没有超支的预算',
+            status: t.over_count > 0 ? 'danger' : 'ok',
+            statusText: t.over_count > 0 ? '有超支' : '都还好',
+        },
+    ];
+}
+/** 一条预算一张带进度条的读数卡（老侧 `budgetBar` 那一块的信息量）。 */
+function budgetCard(b) {
+    const meta = BUDGET_STATUS_META[b.status];
+    const remain = b.remaining >= 0 ? '剩余 ' + money(b.remaining) + ' 元' : '超出 ' + money(Math.abs(b.remaining)) + ' 元';
+    const projection = monthEndHintOf(b);
+    return {
+        label: b.category_cn,
+        value: money(b.actual),
+        unit: '元',
+        detail: [
+            '预算 ' + money(b.amount) + ' 元',
+            '已用 ' + money(b.actual) + ' 元',
+            String(b.count) + ' 笔',
+            '进度 ' + pctText(b.pct),
+            remain,
+            ...(projection === '' ? [] : [projection]),
+        ].join(' · '),
+        bar: { pct: clampPct(b.pct) },
+        status: meta.kind,
+        statusText: meta.label,
+    };
+}
+//# sourceMappingURL=scene-budget.js.map

package/dist/goal/scene-budget.js.map

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

package/dist/goal/scene-saving.d.ts

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

package/dist/goal/scene-saving.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-saving.d.ts","sourceRoot":"","sources":["../../src/goal/scene-saving.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAqB,aAAa,EAAE,MAAM,YAAY,CAAC;AAQnE,eAAO,MAAM,KAAK,EAAE,aA+CnB,CAAC"}

package/dist/goal/scene-saving.js

@@ -0,0 +1,116 @@
+/** 场景件：**看目标**（`op=saving`）——本件只是差异声明，块位序列住 `./template-progress.ts`。
+ *
+ * 本件的差异（老侧 `templates/目标/saving_view.html`）：
+ *   ① 4 张读数卡同数同序：目标数／已完成／累计已存／目标总额（`:192-195`）；
+ *   ② 每个目标一张带进度条的卡：状态徽章 ＋ 已存/目标 ＋ 进度 ＋ 月均净存 ＋ **预计达成日** ＋ 截止日期
+ *      ＋（有截止日且未达成时）**达标所需月存**（`:206-231`，老侧长板，照抄）；
+ *   ③ 进度百分比**双端夹取**：老侧这一张本来就是双端（`:208` 的 `Math.min(Math.max(s.pct,0),100)`，
+ *      显示那一处 `:225` 也夹了下界）——新侧取它的口径，两张页共用一处（`./pageParts.js` 的 `clampPct`）。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { SAVING_STATUS_META, clampPct, money, pctText } from './pageParts.js';
+import { localDay } from './params.js';
+import { bindGoalProgressPage } from './template-progress.js';
+const WORD = projectWakeWord({ key: 'bill.goal.query', op: 'saving' });
+const WRITE_WORD = projectWakeWord({ key: 'bill.goal.write', op: 'set-saving' });
+const KEY = 'bill.goal.query';
+export const SCENE = {
+    id: 'saving',
+    key: KEY,
+    op: 'saving',
+    family: '进度',
+    ...bindGoalProgressPage({
+        word: WORD,
+        docSuffix: '·目标进度',
+        window: () => '账本已经算到 ' + localDay(),
+        conclusion: (input) => {
+            const p = input.saving;
+            const items = p?.savings ?? [];
+            if (p === null || items.length === 0)
+                return '还没有储蓄目标，先说说想存钱买什么。';
+            const saved = items.reduce((s, i) => s + i.saved, 0);
+            const goal = items.reduce((s, i) => s + i.amount, 0);
+            return '一共 ' + String(items.length) + ' 个目标，累计存下 ' + money(saved) + ' 元，'
+                + '离目标总额 ' + money(goal) + ' 元还差 ' + money(Math.max(goal - saved, 0)) + ' 元'
+                + (p.done_count > 0 ? '；其中 ' + String(p.done_count) + ' 个已经达成。' : '。');
+        },
+        caliber: (input) => {
+            const p = input.saving;
+            if (p === null || p.savings.length === 0)
+                return '还没有目标';
+            return String(p.savings.length) + ' 个目标 ／ 已完成 ' + String(p.done_count) + ' 个';
+        },
+        kpi: (input) => savingKpi(input),
+        cardsTitle: '各个目标的进度',
+        cards: (input) => (input.saving?.savings ?? []).map(savingCard),
+        bars: (input) => {
+            const items = input.saving?.savings ?? [];
+            const total = items.reduce((s, i) => s + Math.max(i.saved, 0), 0);
+            const rows = items.length === 0 || total === 0 ? []
+                : items.map((i) => ({ label: i.name, value: money(i.saved) + ' 元', pct: Math.max(i.saved, 0) / total * 100 }));
+            return { title: '各个目标存了多少', rows };
+        },
+        counts: (input) => ({ items: input.saving?.savings.length ?? 0, records: input.saving?.records ?? 0 }),
+        empty: () => ({
+            icon: '🐷',
+            text: '还没有储蓄目标',
+            next: '说「' + WRITE_WORD + '」就能开始',
+        }),
+        caliberLines: '目标期从设下那个月算起，算到截止日（没写截止日就算到今天）：已存＝这段期间里收入减去支出的累计净额。'
+            + '预计达成日是按目前的月均净存往后推的；月均没往上涨就暂时算不出来。'
+            + '进度按 0–100% 夹住画：超出的部分由「还差多少」那一行说清。',
+        source: '目标表与账本（只读：算目标进度）',
+        sourceText: '目标表与账本（只读）',
+        logDetail: (input) => '查到 ' + String(input.saving?.savings.length ?? 0) + ' 个目标',
+    }),
+};
+/** 读数行四格（老侧 `saving_view.html:192-195` 同数同序）。 */
+function savingKpi(input) {
+    const p = input.saving;
+    const items = p?.savings ?? [];
+    const saved = items.reduce((s, i) => s + i.saved, 0);
+    const goal = items.reduce((s, i) => s + i.amount, 0);
+    const rate = goal > 0 ? clampPct(saved / goal * 100) : 0;
+    return [
+        { label: '目标数', value: String(p?.count ?? 0), unit: '个', detail: '都记在目标表里' },
+        {
+            label: '已完成', value: String(p?.done_count ?? 0), unit: '个',
+            detail: (p?.done_count ?? 0) > 0 ? '已经存够了' : '还没有达成的目标',
+            status: (p?.done_count ?? 0) > 0 ? 'ok' : 'empty',
+            statusText: (p?.done_count ?? 0) > 0 ? '有达成' : '都没达成',
+        },
+        {
+            label: '累计已存', value: money(saved), unit: '元',
+            detail: goal > 0 ? '相当于目标总额的 ' + pctText(rate) : '还没有设立目标金额',
+            ...(goal > 0 ? { bar: { pct: rate } } : {}),
+        },
+        { label: '目标总额', value: money(goal), unit: '元', detail: '所有目标加起来要存这么多' },
+    ];
+}
+/** 一个目标一张带进度条的读数卡（老侧 `savingCard` 那一块的信息量）。 */
+function savingCard(s) {
+    const meta = SAVING_STATUS_META[s.status];
+    const eta = s.status === 'done' ? '目标已达成'
+        : (s.eta === null ? '暂无预计（先存一笔吧）' : '预计 ' + s.eta + ' 达成');
+    const deadline = s.deadline === null || s.deadline === '' ? '无截止日期' : '截止 ' + s.deadline;
+    const needed = s.needed_monthly === null
+        ? [] : ['截止前达标还需每月 ' + money(s.needed_monthly) + ' 元'];
+    return {
+        label: s.name,
+        value: money(s.saved),
+        unit: '元',
+        detail: [
+            '目标 ' + money(s.amount) + ' 元',
+            '进度 ' + pctText(s.pct),
+            s.remaining >= 0 ? '还差 ' + money(s.remaining) + ' 元' : '已超出 ' + money(Math.abs(s.remaining)) + ' 元',
+            '月均净存 ' + money(s.monthly_avg) + ' 元',
+            eta,
+            deadline,
+            ...needed,
+        ].join(' · '),
+        bar: { pct: clampPct(s.pct) },
+        status: meta.kind,
+        statusText: meta.label,
+    };
+}
+//# sourceMappingURL=scene-saving.js.map

package/dist/goal/scene-saving.js.map

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

package/dist/goal/scene-set-budget.d.ts

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

package/dist/goal/scene-set-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-set-budget.d.ts","sourceRoot":"","sources":["../../src/goal/scene-set-budget.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAsC,cAAc,EAAE,MAAM,YAAY,CAAC;AAkBrF,eAAO,MAAM,KAAK,EAAE,cAmEnB,CAAC"}

package/dist/goal/scene-set-budget.js

@@ -0,0 +1,94 @@
+/** 场景件：**设定预算**（`op=set-budget`）——本件只是差异声明，块位序列住 `./template-form.ts`。
+ *
+ * 本件的差异（老侧 `templates/目标/budget_form.html`）：
+ *   ① 三格：金额必填、月份与分类选填（老侧同三格；页内那排 JS 才做的事，新侧全在服务端算完）；
+ *   ② 采集页的「已有条目」那张只读表，兑现的是老侧 `render.py:201-213` 的 `_find_existing_budget`
+ *      ——老侧把它折成一条冲突提示条（`budget_form.html:129-134`），新侧摊成表 ＋ 一条可见的冲突提示；
+ *   ③ 冲突（同月同类已存在）**不再是一句 CLI 报错**（老侧 `cli.py:143-147` 回一句「确认覆盖请加 --force」）：
+ *      它进阻断表，页上可见地告诉用户「要覆盖就把确认覆盖给上」，这一页不写库（#688 裁定 9）。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { MONTH_RE } from '../shared/dateRange.js';
+import { money, promptOf, textOrDash } from './pageParts.js';
+import { GOAL_WRITE_SLOTS, localMonth, textOf } from './params.js';
+import { bindGoalFormPages } from './template-form.js';
+const WORD = projectWakeWord({ key: 'bill.goal.write', op: 'set-budget' });
+const READ_WORD = projectWakeWord({ key: 'bill.goal.query', op: 'budget' });
+const KEY = 'bill.goal.write';
+/** 这一页管的是哪个月：参数给的月份归一得了就用它，归一不了按本月（那一格另有缺项标签点名）。 */
+function monthOf(params) {
+    const raw = textOf(params['month']);
+    return MONTH_RE.test(raw) ? raw : localMonth();
+}
+/** 采集页副标题：缺什么就写清缺几项。 */
+const subtitleOf = (input) => (input.blocked.length === 0 ? '金额填好就可以写进去了。' : '缺 ' + String(input.blocked.length) + ' 项，详见下表。');
+export const SCENE = {
+    id: 'set-budget',
+    key: KEY,
+    op: 'set-budget',
+    family: '设定',
+    ...bindGoalFormPages({
+        word: WORD,
+        caliber: '登记一条月度预算',
+        note: '预算只管当月：分类留空＝全月总预算；填了分类＝这一类的上限（它下面更细的分类也算在内）。',
+        fieldDescription: '金额必填，写正数；月份与分类选填——不填就是本月、不分类。',
+        subtitle: subtitleOf,
+        existing: (input) => {
+            const month = monthOf(input.params);
+            const rows = input.budgets.filter((b) => b.month === month);
+            return {
+                caption: month + ' 已经设过的预算',
+                columns: [
+                    { key: 'category', label: '分类' },
+                    { key: 'amount', label: '金额' },
+                    { key: 'created', label: '记下的时间' },
+                ],
+                rows: rows.map((b) => ({
+                    category: b.category === '' ? '全月总预算' : b.category,
+                    amount: money(b.amount) + ' 元',
+                    created: textOrDash(b.created_at),
+                })),
+                empty: {
+                    text: month + ' 还没有设置预算。',
+                    next: '把金额填在下面，说一遍「' + WORD + '」就行。',
+                },
+            };
+        },
+        prompt: (input) => promptOf(WORD, GOAL_WRITE_SLOTS['set-budget'], input.params),
+        receiptCards: (input) => [
+            { label: '这份预算的金额', value: money(Number(input.params['amount'])), unit: '元', detail: '每月的上限' },
+            {
+                label: '管哪个月',
+                value: textOf(input.params['month']) === '' ? monthOf(input.params) : textOrDash(input.params['month']),
+                detail: '按月算，不跨月累计',
+            },
+            {
+                label: '管到哪一层分类',
+                value: textOf(input.params['category']) === '' ? '全部支出' : textOrDash(input.params['category']),
+                detail: textOf(input.params['category']) === '' ? '没写分类＝全月总预算' : '这一类与它下面更细的分类都算',
+            },
+            { label: '现在一共有几份预算', value: String(input.receipt.budgetCount) + ' 份', detail: '都在预算表里' },
+        ],
+        result: (input) => {
+            const old = input.receipt.overwritten;
+            if (old === null)
+                return null;
+            return {
+                navText: '覆盖',
+                caption: '被这一条替掉的旧预算',
+                rows: [
+                    { k: '月份', v: old.month },
+                    { k: '分类', v: old.category === '' ? '全月总预算' : old.category },
+                    { k: '原来的金额', v: money(old.amount) + ' 元' },
+                ],
+                note: '覆盖＝把原来那条删掉、按新的值重记一条；同一个月份同一层分类只留一条。',
+            };
+        },
+        receiptNote: '预算与实际支出都只算当月：要月度执行情况就看「' + READ_WORD + '」那一页。',
+        detailCaption: '写进去的这份预算',
+        logDetail: (input) => '设定预算 ' + monthOf(input.params) + ' ' + (textOf(input.params['category']) || '全月总预算')
+            + ' ' + money(Number(input.params['amount'])) + ' 元'
+            + (input.receipt.overwritten === null ? '' : '（覆盖了原来那条）'),
+    }),
+};
+//# sourceMappingURL=scene-set-budget.js.map

package/dist/goal/scene-set-budget.js.map

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

package/dist/goal/scene-set-saving.d.ts

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

package/dist/goal/scene-set-saving.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-set-saving.d.ts","sourceRoot":"","sources":["../../src/goal/scene-set-saving.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAsC,cAAc,EAAE,MAAM,YAAY,CAAC;AAYrF,eAAO,MAAM,KAAK,EAAE,cA8CnB,CAAC"}

package/dist/goal/scene-set-saving.js

@@ -0,0 +1,66 @@
+/** 场景件：**设定目标**（`op=set-saving`）——本件只是差异声明，块位序列住 `./template-form.ts`。
+ *
+ * 本件的差异（老侧 `templates/目标/saving_form.html`）：
+ *   ① 三格：目标名与金额必填、截止日期选填（老侧同三格，同一句口径「不填 = 无截止日期」）；
+ *   ② 没有「覆盖冲突」这条路——老侧 `cmd_set_saving` 也不查重（同名再设一次就是两个目标）；
+ *   ③ 采集页的「已有条目」那张只读表是新侧加的（老侧 saving 表单页没有这一块）：
+ *      代价是一张只读小表，换来的是「再设一个之前先看见已经有哪些目标」——老侧同族页里
+ *      `budget_form.html` 有、`saving_form.html` 没有，**同族两套**，新侧取齐全的那一套。
+ */
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { money, promptOf, textOrDash } from './pageParts.js';
+import { GOAL_WRITE_SLOTS, textOf } from './params.js';
+import { bindGoalFormPages } from './template-form.js';
+const WORD = projectWakeWord({ key: 'bill.goal.write', op: 'set-saving' });
+const READ_WORD = projectWakeWord({ key: 'bill.goal.query', op: 'saving' });
+const KEY = 'bill.goal.write';
+/** 采集页副标题：缺什么就写清缺几项。 */
+const subtitleOf = (input) => (input.blocked.length === 0 ? '目标名与金额填好就可以写进去了。' : '缺 ' + String(input.blocked.length) + ' 项，详见下表。');
+export const SCENE = {
+    id: 'set-saving',
+    key: KEY,
+    op: 'set-saving',
+    family: '设定',
+    ...bindGoalFormPages({
+        word: WORD,
+        caliber: '登记一个储蓄目标',
+        note: '目标期从当月开始，算到截止日（没写截止日就算到今天）：已存＝这段期间收入减去支出的累计净额。',
+        fieldDescription: '目标名与金额必填；截止日期选填，不填就没有截止日。',
+        subtitle: subtitleOf,
+        existing: (input) => ({
+            caption: '已经设过的目标',
+            columns: [
+                { key: 'name', label: '目标' },
+                { key: 'amount', label: '金额' },
+                { key: 'deadline', label: '截止日期' },
+            ],
+            rows: input.savings.map((s) => ({
+                name: s.name,
+                amount: money(s.amount) + ' 元',
+                deadline: s.deadline === null || s.deadline === '' ? '不限' : s.deadline,
+            })),
+            empty: {
+                text: '还没有储蓄目标。',
+                next: '把想买的东西与金额填在下面，说一遍「' + WORD + '」就行。',
+            },
+        }),
+        prompt: (input) => promptOf(WORD, GOAL_WRITE_SLOTS['set-saving'], input.params),
+        receiptCards: (input) => [
+            { label: '目标', value: textOrDash(input.params['name']), detail: '刚登记进来的' },
+            { label: '目标金额', value: money(Number(input.params['amount'])), unit: '元', detail: '存够这么多就算达成' },
+            {
+                label: '截止日期',
+                value: textOf(input.params['deadline']) === '' ? '不限' : textOrDash(input.params['deadline']),
+                detail: textOf(input.params['deadline']) === '' ? '没写截止日，什么时候存够都算' : '到这一天之前存够',
+            },
+            { label: '现在一共有几个目标', value: String(input.receipt.savingCount) + ' 个', detail: '都在目标表里' },
+        ],
+        result: () => null,
+        receiptNote: '想看存了多少、还差多少、大概什么时候能达成，就看「' + READ_WORD + '」那一页。',
+        detailCaption: '写进去的这个目标',
+        logDetail: (input) => '设定目标 ' + textOrDash(input.params['name'])
+            + ' ' + money(Number(input.params['amount'])) + ' 元'
+            + (textOf(input.params['deadline']) === '' ? '' : '（截止 ' + textOf(input.params['deadline']) + '）'),
+    }),
+};
+//# sourceMappingURL=scene-set-saving.js.map

package/dist/goal/scene-set-saving.js.map

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

package/dist/goal/scene.d.ts

@@ -0,0 +1,142 @@
+import type { DataTableColumn, DataTableRow, KpiCardInput } from 'base-paint/blocks';
+import type { GoalBlocked, GoalWriteOp, GoalReadOp } from './params.js';
+import type { BudgetExecution, GoalBudgetRow, GoalSavingRow, SavingProgress } from './goalData.js';
+/** 采集页入参：这一页是谁 ＋ 缺什么 ＋ 目标表现状 ＋ 复制日志与脚注的取数。 */
+export interface GoalCollectInput {
+    /** 对外命令名（`bill.goal.write`）。 */
+    readonly key: string;
+    /** 这一页是哪一支操作。 */
+    readonly op: GoalWriteOp;
+    /** 本次参数（复制日志那行命令原文照它拼，可照抄重跑）。 */
+    readonly params: Record<string, unknown>;
+    /** 缺什么／哪一格的值进不去（空数组＝可以写库，本页不该出）。 */
+    readonly blocked: readonly GoalBlocked[];
+    /** 预算表现状（设定预算那一件的「已有条目」只读表读它）。 */
+    readonly budgets: readonly GoalBudgetRow[];
+    /** 目标表现状（设定目标那一件同上）。 */
+    readonly savings: readonly GoalSavingRow[];
+    /** 本次数据来源（复制日志第 3 段）。 */
+    readonly source: string;
+    /** 本次执行时刻（复制日志第 5 段）。 */
+    readonly actionAt: string;
+}
+/** 一次写库的事实（回执页与复制日志都读它）。**形状由本域定**：目标域动的是 `goals.json`
+ *  的 `budgets`／`savings` 两键里的一条，与写入域的「一条记录」、账户域的「账户表 ＋ 账本」都不是同一件事。 */
+export interface GoalReceipt {
+    readonly op: GoalWriteOp;
+    /** 一句人话回执（页副标题、复制日志、出口 message 共用）。 */
+    readonly summary: string;
+    /** 库里改动的处数（目标表那一层**自报**：一条预算或一个目标＝1；见 `./write.js` 的口径注）。 */
+    readonly affectedRows: number;
+    /** 写入时刻（本地时钟，`YYYY-MM-DD HH:MM:SS`）。 */
+    readonly actionAt: string;
+    /** 本次数据来源（复制日志第 3 段）。 */
+    readonly source: string;
+    /** 被覆盖掉的那一条（只可能出现在设定预算那一支；没覆盖＝`null`）。 */
+    readonly overwritten: {
+        readonly month: string;
+        readonly category: string;
+        readonly amount: number;
+    } | null;
+    /** 写完之后预算表里一共几条。 */
+    readonly budgetCount: number;
+    /** 写完之后目标表里一共几个。 */
+    readonly savingCount: number;
+}
+/** 回执页入参：回执事实 ＋ 明细行 ＋ 取数。 */
+export interface GoalReceiptInput {
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    readonly receipt: GoalReceipt;
+    /** 明细表的行（本次写进去的项与值）。 */
+    readonly detail: readonly {
+        readonly k: string;
+        readonly v: string;
+    }[];
+}
+/** 一件写场景件：一条唤醒词的落点（两张页：采集页与回执页）。 */
+export interface GoalWriteScene {
+    /** 件的名字（与文件名 `scene-<id>.ts` 对得上）。 */
+    readonly id: string;
+    readonly key: 'bill.goal.write';
+    readonly op: GoalWriteOp;
+    /** 待哪一族窗口来填这一件的页（目标域的一族：设定）。 */
+    readonly family: string;
+    /** 这一件的过程型采集页（缺项那一支）。 */
+    readonly collect: (input: GoalCollectInput) => string;
+    /** 这一件的结果型回执页（写库成功那一支）。 */
+    readonly receipt: (input: GoalReceiptInput) => string;
+}
+/** 进度视图入参：这一页看的是哪一段 ＋ 那一支的事实 ＋ 取数。两支里恰好一支非空（由 `./read.js` 给）。 */
+export interface GoalProgressInput {
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    /** 唤醒词（页标题；由域声明投影算出）。 */
+    readonly wakeWord: string;
+    /** 预算执行那一支的事实（`op=budget` 时给）。 */
+    readonly budget: BudgetExecution | null;
+    /** 目标进度那一支的事实（`op=saving` 时给）。 */
+    readonly saving: SavingProgress | null;
+    /** 出口载荷（与页面同一份事实；复制区直接序列化它）。 */
+    readonly data: GoalProgressData;
+    /** 来源脚注的窗口起止（一条记录都没有时写「不限」）。 */
+    readonly windowStart: string;
+    readonly windowEnd: string;
+    /** 本次执行时刻（复制日志第 5 段）。 */
+    readonly actionAt: string;
+}
+/** 出口载荷：`items` 是 `list` 形必填的那一格，其余是本域给页面与下游看的窗口事实。
+ *  写成 `type` 而不是 `interface`：`ViewOut['data']` 收 `Record<string, unknown>`，别名形态自带隐式索引签名。 */
+export type GoalProgressData = {
+    readonly items: unknown[];
+    readonly total: number;
+    readonly op: GoalReadOp;
+    readonly [k: string]: unknown;
+};
+/** 一件读场景件：一条读操作出一张整页（进度视图页型的一支）。 */
+export interface GoalReadScene {
+    readonly id: string;
+    readonly key: 'bill.goal.query';
+    readonly op: GoalReadOp;
+    /** 待哪一族窗口来填这一件的页（目标域的一族：进度）。 */
+    readonly family: string;
+    /** 这一件的整页产物。 */
+    readonly view: (input: GoalProgressInput) => string;
+}
+/** 写命令的两行落点表（**唯一定义地**）：顺序＝域声明里那两条词的书写顺序（设定预算／设定目标）。 */
+export declare const GOAL_WRITE_SCENES: readonly GoalWriteScene[];
+/** 读命令的两行落点表（**唯一定义地**）：顺序＝域声明里那两条词的书写顺序（看预算／看目标）。 */
+export declare const GOAL_READ_SCENES: readonly GoalReadScene[];
+/** 取件：按 `op` 认（写命令两支各一件）。认不得的 op 即抛——**不猜、不兜底**
+ *  （`op` 已在 `./params.js` 拦过一道，走到这里还认不得即是代码缺陷）。 */
+export declare function writeSceneFor(op: GoalWriteOp): GoalWriteScene;
+/** 取件：读命令两支各一件，认不得即抛（同上）。 */
+export declare function readSceneFor(op: GoalReadOp): GoalReadScene;
+/** 已有条目只读表（采集页）的取值面：普通数据（列／行／标题／空态两句），块位拼装仍归模板件。 */
+export interface GoalExistingTable {
+    readonly caption: string;
+    readonly columns: readonly DataTableColumn[];
+    readonly rows: readonly DataTableRow[];
+    readonly empty: {
+        readonly text: string;
+        readonly next: string;
+    };
+}
+/** 回执页结果块（覆盖了哪一条；没覆盖就不出这一块）：普通数据。 */
+export interface GoalReceiptResult {
+    readonly navText: string;
+    readonly caption: string;
+    readonly rows: readonly {
+        readonly k: string;
+        readonly v: string;
+    }[];
+    readonly note: string;
+}
+/** 读数卡与结果块共用的「一行键值」（明细表、结果表都用它）。 */
+export type GoalRows = readonly {
+    readonly k: string;
+    readonly v: string;
+}[];
+/** 场景件给模板件的读数卡列表（模板件只管把它交给 `renderKpiGrid`）。 */
+export type GoalCards = readonly KpiCardInput[];
+//# sourceMappingURL=scene.d.ts.map