skill-bill 0.1.0 → 0.2.1

package/dist/goal/goalData.js

@@ -0,0 +1,228 @@
+/** 目标域·目标表与进度取数（**唯一定义地**）：`goals.json` 的 `budgets`／`savings` 两键的读与写、
+ *  预算执行（计划值 vs 当月实际支出）、储蓄目标进度（目标期内的净存）。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/goal/write.ts`——写命令处理体：查同月同类预算、落预算表／目标表（覆盖时删旧加新）；
+ *   ② `src/goal/read.ts`——读命令处理体：取 `budgetExecution`／`savingProgress` 当页与出口载荷的唯一事实。
+ *
+ * 老侧对应件：`scripts/goal/cli.py`（`load_goals`／`save_goals`／`cmd_set_budget`／`cmd_budget`／
+ *  `cmd_set_saving`／`cmd_saving`／`_month_expense`／`_month_projection`／`_saving_progress`）。
+ *  口径逐条照搬老侧（**默认真相**），只把「住哪」摆正：
+ *   - **目标表载体**＝`goals.json` 顶层 `budgets`／`savings` 两键（与账户域的 `accounts` 键隔离，
+ *     原子写保留其他键）——写盘那一层住 `../fetch/db.js` 的 `loadGoals`／`saveGoals`，本件不另开一路；
+ *   - **预算实际支出**＝当月 `bills` 里的负数记录，分类预算按 **L1 前缀匹配**
+ *     （`category === c || category.startsWith(c + '/')`，老侧 `cli.py:117-120` 同形），
+ *     「笔数」只数这些负数记录（收入不进）；
+ *   - **预算状态三档**：已用 ≤ 预算的 90% ＝预算内／≤ 预算 ＝接近上限／超出 ＝已超支（老侧 `cli.py:183-188`）；
+ *   - **月底预测三态**：`monthProjection` 按当前节奏外推；过去月＝预测即实际、未来月＝无预测
+ *     （老侧 `cli.py:90-109`）；页面侧按 `±0.01` 判「预计超／预计省／预计持平」；
+ *   - **汇总口径**：总预算（`category` 空格的那一条）存在 ⇒ 用它 ＋ 当月全部支出；
+ *     否则 ⇒ 分类预算之和 vs 分类实际之和（避免「总预算 ＋ 分类预算」并存时实际支出重复计数，老侧 `cli.py:201-212`）；
+ *   - **目标期**＝创建当月起 ~ 截止日（无截止日＝今天）；**已存**＝期内所有记录的金额累计（收入正、支出负）；
+ *   - **预计达成日**＝按月均净存外推（已达成＝无、月均 ≤ 0 ＝无法预计，老侧 `cli.py:284-290`）；
+ *   - **达标所需月存**＝有截止日且未达成时，按剩余月份摊（老侧 `cli.py:292-301`）。
+ *
+ * 老侧缺陷**不照抄**（逐条记在 `docs/skills/skill-bill/t730-差异表.md`）：
+ *   - 老侧 `_month_projection` 对**未来月**返回 `(None, None, 0)` 三态齐全，页面侧靠 `if` 反查；
+ *     本件把三态收进一个「有没有预测」的判别式 `month_end_proj !== null`，页面上不再靠假值兜底。
+ */
+import { fetchAll, listRange } from '../fetch/index.js';
+import { monthRange } from '../shared/dateRange.js';
+import { localDay, round2 } from './params.js';
+/** 预算表：把 `goals.budgets` 的原始行归一成本域认识的形状（认不得的键丢掉，缺的给安全缺省）。 */
+export function budgetsOf(goals) {
+    return goals.budgets.map((raw) => ({
+        id: Number(raw['id']) || 0,
+        month: String(raw['month'] ?? ''),
+        category: String(raw['category'] ?? ''),
+        amount: Number(raw['amount']) || 0,
+        created_at: String(raw['created_at'] ?? ''),
+    }));
+}
+/** 目标表：同上。 */
+export function savingsOf(goals) {
+    return goals.savings.map((raw) => ({
+        id: Number(raw['id']) || 0,
+        name: String(raw['name'] ?? ''),
+        amount: Number(raw['amount']) || 0,
+        deadline: raw['deadline'] === null || raw['deadline'] === undefined ? null : String(raw['deadline']),
+        created_at: String(raw['created_at'] ?? ''),
+    }));
+}
+/** 按「同月 ＋ 同类」找那一条预算（空分类＝总预算，也要按空串对；找不到给 `null`，不抛）。 */
+export function findBudget(rows, month, category) {
+    return rows.find((b) => b.month === month && b.category === category) ?? null;
+}
+/** 下一条编号（老侧 `_next_id`：现有最大编号 ＋ 1）。 */
+function nextId(rows) {
+    return rows.reduce((max, r) => Math.max(max, Number(r['id']) || 0), 0) + 1;
+}
+/** 落一条预算（**覆盖＝删旧加新**，老侧 `cli.py:149-153` 逐字同形：新的一条拿新编号）。
+ *  返回写进去的那一行，调用方拿它做回执。 */
+export function appendBudget(goals, input) {
+    const created = {
+        id: nextId(goals.budgets), month: input.month, category: input.category,
+        amount: input.amount, created_at: input.createdAt,
+    };
+    goals.budgets = goals.budgets.filter((b) => !(String(b['month'] ?? '') === input.month && String(b['category'] ?? '') === input.category));
+    goals.budgets.push({ ...created });
+    return created;
+}
+/** 落一个储蓄目标（老侧 `cmd_set_saving` 只追加，不查重）。 */
+export function appendSaving(goals, input) {
+    const created = {
+        id: nextId(goals.savings), name: input.name, amount: input.amount,
+        deadline: input.deadline, created_at: input.createdAt,
+    };
+    goals.savings.push({ ...created });
+    return created;
+}
+/** 当月支出与笔数（老侧 `_month_expense`）：分类给了就按 L1 前缀收窄，只数负数记录。 */
+export function monthExpense(db, month, category = '') {
+    const { start, end } = monthRange(month);
+    const rows = listRange(db, start, end);
+    const mine = category === '' ? rows
+        : rows.filter((r) => r.category === category || r.category.startsWith(category + '/'));
+    const expenses = mine.filter((r) => r.amount < 0);
+    return { total: round2(expenses.reduce((s, r) => s + Math.abs(r.amount), 0)), count: expenses.length };
+}
+/** 月底预测（老侧 `_month_projection`）：过去月＝预测即实际、未来月＝无预测、当月＝按已过天数外推。 */
+export function monthProjection(month, actual, now = new Date()) {
+    const [y, m] = month.split('-').map(Number);
+    const monthDays = new Date(y, m, 0).getDate();
+    const today = localDay(now).split('-').map(Number);
+    const here = today[0] * 12 + today[1];
+    if (y * 12 + m < here)
+        return { daily_avg: round2(actual / monthDays), month_end_proj: actual, days_elapsed: monthDays };
+    if (y * 12 + m > here)
+        return { daily_avg: null, month_end_proj: null, days_elapsed: 0 };
+    const daysElapsed = Math.min(today[2], monthDays);
+    if (daysElapsed <= 0)
+        return { daily_avg: null, month_end_proj: null, days_elapsed: 0 };
+    const daily = round2(actual / daysElapsed);
+    return { daily_avg: daily, month_end_proj: round2(daily * monthDays), days_elapsed: daysElapsed };
+}
+/** 单条预算的状态档（老侧 `cli.py:183-188`：90% 与 100% 两道线）。 */
+function budgetStatusOf(actual, amount) {
+    if (actual <= amount * 0.9)
+        return 'ok';
+    if (actual <= amount)
+        return 'warn';
+    return 'over';
+}
+/** 预算执行（老侧 `cmd_budget` 整支）：当月预算逐条算执行 ＋ 合计。 */
+export function budgetExecution(db, goals, month, categoryFilter = '', now = new Date()) {
+    let rows = budgetsOf(goals).filter((b) => b.month === month);
+    if (categoryFilter !== '') {
+        rows = rows.filter((b) => b.category === categoryFilter || b.category.startsWith(categoryFilter + '/'));
+    }
+    const { start, end } = monthRange(month);
+    const records = listRange(db, start, end);
+    const items = rows.map((b) => {
+        const mine = b.category === ''
+            ? records.filter((r) => r.amount < 0)
+            : records.filter((r) => r.amount < 0 && (r.category === b.category || r.category.startsWith(b.category + '/')));
+        const actual = round2(mine.reduce((s, r) => s + Math.abs(r.amount), 0));
+        const projection = monthProjection(month, actual, now);
+        return {
+            id: b.id, month, category: b.category, category_cn: b.category === '' ? '总预算' : b.category,
+            amount: b.amount, actual, count: mine.length,
+            remaining: round2(b.amount - actual),
+            pct: b.amount > 0 ? Math.round(actual / b.amount * 1000) / 10 : 0,
+            status: budgetStatusOf(actual, b.amount),
+            daily_avg: projection.daily_avg, month_end_proj: projection.month_end_proj, days_elapsed: projection.days_elapsed,
+        };
+    });
+    items.sort((a, b) => (a.category === '' ? 0 : 1) - (b.category === '' ? 0 : 1) || a.category.localeCompare(b.category));
+    const over_count = items.filter((i) => i.status === 'over').length;
+    const master = items.find((i) => i.category === '');
+    const totals = master === undefined
+        ? {
+            budget: round2(items.reduce((s, i) => s + i.amount, 0)),
+            actual: round2(items.reduce((s, i) => s + i.actual, 0)),
+            remaining: round2(items.reduce((s, i) => s + i.remaining, 0)),
+            over_count,
+        }
+        : { budget: master.amount, actual: master.actual, remaining: master.remaining, over_count };
+    return { month, budgets: items, totals, count: items.length, records: records.length };
+}
+/** 目标期内的净存（老侧 `_saving_progress` 的那一次取数）：期内每一条记录的金额原样相加。 */
+function netSavedIn(db, fromTime, toTime) {
+    const rows = fetchAll(db, { fromTime, toTime });
+    return { saved: round2(rows.reduce((s, r) => s + r.amount, 0)), records: rows.length };
+}
+/** 从起始月首日到当刻的月数（含首月与当月，不足整月按 1 计；老侧 `_months_elapsed`）。 */
+function monthsElapsed(startMonth, now) {
+    const [y, m] = startMonth.split('-').map(Number);
+    const today = localDay(now).split('-').map(Number);
+    return (today[0] - y) * 12 + (today[1] - m) + 1;
+}
+/** 单个目标的进度（老侧 `_saving_progress` 整支）。 */
+function savingItemOf(db, row, now) {
+    const amount = row.amount;
+    const today = localDay(now);
+    const createdMonth = row.created_at.slice(0, 7);
+    const startMonth = /^\d{4}-(0[1-9]|1[0-2])$/.test(createdMonth) ? createdMonth : today.slice(0, 7);
+    const deadlineDay = row.deadline !== null && /^\d{4}-\d{2}-\d{2}$/.test(row.deadline) ? row.deadline : null;
+    const endDay = deadlineDay !== null && deadlineDay < today ? deadlineDay : today;
+    const { start } = monthRange(startMonth);
+    const { saved, records } = netSavedIn(db, start + ' 00:00:00', endDay + ' 23:59:59');
+    const remaining = round2(amount - saved);
+    const elapsed = monthsElapsed(startMonth, now);
+    const monthlyAvg = elapsed > 0 ? round2(saved / elapsed) : 0;
+    const eta = saved < amount && monthlyAvg > 0 ? etaOf(today, Math.ceil(remaining / monthlyAvg)) : null;
+    const needed = deadlineDay !== null && saved < amount && deadlineDay >= today
+        ? round2(Math.max(remaining, 0) / monthsLeft(today, deadlineDay)) : null;
+    const status = savingStatusOf(amount, saved, monthlyAvg, eta, deadlineDay);
+    return {
+        item: {
+            id: row.id, name: row.name === '' ? '未命名目标' : row.name, amount, deadline: row.deadline,
+            created_at: row.created_at, start_month: startMonth, saved, remaining,
+            pct: amount > 0 ? Math.round(Math.max(saved, 0) / amount * 1000) / 10 : 0,
+            monthly_avg: monthlyAvg, eta, status, needed_monthly: needed,
+        },
+        records,
+    };
+}
+/** 预计达成月：今天往后推 `monthsNeeded` 个月（老侧 `cli.py:288-290` 的整数月算法）。 */
+function etaOf(today, monthsNeeded) {
+    if (!Number.isFinite(monthsNeeded) || monthsNeeded < 0)
+        return null;
+    const [y, m] = today.split('-').map(Number);
+    const total = y * 12 + (m - 1) + monthsNeeded;
+    return String(Math.floor(total / 12)).padStart(4, '0') + '-' + String(total % 12 + 1).padStart(2, '0');
+}
+/** 从今天到截止日还剩几个月（不足一个月按 1 计，老侧 `cli.py:300` 的 `max(…, 1)`）。 */
+function monthsLeft(today, deadline) {
+    const a = today.split('-').map(Number);
+    const b = deadline.split('-').map(Number);
+    return Math.max((b[0] - a[0]) * 12 + (b[1] - a[1]), 1);
+}
+/** 目标状态四档（老侧 `cli.py:303-310`：达成／无从预计／要落后／按计划）。 */
+function savingStatusOf(amount, saved, monthlyAvg, eta, deadline) {
+    if (saved >= amount)
+        return 'done';
+    if (monthlyAvg <= 0)
+        return 'na';
+    if (eta !== null && deadline !== null && eta > deadline.slice(0, 7))
+        return 'behind';
+    return 'on_track';
+}
+/** 目标进度（老侧 `cmd_saving` 整支）：按名字子串收窄，逐条算进度，顺序＝目标表登记序。 */
+export function savingProgress(db, goals, nameFilter = '', now = new Date()) {
+    const rows = savingsOf(goals)
+        .filter((s) => nameFilter === '' || s.name.includes(nameFilter))
+        .sort((a, b) => a.id - b.id);
+    const items = [];
+    let records = 0;
+    for (const row of rows) {
+        const one = savingItemOf(db, row, now);
+        items.push(one.item);
+        records += one.records;
+    }
+    return {
+        savings: items, count: items.length,
+        done_count: items.filter((i) => i.status === 'done').length, records,
+    };
+}
+//# sourceMappingURL=goalData.js.map

package/dist/goal/goalData.js.map

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

package/dist/goal/index.d.ts

@@ -0,0 +1,19 @@
+/** 目标域对外的门：**命令声明**（权威源在 `./commands.ts`，这里只是转出）。
+ *
+ * **本域是第一个「读写两类命令同域」的样本**（#730 判据 6 要的结论就写在这里）：
+ *  一个域里同时放写入口与读入口**不需要第二个入口函数**——两条命令的差别只有 `kind`／`shape` 两格，
+ *  而**命令声明里的 `run` 就是唯一入口**：出口分派改成按注册表直接调 `spec.run` 之后
+ *  （`src/cli/cmd_read.ts` 的 `runRegistered`，账户域那一窗改的），域门只转出「命令声明」这一件就够。
+ *  对照兄弟域的两处口径注释：`src/account/index.ts` 记的是「本域纯写、也不再有第二个入口」，
+ *  `src/query/index.ts` 记的是「本域纯读、`runQueryRead` 那个入口是给按域写死的分派用的」；
+ *  纯写／纯读两域各自的入口函数**是为那一窗的分派形状服务的**，本域（读写同域）没有那个形状可服务，
+ *  故一件不留。**形状事实**（哪条写、哪条读、各自什么 envelope 形状）只住 `./commands.ts` 一处。
+ *
+ * 域内其他件（处理体 `write.ts`／`read.ts`、目标表与进度取数 `goalData.ts`、两片页型模板件、
+ *  四件场景件、参数与槽位表 `params.ts`、页内共件 `pageParts.ts`）**不出这个目录**，故不在这里转出；
+ *  两张场景落点表（`./scene.js` 的 `GOAL_WRITE_SCENES`／`GOAL_READ_SCENES`）供测试按既有取法直取定义地。
+ *
+ * 形状照 `../account/index.ts` 与 `../write/index.ts`（同一包内四域同形）：门只收「命令声明」这一件。
+ */
+export { GOAL_COMMANDS } from './commands.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/goal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/goal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/goal/index.js

@@ -0,0 +1,19 @@
+/** 目标域对外的门：**命令声明**（权威源在 `./commands.ts`，这里只是转出）。
+ *
+ * **本域是第一个「读写两类命令同域」的样本**（#730 判据 6 要的结论就写在这里）：
+ *  一个域里同时放写入口与读入口**不需要第二个入口函数**——两条命令的差别只有 `kind`／`shape` 两格，
+ *  而**命令声明里的 `run` 就是唯一入口**：出口分派改成按注册表直接调 `spec.run` 之后
+ *  （`src/cli/cmd_read.ts` 的 `runRegistered`，账户域那一窗改的），域门只转出「命令声明」这一件就够。
+ *  对照兄弟域的两处口径注释：`src/account/index.ts` 记的是「本域纯写、也不再有第二个入口」，
+ *  `src/query/index.ts` 记的是「本域纯读、`runQueryRead` 那个入口是给按域写死的分派用的」；
+ *  纯写／纯读两域各自的入口函数**是为那一窗的分派形状服务的**，本域（读写同域）没有那个形状可服务，
+ *  故一件不留。**形状事实**（哪条写、哪条读、各自什么 envelope 形状）只住 `./commands.ts` 一处。
+ *
+ * 域内其他件（处理体 `write.ts`／`read.ts`、目标表与进度取数 `goalData.ts`、两片页型模板件、
+ *  四件场景件、参数与槽位表 `params.ts`、页内共件 `pageParts.ts`）**不出这个目录**，故不在这里转出；
+ *  两张场景落点表（`./scene.js` 的 `GOAL_WRITE_SCENES`／`GOAL_READ_SCENES`）供测试按既有取法直取定义地。
+ *
+ * 形状照 `../account/index.ts` 与 `../write/index.ts`（同一包内四域同形）：门只收「命令声明」这一件。
+ */
+export { GOAL_COMMANDS } from './commands.js';
+//# sourceMappingURL=index.js.map

package/dist/goal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/goal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/goal/pageParts.d.ts

@@ -0,0 +1,140 @@
+import type { SerializableEnvelope, StatusKind } from 'base-paint';
+import type { DataTableColumn, DataTableRow, KpiCardInput, ParamFieldInput } from 'base-paint/blocks';
+import type { PageShellInput } from '../shared/pageShell.js';
+import type { GoalBudgetStatus, GoalSavingStatus } from './goalData.js';
+/** 目标域各页的眉标：**只在本域写一次**（共用位不持「域名→取值」表）。 */
+export declare const EYEBROW = "\u8BB0\u8D26\uFF5C\u76EE\u6807\u57DF";
+/** 本域各页统一走它：补上眉标再转共用位的 `pageShell`；调用点写法 `pageShell({…})` 不变。 */
+export declare function goalPageShell(input: Omit<PageShellInput, 'eyebrow'>): string;
+/** 写命令两页的页面内置 envelope（采集页 `ok:false`、回执页 `ok:true`；两页同一形状 `receipt`）。 */
+export declare function envelopeOf(key: string, ok: boolean, message: string): SerializableEnvelope;
+/** 读命令那一页的 envelope（形状 `list`，`items` 必有、`total` 可选；判据不许宽过公共层）。 */
+export declare function listEnvelopeOf(key: string, data: {
+    readonly items: unknown[];
+    readonly total?: number;
+}): SerializableEnvelope;
+/** 缺值占位（裁定 4）。 */
+export declare const MISSING = "\u2014";
+/** 金额文本：两位小数。数字照实写（含 0）；不是有限数就写缺值占位。 */
+export declare function money(n: number | null | undefined): string;
+/** 进度百分比的双端夹取（**唯一定义地**，见件头口径）：条长与上屏的百分数同取一份。 */
+export declare function clampPct(n: number | null | undefined): number;
+/** 百分比文本：一位小数（老侧 `fmtPct` 同口径），值已双端夹取。 */
+export declare function pctText(n: number | null | undefined): string;
+/** 月底预测那一句（**唯一定义地**；#688 §二 C13 的三态）。
+ *
+ *  三态判据与阈值逐字照老侧 `目标/budget_view.html:214-219`：`diff > 0.01` 预计超、
+ *  `diff < -0.01` 预计省、其间预计持平。**空预测＝空串**（`month_end_proj` 为 `null` 是「这一月没有预测可给」，
+ *  老侧那一支同样是空串——它靠 `b.month_end_proj != null && b.days_elapsed` 两个假值反查，新侧只判一处）。 */
+export declare function monthEndHintOf(item: {
+    readonly month_end_proj: number | null;
+    readonly daily_avg: number | null;
+    readonly amount: number;
+}): string;
+/** 一个值写成上屏文本：空白串与缺值一律 `—`（不写 `undefined`、不留空）。 */
+export declare function textOrDash(v: unknown): string;
+/** 预算状态的说法（老侧 `budget_view.html:101-105` 的 `STATUS_META` 逐字）。 */
+export declare const BUDGET_STATUS_META: Readonly<Record<GoalBudgetStatus, {
+    readonly kind: StatusKind;
+    readonly label: string;
+}>>;
+/** 目标状态的说法（老侧 `saving_view.html:99-104` 的 `STATUS_META` 逐字；档位照老侧 `:220` 的映射）。 */
+export declare const SAVING_STATUS_META: Readonly<Record<GoalSavingStatus, {
+    readonly kind: StatusKind;
+    readonly label: string;
+}>>;
+/** 类型徽章那一串（唤醒词 ＋ 口径 ＋ 状态徽章 ＋ 下一步动作）：四枚形状各自独立，不拼分隔符串。
+ *  形状照写入域 `../write/typeBadge.js` 与账户域 `../account/pageParts.js` 的同一套，本件只喂目标自己的取值。 */
+export declare function badgeOf(input: {
+    readonly word: string;
+    /** 第二枚胶囊那句话（本域页面的口径；空串＝只出唤醒词那一枚）。 */
+    readonly caliber: string;
+    readonly status: StatusKind;
+    readonly statusText: string;
+    /** 下一步动作（整句；空串＝不出）。按句号分行，一句一行口径。 */
+    readonly next: string;
+}): string;
+/** 字段卡的一格（普通数据：参数名／中文名／怎么给／是否必需）。 */
+export interface GoalField {
+    readonly name: string;
+    readonly label: string;
+    readonly hint: string;
+    readonly required: boolean;
+}
+/** 字段卡的格子：一律由 `renderParamForm` 出（标签与控件配对、每格带 `name`）。
+ *  值一律取本次参数——老侧表单页也是把 AI 解析出的字段透传回来回显（`render.py:126-127` 那一类）。 */
+export declare function slotFieldsOf(params: Record<string, unknown>, fields: readonly GoalField[]): ParamFieldInput[];
+/** 缺项阻断条：**收进折叠区**（点开才看得见），里面是「还缺什么」表 ＋ 只读的口令原文 ＋ 一句口径。
+ *  铁口径（照 #688 裁定 9）：缺项时**不出**可复制的写库指令——页面上那条口令只给看不给复制。 */
+export declare function blockedFoldOf(input: {
+    readonly blocked: readonly {
+        readonly name: string;
+        readonly label: string;
+        readonly why: string;
+    }[];
+    /** 补齐后照抄的那条命令原文（缺的值留成尖括号占位符；「确认覆盖」那一格写 `true`）。 */
+    readonly command: string;
+}): string;
+/** 复制指令块（过程型页的「照这句跟助手说一遍」）：走公共层 `renderPreBlock` 的自带复制按钮。 */
+export declare function promptBlockOf(prompt: string, label?: string): string;
+/** 复制区（数据位 ＋ 日志位；三格式与双按钮由共用件给）。 */
+export declare function copyZoneOf(input: {
+    readonly envelope: SerializableEnvelope;
+    readonly title: string;
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    readonly source: string;
+    readonly detail: string;
+    readonly actionAt: string;
+}): string;
+/** 空态（含「接下来怎么办」那一句）：预算表为空、目标表为空、当月无记录几处共用。 */
+export declare function emptyOf(input: {
+    readonly title?: string;
+    readonly text: string;
+    readonly next: string;
+}): string;
+/** 来源脚注（结果型页恒出，照 #688 §五 5.2 第 26 行）：三样值由调用方给。 */
+export declare function sourceNoteOf(input: {
+    readonly sourceText: string;
+    readonly start: string;
+    readonly end: string;
+    readonly count: number;
+}): string;
+/** 缺项时那条口令原文：缺的值留成尖括号占位符，**只给看不给复制**。
+ *  两处与账户域不同：①「确认覆盖」那一格映射成 `true`（它不是用户填的槽位，是「覆盖掉那一条」这个意图）；
+ *  ②其余格按参数名映射。 */
+export declare function blockedCommandOf(key: string, params: Record<string, unknown>, blocked: readonly {
+    readonly name: string;
+    readonly label: string;
+}[]): string;
+/** 回执页的状态卡：新设／覆盖了旧的 ＋ 一句写入去向的说明。 */
+export declare function receiptStatusCard(overwritten: boolean): KpiCardInput;
+/** 一格的状态值：值 ＋ 一句说明。 */
+export declare function statusCard(value: string, detail: string): KpiCardInput;
+/** 页尾「对账信息」折叠区：本次写入的**可核对信息**（改了几处／什么时候写的／怎么核对）。 */
+export declare function reconcileOf(input: {
+    readonly actionAt: string;
+    readonly changed: number;
+    readonly note: string;
+}): string;
+/** 采集页／回执页明细表的列（**这一族页型唯一定义地**：表头文本与每格 `data-label` 同源）。 */
+export declare const DETAIL_COLUMNS: readonly DataTableColumn[];
+/** 明细表的行：普通数据，按面量接口给（`renderDataTable` 收 `Record<string, unknown>`）。 */
+export declare function detailRows(rows: readonly {
+    readonly k: string;
+    readonly v: string;
+}[]): readonly DataTableRow[];
+/** 复制日志第 3 段的三句来源：给机器看的那句可带载体名，上屏（来源脚注）的那句只写人话
+ *  （照 #688 裁定 1：库文件名、命令名与脚本路径一律不上屏）。 */
+export declare const SOURCE_COLLECT = "\u76EE\u6807\u8868\uFF08\u53EA\u8BFB\uFF1A\u8FD9\u4E00\u9875\u5148\u4E0D\u5199\u5E93\uFF0C\u53EA\u91C7\u96C6\uFF09";
+export declare const SOURCE_WRITE = "\u76EE\u6807\u8868\uFF08\u5199\u5E93\u56DE\u6267\uFF09";
+export declare const SOURCE_COLLECT_TEXT = "\u76EE\u6807\u8868\uFF08\u53EA\u8BFB\uFF09";
+export declare const SOURCE_WRITE_TEXT = "\u76EE\u6807\u8868\uFF08\u5199\u5165\uFF09";
+/** 采集页／回执页复制口令那一段（「照这句跟助手说一遍」）：说清是哪条词、每一格填什么。
+ *  空着的格写 `____`（必填）或 `____（选填）`，与老侧复制文本的占位写法同义（老侧写 `__如:3000__`）。 */
+export declare function promptOf(word: string, slots: readonly {
+    readonly name: string;
+    readonly label: string;
+    readonly required: boolean;
+}[], params: Record<string, unknown>): string;
+//# sourceMappingURL=pageParts.d.ts.map

package/dist/goal/pageParts.d.ts.map

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