skill-bill 0.1.0 → 0.2.1

package/dist/shared/pageSections.d.ts

@@ -0,0 +1,23 @@
+/** 一个区块的导航面：锚点 id 与它在页内导航里的条目文本（两字段必须同给）。 */
+export interface PageBlockNav {
+    readonly anchor: string;
+    readonly navText: string;
+}
+/** 一个页内区块：**已渲染好的** HTML（受信：全部来自公共层区块件）＋ 可选导航面 ＋ 可选段标题。 */
+export interface PageBlock {
+    readonly html: string;
+    /** 给了即包 `<section id>` 并进页内导航；不给＝原样透传、不进导航。 */
+    readonly nav?: PageBlockNav;
+    /** 可见段标题（不给＝只出锚点、不出标题）。 */
+    readonly heading?: string;
+}
+/** 一个**带导航面**的区块，一行写完一块：`navBlock(html, 'sec-kpi', '读数')`。
+ *  与 `{ html, nav: { anchor, navText } }` 是同一件事的两种写法——写入域五张模板每张要拼五六块
+ *  （块清单一行一块最读得清）；查询域两张页的块各带着段标题，仍写对象字面量。 */
+export declare function navBlock(html: string, anchor: string, navText: string): PageBlock;
+/** 逐块拼正文：`<section>` 包装 ＋ 段标题。块序由调用方给的那份清单**唯一定义**。 */
+export declare function pageBody(blocks: readonly PageBlock[]): string;
+/** 页内导航：条目**从同一份块清单派生**（有导航面的才进）。
+ *  一块都没有 → 公共层返回空串（「没内容不留空块」），本件不自己造第二套判据。 */
+export declare function pageNav(blocks: readonly PageBlock[]): string;
+//# sourceMappingURL=pageSections.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageSections.d.ts","sourceRoot":"","sources":["../../src/shared/pageSections.ts"],"names":[],"mappings":"AA4BA,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AASD;;4CAE4C;AAC5C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAEjF;AAED,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAE7D;AAED;8CAC8C;AAC9C,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAI5D"}

package/dist/shared/pageSections.js

@@ -0,0 +1,52 @@
+/** 页面区块锚点与页内导航（共用位）：**区块锚点包装** ＋ **从同一份块清单派生的页内导航**。
+ *
+ * 谁在用（两个域、七个调用点，指名）：
+ *   ① `src/query/`——列表页（`./list.ts` 的 `queryListDoc`）与详情页（`./detail.ts` 的 `queryDetailDoc`）；
+ *   ② `src/write/`——五张模板（`./template-{expense,flow,batch,installment,update}.ts`）的结果型回执页那一支。
+ *  两域的块清单都**既拼正文也派生导航**，锚点与条目只在本件写一份（裁定 7「一个形状只许一处定义」）。
+ *
+ * 出处：`docs/skills/skill-bill/688-融合基准.md` §四 裁定 2（结果型页恒出页内导航）＋ §五 5.2 第 4 行
+ *  （`●` 结果型 ④⑤⑥⑦、`—` 过程型 ①②③）。可判形式（同条）：每张产物各含**一个**页内导航块（`ilife-block-toc`）。
+ *
+ * **本件是「共用位从第二个用法里长出来」的那一件**：原住 `src/query/pageParts.ts`（查询域先跑通），
+ *  写入域五张回执页要用第二遍，故原样搬到 `src/shared/`；两个类型改名中性（`QueryBlockNav`→`PageBlockNav`、
+ *  `QueryPageBlock`→`PageBlock`），**行为一字不改**——含下面 `sectionOf` 里那枚段标题类名
+ *  `ilife-query-sec-title`：它是搬迁前那一枚字面，改名会动查询域当刻产物，属另一件事。
+ *
+ * **不是新形状**：区块本体全走公共层（`renderTocBlock`，`blocks.ts:254`）；本件只补公共层没有的两件事——
+ *  ① 给区块一个稳定的 `id`（`renderTocBlock` 的锚点由调用方给，它不猜）；② 导航条目**从同一份块清单派生**
+ *  （块序与锚点各写一份就会走散，故不许两处各写）。形状照卡路里同族的 `pageSection`
+ *  （`packages/skill-calorie/src/render/trendPredictDocs.ts:59`）。
+ *
+ * **锚点与条目是同一件事的两面**：它们合成一个必填两字段的 `nav` 对象，故「给了锚点忘了条目」
+ *  这种半截状态在类型上就写不出来（不靠运行期断言）。
+ *
+ * 段标题：`heading` 给了才出 `<h2>`。**不出无意义的标题**——读数区与复制区各自已经有形状承担身份
+ *  （复制区更不许出与按钮同名的标题，裁定 5）。锚点不要求有可见标题，故 `heading` 可缺。
+ */
+import { renderTocBlock } from 'base-paint/blocks';
+/** 一个区块：有导航面即包 `<section id>`（导航条目指得到），否则原样透传。 */
+function sectionOf(block) {
+    if (block.nav === undefined)
+        return block.html;
+    const heading = block.heading === undefined ? '' : '<h2 class="ilife-query-sec-title">' + block.heading + '</h2>';
+    return '<section id="' + block.nav.anchor + '">' + heading + block.html + '</section>';
+}
+/** 一个**带导航面**的区块，一行写完一块：`navBlock(html, 'sec-kpi', '读数')`。
+ *  与 `{ html, nav: { anchor, navText } }` 是同一件事的两种写法——写入域五张模板每张要拼五六块
+ *  （块清单一行一块最读得清）；查询域两张页的块各带着段标题，仍写对象字面量。 */
+export function navBlock(html, anchor, navText) {
+    return { html, nav: { anchor, navText } };
+}
+/** 逐块拼正文：`<section>` 包装 ＋ 段标题。块序由调用方给的那份清单**唯一定义**。 */
+export function pageBody(blocks) {
+    return blocks.map(sectionOf).join('');
+}
+/** 页内导航：条目**从同一份块清单派生**（有导航面的才进）。
+ *  一块都没有 → 公共层返回空串（「没内容不留空块」），本件不自己造第二套判据。 */
+export function pageNav(blocks) {
+    return renderTocBlock({
+        items: blocks.filter((b) => b.nav !== undefined).map((b) => ({ id: b.nav.anchor, text: b.nav.navText })),
+    });
+}
+//# sourceMappingURL=pageSections.js.map

package/dist/shared/pageSections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageSections.js","sourceRoot":"","sources":["../../src/shared/pageSections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiBnD,kDAAkD;AAClD,SAAS,SAAS,CAAC,KAAgB;IACjC,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oCAAoC,GAAG,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAClH,OAAO,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;AACzF,CAAC;AAED;;4CAE4C;AAC5C,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAc,EAAE,OAAe;IACpE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,QAAQ,CAAC,MAA4B;IACnD,OAAO,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;8CAC8C;AAC9C,MAAM,UAAU,OAAO,CAAC,MAA4B;IAClD,OAAO,cAAc,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAG,CAAC,CAAC,GAAoB,CAAC,MAAM,EAAE,IAAI,EAAG,CAAC,CAAC,GAAoB,CAAC,OAAO,EAAE,CAAC,CAAC;KAC7I,CAAC,CAAC;AACL,CAAC"}

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;
+    /** 这一页的眉标（正文标题上方那一行）：**由调用方自己的域报**——共用位不持「域名→取值」表。 */
+    readonly eyebrow: string;
+}
+/** 页面模板与页头：`<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":"AAoBA,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,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAevD"}

package/dist/shared/pageShell.js

@@ -0,0 +1,37 @@
+/** 页面模板与页头（每张页都有的第一件，**唯一定义地**）：`<section>` 段 ＋ 标题三件套 ＋ 整页装配。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/write/`——写入域：过程型采集页（页头 ＋ 九块正文）与结果型回执整页（页头 ＋ 回执块序列）；
+ *   ② `src/query/`——查询域：通用查询列表页（页头 ＋ KPI 行 ＋ 数据表 ＋ 复制区）同走本件，
+ *      眉标由该域自报（`src/query/pageParts.ts` 的 `QUERY_EYEBROW`）。
+ *  本票实测：本包 `src/` 下真引用本件的就是上面两个域，再无第三处。
+ *
+ * 分工（三件不要混）：
+ *   - `./docPage.ts`＝文档装配那一层（`fillTemplate` 包裹、样式资产注入），本件往下调它，不重写；
+ *   - 本件＝页面模板与页头的取值口径（**眉标由调用方的域自报**、标题三件套只出一处；`data-page` 是选页那一枚标记）；
+ *   - 页内块序列（表单／摘要行／复制区…）归各域自己，本件不管；类型徽章另立 `../write/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';
+/** 页面模板与页头：`<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: input.eyebrow,
+        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;AAwB/C,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,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/params.d.ts

@@ -0,0 +1,11 @@
+/** 写命令的操作名（`bill.record.add` 的 add／`bill.record.update` 的三支）。 */
+export type RecordOp = 'add' | 'update' | 'undo' | 'restore';
+/** `id` 槽位守卫：须给正整数（改记录／撤销／恢复／查详情同一句口径，别处不再写第二份）。 */
+export declare function needId(params: Record<string, unknown>): number;
+/** 一个值算不算「给了」：`undefined`／`null`／`false`／空白串都不算。 */
+export declare function isGiven(v: unknown): boolean;
+/** 一个值写成文本（认字符串与有限数；其余形态一律当没给——不猜）。 */
+export declare function textOf(v: unknown): string;
+/** 数字解析：认数字与非空数字串；解析不了给 `null`（不在这里报错，报错归各域的校验处）。 */
+export declare function numberOf(v: unknown): number | null;
+//# sourceMappingURL=params.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/shared/params.ts"],"names":[],"mappings":"AAoBA,iEAAiE;AACjE,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7D,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAM9D;AAaD,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAG3C;AAED,uCAAuC;AACvC,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAGzC;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMlD"}

package/dist/shared/params.js

@@ -0,0 +1,60 @@
+/** 共用位·跨域参数槽位口径（#689 结构搬迁第三批新建）：从 `src/policy/record.ts` 里被**两个域**同时取用的那两件来——
+ *   ① `RecordOp`——写命令 `op` 的取值集（`parseRecordOp` 认的就是它）；形状事实的取值面同时被
+ *      `src/shared/writeParts.ts` 的 `BillReceipt.op` 与 `src/shared/commandSpec.ts` 的写出口取；
+ *   ② `needId`——`id` 槽位的正整数守卫（改记录／撤销／恢复与查账单详情四处同一句校验）。
+ *
+ *  为什么新建这一件、而不是留在某一域里（#689 按「谁在用」判，逐条记在这里）：
+ *   · `needId` 的消费者是**两个域**——写域 `src/write/record.ts`（`validateUpdateInput`）与
+ *     查询域 `src/query/read.ts`（查账单详情）⇒ 归属律 2「说得出两个域在用 ⇒ 共用位」。
+ *     塞进任一域都会让另一个域伸手进对方内部件（或经对方门反向依赖），故上浮共用位。
+ *   · `RecordOp` 的消费者是写域 ＋ **两个共用件**（`writeParts.ts`／`commandSpec.ts`）。
+ *     它若留在 `src/write/record.ts`，共用件就得 import 域目录 —— 撞守卫③a
+ *     （共用位不 import 任何域目录）。故与 `needId` 同住本件；`src/write/record.ts` 转出它，
+ *     写域内部的消费方（`write.ts`）照旧只认自己域那一件。
+ *
+ *  谁在用（指名）：`src/write/record.ts`（两件都取，并转出 `RecordOp`）·
+ *    `src/write/write.ts`（经 `./record.js` 取 `RecordOp`）· `src/query/read.ts`（`needId`）·
+ *    `src/shared/writeParts.ts` 与 `src/shared/commandSpec.ts`（`RecordOp` 作字段类型）。
+ *  形状照兄弟件 `packages/skill-calorie/src/shared/params.ts`：跨域参数口径住共用位，域内不各写一份。 */
+import { BillPolicyError } from '../fetch/errors.js';
+/** `id` 槽位守卫：须给正整数（改记录／撤销／恢复／查详情同一句口径，别处不再写第二份）。 */
+export function needId(params) {
+    const id = params.id;
+    if (!Number.isInteger(id) || id <= 0) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', '须给正整数 id');
+    }
+    return id;
+}
+/* ── 值的三种读法（#731 上浮共用位）────────────────────────────────────────────────────────
+ *
+ * 三件从 `src/account/params.ts` **原样上移**（行为一字不改）：账户域第一处写、开始使用域（#731）
+ * 第二处要用，按「共用件是从第二个用法里长出来的」上浮；`src/account/params.ts` 改为转出这三件，
+ * 域内调用点写法不变。
+ *
+ * **本件不是「全仓唯一一份值读法」**：写入域若干件各有一份**私有**同名函数（`collect.ts`／`diffTable.ts`／
+ * `template-*.ts`／`recentPicks.ts`，其中 `recentPicks.ts` 那份的 `NaN` 归「`NaN` 字面」、
+ * 与下面这份「`NaN` 归空」不同义）——那是搬迁前的既有债务，不属本票写集，就地摆正留给写入域自己的票。
+ */
+/** 一个值算不算「给了」：`undefined`／`null`／`false`／空白串都不算。 */
+export function isGiven(v) {
+    if (v === undefined || v === null || v === false)
+        return false;
+    return !(typeof v === 'string' && v.trim() === '');
+}
+/** 一个值写成文本（认字符串与有限数；其余形态一律当没给——不猜）。 */
+export function textOf(v) {
+    if (typeof v === 'string')
+        return v.trim();
+    return typeof v === 'number' && Number.isFinite(v) ? String(v) : '';
+}
+/** 数字解析：认数字与非空数字串；解析不了给 `null`（不在这里报错，报错归各域的校验处）。 */
+export function numberOf(v) {
+    if (v === undefined || v === null || typeof v === 'boolean')
+        return null;
+    const raw = typeof v === 'string' ? v.trim() : v;
+    if (raw === '')
+        return null;
+    const n = typeof raw === 'number' ? raw : Number(raw);
+    return Number.isFinite(n) ? n : null;
+}
+//# sourceMappingURL=params.js.map

package/dist/shared/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/shared/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;+EAiB+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKrD,oDAAoD;AACpD,MAAM,UAAU,MAAM,CAAC,MAA+B;IACpD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACrB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAK,EAAa,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,EAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AAEH,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAC,CAAU;IAChC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,uCAAuC;AACvC,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,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,QAAQ,CAAC,CAAU;IACjC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC"}

package/dist/shared/sourceLine.d.ts

@@ -0,0 +1,19 @@
+/** 来源脚注的三个事实（全部由调用方算好；空串来源＝不写来源那一段）。 */
+export interface SourceLineFacts {
+    /** 人话来源（如「记账库（只读）」）；空串＝这一页不报来源，只印窗口与条数。 */
+    readonly source: string;
+    /** 窗口起点（日期或「不限」）。 */
+    readonly start: string;
+    /** 窗口终点（日期或「不限」）。 */
+    readonly end: string;
+    /** 本窗条数（非负整数）。 */
+    readonly count: number;
+}
+/** 来源脚注：`数据来源 <来源> ｜ <窗口> ｜ 共 N 条`（分隔由版式出，字符不进可见文本）。
+ *
+ *  t728 改法：改前是先 `join(' · ')` 拼成一整串再交给口径行，于是公共层的拆段器认不出它
+ *  （它只认并列分隔符）⇒ 那 32 行 `·` 串原样上屏，正是用户点名的那类「用符号简化 UI」。
+ *  现在改成：本件只说「这是三段并列」，`｜` 交给 `renderCaliberLine` 拆成逐段 `<span>`，
+ *  段间那条细竖线由公共层 CSS 出（与全仓口径行同一条机制、同一处定义）。 */
+export declare function sourceLine(facts: SourceLineFacts): string;
+//# sourceMappingURL=sourceLine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLine.d.ts","sourceRoot":"","sources":["../../src/shared/sourceLine.ts"],"names":[],"mappings":"AAoBA,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAkBD;;;;;4CAK4C;AAC5C,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAOzD"}

package/dist/shared/sourceLine.js

@@ -0,0 +1,52 @@
+/** 来源脚注（技能层共用件）：结果型每张页**恒出**的一句
+ *  「数据来源 · <来源> · 起 → 止 · 共 N 条」。
+ *
+ * 出处：`docs/skills/skill-bill/688-融合基准.md` §四 裁定 2（结果型页恒出三条之一：
+ *  页内导航 ＋ 口径说明行 ＋ 来源脚注）与 §八 A5（**新建共用位件**，落第一张用它的页面票；
+ *  形状照卡路里 `packages/skill-calorie/src/shared/sourceLine.ts:24`）。本件即 §八 A5 那一行。
+ *
+ * 老侧反面**不照抄**（裁定 1）：老页脚把源脚本路径印成字面（`query_view.html:217` 恒印
+ *  `scripts/record_bill.py {type} --json`，`分析/analysis_view.html:254` 恒印 `scripts/analysis/cli.py`），
+ *  既与实际分域路由对不上（缺陷 D6／D16），对用户也无意义——所以来源那一段写**人话**，
+ *  由调用方给（本件不认库名、不认命令名，不把内部标识符带上屏）。
+ *
+ * 版面：走公共层 #420 的口径说明行 `renderCaliberLine`（`ilife-block-caliber`，12px `--fg2`）；
+ *  本件不写色、不写字号、不写断点——版面单源住 `packages/base-render/`（裁定 7）。
+ *
+ * 分工：本件是**纯排版**，不做校验、不查库、不算窗口。三分不符即算不清：条数由取数处给、
+ *  窗口由参数解析处给、来源那句话由调用方按域给（照本包 `shared/` 既有件的分工：装配件不校验）。
+ */
+import { renderCaliberLine } from 'base-paint/blocks';
+/** 并列段之间那条分隔：**公共层的并列分隔符**（`base-paint` 的 `renderCaliberLine` 认的就是它）。
+ *  本件给的是「这句脚注有几段并列」，怎么把并列画出来由公共层定——页侧一个分隔符字符都不写。 */
+const SEG = '｜';
+/** 窗口那一格：起止同值时只说一次（本域回执记的是**一笔**，不是一段）。
+ *  「不限」那两端（没给窗口）改说人话，不再印 `— → —`（改前空窗口页逐页印这串）。 */
+function windowText(start, end) {
+    const s = start.trim();
+    const e = end.trim();
+    const blank = (v) => v === '' || v === '—' || v === '-';
+    if (blank(s) && blank(e))
+        return '时间不限';
+    if (blank(e))
+        return '从 ' + s + ' 起';
+    if (blank(s))
+        return '到 ' + e + ' 止';
+    return s === e ? '时间 ' + s : '时间 ' + s + ' 到 ' + e;
+}
+/** 来源脚注：`数据来源 <来源> ｜ <窗口> ｜ 共 N 条`（分隔由版式出，字符不进可见文本）。
+ *
+ *  t728 改法：改前是先 `join(' · ')` 拼成一整串再交给口径行，于是公共层的拆段器认不出它
+ *  （它只认并列分隔符）⇒ 那 32 行 `·` 串原样上屏，正是用户点名的那类「用符号简化 UI」。
+ *  现在改成：本件只说「这是三段并列」，`｜` 交给 `renderCaliberLine` 拆成逐段 `<span>`，
+ *  段间那条细竖线由公共层 CSS 出（与全仓口径行同一条机制、同一处定义）。 */
+export function sourceLine(facts) {
+    const parts = [];
+    const source = facts.source.trim();
+    if (source !== '')
+        parts.push('数据来源 ' + source);
+    parts.push(windowText(facts.start, facts.end));
+    parts.push('共 ' + String(facts.count) + ' 条');
+    return renderCaliberLine(parts.join(SEG));
+}
+//# sourceMappingURL=sourceLine.js.map

package/dist/shared/sourceLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLine.js","sourceRoot":"","sources":["../../src/shared/sourceLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AActD;oDACoD;AACpD,MAAM,GAAG,GAAG,GAAG,CAAC;AAEhB;kDACkD;AAClD,SAAS,UAAU,CAAC,KAAa,EAAE,GAAW;IAC5C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;IACzE,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC;IACrC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AACrD,CAAC;AAED;;;;;4CAK4C;AAC5C,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,MAAM,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/shared/writeParts.d.ts

@@ -0,0 +1,64 @@
+/** 写命令回执的共用件（**唯一定义地**）：回执事实的形状（`BillReceipt`）＋ 影响行数口径（`totalChanges`）
+ *  ＋ 页面的 `<section>` 段（`writeSection`）＋ 命令原文（`commandLine`）。**对外五件**；三字符转义（`esc`）只在本件内部
+ *  给 `writeSection` 用，不转出去（铁律五：接口小、里面厚）。
+ *  回执事实里 `op` 的取值集 `RecordOp` 住共用位 `./params.js`（#689 起：它与 `id` 槽位守卫同住一件，
+ *  两边都是跨域参数口径）——本件只把它取来当 `BillReceipt.op` 的类型，不另立一份取值面。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/write/`——写入域：两条写命令的处理体（影响行数取前后差、回执事实在这里装配、命令原文在这里拼），
+ *      过程型采集页与结果型回执整页的 `<section>` 段；
+ *   ② `src/query/`——查询域：四条读命令的处理体用 `commandLine` 拼复制载荷与日志的命令原文，
+ *      通用查询列表页的 `<section>` 段同走 `writeSection`（槽位 `list`）。
+ *  （页面三个公共标识另立 `./pageIdentity.ts`：那是另一件活——标识取值，不是回执与 `<section>` 段。）
+ *  （页面三个公共标识另立 `./pageIdentity.ts`：那是另一件活——标识取值，不是回执与 `<section>` 段。）
+ *
+ * 口径出处：
+ *   - 影响行数＝SQLite `total_changes()` 在本次写库前后的增量（`INSERT`／`UPDATE`／软删标记一律计），
+ *     与 `packages/skill-calorie/src/shared/writeParts.ts:38` 同一口径，**非自报**；
+ *   - 回执 `<section>` 的槽位取值照卡路里同件的 `ilife:<技能>:<槽位>` 形状。
+ *
+ * 转义口径（**不得与公共层 `escapeHtml` 互换**）：本件 `esc` 只转 `&`／`<`／`>` 三字符；
+ *   公共层那一份（`base-paint` 的 `escapeHtml`，`src/render/html.ts` 也改引它）转五字符（多 `"`／`'`）。
+ *   两者混用会静默改产物（`docs/skills/skill-bill/t406-共用件依赖与提升改造清单.md` 第二节 `esc` 行）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { RecordOp } from './params.js';
+/** 一次写库的事实（回执页与复制日志都读它）。
+ *  形状照卡路里同件的收据对象，只留饼干用得上的：操作／记录号／摘要／影响行数／写入字段／有无改动／来源／时刻。
+ *  `noChange` 承接「值与改前一致」那一格，一页只出现这一处。 */
+export interface BillReceipt {
+    readonly op: RecordOp;
+    readonly recordId: number | null;
+    readonly summary: string;
+    readonly affectedRows: number;
+    readonly writtenFields: readonly string[];
+    readonly noChange: boolean;
+    /** 本次数据从哪里来（复制日志第 3 段；库文件名逐字由调用方给，共用件不取本包文件名）。 */
+    readonly source: string;
+    /** 写入时刻（本地时钟，`YYYY-MM-DD HH:MM:SS`）。 */
+    readonly actionAt: string;
+}
+/** 回执格式串（页尾对账折叠区那一行）；本票口径 `v1`。 */
+export declare const RECEIPT_FORMAT = "v1\uFF08\u5199\u5E93\u56DE\u6267\uFF09";
+/** 影响行数口径：SQLite `total_changes()` 的当前值；调用方取「写库前」与「写库后」两次之差。 */
+export declare function totalChanges(db: DatabaseSync): number;
+/** 本次执行的命令原文（复制 prompt 区与复制日志第 4 段共用）：与助手实跑那条同形，含本次 `--params`，可照抄重跑。
+ *  参数值里若出现半角单引号，原文会在此处被截断——真要照抄重跑请自行转义（本仓命令原文一贯用单引号包 JSON）。 */
+export declare function commandLine(key: string, params: Record<string, unknown>): string;
+/** 页面域内的 `<section>` 段：`data-slot`（`receipt`＝结果型回执整页、`collect`＝过程型采集页、
+ *  `list`＝查询域列表页）＋ 四个机器标记 ＋ 正文。
+ *  标记：`data-skill`（技能名，取值同页标识）／`data-slot`（页型槽位，取值见上）
+ *  ／`data-shape`（＝本次 envelope 的形状，与老回执页同一枚，**是契约、不随页型改**）
+ *  ／`data-page`（**选页用这一枚**：`collect`／`receipt`／`list`；回执页与采集页共用 `shape=receipt`，靠 shape 选页会选错）
+ *  ／`data-key`（**场景名**，过 `sceneKeyOf`：`bill.record.add` → `record.add`）。
+ *  R4 收口（写域）：`bill.` 只许出现在复制载荷区（`pre`／复制块／`data-t`），页面标记一律写场景名；
+ *  要整名时 `data-skill` ＋ `.` ＋ `data-key` 仍拼得回来。
+ *  H1 与副标题**不在这里**：那是页面模板（`base-paint/blocks` 的 `renderPageShell`）的活，一处只出一次。 */
+export declare function writeSection(input: {
+    readonly slot: 'receipt' | 'collect' | 'list';
+    readonly page: 'receipt' | 'collect' | 'list';
+    readonly shape: string;
+    readonly key: string;
+    readonly content: string;
+}): string;
+//# sourceMappingURL=writeParts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeParts.d.ts","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;yCAEyC;AACzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,mCAAmC;AACnC,eAAO,MAAM,cAAc,2CAAa,CAAC;AAOzC,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAGrD;AAED;+DAC+D;AAC/D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEhF;AAUD;;;;;;;;gFAQgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAIT"}

package/dist/shared/writeParts.js

@@ -0,0 +1,39 @@
+import { DOC_SKILL, sceneKeyOf } from './pageIdentity.js';
+/** 回执格式串（页尾对账折叠区那一行）；本票口径 `v1`。 */
+export const RECEIPT_FORMAT = 'v1（写库回执）';
+/** 三字符转义：只转 `&`／`<`／`>`。**不得与五字符的 `escapeHtml` 互换**（见文件头）；只给本件的 `<section>` 段用。 */
+function esc(s) {
+    return String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** 影响行数口径：SQLite `total_changes()` 的当前值；调用方取「写库前」与「写库后」两次之差。 */
+export function totalChanges(db) {
+    const row = db.prepare('SELECT total_changes() AS n').get();
+    return row && typeof row.n === 'number' ? Number(row.n) : 0;
+}
+/** 本次执行的命令原文（复制 prompt 区与复制日志第 4 段共用）：与助手实跑那条同形，含本次 `--params`，可照抄重跑。
+ *  参数值里若出现半角单引号，原文会在此处被截断——真要照抄重跑请自行转义（本仓命令原文一贯用单引号包 JSON）。 */
+export function commandLine(key, params) {
+    return 'bill-cmd-read ' + key + " --params '" + JSON.stringify(params) + "'";
+}
+/** `<section>` 上的类名（按槽位取值）。写域两页沿用已交付产物上的 `ilife-write`（32 份产物与验收墙按它，
+ *  本票一字不动）；查询域列表页用自己那一枚 `ilife-list`——同一份整页不该顶着「write」这个类名走。 */
+const SECTION_CLASS = {
+    receipt: 'ilife-write',
+    collect: 'ilife-write',
+    list: 'ilife-list',
+};
+/** 页面域内的 `<section>` 段：`data-slot`（`receipt`＝结果型回执整页、`collect`＝过程型采集页、
+ *  `list`＝查询域列表页）＋ 四个机器标记 ＋ 正文。
+ *  标记：`data-skill`（技能名，取值同页标识）／`data-slot`（页型槽位，取值见上）
+ *  ／`data-shape`（＝本次 envelope 的形状，与老回执页同一枚，**是契约、不随页型改**）
+ *  ／`data-page`（**选页用这一枚**：`collect`／`receipt`／`list`；回执页与采集页共用 `shape=receipt`，靠 shape 选页会选错）
+ *  ／`data-key`（**场景名**，过 `sceneKeyOf`：`bill.record.add` → `record.add`）。
+ *  R4 收口（写域）：`bill.` 只许出现在复制载荷区（`pre`／复制块／`data-t`），页面标记一律写场景名；
+ *  要整名时 `data-skill` ＋ `.` ＋ `data-key` 仍拼得回来。
+ *  H1 与副标题**不在这里**：那是页面模板（`base-paint/blocks` 的 `renderPageShell`）的活，一处只出一次。 */
+export function writeSection(input) {
+    return '<section class="' + SECTION_CLASS[input.slot] + '" data-skill="' + DOC_SKILL + '" data-slot="ilife:bill:' + input.slot
+        + '" data-page="' + input.page + '" data-shape="' + esc(input.shape) + '" data-key="' + esc(sceneKeyOf(input.key)) + '">'
+        + input.content + '</section>';
+}
+//# sourceMappingURL=writeParts.js.map

package/dist/shared/writeParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeParts.js","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkB1D,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,mFAAmF;AACnF,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5F,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,EAAgB;IAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GAAG,EAAgC,CAAC;IAC1F,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;+DAC+D;AAC/D,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAA+B;IACtE,OAAO,gBAAgB,GAAG,GAAG,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;AAC/E,CAAC;AAED;gEACgE;AAChE,MAAM,aAAa,GAA6D;IAC9E,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF;;;;;;;;gFAQgF;AAChF,MAAM,UAAU,YAAY,CAAC,KAM5B;IACC,OAAO,kBAAkB,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,GAAG,SAAS,GAAG,0BAA0B,GAAG,KAAK,CAAC,IAAI;UAC1H,eAAe,GAAG,KAAK,CAAC,IAAI,GAAG,gBAAgB,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI;UACvH,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC;AACnC,CAAC"}

package/dist/triggers/routeSpec.d.ts

@@ -0,0 +1,109 @@
+/** #721 · 路由与声明的**形状**（类型唯一处）。
+ *
+ * 本件只放类型与形状，**不含任何记录数据、不含任何逻辑**：
+ *   - 三个路由类型（`BillKey` 键联合／`WakeEntry` 路由项／`WakeRoute` 路由结果）——今天的行为逐字不变；
+ *   - 四份**声明形状**（`DomainDeclaration` / `WakeEntryDecl` / `WakeSubgroupDecl` / `WakeSceneDecl`）——
+ *     各域 `declaration.ts` 写出的形状，比运行时记录多一个「场景归谁所有」的位置；
+ *   - 三个**投影形状**（`WakeSceneAsset` / `WakeSubgroupAsset` / `WakeGroupAsset`）——HELP 目录那一面
+ *     （`src/triggers/wake-assets.ts` 转出，路径与导出面照旧）。
+ *
+ * 顺序权威：词的顺序＝**域声明里 `entries` 的书写顺序**（词表由各声明按 `order` 拼接得出，
+ * 不打乱、不重排）；域的顺序＝`DomainDeclaration.order`（缺号／重号 fail-closed）。
+ * 谁在写声明：`src/<域>/declaration.ts` ×7 ＋ `src/help/declaration.ts`（无场景的那一份）。
+ *
+ * 口径出处：形状照兄弟件 `packages/skill-calorie/src/triggers/routeSpec.ts`（照结构，不照文件）——
+ * 「类型唯一处、声明件只写记录」是同一条分工；住处由 [规格] 目标 src/ 形状（#720）归入
+ * 「外壳与机器面」里的触发与路由机器面。
+ */
+/** 记账的 16 个命令名（跨技能契约，冻结不动；`bill.record.*` 六条属写入域与查询域两域共用同一前缀）。 */
+export type BillKey = 'bill.record.add' | 'bill.record.update' | 'bill.record.today' | 'bill.record.range' | 'bill.record.search' | 'bill.record.detail' | 'bill.analysis.overview' | 'bill.analysis.compare' | 'bill.analysis.trend' | 'bill.goal.write' | 'bill.goal.query' | 'bill.account.write' | 'bill.account.query' | 'bill.link.submit' | 'bill.setup.run' | 'bill.help.lookup';
+/** 路由结果：命中哪条命令 ＋ 随命令带下去的槽位。 */
+export interface WakeRoute {
+    readonly key: BillKey;
+    readonly params: Record<string, unknown>;
+}
+/** 路由项（＝域声明里去掉场景的那半）；`needs`＝必需槽位（给不出就在路由层报错）；
+ *  `carries`＝**不拦**、上下文里给了就带下去的槽位（改记录／撤销／恢复三条词的 `id` 住这里）。
+ *  分两格的理由见本件的 `WakeEntry`（逐字保留自旧的 `src/policy/wakewords.ts`——那件已随 #689 第三批删掉）。 */
+export interface WakeEntry {
+    readonly phrase: string;
+    readonly key: BillKey;
+    readonly preset?: Readonly<Record<string, unknown>>;
+    readonly needs?: readonly string[];
+    readonly carries?: readonly string[];
+}
+/** 徽章类型词（老实物用到的全集；共享 help 模板 `TYPE_DEFAULT` 认得这些词，缺席即配色表要改）。 */
+export type WakeSceneType = '采集' | '查看' | '选择' | '向导' | '回执';
+/** 一条场景（老 HELP 卡的内容面）。**不写 `wake_word`**——那是拥有它的词条的**投影**。 */
+export interface WakeSceneDecl {
+    readonly id: string;
+    readonly title: string;
+    /** 老实物 71/71 为空串（可用）；`【待开发】` 为本仓预留态。 */
+    readonly status: string;
+    /** 「复制指令」按钮按出来的正文，逐字保留。 */
+    readonly prompt_template: string;
+    readonly types: readonly WakeSceneType[];
+}
+/** 一条词条：这个词怎么说、路由到哪条命令、说完看到哪几张卡（`scenes` ×0..n）。 */
+export interface WakeEntryDecl {
+    readonly phrase: string;
+    readonly key: BillKey;
+    readonly preset?: Readonly<Record<string, unknown>>;
+    readonly needs?: readonly string[];
+    readonly carries?: readonly string[];
+    readonly scenes: readonly WakeSceneDecl[];
+}
+/** 一个二级组：名字 ＋ 它按序排的场景 id（场景本身住词条名下，不在这里再抄一遍）。 */
+export interface WakeSubgroupDecl {
+    readonly id: string;
+    readonly label: string;
+    readonly scenes: readonly string[];
+}
+/** 一份**域声明**（手写、唯一事实源）。
+ *
+ * 机械不变式（合并件与判据都按这几条判）：
+ *   - `order` 在 8 份声明里唯一且连续，从 0 起（0＝HELP 自身位，排在所有域之前，保住今天的词序）；
+ *   - 有场景的声明（`subgroups` 非空）必须有 `label` 与 `icon`；无场景的那一份（HELP 位）两者都不给；
+ *   - 一个场景 id 只准被一条词条拥有一次；二级组点名的场景必须在本域内（否则合并期即抛）。 */
+export interface DomainDeclaration {
+    readonly id: string;
+    readonly label?: string;
+    readonly icon?: string;
+    readonly order: number;
+    readonly entries: readonly WakeEntryDecl[];
+    readonly subgroups: readonly WakeSubgroupDecl[];
+}
+/** 投影面：一条场景卡（HELP 页读的那一层；`wake_word` 由拥有它的词条算出）。 */
+export interface WakeSceneAsset {
+    readonly id: string;
+    readonly title: string;
+    readonly wake_word: string;
+    readonly status: string;
+    readonly prompt_template: string;
+    readonly types: readonly WakeSceneType[];
+}
+/** 投影面：一个二级组（`scenes` 已是场景卡）。 */
+export interface WakeSubgroupAsset {
+    readonly id: string;
+    readonly label: string;
+    readonly scenes: readonly WakeSceneAsset[];
+}
+/** 投影面：一个域（HELP 一级分组）。 */
+export interface WakeGroupAsset {
+    readonly id: string;
+    readonly icon: string;
+    readonly label: string;
+    readonly subgroups: readonly WakeSubgroupAsset[];
+}
+/** 投影的线索（调用方知道自己手里的哪几件事，就给哪几件）。 */
+export interface WakeScope {
+    /** 命令名（缺省＝在全部词条里找）。 */
+    readonly key?: BillKey;
+    /** 内部型名（`expense`／`lend`…）：按词条的 `preset.kind` 认。 */
+    readonly kind?: string;
+    /** 操作名（`undo`／`restore`…）：按词条的 `preset.op` 认。 */
+    readonly op?: string;
+    /** 命令的入参原样（页面标题那一支：按 preset 子集与 needs 命中）。 */
+    readonly preset?: Readonly<Record<string, unknown>>;
+}
+//# sourceMappingURL=routeSpec.d.ts.map

package/dist/triggers/routeSpec.d.ts.map

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

package/dist/triggers/routeSpec.js

@@ -0,0 +1,19 @@
+/** #721 · 路由与声明的**形状**（类型唯一处）。
+ *
+ * 本件只放类型与形状，**不含任何记录数据、不含任何逻辑**：
+ *   - 三个路由类型（`BillKey` 键联合／`WakeEntry` 路由项／`WakeRoute` 路由结果）——今天的行为逐字不变；
+ *   - 四份**声明形状**（`DomainDeclaration` / `WakeEntryDecl` / `WakeSubgroupDecl` / `WakeSceneDecl`）——
+ *     各域 `declaration.ts` 写出的形状，比运行时记录多一个「场景归谁所有」的位置；
+ *   - 三个**投影形状**（`WakeSceneAsset` / `WakeSubgroupAsset` / `WakeGroupAsset`）——HELP 目录那一面
+ *     （`src/triggers/wake-assets.ts` 转出，路径与导出面照旧）。
+ *
+ * 顺序权威：词的顺序＝**域声明里 `entries` 的书写顺序**（词表由各声明按 `order` 拼接得出，
+ * 不打乱、不重排）；域的顺序＝`DomainDeclaration.order`（缺号／重号 fail-closed）。
+ * 谁在写声明：`src/<域>/declaration.ts` ×7 ＋ `src/help/declaration.ts`（无场景的那一份）。
+ *
+ * 口径出处：形状照兄弟件 `packages/skill-calorie/src/triggers/routeSpec.ts`（照结构，不照文件）——
+ * 「类型唯一处、声明件只写记录」是同一条分工；住处由 [规格] 目标 src/ 形状（#720）归入
+ * 「外壳与机器面」里的触发与路由机器面。
+ */
+export {};
+//# sourceMappingURL=routeSpec.js.map

package/dist/triggers/routeSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeSpec.js","sourceRoot":"","sources":["../../src/triggers/routeSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/triggers/wake-assets.d.ts

@@ -0,0 +1,15 @@
+import type { WakeGroupAsset, WakeSceneAsset } from './routeSpec.js';
+export type { WakeSceneType, WakeSceneAsset, WakeSubgroupAsset, WakeGroupAsset } from './routeSpec.js';
+/** 7 域／20 二级组／74 场景（域序＝声明的 `order`，词序＝声明里的书写顺序）。 */
+export declare const WAKE_GROUPS: readonly WakeGroupAsset[];
+/** 扁平 74 条（顺序与 HELP 分组一致；单源派生，不重复落词）。 */
+export declare const WAKE_ASSETS: readonly WakeSceneAsset[];
+/** id → 场景（74/74 唯一）。 */
+export declare const SCENE_BY_ID: Readonly<Record<string, WakeSceneAsset>>;
+/** 资产总数（由 `WAKE_ASSETS` 派生，单源不复写第二遍数；改资产即跟变，测试仍钉 74）。 */
+export declare const WAKE_ASSET_TOTAL: number;
+/** HELP 自身的唤醒词（老实物 `meta_blocks.help_wake_words` 那一块；4 条，不进场景目录）。
+ *
+ * 从**无场景的那份声明**（HELP 位）读——防自指的规则只写一处：有场景的进目录，没场景的进这里。 */
+export declare const HELP_WAKE_WORDS: readonly string[];
+//# sourceMappingURL=wake-assets.d.ts.map

package/dist/triggers/wake-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wake-assets.d.ts","sourceRoot":"","sources":["../../src/triggers/wake-assets.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAqB,cAAc,EAAE,cAAc,EAAqB,MAAM,gBAAgB,CAAC;AAE3G,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA6BvG,oDAAoD;AACpD,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAEA,CAAC;AAElD,yCAAyC;AACzC,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAEhD,CAAC;AAEF,yBAAyB;AACzB,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEhE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,EAAE,MAA2B,CAAC;AAE3D;;yDAEyD;AACzD,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAEI,CAAC"}