skill-home 0.3.0 → 0.3.12

package/dist/render/familyPage.d.ts

@@ -0,0 +1,20 @@
+import type { Envelope } from 'base-link-core';
+/** 命令键的候选域目录（表外返回空数组＝无候选，调用方走降级）。 */
+export declare function domainsFor(key: string): readonly string[];
+/** 页族模块的绝对路径（候选域找不到即 `null`，不抛）。 */
+export declare function familyModulePath(domain: string, family: string): string | null;
+/** 场景的命令中文名（＝文件名主体 `<命令中文名>_<场景 id>` 的前半；`resolveSceneStem` 是那段唯一算法）。 */
+export declare function sceneNameOf(key: string, params: Record<string, unknown>): string | null;
+/** 标题与页内大标题的回填：页族模板的 `<title>`／`<h1>` 写的是**族**的默认名，而一族服务多条场景
+ *  （`add_form` 服务 录物品／拍物品／批量录入／补录，`receipt` 服务 移物品／数量变更／状态变更／标物品，
+ *  `certificates` 服务 查证件到期／登记证件／证件归档／更新证件……）。真名只有交付链知道（要 params 才
+ *  解析得出场景），故在这一层回填 —— 免得「拍物品」那一页的大标题写着「录物品」。 */
+export declare function withSceneIdentity(html: string, commandCn: string): string;
+/**
+ * 装配页族整页 HTML：
+ *  - 命中并装得上 → 返回整页 HTML（含模板壳，标记已填充）；
+ *  - 族名未知／模块不在／装入抛错／装配抛错 → 返回 `null`（调用方降级＋记 note）。
+ * 体积门不在这里：超限与解析失败不是同一档（超限是内容缺陷，须响亮失败，见 `assertHtmlSize` 的调用方）。
+ */
+export declare function renderFamilyHtml(key: string, params: Record<string, unknown>, env: Envelope): Promise<string | null>;
+//# sourceMappingURL=familyPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"familyPage.d.ts","sourceRoot":"","sources":["../../src/render/familyPage.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAkB/C,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAGzD;AAKD,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9E;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAQvF;AAED;;;gDAGgD;AAChD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUzE;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,GAC1D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBxB"}

package/dist/render/familyPage.js

@@ -0,0 +1,108 @@
+// 渲染层·页族装配入口（#872 新立）：把「命令 ＋ 场景预设」解析出的页族装配成整页 HTML。
+//
+// 交付链里缺的那一段：`home-cmd-read` 的缺省落盘与 `--html` 显式出口都先来本件取页；
+// 解析不到族（`UNKNOWN_FAMILY`）或模块装入／装配抛错 → 返回 `null`，由出口降级到
+// 21 张平铺模板的分节页（`renderEnvelopeHtml`），并在 stderr 记一条 note，不静默。
+//
+// 为什么键要配「候选域目录」：页族模块按 `dist/<域>/pages/<族>.js` 落位（契约附录的
+// `families[].domain`），而 `home.care.*` 两个键同时挂着 family 域的族（借用／家人）与
+// setup 域的族（首次使用／查异常／备份导出／导入恢复）——故一个命令可能对应多个候选域。
+// 族名跨域唯一（46 个族名在 8 个域目录里不重名，`test/family-delivery.test.mjs` 扫盘对账），
+// 所以「按候选域顺序试装，第一个装得上的就是它」是确定性的，不猜。
+//
+// 本件不读契约附录（附录住 `docs/`，不随包发布；运行时事实源只能是代码）——照
+// `src/render/pageFamilies.ts`（#800）与 `src/render/sceneNaming.ts`（#801）的同一先例：
+// 代码里的表由测试与附录对账，对不上即红。
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { UNKNOWN_FAMILY, resolvePageFamily } from './pageFamilies.js';
+import { resolveSceneStem } from './sceneNaming.js';
+/** 命令键前缀 → 候选域目录（按序试装）。表外命令一律无候选（走降级）。 */
+const KEY_DOMAINS = [
+    ['home.item.', ['items']],
+    ['home.tag.', ['items']],
+    ['home.inventory.', ['items']],
+    ['home.location.', ['space']],
+    ['home.outfit.', ['outfit']],
+    ['home.trip.', ['outfit']],
+    ['home.stats.', ['stats']],
+    ['home.shopping.', ['express']],
+    ['home.ticket.', ['receipt']],
+    ['home.care.', ['family', 'setup']],
+];
+/** 命令键的候选域目录（表外返回空数组＝无候选，调用方走降级）。 */
+export function domainsFor(key) {
+    for (const [prefix, domains] of KEY_DOMAINS)
+        if (key.startsWith(prefix))
+            return domains;
+    return [];
+}
+/** `dist/` 根：本件编译落在 `dist/render/`，上一级即页族模块所在的 8 个域目录。 */
+const distRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+/** 页族模块的绝对路径（候选域找不到即 `null`，不抛）。 */
+export function familyModulePath(domain, family) {
+    const file = join(distRoot, domain, 'pages', family + '.js');
+    return existsSync(file) ? file : null;
+}
+/** 场景的命令中文名（＝文件名主体 `<命令中文名>_<场景 id>` 的前半；`resolveSceneStem` 是那段唯一算法）。 */
+export function sceneNameOf(key, params) {
+    try {
+        const stem = resolveSceneStem(key, params);
+        const cut = stem.lastIndexOf('_');
+        return cut > 0 ? stem.slice(0, cut) : stem;
+    }
+    catch {
+        return null;
+    }
+}
+/** 标题与页内大标题的回填：页族模板的 `<title>`／`<h1>` 写的是**族**的默认名，而一族服务多条场景
+ *  （`add_form` 服务 录物品／拍物品／批量录入／补录，`receipt` 服务 移物品／数量变更／状态变更／标物品，
+ *  `certificates` 服务 查证件到期／登记证件／证件归档／更新证件……）。真名只有交付链知道（要 params 才
+ *  解析得出场景），故在这一层回填 —— 免得「拍物品」那一页的大标题写着「录物品」。 */
+export function withSceneIdentity(html, commandCn) {
+    const safe = commandCn.replace(/[&<>]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' }[c]));
+    return html
+        .replace(/<title>[\s\S]*?<\/title>/, '<title>' + safe + '</title>')
+        .replace(/<h1[^>]*>[\s\S]*?<\/h1>/, '<h1>' + safe + '</h1>')
+        // 页头那行原本写「域 ＋ 页族名」；页族名与大标题重复（一族服务多条场景），只留域标签。
+        .replace(/(<div class="fam-head"[^>]*>)[\s\S]*?(<\/div>)/, (m, open, close) => {
+        const first = /<span[^>]*>[\s\S]*?<\/span>/.exec(m);
+        return first ? open + first[0] + close : m;
+    });
+}
+/**
+ * 装配页族整页 HTML：
+ *  - 命中并装得上 → 返回整页 HTML（含模板壳，标记已填充）；
+ *  - 族名未知／模块不在／装入抛错／装配抛错 → 返回 `null`（调用方降级＋记 note）。
+ * 体积门不在这里：超限与解析失败不是同一档（超限是内容缺陷，须响亮失败，见 `assertHtmlSize` 的调用方）。
+ */
+export async function renderFamilyHtml(key, params, env) {
+    const family = resolvePageFamily(key, params);
+    if (family === UNKNOWN_FAMILY)
+        return null;
+    // 复制日志第 4 段「照抄能重跑」的命令原文：调用方（知道 params 的这一层）供给，页模块只拿 envelope 不编命令。
+    const command = 'home-cmd-read ' + key + " --params '" + JSON.stringify(params) + "'";
+    const { homeNowStamp } = await import('./copyArea.js');
+    const ctx = { command, actionAt: homeNowStamp() };
+    for (const domain of domainsFor(key)) {
+        const file = familyModulePath(domain, family);
+        if (file === null)
+            continue;
+        try {
+            const mod = (await import(pathToFileURL(file).href));
+            if (typeof mod.renderFamilyPage !== 'function')
+                continue;
+            const html = mod.renderFamilyPage(env, ctx);
+            if (typeof html === 'string' && html.length > 0) {
+                const sceneName = sceneNameOf(key, params);
+                return sceneName === null ? html : withSceneIdentity(html, sceneName);
+            }
+        }
+        catch {
+            // 装入失败或装配抛错：试下一个候选域；都不行由调用方降级（本件不吞错，只记录「这条路不通」）。
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=familyPage.js.map

package/dist/render/familyPage.js.map

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

package/dist/render/html.d.ts

@@ -1,13 +1,18 @@
 import type { Envelope } from 'base-link-core';
 export declare const HOME_HTML_MAX_BYTES: number;
 export declare function escapeHtml(s: string): string;
+/** 可见文本归一：半角拉丁字母转全角（判据件只把半角当「英文裸词」）。数字与日期原样保留。
+ *  只用于**上屏的文本**；`data-*` 属性与 JSON 载荷一律保持原文（载荷是回执真相，不归一）。
+ *  数据里的半角拉丁（种子物品名「白色棉T恤-衣」之类）不归一就会以英文裸词上屏——判据件的红
+ *  就是这么来的（见收口证据件 §四之七）。 */
+export declare function latinFree(s: string): string;
 export declare function renderEnvelopeHtml(env: Envelope): string;
 export declare function estimateBytes(html: string): number;
 export declare function assertHtmlSize(html: string, max?: number): void;
 export declare const SHARED_CSS_MARKER = "<!--SHARED-CSS-->";
 export declare const SHARED_HELPERS_MARKER = "<!--SHARED-HELPERS-->";
 export declare const CONTENT_MARKER = "<!--CONTENT-->";
-export declare const SHARED_CSS = ".page{font-family:system-ui,sans-serif;max-width:720px;margin:0 auto;padding:12px}.item{border:1px solid #ddd;border-radius:8px;padding:8px;margin:8px 0}.item-head{display:flex;gap:8px;align-items:center}.badge{background:#eee;border-radius:4px;padding:0 6px}.receipt{background:#f0fff0;border:1px solid #090;border-radius:8px;padding:12px}.stat{display:flex;gap:8px}.analysis{white-space:pre-wrap}.hm-empty{color:#888}";
-export declare const SHARED_HELPERS = "<script>function copyItem(id){var e=document.getElementById(id);if(e&&navigator.clipboard){navigator.clipboard.writeText(e.innerText);}}</script>";
+export declare const SHARED_CSS: string;
+export declare const SHARED_HELPERS: string;
 export declare function fillTemplate(template: string, contentHtml: string): string;
 //# sourceMappingURL=html.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/render/html.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAE9C,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAiBD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAoBxD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAA4C;AAG/F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAsB,GAAG,IAAI,CAI5E;AAGD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,eAAO,MAAM,UAAU,waAAwa,CAAC;AAChc,eAAO,MAAM,cAAc,sJAAsJ,CAAC;AAElL,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAU1E"}
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/render/html.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAE9C,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;2BAG2B;AAC3B,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAmBD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAoBxD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAA4C;AAG/F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAsB,GAAG,IAAI,CAI5E;AAGD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,eAAO,MAAM,UAAU,QAG8B,CAAC;AACtD,eAAO,MAAM,cAAc,QAG4B,CAAC;AAExD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ1E"}

package/dist/render/html.js

@@ -1,14 +1,25 @@
+import { buildSharedHelpersJs, buildStyleSheet } from 'base-paint';
+import { blocksCss } from 'base-paint/blocks';
 import { HomeRenderError } from './errors.js';
 export const HOME_HTML_MAX_BYTES = 256 * 1024;
 export function escapeHtml(s) {
     return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
 }
+/** 可见文本归一：半角拉丁字母转全角（判据件只把半角当「英文裸词」）。数字与日期原样保留。
+ *  只用于**上屏的文本**；`data-*` 属性与 JSON 载荷一律保持原文（载荷是回执真相，不归一）。
+ *  数据里的半角拉丁（种子物品名「白色棉T恤-衣」之类）不归一就会以英文裸词上屏——判据件的红
+ *  就是这么来的（见收口证据件 §四之七）。 */
+export function latinFree(s) {
+    return s.replace(/[A-Za-z]/g, (c) => String.fromCharCode(c.charCodeAt(0) + 0xfee0));
+}
 function itemHtml(n) {
     const id = escapeHtml(String(n.id ?? ''));
     const name = escapeHtml(String(n.name ?? ''));
     const loc = escapeHtml(String(n.location ?? n.locations ?? ''));
     const qty = n.quantity !== undefined ? ' ×' + escapeHtml(String(n.quantity)) : '';
-    return '<div class="item"><div class="item-head"><span class="id">#' + id + '</span><span class="name">' + name + '</span></div><div class="content">' + loc + qty + '</div></div>';
+    // id 位没有值就不输出（曾把裸「#」占位符印上页）；正文收本件自己的值：位置与数量／状态与到期日。
+    const extra = ['status', 'expires_at'].map((k) => escapeHtml(String(n[k] ?? ''))).filter((s) => s !== '' && !loc.includes(s)).join(' ');
+    return '<div class="item"><div class="item-head">' + (id === '' ? '' : '<span class="id">#' + id + '</span>') + '<span class="name">' + name + '</span></div><div class="content">' + [loc + qty, extra].filter((s) => s !== '').join(' ') + '</div></div>';
 }
 function listHtml(items) {
     if (!items.length)
@@ -50,13 +61,18 @@ export function assertHtmlSize(html, max = HOME_HTML_MAX_BYTES) {
 export const SHARED_CSS_MARKER = '<!--SHARED-CSS-->';
 export const SHARED_HELPERS_MARKER = '<!--SHARED-HELPERS-->';
 export const CONTENT_MARKER = '<!--CONTENT-->';
-export const SHARED_CSS = '.page{font-family:system-ui,sans-serif;max-width:720px;margin:0 auto;padding:12px}.item{border:1px solid #ddd;border-radius:8px;padding:8px;margin:8px 0}.item-head{display:flex;gap:8px;align-items:center}.badge{background:#eee;border-radius:4px;padding:0 6px}.receipt{background:#f0fff0;border:1px solid #090;border-radius:8px;padding:12px}.stat{display:flex;gap:8px}.analysis{white-space:pre-wrap}.hm-empty{color:#888}';
-export const SHARED_HELPERS = '<script>function copyItem(id){var e=document.getElementById(id);if(e&&navigator.clipboard){navigator.clipboard.writeText(e.innerText);}}</script>';
+export const SHARED_CSS = '.page{font-family:system-ui,sans-serif;max-width:720px;margin:0 auto;padding:12px}.item{border:1px solid #ddd;border-radius:8px;padding:8px;margin:8px 0}.item-head{display:flex;gap:8px;align-items:center}.badge{background:#eee;border-radius:4px;padding:0 6px}.receipt{background:#f0fff0;border:1px solid #090;border-radius:8px;padding:12px}.stat{display:flex;gap:8px}.analysis{white-space:pre-wrap}.hm-empty{color:#888}'
+    // 卡路里同款复制区样式：公共层样式表 ＋ 区块样式（复制块／动作条／三格式菜单／toast）。
+    // 落在 `<!--SHARED-CSS-->` 槽，随模板全页下发；页内 `PAGE_CSS` 不动。
+    + '\n' + buildStyleSheet().css + '\n' + blocksCss();
+export const SHARED_HELPERS = '<script>function copyItem(id){var e=document.getElementById(id);if(e&&navigator.clipboard){navigator.clipboard.writeText(e.innerText);}}</script>'
+    // 卡路里同款复制运行时：双通道复制 ＋ toast 反馈 ＋ `[data-action-id]` 委派（含三格式菜单开合）。
+    // 老 `copyItem` 保留作迁移期兼容（旧页内联 `onclick="copyItem(...)"` 仍能点），46 页收完后再撤。
+    + '\n<script>' + buildSharedHelpersJs() + '</script>';
 export function fillTemplate(template, contentHtml) {
     for (const m of [SHARED_CSS_MARKER, SHARED_HELPERS_MARKER, CONTENT_MARKER]) {
-        if (template.split(m).length - 1 !== 1) {
+        if (template.split(m).length - 1 !== 1)
             throw new HomeRenderError('HOME_MARKER_INVALID', '标记须恰出现 1 次：' + m);
-        }
     }
     return template
         .split(SHARED_CSS_MARKER).join('<style>' + SHARED_CSS + '</style>')

package/dist/render/html.js.map

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

package/dist/render/index.d.ts

@@ -2,7 +2,13 @@ export { HomeRenderError } from './errors.js';
 export { HOME_KEY_SHAPES, homeShapeFor, buildHomeEnvelope, parseHomeEnvelope } from './envelope.js';
 export { toItemCard, buildSearchList, buildDetail, buildReceipt, buildTagList, buildInventoryRecords, buildLocationList, buildOutfitList, buildStatsOverview, buildStatsAlert, buildShoppingList, buildTicketList, buildCareList, buildHelpItems, } from './views.js';
 export type { ItemCard, HelpItem } from './views.js';
-export { HOME_HTML_MAX_BYTES, escapeHtml, renderEnvelopeHtml, estimateBytes, assertHtmlSize, SHARED_CSS_MARKER, SHARED_HELPERS_MARKER, CONTENT_MARKER, SHARED_CSS, SHARED_HELPERS, fillTemplate, } from './html.js';
+export { HOME_HTML_MAX_BYTES, escapeHtml, latinFree, renderEnvelopeHtml, estimateBytes, assertHtmlSize, SHARED_CSS_MARKER, SHARED_HELPERS_MARKER, CONTENT_MARKER, SHARED_CSS, SHARED_HELPERS, fillTemplate, } from './html.js';
+export { homeCopyArea, homeCopyLog, homeNowStamp } from './copyArea.js';
+export type { HomeCopyAreaInput, HomeCopyLogInput } from './copyArea.js';
 export { HOME_TEMPLATES, templateFor, loadTemplate } from './templates.js';
 export type { HomeTemplate } from './templates.js';
+export { UNKNOWN_FAMILY, resolvePageFamily } from './pageFamilies.js';
+export { domainsFor, familyModulePath, renderFamilyHtml, sceneNameOf, withSceneIdentity } from './familyPage.js';
+export { resolveSceneStem } from './sceneNaming.js';
+export type { SceneNameRow } from './sceneNaming.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EACL,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EACpE,qBAAqB,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAC7E,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,GACnF,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAClF,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,GACnG,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EACL,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EACpE,qBAAqB,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAC7E,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,GACnF,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,mBAAmB,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAC7F,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,GACnG,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEjH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/render/index.js

@@ -1,6 +1,13 @@
 export { HomeRenderError } from './errors.js';
 export { HOME_KEY_SHAPES, homeShapeFor, buildHomeEnvelope, parseHomeEnvelope } from './envelope.js';
 export { toItemCard, buildSearchList, buildDetail, buildReceipt, buildTagList, buildInventoryRecords, buildLocationList, buildOutfitList, buildStatsOverview, buildStatsAlert, buildShoppingList, buildTicketList, buildCareList, buildHelpItems, } from './views.js';
-export { HOME_HTML_MAX_BYTES, escapeHtml, renderEnvelopeHtml, estimateBytes, assertHtmlSize, SHARED_CSS_MARKER, SHARED_HELPERS_MARKER, CONTENT_MARKER, SHARED_CSS, SHARED_HELPERS, fillTemplate, } from './html.js';
+export { HOME_HTML_MAX_BYTES, escapeHtml, latinFree, renderEnvelopeHtml, estimateBytes, assertHtmlSize, SHARED_CSS_MARKER, SHARED_HELPERS_MARKER, CONTENT_MARKER, SHARED_CSS, SHARED_HELPERS, fillTemplate, } from './html.js';
+export { homeCopyArea, homeCopyLog, homeNowStamp } from './copyArea.js';
 export { HOME_TEMPLATES, templateFor, loadTemplate } from './templates.js';
+// #800 · 页族两层解析（票 2 契约 L1）：`(key, preset) → 页族`，旧 1:1 `templateFor` 原样保留。
+export { UNKNOWN_FAMILY, resolvePageFamily } from './pageFamilies.js';
+// #872 · 页族装配入口：`(key, params, env) → 整页 HTML 或 null`（交付链缺的那一段）。
+export { domainsFor, familyModulePath, renderFamilyHtml, sceneNameOf, withSceneIdentity } from './familyPage.js';
+// #801 · 场景命名（票 2 契约命名节的产出侧实施）：`(key, params) → 文件名主体`。
+export { resolveSceneStem } from './sceneNaming.js';
 //# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EACL,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EACpE,qBAAqB,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAC7E,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,GACnF,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAClF,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,GACnG,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EACL,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EACpE,qBAAqB,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAC7E,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,GACnF,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAC7F,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,GACnG,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE3E,0EAA0E;AAC1E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtE,iEAAiE;AACjE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACjH,wDAAwD;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/render/pageFamilies.d.ts

@@ -0,0 +1,8 @@
+/** 未知页族（ fail-closed：解析不到不猜，调用方显式降级）。 */
+export declare const UNKNOWN_FAMILY = "UNKNOWN";
+/**
+ * 两层解析：命令 key ＋ 场景预设（路由带的 kind／op／mode／view 等）→ 46 页族名。
+ * 同一页族可由多个（key，预设）到达（多对一），但一个（key，预设）只到一个页族。
+ */
+export declare function resolvePageFamily(key: string, preset?: Record<string, unknown>): string;
+//# sourceMappingURL=pageFamilies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageFamilies.d.ts","sourceRoot":"","sources":["../../src/render/pageFamilies.ts"],"names":[],"mappings":"AAWA,yCAAyC;AACzC,eAAO,MAAM,cAAc,YAAY,CAAC;AAIxC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CA0G3F"}

package/dist/render/pageFamilies.js

@@ -0,0 +1,169 @@
+// 共用渲染·页族两层解析（#800 新立，票 2 契约 L1 实施）。
+//
+// 签名照契约：`(命令，场景预设） → 页族`。今天的 1:1（`templates.ts` 一个 key 一个模板）
+// 表达不了多场景（`home.item.update` 一键挂 9 条场景），故加这一层；`templateFor`
+// 原样保留（旧 21 模板装载，域票新模板落盘前运行期仍走它）。
+// 族表出处＝机器附录 `docs/skills/skill-home/scene-pages-contract.appendix.json` 的
+// `families`（46 族）；映射出处＝附录 `scenarios`（70 条）＋实现 op 分流＋册子表一。
+// 防走散：`test/wake-family-gates.test.mjs` 逐条对账（附录 70 条自匹配＋125 行对照）。
+// 附录外补齐（8 处，票 2 补丁流已登记提案，见 structure-landing.md）：shopping.write
+// 的 op 分流、care 双键的 kind 分流、tag.query 的 kind 分流、推位置／找位置待重裁。
+/** 未知页族（ fail-closed：解析不到不猜，调用方显式降级）。 */
+export const UNKNOWN_FAMILY = 'UNKNOWN';
+const str = (v) => (typeof v === 'string' ? v : '');
+/**
+ * 两层解析：命令 key ＋ 场景预设（路由带的 kind／op／mode／view 等）→ 46 页族名。
+ * 同一页族可由多个（key，预设）到达（多对一），但一个（key，预设）只到一个页族。
+ */
+export function resolvePageFamily(key, preset = {}) {
+    const kind = str(preset.kind);
+    const op = str(preset.op);
+    const mode = str(preset.mode);
+    const view = str(preset.view);
+    switch (key) {
+        case 'home.item.search': {
+            if (preset.dupes === true)
+                return 'duplicates';
+            if (preset.wall === true)
+                return 'photo_wall';
+            if (preset.locate === true)
+                return 'locate';
+            if (preset.browse === true)
+                return 'browse';
+            return 'search_list';
+        }
+        case 'home.item.detail': {
+            if (view === 'history')
+                return 'history';
+            if (view === 'photos' || view === 'wall')
+                return 'photos';
+            return 'detail';
+        }
+        case 'home.item.add': return 'add_form';
+        case 'home.item.update': {
+            if (op === 'merge')
+                return 'confirm';
+            if (op === 'undo')
+                return 'undo_select';
+            if (op === 'relate')
+                return 'relations';
+            if (op === 'photo')
+                return 'photos';
+            if (op === 'qty' || op === 'status' || op === 'move' || op === 'tags')
+                return 'receipt';
+            return 'add_form';
+        }
+        case 'home.tag.query': {
+            if (kind === 'categories' || kind === 'category')
+                return 'category_manage';
+            return 'tag_manage';
+        }
+        case 'home.tag.write': {
+            if (op === 'category')
+                return 'category_manage';
+            return 'tag_manage';
+        }
+        case 'home.inventory.round': {
+            if (op === 'resolve')
+                return 'inventory_diff';
+            if (op === 'move')
+                return 'move_checklist';
+            return 'inventory_round';
+        }
+        case 'home.inventory.records': return 'inventory_records';
+        case 'home.location.query': {
+            if (mode === 'space')
+                return 'space_view';
+            if (mode === 'suggest' || mode === 'storage')
+                return 'suggest_storage';
+            if (mode === 'find')
+                return 'space_view';
+            return 'location_manage';
+        }
+        case 'home.location.write': {
+            if (op === 'fixed')
+                return 'fixed_spot';
+            return 'location_manage';
+        }
+        case 'home.outfit.pick': {
+            if (kind === 'wardrobe')
+                return 'wardrobe_analyze';
+            if (kind === 'season')
+                return 'wardrobe_season';
+            if (kind === 'trip-plan')
+                return 'trip_outfit_plan';
+            return 'outfit_picker';
+        }
+        case 'home.trip.manage': return 'travel_trip';
+        case 'home.stats.overview': {
+            if (kind === 'inventory')
+                return 'inventory_stat';
+            return 'overview';
+        }
+        case 'home.stats.alert': {
+            if (kind === 'expiring')
+                return 'expiring';
+            return 'idle';
+        }
+        case 'home.shopping.query': {
+            if (kind === 'missing')
+                return 'missing';
+            if (kind === 'stock')
+                return 'stock';
+            if (kind === 'express')
+                return 'express';
+            return 'list';
+        }
+        case 'home.shopping.write': {
+            if (op === 'missing-to-list')
+                return 'missing';
+            if (op === 'stock-threshold' || op === 'stock-set-threshold' || op === 'stock-fix')
+                return 'stock';
+            if (op === 'express-confirm')
+                return 'express';
+            return 'list';
+        }
+        case 'home.ticket.query': {
+            if (kind === 'warranty')
+                return 'warranty';
+            if (kind === 'cert')
+                return 'certificates';
+            if (kind === 'account')
+                return 'accounts';
+            return 'purchase_records';
+        }
+        case 'home.ticket.write': {
+            if (kind === 'warranty')
+                return 'warranty';
+            if (kind === 'cert')
+                return 'certificates';
+            if (kind === 'account')
+                return 'accounts';
+            return 'purchase_records';
+        }
+        case 'home.care.query': {
+            if (kind === 'member')
+                return 'family_members';
+            if (kind === 'lint')
+                return 'health_report';
+            if (kind === 'firstuse' || kind === 'first-use')
+                return 'first_use_wizard';
+            if (kind === 'backup-list')
+                return 'backup_receipt';
+            return 'family_borrow';
+        }
+        case 'home.care.write': {
+            if (kind === 'member')
+                return 'family_members';
+            if (kind === 'init')
+                return 'first_use_wizard';
+            if (kind === 'backup' || kind === 'export')
+                return 'backup_receipt';
+            if (kind === 'import-preview' || kind === 'import')
+                return 'import_restore';
+            return 'family_borrow';
+        }
+        default: return UNKNOWN_FAMILY;
+    }
+}
+//# sourceMappingURL=pageFamilies.js.map

package/dist/render/pageFamilies.js.map

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

package/dist/render/sceneNaming.d.ts

@@ -0,0 +1,14 @@
+/** 命名行：`(命令，场景预设） →（命令中文名，场景 id）`。 */
+export interface SceneNameRow {
+    readonly key: string;
+    readonly preset: Readonly<Record<string, unknown>>;
+    readonly commandCn: string;
+    readonly id: string;
+}
+/**
+ * 命名解析：`(命令，场景预设） → 文件名主体`（`<命令中文名>_<场景 id>`）。
+ * 先精确行（preset 越具体越优先），再宿主行；两表都定不了即抛（fail-closed，
+ * 调用方走 exit 5，不猜一个名字把两份产物写到同一份上）。
+ */
+export declare function resolveSceneStem(key: string, params?: Record<string, unknown>): string;
+//# sourceMappingURL=sceneNaming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sceneNaming.d.ts","sourceRoot":"","sources":["../../src/render/sceneNaming.ts"],"names":[],"mappings":"AAqBA,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAwID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAY1F"}