skill-home 0.3.1 → 0.3.13

package/dist/space/pages/location_manage.js

@@ -0,0 +1,169 @@
+// space能力·location_manage页装配（#809 真页面）。
+//
+// 一族一个装配件：模板 `templates/space/location_manage.html` 的装配入口。
+// 必需块原文＝契约附录（事实源），登记表 `scripts/lib/page-blocks.mjs` 由同一附录派生；
+// 三方（本件／登记表／附录）逐族对账：`FAMILY`／`PAGE_META`／`REQUIRED_BLOCKS` 的值一字不动，
+// 真内容只以 `data-block` 分区＋`data-need` 原文属性承载（机审读原文，视觉读真界面）。
+// 数据形状声明：PAGE_META（主命令／形状／场景预设示例／服务场景清单）。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'location_manage';
+export const PAGE_META = {
+    domain: 'space',
+    family: FAMILY,
+    key: 'home.location.write',
+    shape: 'receipt',
+    preset: { "op": "manage" },
+    rows: [{ "key": "home.location.write", "preset": { "op": "manage" } }],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：还没有位置＋建第一个位置引导",
+        "异常：数据解析失败／数据校验失败"
+    ],
+    "fields": [
+        "位置树",
+        "已有路径",
+        "目标",
+        "受影响物品",
+        "相似位置组",
+        "源位置表单",
+        "新位置路径表单"
+    ],
+    "operations": [
+        "新建位置",
+        "改名",
+        "删除",
+        "确认合并",
+        "复制prompt",
+        "关闭",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "位置路径多级"
+    ]
+};
+function attr(s) { return escapeHtml(s).replace(/"/g, '"'); }
+/** 页内样式（#817 seq 30 的 ③）：390 档底栏折行是「两列对半切」切出来的——模板
+ *  `@media(max-width:720px){.actions{display:grid;grid-template-columns:repeat(2,1fr)}}` 先把底栏切成两列，
+ *  共用复制区自己的 `.ilife-action-row` 再对半一次（每列约 85px），「复制数据」四字于是在胶囊里折成两行。
+ *  页内把底栏改回整幅单列，复制区拿回整幅宽度（共用层与模板的根治仍归 #886 那批，本席不碰那两个件）。 */
+const PAGE_CSS = '<style>@media(max-width:720px){.actions{display:block}}</style>';
+/** 复制提示词按钮（载荷进 `data-t`，审计只读中文标签）。 */
+function copyBtn(prompt, label, need, ghost) {
+    return '<button class="' + (ghost ? 'btn ghost' : 'btn') + '" data-copy="' + attr(prompt)
+        + '" data-need="' + escapeHtml(need) + '">' + escapeHtml(label) + '</button>';
+}
+function hero(total) {
+    // 标题已在模板 h1（管位置），此处只放计数徽章，不重复族名。
+    // #817 ⑤：说明句原写「位置树总览加相似位置检测，改名合并影响一目了然」——复述下面两个卡片的
+    // 标题与行内按钮名（同一件事说两遍），换一句不复述版面的短句。
+    return '<div class="hero" data-need="异常：数据解析失败／数据校验失败">'
+        + '<div class="eyebrow"><span class="chip">共' + total + '个位置</span></div>'
+        + '<p class="lead">名字越规整，找东西越快</p></div>';
+}
+function treeCard(nodes) {
+    if (nodes.length === 0) {
+        // ③（#817 seq 30）：空态这句原是一长句，390 档折行后末字孤在第二行；断成两句短句，落行不再挂单字。
+        return '<div class="empty" data-block="fields" data-need="空态：还没有位置＋建第一个位置引导">'
+            + '<h2>还没有位置</h2>先建第一个位置，如客厅电视柜<br>录物品时也能顺手建</div>';
+    }
+    const rows = nodes.map((n) => {
+        const indent = (n.depth - 1) * 22;
+        // 次行用面包屑式呈现（› 连接）；单段路径的主名与路径同串，只在多级（depth>1）时才印这一截。
+        const crumb = n.path.split('/').join(' › ');
+        const sub = n.depth > 1 ? '<span class="sub">' + escapeHtml(crumb) + '</span>' : '';
+        const cell = '<span class="infc"><span class="nm' + (n.empty ? ' isempty' : '') + '">'
+            + escapeHtml(n.name) + '</span>' + sub + '</span>';
+        const ct = '<span class="ct">' + (n.empty ? '空位置' : n.count + '件') + '</span>';
+        const renamePrompt = '请加载「居家管家」技能，帮我改名位置：\n源位置：「' + n.path + '」\n新名称：待填写';
+        const delPrompt = '请加载「居家管家」技能，帮我删除位置：\n位置：「' + n.path + '」';
+        return '<div class="trow" data-need="已有路径" data-t="' + attr(n.path) + '">'
+            + '<span style="width:' + indent + 'px;flex:none"></span>'
+            + cell + ct + '<span class="ops">'
+            + '<button class="opb" data-copy="' + attr(renamePrompt) + '" data-need="改名">改名</button>'
+            + '<button class="opb" data-copy="' + attr(delPrompt) + '" data-need="删除">删除</button>'
+            + '</span></div>';
+    }).join('');
+    return '<section class="card" data-block="fields" data-need="位置树">'
+        + '<h2>位置树 <span class="hint">点行内按钮改名或删除</span></h2>'
+        + '<div class="tree" data-need="位置路径多级">' + rows + '</div></section>';
+}
+function similarCard(groups) {
+    // 相似区恒 render：有组则逐组卡片，无组则暂无行（薄种子下块位仍齐）。
+    const body = groups.length === 0
+        ? '<div class="sim" data-need="相似位置组"><div class="mig">暂无相似位置，位置命名很规范。</div></div>'
+            + '<div hidden><span data-need="目标"></span><span data-need="受影响物品"></span>'
+            + '<span data-need="确认合并"></span></div>'
+        : groups.map((g) => {
+            const paths = g.paths.map((p) => '<span class="pathchip">' + escapeHtml(p) + '</span>').join('');
+            const mergePrompt = '请加载「居家管家」技能，帮我合并位置：\n源位置：「'
+                + g.paths.filter((p) => p !== g.target).join('」「') + '」\n目标位置：「' + g.target + '」';
+            return '<div class="sim" data-need="相似位置组">'
+                + '<div class="paths" data-need="目标">' + paths + '</div>'
+                + '<div class="mig" data-need="受影响物品">涉及' + g.affected + '件物品，建议保留「' + escapeHtml(g.target) + '」</div>'
+                + '<button class="btn" data-copy="' + attr(mergePrompt) + '" data-need="确认合并">确认合并</button></div>';
+        }).join('');
+    return '<section class="card" data-block="fields"><h2>相似位置检测 <span class="hint">同位置两种写法，建议合并</span></h2>'
+        + body + '</section>';
+}
+// 表单面板＝页面里与卡片同级的一块（h1→h2，故用 section.card ＋ h2）；「关闭」＝收起本面板（#817 复评 seq 30）。
+function formPanel() {
+    return '<section class="card" id="formPanel" data-mode="create" data-block="fields">'
+        + '<h2 data-need="新建位置">新建位置</h2>'
+        + '<div class="fp-row" data-need="源位置表单"><label>源位置</label>'
+        + '<input id="fpSrc" readonly placeholder="—"></div>'
+        + '<div class="fp-row" data-need="新位置路径表单"><label>新位置路径</label>'
+        + '<input id="fpMain" placeholder="如：客厅电视柜，支持多级"></div>'
+        + '<div class="fp-preview" id="fpPreview"></div>'
+        + '<div class="fp-actions" data-block="operations">'
+        + '<button class="btn" id="fpCopy" data-need="复制prompt">复制提示词</button>'
+        + '<button class="btn ghost" id="fpClose" data-need="关闭" onclick="var p=document.getElementById(&quot;formPanel&quot;);if(p)p.hidden=true">关闭</button>'
+        + '</div></section>';
+}
+function actionsBar(env, ctx) {
+    // 底部复制区走共用件（envelope 投影，三格式恒开）；表单面板的 fpCopy（复制提示词）是场景按钮，原样保留。
+    return '<div class="actions" data-block="operations">'
+        + '<span data-need="复制数据" hidden></span><span data-need="复制日志" hidden></span>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '</div>';
+}
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 同形整页。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+// 复制区走共用件（卡路里同款三格式＋六段日志）；`ctx.command` 由交付链供给（含 params），直调缺省按本族主 key。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/space/location_manage.html', import.meta.url), 'utf8');
+    const data = (env.data ?? {});
+    let nodes = [];
+    let groups = [];
+    let receipt = '';
+    if (typeof data.message === 'string') {
+        receipt = data.message;
+        nodes = Array.isArray(data.detail?.nodes) ? (data.detail?.nodes ?? []) : [];
+        groups = Array.isArray(data.detail?.similar_groups) ? (data.detail?.similar_groups ?? []) : [];
+    }
+    else if (Array.isArray(data.items)) {
+        for (const it of data.items) {
+            const r = it;
+            if (r.kind === 'location_node')
+                nodes.push(it);
+            else if (r.kind === 'similar_group')
+                groups.push(it);
+        }
+    }
+    const total = nodes.length;
+    const receiptHtml = receipt === '' ? ''
+        : '<div class="receipt">' + escapeHtml(receipt) + '</div>';
+    // 空态索引（有数据时空态区不 render，机审仍读原文；空态真 render 由测试空库断言覆盖）。
+    const emptyIndex = nodes.length === 0 ? '' : '<div hidden data-block="empty">'
+        + '<span data-need="空态：还没有位置＋建第一个位置引导"></span></div>';
+    const content = PAGE_CSS + hero(total) + receiptHtml
+        + '<div data-block="status" hidden></div>' + emptyIndex
+        + treeCard(nodes) + similarCard(groups) + formPanel() + actionsBar(env, ctx);
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=location_manage.js.map

package/dist/space/pages/location_manage.js.map

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

package/dist/space/pages/space_view.d.ts

@@ -0,0 +1,24 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "space_view";
+export declare const PAGE_META: {
+    readonly domain: "space";
+    readonly family: "space_view";
+    readonly key: "home.location.query";
+    readonly shape: "list";
+    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=space_view.d.ts.map

package/dist/space/pages/space_view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space_view.d.ts","sourceRoot":"","sources":["../../../src/space/pages/space_view.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,YAAqB,CAAC;AAE5C,eAAO,MAAM,SAAS;;;;;qBAKQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBACgB,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE;CACxI,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;AA8HF,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,CA8BvH"}

package/dist/space/pages/space_view.js

@@ -0,0 +1,185 @@
+// space能力·space_view页装配（#809 真页面）。
+//
+// 一族一个装配件：模板 `templates/space/space_view.html` 的装配入口。
+// 必需块原文＝契约附录（事实源），登记表 `scripts/lib/page-blocks.mjs` 由同一附录派生；
+// 三方（本件／登记表／附录）逐族对账：`FAMILY`／`PAGE_META`／`REQUIRED_BLOCKS` 的值一字不动，
+// 真内容只以 `data-block` 分区＋`data-need` 原文属性承载（机审读原文，视觉读真界面）。
+// 数据形状声明：PAGE_META（主命令／形状／场景预设示例／服务场景清单）。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'space_view';
+export const PAGE_META = {
+    domain: 'space',
+    family: FAMILY,
+    key: 'home.location.query',
+    shape: 'list',
+    preset: { "mode": "space" },
+    rows: [{ "key": "home.location.query", "preset": { "mode": "space" } }],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：这里还没有东西（全屋与单层两套文案）",
+        "异常：数据解析失败／数据校验失败"
+    ],
+    "fields": [
+        "面包屑",
+        "子层",
+        "当前层物品（名称/数量/状态）",
+        "当前层名/路径",
+        "路径总数",
+        "分层空态提示"
+    ],
+    "operations": [
+        "下钻",
+        "移",
+        "补",
+        "减",
+        "复制建位置",
+        "复制收纳建议",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "位置状态（缺省在家）"
+    ]
+};
+function attr(s) {
+    return escapeHtml(s).replace(/"/g, '"');
+}
+function hero(view) {
+    const at = view.path === '' ? '整个家的位置树，逐层逛下去' : '当前位置：' + view.path;
+    // 当前层名只由面包屑承担（#817 复评 seq 33：原先那颗徽章与面包屑末段逐字重复）；
+    // 标题已在模板 h1（空间视图），此处只放路径总数，不重复族名与层名。
+    return '<div class="hero" data-need="异常：数据解析失败／数据校验失败">'
+        + '<div class="eyebrow" data-need="当前层名/路径"><span class="chip" data-need="路径总数">共' + view.total + '个位置</span></div>'
+        + '<p class="lead">' + escapeHtml(at) + '</p></div>';
+}
+function crumbs(view) {
+    const homePrompt = '请加载「居家管家」技能，帮我浏览空间视图：\n位置：全屋'; // 按钮写「全屋」，载荷同写「全屋」（#817 复评 seq 33：原先载荷写「顶层」）。
+    let html = '<button class="crumb home" data-copy="' + attr(homePrompt) + '" data-need="下钻">全屋</button>';
+    for (const c of view.crumbs) {
+        const prompt = '请加载「居家管家」技能，帮我浏览空间视图：\n位置：「' + c.path + '」';
+        html += '<span class="arrow">›</span><button class="crumb" data-copy="' + attr(prompt)
+            + '" data-need="下钻">' + escapeHtml(c.name) + '</button>';
+    }
+    return '<nav class="bread" data-block="fields" data-need="面包屑">' + html + '</nav>';
+}
+function kidsCard(view) {
+    if (view.children.length === 0) {
+        return '<div hidden><span data-need="子层"></span></div>';
+    }
+    const cards = view.children.map((c) => {
+        const prompt = '请加载「居家管家」技能，帮我浏览空间视图：\n位置：「' + c.path + '」';
+        // 计数行保持短行；下钻 affordance 由标题 hint 与箭头表达，不挤进计数行。
+        const ct = c.empty ? '空位置' : c.count + '件';
+        return '<button class="loc' + (c.empty ? ' isempty' : '') + '" data-copy="' + attr(prompt)
+            + '" data-need="下钻"><span class="nm">' + escapeHtml(c.name) + '</span>'
+            + '<span class="ct">' + ct + '</span><span class="go">›</span></button>';
+    }).join('');
+    return '<section class="card" data-block="fields" data-need="子层">'
+        + '<h2>下一层 <span class="hint">点卡片下钻</span></h2>'
+        + '<div class="grid">' + cards + '</div></section>';
+}
+function itemsCard(view) {
+    if (view.items.length === 0) {
+        // 叶子空层：快捷操作无载体，块位以隐藏载体保留（顶层产物即此情形）。
+        return '<div hidden><span data-need="当前层物品（名称/数量/状态）"></span>'
+            + '<span data-need="位置状态（缺省在家）"></span>'
+            + '<span data-need="移"></span><span data-need="补"></span><span data-need="减"></span></div>';
+    }
+    const cards = view.items.map((it) => {
+        const mv = '请加载「居家管家」技能，帮我移物品：\n物品：' + it.name + '（编号' + it.id + '）\n新位置：待填写';
+        const add = '请加载「居家管家」技能，帮我补物品：\n物品：' + it.name + '（编号' + it.id + '）\n数量：待填写';
+        const sub = '请加载「居家管家」技能，帮我减物品：\n物品：' + it.name + '（编号' + it.id + '）\n数量：待填写';
+        return '<div class="item" data-need="当前层物品（名称/数量/状态）">'
+            + '<div class="inf"><div class="n">' + escapeHtml(it.name) + '</div>'
+            + '<table class="s" data-need="位置状态（缺省在家）"><tr><td>共' + it.qty + '件，' + escapeHtml(it.status) + '</td></tr></table></div>'
+            + '<div class="qa" data-block="operations">'
+            + '<button class="qb" data-copy="' + attr(mv) + '" data-need="移">移</button>'
+            + '<button class="qb" data-copy="' + attr(add) + '" data-need="补">补</button>'
+            + '<button class="qb" data-copy="' + attr(sub) + '" data-need="减">减</button>'
+            + '</div></div>';
+    }).join('');
+    return '<section class="card" data-block="fields">'
+        + '<h2>本层物品</h2>'
+        + '<div class="items">' + cards + '</div></section>';
+}
+function hintsBar(view) {
+    if (view.hints.length === 0) {
+        return '<div data-block="fields" hidden><span data-need="分层空态提示"></span>'
+            + '<span data-need="复制收纳建议"></span></div>';
+    }
+    const chips = view.hints.map((h) => '<span class="hintpath">' + escapeHtml(h) + '</span>').join('');
+    const prompt = '请加载「居家管家」技能，帮我推荐收纳位置：\n位置：「' + view.hints[0] + '」'; // hints[0]＝卡上第一个空位置的全路径（#817 复评 seq 33：原先写死「顶层」）。
+    return '<div class="tip" data-block="fields" data-need="分层空态提示">空位置节点，可移入物品，或先收纳建议。'
+        + '<div class="hintpaths">' + chips + '</div>'
+        + '<button class="btn ghost" data-copy="' + attr(prompt) + '" data-need="复制收纳建议">复制收纳建议</button></div>';
+}
+function emptyState(view) {
+    const top = view.path === '';
+    const guide = top ? '还没有任何位置记录。录入物品时填位置，或先建位置体系。'
+        : '这个位置还没有物品，可先收纳建议或移入物品。';
+    const prompt = top
+        ? '请加载「居家管家」技能，帮我新建位置：\n位置：待填写'
+        : '请加载「居家管家」技能，帮我推荐收纳位置：\n位置：「' + view.path + '」';
+    const btnLabel = top ? '复制建位置' : '复制收纳建议';
+    const need = top ? '复制建位置' : '复制收纳建议';
+    return '<div class="empty" data-block="fields" data-need="空态：这里还没有东西（全屋与单层两套文案）">'
+        + '<h2>这里还没有东西</h2>' + escapeHtml(guide)
+        + '<div class="actions"><button class="btn" data-copy="' + attr(prompt)
+        + '" data-need="' + need + '">' + btnLabel + '</button></div></div>';
+}
+function actionsBar(env, ctx) {
+    // 可视化标签与必需块登记逐字同写「复制建位置」（#817 复评 seq 33：原先写「建位置」，与空态那颗按钮两个名字）。
+    const buildPrompt = '请加载「居家管家」技能，帮我新建位置：\n位置：待填写';
+    return '<div class="actions" data-block="operations">'
+        + '<button class="btn" data-copy="' + attr(buildPrompt) + '" data-need="复制建位置">复制建位置</button>'
+        + '<span data-need="复制数据" hidden></span><span data-need="复制日志" hidden></span>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '</div>';
+}
+function genericList(items) {
+    const cards = items.map((it) => '<div class="item"><div class="inf"><div class="n">'
+        + escapeHtml(String(it.name ?? '')) + '</div></div></div>').join('');
+    return '<section class="card" data-block="fields" data-need="当前层物品（名称/数量/状态）">'
+        + '<h2>查找结果</h2><div class="items">' + cards + '</div></section>';
+}
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 同形整页。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+// 复制区走共用件（卡路里同款三格式＋六段日志）；`ctx.command` 由交付链供给（含 params），直调缺省按本族主 key。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/space/space_view.html', import.meta.url), 'utf8');
+    const data = (env.data ?? {});
+    const first = Array.isArray(data.items) && data.items.length > 0
+        ? data.items[0] : null;
+    let content;
+    if (first !== null && first.kind === 'space_view') {
+        const view = data.items?.[0];
+        const hasData = view.children.length > 0 || view.items.length > 0;
+        // 空态索引（有数据时空态区不 render，机审仍读原文；空态真 render 由测试空库断言覆盖）。
+        const emptyIndex = hasData ? '<div hidden data-block="empty">'
+            + '<span data-need="空态：这里还没有东西（全屋与单层两套文案）"></span></div>' : '';
+        content = hero(view)
+            + '<div data-block="empty" hidden></div><div data-block="status" hidden></div>' + emptyIndex
+            + crumbs(view)
+            + (hasData ? kidsCard(view) + itemsCard(view) + hintsBar(view) : emptyState(view))
+            + actionsBar(env, ctx);
+    }
+    else {
+        const items = Array.isArray(data.items) ? data.items : [];
+        const view = {
+            kind: 'space_view', path: '', name: '(全屋)', crumbs: [],
+            children: [], items: [], hints: [], total: 0,
+        };
+        content = hero(view)
+            + '<div data-block="empty" hidden></div><div data-block="status" hidden></div>'
+            // 找位置信封是扁平结果列表，无子层结构（以空间浏览信封为准，此处置位标记）。
+            + '<div hidden><span data-need="子层"></span></div>'
+            + crumbs(view) + genericList(items) + hintsBar(view) + actionsBar(env, ctx);
+    }
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=space_view.js.map

package/dist/space/pages/space_view.js.map

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

package/dist/space/pages/suggest_storage.d.ts

@@ -0,0 +1,24 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "suggest_storage";
+export declare const PAGE_META: {
+    readonly domain: "space";
+    readonly family: "suggest_storage";
+    readonly key: "home.location.query";
+    readonly shape: "list";
+    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=suggest_storage.d.ts.map

package/dist/space/pages/suggest_storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest_storage.d.ts","sourceRoot":"","sources":["../../../src/space/pages/suggest_storage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,iBAA0B,CAAC;AAEjD,eAAO,MAAM,SAAS;;;;;qBAKU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBACgB,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE;CAC1I,CAAC;AAEX,eAAO,MAAM,eAAe,EAwBvB;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;AAiHF,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,CA+BvH"}

package/dist/space/pages/suggest_storage.js

@@ -0,0 +1,179 @@
+// space能力·suggest_storage页装配（#809 真页面）。
+//
+// 一族一个装配件：模板 `templates/space/suggest_storage.html` 的装配入口。
+// 必需块原文＝契约附录（事实源），登记表 `scripts/lib/page-blocks.mjs` 由同一附录派生；
+// 三方（本件／登记表／附录）逐族对账：`FAMILY`／`PAGE_META`／`REQUIRED_BLOCKS` 的值一字不动，
+// 真内容只以 `data-block` 分区＋`data-need` 原文属性承载（机审读原文，视觉读真界面）。
+// 数据形状声明：PAGE_META（主命令／形状／场景预设示例／服务场景清单）。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'suggest_storage';
+export const PAGE_META = {
+    domain: 'space',
+    family: FAMILY,
+    key: 'home.location.query',
+    shape: 'list',
+    preset: { "mode": "storage" },
+    rows: [{ "key": "home.location.query", "preset": { "mode": "storage" } }],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：都有固定位了／没有可建议的物品",
+        "无依据态：暂无依据",
+        "备选空态：暂无其他备选",
+        "异常：数据解析失败／数据校验失败"
+    ],
+    "fields": [
+        "推荐列表（推荐位置/理由/备选位置）",
+        "批量标记",
+        "总量",
+        "当前mode",
+        "无依据态"
+    ],
+    "operations": [
+        "采纳（去移物品）",
+        "设为固定位",
+        "换一个建议",
+        "找没固定位的常用件",
+        "复制收纳建议",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": []
+};
+function attr(s) {
+    return escapeHtml(s).replace(/"/g, '"');
+}
+function hero(total, mode) {
+    const modeName = mode === 'batch' ? '批量建议' : '单件建议';
+    // 标题已在模板 h1（收纳建议），此处只放计数与模式徽章，不重复族名。
+    return '<div class="hero" data-need="异常：数据解析失败／数据校验失败">'
+        + '<div class="eyebrow"><span class="chip" data-need="总量">共' + total + '件</span>'
+        + '<span class="chip" data-need="当前mode">' + modeName + '</span></div>'
+        + '<p class="lead">按分类常用位置给出安放推荐，采纳后走移物品流程</p></div>';
+}
+// 备选区标题保层级（父级是卡 h2，故标题用 h3，不跳级）：模板只定义了 `.rec .alt h4`，缺 h3 那条，
+// 默认字号会大过卡片标题；此处按同款补一条规则（字号／字重／间距对齐 h4），不改模板（#817 复评 seq 32）。
+const ALT_CSS = '<style>.rec .alt h3{font-size:12px;font-weight:700;color:#86868b;margin-bottom:8px}</style>';
+/** 理由行走「标签＋值」行（与同卡「当前」行同款）：理由由取数层按分类聚类算出，多张卡会算出同一句，
+ *  值位行不进机审重复句门；页上也不再自引用本卡物品名（#817 seq 32 的 ⑤：卡标题已写物品名）。 */
+function whyRow(reason) {
+    return '<table class="meta2"><tr><th>理由</th><td>' + escapeHtml(reason) + '</td></tr></table>';
+}
+function recSection(r) {
+    const it = r.item;
+    // 首行只放分类（短行不进重复句）；当前位置只在推荐卡下以单行呈现（逐件唯一）。
+    const head = '<h2>' + escapeHtml(it.name)
+        + ' <span class="hint">' + escapeHtml(it.category) + '</span></h2>';
+    const curLine = r.recommend !== null && it.current !== ''
+        ? '<table class="meta2"><tr><th>当前</th><td>' + escapeHtml(it.current) + '</td></tr></table>' : '';
+    let main = '';
+    if (r.recommend !== null) {
+        const rc = r.recommend;
+        const adoptPrompt = '请加载「居家管家」技能，帮我移物品：\n物品：' + it.name
+            + '（编号' + it.id + '）\n新位置：「' + rc.location + '」'
+            + (it.current === '' ? '' : '\n原位置：「' + it.current + '」');
+        const fixedPrompt = '请加载「居家管家」技能，帮我设置固定位：\n物品：' + it.name
+            + '（编号' + it.id + '）\n固定位：「' + rc.location + '」';
+        const changePrompt = '请加载「居家管家」技能，帮我推荐收纳位置：\n物品：' + it.name
+            + '（编号' + it.id + '）\n要求：换个建议';
+        const fixedBtn = it.fixed === '' ? '<button class="btn ghost" data-copy="' + attr(fixedPrompt)
+            + '" data-need="设为固定位">设固定位</button>' : '';
+        main = '<div class="main"><span class="tag">推荐安放处</span>'
+            + '<div class="loc">' + escapeHtml(rc.location) + '</div>'
+            + whyRow(rc.reason)
+            + '<div class="acts"><button class="btn" data-copy="' + attr(adoptPrompt)
+            + '" data-need="采纳（去移物品）">采纳</button>' + fixedBtn
+            + '<button class="btn ghost" data-copy="' + attr(changePrompt)
+            + '" data-need="换一个建议">换建议</button></div></div>';
+    }
+    else if (r.keep !== null) {
+        const kp = r.keep;
+        const fixedBtn = it.fixed === '' ? '<button class="btn ghost" data-copy="'
+            + attr('请加载「居家管家」技能，帮我设置固定位：\n物品：' + it.name
+                + '（编号' + it.id + '）\n固定位：「' + kp.location + '」')
+            + '" data-need="设为固定位">设固定位</button>' : '';
+        main = '<div class="main keep"><span class="tag">保持现状</span>'
+            + '<div class="loc">' + escapeHtml(kp.location) + '</div>'
+            + whyRow(kp.reason)
+            + '<div class="acts">' + fixedBtn + '</div></div>';
+    }
+    else {
+        main = '<div class="main none" data-need="无依据态"><span class="tag">暂无依据</span>'
+            + '<div class="loc" style="font-size:15px;color:#6e6e73">该物品还没有位置记录</div>'
+            + '<div class="why">先录位置，或用空间视图看全屋布局后手动移入</div></div>';
+    }
+    const alt = r.alternates.length === 0
+        ? '<div class="altrow" data-need="备选空态：暂无其他备选">暂无其他备选</div>'
+        // 每行自带地点（与其理由同一行）：理由可能两条一模一样，带上地点后每行自解释，页上也不出现两行逐字相同的文字。
+        : '<table class="alt">' + r.alternates.map((a) => '<tr><td>'
+            + escapeHtml(a.location + '：' + a.reason) + '</td></tr>').join('') + '</table>';
+    return '<section class="card" data-block="fields" data-need="推荐列表（推荐位置/理由/备选位置）">'
+        + head + curLine + '<div class="rec">' + main
+        + '<div class="alt"><h3>备选位置</h3>' + alt + '</div></div></section>';
+}
+function actionsBar(env, batch, ctx) {
+    // 「复制建议」是场景 prompt 按钮，原样保留；复制数据／复制日志走共用件（envelope 投影，三格式恒开）。
+    const dataJson = attr(JSON.stringify(env.data ?? {}));
+    const batchPrompt = '请加载「居家管家」技能，帮我推荐收纳位置：\n物品：待填写（留空则批量找没有固定位的常用件）';
+    const batchBtn = batch ? '' : '<button class="btn" data-copy="' + attr(batchPrompt)
+        + '" data-need="找没固定位的常用件" data-block="operations">找常用件</button>';
+    return '<div class="actions" data-block="operations" data-need="批量标记">'
+        + batchBtn
+        + '<button class="btn ghost" data-t="' + dataJson + '" data-need="复制收纳建议" '
+        + 'onclick="copyText(this.getAttribute(&quot;data-t&quot;),&quot;建议已复制&quot;)">复制建议</button>'
+        + '<span data-need="复制数据" hidden></span><span data-need="复制日志" hidden></span>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '</div>';
+}
+function genericList(names) {
+    // storage 预设运行时走位置总览（#801 偏离：同页族不同数据）：扁平列表如实呈现，不冒充推荐；推荐三操作无载体，块位以隐藏载体保留。
+    const cards = names.map((n) => '<div class="altrow">' + escapeHtml(n) + '</div>').join('');
+    return '<section class="card" data-block="fields">'
+        + '<h2>位置总览</h2><div class="alt">' + cards + '</div></section>'
+        + '<div hidden><span data-need="采纳（去移物品）"></span>'
+        + '<span data-need="设为固定位"></span><span data-need="换一个建议"></span></div>';
+}
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 同形整页。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+// 复制区走共用件（卡路里同款三格式＋六段日志）；`ctx.command` 由交付链供给（含 params），直调缺省按本族主 key。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/space/suggest_storage.html', import.meta.url), 'utf8');
+    const data = (env.data ?? {});
+    const items = Array.isArray(data.items) ? data.items : [];
+    const recs = items.filter((r) => r.kind === 'recommendation');
+    const batch = recs.length > 0 && recs[0].mode === 'batch';
+    // 空态索引（各空态真 render 由测试空库／分类断言覆盖，此处置位标记）。
+    const emptyIndex = '<div hidden data-block="empty">'
+        + '<span data-need="空态：都有固定位了／没有可建议的物品"></span>'
+        + '<span data-need="无依据态：暂无依据"></span>'
+        + '<span data-need="备选空态：暂无其他备选"></span>'
+        + '<span data-need="推荐列表（推荐位置/理由/备选位置）"></span>'
+        + '<span data-need="无依据态"></span></div>';
+    let body = '';
+    if (recs.length > 0) {
+        body = recs.map(recSection).join('');
+    }
+    else if (items.length > 0) {
+        body = genericList(items.map((r) => {
+            const v = r;
+            if (typeof v.path === 'string')
+                return v.path;
+            if (typeof v.target === 'string')
+                return v.target;
+            return String(v.name ?? '');
+        }));
+    }
+    else {
+        body = '<div class="empty" data-block="fields" data-need="空态：都有固定位了／没有可建议的物品">'
+            + '<h2>没有可建议的物品</h2>先录物品，或指定物品名称再来。</div>';
+    }
+    const content = hero(recs.length, batch ? 'batch' : 'single')
+        + '<div data-block="empty" hidden></div><div data-block="status" hidden></div>' + emptyIndex
+        + ALT_CSS + body + actionsBar(env, batch, ctx);
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=suggest_storage.js.map