skill-home 0.3.1 → 0.3.13

package/dist/render/sceneNaming.js

@@ -0,0 +1,173 @@
+// 共用渲染·场景命名（#801 新立；#859 命名纪律改版：文件名不再拼场景 id）。
+//
+// 规矩（`docs/skills/skill-home/naming-chain-precedent.md` §一）：运行期只认命令键／命令中文名／
+// 页族名三条词表；场景 id 这类字母码只许住事实源与机器附录，不得出现在标识符、运行期值、
+// 注释或**产物文件名**里。故本件只出 `<命令中文名>` 这一段，戳由共用件 `base-paint/save-html` 加。
+// 行表出处＝机器附录 `docs/skills/skill-home/scene-pages-contract.appendix.json` 的 `scenarios`
+// （70 行，由 `test/html-delivery-801.test.mjs` 逐行对账，附录一改这里即红）。
+// 本件不读附录 JSON（附录住 `docs/`，不随包发布；运行时事实源只能是代码——
+// 照 `src/render/pageFamilies.ts` #800 先例）。
+//
+// 一处显式偏离（fail-closed，不静默）：附录里收纳建议（SM2-3）那一行的 preset 是
+// `{mode:"storage"}`，但运行期 `mode:"storage"` 走的是位置总览分支
+// （`src/space/location.ts:33` 的 manage/storage 共枝），行为与收纳建议不同；
+// 真收纳建议走 `mode:"suggest"`。故本件**不收**附录那一行：收纳建议（SM2-3）走 `suggest`、
+// 管位置（SM2-1）走 `storage` 的宿主回退（见下 HOST_ROWS），已向票 2 登记补丁流提案（证据
+// `docs/skills/skill-home/html-delivery-chain.md` §宿主回退表）。
+//
+// 宿主回退（HOST_ROWS）：运行时合法、但附录 70 行没有的组合，一律归宿到在册场景之一
+// （不发明新名——票面禁令「本票不自行决定文件名」）。归宿点＝同页族内行为一致的那一行
+// （证据里逐条点名）；匹配不到任何行即抛（调用方走 exit 5，大声失败）。
+import { HomeRenderError } from './errors.js';
+/* —— 70 行中的 69 行（附录逐字，唯收纳建议（SM2-3）的 storage 行除外，见件头偏离说明） —— */
+const EXACT_ROWS = [
+    { key: "home.item.add", preset: {}, commandCn: "录物品" },
+    { key: "home.item.add", preset: { "photo": "1" }, commandCn: "拍物品" },
+    { key: "home.item.add", preset: { "op": "batch" }, commandCn: "批量录入" },
+    { key: "home.item.add", preset: { "op": "backfill" }, commandCn: "补录" },
+    { key: "home.item.search", preset: {}, commandCn: "查物品" },
+    { key: "home.item.detail", preset: {}, commandCn: "看物品" },
+    { key: "home.item.search", preset: { "locate": true }, commandCn: "紧急定位" },
+    { key: "home.item.search", preset: { "browse": true }, commandCn: "筛选浏览" },
+    { key: "home.item.search", preset: { "photo": true }, commandCn: "拍照找物品" },
+    { key: "home.item.search", preset: { "dupes": true }, commandCn: "查重复" },
+    { key: "home.item.update", preset: {}, commandCn: "改物品" },
+    { key: "home.item.update", preset: { "op": "move" }, commandCn: "移物品" },
+    { key: "home.item.update", preset: { "op": "qty" }, commandCn: "数量变更" },
+    { key: "home.item.update", preset: { "op": "status" }, commandCn: "状态变更" },
+    { key: "home.item.update", preset: { "op": "merge" }, commandCn: "合并物品" },
+    { key: "home.item.update", preset: { "op": "undo" }, commandCn: "撤销操作" },
+    { key: "home.item.update", preset: { "op": "relate" }, commandCn: "物品关联" },
+    { key: "home.item.update", preset: { "op": "tags" }, commandCn: "标物品" },
+    { key: "home.tag.write", preset: { "op": "overview" }, commandCn: "管标签" },
+    { key: "home.tag.write", preset: { "op": "category" }, commandCn: "管分类" },
+    { key: "home.tag.write", preset: { "op": "tidy" }, commandCn: "整理建议" },
+    { key: "home.item.detail", preset: { "view": "photos" }, commandCn: "查看照片" },
+    { key: "home.item.update", preset: { "op": "photo" }, commandCn: "管照片" },
+    { key: "home.item.search", preset: { "wall": true }, commandCn: "照片墙" },
+    { key: "home.inventory.round", preset: { "op": "round" }, commandCn: "盘点" },
+    { key: "home.inventory.round", preset: { "op": "resolve" }, commandCn: "差异处理" },
+    { key: "home.inventory.records", preset: {}, commandCn: "盘点记录" },
+    { key: "home.inventory.round", preset: { "op": "move" }, commandCn: "搬家盘点" },
+    { key: "home.item.detail", preset: { "view": "history" }, commandCn: "历史" },
+    { key: "home.location.write", preset: { "op": "manage" }, commandCn: "管位置" },
+    { key: "home.location.write", preset: { "op": "fixed" }, commandCn: "固定位" },
+    { key: "home.location.query", preset: { "mode": "space" }, commandCn: "空间视图" },
+    { key: "home.outfit.pick", preset: {}, commandCn: "穿什么" },
+    { key: "home.outfit.pick", preset: { "kind": "wardrobe" }, commandCn: "衣橱分析" },
+    { key: "home.outfit.pick", preset: { "kind": "season" }, commandCn: "换季" },
+    { key: "home.trip.manage", preset: { "mode": "pack" }, commandCn: "出行清单" },
+    { key: "home.outfit.pick", preset: { "kind": "trip-plan" }, commandCn: "旅行穿搭" },
+    { key: "home.stats.overview", preset: { "kind": "summary" }, commandCn: "统物品" },
+    { key: "home.stats.alert", preset: { "kind": "idle" }, commandCn: "查闲置" },
+    { key: "home.stats.alert", preset: { "kind": "expiring" }, commandCn: "查过期" },
+    { key: "home.stats.overview", preset: { "kind": "inventory" }, commandCn: "盘点统计" },
+    { key: "home.shopping.query", preset: { "kind": "list" }, commandCn: "购物清单" },
+    { key: "home.shopping.query", preset: { "kind": "missing" }, commandCn: "缺货检测" },
+    { key: "home.shopping.query", preset: { "kind": "express" }, commandCn: "查快递" },
+    { key: "home.shopping.query", preset: { "kind": "stock" }, commandCn: "囤货盘点" },
+    { key: "home.ticket.query", preset: { "kind": "purchase" }, commandCn: "查购买记录" },
+    { key: "home.ticket.query", preset: { "kind": "purchase", "range": "last-month" }, commandCn: "查上月购买" },
+    { key: "home.ticket.query", preset: { "kind": "purchase", "range": "year" }, commandCn: "查今年花费" },
+    { key: "home.ticket.query", preset: { "kind": "purchase", "range": "return" }, commandCn: "查退货窗口" },
+    { key: "home.ticket.write", preset: { "kind": "purchase", "op": "add" }, commandCn: "登记购买记录" },
+    { key: "home.ticket.query", preset: { "kind": "warranty" }, commandCn: "查保修状态" },
+    { key: "home.ticket.write", preset: { "kind": "warranty", "op": "register" }, commandCn: "登记保修" },
+    { key: "home.ticket.write", preset: { "kind": "warranty", "op": "repair" }, commandCn: "记录维修" },
+    { key: "home.ticket.write", preset: { "kind": "warranty", "op": "cycle" }, commandCn: "设置保养周期" },
+    { key: "home.ticket.write", preset: { "kind": "warranty", "op": "maintain" }, commandCn: "执行保养" },
+    { key: "home.ticket.query", preset: { "kind": "cert" }, commandCn: "查证件到期" },
+    { key: "home.ticket.write", preset: { "kind": "cert", "op": "add" }, commandCn: "登记证件" },
+    { key: "home.ticket.write", preset: { "kind": "cert", "op": "archive" }, commandCn: "证件归档" },
+    { key: "home.ticket.write", preset: { "kind": "cert", "op": "update" }, commandCn: "更新证件" },
+    { key: "home.ticket.query", preset: { "kind": "account" }, commandCn: "查账号" },
+    { key: "home.ticket.write", preset: { "kind": "account", "op": "add" }, commandCn: "存账号" },
+    { key: "home.ticket.write", preset: { "kind": "account", "op": "update" }, commandCn: "改账号" },
+    { key: "home.ticket.write", preset: { "kind": "account", "op": "show" }, commandCn: "看密码" },
+    { key: "home.care.query", preset: { "kind": "borrow" }, commandCn: "借用" },
+    { key: "home.care.query", preset: { "kind": "member" }, commandCn: "家人档案" },
+    { key: "home.care.write", preset: { "kind": "init" }, commandCn: "首次使用" },
+    { key: "home.care.query", preset: { "kind": "lint" }, commandCn: "查异常" },
+    { key: "home.care.write", preset: { "kind": "backup" }, commandCn: "备份导出" },
+    { key: "home.care.write", preset: { "kind": "import" }, commandCn: "导入恢复" },
+];
+/* —— 宿主回退行（运行时合法、附录无行的组合；归宿理由见证据 §宿主回退表） —— */
+const HOST_ROWS = [
+    { key: "home.item.add", preset: { "photo": true }, commandCn: "拍物品" },
+    { key: "home.tag.query", preset: { "kind": "categories" }, commandCn: "管分类" },
+    { key: "home.tag.query", preset: { "kind": "category" }, commandCn: "管分类" },
+    { key: "home.tag.query", preset: {}, commandCn: "管标签" },
+    { key: "home.tag.write", preset: { "op": "merge" }, commandCn: "管标签" },
+    { key: "home.item.detail", preset: { "view": "wall" }, commandCn: "查看照片" },
+    { key: "home.location.query", preset: { "mode": "suggest" }, commandCn: "收纳建议" },
+    { key: "home.location.query", preset: { "mode": "find" }, commandCn: "空间视图" },
+    { key: "home.location.query", preset: { "mode": "storage" }, commandCn: "管位置" },
+    { key: "home.location.query", preset: { "mode": "manage" }, commandCn: "管位置" },
+    { key: "home.location.query", preset: {}, commandCn: "管位置" },
+    { key: "home.location.write", preset: {}, commandCn: "管位置" },
+    { key: "home.trip.manage", preset: { "mode": "return" }, commandCn: "出行清单" },
+    { key: "home.trip.manage", preset: {}, commandCn: "出行清单" },
+    { key: "home.stats.overview", preset: {}, commandCn: "统物品" },
+    { key: "home.stats.alert", preset: {}, commandCn: "查闲置" },
+    { key: "home.shopping.query", preset: {}, commandCn: "购物清单" },
+    { key: "home.shopping.write", preset: { "op": "list-add" }, commandCn: "购物清单" },
+    { key: "home.shopping.write", preset: { "op": "list-check" }, commandCn: "购物清单" },
+    { key: "home.shopping.write", preset: { "op": "check" }, commandCn: "购物清单" },
+    { key: "home.shopping.write", preset: { "op": "missing-to-list" }, commandCn: "缺货检测" },
+    { key: "home.shopping.write", preset: { "op": "stock-threshold" }, commandCn: "囤货盘点" },
+    { key: "home.shopping.write", preset: { "op": "stock-set-threshold" }, commandCn: "囤货盘点" },
+    { key: "home.shopping.write", preset: { "op": "stock-fix" }, commandCn: "囤货盘点" },
+    { key: "home.shopping.write", preset: { "op": "express-confirm" }, commandCn: "查快递" },
+    { key: "home.care.query", preset: {}, commandCn: "借用" },
+    { key: "home.care.query", preset: { "kind": "firstuse" }, commandCn: "首次使用" },
+    { key: "home.care.query", preset: { "kind": "first-use" }, commandCn: "首次使用" },
+    { key: "home.care.query", preset: { "kind": "backup-list" }, commandCn: "备份导出" },
+    { key: "home.care.write", preset: { "kind": "borrow" }, commandCn: "借用" },
+    { key: "home.care.write", preset: { "kind": "member" }, commandCn: "家人档案" },
+    { key: "home.care.write", preset: { "kind": "backup" }, commandCn: "备份导出" },
+    { key: "home.care.write", preset: { "kind": "export" }, commandCn: "备份导出" },
+    { key: "home.care.write", preset: { "kind": "import-preview" }, commandCn: "导入恢复" },
+    { key: "home.care.write", preset: { "kind": "import" }, commandCn: "导入恢复" },
+];
+/** 布尔预设的宽容比对：调用方传 true／"true"／"1"／1 皆算真（CLI 走 JSON，两路同形）。 */
+function toBool(v) {
+    if (typeof v === 'boolean')
+        return v;
+    if (typeof v === 'number')
+        return v === 1 ? true : v === 0 ? false : null;
+    if (typeof v === 'string') {
+        const s = v.trim().toLowerCase();
+        if (s === 'true' || s === '1')
+            return true;
+        if (s === 'false' || s === '0')
+            return false;
+    }
+    return null;
+}
+function entryMatches(rowVal, paramVal) {
+    if (typeof rowVal === 'boolean')
+        return toBool(paramVal) === rowVal;
+    return String(paramVal) === String(rowVal);
+}
+/** 行是否覆盖本次调用：行 preset 的每一项都在 params 里对上（子集语义；空 preset 恒覆盖）。 */
+function covers(row, params) {
+    return Object.entries(row.preset).every(([k, v]) => k in params && entryMatches(v, params[k]));
+}
+/**
+ * 命名解析：`(命令，场景预设） → 文件名主体`＝命令中文名（`<命令中文名>_<戳>.html` 的前半）。
+ * 先精确行（preset 越具体越优先），再宿主行；两表都定不了即抛（fail-closed，
+ * 调用方走 exit 5，不猜一个名字把两份产物写到同一份上）。
+ * 返回的就是场景的**面向用户的名字**：页面大标题、日志与产物名共用这一个值，不许各自拼。
+ */
+export function resolveSceneStem(key, params = {}) {
+    const bySize = (a, b) => Object.keys(b.preset).length - Object.keys(a.preset).length;
+    for (const table of [EXACT_ROWS, HOST_ROWS]) {
+        const hits = table.filter((r) => r.key === key && covers(r, params)).sort(bySize);
+        if (hits.length > 0) {
+            const hit = hits[0];
+            return hit.commandCn;
+        }
+    }
+    throw new HomeRenderError('HOME_UNKNOWN_SCENE', '[skill-home] 无命名归宿（缺失阻断，不猜）：' + key + ' ' + JSON.stringify(params));
+}
+//# sourceMappingURL=sceneNaming.js.map

package/dist/render/sceneNaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneNaming.js","sourceRoot":"","sources":["../../src/render/sceneNaming.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,4EAA4E;AAC5E,gDAAgD;AAChD,oEAAoE;AACpE,sFAAsF;AACtF,4DAA4D;AAC5D,8CAA8C;AAC9C,2CAA2C;AAC3C,EAAE;AACF,sDAAsD;AACtD,qDAAqD;AACrD,8DAA8D;AAC9D,iEAAiE;AACjE,6DAA6D;AAC7D,2DAA2D;AAC3D,EAAE;AACF,kDAAkD;AAClD,6CAA6C;AAC7C,yCAAyC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAS9C,+DAA+D;AAC/D,MAAM,UAAU,GAA4B;IAC1C,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACtD,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,EAAC,OAAO,EAAC,GAAG,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACjE,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACnE,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,IAAI,EAAE;IACpE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACzD,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACzD,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,QAAQ,EAAC,IAAI,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACvE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,QAAQ,EAAC,IAAI,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACvE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,OAAO,EAAC,IAAI,EAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IACvE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,OAAO,EAAC,IAAI,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACrE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACzD,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACpE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,KAAK,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACpE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACvE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACtE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACrE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACvE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACpE,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACtE,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACtE,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACnE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACzE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACrE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,IAAI,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACpE,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,IAAI,EAAE;IACxE,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC5E,EAAE,GAAG,EAAE,wBAAwB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;IAChE,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACzE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,IAAI,EAAE;IACxE,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACzE,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACxE,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC3E,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACzD,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC3E,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,IAAI,EAAE;IACvE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACvE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,WAAW,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC5E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5E,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACtE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAC1E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,WAAW,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC/E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC1E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC7E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC3E,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IAC7E,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,OAAO,EAAC,YAAY,EAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IAClG,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,OAAO,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IAC5F,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,OAAO,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IAC9F,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,IAAI,EAAC,KAAK,EAAC,EAAE,SAAS,EAAE,QAAQ,EAAE;IACzF,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IAC7E,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,IAAI,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC5F,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,IAAI,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC1F,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,QAAQ,EAAE;IAC3F,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,IAAI,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC5F,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IACzE,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,IAAI,EAAC,KAAK,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACnF,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,IAAI,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACvF,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,IAAI,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACtF,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAC1E,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,IAAI,EAAC,KAAK,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACrF,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,IAAI,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACxF,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,IAAI,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACtF,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,IAAI,EAAE;IACtE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACxE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACtE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACrE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACxE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;CACzE,CAAC;AAEF,+CAA+C;AAC/C,MAAM,SAAS,GAA4B;IACzC,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,EAAC,OAAO,EAAC,IAAI,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAClE,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,YAAY,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAC1E,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACxE,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACvD,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IACnE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACvE,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC7E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC1E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,SAAS,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAC3E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5D,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5D,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACzE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;IAC1D,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5D,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACzD,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;IAC7D,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC5E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,YAAY,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC9E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACzE,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,iBAAiB,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACnF,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,iBAAiB,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACnF,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,qBAAqB,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACvF,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,WAAW,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC7E,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,iBAAiB,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE;IAClF,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACvD,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,UAAU,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC1E,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,WAAW,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC3E,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,aAAa,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAC7E,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,IAAI,EAAE;IACtE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACxE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACxE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IACxE,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,gBAAgB,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;IAChF,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE;CACzE,CAAC;AAEF,6DAA6D;AAC7D,SAAS,MAAM,CAAC,CAAU;IACxB,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAC3C,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,MAAe,EAAE,QAAiB;IACtD,IAAI,OAAO,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC;IACpE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,+DAA+D;AAC/D,SAAS,MAAM,CAAC,GAAiB,EAAE,MAA+B;IAChE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,IAAI,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,SAAkC,EAAE;IAChF,MAAM,MAAM,GAAG,CAAC,CAAe,EAAE,CAAe,EAAU,EAAE,CAC1D,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAC9D,KAAK,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAiB,CAAC;YACpC,OAAO,GAAG,CAAC,SAAS,CAAC;QACvB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAC5C,8BAA8B,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/render/views.d.ts

@@ -9,6 +9,16 @@ export interface ItemCard {
     tags: string;
 }
 export declare function toItemCard(item: HomeItem, locations: HomeLocation[], tags: string[]): ItemCard;
+/** `toItemCard` 那个复合串的逆：`客厅/阳台柜×1[在家]` → `客厅/阳台柜`。
+ *
+ *  为什么跟 `toItemCard` 住一个文件：复合串的格式只由上面那一个 `map` 定义（`位置×件数[状态]`，
+ *  多位置用 `；` 连），它的解析规则只有跟定义住一起才不会走散（铁律二）。
+ *
+ *  为什么需要它：页面把「位置／数量／状态」当三个独立字段位渲染时（#890 seq 22 查看照片、
+ *  seq 7 紧急定位的置顶与其余候选），直接印复合串会让同一个值位同时带 `/`、`×`、`[]` 三套符号，
+ *  且件数与状态跟旁边的独立字段位说两遍。本函数只吃 `toItemCard` 产出的形状——位置路径里
+ *  不含 `×` 与 `[]`，故按段剥；`(无位置)` 这类没有复合尾巴的原样返回。 */
+export declare function locationPath(location: string): string;
 export declare function buildSearchList(cards: ItemCard[]): {
     items: ItemCard[];
     total: number;
@@ -16,9 +26,21 @@ export declare function buildSearchList(cards: ItemCard[]): {
 export declare function buildDetail(card: ItemCard, extra?: Record<string, unknown>): {
     item: Record<string, unknown>;
 };
-export declare function buildReceipt(message: string): {
+/** 写库回执（#890 起可带「本次写入字段」）：`message` 仍是那一句人话（对话里读的就是它）；
+ *  `fields` 是本次真写进去的字段逐行（键名与值都由命令层给中文，页面与渲染层不翻译英文键）。
+ *  不给 `fields` 时载荷形状与本改动之前逐字节同形——旧调用方不受影响。 */
+export declare function buildReceipt(message: string, fields?: readonly {
+    readonly k: string;
+    readonly v: string;
+}[]): {
     ok: boolean;
     message: string;
+    detail?: {
+        fields: readonly {
+            readonly k: string;
+            readonly v: string;
+        }[];
+    };
 };
 export declare function buildTagList(tags: {
     tag: string;
@@ -61,9 +83,19 @@ export declare function buildShoppingList(items: {
     items: unknown[];
     total: number;
 };
-export declare function buildTicketList(items: Record<string, unknown>[]): {
+/** 清单载荷（#890 起可带「本次查询条件」）：按物品查又可能 0 命中的场景（查退货窗口），
+ *  把「这一次查的是谁」写进 `data.query`，页面据此回显；不传即无该键，与改动前同形。
+ *  形状写死在这里，不用索引签名——调用方与页面都按这两个字段读写（铁律三）。 */
+export declare function buildTicketList(items: Record<string, unknown>[], query?: {
+    item_id: number;
+    item_name: string;
+}): {
     items: Record<string, unknown>[];
     total: number;
+    query?: {
+        item_id: number;
+        item_name: string;
+    };
 };
 export declare function buildCareList(items: Record<string, unknown>[]): {
     items: Record<string, unknown>[];

package/dist/render/views.d.ts.map

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

package/dist/render/views.js

@@ -8,14 +8,35 @@ export function toItemCard(item, locations, tags) {
         category: item.category ?? '', tags: tags.join(','),
     };
 }
+/** `toItemCard` 那个复合串的逆：`客厅/阳台柜×1[在家]` → `客厅/阳台柜`。
+ *
+ *  为什么跟 `toItemCard` 住一个文件：复合串的格式只由上面那一个 `map` 定义（`位置×件数[状态]`，
+ *  多位置用 `；` 连），它的解析规则只有跟定义住一起才不会走散（铁律二）。
+ *
+ *  为什么需要它：页面把「位置／数量／状态」当三个独立字段位渲染时（#890 seq 22 查看照片、
+ *  seq 7 紧急定位的置顶与其余候选），直接印复合串会让同一个值位同时带 `/`、`×`、`[]` 三套符号，
+ *  且件数与状态跟旁边的独立字段位说两遍。本函数只吃 `toItemCard` 产出的形状——位置路径里
+ *  不含 `×` 与 `[]`，故按段剥；`(无位置)` 这类没有复合尾巴的原样返回。 */
+export function locationPath(location) {
+    return String(location ?? '')
+        .split('；')
+        .map((seg) => seg.replace(/\s*×\s*\d+\s*/g, '').replace(/\[[^\]]*\]/g, '').trim())
+        .filter((seg) => seg !== '')
+        .join('；');
+}
 export function buildSearchList(cards) {
     return { items: cards, total: cards.length };
 }
 export function buildDetail(card, extra) {
     return { item: { ...card, ...(extra ?? {}) } };
 }
-export function buildReceipt(message) {
-    return { ok: true, message };
+/** 写库回执（#890 起可带「本次写入字段」）：`message` 仍是那一句人话（对话里读的就是它）；
+ *  `fields` 是本次真写进去的字段逐行（键名与值都由命令层给中文，页面与渲染层不翻译英文键）。
+ *  不给 `fields` 时载荷形状与本改动之前逐字节同形——旧调用方不受影响。 */
+export function buildReceipt(message, fields) {
+    return fields === undefined || fields.length === 0
+        ? { ok: true, message }
+        : { ok: true, message, detail: { fields } };
 }
 export function buildTagList(tags, categories) {
     const items = tags.map((t) => ({ name: t.tag, count: t.count }));
@@ -43,8 +64,11 @@ export function buildStatsAlert(items) {
 export function buildShoppingList(items) {
     return { items, total: items.length };
 }
-export function buildTicketList(items) {
-    return { items, total: items.length };
+/** 清单载荷（#890 起可带「本次查询条件」）：按物品查又可能 0 命中的场景（查退货窗口），
+ *  把「这一次查的是谁」写进 `data.query`，页面据此回显；不传即无该键，与改动前同形。
+ *  形状写死在这里，不用索引签名——调用方与页面都按这两个字段读写（铁律三）。 */
+export function buildTicketList(items, query) {
+    return { ...(query === undefined ? {} : { query }), items, total: items.length };
 }
 export function buildCareList(items) {
     return { items, total: items.length };

package/dist/render/views.js.map

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

package/dist/setup/commands.d.ts

@@ -0,0 +1,3 @@
+import type { HomeCommandSpec } from '../shared/commandSpec.js';
+export declare const SETUP_COMMANDS: readonly HomeCommandSpec[];
+//# sourceMappingURL=commands.d.ts.map

package/dist/setup/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/setup/commands.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAAO,CAAC"}

package/dist/setup/commands.js

@@ -0,0 +1,9 @@
+// 开始使用能力的命令声明（**权威源**，#800 新立）。
+//
+// 本能力暂无独占命令键：开始使用 4 场景（SM8-1 首次使用／SM8-2 查异常／SM8-3 备份
+// 导出／SM8-4 导入恢复）全走 family 能力的 care 双键（kind 预设区分），故声明为空
+// 数组。空不是缺失：生成器校验本文件存在且为空（`SETUP_COMMANDS = []`），页族写集
+// （first_use_wizard／health_report／backup_receipt／import_restore）照契约归本目录
+// `pages/`（域票地盘，本票只留目录占位说明，不建页面文件）。
+export const SETUP_COMMANDS = [];
+//# sourceMappingURL=commands.js.map

package/dist/setup/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/setup/commands.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,qDAAqD;AACrD,uDAAuD;AACvD,qDAAqD;AACrD,wEAAwE;AACxE,oCAAoC;AAIpC,MAAM,CAAC,MAAM,cAAc,GAA+B,EAAE,CAAC"}

package/dist/setup/index.d.ts

@@ -0,0 +1,3 @@
+export { SETUP_COMMANDS } from './commands.js';
+export { SETUP_ROUTES } from './routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/setup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/setup/index.js

@@ -0,0 +1,4 @@
+// 开始使用能力门：对外只给声明（跨能力调用只走这道门）。
+export { SETUP_COMMANDS } from './commands.js';
+export { SETUP_ROUTES } from './routes.js';
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/setup/pages/backup_receipt.d.ts

@@ -0,0 +1,24 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "backup_receipt";
+export declare const PAGE_META: {
+    readonly domain: "setup";
+    readonly family: "backup_receipt";
+    readonly key: "home.care.write";
+    readonly shape: "receipt";
+    readonly preset: Record<string, unknown>;
+    readonly rows: readonly {
+        readonly key: string;
+        readonly preset: Record<string, unknown>;
+    }[];
+};
+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=backup_receipt.d.ts.map

package/dist/setup/pages/backup_receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup_receipt.d.ts","sourceRoot":"","sources":["../../../src/setup/pages/backup_receipt.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,gBAAyB,CAAC;AAEhD,eAAO,MAAM,SAAS;;;;;qBAKS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBACY,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE;CACrI,CAAC;AAEX,eAAO,MAAM,eAAe,EAyBvB;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;AAwCF,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,CA2HvH"}