skill-bill 0.2.0 → 0.2.2

package/dist/shared/copyArea.js

@@ -1,7 +1,7 @@
 /** 复制与提示共用件：复制 prompt 区、复制区（数据位＋日志位）、复制日志的入参。
  *
  * 谁在用（两个能力，指名）：
- *   ① `src/record/`——写入域：过程型采集页（复制 prompt 区 ＋ 复制数据／日志）与结果型回执整页（复制数据／日志）；
+ *   ① `src/write/`——写入域：过程型采集页（复制 prompt 区 ＋ 复制数据／日志）与结果型回执整页（复制数据／日志）；
  *   ② `src/query/`——查询域：通用查询列表页的复制数据／日志两条通道（不设 prompt 区——查询不写库，没有要交回助手的一句）。
  *  （写域 32 份产物按本件的字面量冻结，查询域只引用、不改这里的任何一句。）
  *
@@ -18,6 +18,7 @@
  *   - 日志第 3 段的库文件名**由调用方给**（`CopyLogInput.source`），共用件不取本包文件名
  *     （`docs/skills/skill-bill/t406-共用件依赖与提升改造清单.md` 第二节 `DB_FILENAME` 行）。
  */
+import { renderStatusBadge } from 'base-paint';
 import { renderCaliberLine, renderCopyBlock, renderEmptyBlock, renderPreBlock } from 'base-paint/blocks';
 import { buildDataText, buildLogText } from 'base-paint';
 /** 日志第 2 段（助手思考链）：本仓页面一律由本地 CLI 渲染，不落 `(未知)` 占位。 */
@@ -27,7 +28,7 @@ const LOG_EXCEPTION = '无';
 /** 复制区空态缺省句（三样全没给时出这一句、不出按钮——点了没反应的死按钮就是问题）。 */
 const COPY_EMPTY_TEXT = '本页没有可复制的数据';
 /** 本次执行时刻串（页面入参 `actionAt`／回执事实 `actionAt` 的**唯一定义地**）：本地时钟 `YYYY-MM-DD HH:MM:SS`。
- *  写域与查询域两张页都读它——搬迁前它分别是 `src/record/write.ts` 的文件级函数与查询域现取的钟，
+ *  写域与查询域两张页都读它——搬迁前它分别是 `src/write/write.ts` 的文件级函数与查询域现取的钟，
  *  第二个用法（查询域列表页，票 #411）长出来之后收成这一处；**取时钟仍在各域处理体那一步调它**，
  *  共用位不自己在模块顶层取时钟（那样一次调用两次读数会不一致）。 */
 export function actionStamp() {
@@ -41,6 +42,15 @@ const MENU_HINTS = ['纯文本 粘贴给助手或自己看', 'JSON 结构化存
  *  （总则②：写清这块复制走给谁；仍含老字串，护栏不断言全等只认包含）。 */
 const PROMPT_COPY_ACTION = 'ilife-copy-prompt';
 const PROMPT_COPY_HINT = '复制给助手：这一句可以直接复制';
+/** 页上那一行可见文本（#728 第二轮）。**prompt 原文不再摊在页面上。**
+ *
+ *  维护者 2026-09-19 逐字：「这个模板不应该把 prompt 内容给用户看，太繁杂了」。
+ *  实测那一块把整套模板平铺出来（`唤醒词：记分期` ＋ `总额：<总额>` 这类尖括号占位符 ＋
+ *  缺项逐条「没给：分期由用户定，不许默认」），390 档占三百多像素高；而 `唤醒词`／尖括号
+ *  占位符／「逐项补齐」都是**给助手看的实现词汇**，本不该上用户的屏（本仓「区外内部话」那条）。
+ *  改法：页上只留一句人话；**原文一字不改地走 `copyText` 进复制载荷**——
+ *  复制得到的还是原来那一整段，载荷文本没动。 */
+const PROMPT_PREVIEW = '点右边的按钮复制，发给助手就行。';
 /** ① 复制 prompt 区：prompt 预览（`renderPreBlock`）＋ 它自带的复制按钮。
  *  **`actionId` 必给**：公共层的 `renderPreBlock` 只在给了 `actionId` 时才渲染复制按钮
  *  （`packages/base-render/src/blocks.ts:729-736`），只给 `copyText` 会出一个「写着复制、其实没有按钮」的
@@ -50,7 +60,7 @@ export function promptCopyArea(prompt, label) {
     const heading = label === undefined ? PROMPT_COPY_HINT : label;
     return renderPreBlock({
         ...(heading === null ? {} : { label: heading }),
-        command: prompt,
+        command: PROMPT_PREVIEW,
         actionId: PROMPT_COPY_ACTION,
         copyText: prompt,
         copyLabel: PROMPT_COPY_HINT,
@@ -105,18 +115,27 @@ export function copyLog(input) {
 }
 /** 退出口那枚危险色出口标记的动作号。**故意不绑动作**：动作条场景按钮不带 `data-t`，点了不复制也不写库。 */
 const EXIT_MARK_ACTION = 'ilife-exit-undo';
-/** 退出口的标题与说明（本轮整改：`危险色出口` 是设计自指词，`restore` 是内部词，都不上屏）。 */
+/** 退出口的标题与说明（本轮整改：`危险色出口` 是设计自指词，`restore` 是内部词，都不上屏）。
+ *  t728：两句之间的 `；` 换成句号——分号在这里不是并列，是把两件事挤进一句的排版手法
+ *  （用户逐字要求 5 点名的那类）；拆成两句之后读法仍是「怎么做」＋「撤销之后会怎样」。 */
 const EXIT_TITLE = '想反悔（撤销这一笔）';
-const EXIT_NOTE = '要撤销这一笔，点下面那颗「复制数据」，里面带着一句撤销的话；撤销之后记录还在，随时可以恢复。';
-/** ④ 回执页退出口：危险色出口标记 ＋ 一句去向说明（t407 根因整改二 D2 去重后）。
- *  改前这里另带一枚「复制数据」（撤销指令直拷，`ilife-exit-undo-copy`）＋ base #336
- *  自动补的一枚置灰「复制日志」，与下面复制区那组「复制数据／复制日志」上下重复。
- *  改后退出口只留标记与说明、不带任何复制按钮与 `data-t`；撤销指令走下面复制区那颗
- *  「复制数据」（复制载荷里仍带可重跑命令，`data-t` 形状不动）。 */
+const EXIT_NOTE = '要撤销这一笔，点下面那颗「复制数据」，里面带着一句撤销的话。撤销之后记录还在，随时可以恢复。';
+/** ④ 回执页退出口：**一枚非交互的 danger 标记 ＋ 一句指路**（#733 改）。
+ *
+ * 改前这里是一颗 `kind: 'red'` 的 `<button>`（`data-action-id="ilife-exit-undo"`，**故意不带 `data-t`**），
+ *  而产物内联委派的第二道 `getAttribute('data-t') === null → return` 就早退 ⇒ **点了零动作、零反馈**；
+ *  1280 档它还是整页唯一一块 878×44 的满列实心高饱和红（最响的一块却不响应），
+ *  而正下方那行口径又写着「点下面那颗『复制数据』」——同屏两句互相否定（15 张回执页全中，逐页复现过）。
+ *
+ * 改法＝**照它本来的身份办**：它是一件「标记」，不是一颗按钮。现在渲染成
+ *  `renderStatusBadge(status:'danger')` 的一枚红胶囊（一眼就知道不是可点控件）＋ 那句指路口径。
+ *  顺带收掉两样债：① 满列红块没了（判据里的「整页最响的一块」）；② `docPage.ts` 里那条
+ *  专为「单钮独占整行」写的补丁（`EXIT_CSS`）随之失效，一并删掉。
+ *
+ * 为什么不做成「真能点」：本页下面复制区那颗「复制数据」的载荷里**已经带着**可重跑的撤销指令，
+ *  退出口再给一颗同样功能的按钮，就是同一件事两颗按钮（t410 拆掉过一次，不该拆回去）。 */
 export function undoExit(recordId) {
-    return renderCopyBlock({
-        title: EXIT_TITLE,
-        buttons: [{ label: '↩︎ 撤销这一笔', kind: 'red', actionId: EXIT_MARK_ACTION }],
-    }) + renderCaliberLine(EXIT_NOTE + '（记录编号 ' + recordId + '）');
+    return renderStatusBadge({ status: 'danger', text: EXIT_TITLE })
+        + renderCaliberLine(EXIT_NOTE + '（记录编号 ' + recordId + '）');
 }
 //# sourceMappingURL=copyArea.js.map

package/dist/shared/copyArea.js.map

@@ -1 +1 @@
-{"version":3,"file":"copyArea.js","sourceRoot":"","sources":["../../src/shared/copyArea.ts"],"names":[],"mappings":"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"}
+{"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":"AAAA;;;;;;;;;;;;;;2EAc2E;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;+CAC+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE9C,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,GAAG,GAAG,GAAG,mBAAmB,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,wDAAwD,CAAC;AACpF,MAAM,CAAC,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,yBAAyB,CAAC;AAElD,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAC/C,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACjF,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;IAClE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;IACpF,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;IAC9F,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAU,EAAE,KAAK,GAAG,MAAM;IACtD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,KAAK,GAAG,UAAU,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzD,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;IAC/G,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,KAAK,GAAG,OAAO;IACxD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;IAChE,CAAC;IACD,OAAQ,CAAY,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,MAA+B;IAC9D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;QAC5E,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;IAChG,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,IAAI,eAAe,CAAC,qBAAqB,EAAE,8BAA8B,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,GAAG;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,iBAAiB,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IACtG,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC;AAED;;;iEAGiE;AAEjE,sCAAsC;AACtC,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACzC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,GAAG,EAAE,EAAE,CAAC;AACzD,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACxF,CAAC"}

package/dist/shared/docPage.d.ts

@@ -11,7 +11,19 @@ interface DocPageInput {
     /** 已组合好的区块 HTML。 */
     readonly content: string;
 }
-/** 整页装配：区块 HTML ＋ 标题三件套 → 完整文档。 */
+/** 退出口单钮独占整行（t410 终审 n20）——**#733 起已撤，本段整体删掉，理由是它成了死 CSS**。
+ *
+ *  t410 当时落这条：`copyArea` 的退出口恒只有一颗红钮，而公共层 `.ilife-action-row` 恒两列，
+ *  单钮只占半格（390 下实测 175px），故用 `:has([data-action-id="ilife-exit-undo"])` 把它收成单列。
+ *  #733 把退出口那颗**点了没反应的红钮**换成一枚非交互的 danger 标记（`copyArea.undoExit` 的注释里有完整推导）⇒
+ *  `ilife-exit-undo` 这个动作号在产物里**一次都不再出现**，本段的两个选择器一条也命中不到。
+ *  留着的代价不是零：它会被 grep 进「页上还有没有这个动作号」这类判据，读的人会以为按钮还在。
+ *  一并删掉——**删的是失效的补丁，不是那条版面意图**（那颗钮已经不存在了）。 */
+/** 整页装配：区块 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

@@ -1 +1 @@
-{"version":3,"file":"docPage.d.ts","sourceRoot":"","sources":["../../src/shared/docPage.ts"],"names":[],"mappings":"AAgBA,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;AAwFD,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAY3D"}
+{"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;AAyED;;;;;;;8CAO8C;AAE9C;;;;2EAI2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAc3D"}

package/dist/shared/docPage.js

@@ -1,7 +1,7 @@
 /** 整页装配共用件：区块 HTML 拼成完整文档（最后一公里）。
  *
  * 谁在用（两个能力，指名）：
- *   ① `src/record/`——写入域：结果型回执整页与过程型采集页；
+ *   ① `src/write/`——写入域：结果型回执整页与过程型采集页；
  *   ② `src/query/`——查询域：通用查询列表页。
  *  两域走的都是 `./pageShell.ts` 那一层，本件是它下面的文档装配层。
  *
@@ -9,38 +9,48 @@
  *   内容＝`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 { blocksCss, renderPageShell } from 'base-paint/blocks';
-import { buildSharedHelpersJs, buildStyleSheet, fillTemplate } from 'base-paint';
-/** 整页模板（裸标记＋CONTENT 槽；`wrap ilife-page` 兼容既有 `--html` 断言）。
- *  标记不得预包裹：资产由 `fillTemplate` 按 `ASSET_WRAPPERS` 自己包。 */
-function docShell(docTitle) {
-    return '<!DOCTYPE html>\n<html lang="zh-CN">\n<head>\n<meta charset="utf-8">\n'
-        + '<meta name="viewport" content="width=device-width,initial-scale=1">\n'
-        + '<title>' + docTitle + '</title>\n<!--SHARED-CSS-->\n</head>\n<body>\n'
-        + '<div class="wrap ilife-page">\n<!--CONTENT-->\n</div>\n<!--SHARED-HELPERS-->\n'
-        + '</body>\n</html>';
-}
-/** 桌面端补丁（t407 根因整改二 D1：内容列用满宽＋卡片网格换大格，只改呈现）。
+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` 的 ⑧／⑪ 段出，本包不再各写一条宽度数字。
  *
- * 为什么落在本件：公共层样式（`base-paint`）不许动，本页 body 后也不加样式块
- * （机审「本页样式块／内联样式」两列要保持 0）；唯一的落点就是本件拼 `sharedCssText`
- * 的这一处——32 份产物走同一条代码路径，head 样式仍 32/32 同一份。
- * 只在 `@media (min-width:1200px)` 里生效：手机端（`≤640px` 两列那档）一行不动，
- * 复量不得回退（见证据件）。 */
+ *  唯一留下的一条：公共层 `.ilife-block-data-table` 锁着 `max-width:680px` 居中，880 正文列下
+ *  右约 100px 留白（t403 视觉验收 D1 的同一处）；那个选择器由公共层产出、但**只在本包这两域**
+ *  需要放开（公共层自己在别的调用点仍要 680 的窄表），故按「样式随它的选择器」的例外档留在这里，
+ *  并且**只写选择器与属性、零字面色值、零新断点**（1200 是仓内既有值）。 */
 const DESKTOP_CSS = [
-    '/* t407-D1：桌面端内容列与卡片网格（只 1200px 以上生效，手机端不动） */',
+    '/* t728：桌面端表格用满正文列（只 1200px 以上生效，手机端不动） */',
     '@media (min-width:1200px) {',
-    '  .ilife-block-page-shell { max-width: 1120px; }',
-    '  .ilife-block-page-shell .ilife-block-kpi-card-grid { grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); }',
-    /* t403-P1：桌面端数据表与内容列同宽（只 1200px 以上生效，手机端不动）。
-     *  为什么落在本件：公共层 `base-paint` 的 `.ilife-block-data-table` 锁 `max-width:680px` 居中，
-     *  1120 版心下右约 40% 留白、密集页被迫折行（t403 视觉验收 D1）；base 包只建议不动，唯一的落点
-     *  就是本件拼 `sharedCssText` 的这一处（与上面 D1 同一条路）。查询域列表／详情与写入域回执
-     *  同走本件，两域的表同宽；`≤640px` 行卡化那档一行不动。 */
     '  .ilife-block-page-shell .ilife-block-data-table { max-width: none; }',
     '}',
+    '/* t728 逐页审计实测：公共层配方 ⑧ 的「宽件满铺」那条写的是',
+    '   `.ilife-block-page-shell-body > :where(读数卡网格／表／图／…){ grid-column: 1 / -1 }`，',
+    '   而本包的 DOM 是 `page-shell-body > section.ilife-write > section#sec-kpi > div.读数卡网格`',
+    '   ——宽件隔着 `section.ilife-write` 这一层，成了**孙级**，`>` 一个都匹配不到 ⇒',
+    '   全部落回「中间 880 列」，1280 档两翼逐点扫描非背景像素 0 行（内容墨迹最外沿 x174–1105）。',
+    '   修法：让这层纯分组的包裹节从布局里退场（`display: contents`），宽件重新成为栅格项。',
+    '   它挂在**本包产出的选择器**上（`.ilife-write` 由 `src/shared/writeParts.ts` 出），',
+    '   所以按「样式随它的选择器」住本件，公共层不认这个类名。 */',
+    '@media (min-width: 1001px) {',
+    '  .ilife-block-page-shell-body > .ilife-write { display: contents; }',
+    '}',
 ].join('\n');
 /** 手机端黑底说明块补丁（t407 第 3 轮返工 B；与上面 D1 同一处、同一条路）。
  *
@@ -49,63 +59,65 @@ const DESKTOP_CSS = [
  *    ① 两栏不等高——标题折了行、胶囊只有一行，整条横幅一边高一边矮（评审判「栏高不齐把整页拖重」）；
  *    ② 行距偏紧——标题行贴着下面那几行说明，只隔 2px。
  *  只动呈现：两栏拉到同高（`stretch` ＋ 胶囊内的字居中对齐）、标题与说明的行距统一到 1.5 以上、
- *  标题行与说明之间留 6px。文字、块序、复制载荷一处不动；公共层样式仍不许动，落点仍只在本件。 */
+ *  标题行与说明之间留 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: 10px; }',
+    '.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` 恒取列头、无逐行标签选项，
- *  base 包只建议不动；本页 body 后也不加样式块（机审「本页样式块／内联样式」两列要保持 0），
- *  唯一的落点就是本件拼 `sharedCssText` 的这一处（与上面 D1／TOAST 同一条路）。
+ *  唯一的落点就是本件交 `extraCss` 的这一处（与上面 DESKTOP／TOAST 同一条路）。
  *  桌面端（≥641px）只见表格、移动端（≤640px）只见键值列表——两者由 `display` 切换，
- *  每端恰出一套（读屏器同 CSS 一起切，不存在两套同读）；打印走桌面那一套。 */
+ *  每端恰出一套（读屏器同 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 rgba(210, 210, 215, .6); }',
+    '  .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 半宽）。
+/** 退出口单钮独占整行（t410 终审 n20）——**#733 起已撤，本段整体删掉，理由是它成了死 CSS**。
  *
- *  根因在公共层（`base-render` 的 `.ilife-action-row` 恒两列，单钮只占半格），本包不许动公共层
- *  （#567 在途），落点只能是本件拼 `sharedCssText` 的这一处（与上面 D1／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 ＋ 标题三件套 → 完整文档。 */
+ *  t410 当时落这条：`copyArea` 的退出口恒只有一颗红钮，而公共层 `.ilife-action-row` 恒两列，
+ *  单钮只占半格（390 下实测 175px），故用 `:has([data-action-id="ilife-exit-undo"])` 把它收成单列。
+ *  #733 把退出口那颗**点了没反应的红钮**换成一枚非交互的 danger 标记（`copyArea.undoExit` 的注释里有完整推导）⇒
+ *  `ilife-exit-undo` 这个动作号在产物里**一次都不再出现**，本段的两个选择器一条也命中不到。
+ *  留着的代价不是零：它会被 grep 进「页上还有没有这个动作号」这类判据，读的人会以为按钮还在。
+ *  一并删掉——**删的是失效的补丁，不是那条版面意图**（那颗钮已经不存在了）。 */
+/** 整页装配：区块 HTML ＋ 标题三件套 → 完整文档（文档壳交公共层骨架件）。
+ *
+ *  `pageUi: true` —— 本包 32 页走公共层页面级配方（#525）；配套的样式段由本件拼进 `extraCss`
+ *  （与卡路里同一条路：配方 CSS 走 `extraCss`，`blocksCss()` 仍走 `sharedCssText`）。
+ *  产出物有 `.ilife-page-ui` 根类与 `viewport-fit=cover` 两处可见证据，判据 9 的量测就量这两处。 */
 export function assembleDocPage(input) {
-    const assets = {
-        sharedCssText: buildStyleSheet().css + '\n' + blocksCss() + '\n' + DESKTOP_CSS + '\n' + TOAST_CSS + '\n' + KV_CSS + '\n' + EXIT_CSS,
-        sharedHelpersJs: buildSharedHelpersJs(),
-    };
     const body = renderPageShell({
         title: input.title,
         ...(input.eyebrow ? { eyebrow: input.eyebrow } : {}),
         ...(input.subtitle ? { subtitle: input.subtitle } : {}),
         content: input.content,
     });
-    return fillTemplate({ template: docShell(input.docTitle), assets, content: body }).html;
+    return renderDocShell({
+        docTitle: input.docTitle,
+        bodyHtml: body,
+        extraCss: [DESKTOP_CSS, TOAST_CSS, KV_CSS, pageUiCss()].join('\n'),
+        doctypeCase: 'upper',
+        pageUi: true,
+    });
 }
 //# sourceMappingURL=docPage.js.map

package/dist/shared/docPage.js.map

@@ -1 +1 @@
-{"version":3,"file":"docPage.js","sourceRoot":"","sources":["../../src/shared/docPage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgBjF;yDACyD;AACzD,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,wEAAwE;UAC3E,uEAAuE;UACvE,SAAS,GAAG,QAAQ,GAAG,gDAAgD;UACvE,gFAAgF;UAChF,kBAAkB,CAAC;AACzB,CAAC;AAED;;;;;;mBAMmB;AACnB,MAAM,WAAW,GAAG;IAClB,gDAAgD;IAChD,6BAA6B;IAC7B,kDAAkD;IAClD,uHAAuH;IACvH;;;;0CAIsC;IACtC,wEAAwE;IACxE,GAAG;CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;;sDAOsD;AACtD,MAAM,SAAS,GAAG;IAChB,4CAA4C;IAC5C,oCAAoC;IACpC,yFAAyF;IACzF,mHAAmH;IACnH,yJAAyJ;IACzJ,0CAA0C;CAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;;6CAO6C;AAC7C,MAAM,MAAM,GAAG;IACb,kCAAkC;IAClC,yCAAyC;IACzC,4BAA4B;IAC5B,4CAA4C;IAC5C,yIAAyI;IACzI,yLAAyL;IACzL,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,mCAAmC;AACnC,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,MAAM,GAAG;QACb,aAAa,EAAE,eAAe,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ;QACnI,eAAe,EAAE,oBAAoB,EAAE;KACxC,CAAC;IACF,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,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC1F,CAAC"}
+{"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;IACH,qCAAqC;IACrC,iFAAiF;IACjF,qFAAqF;IACrF,4DAA4D;IAC5D,6DAA6D;IAC7D,wDAAwD;IACxD,qEAAqE;IACrE,mCAAmC;IACnC,8BAA8B;IAC9B,sEAAsE;IACtE,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;;;;;;;8CAO8C;AAE9C;;;;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,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAClE,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

@@ -2,7 +2,7 @@
  *  整页装配的调用方与复制日志都读它，别处只引用、不另写这几个字面量（同一件事实两处就会走散）。
  *
  * 谁在用（两个能力，指名）：
- *   ① `src/record/`——写入域：结果型回执整页与过程型采集页的 envelope 三字段（其中 `key` 过 `sceneKeyOf`）、
+ *   ① `src/write/`——写入域：结果型回执整页与过程型采集页的 envelope 三字段（其中 `key` 过 `sceneKeyOf`）、
  *      复制日志版本、页标题前缀；`src/shared/writeParts.ts` 的 `writeSection` 取技能名做 `data-skill`；
  *   ② `src/query/`——查询域：通用查询列表页的同一批取值（envelope 三字段、复制日志版本、页标题前缀）。
  *  两域的页面内置 envelope 都拿本件的 `sceneKeyOf` 把对外命令名收成场景名（`bill.record.today` → `record.today`），
@@ -15,8 +15,17 @@
 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}`

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

@@ -1 +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,kCAAkC;AAClC,eAAO,MAAM,SAAS,6BAAS,CAAC;AAEhC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C"}
+{"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"}