hd-garden 0.4.0 → 0.4.1

package/.agents/skills/garden-interactive-chart/SKILL.md

@@ -2,7 +2,7 @@
 name: garden-interactive-chart
 description: >-
   Writes Garden interactive charts as self-contained HTML in a same-name
-  sidecar directory and embeds them with a short widget fence. Use when adding
+  sidecar directory and embeds them with a short garden html fence. Use when adding
   or editing Garden widgets, steppers, inspect grids, param benches,
   compare views, traces, KV cache charts, or any 可交互图表 / 同名目录 HTML.
 ---
@@ -41,9 +41,9 @@ content/posts/understand-kv-cache/waste.html
 正文：
 
 ````md
-```widget
+```garden html
 src: ./understand-kv-cache/waste.html
-caption: 朴素 decode 每步重算全部过去 token；6 个 token 共 21 次计算，其中 15 次是浪费。
+title: 朴素 decode 每步重算全部过去 token；6 个 token 共 21 次计算，其中 15 次是浪费。
 ```
 ````
 
@@ -51,7 +51,7 @@ caption: 朴素 decode 每步重算全部过去 token；6 个 token 共 21 次
 
 - `src` 必须是该同名目录里的本地 `.html` 或 `.pdf`，不能指到 `assets/`、别的文章或 `https://`
 - 带 `garden-chart` 高度回报的 HTML 是图表，直接铺开；普通 HTML 和 PDF 默认收成示意入口，读者展开后再加载
-- `caption` 必须是判断，不能是「见下图」
+- `title` 必须是判断，不能是「见下图」
 - 一份 HTML 一张图；文件名用 `waste.html`、`stepper.html` 这种短 kebab
 - HTML 自包含：CSS、SVG、脚本都在这一个文件里
 - 先写 HTML，再写围栏；围栏里不要再摊步进数组或采样点
@@ -77,8 +77,8 @@ caption: 朴素 decode 每步重算全部过去 token；6 个 token 共 21 次
 
 ## 交稿前
 
-- [ ] 文件在同名目录内，围栏只有 `src` + `caption`
+- [ ] 文件在同名目录内，围栏只有 `src` + `title`
 - [ ] 单独打开 HTML 就能用；iframe 能撑开高度
 - [ ] 浅色 / 深色主题都跟 Garden 纸面
 - [ ] 减少动态时不自动循环
-- [ ] `caption` 让关 JS 的人也能读到结论
+- [ ] `title` 让关 JS 的人也能读到结论

package/.agents/skills/garden-ui/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: garden-ui
 description: >-
-  Compiles the intent blocks in one Garden post into ui blocks (or prose, or a
-  widget), recompiles stale or broken ui blocks, and suggests where a post
+  Compiles the intent blocks in one Garden post into ui blocks (or prose, or
+  garden html), recompiles stale or broken ui blocks, and suggests where a post
   could use interaction. Use when the user says 编译这篇 / 编译意图块 / 重编译
   <id> / 这篇哪里适合交互, or pastes a garden ui check fix prompt.
 ---
@@ -43,7 +43,7 @@ description: >-
 3. 每块读原话和所在小节，三选一：
    - **写回正文**：一句话、一张表或一张 Mermaid 就能说清时。
    - **写 `ui`**：读者需要拖、点、翻才能看懂时。
-   - **写 `widget`**：目录表达不了的画布动画、音频、物理模拟等。按 [garden-interactive-chart](../garden-interactive-chart/SKILL.md) 在同名目录写 HTML，并在 `widget` 的 YAML 里加 `intent:` 保留原话。
+   - **写 `garden html`**：目录表达不了的画布动画、音频、物理模拟等。按 [garden-interactive-chart](../garden-interactive-chart/SKILL.md) 在同名目录写 HTML，用 `title` 写下判断。
 
 4. 写 `ui` 时：
    - 原话原样放进块头的 `intent`，一个字都不改。`compiled` 不用写，`apply` 会写。
@@ -69,7 +69,7 @@ description: >-
    ````
 
    - 没写 id 的 `intent` 块用 `--intent-hash <intentHash>` 定位；原话重复时改用 `--at <startLine>`。
-   - 新内容可以是一个 `ui` 围栏、一个 `widget` 围栏，或一段普通 Markdown（写回正文时）。
+   - 新内容可以是一个 `ui` 围栏、一个 `garden html` 围栏，或一段普通 Markdown（写回正文时）。
    - 成功时 stdout 是 `{"ok":true,...}`。失败时 stderr 是 JSON，按 `code` 处理：
      - `apply-invalid`：新内容没通过校验，按 `diagnostics` 改了再写。
      - `apply-base`：块在扫描之后被改过。重新 `scan`，用新的 `hash`。

package/app/blog/[...path]/page.tsx

@@ -99,7 +99,6 @@ export default async function PostPage({
               </time>
             </li>
             {post.updated ? <li>更新于 {formatDate(post.updated)}</li> : null}
-            <li>{post.readingTime}</li>
             <li>约 {wordCount.toLocaleString("en-US")} 字</li>
             {post.topic ? (
               <li>

package/app/columns/[column]/[...path]/page.tsx

@@ -122,7 +122,6 @@ export default async function ColumnEntryPage({
                 {formatDate(entry.date)}
               </time>
             </li>
-            <li>{entry.readingTime}</li>
             {entry.topic && entry.topic !== entry.columnTitle ? (
               <li><a className="cat" href={`/blog?topic=${encodeURIComponent(entry.topic)}`}>{entry.topic}</a></li>
             ) : null}

package/app/lib/content.ts

@@ -8,6 +8,7 @@ import {
 } from "@garden/generated-content";
 import GithubSlugger from "github-slugger";
 import { canonicalSiteDate } from "../../scripts/site-date.mjs";
+import { demoDateLabel } from "./a2-meta";
 import { contentToSearchText } from "../../ui/core/transform.mjs";
 import { toString } from "mdast-util-to-string";
 import remarkParse from "remark-parse";
@@ -26,6 +27,7 @@ export const columnHref = (entry: Pick<ContentEntry, "column" | "path">) =>
   `/columns/${entry.column}/${columnEntryPath(entry)}`;
 
 export const formatDate = (value: string, withTime = false) => {
+  if (!withTime) return demoDateLabel(value);
   const canonical = canonicalSiteDate(value) ?? value;
   const date = new Date(canonical);
   if (Number.isNaN(date.getTime())) return value;
@@ -34,7 +36,8 @@ export const formatDate = (value: string, withTime = false) => {
     year: "numeric",
     month: "2-digit",
     day: "2-digit",
-    ...(withTime ? { hour: "2-digit", minute: "2-digit" } : {}),
+    hour: "2-digit",
+    minute: "2-digit",
   }).format(date);
 };
 

package/app/page.tsx

@@ -49,7 +49,7 @@ export default function Home() {
       {posts.length > 0 && feature ? (
         <article className="sh-feature" aria-labelledby="ft">
           {feature.cover ? (
-            <div className="cover" style={{ background: "var(--cover)" }}>
+            <div className="cover">
               {/* eslint-disable-next-line @next/next/no-img-element */}
               <img src={feature.cover} alt="" />
             </div>

package/app/styles/shell.css

@@ -134,7 +134,8 @@ html[data-theme="dark"] .sh-rail{color:var(--muted)}
 .sh-intro .links a:hover{color:var(--blue);text-decoration-color:currentColor}
 .sh-feature{position:relative;display:grid;grid-template-columns:minmax(0,1.25fr) minmax(0,1fr);gap:48px;align-items:center;margin:56px 0 0}
 .sh-feature:not(:has(.cover)){grid-template-columns:minmax(0,1fr)}
-.sh-feature .cover{border-radius:var(--r-lg);aspect-ratio:16/9;display:flex;align-items:center;justify-content:center;overflow:hidden}
+.sh-feature .cover{border-radius:var(--r-lg);aspect-ratio:auto;display:block;overflow:hidden;background:none}
+.sh-feature .cover img{display:block;width:100%;height:auto}
 .sh-feature .cover .cover-art{height:86%;width:auto}
 .sh-feature .kicker{display:flex;flex-wrap:wrap;gap:4px 14px;font-size:var(--fs-small);color:var(--muted);margin:0 0 12px}
 .sh-feature h2{font:700 30px/1.35 var(--sans);color:var(--ink);margin:0;text-wrap:balance}
@@ -271,7 +272,6 @@ html[data-theme="dark"] .sh-pal-scrim{background:rgba(0,0,0,.55)}
   .sh-intro{padding:44px 0 0}
   .sh-intro p{font-size:var(--fs-body)}
   .sh-feature{grid-template-columns:minmax(0,1fr);gap:20px;margin-top:36px}
-  .sh-feature .cover{border-radius:16px}
   .sh-feature h2{font-size:24px}
   .sh-section{margin-top:56px}
   .sh-cols{grid-template-columns:minmax(0,1fr);gap:16px}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "private": false,
   "description": "用 Markdown 写作、用 GitHub Pages 发布的个人博客引擎。",
   "license": "MIT",