skill-calorie 0.2.3 → 0.2.5

package/dist/shared/params.js

@@ -0,0 +1,176 @@
+import { shiftISODate, todayISO } from '../analysis/utils.js';
+import { applyOffset, resolveDay, resolveWindow } from '../analysis/series.js';
+import { CalorieRenderError } from '../render/errors.js';
+export function fail(code, msg) {
+    console.error('ERR ' + code + ': ' + msg);
+    process.exit(code);
+}
+export function needStr(params, name) {
+    const v = params[name];
+    if (typeof v !== 'string' || v.length === 0)
+        fail(2, '缺参数 ' + name);
+    return v;
+}
+export function optStr(params, name) {
+    const v = params[name];
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== 'string')
+        fail(2, '参数 ' + name + ' 须为字符串');
+    return v;
+}
+export function needNum(params, name) {
+    const v = params[name];
+    if (typeof v !== 'number' || !Number.isFinite(v))
+        fail(2, '缺参数 ' + name + '（须为有限 number）');
+    return v;
+}
+export function optNum(params, name) {
+    const v = params[name];
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== 'number' || !Number.isFinite(v))
+        fail(2, '参数 ' + name + ' 须为有限 number');
+    return v;
+}
+export function optInt(params, name) {
+    const v = optNum(params, name);
+    if (v === undefined)
+        return undefined;
+    if (!Number.isInteger(v))
+        fail(2, '参数 ' + name + ' 须为整数');
+    return v;
+}
+export function needId(params, name = 'id') {
+    const v = params[name];
+    if (typeof v !== 'number' || !Number.isInteger(v) || v <= 0)
+        fail(2, '缺参数 ' + name + '（正整数记录 id）');
+    return v;
+}
+export function needArr(params, name) {
+    const v = params[name];
+    if (!Array.isArray(v) || v.length === 0)
+        fail(2, '缺参数 ' + name + '（非空数组）');
+    return v;
+}
+export function assertISO(v, field) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(v))
+        fail(2, field + ' 非法（须 YYYY-MM-DD）：' + v);
+}
+/** 非空数挑拣：null/undefined/NaN/Infinity 一律丢弃（stat.metrics 须全有限 number）。 */
+export function nums(input) {
+    const out = {};
+    for (const [k, v] of Object.entries(input)) {
+        if (typeof v === 'number' && Number.isFinite(v))
+            out[k] = v;
+    }
+    return out;
+}
+/** 锚点：`today` 可显式传入（演示／测试／面板用来复现固定日）；缺省＝**真实今天**（语义正确）。 */
+export function anchorOf(params) {
+    const t = optStr(params, 'today');
+    if (!t)
+        return todayISO();
+    const d = resolveDay(t, todayISO());
+    assertISO(d, 'today');
+    return d;
+}
+/** 窗口：`window`（今日／本周／最近 Nd／custom…）＋ `offset`（整体平移 ±Nd/±Nw/±Nm/±Ny）。
+ *  给了 `window` 就以它为准；**显式 start+end 仍然优先**（`custom` 除外——它本来就用这对日期）；
+ *  两样都没有则回 null，由各命令沿用旧口径。 */
+export function windowRange(params) {
+    const w = optStr(params, 'window');
+    if (!w)
+        return null;
+    const s0 = optStr(params, 'start');
+    const e0 = optStr(params, 'end');
+    if (w !== 'custom' && s0 && e0)
+        return null;
+    let s;
+    let e;
+    try {
+        // 窗口词／偏移是**参数**错（用法错），统一报 bad-input（exit 2）；别混进「取数失败」那一档。
+        [s, e] = applyOffset(resolveWindow(w, s0, e0, anchorOf(params)), optStr(params, 'offset'));
+    }
+    catch (err) {
+        throw new CalorieRenderError('bad-input', err instanceof Error ? err.message : String(err));
+    }
+    assertISO(s, 'start');
+    assertISO(e, 'end');
+    if (s > e)
+        fail(2, 'start 不得晚于 end');
+    return { start: s, end: e };
+}
+/** 单日字段：`date`／`from`／`to` 这类「一个日」可写相对词（今日／昨日／前天），并吃 `offset` 平移。 */
+export function dayField(params, field) {
+    const raw = optStr(params, field);
+    if (!raw)
+        return null;
+    const anchor = anchorOf(params);
+    const shifted = applyOffset([resolveDay(raw, anchor), resolveDay(raw, anchor)], optStr(params, 'offset'))[0];
+    assertISO(shifted, field);
+    return shifted;
+}
+/** 单日字段（必填）：相对词与显式日期都收；缺则按用法报 exit 2。 */
+export function needDay(params, field) {
+    const v = dayField(params, field);
+    if (!v)
+        fail(2, '缺参数 ' + field);
+    return v;
+}
+/** 写命令的日期位与读命令**同一套时间说法**：显式 ISO 日照旧，另收相对词（今日／昨日／前天）
+ *  与 `offset` 平移（±Nd／±Nw／±Nm／±Ny）——「补记昨天的饮食」这类话不必由 AI 自己算日期。
+ *  非日期值原样返回（本函数只做「相对词 → 具体日」的翻译，不认识的值交给各自的校验）。 */
+export function wday(params, field) {
+    const raw = optStr(params, field);
+    if (!raw)
+        return undefined;
+    const anchor = resolveDay(optStr(params, 'today') ?? todayISO(), todayISO());
+    return applyOffset([resolveDay(raw, anchor), resolveDay(raw, anchor)], optStr(params, 'offset'))[0];
+}
+/** 写命令的必填日期位（语义同 `wday`）。 */
+export function needWday(params, field) {
+    const v = wday(params, field);
+    if (!v)
+        fail(2, '缺参数 ' + field);
+    return v;
+}
+/** 闭区间天数（含首末日）。 */
+export function daysIn(range) {
+    return Math.round((Date.parse(range.end) - Date.parse(range.start)) / 86400000) + 1;
+}
+export function latestFoodDate(db) {
+    try {
+        const row = db.prepare('SELECT MAX(date) AS m FROM food_log').get();
+        return row?.m ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function defaultRange(db, params, defDays = 7) {
+    const win = windowRange(params);
+    if (win)
+        return win;
+    let end = dayField(params, 'end') ?? dayField(params, 'date') ?? dayField(params, 'today') ?? undefined;
+    const start = dayField(params, 'start') ?? undefined;
+    if (end)
+        assertISO(end, 'end');
+    if (start)
+        assertISO(start, 'start');
+    if (start && end) {
+        if (start > end)
+            fail(2, 'start 不得晚于 end');
+        return { start, end };
+    }
+    const latest = latestFoodDate(db) ?? todayISO();
+    end = end ?? latest;
+    assertISO(end, 'end');
+    if (start) {
+        if (start > end)
+            fail(2, 'start 不得晚于 end');
+        return { start, end: end };
+    }
+    return { start: shiftISODate(end, -(defDays - 1)), end: end };
+}
+//# sourceMappingURL=params.js.map

package/dist/shared/params.js.map

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

package/dist/shared/planCopyBlock.d.ts

@@ -0,0 +1,32 @@
+/** T351 · 健身计划页面底部复制区：prompt 段（预检确认页才有）＋ 冻结双按钮段。
+ *
+ * 谁在用（写得出哪两个在用）：**看训练计划**（`src/render/workoutPlanDocs.ts` 的结果页与过程页）
+ * 与**写后回执**（`src/workout/receipt.ts` 的十条会改数据库的命令）——四条调用点产物逐字同形，
+ * 故收成一份，免得各自漂移。只有过程型两页（预检确认页）传 `prompt`。
+ *
+ * 与 `src/shared/copyArea.ts` 的 `copyArea` 分家：`copyArea` 的数据位恒出三格式菜单
+ * （纯文本／JSON／CSV，场景 07 等页在用，本次不动它）；本件按视觉审查口径**不出菜单**——
+ * `renderCopyBlock` 不传 `dataFormats`，并把两颗按钮的 `id` 补成冻结表那两颗
+ * （`ilife-copy-data`／`ilife-copy-log`，见 `COPY_ACTION_IDS.actionBar`），供页面运行时的
+ * 双通道复制认领。故本件只服务健身计划这一路，不替换 `copyArea` 的既有行为。
+ *
+ * 复制文本仍走唯一出处：数据位 `base-paint` 的 `buildDataText`（#77 数据投影），
+ * 日志位 `buildLogText` ＋ 共用件 `copyLog`（#77 六段日志）。本件不取数、不取时钟。
+ */
+import type { CopyLogFields, SerializableEnvelope } from 'base-paint';
+/** 复制区入参：信封（八键载荷）＋ 日志六段（由调用方 `copyLog({…})` 派生）。 */
+interface PlanCopyInput {
+    /** 页面载荷信封（`version`／`skill`／`shape`／`key`／`data`）。 */
+    readonly envelope: SerializableEnvelope;
+    /** 日志六段（调用方给 `command`／`source`／`m5Line`／`actionAt`／`version` 后由 `copyLog` 派生）。 */
+    readonly log: CopyLogFields;
+    /** 复制数据文本的输出头；不给即按信封模板派生（`DataTextInput.title` 口径）。 */
+    readonly dataTitle?: string;
+    /** 本写词的逐字 prompt（只在预检确认页给；空串／不给即不出 prompt 段）。 */
+    readonly prompt?: string;
+}
+/** 复制区：数据位单格式、日志位直挂，按钮 `id` 补成冻结表那两颗；无三格式菜单、无英文菜单项。
+ *  日志位的信封先过 #550 归一（`key` 带 `calorie.` 前缀时剥一层），**数据位一字不动**。 */
+export declare function planCopyBlock(input: PlanCopyInput): string;
+export {};
+//# sourceMappingURL=planCopyBlock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planCopyBlock.d.ts","sourceRoot":"","sources":["../../src/shared/planCopyBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAoBtE,oDAAoD;AACpD,UAAU,aAAa;IACrB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;+DAC+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAa1D"}

package/dist/shared/planCopyBlock.js

@@ -0,0 +1,34 @@
+import { buildDataText, buildLogText, renderActionBar } from 'base-paint';
+import { renderCopyBlock, renderPreBlock } from 'base-paint/blocks';
+import { CALORIE_COPY_ACTION } from '../render/copy.js';
+import { sceneEnvelope } from './sceneEnvelope.js';
+/** prompt 段：预览块 ＋ 一颗「复制指令」（预检确认页「复制 prompt 回给 AI」那一环，老侧 `promptCopyArea` 的语序）。
+ *
+ *  **这颗只能走 `renderActionBar` 的日志位**：`renderActionBar`（`base-render/src/controls.ts:1367`）
+ *  在「数据位在场而日志位缺席」时会按 #336 自动补一颗**禁用**「复制日志」，其 id 正是
+ *  `COPY_ACTION_IDS.actionBar.copyLog`——与底部冻结那颗撞 id，页上就成了两颗同名按钮（其中一颗灰的）。
+ *  日志位单独给一颗复制按钮不触发 #336，且 actionId／文案由调用方定。「一排三颗」用冻结 API 表达不出来：
+ *  `buttons` 位的场景按钮不写 `data-t`，运行时认领不到，做成第三颗就是个点不动的死按钮。 */
+function promptArea(prompt) {
+    return renderPreBlock({ command: prompt })
+        + renderActionBar({
+            copyLog: { actionId: CALORIE_COPY_ACTION.actionId, label: CALORIE_COPY_ACTION.label, text: prompt },
+        });
+}
+/** 复制区：数据位单格式、日志位直挂，按钮 `id` 补成冻结表那两颗；无三格式菜单、无英文菜单项。
+ *  日志位的信封先过 #550 归一（`key` 带 `calorie.` 前缀时剥一层），**数据位一字不动**。 */
+export function planCopyBlock(input) {
+    const title = input.dataTitle;
+    const prompt = input.prompt;
+    return (prompt === undefined || prompt === '' ? '' : promptArea(prompt))
+        + renderCopyBlock({
+            dataText: buildDataText({
+                envelope: input.envelope,
+                ...(title === undefined ? {} : { title }),
+            }),
+            logText: buildLogText({ envelope: sceneEnvelope(input.envelope), copyLog: input.log }),
+        })
+            .replace('data-action-id="ilife-copy-data"', 'id="ilife-copy-data" data-action-id="ilife-copy-data"')
+            .replace('data-action-id="ilife-copy-log"', 'id="ilife-copy-log" data-action-id="ilife-copy-log"');
+}
+//# sourceMappingURL=planCopyBlock.js.map

package/dist/shared/planCopyBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planCopyBlock.js","sourceRoot":"","sources":["../../src/shared/planCopyBlock.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;2DAM2D;AAC3D,SAAS,UAAU,CAAC,MAAc;IAChC,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;UACtC,eAAe,CAAC;YAChB,OAAO,EAAE,EAAE,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE,KAAK,EAAE,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;SACpG,CAAC,CAAC;AACP,CAAC;AAcD;+DAC+D;AAC/D,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;UACpE,eAAe,CAAC;YAChB,QAAQ,EAAE,aAAa,CAAC;gBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;aAC1C,CAAC;YACF,OAAO,EAAE,YAAY,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;SACvF,CAAC;aACC,OAAO,CAAC,kCAAkC,EAAE,uDAAuD,CAAC;aACpG,OAAO,CAAC,iCAAiC,EAAE,qDAAqD,CAAC,CAAC;AACzG,CAAC"}

package/dist/shared/receiptParts.d.ts

@@ -0,0 +1,9 @@
+import type { KpiCardInput } from 'base-paint/blocks';
+import type { CrudReceipt } from '../render/receipt.js';
+/** 一格的状态值：无改动／已改动 ＋ 一句写入去向的说明（说明由调用方按本域措辞传入）。
+ *  承接原「无变化 否」那个双重否定，一页只出现这一处。 */
+export declare function statusCard(receipt: CrudReceipt, writtenDetail: string): KpiCardInput;
+/** 页尾「对账信息」折叠区：本次写入的**可核对信息**——记录编号／写入时间／回执格式。
+ *  影响行数与写入字段已在卡片上，这里不重写；眉标与副标题不再出现版本号与那行机器文本。 */
+export declare function reconcileDisclosure(receipt: CrudReceipt): string;
+//# sourceMappingURL=receiptParts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"receiptParts.d.ts","sourceRoot":"","sources":["../../src/shared/receiptParts.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;iCACiC;AACjC,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CAMpF;AAED;iDACiD;AACjD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAYhE"}

package/dist/shared/receiptParts.js

@@ -0,0 +1,40 @@
+/** #251 · 写后回执页的两块共用件：状态卡 ＋ 页尾「对账信息」折叠区。
+ *
+ * 谁在用（写得出哪两个在用）：
+ *   ① **基础信息**（`src/profile/setup.ts` 的两张回执页与 `src/profile/update.ts` 的改档案回执）；
+ *   ② **目标管理**（`src/goal/` 的写后回执页）。
+ * 这两块此前只在 `src/profile/setup.ts` 里定义、被同目录 `update.ts` 取用——**同一件事的定义地
+ * 跟着第二个能力一起上移到共用位**（`docs/agents/structure.md`：共用位是从第二个用法里长出来的）。
+ *
+ * 块与整页的分工：整页装配住同目录 `docPage.ts`（`assembleDocPage`），本文件只出**页内的两块**；
+ * 复制与提示住同目录 `copyArea.ts`。三者各管一段，互不重复定义。
+ *
+ * 一处由调用方给的措辞：**写入去向那句说明**（`writtenDetail`）。基础信息写的是档案、目标管理写的是
+ * 目标，两边说法不同，故它是必填参数——不给默认值，免得哪一页悄悄用了别域的说法。
+ */
+import { renderDataTable, renderDisclosure } from 'base-paint/blocks';
+/** 一格的状态值：无改动／已改动 ＋ 一句写入去向的说明（说明由调用方按本域措辞传入）。
+ *  承接原「无变化 否」那个双重否定，一页只出现这一处。 */
+export function statusCard(receipt, writtenDetail) {
+    return {
+        label: '状态',
+        value: receipt.noChange ? '无改动' : '已改动',
+        detail: receipt.noChange ? '值与改前一致' : writtenDetail,
+    };
+}
+/** 页尾「对账信息」折叠区：本次写入的**可核对信息**——记录编号／写入时间／回执格式。
+ *  影响行数与写入字段已在卡片上，这里不重写；眉标与副标题不再出现版本号与那行机器文本。 */
+export function reconcileDisclosure(receipt) {
+    return renderDisclosure({
+        title: '对账信息',
+        contentHtml: renderDataTable({
+            columns: [{ key: 'k', label: '项' }, { key: 'v', label: '值' }],
+            rows: [
+                { k: '记录编号', v: receipt.recordId === null ? '未设置' : String(receipt.recordId) },
+                { k: '写入时间', v: receipt.meta.actionAt },
+                { k: '回执格式', v: 'v' + receipt.m5Contract + '（写库回执）' },
+            ],
+        }),
+    });
+}
+//# sourceMappingURL=receiptParts.js.map

package/dist/shared/receiptParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiptParts.js","sourceRoot":"","sources":["../../src/shared/receiptParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAItE;iCACiC;AACjC,MAAM,UAAU,UAAU,CAAC,OAAoB,EAAE,aAAqB;IACpE,OAAO;QACL,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;QACvC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa;KACpD,CAAC;AACJ,CAAC;AAED;iDACiD;AACjD,MAAM,UAAU,mBAAmB,CAAC,OAAoB;IACtD,OAAO,gBAAgB,CAAC;QACtB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,eAAe,CAAC;YAC3B,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YAC7D,IAAI,EAAE;gBACJ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAC9E,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE;gBACvC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,GAAG,QAAQ,EAAE;aACtD;SACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/sceneEnvelope.d.ts

@@ -0,0 +1,32 @@
+/** #550 · 复制日志第 1 段「场景标识」的**场景键归一**：`key` 已带 `{skill}.` 前缀时剥掉那一层。
+ *
+ * 一句话背景：公共层 `base-render/src/text.ts:298` 的场景标识算式是 **`skill ＋ '.' ＋ key`**，
+ * 而 `Envelope.key` 的契约注释（`base-link-core/src/envelope.ts:26`「registry 命名空间 key：形如
+ * skill.combo」）与兄弟技能 `skill-bill/src/shared/pageIdentity.ts:10` 的写法（交给信封的 key
+ * **只写场景名**，`bill.record.add` → `record.add`）**互相打架**。卡路里这侧站整名那一派
+ * （勘察读数：`packages/skill-calorie/src` 里 78 处信封装配位，带 `calorie.` 前缀的 **50** 处、
+ * 不带前缀的 **0** 处、动态表达式 28 处），于是日志第 1 段印成
+ * `calorie.calorie.view.plan（stat）`——用户照「复制日志」抄回 AI 的是一个**不存在的命令键**
+ * （这一段不上屏，机检与肉眼原先都照不到）。
+ *
+ * 为什么归一落在卡路里这侧、不动公共层：编排者 2026-09-15 裁定（#550 执行窗）——公共层
+ * 「算式 vs 兄弟技能约定」这一对矛盾归公共层票裁，卡路里票只在自己这侧的**每一次 `buildLogText`
+ * 调用点**上收口。
+ *
+ * 判据（可证不回归，两条都是性质不是口味）：
+ *  - **合规写法逐字节不变**：`key` 不以 `{skill}.` 开头时**返回入参那一只对象本身**（`===`），
+ *    下游拿到的字节与改前逐字节相同；
+ *  - **不合规写法不再拼两遍**：带前缀时剥一层，产物里该行回到 `{skill}.{场景名}（{shape}）`。
+ *
+ * 规则从 envelope 自己的 `skill` 派生，**不写任何能力的名字**（仓规「共用位里不许出现任何一个
+ * 能力的名字」）；`skill` 为空串、`key` 非字符串或为空串时一律原样返回（不抛错、不改字节）。
+ *
+ * 谁在用（写得出哪两个在用）：**页面日志位的漏斗** `shared/copyArea.ts`（全包各域页面的复制区
+ * 都经它出日志位）与 **三族自己直调 `buildLogText` 的页面装配**（`render/planCopyBlock.ts` 的
+ * 健身计划结果页／过程页与写后回执、`render/reviewDocs.ts` 的计划复盘页、`render/trendDocs.ts`
+ * 的禁忌扫描页）。
+ */
+import type { SerializableEnvelope } from 'base-paint';
+/** 场景键归一：`key` 以 `{skill}.` 开头时剥掉该前缀；其余情形返回**入参那一只对象**（引用相等）。 */
+export declare function sceneEnvelope(envelope: SerializableEnvelope): SerializableEnvelope;
+//# sourceMappingURL=sceneEnvelope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sceneEnvelope.d.ts","sourceRoot":"","sources":["../../src/shared/sceneEnvelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,oBAAoB,GAAG,oBAAoB,CAOlF"}

package/dist/shared/sceneEnvelope.js

@@ -0,0 +1,12 @@
+/** 场景键归一：`key` 以 `{skill}.` 开头时剥掉该前缀；其余情形返回**入参那一只对象**（引用相等）。 */
+export function sceneEnvelope(envelope) {
+    const skill = typeof envelope.skill === 'string' ? envelope.skill : '';
+    const key = typeof envelope.key === 'string' ? envelope.key : '';
+    if (skill === '' || key === '')
+        return envelope;
+    const prefix = skill + '.';
+    if (!key.startsWith(prefix))
+        return envelope;
+    return { ...envelope, key: key.slice(prefix.length) };
+}
+//# sourceMappingURL=sceneEnvelope.js.map

package/dist/shared/sceneEnvelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneEnvelope.js","sourceRoot":"","sources":["../../src/shared/sceneEnvelope.ts"],"names":[],"mappings":"AA8BA,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,QAA8B;IAC1D,MAAM,KAAK,GAAG,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,GAAG,GAAG,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,IAAI,KAAK,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAChD,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/dist/shared/sourceLine.d.ts

@@ -0,0 +1,10 @@
+/** 来源脚注：`数据来源 · 来源 · 起 → 止 · 共 N 条`。
+ *  入参形状**内联在签名里**（#708 收掉原来那个零 import 的 `SourceLineInput` 导出名）：
+ *  `source` 不给／空串即只印窗口与条数（老件缺来源时的那种写法）。 */
+export declare function sourceLine(input: {
+    readonly source: string;
+    readonly start: string;
+    readonly end: string;
+    readonly count: number;
+}): string;
+//# sourceMappingURL=sourceLine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLine.d.ts","sourceRoot":"","sources":["../../src/shared/sourceLine.ts"],"names":[],"mappings":"AAoBA;;2CAE2C;AAC3C,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAe3I"}

package/dist/shared/sourceLine.js

@@ -0,0 +1,39 @@
+/** #422 · 来源脚注（技能层共用件）：读页与回执页共用的一句
+ *  「数据来源 · <来源> · 起 → 止 · 共 N 条」。
+ *
+ * 老实物出处：汇总件 `exercise_summary.html:217` 的「📊 数据来源 · 起 → 止 · N 条」；
+ * 回执老件缺这一行（`crud_receipt.html` 的 `.footer` 只有按钮），融合时给回执页补上，
+ * 故本件是**两族共用**的那一处。
+ *
+ * 版面：走公共层 #420 的口径说明行 `renderCaliberLine`（`ilife-block-caliber`，12px `--fg2`），
+ * 本件不写色、不写字号——版面单源住 `packages/base-render/`。
+ */
+import { renderCaliberLine } from 'base-paint/blocks';
+import { CalorieRenderError } from '../render/errors.js';
+function reqText(value, field) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new CalorieRenderError('bad-input', field + ' 必须是非空字符串（本件不给默认窗口）');
+    }
+    return value;
+}
+/** 来源脚注：`数据来源 · 来源 · 起 → 止 · 共 N 条`。
+ *  入参形状**内联在签名里**（#708 收掉原来那个零 import 的 `SourceLineInput` 导出名）：
+ *  `source` 不给／空串即只印窗口与条数（老件缺来源时的那种写法）。 */
+export function sourceLine(input) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new CalorieRenderError('bad-input', 'sourceLine: input 必须是对象');
+    }
+    const line = input;
+    const start = reqText(line.start, 'sourceLine: input.start');
+    const end = reqText(line.end, 'sourceLine: input.end');
+    if (!Number.isInteger(line.count) || line.count < 0) {
+        throw new CalorieRenderError('bad-input', 'sourceLine: input.count 须为非负整数');
+    }
+    const parts = ['数据来源'];
+    if (typeof line.source === 'string' && line.source.trim() !== '')
+        parts.push(line.source.trim());
+    parts.push(start + ' → ' + end);
+    parts.push('共 ' + line.count + ' 条');
+    return renderCaliberLine(parts.join(' · '));
+}
+//# sourceMappingURL=sourceLine.js.map

package/dist/shared/sourceLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLine.js","sourceRoot":"","sources":["../../src/shared/sourceLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,SAAS,OAAO,CAAC,KAAc,EAAE,KAAa;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,KAAK,GAAG,qBAAqB,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;2CAE2C;AAC3C,MAAM,UAAU,UAAU,CAAC,KAAwG;IACjI,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,gCAAgC,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAa,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACjG,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACrC,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/shared/time.d.ts

@@ -0,0 +1,28 @@
+/** 时钟的**唯一定义地**（#717 批③）：「今天是哪一天」「现在是几点」只从这里取。
+ *
+ * 谁在用（写得出哪两个能力在用）：
+ *   ① 分析能力 `analysis/`（`analysis/utils.ts` 的 `todayISO` 正本在这里，原处按原名转出）；
+ *   ② 饮食能力 `diet/`（`fetch/diet.ts` 记一餐时的落库日期与时刻）；
+ *   ③ 运动能力 `exercise/`（`exercise/exerciseStore.ts` 记一条时的时刻）；
+ *   ④ 体重能力 `weight/`（`weight/records.ts` 记体重时的日期与时刻）。
+ *
+ * 本件**零依赖**：不 import 任何件，也不出现任何一个能力目录的名字。
+ *
+ * 收在这里之前的样子（#701 普查、#717 批③）：`todayISO` 的正本住 `analysis/utils.ts`，而
+ * `fetch/diet.ts`／`exercise/exerciseStore.ts`／`weight/records.ts` **各写一份私有的本地时钟**
+ * （`new Date().toISOString().slice(0,10)` 与 `new Date().toTimeString().slice(0,8)`）——
+ * 抓取层被要求「不反向依赖 analysis」，于是绕路自己读系统钟，三份副本各自走散。
+ *
+ * 口径：**读系统钟**（进程级钉钟由测试的 `--require freeze-clock.cjs` 预载件盖住整个 `Date`，
+ * 故钉钟时本件三个读数同时跟走——写入日、回执日、累计读日不会再分家）。
+ */
+/** 当刻的日（`YYYY-MM-DD`，UTC 日口径，与全包既有口径一致）。 */
+export declare function todayISO(): string;
+/** 当刻的时刻（`HH:MM:SS`，本地时刻口径）。 */
+export declare function timeOfDayISO(): string;
+/** 日期加减（按整天，`shiftISODate('2026-09-07', -6) === '2026-09-01'`）。
+ *
+ *  锚到 UTC 正午再加减，避开夏令时把某一天算成 23／25 小时那种边界。
+ *  非法日期当场抛（消息形状与全包既有写法一致）。 */
+export declare function shiftISODate(iso: string, deltaDays: number): string;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/shared/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,4CAA4C;AAC5C,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,gCAAgC;AAChC,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;8BAG8B;AAC9B,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAInE"}

package/dist/shared/time.js

@@ -0,0 +1,37 @@
+/** 时钟的**唯一定义地**（#717 批③）：「今天是哪一天」「现在是几点」只从这里取。
+ *
+ * 谁在用（写得出哪两个能力在用）：
+ *   ① 分析能力 `analysis/`（`analysis/utils.ts` 的 `todayISO` 正本在这里，原处按原名转出）；
+ *   ② 饮食能力 `diet/`（`fetch/diet.ts` 记一餐时的落库日期与时刻）；
+ *   ③ 运动能力 `exercise/`（`exercise/exerciseStore.ts` 记一条时的时刻）；
+ *   ④ 体重能力 `weight/`（`weight/records.ts` 记体重时的日期与时刻）。
+ *
+ * 本件**零依赖**：不 import 任何件，也不出现任何一个能力目录的名字。
+ *
+ * 收在这里之前的样子（#701 普查、#717 批③）：`todayISO` 的正本住 `analysis/utils.ts`，而
+ * `fetch/diet.ts`／`exercise/exerciseStore.ts`／`weight/records.ts` **各写一份私有的本地时钟**
+ * （`new Date().toISOString().slice(0,10)` 与 `new Date().toTimeString().slice(0,8)`）——
+ * 抓取层被要求「不反向依赖 analysis」，于是绕路自己读系统钟，三份副本各自走散。
+ *
+ * 口径：**读系统钟**（进程级钉钟由测试的 `--require freeze-clock.cjs` 预载件盖住整个 `Date`，
+ * 故钉钟时本件三个读数同时跟走——写入日、回执日、累计读日不会再分家）。
+ */
+/** 当刻的日（`YYYY-MM-DD`，UTC 日口径，与全包既有口径一致）。 */
+export function todayISO() {
+    return new Date().toISOString().slice(0, 10);
+}
+/** 当刻的时刻（`HH:MM:SS`，本地时刻口径）。 */
+export function timeOfDayISO() {
+    return new Date().toTimeString().slice(0, 8);
+}
+/** 日期加减（按整天，`shiftISODate('2026-09-07', -6) === '2026-09-01'`）。
+ *
+ *  锚到 UTC 正午再加减，避开夏令时把某一天算成 23／25 小时那种边界。
+ *  非法日期当场抛（消息形状与全包既有写法一致）。 */
+export function shiftISODate(iso, deltaDays) {
+    const t = Date.parse(iso + 'T12:00:00Z');
+    if (Number.isNaN(t))
+        throw new Error('[calorie] 日期非法: ' + iso);
+    return new Date(t + deltaDays * 86400000).toISOString().slice(0, 10);
+}
+//# sourceMappingURL=time.js.map

package/dist/shared/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/shared/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,4CAA4C;AAC5C,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;8BAG8B;AAC9B,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,SAAiB;IACzD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC;IAC/D,OAAO,IAAI,IAAI,CAAC,CAAC,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/shared/writeParts.d.ts

@@ -0,0 +1,61 @@
+/** 写命令的回执底座（**唯一定义地**）：回执装配（`R`／`out`／`receiptHtml`）＋ 影响行数口径
+ *  （`totalChanges`）＋ 写入字段摘要口径（`F`／`COL_CLI`／`provided`／`definedKeys`）＋ 删除措辞。
+ *
+ * 谁在用（写得出哪两个在用）：
+ *   ① 出口分派层 `src/cli/write.ts`——尚未搬进能力目录的老写键；
+ *   ② 能力目录（本票：体重 `src/weight/`）——写命令的实现搬回能力目录后，回执仍是同一套形状
+ *      （`ok`／`message`／`receipt` 三件，`affectedRows` 由 `dispatchWrite` 统一注入）。
+ *
+ * 口径正本：`#97` M5 写库回执契约（只追加字段）；`#101`→`#120` 删除可恢复性
+ *  （**不得承诺可恢复**：软删除＝行保留、已从查询与统计排除、暂无恢复入口；硬删除＝行删除、不可恢复）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { CrudReceipt, M5IdSource } from '../render/receipt.js';
+import type { WriteOut } from './commandSpec.js';
+/** 删除口径单一来源（prose 词条 ＋ `items[].status` 状态串同源派生）。
+ * `recoverable` 恒 false：全仓 0 个 restore/undo/recover 入口，故不得出现「可恢复」承诺。 */
+export declare const SOFT_EXCLUDED_INNER = "\u8F6F\u5220\u9664\uFF1A\u884C\u4FDD\u7559\uFF0C\u5DF2\u4ECE\u67E5\u8BE2\u4E0E\u7EDF\u8BA1\u4E2D\u6392\u9664\uFF1B\u6682\u65E0\u6062\u590D\u5165\u53E3";
+export declare const SOFT_EXCLUDED: string;
+export declare const HARD_INNER = "\u786C\u5220\u9664\uFF0C\u4E0D\u53EF\u6062\u590D";
+export declare const HARD_WORDING: string;
+/** 状态串与 prose 同源：kind 决定「软/硬」，两者一律带「不可恢复」。 */
+export declare function deleteStatus(kind: 'soft' | 'hard', base?: string): string;
+export declare function esc(s: unknown): string;
+/** 影响行数来源：SQLite `total_changes()` 在本键写库前后的增量。
+ * 真实库行数（INSERT／UPDATE／DELETE／软删标记一律计；`INSERT OR REPLACE` 命中已有行＝1，
+ * `INSERT OR IGNORE` 命中已有行＝0——实测 node:sqlite v24），非自报。 */
+export declare function totalChanges(db: DatabaseSync): number;
+/** 写入字段摘要（CLI 参数名口径）：create 键＝该键写入字段全集（缺省值也算写入）；
+ * update 键＝本次实际变更字段；delete 键＝空数组（无写入字段，旧版同样只印 id/日期/影响）。 */
+export declare const F: {
+    readonly diet: readonly ["foodName", "calories", "protein", "carbs", "fat", "grams", "note", "date", "time"];
+    readonly water: readonly ["ml", "note", "date", "time"];
+    readonly weight: readonly ["kg", "note", "date", "time"];
+    readonly weightBatch: readonly ["kg", "date"];
+    readonly exercise: readonly ["type", "calories", "minutes", "date", "time", "note", "reps", "category", "difficulty", "distance", "heartRate", "maxHeartRate", "steps", "setIndex", "loadKg", "backfill"];
+    readonly photo: readonly ["srcPaths", "tag", "note", "date", "time"];
+    readonly product: readonly ["productName", "brand", "calories", "protein", "fat", "saturatedFat", "carbohydrates", "sugar", "dietaryFiber", "sodium", "note"];
+};
+/** 库列名 → CLI 参数名（update 键按实际变更列回报写入字段摘要）。 */
+export declare const COL_CLI: Record<string, string>;
+export declare const cliNames: (cols: readonly string[]) => string[];
+/** 只取「实际提供」的参数名（写入字段摘要；`undefined` 不算写入）。 */
+export declare function provided(params: Record<string, unknown>, names: readonly string[]): string[];
+/** `input` 里实际有值的键（体脂／围度等动态字段表）。 */
+export declare function definedKeys(input: Record<string, unknown>): string[];
+/** M5 追加补丁：ids／idSource／writtenFields（`affectedRows` 由 `dispatchWrite` 统一注入）。 */
+export type M5Patch = {
+    ids?: number[];
+    idSource?: M5IdSource;
+    writtenFields?: string[];
+};
+/** C6 #43 · 写收据 HTML 结构化分项：摘要 + 操作元 + items 逐条（id/日期/状态/原因/明细）。 */
+export declare function receiptHtml(scene: string, summary: string, op: string, recordId: number | null, items?: CrudReceipt['items']): string;
+export declare function out(receipt: CrudReceipt): WriteOut;
+/** 页面「复制日志」第 4 段的命令原文：与 AI 实跑那条同形（含本次 `--params`），可照抄重跑。
+ *  参数值里若出现半角单引号，原文会在此处被截断——与 `profile/setup.ts` 的 prompt 写命令同一口径，
+ *  真要照抄重跑请自行把单引号转义（本仓命令原文一贯用单引号包 JSON）。 */
+export declare function commandLine(key: string, params: Record<string, unknown>): string;
+/** 回执装配的收口：一次写命令的「场景／操作／摘要／唤醒词／取数来源」＋ 追加补丁。 */
+export declare const R: (scene: string, op: CrudReceipt["op"], summary: string, wakeWord: string, source: string, extra?: Partial<Pick<CrudReceipt, "recordId" | "items" | "tagDiff" | "distance" | "noChange" | "action">> & M5Patch) => CrudReceipt;
+//# sourceMappingURL=writeParts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeParts.d.ts","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;wEACwE;AACxE,eAAO,MAAM,mBAAmB,2JAA8B,CAAC;AAC/D,eAAO,MAAM,aAAa,QAAkC,CAAC;AAC7D,eAAO,MAAM,UAAU,qDAAa,CAAC;AACrC,eAAO,MAAM,YAAY,QAAyB,CAAC;AAEnD,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,SAAQ,GAAG,MAAM,CAExE;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAEtC;AAID;;0DAE0D;AAC1D,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAGrD;AAED;4DAC4D;AAC5D,eAAO,MAAM,CAAC;;;;;;;;CAQJ,CAAC;AAEX,6CAA6C;AAC7C,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS1C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,SAAS,MAAM,EAAE,KAAG,MAAM,EAAsC,CAAC;AAEhG,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAE5F;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAEpE;AAED,iFAAiF;AACjF,MAAM,MAAM,OAAO,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE1F,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,CAMrI;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAKlD;AAED;;2CAE2C;AAC3C,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEhF;AAED,+CAA+C;AAC/C,eAAO,MAAM,CAAC,GACZ,OAAO,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,UAAU,MAAM,EAAE,QAAQ,MAAM,EACvF,QAAQ,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAC,GAAG,OAAO,KAClH,WAIC,CAAC"}