@takazudo/zudo-doc 5.26.5 → 5.28.0

package/CHANGELOG.md

@@ -8,11 +8,42 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [5.28.0] - 2026-09-27
+
+### Features
+
+- Search now indexes up to 3000 characters per page instead of 300, making longer pages searchable beyond their opening paragraphs. Set `searchMaxBodyLength` to a positive integer to adjust the limit; result snippets retain their existing display length. (332a6184b)
+
+### Bug Fixes
+
+- Heading extraction for the table of contents and link checks ignores heading-like text inside multiline JSX expressions, comments, quoted attributes, and template-literal props, while preserving headings in JSX children. Multiline inline-code spans no longer confuse JSX detection. (b85fe3469, 99ad4252b)
+- Escape closes the mobile drawer's Appearance menu and returns focus to its trigger; a second Escape closes the drawer and focuses the hamburger button. (66359d27c)
+
+### Other Changes
+
+- Raise the zfb, zfb-runtime, and zfb-md-wasm peer floors to `^2.21.1`, bringing single-Preact-runtime SSR fixes, collection include-filter handling, faster startup, and workspace-package staging and reload fixes. No configuration migration is required. (6686f2da6, e82e57551)
+
+## [5.27.0] - 2026-09-24
+
+### Features
+
+- Added an accessible Appearance menu with Light, Dark, and System choices. System follows device changes, and the selected preference persists across navigation (5bb3d2175, d2146b6e0).
+
+### Bug Fixes
+
+- Grouped header icons into 40 px controls with no internal gap and 12 px boundaries beside other controls; the Appearance menu also returns keyboard focus to its trigger after closing (4c718aa02).
+- Kept the Appearance menu above the design token panel and within the available viewport (1773a3a21).
+- Corrected heading IDs and table-of-contents links when headings contain escaped punctuation or code spans (59d47f68a).
+
+### Other Changes
+
+- Raised the minimum supported zfb toolchain peer version to 2.20.2 (e22acafdf).
+
 ## [5.26.5] - 2026-09-23
 
 ### Bug Fixes
 
-- Fixed package-owned route injection in nested pnpm workspace consumers. Published route sources are staged under the project root so the build shadow can resolve the generated 404, robots, and docs routes (848264b9c).
+- Fixed package-owned route injection in nested pnpm workspace consumers. Published route sources are staged under the project root so the build shadow can resolve the generated 404, robots, and docs routes (848264b9c). Projects scaffolded on 5.26.4 or earlier should add `.zudo-doc/` to their `.gitignore`: the build now writes the staged route sources to `.zudo-doc/routes-src/`, and without the ignore entry `git status` will show it as an untracked directory. New scaffolds already ignore it; see the `create-zudo-doc` changelog.
 
 ## [5.26.4] - 2026-09-22
 

package/dist/compiled.css

@@ -387,6 +387,9 @@
 .z-toolbar {
   z-index: 20;
 }
+.z-tooltip {
+  z-index: 80;
+}
 .col-span-full {
   grid-column: 1 / -1;
 }
@@ -604,6 +607,9 @@
 .h-\[14px\] {
   height: 14px;
 }
+.h-\[40px\] {
+  height: 40px;
+}
 .h-\[70vh\] {
   height: 70vh;
 }
@@ -715,6 +721,9 @@
 .w-\[18px\] {
   width: 18px;
 }
+.w-\[40px\] {
+  width: 40px;
+}
 .w-\[90vw\] {
   width: 90vw;
 }
@@ -1152,6 +1161,12 @@
 .bg-accent {
   background-color: var(--color-accent);
 }
+.bg-accent\/10 {
+  background-color: var(--color-accent);
+  @supports (color: color-mix(in lab, red, red)) {
+    background-color: color-mix(in oklab, var(--color-accent) 10%, transparent);
+  }
+}
 .bg-bg {
   background-color: var(--color-bg);
 }
@@ -1233,6 +1248,9 @@
 .p-hsp-xl {
   padding: var(--spacing-hsp-xl);
 }
+.p-hsp-xs {
+  padding: var(--spacing-hsp-xs);
+}
 .px-hsp-2xl {
   padding-inline: var(--spacing-hsp-2xl);
 }

package/dist/config-assertions/index.d.ts

@@ -68,6 +68,19 @@ export declare function resolvesBundleZdtp(settings: ZdtpBundlingSubject): boole
  * in the browser. Fail loudly at config resolution instead (#4261).
  */
 export declare function assertZdtpBundlingConsistent(settings: ZdtpBundlingSubject): void;
+/**
+ * Reject a `searchMaxBodyLength` that is not a positive integer.
+ *
+ * `undefined` no-ops (the field is optional at this layer — the search-index
+ * collector applies its own `MAX_BODY_LENGTH` default). Shared between
+ * `zudoDoc()` (`../config.ts`) and `zudoDocPreset()` (same rationale as the
+ * other guards above) AND the search-index collector itself
+ * (`../plugins/internal/search-index/collect.ts`), which is also reachable
+ * directly (tests, or a consumer calling `collectSearchEntries()` outside
+ * `zudoDoc()`) — clamping silently there would hide a config typo behind a
+ * quietly-wrong index instead of failing loudly (zudolab/zudo-doc#4407).
+ */
+export declare function assertValidSearchMaxBodyLength(searchMaxBodyLength: number | undefined): void;
 /**
  * Warn about `categoryMatch` values that cannot express the intended
  * dropdown grouping.

package/dist/config-assertions/index.js

@@ -29,6 +29,14 @@ function assertZdtpBundlingConsistent(settings) {
     );
   }
 }
+function assertValidSearchMaxBodyLength(searchMaxBodyLength) {
+  if (searchMaxBodyLength === void 0) return;
+  if (!Number.isInteger(searchMaxBodyLength) || searchMaxBodyLength <= 0) {
+    throw new TypeError(
+      `Invalid searchMaxBodyLength ${JSON.stringify(searchMaxBodyLength)}: must be a positive integer (e.g. 3000).`
+    );
+  }
+}
 function warnAmbiguousDropdownCategoryMatch(headerNav, logger = console) {
   if (!headerNav) return;
   for (const item of headerNav) {
@@ -70,6 +78,7 @@ function warnAmbiguousDropdownCategoryMatch(headerNav, logger = console) {
 }
 export {
   assertNoEmptyStringFaviconOrLogo,
+  assertValidSearchMaxBodyLength,
   assertZdtpBundlingConsistent,
   resolvesBundleZdtp,
   warnAmbiguousDropdownCategoryMatch

package/dist/config.d.ts

@@ -368,6 +368,20 @@ export interface ZudoDocConfig {
      * @default 4
      */
     tocMaxDepth?: number;
+    /**
+     * How many characters of each page's plain-text body are indexed for
+     * search *matching* (`search-index.json`'s per-entry `body` field). This is
+     * a match-depth cap, not a display cap — the search widget already renders
+     * only a short match-centred window (`truncate(text, query, 200)`), so
+     * raising this value makes long pages searchable past their opening
+     * paragraphs without changing what a result snippet shows. Also caps how
+     * many bytes are read from a public text asset for its search excerpt (the
+     * asset-viewer indexing path in `plugins/internal/search-index/collect.ts`).
+     * Must be a positive integer — a non-integer or ≤ 0 value throws at config
+     * resolution.
+     * @default 3000
+     */
+    searchMaxBodyLength?: number;
     /**
      * Enable the draggable sidebar resizer.
      * @default false

package/dist/config.js

@@ -6,7 +6,8 @@ import { defaultColorSchemes } from "./color-schemes-defaults/index.js";
 import { assertNoCommaInVersionSlugs } from "./version-availability/index.js";
 import {
   assertNoEmptyStringFaviconOrLogo,
-  assertZdtpBundlingConsistent
+  assertZdtpBundlingConsistent,
+  assertValidSearchMaxBodyLength
 } from "./config-assertions/index.js";
 import { validateAssetViewerSettings } from "./asset-path/index.js";
 function mergeDefaultTranslations(overrides) {
@@ -91,6 +92,7 @@ const DEFAULT_SETTINGS = {
   designTokenPanel: false,
   tocMinDepth: 2,
   tocMaxDepth: 4,
+  searchMaxBodyLength: 3e3,
   sidebarResizer: false,
   sidebarToggle: false,
   tocToggle: false,
@@ -152,6 +154,7 @@ function zudoDoc(user = {}) {
   assertNoCommaInVersionSlugs(settings.versions);
   assertNoEmptyStringFaviconOrLogo(settings);
   assertZdtpBundlingConsistent(settings);
+  assertValidSearchMaxBodyLength(settings.searchMaxBodyLength);
   const fragment = zudoDocPreset({
     settings,
     buildDocsSchema: userBuildDocsSchema ?? (() => defaultBuildDocsSchema({

package/dist/extract-headings/index.d.ts

@@ -38,3 +38,5 @@ export declare function extractHeadings(body: string, opts?: {
     tocMinDepth?: number;
     tocMaxDepth?: number;
 }): HeadingItem[];
+/** All rendered h2–h6 IDs, including headings below the TOC depth window. */
+export declare function extractAllHeadingIds(body: string): string[];

package/dist/extract-headings/index.js

@@ -52,7 +52,39 @@ class SlugAllocator {
   }
 }
 function stripInlineMarkdown(raw) {
-  return raw.replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/`([^`]+)`/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/(?<![\w])__([^_]+)__(?![\w])/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/(?<![\w])_([^_]+)_(?![\w])/g, "$1").trim();
+  const protectedText = [];
+  const protect = (value) => {
+    const index = protectedText.push(value) - 1;
+    return `\uE000${index}\uE001`;
+  };
+  let masked = "";
+  for (let i = 0; i < raw.length; ) {
+    if (raw[i] === "\\" && i + 1 < raw.length && /[!-/:-@[-`{-~]/.test(raw[i + 1] ?? "")) {
+      masked += protect(raw[i + 1] ?? "");
+      i += 2;
+      continue;
+    }
+    if (raw[i] === "`") {
+      const opener = /^`+/.exec(raw.slice(i))?.[0] ?? "`";
+      const closer = /`+/g;
+      closer.lastIndex = i + opener.length;
+      let match;
+      while ((match = closer.exec(raw)) !== null && match[0].length !== opener.length) {
+      }
+      if (match !== null) {
+        let code = raw.slice(i + opener.length, match.index).replace(/\n/g, " ");
+        if (code.startsWith(" ") && code.endsWith(" ") && /[^ ]/.test(code)) {
+          code = code.slice(1, -1);
+        }
+        masked += protect(code);
+        i = match.index + opener.length;
+        continue;
+      }
+    }
+    masked += raw[i];
+    i++;
+  }
+  return masked.replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/(?<![A-Za-z0-9])__([^_]+)__(?![A-Za-z0-9])/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/(?<![A-Za-z0-9])_([^_]+)_(?![A-Za-z0-9])/g, "$1").replace(/\uE000(\d+)\uE001/g, (_match, index) => protectedText[Number(index)] ?? "").trim();
 }
 function resolveDepthWindow(rawMin, rawMax) {
   const min = Math.trunc(Number(rawMin));
@@ -67,23 +99,18 @@ function extractHeadings(body, opts) {
     opts?.tocMinDepth ?? 2,
     opts?.tocMaxDepth ?? 4
   );
+  return collectHeadings(body, lo, hi);
+}
+function extractAllHeadingIds(body) {
+  return collectHeadings(body, 2, 6).map((heading) => heading.slug).filter(Boolean);
+}
+function collectHeadings(body, lo, hi) {
   const allocator = new SlugAllocator();
   const headings = [];
-  let codeFenceOpener = null;
-  for (const line of body.split("\n")) {
-    const trimmed = line.trimStart();
-    const fenceMatch = /^([`~]{3,})/.exec(trimmed);
-    if (fenceMatch) {
-      const fence = fenceMatch[1];
-      if (fence === void 0) continue;
-      if (codeFenceOpener === null) {
-        codeFenceOpener = fence;
-      } else if (fence[0] === codeFenceOpener[0] && fence.length >= codeFenceOpener.length) {
-        codeFenceOpener = null;
-      }
-      continue;
-    }
-    if (codeFenceOpener !== null) continue;
+  const lines = body.split("\n");
+  const candidate = classifyLines(lines);
+  for (const [index, line] of lines.entries()) {
+    if (candidate[index] !== true) continue;
     const match = /^(#{2,6})[ \t]+(.+)$/.exec(line.trim());
     if (!match) continue;
     const hashes = match[1];
@@ -98,7 +125,129 @@ function extractHeadings(body, opts) {
   }
   return headings;
 }
+const JSX_TAG_CHAR = /[\p{ID_Continue}$\-.:=/>"'{\s]/u;
+const JSX_TAG_START = /[\p{ID_Start}$_/>]/u;
+const ASCII_PUNCTUATION = /[!-/:-@[-`{-~]/;
+const ATX_HEADING = /^#{1,6}(?:[ \t]|$)/;
+function findCodeSpanEnd(lines, from, runLength) {
+  for (let lineIndex = from; lineIndex < lines.length; lineIndex++) {
+    const line = lines[lineIndex] ?? "";
+    const trimmed = line.trimStart();
+    if (trimmed.trim() === "" || ATX_HEADING.test(trimmed) || /^(?:`{3,}|~{3,})/.test(trimmed)) {
+      return null;
+    }
+    for (const match of line.matchAll(/`+/g)) {
+      if (match[0].length === runLength) {
+        return { line: lineIndex, col: match.index + runLength };
+      }
+    }
+  }
+  return null;
+}
+function classifyLines(lines) {
+  const ignoredOpeners = /* @__PURE__ */ new Set();
+  for (; ; ) {
+    const result = scanLines(lines, ignoredOpeners);
+    if (result.unclosedOpener === null) return result.candidate;
+    ignoredOpeners.add(result.unclosedOpener);
+  }
+}
+function scanLines(lines, ignoredOpeners) {
+  const candidate = [];
+  let codeFenceOpener = null;
+  let exprDepth = 0;
+  let tag = null;
+  let opener = null;
+  let codeSpanEnd = null;
+  for (const [lineIndex, line] of lines.entries()) {
+    let start = 0;
+    if (codeSpanEnd !== null) {
+      candidate.push(false);
+      if (lineIndex < codeSpanEnd.line) continue;
+      start = codeSpanEnd.col;
+      codeSpanEnd = null;
+    }
+    const trimmed = line.trimStart();
+    if (start === 0 && tag !== null && tag.quote === null && exprDepth === 0) {
+      const first = trimmed[0];
+      if (first !== void 0 && !JSX_TAG_CHAR.test(first)) tag = null;
+    }
+    if (start > 0) {
+    } else if (exprDepth > 0 || tag !== null) {
+      candidate.push(false);
+    } else {
+      const fence = /^([`~]{3,})/.exec(trimmed)?.[1];
+      if (fence !== void 0) {
+        if (codeFenceOpener === null) {
+          codeFenceOpener = fence;
+        } else if (fence[0] === codeFenceOpener[0] && fence.length >= codeFenceOpener.length) {
+          codeFenceOpener = null;
+        }
+        candidate.push(false);
+        continue;
+      }
+      candidate.push(codeFenceOpener === null);
+      if (codeFenceOpener !== null) continue;
+    }
+    for (let i = start; i < line.length; i++) {
+      const ch = line[i] ?? "";
+      if (exprDepth > 0) {
+        if (ch === "{") exprDepth++;
+        else if (ch === "}") exprDepth--;
+        continue;
+      }
+      if (tag !== null) {
+        if (tag.quote !== null) {
+          if (ch === tag.quote) tag.quote = null;
+        } else if (ch === '"' || ch === "'") {
+          tag.quote = ch;
+        } else if (ch === "{") {
+          exprDepth = 1;
+        } else if (ch === ">") {
+          tag = null;
+        } else if (!JSX_TAG_CHAR.test(ch)) {
+          tag = null;
+          i--;
+        }
+        continue;
+      }
+      if (ch === "\\" && ASCII_PUNCTUATION.test(line[i + 1] ?? "")) {
+        i++;
+        continue;
+      }
+      if (ch === "`") {
+        const run = /^`+/.exec(line.slice(i))?.[0] ?? "`";
+        const closer = /`+/g;
+        closer.lastIndex = i + run.length;
+        let match;
+        while ((match = closer.exec(line)) !== null && match[0].length !== run.length) {
+        }
+        if (match === null && !ATX_HEADING.test(trimmed)) {
+          codeSpanEnd = findCodeSpanEnd(lines, lineIndex + 1, run.length);
+          if (codeSpanEnd !== null) break;
+        }
+        i = (match === null ? i : match.index) + run.length - 1;
+        continue;
+      }
+      const position = `${lineIndex}:${i}`;
+      if (ignoredOpeners.has(position)) continue;
+      if (ch === "{") {
+        exprDepth = 1;
+        opener = position;
+      } else if (ch === "<" && JSX_TAG_START.test(line[i + 1] ?? "")) {
+        tag = { quote: null };
+        opener = position;
+      }
+    }
+    if (exprDepth === 0 && tag === null) opener = null;
+  }
+  return {
+    candidate,
+    unclosedOpener: exprDepth > 0 || tag !== null ? opener : null
+  };
+}
 export {
+  extractAllHeadingIds,
   extractHeadings,
   slugify
 };

package/dist/header/header.js

@@ -49,6 +49,43 @@ function Header(props) {
   const matchPath = pathForMatch(pathWithoutVersion, lang, i18n.defaultLocale);
   const activeNavPath = computeActiveNavPath(headerNav, matchPath);
   const rightItemDispatch = createRightItemDispatch(headerRightComponents);
+  const rightItems = headerRightItems.map((item, i) => ({
+    item,
+    node: renderRightItem(
+      item,
+      i,
+      {
+        lang,
+        githubRepoUrl,
+        githubLabel,
+        themeToggle,
+        languageSwitcher,
+        versionSwitcher,
+        search,
+        colorModeEnabled,
+        hasLocales
+      },
+      rightItemDispatch
+    )
+  })).filter((entry) => entry.node !== null);
+  const rightGroups = [];
+  let iconGroup = [];
+  const flushIconGroup = () => {
+    if (iconGroup.length === 0) return;
+    rightGroups.push(
+      /* @__PURE__ */ jsx("div", { class: "flex items-center", "data-header-icon-group": true, children: iconGroup })
+    );
+    iconGroup = [];
+  };
+  for (const { item, node } of rightItems) {
+    if (isHeaderIconItem(item)) {
+      iconGroup.push(node);
+    } else {
+      flushIconGroup();
+      rightGroups.push(node);
+    }
+  }
+  flushIconGroup();
   return /* @__PURE__ */ jsxs(
     "header",
     {
@@ -123,22 +160,7 @@ function Header(props) {
           {
             class: "ml-auto flex shrink-0 items-center gap-x-hsp-md",
             "data-header-right": true,
-            children: headerRightItems.map((item, i) => renderRightItem(
-              item,
-              i,
-              {
-                lang,
-                githubRepoUrl,
-                githubLabel,
-                themeToggle,
-                languageSwitcher,
-                versionSwitcher,
-                search,
-                colorModeEnabled,
-                hasLocales
-              },
-              rightItemDispatch
-            ))
+            children: rightGroups
           }
         ),
         /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: NAV_OVERFLOW_SCRIPT } }),
@@ -271,6 +293,12 @@ function stripCurrentVersionPrefix(path, currentVersion) {
   if (path.startsWith(`${prefix}/`)) return path.slice(prefix.length);
   return path;
 }
+function isHeaderIconItem(item) {
+  if (item.type === "trigger") return true;
+  if (item.type === "link") return item.icon === "github";
+  if (item.type !== "component") return false;
+  return ["github-link", "theme-toggle", "search"].includes(item.component);
+}
 function TriggerButton({
   index,
   id,
@@ -286,7 +314,7 @@ function TriggerButton({
     {
       id,
       type: "button",
-      class: "flex items-center justify-center text-muted transition-colors hover:text-fg",
+      class: "flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted transition-colors hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2",
       "aria-label": ariaLabel,
       ...inlineOnclick,
       children
@@ -373,7 +401,7 @@ const BASE_RIGHT_ITEM_DISPATCH = {
         href: ctx.githubRepoUrl,
         target: "_blank",
         rel: "noopener noreferrer",
-        class: "flex items-center justify-center text-muted transition-colors hover:text-fg",
+        class: "flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted transition-colors hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2",
         "aria-label": ctx.githubLabel,
         title: ctx.githubLabel,
         children: [
@@ -403,7 +431,7 @@ const BASE_RIGHT_ITEM_DISPATCH = {
         href: item.href,
         target: isExternal ? "_blank" : void 0,
         rel: isExternal ? "noopener noreferrer" : void 0,
-        class: "flex items-center justify-center text-muted transition-colors hover:text-fg",
+        class: item.icon === "github" ? "flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted transition-colors hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2" : "flex items-center justify-center text-muted transition-colors hover:text-fg",
         "aria-label": item.ariaLabel,
         title: label,
         children: item.icon === "github" ? /* @__PURE__ */ jsxs(Fragment, { children: [

package/dist/header-with-defaults/index.js

@@ -6,6 +6,7 @@ import {
   VersionSwitcher
 } from "../i18n-version/index.js";
 import { ThemeToggle } from "../theme-toggle/index.js";
+import { themeToggleLabels } from "../theme-toggle/labels.js";
 import { SidebarToggle } from "../sidebar-toggle-island/index.js";
 import { buildGitHubRepoUrl as buildGitHubRepoUrlBase } from "../github-helpers/index.js";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";
@@ -47,6 +48,7 @@ function createHeaderWithDefaults(ctx) {
     const backToMenuLabel = t("nav.backToMenu", lang);
     const localeLinks = buildLocaleLinksForNav(currentPath, lang, locales.length);
     const themeDefaultMode = getThemeDefaultMode();
+    const themeRespectSystem = (ctx.settings.colorMode && ctx.settings.colorMode.respectPrefersColorScheme) ?? true;
     const buildDefaultSidebarNodes = () => buildSidebarNodes(lang, navSection, currentVersion);
     const sidebarNodes = sidebarNodesProp === void 0 ? buildDefaultSidebarNodes() : typeof sidebarNodesProp === "function" ? sidebarNodesProp({
       lang,
@@ -66,13 +68,15 @@ function createHeaderWithDefaults(ctx) {
           locale: lang,
           localeLinks,
           themeDefaultMode,
+          themeLabels: themeToggleLabels(t, lang),
+          themeRespectSystem,
           dateFormats: dateFormatsFor(lang)
         }
       )
     });
     const themeToggle = Island({
       when: "load",
-      children: /* @__PURE__ */ jsx(ThemeToggle, { defaultMode: themeDefaultMode, pendingUntilHydrated: true })
+      children: /* @__PURE__ */ jsx(ThemeToggle, { defaultMode: themeDefaultMode, labels: themeToggleLabels(t, lang), respectPrefersColorScheme: themeRespectSystem, pendingUntilHydrated: true })
     });
     const searchWidget = /* @__PURE__ */ jsx(
       SearchWidget,

package/dist/i18n-defaults/index.js

@@ -37,6 +37,11 @@ const defaultTranslations = {
     "doc.editPage": "Edit this page",
     "doc.viewSource": "View source on GitHub",
     "header.github": "GitHub repository",
+    "appearance.title": "Appearance",
+    "appearance.light": "Light",
+    "appearance.dark": "Dark",
+    "appearance.system": "System",
+    "appearance.systemHelper": "Follows device \xB7 currently {mode}",
     "language.switcher.label": "Language",
     "doc.tags": "Tags",
     "doc.taggedWith": "Pages tagged with",
@@ -167,6 +172,11 @@ const defaultTranslations = {
     "doc.editPage": "\u3053\u306E\u30DA\u30FC\u30B8\u3092\u7DE8\u96C6",
     "doc.viewSource": "GitHub \u3067\u30BD\u30FC\u30B9\u3092\u898B\u308B",
     "header.github": "GitHub \u30EA\u30DD\u30B8\u30C8\u30EA",
+    "appearance.title": "\u5916\u89B3",
+    "appearance.light": "\u30E9\u30A4\u30C8",
+    "appearance.dark": "\u30C0\u30FC\u30AF",
+    "appearance.system": "\u30B7\u30B9\u30C6\u30E0",
+    "appearance.systemHelper": "\u30C7\u30D0\u30A4\u30B9\u306E\u8A2D\u5B9A\u306B\u5F93\u3044\u307E\u3059 \xB7 \u73FE\u5728\u306F{mode}",
     "language.switcher.label": "\u8A00\u8A9E",
     "doc.tags": "\u30BF\u30B0",
     "doc.taggedWith": "\u30BF\u30B0\u4ED8\u304D\u30DA\u30FC\u30B8",

package/dist/plugins/internal/search-index/collect.js

@@ -8,14 +8,15 @@ import {
   stripMarkdown
 } from "../../../md-utils/index.js";
 import { collectAssetPageDescriptors } from "../asset-viewer/asset-pages.js";
+import { assertValidSearchMaxBodyLength } from "../../../config-assertions/index.js";
 import {
   MAX_BODY_LENGTH
 } from "./types.js";
-function truncateBody(text) {
-  return text.length > MAX_BODY_LENGTH ? text.substring(0, MAX_BODY_LENGTH) : text;
+function truncateBody(text, maxBodyLength) {
+  return text.length > maxBodyLength ? text.substring(0, maxBodyLength) : text;
 }
-function readAssetExcerpt(filePath) {
-  const sample = Buffer.allocUnsafe(MAX_BODY_LENGTH * 4);
+function readAssetExcerpt(filePath, maxBodyLength) {
+  const sample = Buffer.allocUnsafe(maxBodyLength * 4);
   const fd = openSync(filePath, "r");
   try {
     let offset = 0;
@@ -30,12 +31,12 @@ function readAssetExcerpt(filePath) {
       if (bytesRead === 0) break;
       offset += bytesRead;
     }
-    return truncateBody(sample.subarray(0, offset).toString("utf8"));
+    return truncateBody(sample.subarray(0, offset).toString("utf8"), maxBodyLength);
   } finally {
     closeSync(fd);
   }
 }
-function buildEntries(contentDir, locale, base) {
+function buildEntries(contentDir, locale, base, maxBodyLength) {
   const absDir = resolve(contentDir);
   const files = collectMdFiles(absDir);
   const entries = [];
@@ -49,14 +50,14 @@ function buildEntries(contentDir, locale, base) {
     entries.push({
       id,
       title: data.title ?? slug,
-      body: truncateBody(stripMarkdown(content)),
+      body: truncateBody(stripMarkdown(content), maxBodyLength),
       url: slugToUrl(slug, locale, base),
       description: data.description ?? ""
     });
   }
   return entries;
 }
-function buildAssetEntries(config) {
+function buildAssetEntries(config, maxBodyLength) {
   const { assetScan, projectRoot } = config;
   if (assetScan === void 0 || projectRoot === void 0) return [];
   const descriptors = collectAssetPageDescriptors({
@@ -67,7 +68,7 @@ function buildAssetEntries(config) {
   const assetRoot = resolve(projectRoot, "public", assetScan.assetViewerDir);
   return descriptors.map((descriptor) => {
     const localePrefix = descriptor.locale === void 0 ? "" : `${descriptor.locale}/`;
-    const body = descriptor.isText ? readAssetExcerpt(resolve(assetRoot, descriptor.path)) : "";
+    const body = descriptor.isText ? readAssetExcerpt(resolve(assetRoot, descriptor.path), maxBodyLength) : "";
     return {
       id: `asset:${localePrefix}${assetScan.assetViewerRoutePrefix}/${descriptor.path}`,
       title: basename(descriptor.path),
@@ -78,15 +79,17 @@ function buildAssetEntries(config) {
   });
 }
 function collectSearchEntries(config) {
+  assertValidSearchMaxBodyLength(config.maxBodyLength);
+  const maxBodyLength = config.maxBodyLength ?? MAX_BODY_LENGTH;
   const base = config.base ?? "";
   const entries = [];
-  entries.push(...buildEntries(config.docsDir, null, base));
+  entries.push(...buildEntries(config.docsDir, null, base, maxBodyLength));
   if (config.locales) {
     for (const [code, locale] of Object.entries(config.locales)) {
-      entries.push(...buildEntries(locale.dir, code, base));
+      entries.push(...buildEntries(locale.dir, code, base, maxBodyLength));
     }
   }
-  entries.push(...buildAssetEntries(config));
+  entries.push(...buildAssetEntries(config, maxBodyLength));
   return entries;
 }
 export {