hd-garden 0.9.3 → 0.10.0

package/app/bookshelf/load.mjs

@@ -1,114 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import matter from "gray-matter";
-import { parse as parseYaml } from "yaml";
-import { gardenSiteRoot } from "../../scripts/garden-paths.mjs";
-import { bookshelfMountFromFile, normalizeBookshelfPostPath } from "../components/bookshelf/catalog.mjs";
-import { BookshelfConfigError, parseBookshelfConfig } from "../components/bookshelf/schema.mjs";
-
-export function bookshelfConfigPath(root = gardenSiteRoot()) {
-  return path.join(root, "content", "bookshelf.yaml");
-}
-
-/**
- * The site shelf, or null when `content/bookshelf.yaml` is absent.
- * Absent means the package demo (click-test only). A file here is the live shelf:
- * each book's `post` or `posts` is read from `content/posts`. One note becomes
- * the open-book HTML. Several notes stay on the book for `/bookshelf/<id>`.
- * `preparedPosts`, when passed, are the sync pipeline's posts (rewritten asset
- * URLs). Otherwise the markdown files are read directly.
- * Throws `BookshelfConfigError` when the file, a cover, or a post path is broken.
- */
-export function loadBookshelf(root = gardenSiteRoot(), preparedPosts) {
-  const file = bookshelfConfigPath(root);
-  if (!fs.existsSync(file)) return null;
-  let parsed;
-  try {
-    parsed = parseYaml(fs.readFileSync(file, "utf8"));
-  } catch (error) {
-    const detail = error instanceof Error ? error.message : "无法解析";
-    throw new BookshelfConfigError("invalid-root", `content/bookshelf.yaml 无法解析：${detail}`);
-  }
-  const config = parseBookshelfConfig(parsed);
-  const sources = preparedPosts
-    ? preparedPosts.map((post) => ({
-      path: post.path,
-      title: post.title,
-      description: post.description,
-      cover: post.cover,
-      date: typeof post.date === "string" ? post.date : undefined,
-      content: post.content,
-    }))
-    : readReferencedPosts(root, config);
-  return bookshelfMountFromFile(config, sources);
-}
-
-function referencedPostPaths(book) {
-  if (Array.isArray(book.posts) && book.posts.length > 0) {
-    return book.posts
-      .map((entry) => (typeof entry === "string" ? entry : entry?.path))
-      .filter((path) => typeof path === "string" && path.trim());
-  }
-  return book.post ? [book.post] : [];
-}
-
-function readReferencedPosts(root, config) {
-  const seen = new Set();
-  const posts = [];
-  for (const shelf of config.shelves) {
-    for (const book of shelf.books) {
-      for (const entry of referencedPostPaths(book)) {
-        const relative = normalizeBookshelfPostPath(entry);
-        if (seen.has(relative)) continue;
-        seen.add(relative);
-        posts.push(readPost(root, relative));
-      }
-    }
-  }
-  return posts;
-}
-
-function readPost(root, postPath) {
-  const relative = normalizeBookshelfPostPath(postPath);
-  const postsRoot = path.resolve(root, "content", "posts");
-  const file = `${path.resolve(postsRoot, ...relative.split("/"))}.md`;
-  if (!file.startsWith(`${postsRoot}${path.sep}`)) {
-    throw new BookshelfConfigError("post", `post「${postPath}」必须是 content/posts 下的路径，不带 .md。`);
-  }
-  if (!fs.existsSync(file)) {
-    throw new BookshelfConfigError("post", `content/bookshelf.yaml 引用的博文 ${relative} 不存在。`);
-  }
-  let parsed;
-  try {
-    parsed = matter(fs.readFileSync(file, "utf8"), {
-      engines: {
-        yaml: {
-          parse: (input) => parseYaml(input) ?? {},
-        },
-      },
-    });
-  } catch (error) {
-    const detail = error instanceof Error ? error.message : "无法解析";
-    throw new BookshelfConfigError("post", `博文 ${relative} 无法解析：${detail}`);
-  }
-  const data = parsed.data && typeof parsed.data === "object" ? parsed.data : {};
-  return {
-    path: relative,
-    title: optionalString(data.title),
-    description: optionalString(data.description),
-    cover: optionalString(data.cover),
-    date: optionalDate(data.date),
-    content: parsed.content,
-  };
-}
-
-function optionalString(value) {
-  if (typeof value !== "string") return undefined;
-  const trimmed = value.trim();
-  return trimmed ? trimmed : undefined;
-}
-
-function optionalDate(value) {
-  if (value instanceof Date && !Number.isNaN(value.getTime())) return value.toISOString();
-  return optionalString(value);
-}

package/app/bookshelf/load.ts

@@ -1,16 +0,0 @@
-import type { BookshelfMount } from "../components/bookshelf/catalog";
-import { bookshelfConfigPath as configPath, loadBookshelf as readShelf } from "./load.mjs";
-
-export type { BookshelfMount };
-
-export function bookshelfConfigPath(root?: string) {
-  return configPath(root) as string;
-}
-
-/**
- * The site shelf, or null when `content/bookshelf.yaml` is absent.
- * Absent means the package demo. See `load.mjs` for the file contract.
- */
-export function loadBookshelf(root?: string): BookshelfMount | null {
-  return readShelf(root) as BookshelfMount | null;
-}

package/app/bookshelf/page.tsx

@@ -1,52 +0,0 @@
-import type { Metadata } from "next";
-import { bookshelf } from "@garden/bookshelf";
-import { Bookshelf } from "../components/bookshelf";
-import { siteLang } from "../lib/i18n";
-import { pageAlternates } from "../lib/page-alternates";
-import { siteConfig } from "../site.config";
-
-/**
- * `/bookshelf` contract:
- * - `content/bookshelf.yaml` present → that shelf, with each `post` rendered
- *   into `notes`, inside the site header. Indexed like the other pages.
- * - file absent → package demo (Chinese click-test only, noindex, no site chrome).
- *   English builds skip the demo so a locale=en site stays free of that markup.
- */
-export async function generateMetadata(): Promise<Metadata> {
-  const shelf = bookshelf;
-  if (shelf) {
-    return {
-      title: shelf.title,
-      description: shelf.description,
-      alternates: pageAlternates("/bookshelf"),
-    };
-  }
-  if (siteLang === "zh") {
-    return { title: { absolute: "花园 · 读书笔记" }, robots: { index: false, follow: false } };
-  }
-  return { title: "Bookshelf", robots: { index: false, follow: false } };
-}
-
-export default function BookshelfPage() {
-  const shelf = bookshelf;
-  if (shelf) {
-    return (
-      <main className="sh-main bookshelf-page" id="content">
-        <header className="sh-head">
-          {shelf.eyebrow ? <p className="sh-kicker">{shelf.eyebrow}</p> : null}
-          <h1 id="sh-title">{shelf.title}</h1>
-          {shelf.description ? <p className="sh-deck">{shelf.description}</p> : null}
-        </header>
-        <Bookshelf
-          embedded
-          catalog={shelf.catalog}
-          notes={shelf.notes}
-          title={shelf.title}
-          eyebrow={shelf.eyebrow ?? siteConfig.name}
-        />
-      </main>
-    );
-  }
-  if (siteLang !== "zh") return null;
-  return <Bookshelf />;
-}

package/app/components/bookshelf/BookHub.tsx

@@ -1,142 +0,0 @@
-import Link from "next/link";
-import { siteHref } from "../../lib/site-href";
-import { ui } from "../../lib/i18n";
-import type { BookshelfBook, BookshelfBookPost, BookshelfNoteKind, BookshelfSource } from "./types";
-
-function day(value: string) {
-  const date = new Date(value);
-  if (Number.isNaN(date.getTime())) return value.slice(0, 10);
-  return new Intl.DateTimeFormat("en-CA", {
-    timeZone: "Asia/Shanghai",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-  }).format(date);
-}
-
-function kindLabel(kind: BookshelfNoteKind | undefined) {
-  const t = ui();
-  switch (kind) {
-    case "overview":
-      return t.bookHubOverview;
-    case "excerpt":
-      return t.bookHubExcerpt;
-    case undefined:
-      return "";
-    default: {
-      const unexpected: never = kind;
-      return unexpected;
-    }
-  }
-}
-
-function sourceHref(href: string) {
-  if (href.startsWith("/") && !href.startsWith("//")) return siteHref(href);
-  return href;
-}
-
-function isExternal(href: string) {
-  return /^(?:https?:)?\/\//iu.test(href);
-}
-
-/** Hub chips are Douban and PDF. The Chinese label is the zh shelf; English sites write Douban. */
-function isDoubanChip(label: string) {
-  return label === "豆瓣" || /^douban$/iu.test(label);
-}
-
-function hubSources(sources: readonly BookshelfSource[] | undefined) {
-  const list = sources ?? [];
-  const douban = list.filter((source) => isDoubanChip(source.label));
-  const pdf = list.filter((source) => /pdf/iu.test(source.label));
-  return [...douban, ...pdf];
-}
-
-function NoteCard({ entry }: { entry: BookshelfBookPost }) {
-  const t = ui();
-  const label = kindLabel(entry.kind);
-  const href = entry.href ?? siteHref(`/blog/${entry.path}`);
-  const when = entry.date ? day(entry.date) : "";
-  const count = entry.words ? t.wordCount(entry.words) : "";
-  return (
-    <Link className="book-hub-note" href={href}>
-      {label ? <p className="book-hub-note-label">{label}</p> : null}
-      <h3>{entry.title}</h3>
-      {entry.summary ? <p className="book-hub-note-sum">{entry.summary}</p> : null}
-      {when || count ? (
-        <p className="book-hub-note-meta">
-          {when}
-          {when && count ? " · " : null}
-          {count}
-        </p>
-      ) : null}
-    </Link>
-  );
-}
-
-function SourceChips({ sources }: { sources: readonly BookshelfSource[] }) {
-  const shown = hubSources(sources);
-  if (!shown.length) return null;
-  const t = ui();
-  return (
-    <div className="book-hub-sources">
-      {shown.map((source) => {
-        const href = sourceHref(source.href);
-        const external = isExternal(source.href);
-        const pdf = /pdf/iu.test(source.label);
-        return (
-          <span className="book-hub-source" key={`${source.label}\u0000${source.href}`}>
-            <a
-              className="book-hub-chip"
-              href={href}
-              {...(external ? { target: "_blank", rel: "noopener noreferrer" } : {})}
-            >
-              {source.label}
-              <span className="ext" aria-hidden="true">↗</span>
-            </a>
-            {pdf ? <span className="book-hub-source-note">{t.bookHubPdfNote}</span> : null}
-          </span>
-        );
-      })}
-    </div>
-  );
-}
-
-/** Book hub (本书). Multi-note volumes land here; a note card is a plain article link. */
-export function BookHub({ shelfTitle, book }: { shelfTitle: string; book: BookshelfBook }) {
-  const t = ui();
-  const jacket = typeof book.cover === "string" ? book.cover : "";
-  const posts = book.posts ?? [];
-  return (
-    <main className="sh-main book-hub" id="content">
-      <p className="book-hub-crumb">
-        <Link href={siteHref("/columns")}>{t.homeColumns}</Link>
-        <span aria-hidden="true"> · </span>
-        <Link href={siteHref("/bookshelf")}>{shelfTitle}</Link>
-        <span aria-hidden="true"> · </span>
-        <span aria-current="page">{t.bookHubCurrent}</span>
-      </p>
-
-      <section className="book-hub-card" aria-labelledby="book-hub-title">
-        {jacket ? (
-          <div className="book-hub-cover">
-            <img src={jacket} alt={t.coverLabel(book.title)} width={148} />
-          </div>
-        ) : null}
-        <div className="book-hub-meta">
-          <h1 id="book-hub-title">{book.title}</h1>
-          {book.author ? <p className="book-hub-author">{book.author}</p> : null}
-          <SourceChips sources={book.sources ?? []} />
-        </div>
-      </section>
-
-      <h2 className="book-hub-notes-head">{t.bookHubNotes}</h2>
-      <ul className="book-hub-notes">
-        {posts.map((entry) => (
-          <li key={entry.path}>
-            <NoteCard entry={entry} />
-          </li>
-        ))}
-      </ul>
-    </main>
-  );
-}

package/app/components/bookshelf/Bookshelf.tsx

@@ -1,128 +0,0 @@
-"use client";
-
-import { useLayoutEffect, useRef } from "react";
-import { siteHref } from "../../lib/site-href";
-import { mountBookshelf } from "./engine";
-import type { BookshelfProps, BookshelfShelf } from "./types";
-import "./bookshelf.css";
-
-const SHELF_SCROLL_KEY = "garden-bookshelf-scroll";
-
-function withNoteLinks(catalog: BookshelfShelf[] | undefined) {
-  if (!catalog) return catalog;
-  return catalog.map((row) => ({
-    ...row,
-    books: row.books.map((book) => {
-      const posts = book.posts?.map((entry) => ({
-        ...entry,
-        href: siteHref(`/blog/${entry.path}`),
-      }));
-      const hub = book.hub ? siteHref(book.hub) : undefined;
-      if (!book.post && !posts?.length && !hub) return book;
-      return {
-        ...book,
-        ...(book.post ? { href: siteHref(`/blog/${book.post}`) } : {}),
-        ...(posts?.length ? { posts } : {}),
-        ...(hub ? { hub } : {}),
-      };
-    }),
-  }));
-}
-
-function readSavedScroll() {
-  try {
-    const raw = sessionStorage.getItem(SHELF_SCROLL_KEY);
-    if (raw == null) return null;
-    sessionStorage.removeItem(SHELF_SCROLL_KEY);
-    const y = Number(raw);
-    return Number.isFinite(y) ? y : null;
-  } catch {
-    return null;
-  }
-}
-
-const DEMO_BRAND = "花园 · 读书笔记";
-const DEMO_TITLE = "读书笔记";
-
-function escapeHtml(value: string) {
-  return value
-    .replaceAll("&", "&")
-    .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;")
-    .replaceAll('"', "&quot;");
-}
-
-function shelfShell(brand: string, title: string) {
-  return `
-    <div class="shelf-view" id="shelfView">
-      <div class="page">
-        <header class="top">
-          <div class="brand">${escapeHtml(brand)}</div>
-          <h1>${escapeHtml(title)}</h1>
-          <p class="lede is-debug" id="lede" hidden>调试说明：页级疏密；悬停/点按展一本；再点进笔记。</p>
-          <div class="qa-bar is-debug" id="qaBar" role="group" aria-label="演示控制" hidden>
-            <span class="qa-label">页级态</span>
-            <button type="button" class="qa-btn" data-mode="auto" id="modeAuto">自动</button>
-            <button type="button" class="qa-btn" data-mode="covers" id="modeCovers">A 全封面</button>
-            <button type="button" class="qa-btn" data-mode="spines" id="modeSpines">B 全立脊</button>
-            <span class="qa-hint" id="modeHint"></span>
-          </div>
-        </header>
-        <main id="bays"></main>
-        <footer class="foot is-debug" id="footBar" hidden>
-          <span>交互 demo · 抽→翻→笔记 · 对称返回</span>
-          <span id="footMode">—</span>
-        </footer>
-      </div>
-    </div>
-
-    <div class="note-view" id="noteView" hidden>
-      <article class="note">
-        <button type="button" class="back-btn" id="backBtn">← 返回书架</button>
-        <div class="note-hero">
-          <div class="note-cover" id="noteCover"></div>
-          <div class="note-meta">
-            <p class="note-cat" id="noteCat"></p>
-            <h1 id="noteTitle"></h1>
-            <p class="note-author" id="noteAuthor"></p>
-            <a class="note-read" id="noteRead" hidden>阅读全文</a>
-          </div>
-        </div>
-        <div class="note-body" id="noteBody"></div>
-      </article>
-    </div>
-
-    <div class="open-backdrop" id="openBackdrop" aria-hidden="true"></div>
-    <div class="open-veil" id="openVeil" aria-hidden="true">
-      <div class="open-veil-blob" id="openVeilBlob"></div>
-    </div>
-    <div class="stage" id="stage" aria-hidden="true"></div>
-`;
-}
-
-/** Approved bookshelf. Pass `catalog` and `notes` for a site shelf; omit them for the package demo. */
-export function Bookshelf({ catalog, notes, title, eyebrow, embedded = false }: BookshelfProps) {
-  const ref = useRef<HTMLDivElement>(null);
-  useLayoutEffect(() => {
-    const root = ref.current;
-    if (!root) return;
-    const saved = embedded ? readSavedScroll() : null;
-    const applyScroll = () => {
-      if (saved != null) window.scrollTo(0, saved);
-    };
-    applyScroll();
-    const unmount = mountBookshelf(root, { catalog: withNoteLinks(catalog), notes });
-    const frame = window.requestAnimationFrame(applyScroll);
-    return () => {
-      window.cancelAnimationFrame(frame);
-      unmount?.();
-    };
-  }, [catalog, notes, title, eyebrow, embedded]);
-  return (
-    <div
-      className={embedded ? "bookshelf-demo is-site" : "bookshelf-demo"}
-      ref={ref}
-      dangerouslySetInnerHTML={{ __html: shelfShell(eyebrow || DEMO_BRAND, title || DEMO_TITLE) }}
-    />
-  );
-}