skill-bill 0.1.0 → 0.2.1

package/dist/shared/copyArea.js

@@ -0,0 +1,124 @@
+/** 复制与提示共用件：复制 prompt 区、复制区（数据位＋日志位）、复制日志的入参。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/write/`——写入域：过程型采集页（复制 prompt 区 ＋ 复制数据／日志）与结果型回执整页（复制数据／日志）；
+ *   ② `src/query/`——查询域：通用查询列表页的复制数据／日志两条通道（不设 prompt 区——查询不写库，没有要交回助手的一句）。
+ *  （写域 32 份产物按本件的字面量冻结，查询域只引用、不改这里的任何一句。）
+ *
+ * 三件东西**只接线、不重造**：
+ *   ① 复制按钮与区块 → `base-paint/blocks` 的 `renderPreBlock`（带 `copyText` 自带复制按钮）与 `renderCopyBlock`；
+ *   ② 复制文本 → `base-paint` 的 `buildDataText`（数据投影）／`buildLogText`（六段日志）；
+ *   ③ 复制成功与失败的提示 → 页面运行时 `buildSharedHelpersJs` 自带（本文件不产第二条提示通道）。
+ *
+ * 口径出处：照 `packages/skill-calorie/src/shared/copyArea.ts`（照结构，不照文件）。
+ *   两处按饼干的情形改了口径：
+ *   - 卡路里的 `promptCopyArea` 走它包内的 `render/copy.js`（`copyActionHtml`，缺省文案是卡路里说法）；
+ *     本件改走 base 现成组件的 `renderPreBlock({copyText})`——**不新增 base 组件、不动别包**，
+ *     复制按钮与逻辑全在 base 侧；
+ *   - 日志第 3 段的库文件名**由调用方给**（`CopyLogInput.source`），共用件不取本包文件名
+ *     （`docs/skills/skill-bill/t406-共用件依赖与提升改造清单.md` 第二节 `DB_FILENAME` 行）。
+ */
+import { renderCaliberLine, renderCopyBlock, renderEmptyBlock, renderPreBlock } from 'base-paint/blocks';
+import { buildDataText, buildLogText } from 'base-paint';
+/** 日志第 2 段（助手思考链）：本仓页面一律由本地 CLI 渲染，不落 `(未知)` 占位。 */
+const LOG_THINKING = '本页由本地渲染，无助手链';
+/** 日志第 6 段（异常）：正常产出即「无」。 */
+const LOG_EXCEPTION = '无';
+/** 复制区空态缺省句（三样全没给时出这一句、不出按钮——点了没反应的死按钮就是问题）。 */
+const COPY_EMPTY_TEXT = '本页没有可复制的数据';
+/** 本次执行时刻串（页面入参 `actionAt`／回执事实 `actionAt` 的**唯一定义地**）：本地时钟 `YYYY-MM-DD HH:MM:SS`。
+ *  写域与查询域两张页都读它——搬迁前它分别是 `src/write/write.ts` 的文件级函数与查询域现取的钟，
+ *  第二个用法（查询域列表页，票 #411）长出来之后收成这一处；**取时钟仍在各域处理体那一步调它**，
+ *  共用位不自己在模块顶层取时钟（那样一次调用两次读数会不一致）。 */
+export function actionStamp() {
+    return new Date().toISOString().slice(0, 19).replace('T', ' ');
+}
+/** 复制数据三格式菜单里三项的用途提示（纯文本／JSON／CSV，顺序＝`COPY_FORMATS`）。
+ *  格式名保留（那是数据格式本来的样子，不是内部标识），只说清它拿去做什么。 */
+const MENU_HINTS = ['纯文本 粘贴给助手或自己看', 'JSON 结构化存档', 'CSV 表格导入'];
+/** 复制 prompt 区那段 prompt 的复制按钮动作号（固定一枚：同页只出一次 prompt 区）。
+ *  小标题缺省那句 `复制 prompt（必走）` 里的 `prompt` 不上屏（本轮整改）——改「复制给助手：这一句可以直接复制」
+ *  （总则②：写清这块复制走给谁；仍含老字串，护栏不断言全等只认包含）。 */
+const PROMPT_COPY_ACTION = 'ilife-copy-prompt';
+const PROMPT_COPY_HINT = '复制给助手：这一句可以直接复制';
+/** ① 复制 prompt 区：prompt 预览（`renderPreBlock`）＋ 它自带的复制按钮。
+ *  **`actionId` 必给**：公共层的 `renderPreBlock` 只在给了 `actionId` 时才渲染复制按钮
+ *  （`packages/base-render/src/blocks.ts:729-736`），只给 `copyText` 会出一个「写着复制、其实没有按钮」的
+ *  有标签没按钮位——那正是本票线上实测发现的一处，本件补齐。
+ *  第二参可选：不给＝小标题「复制给助手：这一句可以直接复制」；`null`＝不出小标题；给字符串就用它。 */
+export function promptCopyArea(prompt, label) {
+    const heading = label === undefined ? PROMPT_COPY_HINT : label;
+    return renderPreBlock({
+        ...(heading === null ? {} : { label: heading }),
+        command: prompt,
+        actionId: PROMPT_COPY_ACTION,
+        copyText: prompt,
+        copyLabel: PROMPT_COPY_HINT,
+    });
+}
+/** ② 复制区：prompt／数据／日志给了什么出什么；三样全不给＝一句空态、**不出按钮**。 */
+export function copyArea(input) {
+    const parts = [];
+    const prompt = input.prompt;
+    if (typeof prompt === 'string') {
+        if (prompt !== '')
+            parts.push(promptCopyArea(prompt));
+    }
+    else if (prompt !== undefined && prompt.text !== '') {
+        parts.push(promptCopyArea(prompt.text, prompt.label ?? null));
+    }
+    if (input.data !== undefined || input.log !== undefined) {
+        parts.push(renderCopyBlock({
+            ...(input.data === undefined ? {} : { dataFormats: formatsOf(input.data) }),
+            ...(input.log === undefined ? {} : { logText: buildLogText(input.log) }),
+        }));
+        return parts.join('');
+    }
+    if (parts.length > 0)
+        return parts.join('');
+    return renderEmptyBlock({ text: input.emptyText ?? COPY_EMPTY_TEXT });
+}
+/** 数据位的那份数据 → 三种格式各算一份 ＋ 菜单提示（`buildDataText` 是本仓复制文本的唯一出口）。
+ *  上级裁定第 2 条：复制载荷头行 `【bill · record.add】` 算上屏一并改——`text` 那份显式给 `title`，
+ *  不再让公共层按 `envelope.skill/key` 拼出命令名；`title` 只写用户说法，不带命令名与 `·`。 */
+function formatsOf(data) {
+    const title = typeof data.title === 'string'
+        && (data.title ?? '').trim() !== ''
+        ? data.title
+        : '记账数据';
+    return {
+        text: buildDataText({ ...data, format: 'text', title }),
+        json: buildDataText({ ...data, format: 'json' }),
+        csv: buildDataText({ ...data, format: 'csv' }),
+        hints: MENU_HINTS,
+    };
+}
+/** ③ 复制日志的第 2–6 段入参：本页由哪条命令渲染、数据从哪来、写了多少行、什么时候。 */
+export function copyLog(input) {
+    return {
+        thinking: LOG_THINKING,
+        dataStructure: input.source === undefined || input.source === '' ? COPY_EMPTY_TEXT : input.source,
+        callChain: input.detail === undefined || input.detail === '' ? input.command : input.command + ' ｜ ' + input.detail,
+        timestamp: input.version === undefined || input.version === '' ? input.actionAt : input.actionAt + ' · 版本 ' + input.version,
+        exception: LOG_EXCEPTION,
+    };
+}
+/** 退出口那枚危险色出口标记的动作号。**故意不绑动作**：动作条场景按钮不带 `data-t`，点了不复制也不写库。 */
+const EXIT_MARK_ACTION = 'ilife-exit-undo';
+/** 退出口的标题与说明（本轮整改：`危险色出口` 是设计自指词，`restore` 是内部词，都不上屏）。
+ *  t728：两句之间的 `；` 换成句号——分号在这里不是并列，是把两件事挤进一句的排版手法
+ *  （用户逐字要求 5 点名的那类）；拆成两句之后读法仍是「怎么做」＋「撤销之后会怎样」。 */
+const EXIT_TITLE = '想反悔（撤销这一笔）';
+const EXIT_NOTE = '要撤销这一笔，点下面那颗「复制数据」，里面带着一句撤销的话。撤销之后记录还在，随时可以恢复。';
+/** ④ 回执页退出口：危险色出口标记 ＋ 一句去向说明（t407 根因整改二 D2 去重后）。
+ *  改前这里另带一枚「复制数据」（撤销指令直拷，`ilife-exit-undo-copy`）＋ base #336
+ *  自动补的一枚置灰「复制日志」，与下面复制区那组「复制数据／复制日志」上下重复。
+ *  改后退出口只留标记与说明、不带任何复制按钮与 `data-t`；撤销指令走下面复制区那颗
+ *  「复制数据」（复制载荷里仍带可重跑命令，`data-t` 形状不动）。 */
+export function undoExit(recordId) {
+    return renderCopyBlock({
+        title: EXIT_TITLE,
+        buttons: [{ label: '↩︎ 撤销这一笔', kind: 'red', actionId: EXIT_MARK_ACTION }],
+    }) + renderCaliberLine(EXIT_NOTE + '（记录编号 ' + recordId + '）');
+}
+//# sourceMappingURL=copyArea.js.map

package/dist/shared/copyArea.js.map

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

package/dist/shared/dateRange.d.ts

@@ -0,0 +1,31 @@
+/** 只给日期不给时分秒时的缺省时刻（**唯一定义地**）：`validateTime` 补出整串，页面侧的预填标注引这一份。
+ *  改这一条就是改全仓的缺省时刻，别处不得再写第二份 `12:00:00` 字面量。 */
+export declare const DEFAULT_TIME_SUFFIX = "12:00:00";
+/** 缺省时刻的整串形态：`YYYY-MM-DD` ＋ 上面那份（页面文案与库内取值同一句）。 */
+export declare function defaultTimeOn(date: string): string;
+export declare const DATETIME_RE: RegExp;
+export declare const DATE_RE: RegExp;
+export declare const MONTH_RE: RegExp;
+export declare function validateTime(raw: unknown): string;
+export declare function normalizeDate(d: unknown, field?: string): string;
+export declare function normalizeMonth(m: unknown, field?: string): string;
+/** 查询某天的入参：不给／给空＝今天（UTC 日）；给了就归一（`YYYY-MM-DD` 三种写法都认）。 */
+export declare function resolveQueryDate(params: Record<string, unknown>): string;
+/** 区间的入参：`start`／`end` 同给；缺一即缺槽位阻断，起点晚于终点阻断。 */
+export declare function resolveRange(params: Record<string, unknown>): {
+    start: string;
+    end: string;
+};
+/** 某个月的起止日（`YYYY-MM` → 该月 1 号到月末）。 */
+export declare function monthRange(month: string): {
+    start: string;
+    end: string;
+};
+/** 昨天（本地日期串 `YYYY-MM-DD`）。 */
+export declare function yesterdayStr(): string;
+/** 本周（周一为第一天）的起止日。 */
+export declare function weekRange(): {
+    start: string;
+    end: string;
+};
+//# sourceMappingURL=dateRange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dateRange.d.ts","sourceRoot":"","sources":["../../src/shared/dateRange.ts"],"names":[],"mappings":"AAiBA;+CAC+C;AAC/C,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,eAAO,MAAM,WAAW,QAA2D,CAAC;AACpF,eAAO,MAAM,OAAO,QAAwB,CAAC;AAC7C,eAAO,MAAM,QAAQ,QAA4B,CAAC;AAQlD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAajD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,SAAS,GAAG,MAAM,CAUhE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,SAAU,GAAG,MAAM,CAKlE;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAMxE;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAQ5F;AAOD,sCAAsC;AACtC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAKxE;AAED,8BAA8B;AAC9B,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAED,sBAAsB;AACtB,wBAAgB,SAAS,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAM1D"}

package/dist/shared/dateRange.js

@@ -0,0 +1,121 @@
+/** 共用位·日期与时间窗口口径（#689 结构搬迁第三批）：从 `src/policy/category.ts` 的日期函数
+ *  ＋ `src/policy/record.ts` 的日期与时间窗口两半合并而来——**一件一处**：日期串的归一、月份串的归一、
+ *  时刻的补齐，以及「某天／某周／某月／某区间」这些窗口算式都只在这里写一遍。
+ *
+ *  谁在用（指名，路径随 #689 搬迁改成新家）：
+ *    · `src/write/`——`record.ts`（`validateUpdateInput` 的 `validateTime`）·
+ *      `prefillNote.ts`／`summaryRow.ts`（`DEFAULT_TIME_SUFFIX`／`defaultTimeOn`）；
+ *    · `src/query/read.ts`——查今天／查昨天（`resolveQueryDate`／`yesterdayStr`）、查区间（`resolveRange`）、
+ *      锚点归一（`normalizeDate`）；
+ *    · `src/analysis/`——`needMonth`／`needRange` 的 `normalizeMonth`／`normalizeDate`；
+ *    · `src/goal/`——预算月份与目标截止日（`normalizeMonth`／`normalizeDate`）；
+ *    · `src/cli/cmd_read.ts`——未迁移的 analysis／goal 两族分支的 `monthRange`／`resolveRange`（外壳）；
+ *    · `src/shared/category.ts`——`validateRecord` 补时刻（`defaultTimeOn`／`validateTime`）。
+ *  两域以上在用它 ⇒ 住共用位（归属律 2）。日期函数**不是**按「单消费者」判的：它们是同一条口径的整族
+ *  （`validateTime` 补出 `DEFAULT_TIME_SUFFIX`，页面侧预填标注引同一份），拆开就会各写一份时刻字面量。 */
+import { BillPolicyError } from '../fetch/errors.js';
+/** 只给日期不给时分秒时的缺省时刻（**唯一定义地**）：`validateTime` 补出整串，页面侧的预填标注引这一份。
+ *  改这一条就是改全仓的缺省时刻，别处不得再写第二份 `12:00:00` 字面量。 */
+export const DEFAULT_TIME_SUFFIX = '12:00:00';
+/** 缺省时刻的整串形态：`YYYY-MM-DD` ＋ 上面那份（页面文案与库内取值同一句）。 */
+export function defaultTimeOn(date) {
+    return date + ' ' + DEFAULT_TIME_SUFFIX;
+}
+export const DATETIME_RE = /^(\d{4})-(\d{2})-(\d{2})(?: (\d{2}):(\d{2}):(\d{2}))?$/;
+export const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+export const MONTH_RE = /^\d{4}-(0[1-9]|1[0-2])$/;
+function realDate(y, m, d) {
+    const dt = new Date(y, m - 1, d);
+    return dt.getFullYear() === y && dt.getMonth() === m - 1 && dt.getDate() === d;
+}
+// 时间：YYYY-MM-DD HH:mm:ss 或 YYYY-MM-DD（补 12:00:00）；非法阻断。
+export function validateTime(raw) {
+    if (typeof raw !== 'string' || raw.trim().length === 0) {
+        throw new BillPolicyError('POLICY_BAD_TIME', 'time 不能为空');
+    }
+    const s = raw.trim().replace(/\//g, '-');
+    const m = DATETIME_RE.exec(s);
+    if (!m)
+        throw new BillPolicyError('POLICY_BAD_TIME', 'time 格式非法');
+    const y = Number(m[1]);
+    const mo = Number(m[2]);
+    const d = Number(m[3]);
+    if (!realDate(y, mo, d))
+        throw new BillPolicyError('POLICY_BAD_TIME', 'time 非真实日期');
+    if (m[4] === undefined)
+        return defaultTimeOn(s);
+    const hh = Number(m[4]);
+    const mm = Number(m[5]);
+    const ss = Number(m[6]);
+    if (hh > 23 || mm > 59 || ss > 59)
+        throw new BillPolicyError('POLICY_BAD_TIME', 'time 时分秒非法');
+    return s;
+}
+export function normalizeDate(d, field = 'date') {
+    if (typeof d !== 'string' || d.trim().length === 0) {
+        throw new BillPolicyError('POLICY_BAD_TIME', field + ' 须为日期字符串');
+    }
+    let s = d.trim().replace(/\//g, '-').replace(/\./g, '-');
+    if (/^\d{8}$/.test(s))
+        s = s.slice(0, 4) + '-' + s.slice(4, 6) + '-' + s.slice(6);
+    if (!DATE_RE.test(s))
+        throw new BillPolicyError('POLICY_BAD_TIME', field + ' 格式非法');
+    const parts2 = s.split('-').map(Number);
+    if (!realDate(parts2[0], parts2[1], parts2[2]))
+        throw new BillPolicyError('POLICY_BAD_TIME', field + ' 非真实日期');
+    return s;
+}
+export function normalizeMonth(m, field = 'month') {
+    if (typeof m !== 'string' || !MONTH_RE.test(m.trim())) {
+        throw new BillPolicyError('POLICY_BAD_TIME', field + ' 格式非法');
+    }
+    return m.trim();
+}
+/** 查询某天的入参：不给／给空＝今天（UTC 日）；给了就归一（`YYYY-MM-DD` 三种写法都认）。 */
+export function resolveQueryDate(params) {
+    if (params.date === undefined || params.date === null || params.date === '') {
+        return new Date().toISOString().slice(0, 10);
+    }
+    if (typeof params.date !== 'string')
+        throw new BillPolicyError('POLICY_BAD_TIME', 'date 须为字符串');
+    return normalizeDate(params.date);
+}
+/** 区间的入参：`start`／`end` 同给；缺一即缺槽位阻断，起点晚于终点阻断。 */
+export function resolveRange(params) {
+    if (params.start === undefined || params.end === undefined) {
+        throw new BillPolicyError('POLICY_MISSING_SLOT', '缺槽位 start/end（期望 YYYY-MM-DD）');
+    }
+    const start = normalizeDate(params.start, 'start');
+    const end = normalizeDate(params.end, 'end');
+    if (start > end)
+        throw new BillPolicyError('POLICY_BAD_INPUT', 'start 不得晚于 end：' + start + '~' + end);
+    return { start, end };
+}
+/* ── 时间窗口口径（**唯一定义地**，查询域与三个分析命令共用）─────────────────────
+ * 这三件原来住在 `src/cli/cmd_read.ts` 的文件级函数里：查询域搬迁（#411）时被两个去处同时需要——
+ * 查询的「查周／查月／查昨天」与分析的「看月度／看年度／看对比」——故按口径层的位置摆正；
+ * #689 第三批随 `policy/` 拆散落到本件（原来的出口 `src/policy/index.ts` 已删）。 */
+/** 某个月的起止日（`YYYY-MM` → 该月 1 号到月末）。 */
+export function monthRange(month) {
+    const [y, m] = month.split('-').map(Number);
+    const last = new Date(y, m, 0).getDate();
+    const dd = String(last).padStart(2, '0');
+    return { start: month + '-01', end: month + '-' + dd };
+}
+/** 昨天（本地日期串 `YYYY-MM-DD`）。 */
+export function yesterdayStr() {
+    const d = new Date();
+    d.setDate(d.getDate() - 1);
+    return d.toISOString().slice(0, 10);
+}
+/** 本周（周一为第一天）的起止日。 */
+export function weekRange() {
+    const now = new Date();
+    const day = (now.getDay() + 6) % 7;
+    const mon = new Date(now);
+    mon.setDate(now.getDate() - day);
+    const sun = new Date(mon);
+    sun.setDate(mon.getDate() + 6);
+    return { start: mon.toISOString().slice(0, 10), end: sun.toISOString().slice(0, 10) };
+}
+//# sourceMappingURL=dateRange.js.map

package/dist/shared/dateRange.js.map

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

package/dist/shared/docPage.d.ts

@@ -0,0 +1,21 @@
+/** 整页装配的入参。 */
+interface DocPageInput {
+    /** head 的 `<title>` 文本。 */
+    readonly docTitle: string;
+    /** 正文标题（页面模板的 H1）。 */
+    readonly title: string;
+    /** 正文眉标（空串＝不写这一行）。 */
+    readonly eyebrow: string;
+    /** 正文副标题（空串＝不写这一行）。 */
+    readonly subtitle: string;
+    /** 已组合好的区块 HTML。 */
+    readonly content: string;
+}
+/** 整页装配：区块 HTML ＋ 标题三件套 → 完整文档（文档壳交公共层骨架件）。
+ *
+ *  `pageUi: true` —— 本包 32 页走公共层页面级配方（#525）；配套的样式段由本件拼进 `extraCss`
+ *  （与卡路里同一条路：配方 CSS 走 `extraCss`，`blocksCss()` 仍走 `sharedCssText`）。
+ *  产出物有 `.ilife-page-ui` 根类与 `viewport-fit=cover` 两处可见证据，判据 9 的量测就量这两处。 */
+export declare function assembleDocPage(input: DocPageInput): string;
+export {};
+//# sourceMappingURL=docPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docPage.d.ts","sourceRoot":"","sources":["../../src/shared/docPage.ts"],"names":[],"mappings":"AA2BA,eAAe;AACf,UAAU,YAAY;IACpB,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AA+ED;;;;2EAI2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAc3D"}

package/dist/shared/docPage.js

@@ -0,0 +1,120 @@
+/** 整页装配共用件：区块 HTML 拼成完整文档（最后一公里）。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/write/`——写入域：结果型回执整页与过程型采集页；
+ *   ② `src/query/`——查询域：通用查询列表页。
+ *  两域走的都是 `./pageShell.ts` 那一层，本件是它下面的文档装配层。
+ *
+ * 包裹约定（沿卡路里同件的 `docPage.ts`，不新增）：
+ *   内容＝`base-paint/blocks` 的区块；文档＝`fillTemplate` 包裹（资产**裸文本**传入＋由填充器包裹）；
+ *   `sharedCss = buildStyleSheet().css + blocksCss()`——**`blocksCss()` 必须拼进 `TemplateAssets.sharedCssText`**，
+ *   不得走 `StyleSheetInput.extraCss`（硬口径，见 `docs/skills/skill-bill/t406-base组件总表.md` 第 1.1 节 `blocksCss` 行）。
+ * **#725 起「文档壳」那一圈（doctype／head 三槽位序／资产拼接）搬去公共层 `base-paint/docShell` 的
+ *   `renderDocShell`**——本件只留自己的页头语义（下面五个字段）＋本包的三段补丁样式（走 `extraCss`），
+ *   拼好正文后交给骨架件；五个字段与 `pageShell.ts` 的调用点一行未动。
+ * 本文件不做取数、不装命令名与领域常量，只按参数拼页；零包内依赖（只 import `base-paint`）。
+ *
+ * **#728（写入域 32 页视觉整改）在本件改了三件事**：
+ *   ① 打开公共层的**页面级配方** `pageUi`（#525）——安全区、44px 触摸区、≤640 单列与安全区内距、
+ *      页内导航横滑、KPI 两格、iOS 惯性滚动、≥1001 版心与正文列、参数表单桌面两列，全在那一处；
+ *   ② 补丁样式按「**样式随它的选择器**」重排：目标选择器由公共层产出的规则迁回公共层
+ *      （口径行的字面色值、越出圆角闭集的 10px），本件只留**本包自己产出**的那几条；
+ *   ③ 桌面端不再由本件给「一条宽度补丁」——版心与分栏归 `pageUi` 的 ⑧ 段，本件只留一条表格宽度收口。
+ */
+import { pageUiCss } from 'base-paint';
+import { renderPageShell } from 'base-paint/blocks';
+import { renderDocShell } from 'base-paint/docShell';
+/** 桌面端补丁（t407 根因整改二 D1；t728 收窄）。
+ *
+ *  t728 为什么收窄到只剩一条：改前本段还写着「内容列放宽到 1120px」与「卡片网格换大格」，
+ *  那是**桌面端只有一条宽度补丁、没有版式**的来源（#728 诊断 R5：1200 以下没有专门版式；
+ *  1120 的内容列里仍是单列长条，右侧一片空白）。现在版心（1280）与正文列（880）＋栅格＋
+ *  宽屏表单两列都由公共层配方 `pageUi` 的 ⑧／⑪ 段出，本包不再各写一条宽度数字。
+ *
+ *  唯一留下的一条：公共层 `.ilife-block-data-table` 锁着 `max-width:680px` 居中，880 正文列下
+ *  右约 100px 留白（t403 视觉验收 D1 的同一处）；那个选择器由公共层产出、但**只在本包这两域**
+ *  需要放开（公共层自己在别的调用点仍要 680 的窄表），故按「样式随它的选择器」的例外档留在这里，
+ *  并且**只写选择器与属性、零字面色值、零新断点**（1200 是仓内既有值）。 */
+const DESKTOP_CSS = [
+    '/* t728：桌面端表格用满正文列（只 1200px 以上生效，手机端不动） */',
+    '@media (min-width:1200px) {',
+    '  .ilife-block-page-shell .ilife-block-data-table { max-width: none; }',
+    '}',
+].join('\n');
+/** 手机端黑底说明块补丁（t407 第 3 轮返工 B；与上面 D1 同一处、同一条路）。
+ *
+ *  块是 `base-paint` 的 `renderToast` 那一条（`.ilife-toast`）：左栏标题（「…标签流转：这一笔打…」，
+ *  窄栏里折成两到三行）＋ 右栏标签胶囊（永远一行）。实测毛病两处：
+ *    ① 两栏不等高——标题折了行、胶囊只有一行，整条横幅一边高一边矮（评审判「栏高不齐把整页拖重」）；
+ *    ② 行距偏紧——标题行贴着下面那几行说明，只隔 2px。
+ *  只动呈现：两栏拉到同高（`stretch` ＋ 胶囊内的字居中对齐）、标题与说明的行距统一到 1.5 以上、
+ *  标题行与说明之间留 6px。文字、块序、复制载荷一处不动。
+ *  t728：圆角从 `10px` 收到**闭集里的 `999px`**（`{8,14,20,999}` 之外的值是 R4 那类「同一语义多名值」；
+ *  这是一枚标签胶囊，999 与全仓胶囊同一档）。 */
+const TOAST_CSS = [
+    '/* t407-r3 B：黑底说明块（.ilife-toast）两栏等高＋行距 */',
+    '.ilife-toast { line-height: 1.5; }',
+    '.ilife-toast-title-row { flex-wrap: nowrap; align-items: stretch; margin-bottom: 6px; }',
+    '.ilife-toast-title-row > .ilife-toast-title { flex: 1 1 auto; min-width: 0; margin-bottom: 0; line-height: 1.5; }',
+    '.ilife-toast-title-row > .ilife-toast-chip { flex: 0 0 auto; display: inline-flex; align-items: center; justify-content: center; border-radius: 999px; }',
+    '.ilife-toast-lines { line-height: 1.6; }',
+].join('\n');
+/** 查询详情移动版式（t403-P2：只 640px 以下生效，桌面端不动）。
+ *
+ *  为什么落在本件：详情字段表（字段／值两列）在窄屏行卡化时会逐行重复表头标签
+ *  （t403 视觉验收 D2）；`renderDataTable` 的 `data-label` 恒取列头、无逐行标签选项，
+ *  唯一的落点就是本件交 `extraCss` 的这一处（与上面 DESKTOP／TOAST 同一条路）。
+ *  桌面端（≥641px）只见表格、移动端（≤640px）只见键值列表——两者由 `display` 切换，
+ *  每端恰出一套（读屏器同 CSS 一起切，不存在两套同读）；打印走桌面那一套。
+ *  t728：分隔线由字面色值 `rgba(210, 210, 215, .6)` 换成 token `var(--line)`——
+ *  判据 1 改口径后要求「补丁零字面色值」；同一个值在公共层已有一处定义（`LINE_RGB`），
+ *  本包不再抄第二份。 */
+const KV_CSS = [
+    '/* t403-P2：详情键值列表（桌面藏，移动端替表格） */',
+    '.ilife-query-kv-list { display: none; }',
+    '@media (max-width:640px) {',
+    '  .ilife-query-kv-table { display: none; }',
+    '  .ilife-query-kv-list { display: block; margin: 16px 0; border: 1px solid var(--line); border-radius: 14px; background: var(--card); }',
+    '  .ilife-query-kv-list > div { display: flex; align-items: baseline; justify-content: space-between; gap: 2px 10px; padding: 8px 12px; border-top: 1px solid var(--line); }',
+    '  .ilife-query-kv-list > div:first-child { border-top: 0; }',
+    '  .ilife-query-kv-list dt { flex: none; color: var(--fg3); font-size: 11.5px; font-weight: 600; }',
+    '  .ilife-query-kv-list dd { margin: 0; color: var(--fg); font-size: 12px; text-align: right; overflow-wrap: anywhere; }',
+    '}',
+].join('\n');
+/** 退出口单钮独占整行（t410 终审 n20：撤销页「撤销这一笔」在 390 下实测 175px 半宽）。
+ *
+ *  根因在公共层（`base-render` 的 `.ilife-action-row` 恒两列，单钮只占半格），落点只能是本件
+ *  交 `extraCss` 的这一处（与上面 DESKTOP／TOAST／KV 同一条路）。只收退出口那一格
+ *  （`copyArea.ts` 的 `undoExit`，动作号 `ilife-exit-undo`）：该格恒只有一颗红钮，
+ *  把它所在行的列改成单列；页上别的动作行（两颗复制按钮平分的那种）一行不动。桌面端同形
+ *  （危险动作独占一行，本就是层级所需）。`:has` 不支持时回退到半宽，不比改前差。 */
+const EXIT_CSS = [
+    '/* t410：退出口单钮独占整行（只收 ilife-exit-undo 这一格） */',
+    '.ilife-block-copy-block:has([data-action-id="ilife-exit-undo"]) .ilife-action-row {',
+    '  grid-template-columns: 1fr;',
+    '}',
+    '.ilife-block-copy-block:has([data-action-id="ilife-exit-undo"]) .ilife-action-btn {',
+    '  width: 100%;',
+    '}',
+].join('\n');
+/** 整页装配：区块 HTML ＋ 标题三件套 → 完整文档（文档壳交公共层骨架件）。
+ *
+ *  `pageUi: true` —— 本包 32 页走公共层页面级配方（#525）；配套的样式段由本件拼进 `extraCss`
+ *  （与卡路里同一条路：配方 CSS 走 `extraCss`，`blocksCss()` 仍走 `sharedCssText`）。
+ *  产出物有 `.ilife-page-ui` 根类与 `viewport-fit=cover` 两处可见证据，判据 9 的量测就量这两处。 */
+export function assembleDocPage(input) {
+    const body = renderPageShell({
+        title: input.title,
+        ...(input.eyebrow ? { eyebrow: input.eyebrow } : {}),
+        ...(input.subtitle ? { subtitle: input.subtitle } : {}),
+        content: input.content,
+    });
+    return renderDocShell({
+        docTitle: input.docTitle,
+        bodyHtml: body,
+        extraCss: [DESKTOP_CSS, TOAST_CSS, KV_CSS, EXIT_CSS, pageUiCss()].join('\n'),
+        doctypeCase: 'upper',
+        pageUi: true,
+    });
+}
+//# sourceMappingURL=docPage.js.map

package/dist/shared/docPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docPage.js","sourceRoot":"","sources":["../../src/shared/docPage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgBrD;;;;;;;;;;8CAU8C;AAC9C,MAAM,WAAW,GAAG;IAClB,4CAA4C;IAC5C,6BAA6B;IAC7B,wEAAwE;IACxE,GAAG;CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;;;;8BAS8B;AAC9B,MAAM,SAAS,GAAG;IAChB,4CAA4C;IAC5C,oCAAoC;IACpC,yFAAyF;IACzF,mHAAmH;IACnH,0JAA0J;IAC1J,0CAA0C;CAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;;;;gBASgB;AAChB,MAAM,MAAM,GAAG;IACb,kCAAkC;IAClC,yCAAyC;IACzC,4BAA4B;IAC5B,4CAA4C;IAC5C,yIAAyI;IACzI,6KAA6K;IAC7K,6DAA6D;IAC7D,mGAAmG;IACnG,yHAAyH;IACzH,GAAG;CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;iDAMiD;AACjD,MAAM,QAAQ,GAAG;IACf,8CAA8C;IAC9C,qFAAqF;IACrF,+BAA+B;IAC/B,GAAG;IACH,qFAAqF;IACrF,gBAAgB;IAChB,GAAG;CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;2EAI2E;AAC3E,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,IAAI,GAAG,eAAe,CAAC;QAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,OAAO,cAAc,CAAC;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5E,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/kpi.d.ts

@@ -0,0 +1,21 @@
+/** 共用位·收支口径（KPI）（#689 结构搬迁第三批：从 `src/render/views.ts` 拆来）。
+ *  KPI（转账除外）：count／expense／income／net 全 number。
+ *
+ *  `isTransfer`（转账不入收支统计：账本 `转账` 或分类 `转账/*`）**必须与本件的 `calcKpi` 同住一件**——
+ *  它是这条口径的唯一判地，`calcKpi`／`calcCategories`／`buildOverview`／`buildTrend` 四处都走它；
+ *  各写一份「算不算转账」就是两套口径（#683 §3.9）。
+ *
+ *  谁在用（指名）：
+ *    · `src/query/read.ts`——四条查询命令的 KPI 胶囊与查分类的占比（`calcKpi`）；
+ *    · `src/analysis/views.ts`——分类聚合／总览／对比／趋势（`calcKpi` ＋ `isTransfer`）。
+ *  两域在用它 ⇒ 住共用位（归属律 2）。 */
+import type { BillRow } from '../fetch/db.js';
+/** 这一行算不算转账（转账是同一笔钱换口袋，不入收支统计，余额另计）。 */
+export declare function isTransfer(r: BillRow): boolean;
+export declare function calcKpi(records: BillRow[]): {
+    count: number;
+    expense: number;
+    income: number;
+    net: number;
+};
+//# sourceMappingURL=kpi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kpi.d.ts","sourceRoot":"","sources":["../../src/shared/kpi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;2BAU2B;AAC3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAE9C;AAGD,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAU3G"}

package/dist/shared/kpi.js

@@ -0,0 +1,20 @@
+/** 这一行算不算转账（转账是同一笔钱换口袋，不入收支统计，余额另计）。 */
+export function isTransfer(r) {
+    return r.ledger === '转账' || r.category.startsWith('转账/');
+}
+// KPI（转账除外）：count/expense/income/net 全 number。
+export function calcKpi(records) {
+    const real = records.filter((r) => !isTransfer(r));
+    let expense = 0;
+    let income = 0;
+    for (const r of real) {
+        if (r.amount < 0)
+            expense += Math.abs(r.amount);
+        else
+            income += r.amount;
+    }
+    expense = Math.round(expense * 100) / 100;
+    income = Math.round(income * 100) / 100;
+    return { count: real.length, expense, income, net: Math.round((income - expense) * 100) / 100 };
+}
+//# sourceMappingURL=kpi.js.map

package/dist/shared/kpi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi.js","sourceRoot":"","sources":["../../src/shared/kpi.ts"],"names":[],"mappings":"AAaA,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,OAAO,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,OAAO,CAAC,OAAkB;IACxC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,OAAO,GAAG,CAAC,CAAC;IAAC,IAAI,MAAM,GAAG,CAAC,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;;YAC3C,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC1C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;AAClG,CAAC"}

package/dist/shared/pageIdentity.d.ts

@@ -0,0 +1,39 @@
+/** 页面三个公共标识 ＋ 场景名（**唯一定义地**）：文档版本／技能名／页面标题／`sceneKeyOf`。
+ *  整页装配的调用方与复制日志都读它，别处只引用、不另写这几个字面量（同一件事实两处就会走散）。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/write/`——写入域：结果型回执整页与过程型采集页的 envelope 三字段（其中 `key` 过 `sceneKeyOf`）、
+ *      复制日志版本、页标题前缀；`src/shared/writeParts.ts` 的 `writeSection` 取技能名做 `data-skill`；
+ *   ② `src/query/`——查询域：通用查询列表页的同一批取值（envelope 三字段、复制日志版本、页标题前缀）。
+ *  两域的页面内置 envelope 都拿本件的 `sceneKeyOf` 把对外命令名收成场景名（`bill.record.today` → `record.today`），
+ *      公共层的日志场景标识再与技能名拼回整名。
+ *
+ * 为什么另立一件：这三个取值是「页面是谁」那件活，与回执事实、`<section>` 段不是同一件事——
+ *  混在 `./writeParts.ts` 里会把那份的对外名字顶过五个（铁律五）。
+ */
+/** 文档版本（envelope 的 `version`，也是复制日志第 5 段后半）。 */
+export declare const DOC_VERSION = "0.1.0";
+/** 技能名（envelope 的 `skill`，也是 `<section>` 上 `data-skill` 的取值）。 */
+export declare const DOC_SKILL = "bill";
+/** 技能名（对外名；也是文档标题的站点名那一半，拼法见 `docTitleOf`）。 */
+export declare const DOC_TITLE = "\u997C\u5E72\u8BB0\u8D26";
+/** 文档标题（`<title>` 的文本）：`<这一页是什么> - <技能名>`。**本件是唯一拼法**。
+ *
+ *  为什么不是 `技能名·这一页`（t728 逐页判红的写法）：`·` 是**并列分隔符**，按 `#728` 的验收口径
+ *  （用户逐字要求：「当一个内容需要通过 `；`／`|`／`·` 分割时代表需要进行 UI 上的设计」）
+ *  出现在可见文本里即算设计债。而文档标题里的「页名 ＋ 站点名」**不是并列内容**——它就是标题写法
+ *  本身（先这一页是什么、再用连字符收站点名），故按标题惯例排，而不是拿并列符去串。
+ *  文档标题住 `<head>`、不进正文版面，因此这里只守标题写法，不参与页内版式。
+ *  一处定义：页名由调用方给（这一页是什么），站点名取本件的 `DOC_TITLE`；页名空白＝只出站点名。 */
+export declare function docTitleOf(what: string): string;
+/** 页面内置 envelope 的 `key`（＝**场景名**，技能内的本地名）。
+ *
+ * 为什么不是对外命令名：公共层的日志第 1 段（`scene`）由 envelope 派生，形如 `{skill}.{key}`
+ *  （`packages/base-render/src/text.ts:296-298` 的 `sceneText`）——`skill` 已是 `bill`，
+ *  这里再写一条带 `bill.` 前缀的整名，日志就会印成 `bill.bill.record.add`（两处都重复一遍）。
+ *  本件按公共层的分工收口：**页面内置 envelope 的 key＝本地场景名**（`bill.record.add` → `record.add`），
+ *  `skill` ＋ `key` 拼起来正好是对外命令名；`<section data-key>` **同写场景名**（R4 收口：`bill.` 只许出现在
+ *  复制载荷区，页面标记一律不带技能前缀），两处一个值，不再各写各的。
+ */
+export declare function sceneKeyOf(key: string): string;
+//# sourceMappingURL=pageIdentity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageIdentity.d.ts","sourceRoot":"","sources":["../../src/shared/pageIdentity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gDAAgD;AAChD,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,iEAAiE;AACjE,eAAO,MAAM,SAAS,SAAS,CAAC;AAEhC,+CAA+C;AAC/C,eAAO,MAAM,SAAS,6BAAS,CAAC;AAEhC;;;;;;;2DAO2D;AAC3D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C"}

package/dist/shared/pageIdentity.js

@@ -0,0 +1,45 @@
+/** 页面三个公共标识 ＋ 场景名（**唯一定义地**）：文档版本／技能名／页面标题／`sceneKeyOf`。
+ *  整页装配的调用方与复制日志都读它，别处只引用、不另写这几个字面量（同一件事实两处就会走散）。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/write/`——写入域：结果型回执整页与过程型采集页的 envelope 三字段（其中 `key` 过 `sceneKeyOf`）、
+ *      复制日志版本、页标题前缀；`src/shared/writeParts.ts` 的 `writeSection` 取技能名做 `data-skill`；
+ *   ② `src/query/`——查询域：通用查询列表页的同一批取值（envelope 三字段、复制日志版本、页标题前缀）。
+ *  两域的页面内置 envelope 都拿本件的 `sceneKeyOf` 把对外命令名收成场景名（`bill.record.today` → `record.today`），
+ *      公共层的日志场景标识再与技能名拼回整名。
+ *
+ * 为什么另立一件：这三个取值是「页面是谁」那件活，与回执事实、`<section>` 段不是同一件事——
+ *  混在 `./writeParts.ts` 里会把那份的对外名字顶过五个（铁律五）。
+ */
+/** 文档版本（envelope 的 `version`，也是复制日志第 5 段后半）。 */
+export const DOC_VERSION = '0.1.0';
+/** 技能名（envelope 的 `skill`，也是 `<section>` 上 `data-skill` 的取值）。 */
+export const DOC_SKILL = 'bill';
+/** 技能名（对外名；也是文档标题的站点名那一半，拼法见 `docTitleOf`）。 */
+export const DOC_TITLE = '饼干记账';
+/** 文档标题（`<title>` 的文本）：`<这一页是什么> - <技能名>`。**本件是唯一拼法**。
+ *
+ *  为什么不是 `技能名·这一页`（t728 逐页判红的写法）：`·` 是**并列分隔符**，按 `#728` 的验收口径
+ *  （用户逐字要求：「当一个内容需要通过 `；`／`|`／`·` 分割时代表需要进行 UI 上的设计」）
+ *  出现在可见文本里即算设计债。而文档标题里的「页名 ＋ 站点名」**不是并列内容**——它就是标题写法
+ *  本身（先这一页是什么、再用连字符收站点名），故按标题惯例排，而不是拿并列符去串。
+ *  文档标题住 `<head>`、不进正文版面，因此这里只守标题写法，不参与页内版式。
+ *  一处定义：页名由调用方给（这一页是什么），站点名取本件的 `DOC_TITLE`；页名空白＝只出站点名。 */
+export function docTitleOf(what) {
+    const page = what.trim();
+    return page === '' ? DOC_TITLE : page + ' - ' + DOC_TITLE;
+}
+/** 页面内置 envelope 的 `key`（＝**场景名**，技能内的本地名）。
+ *
+ * 为什么不是对外命令名：公共层的日志第 1 段（`scene`）由 envelope 派生，形如 `{skill}.{key}`
+ *  （`packages/base-render/src/text.ts:296-298` 的 `sceneText`）——`skill` 已是 `bill`，
+ *  这里再写一条带 `bill.` 前缀的整名，日志就会印成 `bill.bill.record.add`（两处都重复一遍）。
+ *  本件按公共层的分工收口：**页面内置 envelope 的 key＝本地场景名**（`bill.record.add` → `record.add`），
+ *  `skill` ＋ `key` 拼起来正好是对外命令名；`<section data-key>` **同写场景名**（R4 收口：`bill.` 只许出现在
+ *  复制载荷区，页面标记一律不带技能前缀），两处一个值，不再各写各的。
+ */
+export function sceneKeyOf(key) {
+    const prefix = DOC_SKILL + '.';
+    return key.startsWith(prefix) ? key.slice(prefix.length) : key;
+}
+//# sourceMappingURL=pageIdentity.js.map

package/dist/shared/pageIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageIdentity.js","sourceRoot":"","sources":["../../src/shared/pageIdentity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,iEAAiE;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;AAEhC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;AAEhC;;;;;;;2DAO2D;AAC3D,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACzB,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,GAAG,SAAS,CAAC;AAC5D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,MAAM,GAAG,SAAS,GAAG,GAAG,CAAC;IAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACjE,CAAC"}