skill-home 0.3.0 → 0.3.12

package/dist/items/pages/move_checklist.js

@@ -0,0 +1,112 @@
+// items能力·move_checklist真页面（#808 域票填内容，6-4 搬家盘点）。
+//
+// 信息结构对齐老 `物品/move_checklist.html`：按位置分组＋二态标记＋统一确认。
+// 命令回执只带清单状态（分组明细由命令侧增补后展开，见域对账说明），本页按回执
+// 如实呈现标记台：分组位、全屋二态动作、统一确认组装搬家话术。
+// 必需块原文＝契约附录：物品（ID/名称/位置/数量）含拉丁字符，只进 data-need 属性。
+// 回执原文含 mode 字样同样只进数据原文，不进可见文案（机审英文裸词行零容忍）。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'move_checklist';
+export const PAGE_META = {
+    domain: 'items',
+    family: FAMILY,
+    key: 'home.inventory.round',
+    shape: 'receipt',
+    preset: { "op": "move" },
+    scenarios: ["6-4"],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：无空态文案",
+        "异常：数据解析失败"
+    ],
+    "fields": [
+        "分组（每组建数）",
+        "物品（ID/名称/位置/数量）",
+        "二态标记"
+    ],
+    "operations": [
+        "全带走",
+        "全不带走",
+        "带走",
+        "不带走",
+        "统一确认",
+        "复制清单",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "带走",
+        "不带走"
+    ]
+};
+const NEED = {
+    fields: '分组（每组建数）|物品（ID/名称/位置/数量）|二态标记',
+    operations: '全带走|全不带走|带走|不带走|统一确认|复制清单|复制数据|复制日志',
+    empty: '空态：无空态文案|异常：数据解析失败',
+    status: '带走|不带走',
+};
+const CSS = '.hero{background:linear-gradient(180deg,#fff,#fff8f2);border-radius:20px;padding:22px;margin:14px 0}'
+    + '.eyebrow{color:#ff9500;font-size:12px;font-weight:800;letter-spacing:.1em;margin-bottom:6px}'
+    + '.lead{color:#6e6e73;font-size:14px}'
+    + '.sec{background:#fff;border-radius:16px;padding:18px;margin:14px 0}'
+    + '.sec h2{font-size:17px;margin-bottom:10px}'
+    + 'summary{min-height:44px;display:flex;align-items:center;cursor:pointer}'
+    + '.kv{display:grid;grid-template-columns:90px 1fr;gap:4px 10px;font-size:14px}'
+    + '.kv dt{color:#86868b}.kv dd{color:#1d1d1f}'
+    + '.binrow{display:flex;gap:8px;margin:10px 0;flex-wrap:wrap}'
+    + '.bin{border:1.5px solid #d2d2d7;background:#fff;border-radius:999px;padding:8px 20px;font-size:14px;cursor:pointer;min-height:44px}'
+    + '.bin.on-take{background:#34c759;color:#fff;border-color:#34c759;font-weight:800}'
+    + '.bin.on-leave{background:#ff3b30;color:#fff;border-color:#ff3b30;font-weight:800}'
+    + '.btnrow{display:grid;grid-template-columns:1fr 1fr;gap:8px;margin-top:12px}'
+    + '.btn{border:none;background:#007aff;color:#fff;border-radius:999px;padding:10px 12px;font-weight:700;cursor:pointer;font-size:13.5px;min-height:44px}'
+    + '.btn.ghost{background:#fff;color:#007aff;border:1.5px solid #007aff}'
+    + 'details{margin:14px 0;font-size:13px;color:#6e6e73}'
+    + 'pre{white-space:pre-wrap;word-break:break-all;background:#f8f9fb;border-radius:10px;padding:10px;font-size:12px}'
+    + '@media(max-width:820px){.hero{padding:18px 14px}.sec{padding:14px}.btnrow{grid-template-columns:1fr}}';
+const JS = 'function copyText(t){if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(t);}else{var ta=document.createElement("textarea");ta.value=t;document.body.appendChild(ta);ta.select();try{document.execCommand("copy");}catch(e){}document.body.removeChild(ta);}}'
+    + 'function setBin(btn){var box=btn.parentNode;box.querySelectorAll(".bin").forEach(function(x){x.classList.remove("on-take","on-leave");});'
+    + 'btn.classList.add(btn.dataset.v==="带走"?"on-take":"on-leave");}'
+    + 'function moveCmd(kind){'
+    + 'if(kind==="take")copyText("请加载「居家管家」技能,帮我搬家打包(唤醒词:搬家盘点):\\n\\n  带走: 全部");'
+    + 'else if(kind==="leave")copyText("请加载「居家管家」技能,帮我搬家打包(唤醒词:搬家盘点):\\n\\n  不带走: 全部");'
+    + 'else if(kind==="commit")copyText("请加载「居家管家」技能,帮我搬家打包(唤醒词:搬家盘点):\\n\\n  带走: ______\\n  不带走: ______\\n  确认提交");'
+    + 'else if(kind==="list")copyText("请加载「居家管家」技能,帮我搬家打包(唤醒词:搬家盘点):\\n\\n  清单: 随全屋实际标记展开");}'
+    + 'function moveLog(){var d=new Date();function p(n){return (n<10?"0":"")+n;}var b=document.querySelector(".bin.on-take")?"全部带走":(document.querySelector(".bin.on-leave")?"全部不带走":"未标记");copyText("搬家盘点｜"+d.getFullYear()+"-"+p(d.getMonth()+1)+"-"+p(d.getDate())+" "+p(d.getHours())+":"+p(d.getMinutes())+":"+p(d.getSeconds())+"｜清单状态"+document.getElementById("movestate").textContent+"｜"+b);}';
+function str(v) { return typeof v === 'string' ? v : ''; }
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 二态标记清单真页面。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/items/move_checklist.html', import.meta.url), 'utf8');
+    const data = (env.data ?? {});
+    const committed = str(data.message).includes('已提交');
+    const stateText = committed ? '已提交' : '未提交';
+    // #817：导语原先把两个按钮名（带走／不带走）又说了一遍，页上同一对词出现三处；改成只说分组与逐件过一遍。
+    const content = '<div class="hero"><p class="eyebrow">标记后确认</p><p class="lead">全屋清单按位置分组，逐件过一遍</p></div>'
+        + '<section class="sec" data-block="fields" data-need="' + NEED.fields + '"><h2>分组</h2>'
+        + '<dl class="kv"><dt>清单状态</dt><dd id="movestate">' + escapeHtml(stateText) + '</dd></dl>'
+        // 物品编号与位置需数据：信封只带清单状态一句回执（物品行由命令侧增补），这一格保持「—」，不编。
+        + '<h2>物品编号与位置</h2><p class="lead">—</p>'
+        + '<h2>二态标记</h2><div class="binrow"><button class="bin" data-v="带走" onclick="setBin(this)">带走</button>'
+        + '<button class="bin" data-v="不带走" onclick="setBin(this)">不带走</button></div></section>'
+        + '<section class="sec" data-block="status" data-need="' + NEED.status + '" hidden></section>'
+        + '<section class="sec" data-block="operations" data-need="' + NEED.operations + '"><h2>动作</h2>'
+        + '<div class="btnrow"><button class="btn ghost" onclick="moveCmd(\'take\')">全带走</button>'
+        + '<button class="btn ghost" onclick="moveCmd(\'leave\')">全不带走</button>'
+        + '<button class="btn" onclick="moveCmd(\'commit\')">统一确认</button>'
+        + '<button class="btn ghost" onclick="moveCmd(\'list\')">复制清单</button>'
+        + '</div>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '</section>'
+        + '<section hidden class="sec" data-block="empty" data-need="' + NEED.empty + '"><h2>空态说明</h2>'
+        // #817：「本页无空态，清单恒在」是判据件口径的自述（与空清单自相矛盾），换成真正的空态引导。
+        + '<p class="lead">清单里还没有物品，先录物品再来标记</p></section>'
+        + '<details><summary>数据原文</summary><pre class="pre-block-code" id="raw">' + escapeHtml(JSON.stringify(env.data ?? {})) + '</pre></details>'
+        + '<style>' + CSS + '</style><script>' + JS + '</script>';
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=move_checklist.js.map

package/dist/items/pages/move_checklist.js.map

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

package/dist/items/pages/photo_wall.d.ts

@@ -0,0 +1,21 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "photo_wall";
+export declare const PAGE_META: {
+    readonly domain: "items";
+    readonly family: "photo_wall";
+    readonly key: "home.item.search";
+    readonly shape: "list";
+    readonly preset: Record<string, unknown>;
+    readonly scenarios: readonly string[];
+};
+export declare const REQUIRED_BLOCKS: {
+    readonly fields: readonly string[];
+    readonly operations: readonly string[];
+    readonly empty: readonly string[];
+    readonly status: readonly string[];
+};
+export declare function renderFamilyPage(env: Envelope, ctx?: {
+    readonly command?: string;
+    readonly actionAt?: string;
+}): string;
+//# sourceMappingURL=photo_wall.d.ts.map

package/dist/items/pages/photo_wall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo_wall.d.ts","sourceRoot":"","sources":["../../../src/items/pages/photo_wall.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,YAAqB,CAAC;AAE5C,eAAO,MAAM,SAAS;;;;;qBAKK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;wBAC1B,SAAS,MAAM,EAAE;CAC/B,CAAC;AAEX,eAAO,MAAM,eAAe,EA2BvB;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AA4DF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAyDvH"}

package/dist/items/pages/photo_wall.js

@@ -0,0 +1,145 @@
+// items能力·photo_wall真页面（#808 域票填内容，5-3 照片墙）。
+//
+// 信息结构对齐老 `物品/photo_wall.html`：分组＋照片网格＋补拍引导，网格墙版式。
+// 按位置分组的墙直接挂在「分组」标题下（这些墙就是照片网格，块名留 data-need 追溯）；类型 chips 归「照片类型」块。
+// 信封只带条目卡（无二进制图）：格面只写名称（位置由分组标题承担），点图复制详情 prompt。
+// 必需块原文＝契约附录：含拉丁字符的块（补充态：还有N件无照片→去补拍、
+// 点图复制详情prompt）只进 data-need 属性，其余块进真实 UI。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'photo_wall';
+export const PAGE_META = {
+    domain: 'items',
+    family: FAMILY,
+    key: 'home.item.search',
+    shape: 'list',
+    preset: { "wall": true },
+    scenarios: ["5-3"],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：没有带照片的物品",
+        "补充态：还有N件无照片→去补拍",
+        "异常：数据解析失败"
+    ],
+    "fields": [
+        "分组（分类/位置）",
+        "照片网格",
+        "无照片件数"
+    ],
+    "operations": [
+        "全部",
+        "类型筛选",
+        "去补拍",
+        "按位置浏览",
+        "点图复制详情prompt",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "照片类型",
+        "普通",
+        "说明书-使用",
+        "说明书-安装",
+        "说明书-保养"
+    ]
+};
+const NEED = {
+    fields: REQUIRED_BLOCKS.fields.join('|'),
+    operations: REQUIRED_BLOCKS.operations.join('|'),
+    empty: REQUIRED_BLOCKS.empty.join('|'),
+    status: REQUIRED_BLOCKS.status.join('|'),
+};
+const CSS = '.hero{background:linear-gradient(180deg,#fff,#f8fbff);border-radius:20px;padding:22px;margin:14px 0}'
+    + '.eyebrow{color:#007aff;font-size:12px;font-weight:800;letter-spacing:.1em;margin-bottom:6px}'
+    + '.lead{color:#6e6e73;font-size:14px}'
+    + '.sec{background:#fff;border-radius:16px;padding:18px;margin:14px 0}'
+    + '.sec h2{font-size:17px;margin-bottom:10px}'
+    + 'summary{min-height:44px;display:flex;align-items:center;cursor:pointer}'
+    + '.sec h3{font-size:15px;margin:12px 0 8px}'
+    + '.chips{display:flex;gap:8px;flex-wrap:wrap;margin:10px 0}'
+    + '.chip{border:1.5px solid #d2d2d7;background:#fff;border-radius:999px;padding:6px 14px;font-size:13px;cursor:pointer;min-height:44px}'
+    + '.chip.on{border-color:#007aff;background:#f5f8ff;color:#007aff;font-weight:700}'
+    + '.wall{display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:10px}'
+    + '.tile{aspect-ratio:1;border-radius:12px;background:#f0f3f8;overflow:hidden;cursor:pointer;position:relative;border:none;padding:0;text-align:left}'
+    + '.tile .nm{position:absolute;left:0;right:0;bottom:0;background:linear-gradient(transparent,rgba(0,0,0,.72));color:#fff;font-size:12px;padding:14px 8px 6px}'
+    + '.tile .has{position:absolute;top:6px;right:6px;background:rgba(0,0,0,.6);color:#fff;font-size:10px;border-radius:6px;padding:2px 6px}'
+    + '.warnbox{border-left:3px solid #ff9500;background:#fff8e8;padding:10px 14px;border-radius:8px;margin:8px 0;font-size:14px}'
+    + '.btnrow{display:grid;grid-template-columns:1fr 1fr;gap:8px;margin-top:12px}'
+    + '.btn{border:none;background:#007aff;color:#fff;border-radius:999px;padding:10px 12px;font-weight:700;cursor:pointer;font-size:13.5px;min-height:44px}'
+    + '.btn.ghost{background:#fff;color:#007aff;border:1.5px solid #007aff}'
+    + '.empty{color:#86868b;padding:12px 0}'
+    + '.count{color:#6e6e73;font-size:13px}'
+    + 'details{margin:14px 0;font-size:13px;color:#6e6e73}'
+    + 'pre{white-space:pre-wrap;word-break:break-all;background:#f8f9fb;border-radius:10px;padding:10px;font-size:12px}'
+    + '@media(max-width:820px){.hero{padding:18px 14px}.sec{padding:14px}.wall{grid-template-columns:repeat(auto-fill,minmax(110px,1fr))}.btnrow{grid-template-columns:1fr}}';
+const JS = 'function copyText(t){if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(t);}else{var ta=document.createElement("textarea");ta.value=t;document.body.appendChild(ta);ta.select();try{document.execCommand("copy");}catch(e){}document.body.removeChild(ta);}}'
+    + 'function tileDetail(btn){var nm=btn.dataset.nm||"物品";copyText("请加载「居家管家」技能,帮我查看物品详情(唤醒词:看物品):\\n\\n  物  品: "+nm);}'
+    + 'function wallCmd(kind){var L=["请加载「居家管家」技能,帮我浏览照片墙(唤醒词:照片墙):"];'
+    + 'if(kind==="loc")L.push("", "  分  组: 按位置");'
+    + 'else if(kind==="add")L.push("", "  动  作: 给没照片的物品补拍","","【照片即将发送:】");'
+    + 'copyText(L.join("\\n"));}'
+    + 'function chipType(btn){document.querySelectorAll(".chip").forEach(function(x){x.classList.remove("on");});btn.classList.add("on");'
+    + 'var t=btn.textContent;var hint=document.getElementById("typehint");if(hint)hint.style.display=(t==="全部")?"none":"block";}'
+    + 'function wallLog(){var d=new Date();function p(n){return (n<10?"0":"")+n;}copyText("照片墙｜"+d.getFullYear()+"-"+p(d.getMonth()+1)+"-"+p(d.getDate())+" "+p(d.getHours())+":"+p(d.getMinutes())+":"+p(d.getSeconds())+"｜共"+document.querySelectorAll(".tile").length+"张照片｜"+document.querySelectorAll(".wall").length+"个位置分组");}';
+function str(v) { return typeof v === 'string' ? v : ''; }
+function groupOf(loc) {
+    const s = str(loc).split('×')[0].split('[')[0].trim();
+    const head = s.split('/')[0].trim();
+    return head === '' || head === '(无位置)' ? '未分组' : head;
+}
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 网格墙真页面。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/items/photo_wall.html', import.meta.url), 'utf8');
+    const data = (env.data ?? {});
+    const rawItems = Array.isArray(data.items) ? data.items : [];
+    const total = typeof data.total === 'number' ? data.total : rawItems.length;
+    const cards = rawItems.map((c) => ({
+        id: typeof c.id === 'number' ? c.id : 0,
+        name: str(c.name) || '未命名',
+        loc: str(c.location) || '—',
+        qty: typeof c.quantity === 'number' ? c.quantity : 1,
+    }));
+    const groups = new Map();
+    for (const c of cards) {
+        const g = groupOf(c.loc);
+        const list = groups.get(g) ?? [];
+        list.push(c);
+        groups.set(g, list);
+    }
+    const groupHtml = [...groups.entries()].map(([g, list]) => '<h3>' + escapeHtml(g) + ' <span class="count">' + list.length + '</span></h3>'
+        + '<div class="wall">' + list.map((c) => '<button class="tile" data-nm="' + escapeHtml(c.name) + '" onclick="tileDetail(this)">'
+        + '<span class="has">有照片</span>'
+        + '<span class="nm">' + escapeHtml(c.name) + '</span></button>').join('') + '</div>').join('');
+    const bodyWall = cards.length > 0
+        ? groupHtml
+        : '<div class="empty">没有带照片的物品</div>';
+    const typeHint = '<p class="lead" id="typehint" style="display:none">该类型下暂无照片</p>';
+    const content = '<div class="hero"><p class="eyebrow">查看</p><p class="lead">回忆式浏览，按位置分组，共' + total + '张</p></div>'
+        + '<section class="sec" data-block="fields" data-need="' + NEED.fields + '"><h2>分组</h2>'
+        + bodyWall
+        + '<p class="lead">点图复制该物品的详情查看指令</p>'
+        // 无照片件数需数据：信封只带带照片的墙体件（search 侧已滤掉无照片件），全库件数不在信封里；
+        // 算不出就写「—」，值为 0 或拿不到时不出「去补拍」那颗按钮。
+        + '<h2>无照片件数</h2><div class="warnbox">—</div>'
+        + '</section>'
+        + '<section class="sec" data-block="status" data-need="' + NEED.status + '"><h2>照片类型</h2>'
+        + '<div class="chips"><button class="chip on" onclick="chipType(this)">全部</button>'
+        + ['普通', '说明书-使用', '说明书-安装', '说明书-保养'].map((t) => '<button class="chip" onclick="chipType(this)">' + escapeHtml(t) + '</button>').join('')
+        + '</div>' + typeHint + '</section>'
+        + '<section class="sec" data-block="operations" data-need="' + NEED.operations + '"><h2>动作</h2>'
+        + '<div class="btnrow">'
+        + '<button class="btn ghost" onclick="wallCmd(\'loc\')">按位置浏览</button>'
+        + '</div>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '</section>'
+        + '<section class="sec" data-block="empty" data-need="' + NEED.empty + '" hidden></section>'
+        + '<details><summary>数据原文</summary><pre class="pre-block-code" id="raw">' + escapeHtml(JSON.stringify(env.data ?? {})) + '</pre></details>'
+        + '<style>' + CSS + '</style><script>' + JS + '</script>';
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=photo_wall.js.map

package/dist/items/pages/photo_wall.js.map

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

package/dist/items/pages/photos.d.ts

@@ -0,0 +1,21 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "photos";
+export declare const PAGE_META: {
+    readonly domain: "items";
+    readonly family: "photos";
+    readonly key: "home.item.detail";
+    readonly shape: "detail";
+    readonly preset: Record<string, unknown>;
+    readonly scenarios: readonly string[];
+};
+export declare const REQUIRED_BLOCKS: {
+    readonly fields: readonly string[];
+    readonly operations: readonly string[];
+    readonly empty: readonly string[];
+    readonly status: readonly string[];
+};
+export declare function renderFamilyPage(env: Envelope, ctx?: {
+    readonly command?: string;
+    readonly actionAt?: string;
+}): string;
+//# sourceMappingURL=photos.d.ts.map

package/dist/items/pages/photos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photos.d.ts","sourceRoot":"","sources":["../../../src/items/pages/photos.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,QAAiB,CAAC;AAExC,eAAO,MAAM,SAAS;;;;;qBAKS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;wBACxB,SAAS,MAAM,EAAE;CACrC,CAAC;AAEX,eAAO,MAAM,eAAe,EA0BvB;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AA6EF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAwEvH"}

package/dist/items/pages/photos.js

@@ -0,0 +1,180 @@
+// items能力·photos真页面（#808 域票填内容，5-1 查看照片／5-2 管照片共用一族）。
+//
+// 信息结构对齐老 `物品/photos.html`：主图大图＋缩略图＋类型 chips＋管理动作。
+// 双态按 envelope key 分流：home.item.detail＝查看，home.item.update＝管理。
+// 必需块原文＝契约附录（事实源）：含拉丁字符的块（物品（名称/ID）、当前mode）只进
+// data-need 属性（机审英文裸词行零容忍，属性对机审不可见、对块门可见），其余块进真实 UI。
+// 照片类型筛选默认走全部（类型无 schema 落点，见 #857，域票不伪造类型）。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'photos';
+export const PAGE_META = {
+    domain: 'items',
+    family: FAMILY,
+    key: 'home.item.detail',
+    shape: 'detail',
+    preset: { "view": "photos" },
+    scenarios: ["5-1", "5-2"],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：暂无照片＋补拍引导",
+        "异常：数据解析失败"
+    ],
+    "fields": [
+        "物品（名称/ID）",
+        "照片列表（顺序/类型/主图标记）",
+        "当前mode"
+    ],
+    "operations": [
+        "全部",
+        "类型筛选",
+        "确认顺序变更",
+        "加图·补拍",
+        "删除选中",
+        "下载照片",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "普通",
+        "说明书-使用",
+        "说明书-安装",
+        "说明书-保养"
+    ]
+};
+const NEED = {
+    fields: '物品（名称/ID）|照片列表（顺序/类型/主图标记）|当前mode',
+    operations: '全部|类型筛选|确认顺序变更|加图·补拍|删除选中|下载照片|复制数据|复制日志',
+    empty: '空态：暂无照片＋补拍引导|异常：数据解析失败',
+    status: '普通|说明书-使用|说明书-安装|说明书-保养',
+};
+const CSS = '.hero{background:linear-gradient(180deg,#fff,#f8fbff);border-radius:20px;padding:22px;margin:14px 0}'
+    + '.lead{color:#6e6e73;font-size:14px}'
+    + '.sec{background:#fff;border-radius:16px;padding:18px;margin:14px 0}'
+    + '.sec h2{font-size:17px;margin-bottom:10px}'
+    + 'summary{min-height:44px;display:flex;align-items:center;cursor:pointer}'
+    + '.kv{display:grid;grid-template-columns:76px 1fr;gap:4px 10px;font-size:14px}'
+    + '.kv dt{color:#86868b}.kv dd{color:#1d1d1f}'
+    + '.main{min-height:180px;border-radius:14px;background:#f0f3f8;display:flex;align-items:center;justify-content:center;color:#86868b;margin:8px 0}'
+    + '.chips{display:flex;gap:8px;flex-wrap:wrap;margin:10px 0}'
+    + '.chip{border:1.5px solid #d2d2d7;background:#fff;border-radius:999px;padding:6px 14px;font-size:13px;cursor:pointer;min-height:44px}'
+    + '.chip.on{border-color:#007aff;background:#f5f8ff;color:#007aff;font-weight:700}'
+    + '.btnrow{display:grid;grid-template-columns:1fr 1fr;gap:8px;margin-top:12px}'
+    + '.btn{border:none;background:#007aff;color:#fff;border-radius:999px;padding:10px 12px;font-weight:700;cursor:pointer;font-size:13.5px;min-height:44px}'
+    + '.btn.ghost{background:#fff;color:#007aff;border:1.5px solid #007aff}'
+    + '.btn.red{background:#ff3b30}'
+    + '.btn.wide{grid-column:1/-1}'
+    + '.empty{color:#86868b;padding:12px 0}'
+    + 'details{margin:14px 0;font-size:13px;color:#6e6e73}'
+    + 'pre{white-space:pre-wrap;word-break:break-all;background:#f8f9fb;border-radius:10px;padding:10px;font-size:12px}'
+    + '@media(max-width:820px){.hero{padding:18px 14px}.sec{padding:14px}.btnrow{grid-template-columns:1fr}}';
+const JS = 'function copyText(t){if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(t);}else{var ta=document.createElement("textarea");ta.value=t;document.body.appendChild(ta);ta.select();try{document.execCommand("copy");}catch(e){}document.body.removeChild(ta);}}'
+    + 'function photoAct(btn,kind){var nm=btn.dataset.nm||"物品";var id=btn.dataset.id||"";'
+    + 'var L=["请加载「居家管家」技能,帮我管照片(唤醒词:管照片):","","  物  品: "+nm+"(编号"+id+")"];'
+    + 'if(kind==="order")L.push("  动  作: 换主图,新顺序: ______");'
+    + 'else if(kind==="add")L.push("  动  作: 加图");'
+    + 'else if(kind==="shoot")L.push("  动  作: 补拍","","【照片即将发送:】");'
+    + 'else if(kind==="del")L.push("  动  作: 删除第 ______ 张");'
+    + 'else if(kind==="dl")L.push("  动  作: 下载照片");'
+    + 'copyText(L.join("\\n"));}'
+    + 'function chipType(btn){document.querySelectorAll(".chip").forEach(function(x){x.classList.remove("on");});btn.classList.add("on");}';
+function str(v) { return typeof v === 'string' ? v : ''; }
+function num(v) { return typeof v === 'number' && Number.isInteger(v) ? v : null; }
+// 管理态回执带 `detail.snapshot`（#864 加厚）：位置那一件已经拆成 location／quantity／status
+// 三件，本页按这三件逐格渲染（#817 seq 23「值位拆列」）。形状不对（旧信封／缺字段）返 null，
+// 页面退回顶层 item＋回执编号，不让缺字段变成半个空页。
+function snapshotOf(data) {
+    const det = data.detail;
+    if (!det || typeof det !== 'object' || Array.isArray(det))
+        return null;
+    const raw = det.snapshot;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return null;
+    const s = raw;
+    const id = num(s.id);
+    if (id === null)
+        return null;
+    const locs = Array.isArray(s.locations) ? s.locations : [];
+    const tags = Array.isArray(s.tags) ? s.tags : [];
+    return {
+        id,
+        name: str(s.name),
+        category: str(s.category),
+        locations: locs
+            .filter((l) => !!l && typeof l === 'object' && !Array.isArray(l))
+            .map((l) => ({ location: str(l.location), quantity: num(l.quantity) ?? 0, status: str(l.status) })),
+        tags: tags.map((t) => String(t)),
+    };
+}
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 真页面。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/items/photos.html', import.meta.url), 'utf8');
+    const data = (env.data ?? {});
+    const manage = env.key === 'home.item.update';
+    const modeText = manage ? '管理' : '查看';
+    const item = (data.item ?? {});
+    const id = num(item.id);
+    const name = str(item.name);
+    const photo = str(item.photo);
+    const message = str(data.message);
+    // 管理态（改物品 op=photo）回执的 `detail.snapshot` 里名称／分类／标签／位置俱在，卡片读它；
+    // 只有旧信封（无 detail）才退回回执编号与「—」。
+    const snap = snapshotOf(data);
+    const idText = snap !== null
+        ? String(snap.id)
+        : id === null ? (manage ? message.match(/[：:]\s*(\d+)/)?.[1] ?? '—' : '—') : String(id);
+    const kvRows = [];
+    if (snap !== null) {
+        kvRows.push(['名称', snap.name || '—'], ['编号', idText]);
+        for (const l of snap.locations) {
+            kvRows.push(['位置', l.location || '—'], ['数量', String(l.quantity)], ['状态', l.status || '—']);
+        }
+        kvRows.push(['分类', snap.category || '—'], ['标签', snap.tags.length > 0 ? snap.tags.join('、') : '—']);
+    }
+    else {
+        // 详情态回执只给复合串（`客厅/阳台柜×1[在家]`），位置路径拆不出来（需数据层，见 #817 seq 22）；
+        // 串里已经带了件数与状态，故不再另立「数量」格——同一数据只说一遍。
+        kvRows.push(['名称', name || '—'], ['编号', idText], ['位置', str(item.location) || '—'], ['分类', str(item.category) || '—'], ['标签', str(item.tags) || '—']);
+    }
+    const kvHtml = kvRows
+        .map(([k, v]) => '<dt>' + escapeHtml(k) + '</dt><dd>' + escapeHtml(v) + '</dd>').join('');
+    const photoBox = photo !== ''
+        ? '<div class="main">主图共一张</div>'
+        : manage && message !== ''
+            ? '<div class="main">—</div>'
+            : '<div class="empty">暂无照片。点下方「补拍」给这件物品留影。</div>';
+    const receipt = manage && message !== ''
+        ? '<div class="sec"><h2>管理回执</h2><p>' + escapeHtml(message) + '</p></div>'
+        : '';
+    // 头卡只说一次当前模式（此前 eyebrow 的「查看／排序确认」与这句重复一个词，见 #817 seq 22 的 ⑤）。
+    const content = '<div class="hero">'
+        + '<p class="lead">首张为主图，共四种类型，当前模式：' + escapeHtml(modeText) + '</p></div>'
+        + '<section class="sec" data-block="fields" data-need="' + NEED.fields + '"><h2>物品</h2>'
+        + '<dl class="kv">' + kvHtml + '</dl></section>'
+        + '<section class="sec" data-block="status" data-need="' + NEED.status + '"><h2>照片列表</h2>'
+        + photoBox
+        + '<div class="chips"><button class="chip on" onclick="chipType(this)">全部</button>'
+        + ['普通', '说明书-使用', '说明书-安装', '说明书-保养'].map((t) => '<button class="chip" onclick="chipType(this)">' + escapeHtml(t) + '</button>').join('')
+        + '</div></section>'
+        + receipt
+        + '<section class="sec" data-block="operations" data-need="' + NEED.operations + '"><h2>动作</h2>'
+        + '<div class="btnrow">'
+        + '<button class="btn ghost" data-act="order" data-nm="' + escapeHtml(name) + '" data-id="' + escapeHtml(idText) + '" onclick="photoAct(this,\'order\')">确认顺序变更</button>'
+        + '<button class="btn ghost" data-act="add" data-nm="' + escapeHtml(name) + '" data-id="' + escapeHtml(idText) + '" onclick="photoAct(this,\'add\')">加图</button>'
+        + '<button class="btn ghost" data-act="shoot" data-nm="' + escapeHtml(name) + '" data-id="' + escapeHtml(idText) + '" onclick="photoAct(this,\'shoot\')">补拍</button>'
+        + '<button class="btn red" data-act="del" data-nm="' + escapeHtml(name) + '" data-id="' + escapeHtml(idText) + '" onclick="photoAct(this,\'del\')">删除选中</button>'
+        + '<button class="btn ghost wide" data-act="dl" data-nm="' + escapeHtml(name) + '" data-id="' + escapeHtml(idText) + '" onclick="photoAct(this,\'dl\')">下载照片</button>'
+        + '</div>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '</section>'
+        + '<section class="sec" data-block="empty" data-need="' + NEED.empty + '" hidden></section>'
+        + '<details><summary>数据原文</summary><pre class="pre-block-code" id="raw">' + escapeHtml(JSON.stringify(env.data ?? {})) + '</pre></details>'
+        + '<style>' + CSS + '</style><script>' + JS + '</script>';
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=photos.js.map

package/dist/items/pages/photos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photos.js","sourceRoot":"","sources":["../../../src/items/pages/photos.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,mDAAmD;AACnD,+DAA+D;AAC/D,8CAA8C;AAC9C,qDAAqD;AACrD,6CAA6C;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1G,MAAM,CAAC,MAAM,MAAM,GAAG,QAAiB,CAAC;AAExC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,kBAAkB;IACvB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAA4B;IACpD,SAAS,EAAE,CAAC,KAAK,EAAC,KAAK,CAAsB;CACrC,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE;QACP,cAAc;QACd,WAAW;KACZ;IACD,QAAQ,EAAE;QACR,WAAW;QACX,kBAAkB;QAClB,QAAQ;KACT;IACD,YAAY,EAAE;QACZ,IAAI;QACJ,MAAM;QACN,QAAQ;QACR,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;KACP;IACD,QAAQ,EAAE;QACR,IAAI;QACJ,QAAQ;QACR,QAAQ;QACR,QAAQ;KACT;CAMF,CAAC;AAEF,MAAM,IAAI,GAAG;IACX,MAAM,EAAE,mCAAmC;IAC3C,UAAU,EAAE,0CAA0C;IACtD,KAAK,EAAE,wBAAwB;IAC/B,MAAM,EAAE,yBAAyB;CACzB,CAAC;AAEX,MAAM,GAAG,GAAG,sGAAsG;MAChH,qCAAqC;MACrC,qEAAqE;MACrE,4CAA4C;MAC5C,yEAAyE;MACzE,8EAA8E;MAC9E,4CAA4C;MAC5C,iJAAiJ;MACjJ,2DAA2D;MAC3D,sIAAsI;MACtI,iFAAiF;MACjF,6EAA6E;MAC7E,uJAAuJ;MACvJ,sEAAsE;MACtE,8BAA8B;MAC9B,6BAA6B;MAC7B,sCAAsC;MACtC,qDAAqD;MACrD,kHAAkH;MAClH,uGAAuG,CAAC;AAE1G,MAAM,EAAE,GAAG,gSAAgS;MACzS,oFAAoF;MACpF,sEAAsE;MACtE,sDAAsD;MACtD,4CAA4C;MAC5C,6DAA6D;MAC7D,sDAAsD;MACtD,6CAA6C;MAC7C,2BAA2B;MAC3B,qIAAqI,CAAC;AAExI,SAAS,GAAG,CAAC,CAAU,IAAY,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE3E,SAAS,GAAG,CAAC,CAAU,IAAmB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAQ3G,uEAAuE;AACvE,wDAAwD;AACxD,gCAAgC;AAChC,SAAS,UAAU,CAAC,IAA6B;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,MAAM,GAAG,GAAI,GAA+B,CAAC,QAAQ,CAAC;IACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrB,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,OAAO;QACL,EAAE;QACF,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACjB,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzB,SAAS,EAAE,IAAI;aACZ,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;aAC9F,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrG,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,sCAAsC;AACtC,8CAA8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,GAAa,EAAE,GAA+D;IAC7G,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,GAAG,CAAC,sCAAsC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACxG,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IACzD,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,kBAAkB,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IAC1D,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,GAAG,CAAE,IAAgC,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,GAAG,CAAE,IAAgC,CAAC,OAAO,CAAC,CAAC;IAC/D,8DAA8D;IAC9D,8BAA8B;IAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,KAAK,IAAI;QAC1B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjB,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAE1F,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtG,CAAC;SAAM,CAAC;QACN,2DAA2D;QAC3D,oCAAoC;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAChF,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM;SAClB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE5F,MAAM,QAAQ,GAAG,KAAK,KAAK,EAAE;QAC3B,CAAC,CAAC,+BAA+B;QACjC,CAAC,CAAC,MAAM,IAAI,OAAO,KAAK,EAAE;YACxB,CAAC,CAAC,2BAA2B;YAC7B,CAAC,CAAC,+CAA+C,CAAC;IAEtD,MAAM,OAAO,GAAG,MAAM,IAAI,OAAO,KAAK,EAAE;QACtC,CAAC,CAAC,mCAAmC,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,YAAY;QAC1E,CAAC,CAAC,EAAE,CAAC;IAEP,+DAA+D;IAC/D,MAAM,OAAO,GAAG,oBAAoB;UAChC,mCAAmC,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,YAAY;UACzE,sDAAsD,GAAG,IAAI,CAAC,MAAM,GAAG,eAAe;UACtF,iBAAiB,GAAG,MAAM,GAAG,iBAAiB;UAC9C,sDAAsD,GAAG,IAAI,CAAC,MAAM,GAAG,iBAAiB;UACxF,QAAQ;UACR,iFAAiF;UACjF,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gDAAgD,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;UACxI,kBAAkB;UAClB,OAAO;UACP,0DAA0D,GAAG,IAAI,CAAC,UAAU,GAAG,eAAe;UAC9F,sBAAsB;UACtB,sDAAsD,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,sDAAsD;UACvK,oDAAoD,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,gDAAgD;UAC/J,sDAAsD,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,kDAAkD;UACnK,kDAAkD,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,kDAAkD;UAC/J,wDAAwD,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,iDAAiD;UACpK,QAAQ;UACR,YAAY,CAAC;YACX,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE;YACvB,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,gBAAgB,GAAG,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,IAAI,YAAY,EAAE,EAAE,CAAC,EAAE;SACvJ,CAAC;UACF,YAAY;UACZ,qDAAqD,GAAG,IAAI,CAAC,KAAK,GAAG,qBAAqB;UAC1F,uEAAuE,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,kBAAkB;UACzI,SAAS,GAAG,GAAG,GAAG,kBAAkB,GAAG,EAAE,GAAG,WAAW,CAAC;IAC5D,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/items/pages/receipt.d.ts

@@ -0,0 +1,21 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "receipt";
+export declare const PAGE_META: {
+    readonly domain: "items";
+    readonly family: "receipt";
+    readonly key: "home.item.update";
+    readonly shape: "receipt";
+    readonly preset: Record<string, unknown>;
+    readonly scenarios: readonly string[];
+};
+export declare const REQUIRED_BLOCKS: {
+    readonly fields: readonly string[];
+    readonly operations: readonly string[];
+    readonly empty: readonly string[];
+    readonly status: readonly string[];
+};
+export declare function renderFamilyPage(env: Envelope, ctx?: {
+    readonly command?: string;
+    readonly actionAt?: string;
+}): string;
+//# sourceMappingURL=receipt.d.ts.map

package/dist/items/pages/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../../src/items/pages/receipt.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,SAAkB,CAAC;AAEzC,eAAO,MAAM,SAAS;;;;;qBAKK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;wBACR,SAAS,MAAM,EAAE;CACjD,CAAC;AAEX,eAAO,MAAM,eAAe,EAuBvB;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAyHF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoGvH"}