skill-calorie 0.2.3 → 0.2.5

package/dist/shared/operationHead.js

@@ -0,0 +1,73 @@
+/** #422 · 回执四态头（技能层共用件）：`create`／`add`／`update`／`delete` 四态的**标签／色档／图标**
+ *  三张表只在本文件定义一处；回执页族与读页族一律引用本件，不再各写一份。
+ *
+ * 老实物出处（逐值）：`D:\2Study\StudyNotes\SKILLS\卡路里\templates\crud_receipt.html:192-197`
+ * 的三张表加一个回退——`opLabels = {add:'新增', create:'新增', update:'修改', delete:'删除'}`、
+ * `opColors = {add:'good', create:'good', update:'warn', delete:'bad'}`、
+ * `opIcons = {add:'✓', create:'✓', update:'✎', delete:'✕'}`、`opLabel = opLabels[op] || op`。
+ * 老表 `good`／`bad` 两档在本仓公共层叫 `ok`／`danger`（`base-paint` 的 `StatusKind` 四值
+ * `ok／warn／danger／empty`），故色档表逐格对到公共层的档名，**本件不写任何色值**：
+ * 颜色由公共层 `renderStatusBadge` 的 `ilife-status-badge-<档>` 承担（样式单源住 `packages/base-render/`）。
+ *
+ * 分工：本件只出**操作卡头部**（图标＋状标签徽章＋标题＋记录号＋时刻行）；
+ * 结构词（记录号／未设置）住本件，域词（标题、时刻行里的来源句）一律由调用方给——不给默认标题、
+ * 不给默认来源，免得哪一页悄悄用了别域的说法。
+ */
+import { STYLE_PREFIX, escapeHtml, renderStatusBadge } from 'base-paint';
+import { CalorieRenderError } from '../render/errors.js';
+/** 状标签表（老实物 `opLabels` 逐值）。 */
+export const OPERATION_LABELS = Object.freeze({
+    create: '新增',
+    add: '新增',
+    update: '修改',
+    delete: '删除',
+});
+/** 色档表（老实物 `opColors` 逐格对到公共层档名：good→ok、bad→danger）。 */
+export const OPERATION_TONES = Object.freeze({
+    create: 'ok',
+    add: 'ok',
+    update: 'warn',
+    delete: 'danger',
+});
+/** 图标表（老实物 `opIcons` 逐值）。 */
+export const OPERATION_ICONS = Object.freeze({
+    create: '✓',
+    add: '✓',
+    update: '✎',
+    delete: '✕',
+});
+/** 表外 op 的图标占位（标签回原 op 字串、色档回 `empty`，与老实物 `|| op` 同口径）。 */
+const OP_FALLBACK_ICON = '·';
+function reqText(value, field) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new CalorieRenderError('bad-input', field + ' 必须是非空字符串（本件不给默认文案）');
+    }
+    return value;
+}
+/** 操作卡头部：图标 ＋ 状标签（色档徽章）＋ 标题 ＋ 记录号 ＋ 时刻行。 */
+export function operationHead(input) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new CalorieRenderError('bad-input', 'operationHead: input 必须是对象');
+    }
+    const head = input;
+    const title = reqText(head.title, 'operationHead: input.title');
+    const actionAt = reqText(head.actionAt, 'operationHead: input.actionAt');
+    const recordId = head.recordId;
+    if (recordId !== null && !Number.isInteger(recordId)) {
+        throw new CalorieRenderError('bad-input', 'operationHead: input.recordId 须为整数或 null');
+    }
+    const op = typeof head.op === 'string' ? head.op : '';
+    const label = OPERATION_LABELS[op] ?? op;
+    const tone = OPERATION_TONES[op] ?? 'empty';
+    const icon = OPERATION_ICONS[op] ?? OP_FALLBACK_ICON;
+    const source = typeof head.source === 'string' && head.source !== '' ? head.source : undefined;
+    const cls = STYLE_PREFIX + 'block-op-head';
+    return '<div class="' + cls + ' ' + cls + '-' + tone + '">'
+        + '<span class="' + cls + '-icon" aria-hidden="true">' + escapeHtml(icon) + '</span>'
+        + renderStatusBadge({ status: tone, text: label })
+        + '<h2 class="' + cls + '-title">' + escapeHtml(title) + '</h2>'
+        + '<p class="' + cls + '-id">记录号 ' + (recordId === null ? '未设置' : '#' + recordId) + '</p>'
+        + '<p class="' + cls + '-time">' + escapeHtml(source === undefined ? actionAt : actionAt + ' · ' + source) + '</p>'
+        + '</div>';
+}
+//# sourceMappingURL=operationHead.js.map

package/dist/shared/operationHead.js.map

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

package/dist/shared/pageKit.d.ts

@@ -0,0 +1,25 @@
+/** 形状清单：左＝这处债长什么样，右＝用哪件（形状名逐字即 `base-paint` 的出口名）。
+ *  这份表是**照抄指引的机器可读版**，与交付件 `docs/skills/skill-calorie/t525-共享形状与样板页.md`
+ *  的同名一节同源；改一处要两处一起改（本件是唯一代码侧落点）。 */
+export declare const SHAPES: Readonly<{
+    '\u6807\u7B7E\u4E32\uFF08`\u00B7` \u8FDE\u7684\u591A\u4E2A\u6807\u7B7E\uFF09': "renderChips";
+    '\u6539\u524D\u6539\u540E\uFF08\u4E24\u5217\u4E8B\u5B9E\uFF09': "renderChangeRows";
+    '\u4E00\u53E5\u5224\u8BED\uFF0B\u4E8B\u5B9E': "renderConclusionBar";
+    '\u4E00\u884C N \u4EF6\u4E8B\uFF08\u62CD\u6444\u65F6\u95F4\uFF0F\u5929\u6570\uFF0F\u6807\u7B7E\uFF0F\u6587\u4EF6\u540D\u8FD9\u7C7B\u4E32\uFF09': "renderFactStrip";
+    分布与占比: "renderDistributionRows";
+    左中右三槽的行: "renderListRows";
+    '\u65F6\u95F4\u7EBF\uFF08\u65F6\u95F4\uFF0B\u505A\u4E86\u4EC0\u4E48\uFF09': "renderTimelineRows";
+    '\u8BFB\u6570\u5361\uFF08\u7EAF\u6570\u5B57\u6210\u7EC4\uFF09': "renderKpiGrid";
+    '\u5C0F\u8868\uFF08\u5217\u5C11\u7684\u5BF9\u7167\uFF09': "renderDataTable";
+    页内导航: "renderTocBlock";
+    口径说明: "renderCaliberLine";
+    '\u56FE\u7247\u4E0E GIF': "renderMediaFigure";
+    原始命令与机器载荷: "payloadFold";
+}>;
+/** 页面基础样式段（与 `assembleDocPage` 的拼法逐字同源）：`buildStyleSheet()` ＋ `blocksCss()`，
+ *  `pageUi` 为真时再追加移动端配方与三件形状的样式。**别在页面里另拼样式**——这里已经是全部。 */
+export declare function pageBaseCss(pageUi: boolean): string;
+/** 机器载荷的折叠呈现：一行人话标题 ＋ 折起的原始命令（含一颗「复制指令」）。
+ *  正文里不再平铺 `calorie-cmd-read …` 那种长串——读者要照抄时点开即可，先看人话。 */
+export declare function payloadFold(title: string, command: string, copyLabel?: string): string;
+//# sourceMappingURL=pageKit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageKit.d.ts","sourceRoot":"","sources":["../../src/shared/pageKit.ts"],"names":[],"mappings":"AAmBA;;qCAEqC;AACrC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;EAcjB,CAAC;AAEH;2DAC2D;AAC3D,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAGnD;AAED;0DAC0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAUtF"}

package/dist/shared/pageKit.js

@@ -0,0 +1,56 @@
+/** #525 · 卡路里页面共用件：四张下游票的**唯一取形状处**（场景 09 的读侧／过程与结果／回执／HELP）。
+ *
+ *  谁在用（写得出哪两个在用）：**卡路里**的整页装配族（`src/shared/docPage.ts` 的调用方——今天的
+ *  `src/photo/photo.ts` 与 `src/render/wizardPortDocs.ts`；本票的样板页 `.scratch/t525/` 先用）。
+ *  四张下游票（#526 读侧／#527 过程与结果／#528 回执／#529 HELP）照抄本件，不再各写一套。
+ *
+ *  本件**不造形状**：形状全在 `base-paint` 里（12 个区块 ＋ #421 四件 ＋ #525 三件）。
+ *  本件只做两件事：
+ *   ① 把「哪件债该变成什么形状」收成一份**可照抄的清单**（下面的 `SHAPES`，一个名字对一处场景），
+ *      并给出「样式段怎么拼」与「机器载荷怎么降级」这两条页面级做法；
+ *   ② 把 `pageUi` 这一位的取用口径收在一处（`pageBaseCss`），免得四票各拼一遍样式。
+ *
+ *  **不许照抄的两件事**：① 不要把可复制的原始命令／载荷平铺进正文（用 `payloadFold`）；
+ *  ② 不要在页面里写字号、内距、色值——版面单源在 `base-paint`，页面里一条都不许有。
+ */
+import { buildStyleSheet } from 'base-paint';
+import { blocksCss, renderDisclosure, renderPreBlock } from 'base-paint/blocks';
+import { pageShapeCss, pageUiCss } from 'base-paint';
+/** 形状清单：左＝这处债长什么样，右＝用哪件（形状名逐字即 `base-paint` 的出口名）。
+ *  这份表是**照抄指引的机器可读版**，与交付件 `docs/skills/skill-calorie/t525-共享形状与样板页.md`
+ *  的同名一节同源；改一处要两处一起改（本件是唯一代码侧落点）。 */
+export const SHAPES = Object.freeze({
+    '标签串（`·` 连的多个标签）': 'renderChips',
+    '改前改后（两列事实）': 'renderChangeRows',
+    '一句判语＋事实': 'renderConclusionBar',
+    '一行 N 件事（拍摄时间／天数／标签／文件名这类串）': 'renderFactStrip',
+    '分布与占比': 'renderDistributionRows',
+    '左中右三槽的行': 'renderListRows',
+    '时间线（时间＋做了什么）': 'renderTimelineRows',
+    '读数卡（纯数字成组）': 'renderKpiGrid',
+    '小表（列少的对照）': 'renderDataTable',
+    '页内导航': 'renderTocBlock',
+    '口径说明': 'renderCaliberLine',
+    '图片与 GIF': 'renderMediaFigure',
+    '原始命令与机器载荷': 'payloadFold',
+});
+/** 页面基础样式段（与 `assembleDocPage` 的拼法逐字同源）：`buildStyleSheet()` ＋ `blocksCss()`，
+ *  `pageUi` 为真时再追加移动端配方与三件形状的样式。**别在页面里另拼样式**——这里已经是全部。 */
+export function pageBaseCss(pageUi) {
+    return buildStyleSheet().css + '\n' + blocksCss()
+        + (pageUi ? '\n' + pageUiCss() + '\n' + pageShapeCss() : '');
+}
+/** 机器载荷的折叠呈现：一行人话标题 ＋ 折起的原始命令（含一颗「复制指令」）。
+ *  正文里不再平铺 `calorie-cmd-read …` 那种长串——读者要照抄时点开即可，先看人话。 */
+export function payloadFold(title, command, copyLabel) {
+    return renderDisclosure({
+        title,
+        contentHtml: renderPreBlock({
+            command,
+            ...(copyLabel === undefined ? {} : { label: copyLabel }),
+            actionId: 'ilife-help-copy-prompt',
+            copyText: command,
+        }),
+    });
+}
+//# sourceMappingURL=pageKit.js.map

package/dist/shared/pageKit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageKit.js","sourceRoot":"","sources":["../../src/shared/pageKit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD;;qCAEqC;AACrC,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,iBAAiB,EAAE,aAAa;IAChC,YAAY,EAAE,kBAAkB;IAChC,SAAS,EAAE,qBAAqB;IAChC,4BAA4B,EAAE,iBAAiB;IAC/C,OAAO,EAAE,wBAAwB;IACjC,SAAS,EAAE,gBAAgB;IAC3B,cAAc,EAAE,oBAAoB;IACpC,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,iBAAiB;IAC9B,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,mBAAmB;IAC3B,SAAS,EAAE,mBAAmB;IAC9B,WAAW,EAAE,aAAa;CAC3B,CAAC,CAAC;AAEH;2DAC2D;AAC3D,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,OAAO,eAAe,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,EAAE;UAC7C,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,EAAE,GAAG,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;0DAC0D;AAC1D,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,OAAe,EAAE,SAAkB;IAC5E,OAAO,gBAAgB,CAAC;QACtB,KAAK;QACL,WAAW,EAAE,cAAc,CAAC;YAC1B,OAAO;YACP,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACxD,QAAQ,EAAE,wBAAwB;YAClC,QAAQ,EAAE,OAAO;SAClB,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/pageStrips.d.ts

@@ -0,0 +1,81 @@
+/** 窗口条的类名词汇（族给）。 */
+export interface WindowVocab {
+    readonly window: string;
+    readonly date: string;
+    readonly arrow: string;
+    readonly days: string;
+}
+/** 事实条的类名词汇（族给）。 */
+export interface FactVocab {
+    readonly facts: string;
+    readonly fact: string;
+    readonly key: string;
+    readonly value: string;
+}
+/** 三族的类名词汇表（**唯一一份**；各族形状件从这里取自己那一套）。 */
+export declare const WINDOW_VOCAB: {
+    readonly exercise: {
+        readonly window: "sui-window";
+        readonly date: "sui-date";
+        readonly arrow: "sui-arrow";
+        readonly days: "sui-days";
+    };
+    readonly weight: {
+        readonly window: "wui-window";
+        readonly date: "wui-date";
+        readonly arrow: "wui-arrow";
+        readonly days: "wui-days";
+    };
+    readonly diet: {
+        readonly window: "dui-window";
+        readonly date: "dui-date";
+        readonly arrow: "dui-arrow";
+        readonly days: "dui-chip";
+    };
+};
+/** 三族的类名词汇表（事实条只有运动族与体重族在用；饮食族不产事实条）。 */
+export declare const FACT_VOCAB: {
+    readonly exercise: {
+        readonly facts: "sui-facts";
+        readonly fact: "sui-fact";
+        readonly key: "sui-fact-k";
+        readonly value: "sui-fact-v";
+    };
+    readonly weight: {
+        readonly facts: "wui-strip";
+        readonly fact: "wui-fact";
+        readonly key: "wui-fact-k";
+        readonly value: "wui-fact-v";
+    };
+};
+/** 窗口条：`2026-09-01 → 2026-09-07` ＋ 天数（或条数）胶囊。
+ *
+ *  `start === end`（单日窗）只出一枚日期块、不出箭头，块内写「（单日）」——不替读者断言一个
+ * 不存在的跨度（#510 立的退化分支，三族同口径）。日期文本走 `escapeHtml`。 */
+export declare function windowStrip(start: string, end: string, chipText: string | undefined, vocab: WindowVocab): string;
+/** 事实条：一组「标签 ＋ 值」。`v` 为空串的那一条整条不出（缺值不留空槽）。
+ *
+ *  `variant` 三位是**落点**不是形状（见 `variantClasses`）。 */
+export declare function factStrip(facts: ReadonlyArray<{
+    k: string;
+    v: string;
+}>, vocab: FactVocab, variant?: {
+    readonly vertical?: boolean;
+    readonly gap?: boolean;
+    readonly asNote?: boolean;
+}): string;
+/** 窗口条的 CSS（**裸串，不带 `<style>` 标签**；三族逐值保留各自的几何）。
+ *
+ *  体重族与饮食族取值相同，只类名前缀不同。本函数产出的是一段可直接拼进族样式段的字符串。 */
+export declare function windowStripCss(): string;
+/** 事实条的 CSS（**裸串，不带 `<style>` 标签**）。
+ *
+ *  **本票唯一一处可见版式变更落在这里**：体重族的容器从「一行横排（`flex-wrap:wrap`）」改成
+ *  「等宽小格（`auto-fit` 栅格、窄屏塌单列）」——正本取运动族那套（票面 §二、§六 第 1 条，用户已授权）。
+ *  类名与其余属性（字号／色／权重）一律不动：体重族那三个变体位（`-v`／`-gap`／`-note`）的原规则
+ *  也逐值保留，故 `wui-strip-v` 的纵列版式与 `wui-strip-note` 的脚注口气字**一行未改**。
+ *
+ *  体重族与运动族的**键／值两小格在桌面档的取向不同**（运动族「键上值下」，体重族「键值同行」），
+ *  故 `.wui-fact` 不给 `flex-direction:column`；到了窄屏两族同归「键贴左、值贴右的纵列」。 */
+export declare function factStripCss(): string;
+//# sourceMappingURL=pageStrips.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageStrips.d.ts","sourceRoot":"","sources":["../../src/shared/pageStrips.ts"],"names":[],"mappings":"AA8BA,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,yCAAyC;AACzC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;CAIuB,CAAC;AAEjD,yCAAyC;AACzC,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAGuB,CAAC;AAqB/C;;;mDAGmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAWhH;AAED;;mDAEmD;AACnD,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9C,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/F,MAAM,CAOR;AAED;;kDAEkD;AAClD,wBAAgB,cAAc,IAAI,MAAM,CAiCvC;AAED;;;;;;;;qEAQqE;AACrE,wBAAgB,YAAY,IAAI,MAAM,CAsCrC"}

package/dist/shared/pageStrips.js

@@ -0,0 +1,166 @@
+/** #719 · 页内两类形状的**唯一定义地**：**窗口条**与**事实条**。
+ *
+ * 为什么收在这里：这两类形状原先在三个能力族里各写一份（窗口条四份、事实条两份），
+ * 实测「函数体逐字同构、只差 CSS 类名前缀与几处几何值」——任何一处单独改动都会与另外几份漂移。
+ * 故按 `docs/agents/structure.md` 铁律二（概念唯一）收成一份：形状的拼装只写一次，
+ * 「族用什么类名」（`WindowVocab`／`FactVocab`）与「几处几何值」（下面两段 CSS 里的逐值差异）由族参数给。
+ *
+ * 谁在用（写得出哪两个能力在用）：**运动族**（`src/exercise/sportUi.ts`）、**体重族**
+ * （`src/weight/weightUi.ts`，经 `src/goal/goalWeightDoc.ts` 与 `src/weight/plateDocs.ts` 间接使用）、
+ * **饮食族**（`src/diet/dietUi.ts`）。三族各自的形状件留一行包装并转出原名字，
+ * 调用方一行不动（既有 34 个文件的 import 与 65 处调用点全部原样）。
+ *
+ * ── 类名不统一，是**故意的** ──
+ * `sui-`／`wui-`／`dui-` 三套类名是既有**外部契约**：包内十余个测试件按字面断言它们
+ * （`sui-window`／`sui-facts`／`sui-fact-k`／`wui-strip`／`wui-strip-v`／`wui-strip-note`／
+ * `dui-window` 等）。统一类名会把十几件测试一起打红，而本票的红线之一是「测试只在外部行为上说话、
+ * 不为了绿而改断言」。故共用件收的是**形状的拼装逻辑**，不是类名。
+ *
+ * ── 几何值也不统一，同样是**故意的** ──
+ * 三族的圆角／内距／外边距逐值不同（日期块圆角 `8px` vs `10px`、内距 `4px 8px` vs `3px 9px`、
+ * 条外边距 `4px 0 16px` vs `2px 0 10px`、窄屏日期块内距 `8px 12px` vs `6px 10px`）。
+ * 那些不是随手写的，是各次视觉裁定落下的值；把它们统一＝改三族外观，超出本票授权。
+ * 故两段 CSS 里按族逐值保留（体重族与饮食族除类名外**取值相同**，一行对齐即可）。
+ *
+ * 本件不取数、不取时钟、不出现任何一个能力目录的名字。
+ */
+import { escapeHtml } from 'base-paint';
+const esc = (s) => escapeHtml(s);
+/** 三族的类名词汇表（**唯一一份**；各族形状件从这里取自己那一套）。 */
+export const WINDOW_VOCAB = {
+    exercise: { window: 'sui-window', date: 'sui-date', arrow: 'sui-arrow', days: 'sui-days' },
+    weight: { window: 'wui-window', date: 'wui-date', arrow: 'wui-arrow', days: 'wui-days' },
+    diet: { window: 'dui-window', date: 'dui-date', arrow: 'dui-arrow', days: 'dui-chip' },
+};
+/** 三族的类名词汇表（事实条只有运动族与体重族在用；饮食族不产事实条）。 */
+export const FACT_VOCAB = {
+    exercise: { facts: 'sui-facts', fact: 'sui-fact', key: 'sui-fact-k', value: 'sui-fact-v' },
+    weight: { facts: 'wui-strip', fact: 'wui-fact', key: 'wui-fact-k', value: 'wui-fact-v' },
+};
+/** 事实条容器／小格的附加类（体重族三个专用变体位；**不进共用件接口**，只作内部附加类串）。
+ *
+ *  `vertical` → `<facts>-v`：整块恒纵列；`gap` → `<facts>-gap`：整块与上一件之间空一行；
+ *  `asNote` → `<facts>-note`：值退成脚注口气的字。三者的名字都从 `facts` 类派生
+ *  （`wui-strip` → `wui-strip-v`／`-gap`／`-note`），运动族的 `facts` 是 `sui-facts` 故给了也不出
+ *  ——运动族的三个调用点从不给这三个位。
+ *
+ *  **顺序固定 `facts` → `-v` → `-gap` → `-note`**：既有测试件按字面断言 `wui-strip-v`／
+ *  `wui-strip-note`，且原实现就是这个顺序，重排会让产物变形。 */
+function variantClasses(vocab, v) {
+    return (v.vertical === true ? ' ' + vocab.facts + '-v' : '')
+        + (v.gap === true ? ' ' + vocab.facts + '-gap' : '')
+        + (v.asNote === true ? ' ' + vocab.facts + '-note' : '');
+}
+/** 窗口条：`2026-09-01 → 2026-09-07` ＋ 天数（或条数）胶囊。
+ *
+ *  `start === end`（单日窗）只出一枚日期块、不出箭头，块内写「（单日）」——不替读者断言一个
+ * 不存在的跨度（#510 立的退化分支，三族同口径）。日期文本走 `escapeHtml`。 */
+export function windowStrip(start, end, chipText, vocab) {
+    const chip = chipText === undefined || chipText === '' ? '' : '<span class="' + vocab.days + '">' + esc(chipText) + '</span>';
+    if (start === end) {
+        return '<div class="' + vocab.window + '"><span class="' + vocab.date + '">' + esc(start) + '（单日）</span>' + chip + '</div>';
+    }
+    return '<div class="' + vocab.window + '">'
+        + '<span class="' + vocab.date + '">' + esc(start) + '</span>'
+        + '<span class="' + vocab.arrow + '">→</span>'
+        + '<span class="' + vocab.date + '">' + esc(end) + '</span>'
+        + chip
+        + '</div>';
+}
+/** 事实条：一组「标签 ＋ 值」。`v` 为空串的那一条整条不出（缺值不留空槽）。
+ *
+ *  `variant` 三位是**落点**不是形状（见 `variantClasses`）。 */
+export function factStrip(facts, vocab, variant = {}) {
+    const body = facts
+        .filter((f) => f.v !== '')
+        .map((f) => '<span class="' + vocab.fact + '"><span class="' + vocab.key + '">' + esc(f.k) + '</span>'
+        + '<span class="' + vocab.value + '">' + esc(f.v) + '</span></span>')
+        .join('');
+    return body === '' ? '' : '<div class="' + vocab.facts + variantClasses(vocab, variant) + '">' + body + '</div>';
+}
+/** 窗口条的 CSS（**裸串，不带 `<style>` 标签**；三族逐值保留各自的几何）。
+ *
+ *  体重族与饮食族取值相同，只类名前缀不同。本函数产出的是一段可直接拼进族样式段的字符串。 */
+export function windowStripCss() {
+    return ''
+        // ── 运动族（`sui-`）：圆角 8px／内距 4px 8px／条外边距 4px 0 16px／窄屏 8px 12px ──
+        + '.sui-window{display:inline-flex;align-items:center;gap:8px;flex-wrap:wrap;margin:4px 0 16px}'
+        + '.sui-date{font-size:13px;font-weight:600;color:var(--fg);background:var(--card);'
+        + 'border:1px solid var(--line);border-radius:8px;padding:4px 8px;font-variant-numeric:tabular-nums}'
+        + '.sui-arrow{color:var(--fg3);font-size:13px}'
+        + '.sui-days{font-size:12px;font-weight:700;color:var(--blue2);background:var(--soft);'
+        + 'border-radius:999px;padding:4px 8px}'
+        + '@media (max-width:820px){'
+        + '  .sui-window{gap:8px}'
+        + '  .sui-date{padding:8px 12px;min-height:32px;display:inline-flex;align-items:center}'
+        + '  .sui-days{padding:4px 12px}'
+        + '}'
+        // ── 体重族（`wui-`）：圆角 10px／内距 3px 9px／条外边距 2px 0 10px／窄屏 6px 10px ──
+        + '.wui-window{display:inline-flex;align-items:center;gap:8px;flex-wrap:wrap;margin:2px 0 10px}'
+        + '.wui-date{font-size:13px;font-weight:600;color:var(--fg);background:var(--card);border:1px solid var(--line);'
+        + 'border-radius:10px;padding:3px 9px;font-variant-numeric:tabular-nums}'
+        + '.wui-arrow{color:var(--fg3);font-size:13px}'
+        + '.wui-days{font-size:12px;font-weight:700;color:var(--blue2);background:var(--soft);border-radius:999px;padding:3px 10px}'
+        + '@media (max-width:820px){'
+        + '  .wui-window{gap:6px}'
+        + '  .wui-date{padding:6px 10px;min-height:32px;display:inline-flex;align-items:center}'
+        + '  .wui-days{padding:5px 10px}'
+        + '}'
+        // ── 饮食族（`dui-`；天数胶囊叫 `dui-chip`）：逐值同体重族 ──
+        + '.dui-window{display:inline-flex;align-items:center;gap:8px;flex-wrap:wrap;margin:2px 0 10px}'
+        + '.dui-date{font-size:13px;font-weight:600;color:var(--fg);background:var(--card);border:1px solid var(--line);'
+        + 'border-radius:10px;padding:3px 9px;font-variant-numeric:tabular-nums}'
+        + '.dui-arrow{color:var(--fg3);font-size:13px}'
+        + '.dui-chip{font-size:12px;font-weight:700;color:var(--blue2);background:var(--soft);border-radius:999px;padding:3px 10px}'
+        + '@media (max-width:820px){.dui-window{gap:6px}'
+        + '.dui-date{padding:6px 10px;min-height:32px;display:inline-flex;align-items:center}}';
+}
+/** 事实条的 CSS（**裸串，不带 `<style>` 标签**）。
+ *
+ *  **本票唯一一处可见版式变更落在这里**：体重族的容器从「一行横排（`flex-wrap:wrap`）」改成
+ *  「等宽小格（`auto-fit` 栅格、窄屏塌单列）」——正本取运动族那套（票面 §二、§六 第 1 条，用户已授权）。
+ *  类名与其余属性（字号／色／权重）一律不动：体重族那三个变体位（`-v`／`-gap`／`-note`）的原规则
+ *  也逐值保留，故 `wui-strip-v` 的纵列版式与 `wui-strip-note` 的脚注口气字**一行未改**。
+ *
+ *  体重族与运动族的**键／值两小格在桌面档的取向不同**（运动族「键上值下」，体重族「键值同行」），
+ *  故 `.wui-fact` 不给 `flex-direction:column`；到了窄屏两族同归「键贴左、值贴右的纵列」。 */
+export function factStripCss() {
+    return ''
+        // ── 运动族（`sui-`）──
+        + '.sui-facts{display:grid;grid-template-columns:repeat(auto-fit,minmax(148px,1fr));gap:8px 16px;margin:8px 0 16px}'
+        + '.sui-fact{display:flex;flex-direction:column;gap:2px;min-width:0}'
+        // 键色 `--fg3`(#86868b) 对白底仅 3.62:1，12px 正文要 4.5:1；`--fg2`(#6e6e73) 为 5.07:1
+        // （同包 `base-render/src/style.ts:567` 已为同类 12px 小字做过同一次改动，本处照办）。
+        + '.sui-fact-k{font-size:12px;color:var(--fg2);white-space:nowrap}'
+        + '.sui-fact-v{font-size:13px;font-weight:600;color:var(--fg);font-variant-numeric:tabular-nums;min-width:0}'
+        // ── 体重族（`wui-strip`）：容器**逐值换成运动族那套栅格**（本票唯一可见变更）；键值两格与三个变体位原样 ──
+        + '.wui-strip{display:grid;grid-template-columns:repeat(auto-fit,minmax(148px,1fr));gap:8px 16px;margin:2px 0 10px}'
+        + '.wui-strip-v{flex-direction:column;align-items:stretch;gap:8px}'
+        // 空槽（`margin-top:16px`）：**卡片的 `detail` 槽**里本件没有兄弟件可借距（KPI 值槽之下直接是本条）。
+        + '.wui-strip-gap{margin-top:16px}'
+        // 纵列里的一组「标签 ＋ 值」：标签在左、值贴右，行行对齐（窄屏的事实一栏读法）。
+        + '.wui-strip-v .wui-fact{width:100%;justify-content:space-between;gap:12px}'
+        // 「标签 ＋ **说明句**」那一型（`factStrip(facts, false, true, true)`）：值不是量值而是一句脚注口气的
+        // 说明（「目标值超出刻度」），整块退一档（同 `.wui-note` 的字号／行高／色），不跟量值抢眼。
+        // #510：两半**分两档**——标签留 `--fg3`、说明那半落到 `--fg2` 且不加粗（原来两半同为 13px 加粗 `--fg`，
+        // 并排读成一句不通的话：`图上没画目标线 目标值超出刻度`）。
+        + '.wui-strip-note .wui-fact{display:flex;align-items:baseline;flex-wrap:wrap;gap:2px 8px}'
+        + '.wui-strip-note .wui-fact-k{font-size:12px;color:var(--fg3);font-weight:400;white-space:normal}'
+        + '.wui-strip-note .wui-fact-v{font-size:12px;font-weight:400;color:var(--fg2);line-height:1.6}'
+        // 体重族的键值两格：**逐值保留原写法**（桌面「键值同行」，与原 `.wui-fact` 一字不差）。
+        + '.wui-fact{display:inline-flex;align-items:baseline;gap:6px;min-width:0}'
+        + '.wui-fact-k{font-size:12px;color:var(--fg3);white-space:nowrap}'
+        + '.wui-fact-v{font-size:13px;font-weight:600;color:var(--fg);font-variant-numeric:tabular-nums}'
+        // ── 两族的窄屏段（820）：塌单列，键贴左／值贴右（两族同写法，逐值保留）──
+        + '@media (max-width:820px){'
+        + '  .sui-facts{grid-template-columns:minmax(0,1fr);gap:8px}'
+        + '  .sui-fact{flex-direction:row;justify-content:space-between;align-items:baseline;gap:12px}'
+        + '  .wui-strip{grid-template-columns:minmax(0,1fr);gap:8px}'
+        + '  .wui-strip-v{gap:8px}'
+        + '  .wui-fact{flex-direction:row;justify-content:space-between;align-items:baseline;gap:12px}'
+        + '  .wui-fact-v{font-size:13px}'
+        + '}'
+        // ── 触摸面（HELP 第 ①）：两族的键值行／窗口条都是读者在手机上会按住的一块内容 ──
+        + '.sui-facts,.sui-window{-webkit-tap-highlight-color:transparent;touch-action:manipulation}';
+}
+//# sourceMappingURL=pageStrips.js.map

package/dist/shared/pageStrips.js.map

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

package/dist/shared/params.d.ts

@@ -0,0 +1,54 @@
+/** 命令层的参数读取与时间窗口口径（**唯一定义地**）。
+ *
+ * 谁在用（写得出哪两个在用）：
+ *   ① 出口分派层 `src/cli/cmd_read.ts`／`write.ts`——尚未搬进能力目录的老命令；
+ *   ② 能力目录（本票：体重 `src/weight/`）——命令的实现搬回能力目录后，它仍要同一套失败码
+ *      与同一套窗口口径（`#250` 的时间说法正本在 `analysis/series.ts`，本文件只是它的参数层读法）。
+ *
+ * 以前 `fail`／`needStr`／`optStr`／`optNum`／`assertISO` 在 `cmd_read.ts` 与 `write.ts` 各写一份，
+ * 本票按「概念唯一」收成一份：同一个语义只留一个定义地，两处引用它。
+ *
+ * 退出码沿 T11 冻结（P9）：1 预检；2 用法／参数；3 key；4 取数／超时；5 envelope／渲染／落盘。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+export declare function fail(code: number, msg: string): never;
+export declare function needStr(params: Record<string, unknown>, name: string): string;
+export declare function optStr(params: Record<string, unknown>, name: string): string | undefined;
+export declare function needNum(params: Record<string, unknown>, name: string): number;
+export declare function optNum(params: Record<string, unknown>, name: string): number | undefined;
+export declare function optInt(params: Record<string, unknown>, name: string): number | undefined;
+export declare function needId(params: Record<string, unknown>, name?: string): number;
+export declare function needArr(params: Record<string, unknown>, name: string): unknown[];
+export declare function assertISO(v: string, field: string): void;
+/** 非空数挑拣：null/undefined/NaN/Infinity 一律丢弃（stat.metrics 须全有限 number）。 */
+export declare function nums(input: Record<string, number | null | undefined>): Record<string, number>;
+/** 锚点：`today` 可显式传入（演示／测试／面板用来复现固定日）；缺省＝**真实今天**（语义正确）。 */
+export declare function anchorOf(params: Record<string, unknown>): string;
+/** 窗口：`window`（今日／本周／最近 Nd／custom…）＋ `offset`（整体平移 ±Nd/±Nw/±Nm/±Ny）。
+ *  给了 `window` 就以它为准；**显式 start+end 仍然优先**（`custom` 除外——它本来就用这对日期）；
+ *  两样都没有则回 null，由各命令沿用旧口径。 */
+export declare function windowRange(params: Record<string, unknown>): {
+    start: string;
+    end: string;
+} | null;
+/** 单日字段：`date`／`from`／`to` 这类「一个日」可写相对词（今日／昨日／前天），并吃 `offset` 平移。 */
+export declare function dayField(params: Record<string, unknown>, field: string): string | null;
+/** 单日字段（必填）：相对词与显式日期都收；缺则按用法报 exit 2。 */
+export declare function needDay(params: Record<string, unknown>, field: string): string;
+/** 写命令的日期位与读命令**同一套时间说法**：显式 ISO 日照旧，另收相对词（今日／昨日／前天）
+ *  与 `offset` 平移（±Nd／±Nw／±Nm／±Ny）——「补记昨天的饮食」这类话不必由 AI 自己算日期。
+ *  非日期值原样返回（本函数只做「相对词 → 具体日」的翻译，不认识的值交给各自的校验）。 */
+export declare function wday(params: Record<string, unknown>, field: string): string | undefined;
+/** 写命令的必填日期位（语义同 `wday`）。 */
+export declare function needWday(params: Record<string, unknown>, field: string): string;
+/** 闭区间天数（含首末日）。 */
+export declare function daysIn(range: {
+    start: string;
+    end: string;
+}): number;
+export declare function latestFoodDate(db: DatabaseSync): string | null;
+export declare function defaultRange(db: DatabaseSync, params: Record<string, unknown>, defDays?: number): {
+    start: string;
+    end: string;
+};
+//# 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":"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"}