@takazudo/zudo-doc 3.2.0 → 4.0.0

package/dist/theme.css

@@ -0,0 +1,319 @@
+/* ============================================================================
+ * @takazudo/zudo-doc — default design tokens + project-agnostic base rules
+ *
+ * Shipped to consumers as `@takazudo/zudo-doc/theme.css` (copied to
+ * `dist/theme.css` by scripts/copy-theme-css.mjs on build). Single source of
+ * truth for the default `@theme` token block (colors, spacing, icon sizes,
+ * elevation, typography, radius, breakpoints, z-index) plus the small set of
+ * project-agnostic base rules (scroll-margin, selection color, focus ring,
+ * search / find-in-page highlight, version-switcher visibility) every
+ * zudo-doc project needs. See zudolab/zudo-doc#2655.
+ *
+ * ── @import order (load-bearing) ────────────────────────────────────────────
+ * The consumer's global.css MUST import this file:
+ *   1. AFTER `@layer zd-preflight, zd-flow;` and the two Tailwind imports
+ *      (`tailwindcss/preflight` layer(zd-preflight), `tailwindcss/utilities`).
+ *      Those three lines stay project-side — path-relative `@source`/`@layer`
+ *      resolution requires them to live in the consumer's own CSS file (see
+ *      packages/create-zudo-doc/templates/base/src/styles/global.css).
+ *   2. BEFORE `@takazudo/zudo-doc/safelist.css`, `content.css`,
+ *      `page-loading.css`, and `features.css` — all four consume the
+ *      `@theme` tokens defined here (colors, spacing, typography, z-index),
+ *      and `content.css`'s `@layer zd-flow` rule depends on the cascade
+ *      layer order already being established by the time it loads.
+ *   3. BEFORE the project's own token-override `@theme { … }` block — Tailwind
+ *      v4 `@theme` resolution is last-declaration-wins per custom property,
+ *      so a later project block can redefine any default declared here.
+ *
+ * ── Consumer contract ────────────────────────────────────────────────────────
+ * The consumer must inject the `--zd-*` ramp/role custom properties this file
+ * aliases into `--color-*` tokens (`ColorSchemeProvider`, see
+ * `@takazudo/zudo-doc/theme`). Without them every `--color-*` token below
+ * resolves to nothing (the tight-token guardrail below wipes Tailwind's
+ * default palette; only `--zd-*`-backed aliases repopulate it).
+ *
+ * Deliberately NOT shipped here: `--color-page-loading-overlay`. That scrim
+ * token stays feature-injected by a project's `dynamicPageTransition` wiring
+ * (its default depends on `--color-overlay`, which IS defined below) — do
+ * not add it to this base block.
+ *
+ * ── Z-index defaults ─────────────────────────────────────────────────────────
+ * The 13 `--z-index-*` entries below are the package DEFAULT tiers (mirrors
+ * `defaultZIndexTiers` from `@takazudo/zudo-doc/z-index-defaults`, #2654).
+ * A project only needs its own `src/config/z-index-tokens.ts` +
+ * `gen:z-index`/`check:z-index` codegen wiring if it OVERRIDES a tier — its
+ * own `@theme` block (declared after this file's import) simply redefines
+ * the specific `--z-index-<name>` it wants to change.
+ * ============================================================================ */
+
+@theme {
+  /* ========================================
+   * Tight-token color reset
+   *
+   * Wipes all Tailwind default color tokens (`--color-*`) so only
+   * project-defined palette and semantic tokens remain. This enforces
+   * zudo-doc's tight-token policy: "NEVER use Tailwind default colors"
+   * (documented per-project in src/CLAUDE.md's Color Rules). Semantic color
+   * tokens (defined below) are added back after this reset.
+   *
+   * The upstream split-import fix (zfb#159 / 9e37551, shipped in f68a9ba)
+   * eliminated the original leak cause (zfb no longer prepends the full
+   * @import "tailwindcss" bundle). The reset is retained as an explicit
+   * design guardrail — it prevents accidental default palette bleed from any
+   * future upstream change and keeps the color surface intentional.
+   *
+   * NOT reset: `--spacing` (the base spacing scale, default 0.25rem).
+   * Tailwind spacing utilities compute as calc(var(--spacing) * N); wiping
+   * `--spacing` collapses them to zero (observed in Wave 4 Sub-7 #1403).
+   * This guardrail resets ONLY the color namespace — never widen it.
+   * ======================================== */
+  --color-*: initial;
+
+  /* ========================================
+   * Colors — Three-tier token system
+   * ======================================== */
+
+  /* ── Base ── */
+  --color-bg: var(--zd-bg);
+  --color-fg: var(--zd-fg);
+  --color-sel-bg: var(--zd-selection-bg);
+  --color-sel-fg: var(--zd-selection-fg);
+
+  /* ── Semantic aliases ── */
+  --color-surface: var(--zd-surface);
+  --color-muted: var(--zd-muted);
+  --color-accent: var(--zd-accent);
+  --color-accent-hover: var(--zd-accent-hover);
+  --color-code-bg: var(--zd-code-bg);
+  --color-code-fg: var(--zd-code-fg);
+  --color-success: var(--zd-success);
+  --color-danger: var(--zd-danger);
+  --color-warning: var(--zd-warning);
+  --color-info: var(--zd-info);
+  /* Overlay is intentionally theme-independent (always dark, not scheme-driven) */
+  --color-overlay: #000;
+  --color-image-overlay-bg: var(--zd-image-overlay-bg);
+  --color-image-overlay-fg: var(--zd-image-overlay-fg);
+  --color-chat-user-bg: var(--zd-chat-user-bg);
+  --color-chat-user-text: var(--zd-chat-user-text);
+  --color-chat-assistant-bg: var(--zd-chat-assistant-bg);
+  --color-chat-assistant-text: var(--zd-chat-assistant-text);
+  --color-matched-keyword-bg: var(--zd-matched-keyword-bg);
+  --color-matched-keyword-fg: var(--zd-matched-keyword-fg);
+
+  /* ========================================
+   * Spacing — hsp (horizontal) + vsp (vertical)
+   * ======================================== */
+  --spacing-0: 0;
+  --spacing-px: 1px;
+
+  /* Horizontal spacing (7 steps) */
+  --spacing-hsp-2xs: 0.125rem;   /* 2px  — tight inline */
+  --spacing-hsp-xs: 0.375rem;   /* 6px  — compact inline */
+  --spacing-hsp-sm: 0.5rem;     /* 8px  — small padding */
+  --spacing-hsp-md: 0.75rem;    /* 12px — default gaps */
+  --spacing-hsp-lg: 1rem;       /* 16px — standard padding */
+  --spacing-hsp-xl: 1.5rem;     /* 24px — generous padding */
+  --spacing-hsp-2xl: 2rem;      /* 32px — large padding */
+
+  /* Vertical spacing (8 steps) */
+  --spacing-vsp-3xs: 0.25rem;     /* 4px — hairline gap */
+  --spacing-vsp-2xs: 0.4375rem;   /* 7px — tight gap */
+  --spacing-vsp-xs: 0.875rem;    /* 14px — small gap */
+  --spacing-vsp-sm: 1.25rem;     /* 20px — compact gap */
+  --spacing-vsp-md: 1.5rem;      /* 24px — standard gap */
+  --spacing-vsp-lg: 1.75rem;     /* 28px — section gap */
+  --spacing-vsp-xl: 2.5rem;      /* 40px — large section gap */
+  --spacing-vsp-2xl: 3.5rem;     /* 56px — page-level gap */
+
+  /* ========================================
+   * Element sizes — semantic icon dimensions
+   * ======================================== */
+  --spacing-icon-xs: 0.75rem;    /* 12px — inline meta icons, chevrons */
+  --spacing-icon-sm: 1rem;       /* 16px — standard UI icons */
+  --spacing-icon-md: 1.25rem;    /* 20px — medium emphasis icons */
+  --spacing-icon-lg: 1.5rem;     /* 24px — large / mobile icons */
+
+  /* Image overlay button chrome */
+  --spacing-image-overlay-inset: 0.5rem;  /* 8px — overlay button corner inset + internal padding */
+
+  /* ========================================
+   * Elevation — the tight `@import "tailwindcss/utilities"` (no default
+   * @theme) drops Tailwind's default shadow scale, so `shadow-*` utilities
+   * generate nothing. Re-add the one elevation the components use: header
+   * and version-switcher dropdown panels apply `shadow-lg`. Value is
+   * Tailwind v4's default shadow-lg; the black is intentionally
+   * theme-independent (a drop shadow is absence of light, not a themed color).
+   * ======================================== */
+  --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+
+  /* ========================================
+   * Typography
+   * ======================================== */
+
+  /* ── Tier 2: Semantic font-size tokens (reference Tier 1 scale only) ── */
+  --text-micro:      var(--text-scale-2xs);  /* 12px — compact panel labels, color swatch annotations */
+  --text-caption:    var(--text-scale-xs);   /* labels, timestamps */
+  --text-small:      var(--text-scale-sm);   /* secondary text, nav items */
+  --text-body:       var(--text-scale-md);   /* paragraphs, default */
+  --text-title:      var(--text-scale-lg);   /* card titles, section labels */
+  --text-heading:    var(--text-scale-xl);   /* page headings */
+  --text-display:    var(--text-scale-2xl);  /* hero text */
+
+  /* Font families */
+  --font-sans: system-ui, sans-serif;
+  --font-mono: ui-monospace, monospace;
+
+  /* Font weights (4 steps) */
+  --font-weight-normal: 400;
+  --font-weight-medium: 500;
+  --font-weight-semibold: 600;
+  --font-weight-bold: 700;
+
+  /* Line heights (4 steps) */
+  --leading-tight: 1.25;
+  --leading-snug: 1.375;
+  --leading-normal: 1.5;
+  --leading-relaxed: 1.625;
+
+  /* Letter spacing / tracking (4 steps) */
+  --tracking-tight: -0.025em;   /* headings, display text */
+  --tracking-normal: normal;    /* browser default — resets any inherited tracking */
+  --tracking-wide: 0.05em;      /* labels, UI text */
+  --tracking-wider: 0.1em;      /* small caps, decorative */
+
+  /* ========================================
+   * Border radius (3 steps)
+   * ======================================== */
+  --radius-DEFAULT: 0.25rem;    /* 4px — rounded */
+  --radius-lg: 0.5rem;          /* 8px — rounded-lg */
+  --radius-full: 9999px;        /* rounded-full */
+
+  /* ========================================
+   * Breakpoints (3 steps)
+   * ======================================== */
+  --breakpoint-sm: 640px;
+  --breakpoint-lg: 1024px;
+  --breakpoint-xl: 1280px;
+}
+
+/* ========================================
+ * Z-index tiers — semantic, single-namespace default scale.
+ *
+ * The 13 tokens below are the package DEFAULTS (mirrors defaultZIndexTiers
+ * from @takazudo/zudo-doc/z-index-defaults, #2654). Tailwind v4 reads each
+ * --z-index-<name> theme key and generates a `z-<name>` utility, so e.g.
+ * --z-index-toolbar: 20 produces `.z-toolbar { z-index: 20 }`; raw CSS can
+ * also reference `z-index: var(--z-index-<name>)`.
+ *
+ * A project only needs its own src/config/z-index-tokens.ts +
+ * gen:z-index/check:z-index codegen if it OVERRIDES a tier — the
+ * GENERATED:Z_INDEX block that used to live in every project's global.css is
+ * now opt-in customization only, not a mandatory per-project artifact.
+ * ======================================== */
+@theme {
+  --z-index-content: 0;
+  --z-index-local-1: 1;
+  --z-index-local-2: 2;
+  --z-index-local-3: 3;
+  --z-index-sidebar: 10;
+  --z-index-toolbar: 20;
+  --z-index-dropdown: 30;
+  --z-index-popover: 40;
+  --z-index-modal-backdrop: 50;
+  --z-index-modal: 60;
+  --z-index-toast: 70;
+  --z-index-tooltip: 80;
+  --z-index-drag: 90;
+}
+
+:root {
+  /* Default responsive range; sidebar-resizer.ts allows 192–448px for explicit resizing. */
+  --zd-sidebar-w: clamp(14rem, 20vw, 22rem);
+
+  /* ── Tier 1: Abstract font-size scale (raw values — NOT for direct component use) ── */
+  /* Used only as a source of truth for Tier 2 semantic tokens above. */
+  --text-scale-2xs: 0.75rem;    /* 12px */
+  --text-scale-xs:  0.875rem;   /* 14px */
+  --text-scale-sm:  1rem;       /* 16px */
+  --text-scale-md:  1.2rem;     /* 19.2px */
+  --text-scale-lg:  1.4rem;     /* 22.4px */
+  --text-scale-xl:  3rem;       /* 48px */
+  --text-scale-2xl: 3.75rem;    /* 60px */
+
+  --default-transition-duration: 150ms; /* consumed by image-enlarge and hash-link opacity fade */
+  --zd-transition-slow: 200ms;          /* sidebar transform/visibility and content-band max-width */
+  --zd-transition-slower: 300ms;        /* view-transition fade-in (contentFadeIn animation) */
+  --zd-header-h: 80px;                  /* sticky header height; consumed by scroll-margin-top on [id] anchors */
+}
+
+/* ========================================
+ * Base styles
+ * ======================================== */
+
+[id] {
+  scroll-margin-top: var(--zd-header-h);
+}
+
+body {
+  background-color: var(--color-bg);
+  color: var(--color-fg);
+}
+
+::selection {
+  background-color: var(--color-sel-bg);
+  color: var(--color-sel-fg);
+}
+
+@layer base {
+  a {
+    text-underline-offset: 4px;
+  }
+  button {
+    cursor: pointer;
+  }
+  :focus-visible {
+    outline: 2px solid var(--color-accent);
+    outline-offset: 2px;
+  }
+}
+
+/* ── Search highlight ── */
+[data-search-results] mark {
+  background-color: var(--color-matched-keyword-bg);
+  color: var(--color-matched-keyword-fg);
+  padding: 0;
+  border-radius: 2px;
+}
+
+/* Version-switcher responsive visibility (was an inline <style> child of
+ * the data-version-switcher <div>; moved to global.css to avoid the
+ * <style>-inside-<div> HTML5 content-model violation flagged by
+ * html-validate — see zudolab/zudo-doc#1505).
+ *
+ * Pins onto the `.hidden` baseline that Tailwind always generates so
+ * consumers wrapping <VersionSwitcher> in `<div class="hidden lg:block">`
+ * still get the desktop override even when the content scanner did not
+ * generate `.lg:block`. Mobile (<64rem) falls through to `.hidden`'s
+ * `display: none`. Inert when no version-switcher is on the page. */
+@media (min-width: 64rem) {
+  .hidden:has(> [data-version-switcher]) {
+    display: block;
+  }
+}
+
+/* ── Find-in-page highlight ── */
+/* Deliberate ephemeral-vs-persistent split: find-in-page uses color-mix(warning)
+ * because it is a transient browser-controlled overlay that appears and disappears
+ * without page navigation. Search results use --color-matched-keyword-bg/fg because
+ * they are persistent semantic highlights tied to the current query state.
+ * Do NOT unify these two highlight strategies — the visual distinction is intentional. */
+.find-match {
+  background-color: color-mix(in oklch, var(--color-warning) 40%, transparent);
+  border-radius: 2px;
+}
+.find-match-active {
+  background-color: color-mix(in oklch, var(--color-warning) 70%, transparent);
+  border-radius: 2px;
+  outline: 2px solid color-mix(in oklch, var(--color-warning) 90%, transparent);
+}

package/dist/versions-page/index.d.ts

@@ -22,11 +22,11 @@ export interface VersionsPageComponents {
         title: string;
     }) => JSX.Element;
     HeaderWithDefaults: (props: {
-        lang?: string;
+        lang: string;
         currentPath?: string;
     }) => JSX.Element;
     FooterWithDefaults: (props: {
-        lang?: string;
+        lang: string;
     }) => JSX.Element;
     BodyEndIslands: (props: {
         basePath: string;

package/dist/versions-page/index.js

@@ -2,9 +2,9 @@ import { Fragment, jsx } from "preact/jsx-runtime";
 import { DocLayoutWithDefaults } from "../doclayout/index.js";
 import { VersionsPageContent } from "../nav-indexing/index.js";
 import { createHeadWithDefaults } from "../head-with-defaults/index.js";
-import { createHeaderWithDefaults } from "../header-with-defaults/index.js";
-import { createFooterWithDefaults } from "../footer-with-defaults/index.js";
+import { resolveThemePackSsrSlug } from "../theme/theme-pack-provider.js";
 import { deriveComposeMetaTitle, deriveBodyEndIslands } from "../chrome/derive.js";
+import { derivePrimaryChromeSlots } from "../chrome/primary-slots.js";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";
 function createVersionsPageView(ctx) {
   assertChromeContext(ctx, "createVersionsPageView");
@@ -14,13 +14,12 @@ function createVersionsPageView(ctx) {
   const withBase = ctx.withBase;
   const composeMetaTitle = deriveComposeMetaTitle(ctx);
   const HeadWithDefaults = createHeadWithDefaults(ctx);
-  const HeaderWithDefaults = createHeaderWithDefaults(
-    ctx
-  );
-  const FooterWithDefaults = createFooterWithDefaults(
-    ctx
-  );
+  const { Header: HeaderWithDefaults, Footer: FooterWithDefaults } = derivePrimaryChromeSlots(ctx);
   const BodyEndIslands = deriveBodyEndIslands(ctx);
+  const dataThemePack = resolveThemePackSsrSlug(
+    ctx.themePackRegistry,
+    ctx.settings
+  );
   function VersionsPageView({ locale }) {
     const isDefault = locale === defaultLocale;
     const prefix = isDefault ? "" : `/${locale}`;
@@ -53,6 +52,7 @@ function createVersionsPageView(ctx) {
         title: composeMetaTitle(pageTitle),
         head: /* @__PURE__ */ jsx(HeadWithDefaults, { title: pageTitle }),
         lang: locale,
+        dataThemePack,
         noindex: settings.noindex,
         hideSidebar: true,
         hideToc: true,

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

@@ -0,0 +1,45 @@
+/**
+ * Default z-index tiers — 13 tiers, `content` (0) through `drag` (90).
+ *
+ * Ported from the `create-zudo-doc` base template's
+ * `src/config/z-index-tokens.ts` `Z_INDEX_TIERS` export (epic
+ * zudolab/zudo-doc#2651, S4 #2654). Consumed by the theme-CSS default
+ * (#2655) for the shipped `@theme` z-index block; a project's own
+ * `gen-z-index` codegen (from `@takazudo/zudo-doc`'s `gen-z-index` bin)
+ * becomes opt-in customization on top of this default rather than the only
+ * source.
+ *
+ * Only `name`/`value` are carried in the exported shape — `purpose`/`kind`
+ * were documentation-only in the template and are preserved below as source
+ * comments instead.
+ *
+ * Strategy (from zudolab/zudo-css-wisdom z-index-strategy): semantic single-
+ * namespace tokens — names describe ROLES, never magnitudes. One flat ordered
+ * list. Values are deliberately gapped but otherwise arbitrary: renaming and
+ * reordering is cheap, which is the whole point. Tailwind v4 reads the
+ * `--z-index-<name>` theme key and generates a `z-<name>` utility, so e.g.
+ * `@theme { --z-index-toolbar: 20 }` produces `.z-toolbar { z-index: 20 }`.
+ *
+ * `local-1`/`local-2`/`local-3` ("local" kind in the template) are anonymous
+ * reusable helpers for promoting a child WITHIN a parent stacking context
+ * (`isolation: isolate` / `position: relative`), not a position on the
+ * global stacking scale. Every other tier is "global".
+ *
+ * Rationale for the two zudo-doc-specific additions (NOT in the generic
+ * overlay-centric strategy scale):
+ *   - `sidebar` — persistent layout chrome (desktop sidebar, TOC, sidebar-toggle
+ *     handle, resizer handle). The strategy's scale has no persistent-sidebar/TOC
+ *     tier. `toolbar` (the sticky header) is deliberately placed ABOVE `sidebar`
+ *     to preserve the existing header-wins ordering; they do not overlap
+ *     spatially, but the historical relationship is kept explicit.
+ *   - `drag` — transient drag affordance (sidebar-resizer ghost line). Replaces
+ *     the old `z-9999` anti-pattern with a named top-of-steady-UI tier.
+ *
+ * `popover`, `toast`, and `tooltip` are reserved canonical tiers from the
+ * strategy's scale — kept for completeness (and so downstream `create-zudo-doc`
+ * users inherit the full scale) even though zudo-doc does not use them yet.
+ */
+export declare const defaultZIndexTiers: ReadonlyArray<{
+    name: string;
+    value: number;
+}>;

package/dist/z-index-defaults/index.js

@@ -0,0 +1,34 @@
+const defaultZIndexTiers = [
+  // global — default in-flow content (implicit baseline)
+  { name: "content", value: 0 },
+  // local — child promotion inside an isolated parent stacking context
+  { name: "local-1", value: 1 },
+  // local — child promotion inside an isolated parent stacking context
+  { name: "local-2", value: 2 },
+  // local — child promotion inside an isolated parent stacking context
+  { name: "local-3", value: 3 },
+  // global — persistent layout chrome: desktop sidebar, TOC, sidebar-toggle
+  // handle, resizer handle
+  { name: "sidebar", value: 10 },
+  // global — sticky top header (sits above sidebar chrome)
+  { name: "toolbar", value: 20 },
+  // global — header menus, version/language switchers
+  { name: "dropdown", value: 30 },
+  // global — reserved: inline popovers (canonical scale; not yet used)
+  { name: "popover", value: 40 },
+  // global — mobile drawer backdrop, <dialog> ::backdrop
+  { name: "modal-backdrop", value: 50 },
+  // global — mobile sidebar drawer panel, search <dialog>
+  { name: "modal", value: 60 },
+  // global — reserved: transient notifications (canonical scale; not yet used)
+  { name: "toast", value: 70 },
+  // global — reserved: highest steady UI layer, below only the transient drag
+  // tier (canonical scale; not yet used)
+  { name: "tooltip", value: 80 },
+  // global — transient drag affordance: sidebar-resizer ghost line (replaces
+  // the z-9999 anti-pattern)
+  { name: "drag", value: 90 }
+];
+export {
+  defaultZIndexTiers
+};

package/eject/breadcrumb/breadcrumb.tsx

@@ -3,7 +3,7 @@
 
 import type { ComponentChildren, VNode } from "preact";
 import { findPath } from "./find-path.js";
-import type { BreadcrumbItem, SidebarNode } from "./types.js";
+import type { BreadcrumbItem, BreadcrumbNode } from "./types.js";
 import { ChevronRight } from "../icons/index.js";
 
 /**
@@ -18,7 +18,7 @@ import { ChevronRight } from "../icons/index.js";
  * with the original Astro breadcrumb component.
  */
 export function buildBreadcrumbItems(
-  tree: SidebarNode[],
+  tree: BreadcrumbNode[],
   currentId: string,
   homeHref: string,
 ): BreadcrumbItem[] {
@@ -111,8 +111,8 @@ export interface BreadcrumbProps {
   /** Pre-built items, or omit and pass `tree` + `currentId` instead. */
   items?: BreadcrumbItem[];
   /** Sidebar tree to derive the trail from. Required when `items` is omitted. */
-  tree?: SidebarNode[];
-  /** Id of the current page (matches SidebarNode.id). Required when `items` is omitted. */
+  tree?: BreadcrumbNode[];
+  /** Id of the current page (matches BreadcrumbNode.id). Required when `items` is omitted. */
   currentId?: string;
   /** Href for the leading home rung. Defaults to "/". */
   homeHref?: string;

package/eject/breadcrumb/find-path.ts

@@ -1,4 +1,4 @@
-import type { BreadcrumbNode, SidebarNode } from "./types.js";
+import type { BreadcrumbNode } from "./types.js";
 
 /**
  * Walk the sidebar tree and return the chain of nodes from the root
@@ -11,7 +11,7 @@ import type { BreadcrumbNode, SidebarNode } from "./types.js";
  * ancestry. The home/root crumb is the renderer's responsibility — this
  * helper deals strictly with the tree itself.
  */
-export function findPath<T extends BreadcrumbNode = SidebarNode>(
+export function findPath<T extends BreadcrumbNode = BreadcrumbNode>(
   nodes: readonly T[],
   targetId: string,
 ): T[] {

package/eject/breadcrumb/index.ts

@@ -1,4 +1,4 @@
 export { Breadcrumb, buildBreadcrumbItems } from "./breadcrumb.js";
 export type { BreadcrumbProps } from "./breadcrumb.js";
 export { findPath } from "./find-path.js";
-export type { BreadcrumbItem, SidebarNode } from "./types.js";
+export type { BreadcrumbItem, BreadcrumbNode } from "./types.js";

package/eject/breadcrumb/types.ts

@@ -16,12 +16,6 @@ export interface BreadcrumbNode {
   children?: readonly BreadcrumbNode[];
 }
 
-/**
- * Backward-compatible alias retained for callers that previously imported
- * `SidebarNode` from this subpath.
- */
-export type SidebarNode = BreadcrumbNode;
-
 /**
  * One rung of the breadcrumb trail. `href` is omitted on the final
  * (current-page) item so the renderer can present it as plain text.

package/eject/code-group/index.tsx

@@ -14,8 +14,8 @@
 // component zips the `tabs` label array with the `<pre data-lang>` children
 // by index, wrapping each in a <TabItem> with the matching label.
 //
-// Code inside each <pre> is raw text (NOT syntect-highlighted — the Rust
-// pipeline does not run highlight inside code-group fences). We render
+// Code inside each <pre> is raw text (the class-mode highlighting pipeline
+// does not run inside code-group fences). We render
 // the <pre> inside a <TabItem> with explicit styling via Tailwind tokens
 // so it looks like a code block visually.
 //

package/eject/doc-history/index.tsx

@@ -460,7 +460,7 @@ export function DocHistory({ slug, locale, basePath = "/" }: DocHistoryProps) {
   // under "index" (an empty path segment is unroutable — the server regex
   // /^\/doc-history\/(.+)\.json$/ rejects ""). The host wrapper already passes
   // the sentineled slug, but defend the boundary so the component is correct
-  // for any caller. Mirrors `toHistorySlug` in @/utils/slug (inlined here
+  // for any caller. Mirrors `toHistorySlug` in @takazudo/zudo-doc/slug (inlined here
   // rather than imported to keep this bundled island free of host-util
   // coupling — see .template-drift-allowlist). (#1891)
   const historySlug = slug === "" ? "index" : slug;

package/eject/doc-pager/index.tsx

@@ -50,7 +50,7 @@ export function createDocPager<S extends Settings = Settings>(
    */
   function DocPager({ prev, next, locale }: DocPagerProps): JSX.Element {
     return (
-      <nav class="mt-vsp-2xl grid grid-cols-2 gap-hsp-xl">
+      <nav class="mt-vsp-2xl grid grid-cols-2 gap-hsp-xl" data-doc-pager>
         {prev ? (
           <a
             href={prev.href}

package/eject/footer/footer.tsx

@@ -87,6 +87,7 @@ export function Footer(props: FooterProps): VNode {
   return (
     <footer
       class="border-t border-muted bg-surface"
+      data-footer
       // Strategy B: locale-keyed persist (zudolab/zudo-doc#1546).
       // The footer's locale-aware bits (link labels, copyright) are SSR'd
       // per locale; a locale-keyed persist key (`footer-en`, `footer-ja`)