hd-garden 0.5.18 → 0.6.1

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

@@ -8,6 +8,7 @@ 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;
@@ -15,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);

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,
@@ -694,7 +694,7 @@ 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: #faf9f5;
+  background: var(--image-backing);
 }
 
 .markdown-body .fig {

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.18",
+  "version": "0.6.1",
   "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/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}`);
     }
@@ -99,20 +101,44 @@ async function listFiles(root, directory = root) {
   return files;
 }
 
+// The deployment ID vinext writes into pages and payloads, and bakes into the
+// client bundle as CLIENT_DEPLOYMENT_VERSION (vinext 1.x compares the two on
+// every client navigation and loads the whole page when they differ).
+const DEPLOYMENT_ID_SOURCES = [".html", ".rsc", ".txt"];
+const DEPLOYMENT_ID_CARRIERS = [".html", ".rsc", ".txt", ".js", ".mjs", ".json"];
+
+function buildDeploymentVersions(text) {
+  const found = new Set();
+  for (const match of text.matchAll(/"deploymentVersion":"([^"]+)"/gu)) found.add(match[1]);
+  for (const match of text.matchAll(/\\["]deploymentVersion\\["]:\\["]([^"\\]+)\\["]/gu)) found.add(match[1]);
+  found.delete(deploymentVersionPlaceholder);
+  return found;
+}
+
 async function stabilizeDeploymentVersion(root) {
   const hash = crypto.createHash("sha256");
   const normalizedFiles = new Map();
+  const files = await listFiles(root);
+
+  // The build's own IDs, read from the pages and payloads.
+  const versions = new Set();
+  for (const file of files) {
+    if (!DEPLOYMENT_ID_SOURCES.includes(path.extname(file.relativePath))) continue;
+    for (const version of buildDeploymentVersions(await fs.readFile(file.absolutePath, "utf8"))) versions.add(version);
+  }
 
-  for (const file of await listFiles(root)) {
+  for (const file of files) {
     const original = await fs.readFile(file.absolutePath);
     let normalized = original;
-    if ([".html", ".rsc"].includes(path.extname(file.relativePath))) {
-      const text = original.toString("utf8");
-      normalized = Buffer.from(
-        normalizeDeploymentVersion(text, deploymentVersionPlaceholder),
-        "utf8",
-      );
-      normalizedFiles.set(file.absolutePath, normalized);
+    const extension = path.extname(file.relativePath);
+    // Flight payloads: .rsc from vinext 0.0.x, index.txt / <page>.txt from vinext 1.x static export.
+    // The same ID also sits in the client JavaScript, so every copy gets the same stable value.
+    if (DEPLOYMENT_ID_CARRIERS.includes(extension)) {
+      let text = original.toString("utf8");
+      if (DEPLOYMENT_ID_SOURCES.includes(extension)) text = normalizeDeploymentVersion(text, deploymentVersionPlaceholder);
+      for (const version of versions) text = text.replaceAll(version, deploymentVersionPlaceholder);
+      normalized = Buffer.from(text, "utf8");
+      if (DEPLOYMENT_ID_SOURCES.includes(extension) || !normalized.equals(original)) normalizedFiles.set(file.absolutePath, normalized);
     }
     hash.update(file.relativePath);
     hash.update("\0");
@@ -130,7 +156,7 @@ async function stabilizeDeploymentVersion(root) {
   ].join("-");
 
   for (const [filePath, content] of normalizedFiles) {
-    const stabilized = normalizeDeploymentVersion(content.toString("utf8"), version);
+    const stabilized = content.toString("utf8").replaceAll(deploymentVersionPlaceholder, version);
     await fs.writeFile(filePath, stabilized);
   }
 }

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/static-params.mjs

@@ -0,0 +1,25 @@
+/**
+ * vinext, like Next.js, stops a static export (`output: "export"`) when a
+ * dynamic route's generateStaticParams() returns an empty array. A garden site
+ * can legitimately have no thoughts, no columns or no admin pages to export, so
+ * an empty list becomes one placeholder entry instead. The prerender counts a
+ * notFound() page as a failed route, so the page renders nothing for the
+ * placeholder (isStaticPlaceholder) and the build step
+ * scripts/static-placeholders.mjs deletes what the export wrote for it.
+ */
+export const STATIC_PLACEHOLDER = "__garden_static_placeholder__";
+
+/**
+ * @template T
+ * @param {T[]} params what the route really has
+ * @param {T} placeholder the same shape with every value set to STATIC_PLACEHOLDER
+ * @returns {T[]}
+ */
+export function staticParams(params, placeholder) {
+  return params.length === 0 && process.env.STATIC_EXPORT === "1" ? [placeholder] : params;
+}
+
+/** True for the placeholder value, or a catch-all path that starts with it. */
+export function isStaticPlaceholder(value) {
+  return value === STATIC_PLACEHOLDER || (Array.isArray(value) && value[0] === STATIC_PLACEHOLDER);
+}