hd-garden 0.13.0 → 0.13.1

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/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/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/package.json

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