hd-garden 0.5.17 → 0.6.0

package/app/a2/[slug]/page.tsx

@@ -8,9 +8,10 @@ import { a2WordCounts } from "@garden/generated-content";
 import { demoDateLabel, demoDateTime } from "../../lib/a2-meta";
 import { extractHeadings } from "../../lib/content";
 import { a2Slugs, readA2Article } from "../../lib/a2-preview";
+import { isStaticPlaceholder, STATIC_PLACEHOLDER, staticParams } from "../../../ui/garden/static-params.mjs";
 
 export function generateStaticParams() {
-  return a2Slugs().map((slug) => ({ slug }));
+  return staticParams(a2Slugs().map((slug) => ({ slug })), { slug: STATIC_PLACEHOLDER });
 }
 
 export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }): Promise<Metadata> {
@@ -23,7 +24,10 @@ export async function generateMetadata({ params }: { params: Promise<{ slug: str
 export default async function A2ArticlePage({ params }: { params: Promise<{ slug: string }> }) {
   const { slug } = await params;
   const article = readA2Article(slug);
-  if (!article) notFound();
+  if (!article) {
+    if (isStaticPlaceholder(slug)) return null;
+    notFound();
+  }
   const headings = extractHeadings(article.content);
   const wordCount = a2WordCounts[slug] ?? 0;
   return (

package/app/admin/preview/[...path]/page.tsx

@@ -7,6 +7,8 @@ import { AdminUiShell, isStaticExport, requireAdminPage, StaticAdminNotice } fro
 import { MarkdownArticle } from "../../../components/MarkdownArticle";
 import { repositoryContentPath } from "../../../lib/repository-path.mjs";
 import { readMarkdown, readText } from "../../../lib/ui-content";
+import { formatInlineLink, replaceInlineLinks } from "../../../../ui/garden/markdown-destination.mjs";
+import { STATIC_PLACEHOLDER, staticParams } from "../../../../ui/garden/static-params.mjs";
 
 export const dynamic = process.env.STATIC_EXPORT === "1" ? "force-static" : "force-dynamic";
 export const dynamicParams = false;
@@ -14,7 +16,7 @@ export const metadata = { title: "草稿预览", robots: { index: false, follow:
 
 /** Draft preview is served by the admin worker. The public static export has no paths here. */
 export function generateStaticParams() {
-  return [];
+  return staticParams([], { path: [STATIC_PLACEHOLDER] });
 }
 
 const isRelative = (value: string) => !/^(?:[a-z][a-z0-9+.-]*:|\/|#)/iu.test(value);
@@ -22,8 +24,8 @@ const isRelative = (value: string) => !/^(?:[a-z][a-z0-9+.-]*:|\/|#)/iu.test(val
 /** Same-name-directory files go through the authenticated, sandboxed proxy. */
 function proxyAssets(content: string, post: string) {
   const proxy = (relative: string) => `/api/admin/preview/asset?post=${encodeURIComponent(post)}&path=${encodeURIComponent(relative)}`;
-  let output = content.replace(/(!\[[^\]]*\]\()<?([^)\s>]+)>?/gu, (match, prefix: string, src: string) =>
-    isRelative(src) ? `${prefix}${proxy(src)}` : match,
+  let output = replaceInlineLinks(content, (link) =>
+    link.image && isRelative(link.url) ? formatInlineLink(link, proxy(link.url)) : undefined,
   );
   for (const fence of [...scanFences(output)].reverse()) {
     if (fence.lang !== "widget") continue;

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

@@ -25,9 +25,10 @@ import {
   webmentionApiEndpoint,
 } from "../../lib/site";
 import { githubUrl, siteConfig } from "../../site.config";
+import { isStaticPlaceholder, STATIC_PLACEHOLDER, staticParams } from "../../../ui/garden/static-params.mjs";
 
 export function generateStaticParams() {
-  return posts.map((post) => ({ path: post.path.split("/") }));
+  return staticParams(posts.map((post) => ({ path: post.path.split("/") })), { path: [STATIC_PLACEHOLDER] });
 }
 
 export async function generateMetadata({
@@ -72,7 +73,10 @@ export default async function PostPage({
 }) {
   const { path } = await params;
   const post = findPost(path.join("/"));
-  if (!post) notFound();
+  if (!post) {
+    if (isStaticPlaceholder(path)) return null;
+    notFound();
+  }
   const headings = extractHeadings(post.content);
   const baseUrl = await getSiteUrl();
   const pathname = postHref(post);

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

@@ -27,12 +27,16 @@ import {
 } from "../../../lib/site";
 import { githubUrl, siteConfig } from "../../../site.config";
 import { siteHref } from "../../../lib/site-href";
+import { isStaticPlaceholder, STATIC_PLACEHOLDER, staticParams } from "../../../../ui/garden/static-params.mjs";
 
 export function generateStaticParams() {
-  return columns.map((entry) => ({
-    column: entry.column,
-    path: columnEntryPath(entry).split("/"),
-  }));
+  return staticParams(
+    columns.map((entry) => ({
+      column: entry.column,
+      path: columnEntryPath(entry).split("/"),
+    })),
+    { column: STATIC_PLACEHOLDER, path: [STATIC_PLACEHOLDER] },
+  );
 }
 
 export async function generateMetadata({
@@ -77,7 +81,10 @@ export default async function ColumnEntryPage({
 }) {
   const { column, path } = await params;
   const entry = findColumnEntry(column, path.join("/"));
-  if (!entry) notFound();
+  if (!entry) {
+    if (isStaticPlaceholder(column)) return null;
+    notFound();
+  }
   const series = columns.filter((item) => item.column === column);
   const listed = [...series].sort((left, right) => Date.parse(right.date) - Date.parse(left.date));
   const currentIndex = series.findIndex((item) => item.path === entry.path);

package/app/layout.tsx

@@ -12,7 +12,6 @@ import {
 } from "./lib/site";
 import { githubUrl, siteConfig } from "./site.config";
 import { brand } from "@garden/site-config";
-import { HASH_JUMP_SCRIPT } from "../ui/garden/hash-jump.mjs";
 import { FEED_ALTERNATES } from "./lib/page-alternates";
 
 export async function generateMetadata(): Promise<Metadata> {
@@ -84,8 +83,6 @@ export default function RootLayout({
               '(function(){try{var t=localStorage.getItem("theme");var d=t==="dark"||(!t&&matchMedia("(prefers-color-scheme: dark)").matches);document.documentElement.dataset.theme=d?"dark":"light";}catch(e){}})();',
           }}
         />
-        {/* Before the router's scripts: keeps #links in a post from refetching the page (ui/garden/hash-jump.mjs). */}
-        <script dangerouslySetInnerHTML={{ __html: HASH_JUMP_SCRIPT }} />
         {mentionEndpoint && <link rel="webmention" href={mentionEndpoint} />}
         {analyticsDomain && (
           <script

package/app/styles/a2.css

@@ -466,7 +466,7 @@ html[data-theme="dark"] .markdown-body a.ext {
 html[data-theme="dark"] .markdown-body img.fav {
   padding: 1px;
   box-sizing: border-box;
-  background: #f5f4ed;
+  background: var(--image-backing);
 }
 
 .markdown-body .table-wrap a.ext img.fav,
@@ -685,6 +685,18 @@ html[data-theme="dark"] .markdown-body .markdown-alert code {
   height: auto;
 }
 
+/* Dark mode: article images sit on the light paper colour, so a transparent
+   image (black lines on nothing, like most SVG diagrams) stays legible and an
+   opaque one looks the same. The backing is the image's own background, so it
+   takes the image's own corner radius; no padding, no filters. Favicons, link
+   card thumbnails, covers, avatars and the logo are not article images. */
+html[data-theme="dark"] .markdown-image-trigger img,
+html[data-theme="dark"] .markdown-image-lightbox-content img,
+html[data-theme="dark"] .markdown-body > img,
+html[data-theme="dark"] .markdown-body > p > img:not([class]) {
+  background: var(--image-backing);
+}
+
 .markdown-body .fig {
   margin: 36px 0;
 }

package/app/styles/tokens.css

@@ -61,6 +61,9 @@
 
 :root[data-theme="dark"],
 html[data-theme="dark"] {
+  /* Light backing under article images and link icons, so dark-on-transparent
+     artwork stays legible. */
+  --image-backing: #faf9f5;
   --paper: #1f1e1d;
   --paper-deep: #262624;
   --card: #262624;

package/app/thoughts/[slug]/page.tsx

@@ -14,9 +14,10 @@ import {
   webmentionApiEndpoint,
 } from "../../lib/site";
 import { siteHref } from "../../lib/site-href";
+import { isStaticPlaceholder, STATIC_PLACEHOLDER, staticParams } from "../../../ui/garden/static-params.mjs";
 
 export function generateStaticParams() {
-  return thoughts.map((thought) => ({ slug: thought.slug }));
+  return staticParams(thoughts.map((thought) => ({ slug: thought.slug })), { slug: STATIC_PLACEHOLDER });
 }
 
 export async function generateMetadata({
@@ -60,7 +61,10 @@ export default async function ThoughtPage({
 }) {
   const { slug } = await params;
   const thought = findPublishedThought(slug);
-  if (!thought) notFound();
+  if (!thought) {
+    if (isStaticPlaceholder(slug)) return null;
+    notFound();
+  }
   const baseUrl = await getSiteUrl();
   const pathname = siteHref(`/thoughts/${slug}`);
 

package/bin/garden.mjs

@@ -391,8 +391,14 @@ switch (command) {
     // Sizes of remote files in garden file blocks; failures fall back to file-sizes.json.
     if (process.env.GARDEN_OFFLINE !== "1") runNode("scripts/file-sizes.mjs");
     runVinext(["build", ...rest], { copyDist: true });
+    // /favicon.ico from the site's own icon (brand.favicon).
+    runNode("scripts/favicon-ico.mjs");
     // Pages for old addresses listed under redirects in site.config.yaml (static export only).
-    if (process.env.STATIC_EXPORT === "1") runNode("scripts/redirects.mjs");
+    if (process.env.STATIC_EXPORT === "1") {
+      // What the export wrote for empty dynamic routes (ui/garden/static-params.mjs).
+      runNode("scripts/static-placeholders.mjs");
+      runNode("scripts/redirects.mjs");
+    }
     break;
   case "links":
     runNode("scripts/link-assets.mjs");

package/next.config.ts

@@ -10,6 +10,11 @@ const nextConfig: NextConfig = {
     : {}),
   // Always on in a static export; a server build opts in with TRAILING_SLASH=1. Links follow it (siteHref).
   trailingSlash: trailingSlashEnabled(process.env),
+  // vinext 1.x, like Next.js, streams page metadata after the document shell to
+  // clients that run JavaScript: title, canonical, RSS and robots would sit at the
+  // end of <body> until a script moves them. Treating every user agent as
+  // HTML-limited keeps them in <head> for everyone, as with vinext 0.0.x.
+  htmlLimitedBots: /.*/,
 };
 
 export default nextConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.5.17",
+  "version": "0.6.0",
   "private": false,
   "description": "用 Markdown 写作、用 GitHub Pages 发布的个人博客引擎。",
   "license": "MIT",
@@ -77,7 +77,7 @@
     "@phosphor-icons/react": "^2.1.10",
     "@tailwindcss/postcss": "4.3.3",
     "@vitejs/plugin-react": "6.1.2",
-    "@vitejs/plugin-rsc": "0.5.30",
+    "@vitejs/plugin-rsc": "0.5.38",
     "acorn": "^8.19.0",
     "fuse.js": "^7.5.0",
     "github-slugger": "^2.0.0",
@@ -93,10 +93,10 @@
     "micromark-extension-mdx-expression": "^3.0.1",
     "micromark-extension-mdx-jsx": "^3.0.2",
     "next": "16.3.0",
-    "react": "19.3.0",
-    "react-dom": "19.3.0",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
     "react-markdown": "^10.1.0",
-    "react-server-dom-webpack": "19.3.0",
+    "react-server-dom-webpack": "19.3.1",
     "rehype-highlight": "^7.0.2",
     "rehype-katex": "^7.0.1",
     "rehype-raw": "^7.0.0",
@@ -108,11 +108,12 @@
     "remark-math": "^6.0.0",
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
+    "sharp": "^0.34.5",
     "tailwindcss": "4.2.1",
     "typescript": "5.9.3",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0",
-    "vinext": "0.0.50",
+    "vinext": "1.2.1",
     "vite": "8.0.13",
     "wrangler": "4.116.0",
     "yaml": "^2.9.0"

package/scripts/build-content.mjs

@@ -10,6 +10,7 @@ import { countDemoWords } from "../ui/garden/word-count.mjs";
 import { referenceDomain } from "../ui/garden/references.mjs";
 import { linkAssetsForRender } from "./link-assets.mjs";
 import { cardUrls } from "../ui/garden/markdown-links.mjs";
+import { formatInlineLink, replaceInlineLinks } from "../ui/garden/markdown-destination.mjs";
 import { configuredSiteAddress, sameSiteMatcher } from "../ui/garden/same-site.mjs";
 import { resolveBrand } from "./brand.mjs";
 import { imageSources, readImageCache, sizeFromBytes } from "./image-sizes.mjs";
@@ -173,10 +174,10 @@ function copyLocalAsset(value, markdownPath, sourcePath, options = {}) {
 }
 
 function rewriteMarkdownAssets(content, markdownPath, sourcePath) {
-  const markdownImages = content.replace(
-    /(!\[[^\]]*\]\()<?([^)\s>]+)>?((?:\s+["'][^"']*["'])?\))/gu,
-    (_, prefix, src, suffix) =>
-      `${prefix}${copyLocalAsset(src, markdownPath, sourcePath)}${suffix}`,
+  // `![alt](<a b (1).png>)` keeps its angle brackets: without them the space
+  // and the parentheses would no longer be one destination.
+  const markdownImages = replaceInlineLinks(content, (link) =>
+    link.image ? formatInlineLink(link, copyLocalAsset(link.url, markdownPath, sourcePath)) : undefined,
   );
 
   return markdownImages.replace(

package/scripts/check-post.mjs

@@ -7,6 +7,7 @@ import { gardenSiteRoot } from "./garden-paths.mjs";
 import { checkUiBlock } from "../ui/core/validate.mjs";
 import { checkGardenMarkdown } from "../ui/garden/check.mjs";
 import { checkFileSources } from "../ui/garden/file-paths.mjs";
+import { inlineLinkParts, inlineLinkPattern } from "../ui/garden/markdown-destination.mjs";
 
 const siteRoot = gardenSiteRoot();
 const calloutTypes = new Set([
@@ -247,8 +248,9 @@ const scanBody = (errors, content, markdownPath, sourcePath, { warnings = [], dr
       error(errors, "callout-type", lineNumber, `${sourcePath}: 不支持的警告框类型 ${callout[1]}`);
     }
 
-    for (const image of line.matchAll(/!\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/gu)) {
-      assertLocalFile(errors, image[2], path.dirname(markdownPath), sourcePath, lineNumber, "图片");
+    for (const match of line.matchAll(inlineLinkPattern())) {
+      const image = inlineLinkParts(match);
+      if (image.image) assertLocalFile(errors, image.url, path.dirname(markdownPath), sourcePath, lineNumber, "图片");
     }
   });
 

package/scripts/favicon-ico.mjs

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * /favicon.ico for browsers, feed readers and crawlers that ask for it
+ * regardless of <link rel="icon">. Made from the site's own icon (`brand.favicon`
+ * in site.config.yaml, Garden's favicon.svg when unset): 16, 32 and 48 px PNG
+ * images in one ICO file. Runs after the build, into dist/client.
+ *
+ * A favicon.ico the site already has in public/ is left alone. An icon given
+ * as a full URL, or a file that is missing or cannot be read, only prints a
+ * warning: the page itself still names its icon.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { parse as parseYaml } from "yaml";
+import { resolveBrand } from "./brand.mjs";
+
+export const ICO_SIZES = [16, 32, 48];
+
+/** An ICO file holding one PNG image per size (Windows Vista and every current browser read PNG entries). */
+export function icoFromPngs(images) {
+  const header = Buffer.alloc(6);
+  header.writeUInt16LE(0, 0);
+  header.writeUInt16LE(1, 2);
+  header.writeUInt16LE(images.length, 4);
+  const entries = [];
+  let offset = 6 + 16 * images.length;
+  for (const { size, png } of images) {
+    const entry = Buffer.alloc(16);
+    entry.writeUInt8(size >= 256 ? 0 : size, 0);
+    entry.writeUInt8(size >= 256 ? 0 : size, 1);
+    entry.writeUInt8(0, 2);
+    entry.writeUInt8(0, 3);
+    entry.writeUInt16LE(1, 4);
+    entry.writeUInt16LE(32, 6);
+    entry.writeUInt32LE(png.length, 8);
+    entry.writeUInt32LE(offset, 12);
+    offset += png.length;
+    entries.push(entry);
+  }
+  return Buffer.concat([header, ...entries, ...images.map((image) => image.png)]);
+}
+
+/** The icon file behind a brand.favicon URL: public/ first, then what the build copied. Null for remote icons. */
+export function faviconSource(siteRoot, outDir, faviconUrl, basePath = "") {
+  if (/^(?:[a-z]+:)?\/\//iu.test(faviconUrl) || faviconUrl.startsWith("data:")) return null;
+  let local = faviconUrl.split(/[?#]/u)[0];
+  if (basePath && local.startsWith(`${basePath}/`)) local = local.slice(basePath.length);
+  local = decodeURIComponent(local).replace(/^\/+/u, "");
+  for (const root of [path.join(siteRoot, "public"), outDir]) {
+    const file = path.resolve(root, local);
+    if (file.startsWith(path.resolve(root) + path.sep) && fs.existsSync(file) && fs.statSync(file).isFile()) return file;
+  }
+  return "";
+}
+
+/** Writes outDir/favicon.ico from the source icon. Returns what happened, for the log and the tests. */
+export async function writeFaviconIco({ source, outDir, siteRoot }) {
+  const target = path.join(outDir, "favicon.ico");
+  if (siteRoot && fs.existsSync(path.join(siteRoot, "public", "favicon.ico"))) return { status: "kept", target };
+  if (/\.ico$/iu.test(source)) {
+    fs.copyFileSync(source, target);
+    return { status: "copied", target };
+  }
+  const { default: sharp } = await import("sharp");
+  const input = fs.readFileSync(source);
+  const images = [];
+  for (const size of ICO_SIZES) {
+    // SVG is rasterised at the target size, not scaled down from a bitmap.
+    const density = /\.svg$/iu.test(source) ? Math.max(72, Math.ceil((72 * size) / 16)) : undefined;
+    const png = await sharp(input, density ? { density } : {})
+      .resize(size, size, { fit: "contain", background: { r: 0, g: 0, b: 0, alpha: 0 } })
+      .png()
+      .toBuffer();
+    images.push({ size, png });
+  }
+  fs.writeFileSync(target, icoFromPngs(images));
+  return { status: "written", target, sizes: ICO_SIZES };
+}
+
+export async function runFaviconStep({ siteRoot, env = process.env, out = process.stdout }) {
+  const outDir = path.join(siteRoot, "dist", "client");
+  const warn = (line) => out.write(`警告：${line}\n`);
+  if (!fs.existsSync(outDir)) {
+    warn(`找不到构建产物 ${path.relative(siteRoot, outDir)}，没有生成 favicon.ico。`);
+    return 0;
+  }
+  const configFile = path.join(siteRoot, "site.config.yaml");
+  const config = fs.existsSync(configFile) ? parseYaml(fs.readFileSync(configFile, "utf8")) ?? {} : {};
+  const basePath = (env.NEXT_PUBLIC_BASE_PATH ?? "").replace(/\/+$/u, "");
+  const { favicon } = resolveBrand(siteRoot, config, basePath);
+  const source = faviconSource(siteRoot, outDir, favicon, basePath);
+  if (source === null) {
+    warn(`brand.favicon 是外部地址 ${favicon}，没有生成 favicon.ico。`);
+    return 0;
+  }
+  if (!source) {
+    warn(`找不到图标文件 ${favicon}，没有生成 favicon.ico。`);
+    return 0;
+  }
+  try {
+    const result = await writeFaviconIco({ source, outDir, siteRoot });
+    if (result.status === "kept") out.write("favicon.ico：使用 public/favicon.ico。\n");
+    else out.write(`favicon.ico：由 ${path.relative(siteRoot, source)} 生成${result.sizes ? `（${result.sizes.join("、")} px）` : ""}。\n`);
+  } catch (error) {
+    warn(`favicon.ico 生成失败（${error.message}），页面仍使用 ${favicon}。`);
+  }
+  return 0;
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const siteRoot = process.env.GARDEN_SITE ? path.resolve(process.env.GARDEN_SITE) : process.cwd();
+  process.exitCode = await runFaviconStep({ siteRoot });
+}

package/scripts/prepare-pages-output.mjs

@@ -2,6 +2,7 @@ import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
+import { STATIC_PLACEHOLDER } from "../ui/garden/static-params.mjs";
 
 const forbiddenDirectoryNames = new Set([
   ".git",
@@ -55,6 +56,7 @@ async function inspectTree(root, directory = root) {
       fail(`不允许源码目录：${relativePath}`);
     }
     if (entry.name.startsWith(".env")) fail(`不允许环境文件：${relativePath}`);
+    if (entry.name.startsWith(STATIC_PLACEHOLDER)) fail(`空动态路由的占位页没有删掉：${relativePath}`);
     if (/^package(?:-lock)?\.json$/u.test(entry.name)) {
       fail(`不允许依赖清单：${relativePath}`);
     }
@@ -106,7 +108,8 @@ async function stabilizeDeploymentVersion(root) {
   for (const file of await listFiles(root)) {
     const original = await fs.readFile(file.absolutePath);
     let normalized = original;
-    if ([".html", ".rsc"].includes(path.extname(file.relativePath))) {
+    // Flight payloads: .rsc from vinext 0.0.x, index.txt / <page>.txt from vinext 1.x static export.
+    if ([".html", ".rsc", ".txt"].includes(path.extname(file.relativePath))) {
       const text = original.toString("utf8");
       normalized = Buffer.from(
         normalizeDeploymentVersion(text, deploymentVersionPlaceholder),

package/scripts/static-placeholders.mjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/**
+ * Deletes what the static export wrote for STATIC_PLACEHOLDER (see
+ * ui/garden/static-params.mjs): the directory or file of every path segment
+ * named after it. Runs after the build, on dist/client.
+ *
+ * Also deletes 404/index.html when it is a copy of 404.html: with trailingSlash
+ * vinext writes both, and on a static host the copy makes /404/ answer 200.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { STATIC_PLACEHOLDER } from "../ui/garden/static-params.mjs";
+
+/** Removes placeholder output under root and returns the removed paths, relative to root. */
+export function removeStaticPlaceholders(root) {
+  const removed = [];
+  const visit = (directory) => {
+    if (!fs.existsSync(directory)) return;
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+      const absolute = path.join(directory, entry.name);
+      if (entry.name === STATIC_PLACEHOLDER || entry.name.startsWith(`${STATIC_PLACEHOLDER}.`)) {
+        fs.rmSync(absolute, { recursive: true, force: true });
+        removed.push(path.relative(root, absolute).split(path.sep).join("/"));
+      } else if (entry.isDirectory()) {
+        visit(absolute);
+      }
+    }
+  };
+  visit(root);
+  return removed.sort();
+}
+
+/** Deletes 404/index.html (and the then empty 404/) when it is byte-for-byte 404.html. Returns whether it did. */
+export function removeNotFoundCopy(root) {
+  const page = path.join(root, "404.html");
+  const copy = path.join(root, "404", "index.html");
+  if (!fs.existsSync(page) || !fs.existsSync(copy) || !fs.readFileSync(page).equals(fs.readFileSync(copy))) return false;
+  fs.rmSync(copy);
+  if (!fs.readdirSync(path.dirname(copy)).length) fs.rmdirSync(path.dirname(copy));
+  return true;
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const siteRoot = process.env.GARDEN_SITE ? path.resolve(process.env.GARDEN_SITE) : process.cwd();
+  removeStaticPlaceholders(path.join(siteRoot, "dist", "client"));
+  removeNotFoundCopy(path.join(siteRoot, "dist", "client"));
+}

package/ui/garden/markdown-destination.mjs

@@ -0,0 +1,77 @@
+/**
+ * Inline links and images, `[label](destination "title")` and
+ * `![alt](destination "title")`, read the way CommonMark reads them. A
+ * destination is either
+ * - `<…>`: anything but a line break or an unescaped `<` / `>`, so it may hold
+ *   spaces and unbalanced parentheses: `![a](<./my shot (1).png>)`; or
+ * - a bare run without spaces, where parentheses must balance:
+ *   `[w](https://en.wikipedia.org/wiki/Trie_(data_structure))`.
+ * The build, the checker, the draft preview, link cards and the search index
+ * all use this one reading, so a destination that works in the article also
+ * works everywhere else, and a rewritten destination keeps its brackets.
+ */
+
+const ESCAPED = String.raw`\\.`;
+const ANGLE = String.raw`<((?:[^<>\n\\]|${ESCAPED})*)>`;
+const PLAIN = String.raw`(?:[^\s()<\\]|${ESCAPED})`;
+const INNER = String.raw`(?:[^\s()\\]|${ESCAPED})`;
+// Balanced parentheses, nested up to three deep.
+const PARENS = [1, 2, 3].reduce((inner) => String.raw`\((?:${INNER}|${inner})*\)`, String.raw`\((?:${INNER})*\)`);
+const BARE = String.raw`((?:${PLAIN}|${PARENS})(?:${INNER}|${PARENS})*)`;
+const LABEL = String.raw`(?:[^\[\]\\]|${ESCAPED}|\[(?:[^\[\]\\]|${ESCAPED})*\])*`;
+
+/**
+ * Source of the inline link pattern. Groups: 1 `!` for an image, 2 label,
+ * 3 destination written in `<…>`, 4 bare destination, 5 title (with the space
+ * before it).
+ */
+export const INLINE_LINK_SOURCE = String.raw`(!?)\[(${LABEL})\]\(\s*(?:${ANGLE}|${BARE})((?:\s+(?:"(?:[^"\\]|${ESCAPED})*"|'(?:[^'\\]|${ESCAPED})*'|\((?:[^()\\]|${ESCAPED})*\)))?)\s*\)`;
+
+/**
+ * A fresh global pattern for inline links and images (`flags` adds e.g. `i`).
+ * @param {string} [flags]
+ */
+export const inlineLinkPattern = (flags = "") => new RegExp(INLINE_LINK_SOURCE, `gu${flags.replace(/[gu]/gu, "")}`);
+
+/**
+ * @typedef {{ whole: string, image: boolean, label: string, url: string, angle: boolean, title: string }} InlineLink
+ */
+
+/**
+ * The parts of one match of inlineLinkPattern().
+ * @param {ArrayLike<string | undefined>} match
+ * @returns {InlineLink}
+ */
+export function inlineLinkParts(match) {
+  const angle = match[3] !== undefined;
+  return { whole: String(match[0]), image: match[1] === "!", label: String(match[2] ?? ""), url: String((angle ? match[3] : match[4]) ?? ""), angle, title: match[5] ?? "" };
+}
+
+/**
+ * A destination written back the way it was written: in `<…>` if it was.
+ * @param {string} url
+ * @param {boolean} angle
+ */
+export const formatDestination = (url, angle) => (angle ? `<${url}>` : url);
+
+/**
+ * `[label](destination title)` or `![…](…)` from parts, with a new url.
+ * @param {Pick<InlineLink, "image" | "label" | "angle" | "title">} link
+ * @param {string} url
+ */
+export const formatInlineLink = ({ image, label, angle, title }, url) =>
+  `${image ? "!" : ""}[${label}](${formatDestination(url, angle)}${title})`;
+
+/**
+ * Replace every inline link and image. `replace(parts)` returns the new text,
+ * or undefined to leave that link as written.
+ * @param {string} text
+ * @param {(link: InlineLink) => string | undefined} replace
+ * @returns {string}
+ */
+export function replaceInlineLinks(text, replace) {
+  return String(text ?? "").replace(inlineLinkPattern(), (...match) => {
+    const next = replace(inlineLinkParts(/** @type {string[]} */ (match)));
+    return next === undefined ? match[0] : next;
+  });
+}

package/ui/garden/markdown-links.mjs

@@ -2,6 +2,7 @@
  * External links written in a post body. Code (fenced blocks, indented blocks
  * and inline spans) is skipped, so a URL in a snippet is never a link.
  */
+import { INLINE_LINK_SOURCE } from "./markdown-destination.mjs";
 
 const FENCE = /^ {0,3}(`{3,}|~{3,})/u;
 
@@ -47,7 +48,12 @@ function mapInline(text, visit) {
   return result + visit(text.slice(index));
 }
 
-const LINK = /(!?)\[(?:[^\[\]]|\[[^\]]*\])*\]\(\s*<?(https?:\/\/[^\s)>]+)>?(?:\s+(?:"[^"]*"|'[^']*'))?\s*\)(\{card\})?/giu;
+// Inline links read as CommonMark reads them (ui/garden/markdown-destination.mjs):
+// `[t](<https://e.com/a (1)>)` and `[t](https://e.com/Trie_(x))` are whole addresses.
+// Groups: 1 `!`, 3 or 4 the address, 6 `{card}`.
+const LINK = new RegExp(`${INLINE_LINK_SOURCE}(\\{card\\})?`, "giu");
+const linkUrl = (match) => match[3] ?? match[4];
+const isWebUrl = (url) => /^https?:\/\//iu.test(url);
 const AUTOLINK = /<(https?:\/\/[^\s>]+)>/giu;
 const BARE = /(^|[\s(（：:，,。])(https?:\/\/[^\s<>()（）\]，。、]+[^\s<>()（）\].,;:!?，。、；：！？'"])/giu;
 
@@ -56,7 +62,7 @@ export function markdownLinks(markdown) {
   const links = [];
   mapOutsideCode(markdown, (text) => {
     for (const match of text.matchAll(LINK)) {
-      if (match[1] !== "!") links.push({ url: match[2], card: Boolean(match[3]) });
+      if (match[1] !== "!" && isWebUrl(linkUrl(match))) links.push({ url: linkUrl(match), card: Boolean(match[6]) });
     }
     const rest = text.replace(LINK, " ");
     for (const match of rest.matchAll(AUTOLINK)) links.push({ url: match[1], card: false });
@@ -75,7 +81,7 @@ export const CARD_MARKER = "{card}";
  */
 export function stripCardMarkers(markdown) {
   if (!String(markdown ?? "").includes(CARD_MARKER)) return markdown;
-  return mapOutsideCode(markdown, (text) => text.replace(LINK, (whole, bang, url, card) => (card ? whole.slice(0, -CARD_MARKER.length) : whole)));
+  return mapOutsideCode(markdown, (text) => text.replace(LINK, (...match) => (match[6] && isWebUrl(linkUrl(match)) ? match[0].slice(0, -CARD_MARKER.length) : match[0])));
 }
 
 /** URLs the author asked to show as cards, in order, without repeats. */

package/ui/garden/search-index.mjs

@@ -8,13 +8,17 @@
  */
 import crypto from "node:crypto";
 import { contentToSearchText } from "../core/transform.mjs";
+import { inlineLinkPattern } from "./markdown-destination.mjs";
+
+const INLINE_LINK = inlineLinkPattern();
 
 /** Plain text of a post body, as search and word counts see it. */
 export function searchableText(markdown) {
   return contentToSearchText(markdown)
     .replace(/```[^\n]*\n([\s\S]*?)```/g, " $1 ")
-    .replace(/!\[([^\]]*)\]\([^)]+\)/g, " $1 ")
-    .replace(/\[([^\]]+)\]\([^)]+\)/g, " $1 ")
+    // Links and images leave their text; the address goes whole, even with
+    // parentheses or in <…> (ui/garden/markdown-destination.mjs).
+    .replace(INLINE_LINK, (...match) => ` ${match[2]} `)
     .replace(/<[^>]+>/g, " ")
     .replace(/[#>*_~`|[\]{}()]/g, " ")
     .replace(/\s+/g, " ")