@takazudo/zudo-doc 5.13.0 → 5.14.0

package/dist/content/index.js

@@ -2,7 +2,10 @@ import { HeadingH2 } from "./heading-h2.js";
 import { HeadingH3 } from "./heading-h3.js";
 import { HeadingH4 } from "./heading-h4.js";
 import { ContentParagraph } from "./content-paragraph.js";
-import { ContentLink } from "./content-link.js";
+import {
+  ContentLink,
+  createContentLink
+} from "./content-link.js";
 import { ContentStrong } from "./content-strong.js";
 import { ContentBlockquote } from "./content-blockquote.js";
 import { ContentUl } from "./content-ul.js";
@@ -22,5 +25,6 @@ export {
   HeadingH2,
   HeadingH3,
   HeadingH4,
+  createContentLink,
   defaultComponents
 };

package/dist/doc-body-end-islands/index.d.ts

@@ -80,6 +80,8 @@ export interface BodyEndIslandsProps {
      * screen readers announce the chat entrypoint correctly before hydration.
      */
     aiChatBodyLabel?: string;
+    /** Force the ImageEnlarge island for a page-owned enlargeable image. */
+    forceImageEnlarge?: boolean;
 }
 /**
  * Build the package-default `BodyEndIslands` component bound to the host's

package/dist/doc-body-end-islands/index.js

@@ -22,7 +22,8 @@ function createBodyEndIslands(deps) {
   });
   function BodyEndIslands({
     basePath,
-    aiChatBodyLabel = DEFAULT_AI_CHAT_BODY_LABEL
+    aiChatBodyLabel = DEFAULT_AI_CHAT_BODY_LABEL,
+    forceImageEnlarge = false
   }) {
     const aiAssistant = settings.aiAssistant ? /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx("h2", { class: "sr-only", children: "AI Assistant" }),
@@ -31,7 +32,7 @@ function createBodyEndIslands(deps) {
         children: /* @__PURE__ */ jsx(AiChatModal, { basePath })
       })
     ] }) : null;
-    const imageEnlarge = settings.imageEnlarge ? Island({
+    const imageEnlarge = settings.imageEnlarge || forceImageEnlarge ? Island({
       when: "idle",
       ssrFallback: /* @__PURE__ */ jsx(ImageEnlargeSsrFallback, {}),
       children: /* @__PURE__ */ jsx(ImageEnlarge, {})

package/dist/doclayout/doc-layout-with-defaults.d.ts

@@ -18,7 +18,7 @@ export interface DocLayoutWithDefaultsProps extends Omit<DocLayoutProps, "header
     children: ComponentChildren;
     /** Replace the default site header. */
     headerOverride?: ComponentChildren;
-    /** Replace the default sidebar contents. */
+    /** Replace the default sidebar contents; pass `false` to omit its landmark entirely. */
     sidebarOverride?: ComponentChildren;
     /** Replace the default desktop TOC. */
     tocOverride?: ComponentChildren;

package/dist/doclayout/doc-layout-with-defaults.js

@@ -106,7 +106,7 @@ function DocLayoutWithDefaults(props) {
         // pass it through `sidebarOverride` and apply their own
         // `<Island>` wrap (see `pages/lib/_sidebar-with-defaults.tsx`
         // in the host project).
-        sidebarOverride ?? Island({
+        sidebarOverride === false ? void 0 : sidebarOverride ?? Island({
           when: "load",
           children: /* @__PURE__ */ jsx(Sidebar, { nodes: [] })
         })

package/dist/eject/index.js

@@ -2,6 +2,14 @@ import fs from "fs-extra";
 import path from "path";
 import pc from "picocolors";
 const EJECTABLE = {
+  "asset-components": {
+    packageSubpath: "@takazudo/zudo-doc/asset-components",
+    localDir: "src/components/zudo-doc/asset-components",
+    classification: {
+      kind: "nested",
+      remediation: "Set chromeBindings.mdxExtras.Asset and chromeBindings.mdxExtras.AssetCode to project-owned wrappers around the local createAssetCard and createAssetCode factories."
+    }
+  },
   header: {
     packageSubpath: "@takazudo/zudo-doc/header",
     localDir: "src/components/zudo-doc/header",

package/dist/factory-context/index.d.ts

@@ -1,5 +1,5 @@
 import type { Settings } from "../settings.js";
-import type { ColorScheme, ThemePackRegistry } from "../route-context-payload/types.js";
+import type { AssetManifest, ColorScheme, ThemePackRegistry } from "../route-context-payload/types.js";
 import type { UrlHelpers } from "../url-helpers/index.js";
 import type { NavSourceDocsAPI } from "../nav-source-docs/index.js";
 import type { DocRouteEntriesAPI } from "../doc-route-entries/index.js";
@@ -121,6 +121,8 @@ export interface RouteContext<S = Settings> extends UrlHelpers, NavSourceDocsAPI
     /** Resolved, enabled, ordered theme-pack registry (or `null`) — see
      *  {@link RouteContextPayload.themePackRegistry}. */
     themePackRegistry: ThemePackRegistry | null;
+    /** Author-facing asset index, or `null` when the viewer is disabled. */
+    assetManifest: AssetManifest | null;
     /** The reconstructed i18n surface. */
     i18n: FactoryI18n;
     /** Default locale code (un-prefixed `/docs/...`). */

package/dist/features.css

@@ -9,11 +9,11 @@
  *
  * ── Consumer contract ──────────────────────────────────────────────────────
  * The consumer's @theme MUST define the custom properties consumed below:
- *   --color-{fg,muted,accent,surface,code-bg,code-fg,success,warning,
+ *   --color-{bg,fg,muted,accent,surface,code-bg,code-fg,success,warning,
  *            matched-keyword-bg,matched-keyword-fg}
- *   --spacing-{hsp-sm,hsp-2xs,hsp-lg,hsp-md,hsp-xl,vsp-xs,vsp-2xs,vsp-md,
+ *   --spacing-{hsp-sm,hsp-2xs,hsp-lg,hsp-md,hsp-xl,vsp-xs,vsp-2xs,vsp-md,vsp-lg,
  *              icon-sm}
- *   --z-index-local-1
+ *   --z-index-{local-1,local-2}
  *   --z-index-toolbar
  *   --radius-{DEFAULT,lg}
  *   --font-{mono,sans}
@@ -1049,3 +1049,124 @@ button[data-zd-pending] {
   opacity: 0.7;
   pointer-events: none;
 }
+
+/* ======== Asset viewer ======== */
+
+.zd-asset-page .zd-asset-code {
+  counter-reset: line;
+}
+
+.zd-asset-page .zd-asset-code .line {
+  display: block;
+  width: 100%;
+}
+
+.zd-asset-page .zd-asset-code .line::before {
+  counter-increment: line;
+  content: counter(line);
+  display: inline-block;
+  box-sizing: border-box;
+  width: var(--zd-asset-gutter, 4ch);
+  padding-right: var(--spacing-hsp-lg);
+  color: var(--color-muted);
+  text-align: right;
+  user-select: none;
+}
+
+.zd-asset-page .zd-asset-code .line:target {
+  background: color-mix(in srgb, var(--color-accent) 15%, transparent);
+  box-shadow: inset 3px 0 0 var(--color-accent);
+}
+
+.zd-asset-page .zd-asset-filebar {
+  position: sticky;
+  /* Match Header's fixed h-[3.5rem]; --zd-header-h intentionally includes
+   * extra clearance for in-page anchor scrolling. */
+  top: 3.5rem;
+  z-index: var(--z-index-local-2);
+}
+
+.zd-asset-page .zd-asset-code + .code-buttons {
+  display: none;
+}
+
+.zd-asset-page .zd-asset-stage.is-checker {
+  background-color: var(--color-bg);
+  background-image:
+    linear-gradient(45deg, color-mix(in srgb, var(--color-muted) 10%, var(--color-bg)) 25%, transparent 25%),
+    linear-gradient(-45deg, color-mix(in srgb, var(--color-muted) 10%, var(--color-bg)) 25%, transparent 25%),
+    linear-gradient(45deg, transparent 75%, color-mix(in srgb, var(--color-muted) 10%, var(--color-bg)) 75%),
+    linear-gradient(-45deg, transparent 75%, color-mix(in srgb, var(--color-muted) 10%, var(--color-bg)) 75%);
+  background-position: 0 0, 0 var(--spacing-hsp-sm), var(--spacing-hsp-sm) calc(-1 * var(--spacing-hsp-sm)), calc(-1 * var(--spacing-hsp-sm)) 0;
+  background-size: calc(2 * var(--spacing-hsp-sm)) calc(2 * var(--spacing-hsp-sm));
+}
+
+.zd-asset-page .zd-asset-stage.is-dark {
+  background: var(--color-code-bg);
+}
+
+.zd-asset-page .zd-asset-stage.is-1to1 img {
+  max-width: none;
+}
+
+.zd-asset-page .zd-asset-media-grid {
+  display: grid;
+  gap: var(--spacing-vsp-lg);
+}
+
+.zd-asset-page .zd-asset-media-rail {
+  display: flex;
+  flex-direction: column;
+  align-items: start;
+  gap: var(--spacing-vsp-md);
+}
+
+.zd-asset-page .zd-asset-media-rail > * {
+  width: 100%;
+}
+
+@media (min-width: 1024px) {
+  .zd-asset-page .zd-asset-media-grid {
+    grid-template-columns: minmax(0, 1fr) 20rem;
+    align-items: start;
+  }
+
+}
+
+[data-zd-asset-tree]:where(ul),
+[data-zd-asset-tree] :where(ul) {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+[data-zd-asset-tree] :where(li) {
+  margin: 0;
+}
+
+[data-zd-asset-tree] :where(ul) {
+  margin-left: var(--spacing-hsp-md);
+  padding-left: var(--spacing-hsp-md);
+  border-left: 1px solid color-mix(in srgb, currentColor 18%, transparent);
+}
+
+[data-zd-asset-tree] :where(summary) {
+  list-style: none;
+}
+
+[data-zd-asset-tree] :where(summary)::-webkit-details-marker {
+  display: none;
+}
+
+[data-zd-asset-tree] :where(summary)::marker {
+  content: "";
+}
+
+[data-zd-asset-tree] details[open] > summary > svg:first-child {
+  transform: rotate(90deg);
+}
+
+[data-zd-asset-tree] details:not([open]) > summary > svg:nth-child(3),
+[data-zd-asset-tree] details[open] > summary > svg:nth-child(2) {
+  display: none;
+}

package/dist/frontmatter/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Frontmatter splitter — the package-owned replacement for `gray-matter`
+ * (zudolab/zudo-doc#3729).
+ *
+ * WHY THIS EXISTS: `gray-matter@4` parses YAML through `js-yaml@3`'s
+ * `safeLoad`, an API js-yaml 4 removed. That pinned every downstream consumer
+ * of this package to the 3.x line and forced them to carry a
+ * `js-yaml: ^3.15.1` override — narrow enough to keep gray-matter working,
+ * but a compatibility-constrained way to stay ahead of the advisories against
+ * older 3.x releases. Splitting the delimiters here and parsing the block with
+ * the maintained `yaml` package removes both from the dependency graph, so
+ * consumers can drop that override.
+ *
+ * Delimiter handling below is deliberately byte-for-byte gray-matter's, so
+ * existing content keeps parsing identically; each divergence is called out
+ * where it happens.
+ */
+export interface ParsedFrontmatter {
+    /**
+     * The parsed frontmatter block, `{}` when there is none.
+     *
+     * Typed as a record to match gray-matter's own declaration, but a YAML
+     * document whose root is a scalar or array passes through unchanged, exactly
+     * as gray-matter did — call sites that care guard with an `isRecord` check.
+     */
+    data: Record<string, unknown>;
+    /** Everything after the closing fence, with one leading CRLF/LF removed. */
+    content: string;
+}
+/**
+ * Split `input` into frontmatter data and body content.
+ *
+ * Throws when the block is present but unparseable, which is gray-matter's
+ * behavior too — callers that tolerate malformed files already wrap this.
+ */
+export declare function matter(input: string): ParsedFrontmatter;
+/**
+ * Rebuild a document from body content plus frontmatter data — the inverse of
+ * {@link matter}, and the one writer this package needs (`tags-suggest` writes
+ * approved tags back into a doc file).
+ *
+ * Matches gray-matter's `stringify`: empty data emits no fence at all, and the
+ * body always ends with a newline. The one deliberate difference is that long
+ * scalars are NOT folded. js-yaml's 80-column default reflowed unrelated
+ * frontmatter — a long `description:` came back as a `>-` block — which is
+ * needless churn in a file the tool is only meant to add tags to.
+ *
+ * `version: "1.1"` applies to SERIALIZATION ONLY (parsing above stays 1.2
+ * core) and reproduces js-yaml 3's quoting: a string that a YAML 1.1 reader
+ * would resolve to something else gets quoted. Without it `date: "2026-08-22"`
+ * would be rewritten unquoted and `tags: ["yes"]` as bare `yes` — the exact
+ * interop hazard `src/content/docs/guides/frontmatter.mdx` tells authors to
+ * avoid, silently introduced into every file `tags-suggest --apply` touches.
+ * `directives: false` keeps the `%YAML 1.1` header out of the emitted block.
+ */
+export declare function stringify(content: string, data: Record<string, unknown>): string;

package/dist/frontmatter/index.js

@@ -0,0 +1,61 @@
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+const OPEN = "---";
+const CLOSE = "\n---";
+const BOM = "\uFEFF";
+const COMMENT_LINES = /^\s*#[^\n]+/gm;
+function matter(input) {
+  const raw = input.startsWith(BOM) ? input.slice(BOM.length) : input;
+  if (!raw.startsWith(OPEN) || raw.charAt(OPEN.length) === "-") {
+    return { data: {}, content: raw };
+  }
+  let body = raw.slice(OPEN.length);
+  const firstBreak = body.search(/\r?\n/);
+  const rawLanguage = firstBreak === -1 ? body : body.slice(0, firstBreak);
+  const language = rawLanguage.trim().toLowerCase();
+  if (language) body = body.slice(rawLanguage.length);
+  let closeIndex = body.indexOf(CLOSE);
+  const unterminated = closeIndex === -1;
+  if (unterminated) closeIndex = body.length;
+  const block = body.slice(0, closeIndex).replace(/\r\n?/g, "\n");
+  let content;
+  if (unterminated) {
+    content = "";
+  } else {
+    content = body.slice(closeIndex + CLOSE.length);
+    if (content.startsWith("\r")) content = content.slice(1);
+    if (content.startsWith("\n")) content = content.slice(1);
+  }
+  if (block.replace(COMMENT_LINES, "").trim() === "") {
+    return { data: {}, content };
+  }
+  return { data: parseBlock(block, language), content };
+}
+function parseBlock(block, language) {
+  if (language === "json") {
+    return normalizeRoot(JSON.parse(block));
+  }
+  if (language !== "" && language !== "yaml" && language !== "yml") {
+    throw new Error(`Unsupported frontmatter language: "${language}"`);
+  }
+  return normalizeRoot(parseYaml(block, { merge: true }));
+}
+function normalizeRoot(value) {
+  return value ?? {};
+}
+function stringify(content, data) {
+  const block = stringifyYaml(data, {
+    lineWidth: 0,
+    version: "1.1",
+    directives: false
+  }).trim();
+  const fence = block === "{}" ? "" : `${OPEN}
+${block}
+${OPEN}
+`;
+  return fence + (content.endsWith("\n") ? content : `${content}
+`);
+}
+export {
+  matter,
+  stringify
+};

package/dist/header/header.js

@@ -11,6 +11,7 @@ import {
   NAV_CHEVRON_INACTIVE,
   NAV_CHILD_ACTIVE,
   NAV_CHILD_INACTIVE,
+  NAV_MORE_INACTIVE,
   NAV_TOP_ACTIVE,
   NAV_TOP_INACTIVE
 } from "./nav-class-tokens.js";
@@ -90,7 +91,16 @@ function Header(props) {
                   "button",
                   {
                     type: "button",
-                    class: "px-hsp-md py-vsp-2xs text-small font-medium text-muted hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline cursor-pointer",
+                    class: [
+                      "px-hsp-md",
+                      "py-vsp-2xs",
+                      "text-small",
+                      "font-medium",
+                      ...NAV_MORE_INACTIVE,
+                      "hover:underline",
+                      "focus-visible:underline",
+                      "cursor-pointer"
+                    ].join(" "),
                     "data-nav-more-toggle": true,
                     "aria-expanded": "false",
                     children: "\xB7\xB7\xB7"

package/dist/header/nav-class-tokens.d.ts

@@ -1,5 +1,7 @@
 export declare const NAV_TOP_ACTIVE: readonly string[];
 export declare const NAV_TOP_INACTIVE: readonly string[];
+export declare const NAV_MORE_ACTIVE: readonly string[];
+export declare const NAV_MORE_INACTIVE: readonly string[];
 export declare const NAV_CHEVRON_ACTIVE: readonly string[];
 export declare const NAV_CHEVRON_INACTIVE: readonly string[];
 export declare const NAV_CHILD_ACTIVE: readonly string[];

package/dist/header/nav-class-tokens.js

@@ -6,6 +6,12 @@ const NAV_TOP_INACTIVE = [
   "focus:underline",
   "focus:text-accent"
 ];
+const NAV_MORE_ACTIVE = [...NAV_TOP_ACTIVE];
+const NAV_MORE_INACTIVE = [
+  "text-muted",
+  "hover:text-accent",
+  "focus-visible:text-accent"
+];
 const NAV_CHEVRON_ACTIVE = ["text-bg"];
 const NAV_CHEVRON_INACTIVE = ["text-muted"];
 const NAV_CHILD_ACTIVE = ["font-bold", "text-accent"];
@@ -75,6 +81,8 @@ export {
   NAV_MENU_PARENT_ACTIVE_SUFFIX,
   NAV_MENU_PLAIN,
   NAV_MENU_PLAIN_ACTIVE_SUFFIX,
+  NAV_MORE_ACTIVE,
+  NAV_MORE_INACTIVE,
   NAV_TOP_ACTIVE,
   NAV_TOP_INACTIVE
 };

package/dist/header/nav-overflow-generated-script.js

@@ -141,8 +141,26 @@ function buildNavOverflowScript() {
     var moreToggle = document.querySelector("[data-nav-more-toggle]");
     if (!nav || !moreContainer || !moreMenu || !moreToggle) return;
 
+    function setMoreActive(active) {
+      if (active) {
+        moreToggle.classList.add("bg-fg", "text-bg");
+        moreToggle.classList.remove("text-muted", "hover:text-accent", "focus-visible:text-accent");
+      } else {
+        moreToggle.classList.add("text-muted", "hover:text-accent", "focus-visible:text-accent");
+        moreToggle.classList.remove("bg-fg", "text-bg");
+      }
+    }
+
+    // The persisted header can be re-initialized with a different nav shape.
+    // Clear a prior page's transferred active state even when there are no
+    // items and update() will not be installed (#3758).
+    setMoreActive(false);
+
     var items = Array.from(nav.querySelectorAll(":scope > [data-nav-item]"));
-    if (items.length === 0) return;
+    if (items.length === 0) {
+      moreContainer.style.display = "none";
+      return;
+    }
 
     var controller = new AbortController();
 
@@ -152,6 +170,7 @@ function buildNavOverflowScript() {
       moreMenu.innerHTML = "";
       moreMenu.classList.add("hidden");
       moreToggle.setAttribute("aria-expanded", "false");
+      setMoreActive(false);
 
       var itemWidths = items.map(function (el) { return el.offsetWidth; });
       var moreWidth = moreContainer.offsetWidth;
@@ -183,10 +202,21 @@ function buildNavOverflowScript() {
         cutoffIndex = i2 + 1;
       }
 
+      var hiddenHasActiveItem = false;
       for (var i3 = cutoffIndex; i3 < items.length; i3++) {
-        items[i3].style.display = "none";
+        var hiddenItem = items[i3];
+        hiddenItem.style.display = "none";
+        var hiddenTopLink = hiddenItem.hasAttribute("data-nav-item-dropdown")
+          ? hiddenItem.querySelector(":scope > a")
+          : hiddenItem;
+        var hiddenActiveChild = hiddenItem.querySelector(":scope > div a[data-active]");
+        if ((hiddenTopLink && hiddenTopLink.getAttribute("aria-current") === "page") || hiddenActiveChild) {
+          hiddenHasActiveItem = true;
+        }
       }
+      setMoreActive(hiddenHasActiveItem);
 
+      var currentCloneAssigned = false;
       for (var i4 = cutoffIndex; i4 < items.length; i4++) {
         var el = items[i4];
         var isDropdown = el.hasAttribute("data-nav-item-dropdown");
@@ -194,6 +224,9 @@ function buildNavOverflowScript() {
         if (isDropdown) {
           var parentLink = el.querySelector(":scope > a");
           var childLinks = el.querySelectorAll(":scope > div a");
+          var hasActiveChild = Array.from(childLinks).some(function (child) {
+            return child.hasAttribute("data-active");
+          });
           if (parentLink) {
             var li = document.createElement("li");
             var a = document.createElement("a");
@@ -203,6 +236,10 @@ function buildNavOverflowScript() {
             a.className = "block px-hsp-md py-vsp-2xs text-small font-bold hover:bg-accent/10 hover:underline focus-visible:underline focus-visible:text-accent text-fg hover:text-accent";
             if (parentLink.getAttribute("aria-current") === "page") {
               a.className += " text-accent";
+              if (!hasActiveChild && !currentCloneAssigned) {
+                a.setAttribute("aria-current", "page");
+                currentCloneAssigned = true;
+              }
             }
             li.appendChild(a);
             moreMenu.appendChild(li);
@@ -216,6 +253,10 @@ function buildNavOverflowScript() {
             a.className = isChildActive
               ? "block pl-hsp-xl pr-hsp-md py-vsp-2xs text-small font-bold text-accent hover:bg-accent/10 hover:underline focus-visible:underline"
               : "block pl-hsp-xl pr-hsp-md py-vsp-2xs text-small text-fg hover:bg-accent/10 hover:text-accent hover:underline focus-visible:underline focus-visible:text-accent";
+            if (isChildActive && !currentCloneAssigned) {
+              a.setAttribute("aria-current", "page");
+              currentCloneAssigned = true;
+            }
             li.appendChild(a);
             moreMenu.appendChild(li);
           });
@@ -228,6 +269,10 @@ function buildNavOverflowScript() {
           a2.className = "block px-hsp-md py-vsp-2xs text-small hover:bg-accent/10 hover:underline focus-visible:underline focus-visible:text-accent text-fg hover:text-accent";
           if (anchor.getAttribute("aria-current") === "page") {
             a2.className += " font-bold text-accent";
+            if (!currentCloneAssigned) {
+              a2.setAttribute("aria-current", "page");
+              currentCloneAssigned = true;
+            }
           }
           li2.appendChild(a2);
           moreMenu.appendChild(li2);

package/dist/header-with-defaults/index.d.ts

@@ -14,6 +14,8 @@ export interface HeaderWithDefaultsProps {
     currentSlug?: string;
     /** Header-nav category matcher used to scope the sidebar tree. */
     navSection?: string;
+    /** Omit the mobile sidebar toggle and its drawer landmark. */
+    hideSidebarToggle?: boolean;
 }
 /** Version config entry subset the factory reads. */
 export interface HeaderVersionEntry {

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

@@ -36,7 +36,8 @@ function createHeaderWithDefaults(ctx) {
       currentPath = "",
       currentVersion,
       currentSlug,
-      navSection
+      navSection,
+      hideSidebarToggle = false
     } = props;
     const lang = langProp;
     const rootMenuItems = buildRootMenuItems(lang, currentVersion);
@@ -44,7 +45,7 @@ function createHeaderWithDefaults(ctx) {
     const localeLinks = buildLocaleLinksForNav(currentPath, lang, locales.length);
     const themeDefaultMode = getThemeDefaultMode();
     const sidebarNodes = buildSidebarNodes(lang, navSection, currentVersion);
-    const sidebarToggle = Island({
+    const sidebarToggle = hideSidebarToggle ? false : Island({
       when: "visible",
       children: /* @__PURE__ */ jsx(
         SidebarToggle,

package/dist/i18n-defaults/index.d.ts

@@ -5,8 +5,9 @@
  * `src/config/i18n.ts` `translations` export (epic zudolab/zudo-doc#2651,
  * S4 #2654) so a generated project needs no i18n config file of its own.
  *
- * Locale code → key → translated string. Fully populated for `en`, `ja`, and
- * `de`; the other locales in the generator's `SUPPORTED_LANGS` list
+ * Locale code → key → translated string. The `en` and `ja` tables carry the
+ * complete package surface; `de` remains the documented partial locale. The
+ * other locales in the generator's `SUPPORTED_LANGS` list
  * (zh-cn/zh-tw/ko/es/fr/pt) fall back to `en` at lookup time (the template's
  * `t()` helper does `translations[locale]?.[key] ?? translations[defaultLocale]?.[key] ?? key`)
  * rather than shipping their own fully-translated table here.

package/dist/i18n-defaults/index.js

@@ -9,6 +9,7 @@ const defaultTranslations = {
     "nav.codex": "Codex",
     "nav.changelog": "Changelog",
     "nav.develop": "Develop",
+    "nav.assets": "Assets",
     "nav.previous": "Previous",
     "nav.next": "Next",
     "nav.overview": "Overview",
@@ -33,6 +34,27 @@ const defaultTranslations = {
     "doc.seeAllTags": "See all tags",
     "doc.created": "Created",
     "doc.updated": "Updated",
+    "asset.badge": "Asset",
+    "asset.crumb": "Assets",
+    "asset.indexBadge": "Index",
+    "asset.indexDescription": "Every file managed by the asset viewer. Open a file to see its viewer page, metadata, and the documents that reference it.",
+    "asset.fileCount": "{count} files",
+    "asset.fileCountSingle": "{count} file",
+    "asset.folderCount": "{count} folders",
+    "asset.folderCountSingle": "{count} folder",
+    "asset.expandAll": "Expand all",
+    "asset.collapseAll": "Collapse all",
+    "asset.indexEmpty": "No assets found.",
+    "asset.download": "Download",
+    "asset.copy": "Copy",
+    "asset.openRaw": "Open raw",
+    "asset.wrap": "Wrap",
+    "asset.lines": "{count} lines",
+    "asset.linkedFrom": "Linked from",
+    "asset.noPreview": "No preview is available for this file type. Download it and open it locally.",
+    "asset.viewFullFile": "View full file",
+    "asset.showingLines": "Showing {shown} of {total} lines",
+    "asset.truncated": "Preview truncated \u2014 download the file for the rest.",
     "doc.noTags": "No tags found.",
     "doc.pageCount": "{count} pages",
     "doc.pageCountSingle": "{count} page",
@@ -69,6 +91,7 @@ const defaultTranslations = {
     "nav.codex": "Codex",
     "nav.changelog": "\u5909\u66F4\u5C65\u6B74",
     "nav.develop": "\u958B\u767A",
+    "nav.assets": "\u30A2\u30BB\u30C3\u30C8",
     "nav.previous": "\u524D\u3078",
     "nav.next": "\u6B21\u3078",
     "nav.overview": "\u6982\u8981",
@@ -93,6 +116,27 @@ const defaultTranslations = {
     "doc.seeAllTags": "\u3059\u3079\u3066\u306E\u30BF\u30B0\u3092\u898B\u308B",
     "doc.created": "\u4F5C\u6210",
     "doc.updated": "\u66F4\u65B0",
+    "asset.badge": "\u30A2\u30BB\u30C3\u30C8",
+    "asset.crumb": "\u30A2\u30BB\u30C3\u30C8",
+    "asset.indexBadge": "\u30A4\u30F3\u30C7\u30C3\u30AF\u30B9",
+    "asset.indexDescription": "\u30A2\u30BB\u30C3\u30C8\u30D3\u30E5\u30FC\u30A2\u30FC\u3067\u7BA1\u7406\u3055\u308C\u3066\u3044\u308B\u3059\u3079\u3066\u306E\u30D5\u30A1\u30A4\u30EB\u3067\u3059\u3002\u30D5\u30A1\u30A4\u30EB\u3092\u958B\u304F\u3068\u3001\u30D7\u30EC\u30D3\u30E5\u30FC\u3001\u30E1\u30BF\u30C7\u30FC\u30BF\u3001\u53C2\u7167\u5143\u306E\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u78BA\u8A8D\u3067\u304D\u307E\u3059\u3002",
+    "asset.fileCount": "{count} \u30D5\u30A1\u30A4\u30EB",
+    "asset.fileCountSingle": "{count} \u30D5\u30A1\u30A4\u30EB",
+    "asset.folderCount": "{count} \u30D5\u30A9\u30EB\u30C0\u30FC",
+    "asset.folderCountSingle": "{count} \u30D5\u30A9\u30EB\u30C0\u30FC",
+    "asset.expandAll": "\u3059\u3079\u3066\u5C55\u958B",
+    "asset.collapseAll": "\u3059\u3079\u3066\u6298\u308A\u305F\u305F\u3080",
+    "asset.indexEmpty": "\u30A2\u30BB\u30C3\u30C8\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
+    "asset.download": "\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9",
+    "asset.copy": "\u30B3\u30D4\u30FC",
+    "asset.openRaw": "\u30D5\u30A1\u30A4\u30EB\u3092\u958B\u304F",
+    "asset.wrap": "\u6298\u308A\u8FD4\u3057",
+    "asset.lines": "{count} \u884C",
+    "asset.linkedFrom": "\u30EA\u30F3\u30AF\u5143",
+    "asset.noPreview": "\u3053\u306E\u30D5\u30A1\u30A4\u30EB\u5F62\u5F0F\u306F\u30D7\u30EC\u30D3\u30E5\u30FC\u3067\u304D\u307E\u305B\u3093\u3002\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u3057\u3066\u30ED\u30FC\u30AB\u30EB\u3067\u958B\u3044\u3066\u304F\u3060\u3055\u3044\u3002",
+    "asset.viewFullFile": "\u30D5\u30A1\u30A4\u30EB\u5168\u4F53\u3092\u898B\u308B",
+    "asset.showingLines": "{total} \u884C\u4E2D {shown} \u884C\u3092\u8868\u793A",
+    "asset.truncated": "\u30D7\u30EC\u30D3\u30E5\u30FC\u306F\u7701\u7565\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u5168\u4F53\u306F\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
     "doc.noTags": "\u30BF\u30B0\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
     "doc.pageCount": "{count}\u30DA\u30FC\u30B8",
     "doc.pageCountSingle": "{count}\u30DA\u30FC\u30B8",

package/dist/icons/index.d.ts

@@ -12,3 +12,12 @@ export declare function History({ className }: IconProps): VNode;
 export declare function Close({ className }: IconProps): VNode;
 export declare function ArrowLeft({ className }: IconProps): VNode;
 export declare function GitHub({ className }: IconProps): VNode;
+export declare function Folder({ className }: IconProps): VNode;
+export declare function FolderOpen({ className }: IconProps): VNode;
+export declare function FileGeneric({ className }: IconProps): VNode;
+export declare function FileCode({ className }: IconProps): VNode;
+export declare function FileText({ className }: IconProps): VNode;
+export declare function FileImage({ className }: IconProps): VNode;
+export declare function FileVideo({ className }: IconProps): VNode;
+export declare function FilePdf({ className }: IconProps): VNode;
+export declare function FileArchive({ className }: IconProps): VNode;