hd-garden 0.14.2 → 0.14.5

package/app/styles/shell.css

@@ -36,15 +36,15 @@ img,svg{max-width:100%}
 /* ---------- header ---------- */
 .sh-header{position:sticky;top:0;z-index:40;background:var(--paper);border-bottom:1px solid transparent;transition:border-color .2s ease}
 .sh-header.is-scrolled{border-bottom-color:var(--rule)}
-.sh-bar{max-width:var(--shell);margin:0 auto;height:var(--hdr);padding:0 32px;display:flex;align-items:center;gap:28px}
-.sh-word{display:inline-flex;align-items:center;gap:10px;font:600 var(--fs-lead)/1 var(--serif);color:var(--ink);text-decoration:none;white-space:nowrap;padding:8px 0}
+.sh-bar{max-width:var(--shell);margin:0 auto;min-height:var(--hdr);height:auto;padding:0 32px;display:flex;align-items:center;gap:28px}
+.sh-word{display:inline-flex;align-items:center;gap:10px;font:600 var(--fs-lead)/1 var(--serif);color:var(--ink);text-decoration:none;white-space:normal;overflow-wrap:anywhere;min-width:0;flex:0 1 auto;line-height:1.2;padding:8px 0}
 .sh-mark{display:inline-flex;flex:none}
 .sh-mark svg{display:block;height:26px;width:auto}
-.sh-nav{display:flex;gap:4px;margin-left:auto}
+.sh-nav{display:flex;flex-shrink:0;gap:4px;margin-left:auto}
 .sh-nav a{font-size:15px;color:var(--soft);text-decoration:none;padding:8px 12px;border-radius:var(--r);transition:color .15s ease,background-color .15s ease}
 .sh-nav a:hover{color:var(--ink);background:var(--tint)}
 .sh-nav a[aria-current="page"],.sh-nav a[aria-current="true"]{color:var(--blue);font-weight:600}
-.sh-tools{display:flex;align-items:center;gap:8px}
+.sh-tools{display:flex;flex-shrink:0;align-items:center;gap:8px}
 /* A hairline box so the entry reads as a field, not a stray word. */
 .sh-search{display:inline-flex;align-items:center;gap:6px;box-sizing:border-box;height:34px;padding:0 10px 0 12px;border:1px solid var(--rule);background:transparent;color:var(--soft);border-radius:8px;font:400 15px/1 var(--sans);cursor:pointer;appearance:none;transition:color .15s ease,border-color .15s ease}
 .sh-search:hover{color:var(--ink);border-color:var(--rule-strong)}

package/bin/garden.mjs

@@ -495,7 +495,7 @@ function help() {
   garden files            读取 Compose <file> 里远程文件的大小，写入 file-sizes.json（build 时会自动做）
   garden init [目录]      创建只含稿和配置的新站点
   garden check <文章.md>  检查一篇博文的硬性结构
-  garden verify [文章.md|--diff] 全量/单篇/改动文档严格预检（包含草稿；make check 使用）
+  garden verify [文章.md|--diff|--rendered] 全量/单篇/改动文档严格预检（包含草稿；make check 使用）
   garden ui <子命令>      Intelligent UI：scan、check、apply、prompt、schema、catalog
   garden hooks            安装提交前检查（检查暂存稿件里的 ui 块）
   garden editors install  安装 Intelligent UI 插件到 VS Code / Cursor 与 Typora（--vscode、--typora、--yes）
@@ -544,6 +544,7 @@ async function main() {
         runNode("scripts/html-lang.mjs");
         // 404.html also under basePath when the host serves that folder alone.
         runNode("scripts/static-404.mjs");
+        runNode("scripts/rendered-site.mjs");
       }
       break;
     case "links":
@@ -565,7 +566,12 @@ async function main() {
       runNode("scripts/fetch-embed.mjs", rest);
       break;
     case "verify":
-      runNode("scripts/check-site.mjs", rest);
+      if (rest[0] === "--rendered") {
+        if (rest.length !== 1) fail("Usage: garden verify --rendered");
+        runNode("scripts/rendered-site.mjs");
+      } else {
+        runNode("scripts/check-site.mjs", rest);
+      }
       break;
     case "check":
       runNode("scripts/check-post.mjs", rest);

package/docs/handbook/components/compose.md

@@ -24,6 +24,8 @@ badge: compose
 
 先说明视觉关系与重点，再使用受支持的属性表达必要样式。默认样式不保证复刻参考图，必须检查真实排版。
 
+静态 Compose 最外层场景默认背景透明，边框、圆角与内边距仍保留。无底色不等于无外框；需要去掉整个场景外框时，使用唯一最外层 `<figure frame="none">…</figure>`。内部容器显式指定的背景、tone 与节点填色不受影响；全屏或弹层的背景由宿主单独处理。
+
 **完整标签与属性**见 [组件参考 · compose](/garden/reference/compose)；**全部图标名**见 [compose 图标](/garden/reference/compose-icons)。
 
 ## 写法对照

package/docs/handbook/en/components/compose.md

@@ -24,6 +24,8 @@ Cover four things:
 
 Describe the visual relationships and desired emphasis. Defaults are a starting point, not a substitute for checking alignment and hierarchy. Explicit styling must use supported controls.
 
+The outer static Compose scene is transparent by default; its border, corner radius, and padding remain. A transparent background does not remove the frame. To remove the entire scene frame, use one outer `<figure frame="none">…</figure>`. Explicit container backgrounds, tones, and node fills are unchanged. The host handles fullscreen or overlay backgrounds separately.
+
 **Every tag and shared token**: [compose reference](/garden/en/reference/compose). **Every icon name**: [compose icons](/garden/en/reference/compose-icons).
 
 ## Rewrite patterns

package/docs/handbook/en/reference/compose.md

@@ -109,3 +109,10 @@ Safe HTML supports allowlisted local `style` properties, including useful layout
 3. Inspect the complete-theme render: icon rail fixed, heading and **all** paragraphs share the same right edge/left edge, no centered headings or full-width body beneath a detached icon row, dividers outside rows, no unintended cards/arrows, no horizontal overflow.
 4. Check desktop and narrow screenshots plus geometry/computed styles; exercise choices, relations, file previews, state updates and sandbox behavior when used.
 5. A hand-authored passing scene proves engine capability, not that an independent model reliably produces it from a short prompt. Report those claims separately.
+
+## Host and exported-artifact acceptance
+Explicit `justify` owns the main axis; `align` owns the cross axis. A title and trailing badge can use `row align="center" justify="between"`. Reading width takes priority over side rails; frameless runtimes do not add body padding; fullscreen controls use a separate top band. The post's mobile contents entry stays in normal flow. Measure the real column and iframe before changing content or type size.
+
+Use native relations for ring-and-detail interactions. Custom topology stays in the same Compose entry, using an offline sandbox, HTML labels and connector-only SVG. The author skill includes a measured-endpoint recipe, not an automatic layout/obstacle router. An isolated iframe does not automatically inherit article web fonts.
+
+Static builds check final HTML links, CSS/JS and lazy dependencies, Compose styles and navigation payloads. Rerun with `garden verify --rendered`. Asset integrity is not visual or client-lifecycle proof: test normal homepage Link entry, return/re-entry, history and direct links separately.

package/docs/handbook/reference/compose.md

@@ -111,3 +111,10 @@ Safe HTML supports allowlisted local `style` properties, including useful layout
 3. Inspect the complete-theme render: icon rail fixed, heading and **all** paragraphs share the same right edge/left edge, no centered headings or full-width body beneath a detached icon row, dividers outside rows, no unintended cards/arrows, no horizontal overflow.
 4. Check desktop and narrow screenshots plus geometry/computed styles; exercise choices, relations, file previews, state updates and sandbox behavior when used.
 5. A hand-authored passing scene proves engine capability, not that an independent model reliably produces it from a short prompt. Report those claims separately.
+
+## 宿主与最终产物验收
+显式 `justify` 管主轴，`align` 管交叉轴；标题＋徽标可直接使用 `row align="center" justify="between"`。正文栏优先于侧栏，frame="none"不叠运行时内距，全屏按钮使用独立顶栏；手机目录入口随正文正常排版。先量真实正文/iframe宽度，不用缩字补救宿主挤压。
+
+复杂连线：原生relations适用于环形关系与详情；自定义拓扑使用同一compose内的离线sandbox，普通HTML承载文字，SVG只画线。作者skill提供实测端点配方，不提供自动排图/避障。iframe字体须单独验证，不能声称隔离文档自动继承文章web字体。
+
+静态构建自动检查最终HTML引用的CSS/JS及懒加载依赖、Compose样式与导航payload；`garden verify --rendered`可单独重跑。它不证明视觉或客户端导航；仍需测试首页正常Link、返回再入、历史及直接链接。