hd-garden 0.13.0 → 0.13.2

package/README.en.md

@@ -73,7 +73,7 @@ Ask your Agent to compile the post using the bundled `garden-ui` skill: it runs
 ```bash
 make new SLUG=writing-pace TITLE="Writing Pace" # Create a draft post in content/posts/
 make dev                                        # Sync content and start the local server
-CONTENT_INCLUDE_DRAFTS=1 make dev               # Preview drafts and future publishAt posts
+CONTENT_INCLUDE_DRAFTS=0 make dev              # Preview published posts only (optional)
 make check                                      # Run garden sync and garden build
 make update MESSAGE="Add writing-pace post"     # Check, commit, and push to origin
 npx garden check content/posts/writing-pace.md  # Validate front matter, components, and assets

package/README.md

@@ -75,7 +75,7 @@ Obsidian 插件这一轮不随包安装。
 ```bash
 make new SLUG=writing-pace TITLE="慢慢写"      # 在 content/posts/ 下创建文章草稿
 make dev                                       # 同步内容并启动本地预览
-CONTENT_INCLUDE_DRAFTS=1 make dev              # 连同草稿和未来定时文章一起预览
+CONTENT_INCLUDE_DRAFTS=0 make dev             # 只预览已发布文章（可选）
 make check                                     # 运行 garden sync 与 garden build 验证全站
 make update MESSAGE="新增一篇文章"             # 检查通过后提交并推送到远端仓库
 npx garden check content/posts/writing-pace.md # 单独检查一篇文章的标题、组件与资源路径

package/app/components/GardenDocsNav.tsx

@@ -8,10 +8,11 @@ import {
   groupHandbookDocs,
   HANDBOOK_SECTIONS,
   HANDBOOK_UI,
-  NAV_SHORT_TITLE,
   REFERENCE_SECTION,
+  handbookNavLabel,
   isReferencePath,
   handbookPath,
+  referenceBadgeSuffix,
   sectionTitle,
   type GardenDocNavItem,
   type HandbookLang,
@@ -103,7 +104,7 @@ export function GardenDocsNav({
         <div className="gdoc-mobile-crumb" aria-hidden="true">
           <span>{sectionTitle(currentSection, lang) ?? t.name}</span>
           <CaretRight size={12} />
-          <strong>{currentDoc ? (lang === "en" ? currentDoc.navTitle ?? currentDoc.title : NAV_SHORT_TITLE[currentDoc.path] ?? currentDoc.title) : t.overviewHint}</strong>
+          <strong>{currentDoc ? handbookNavLabel(currentDoc, lang) : t.overviewHint}</strong>
         </div>
       </div>
 
@@ -161,7 +162,10 @@ export function GardenDocsNav({
                 {group.items.map((item) => {
                   const active = item.path === currentPath;
                   const badge = COMPONENT_BADGE[item.path];
-                  const label = lang === "en" ? item.navTitle ?? item.title : NAV_SHORT_TITLE[item.path] ?? item.title;
+                  const label = handbookNavLabel(item, lang);
+                  const referenceSuffix = group.id === REFERENCE_SECTION && badge
+                    ? referenceBadgeSuffix(badge, label)
+                    : null;
                   return (
                     <li key={item.path} className={active ? "is-active" : undefined}>
                       <Link
@@ -172,7 +176,11 @@ export function GardenDocsNav({
                         {badge ? (
                           <>
                             <code className="gdoc-comp-pill">{badge}</code>
-                            {group.id === REFERENCE_SECTION ? null : <span className="gdoc-comp-label">{label}</span>}
+                            {group.id === REFERENCE_SECTION ? (
+                              referenceSuffix ? <span className="gdoc-comp-label">{referenceSuffix}</span> : null
+                            ) : (
+                              <span className="gdoc-comp-label">{label}</span>
+                            )}
                           </>
                         ) : (
                           <span>{label}</span>

package/app/lib/garden-docs-meta.ts

@@ -133,6 +133,31 @@ export const NAV_SHORT_TITLE: Record<string, string> = {
   reference: "总览",
 };
 
+
+/**
+ * Reference sidebar shows COMPONENT_BADGE inside <code>. When two pages share a
+ * badge (compose + compose-icons), keep the code pill and append the remainder
+ * of navTitle / short label after a separator (space / · / dash).
+ * Returns the suffix including its leading separator, or null.
+ */
+export function referenceBadgeSuffix(badge: string, label: string): string | null {
+  if (!badge || !label || label === badge) return null;
+  if (!label.startsWith(badge)) return null;
+  const rest = label.slice(badge.length);
+  if (!rest || !/^[\s·\-—]/.test(rest)) return null;
+  return rest;
+}
+
+/** Sidebar text label: prefer authored navTitle; ZH may fall back to NAV_SHORT_TITLE. */
+export function handbookNavLabel(item: GardenDocNavItem, lang: HandbookLang): string {
+  if (item.navTitle) return item.navTitle;
+  if (lang !== "en") {
+    const short = NAV_SHORT_TITLE[item.path];
+    if (short) return short;
+  }
+  return item.title;
+}
+
 export function groupHandbookDocs<T extends GardenDocNavItem>(docs: T[]) {
   const bySection = new Map<string, T[]>();
   for (const section of HANDBOOK_SECTIONS) {

package/bin/garden.mjs

@@ -522,6 +522,10 @@ async function main() {
       await sync();
       break;
     case "dev":
+      // Preview drafts by default, without overriding an explicit opt-out.
+      // Scoped to this CLI process: sync, Vinext and its watcher inherit it;
+      // later build/check commands do not.
+      process.env.CONTENT_INCLUDE_DRAFTS ??= "1";
       ensureDevGitHubLogin();
       await runVinext(["dev", ...rest]);
       break;

package/docs/handbook/components/file/checklist.md

@@ -14,4 +14,4 @@
 | :--- | :--- |
 | `npx garden check content/posts/<slug>.md` | 检查单篇文章的组件字段、代码对比与图片附件路径 |
 | `make check` | 运行 `npx garden sync && npx garden build` 校验全站构建 |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | 在本地连同草稿和定时文章一起预览 |
+| `make dev` | 在本地连同草稿和定时文章一起预览 |

package/docs/handbook/en/components/file/checklist.md

@@ -14,4 +14,4 @@ Before running `make update` to push changes, verify the following items:
 | :--- | :--- |
 | `npx garden check content/posts/<slug>.md` | Checks a single post's component fields, code diffs, and local asset paths |
 | `make check` | Runs `npx garden sync && npx garden build` to validate the full site build |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | Previews drafts and scheduled posts locally |
+| `make dev` | Previews drafts and scheduled posts locally |

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

@@ -173,7 +173,7 @@ One mini sample per group, then a one-line table for every tag. No per-tag essay
 
 ## Chart examples
 
-Play-level chart samples (static eight bars, fusion weight slider) live on [Diagrams · compose](/garden/en/components/compose#compose-chart-active-hours).
+Play-level chart samples (static eight bars, fusion weight slider) live on [Diagrams · compose](/garden/en/components/compose#ui-compose-chart-active-hours).
 
 ## Limits
 

package/docs/handbook/en/reference/file/checklist.md

@@ -14,4 +14,4 @@ Before running `make update` to push changes, verify the following items:
 | :--- | :--- |
 | `npx garden check content/posts/<slug>.md` | Checks a single post's component fields, code diffs, and local asset paths |
 | `make check` | Runs `npx garden sync && npx garden build` to validate the full site build |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | Previews drafts and scheduled posts locally |
+| `make dev` | Previews drafts and scheduled posts locally |

package/docs/handbook/en/start.md

@@ -59,10 +59,10 @@ make new DIR=network SLUG=tcp-bbr TITLE="TCP BBR Notes"
 > [!NOTE] Note
 > `SLUG` may only contain lowercase letters, digits, and hyphens (`a-z`, `0-9`, `-`), never `/`; pass subdirectories via `DIR`. `make new` reads only `SLUG`, `TITLE`, and `DIR`.
 
-Newly created files default to `draft: true`. Set `CONTENT_INCLUDE_DRAFTS=1` to preview drafts or future-dated (`publishAt`) posts locally:
+Newly created files default to `draft: true`. `make dev` previews drafts and future-dated (`publishAt`) posts by default. Use `CONTENT_INCLUDE_DRAFTS=0 make dev` to opt out. Production builds still exclude them by default:
 
 ```bash
-CONTENT_INCLUDE_DRAFTS=1 make dev
+make dev
 ```
 
 ### Creating a Thought
@@ -76,7 +76,7 @@ The site `Makefile` and `garden` CLI provide these commands:
 | Command | What It Runs |
 | :--- | :--- |
 | `make dev` | Runs `make prepare` to check dependencies, then runs `npx garden dev` (which syncs content and starts the dev server) |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | Previews `draft: true` drafts and future `publishAt` posts alongside published content |
+| `CONTENT_INCLUDE_DRAFTS=0 make dev` | Optional: preview published posts only, excluding drafts and future posts |
 | `make new SLUG=xxx TITLE="Title" DIR=subdir` | Calls `npx garden new` to create a draft post under `content/posts/` (`DIR` is optional) |
 | `make check` | Runs `npx garden sync && npx garden build` in the site repo to verify content sync and the production build |
 | `npx garden check content/posts/xxx.md` | Checks a single Markdown post's title, component fields, code diffs, and local asset paths |

package/docs/handbook/reference/compose.md

@@ -173,7 +173,7 @@ badge: compose
 
 ## 图表示例
 
-玩法级图表示例（静态八柱、融合权重滑杆）见 [说明图 · compose](/garden/components/compose#compose-chart-active-hours)。
+玩法级图表示例（静态八柱、融合权重滑杆）见 [说明图 · compose](/garden/components/compose#ui-compose-chart-active-hours)。
 
 ## 限制
 

package/docs/handbook/reference/file/checklist.md

@@ -14,4 +14,4 @@
 | :--- | :--- |
 | `npx garden check content/posts/<slug>.md` | 检查单篇文章的组件字段、代码对比与图片附件路径 |
 | `make check` | 运行 `npx garden sync && npx garden build` 校验全站构建 |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | 在本地连同草稿和定时文章一起预览 |
+| `make dev` | 在本地连同草稿和定时文章一起预览 |

package/docs/handbook/start.md

@@ -59,10 +59,10 @@ make new DIR=network SLUG=tcp-bbr TITLE="TCP BBR 拥塞控制笔记"
 > [!NOTE]
 > `SLUG` 只能包含小写字母、数字和连字符（`a-z`、`0-9`、`-`），不能包含 `/`；子目录必须用 `DIR` 参数传入。`make new` 只读取 `SLUG`、`TITLE` 和 `DIR` 三个变量。
 
-新建的文件默认带有 `draft: true`。本地预览草稿或未来定时文章（`publishAt`）时，加上环境变量 `CONTENT_INCLUDE_DRAFTS=1`：
+新建的文件默认带有 `draft: true`。`make dev` 默认预览草稿和未来定时文章（`publishAt`）；用 `CONTENT_INCLUDE_DRAFTS=0 make dev` 可关闭。正式构建仍默认排除它们：
 
 ```bash
-CONTENT_INCLUDE_DRAFTS=1 make dev
+make dev
 ```
 
 ### 新建随想
@@ -76,7 +76,7 @@ CONTENT_INCLUDE_DRAFTS=1 make dev
 | 命令 | 实际执行的操作 |
 | :--- | :--- |
 | `make dev` | 先执行 `make prepare` 检查依赖，再运行 `npx garden dev`（内部自动执行同步并启动开发服务器） |
-| `CONTENT_INCLUDE_DRAFTS=1 make dev` | 连同 `draft: true` 草稿和未到 `publishAt` 时间的文章一起预览 |
+| `CONTENT_INCLUDE_DRAFTS=0 make dev` | 可选：只预览已发布文章，排除草稿和未来定时文章 |
 | `make new SLUG=xxx TITLE="标题" DIR=子目录` | 调用 `npx garden new` 在 `content/posts/` 下生成新文章草稿（`DIR` 可省略） |
 | `make check` | 在站点仓库中运行 `npx garden sync && npx garden build`，验证全站同步与生产构建 |
 | `npx garden check content/posts/xxx.md` | 单独检查某篇 Markdown 文章的标题、组件字段、代码对比与本地附件路径 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "private": false,
   "description": "\u7528 Markdown \u5199\u4f5c\u3001\u7528 GitHub Pages \u53d1\u5e03\u7684\u4e2a\u4eba\u535a\u5ba2\u5f15\u64ce\u3002",
   "license": "MIT",

package/scripts/new-post.mjs

@@ -67,12 +67,12 @@ async function main() {
   if (lang === "en") {
     console.log(`Created draft: ${path.relative(root, destination)}`);
     console.log(`Post URL: /blog/${[...segments, slug].join("/")}/`);
-    console.log("Preview: CONTENT_INCLUDE_DRAFTS=1 make dev");
+    console.log("Preview: make dev");
     console.log("Before publishing, fill in description, tags, and body, set draft to false, then run make update.");
   } else {
     console.log(`已创建草稿：${path.relative(root, destination)}`);
     console.log(`文章路径：/blog/${[...segments, slug].join("/")}/`);
-    console.log("预览：CONTENT_INCLUDE_DRAFTS=1 make dev");
+    console.log("预览：make dev");
     console.log("发布前请完善摘要、标签与正文，并将 draft 改为 false，再运行 make update。");
   }
 }

package/templates/site/README.en.md

@@ -8,6 +8,8 @@ make new TITLE="Hello, World" SLUG=hello
 make dev
 ```
 
+`make dev`, `npm run dev`, and `npx garden dev` preview drafts and future scheduled posts by default. Opt out with `CONTENT_INCLUDE_DRAFTS=0 make dev`. Production builds exclude them by default.
+
 Running `npx garden dev` for the first time fills in any missing `Makefile` or skills and creates `.env.local`. Cursor and Codex read `.agents/skills/` automatically when opening this repository. Run `npx garden skill` anytime to update the bundled skills.
 
 `npx hd-garden init` copies the VS Code / Cursor and Typora Intelligent UI plugins into `.garden/editors/` and asks whether to install them when the terminal is interactive. Run `npx garden editors install` later (`--yes` installs both, `--vscode` or `--typora` installs one). Typora needs typora-community-plugin first; then enable the plugin under Settings, Installed plugins. Use the plugins to insert a plain `garden` brief for the `garden-ui` skill to compile, preview a component, and open the catalog. In Typora, type `/` and choose `/garden` to list each component with a small preview image. Hand `Compile this post:` to the skill when you want it compiled.

package/templates/site/README.md

@@ -8,6 +8,8 @@ make new TITLE="你好，世界" SLUG=hello
 make dev
 ```
 
+`make dev`、`npm run dev` 和 `npx garden dev` 默认预览草稿及未来定时文章。可用 `CONTENT_INCLUDE_DRAFTS=0 make dev` 关闭；正式构建默认排除这些内容。
+
 第一次 `npx garden dev` 会补齐 Makefile 和 skill，并创建 `.env.local`。Cursor / Codex 打开这个仓库后会读到 `.agents/skills/`。要更新 skill，再运行 `npx garden skill`。
 
 `npx hd-garden init` 会把 VS Code / Cursor 与 Typora 的 Intelligent UI 插件放到 `.garden/editors/`，并在交互终端里询问要不要安装。之后可以运行 `npx garden editors install`（加 `--yes` 则直接安装，`--vscode` / `--typora` 只装一个）。Typora 需要先装 typora-community-plugin，再在「设置 → 已安装插件」里勾选。插件用来插入想法（一段给 `garden-ui` skill 编译的 `garden` 围栏，不是写好的 YAML）、预览组件、打开清单，并把「编译这篇」交给 skill。Typora 里输入 `/` 选 `/garden`，再从带小预览图的列表里选。