create-zudo-doc 3.2.0 → 4.0.0

package/README.md

@@ -72,7 +72,7 @@ Each feature has a `--[no-]<flag>` form. Passing `--feature` enables it; `--no-f
 | `--[no-]search` | Pagefind full-text search | on |
 | `--[no-]sidebar-filter` | Real-time sidebar filter | on |
 | `--[no-]image-enlarge` | Click-to-enlarge for oversized images | on |
-| `--[no-]tag-governance` | Vocabulary-aware tag audit + suggest scripts | on |
+| `--[no-]tag-governance` | Vocabulary-aware tag audit + suggest scripts | off |
 | `--[no-]claude-resources` | Auto-generate Claude Code docs (`CLAUDE.md`, `llms.txt`) | off |
 | `--[no-]claude-skills` | Ship zudo-doc Claude Code skills (design-system, translate, version-bump) | off |
 | `--[no-]design-token-panel` | Interactive panel for tweaking spacing, font, color tokens | off |
@@ -86,7 +86,8 @@ Each feature has a `--[no-]<flag>` form. Passing `--feature` enables it; `--no-f
 | `--[no-]tauri` | Tauri desktop app — Mode 1 offline reader | off |
 | `--[no-]tauri-dev` | Tauri dev wrapper — Mode 2 configurable dev wrapper | off |
 | `--[no-]footer-nav-group` | Navigation links in the footer | off |
-| `--[no-]footer-copyright` | Copyright notice in the footer | off |
+| `--[no-]dynamic-page-transition` | SPA-style page transition with history handling | on |
+| `--[no-]footer-copyright` | Copyright notice in the footer | on |
 | `--[no-]footer-taglist` | Grouped tag index in the footer (requires tag-governance) | off |
 | `--[no-]changelog` | Changelog page | off |
 

package/dist/api.d.ts

@@ -9,6 +9,8 @@ export interface CreateOptions {
     darkScheme?: string;
     respectPrefersColorScheme?: boolean;
     defaultMode?: "light" | "dark";
+    /** Theme pack slug (ADR #2818 Decision 7), validated against THEME_PACKS. Default: "default". */
+    themePack?: string;
     features: string[];
     /** GitHub repository URL — drives the header GitHub link and body-foot
      *  "View source on GitHub" link. Empty = disabled. */

package/dist/api.js

@@ -1,5 +1,5 @@
 import path from "path";
-import { SINGLE_SCHEMES } from "./constants.js";
+import { SINGLE_SCHEMES, THEME_PACKS } from "./constants.js";
 import { scaffold } from "./scaffold.js";
 import { initGitRepo, installDependencies, validateProjectName } from "./utils.js";
 export async function createZudoDoc(options) {
@@ -22,6 +22,14 @@ export async function createZudoDoc(options) {
             throw new Error(`Unknown ${label} "${value}"`);
         }
     }
+    // Validate the theme pack slug like the CLI (cli.ts) and preset (preset.ts)
+    // paths do (ADR #2818 Decision 7 / #2823 codex-review follow-up) — an
+    // unvalidated slug here would be written verbatim into zfb.config.ts and
+    // only fail when the generated site's build reaches plugin setup.
+    if (rest.themePack && !THEME_PACKS.some((t) => t.slug === rest.themePack)) {
+        const catalog = THEME_PACKS.map((t) => t.slug).join(", ");
+        throw new Error(`Unknown theme pack "${rest.themePack}". Available: ${catalog}`);
+    }
     const choices = { ...rest, defaultLang: rest.defaultLang ?? "en" };
     await scaffold(choices);
     const targetDir = path.resolve(process.cwd(), choices.projectName);

package/dist/claude-md-gen.d.ts

@@ -1,2 +1,10 @@
 import type { UserChoices } from "./prompts.js";
+/**
+ * Generate the per-project `CLAUDE.md` (minimal-scaffold shape, epic
+ * zudolab/zudo-doc#2651, Wave 6 #2660). Rewritten from scratch — the old
+ * generator described a 64-file project (`src/components/admonitions/`,
+ * `src/layouts/`, `src/utils/`, per-page `pages/lib/*` wiring) that no
+ * longer exists. The scaffolded project is now ~12 files; almost
+ * everything referenced here lives in `node_modules/@takazudo/zudo-doc`.
+ */
 export declare function generateCLAUDEFile(choices: UserChoices): string;

package/dist/claude-md-gen.js

@@ -1,53 +1,63 @@
-import { capitalize } from "./utils.js";
-function runCmd(pm, script) {
-    if (pm === "npm")
-        return `npm run ${script}`;
-    return `${pm} ${script}`;
-}
+import { capitalize, pmRunCommand } from "./utils.js";
+/**
+ * Generate the per-project `CLAUDE.md` (minimal-scaffold shape, epic
+ * zudolab/zudo-doc#2651, Wave 6 #2660). Rewritten from scratch — the old
+ * generator described a 64-file project (`src/components/admonitions/`,
+ * `src/layouts/`, `src/utils/`, per-page `pages/lib/*` wiring) that no
+ * longer exists. The scaffolded project is now ~12 files; almost
+ * everything referenced here lives in `node_modules/@takazudo/zudo-doc`.
+ */
 export function generateCLAUDEFile(choices) {
     const siteName = capitalize(choices.projectName.replace(/-/g, " "));
     const lines = [];
     lines.push(`# ${siteName}`);
     lines.push(``);
-    lines.push(`Documentation site built with [zudo-doc](https://github.com/zudolab/zudo-doc) — a zfb-based documentation framework with MDX, Tailwind CSS v4, and Preact islands.`);
+    lines.push(`Documentation site built with [zudo-doc](https://github.com/zudolab/zudo-doc) — a zfb-based documentation framework with MDX, Tailwind CSS v4, and Preact islands. This project is intentionally minimal: one config file (\`zfb.config.ts\`) plus markdown content — layout, chrome, and islands all ship from \`@takazudo/zudo-doc\` in \`node_modules\`.`);
     lines.push(``);
     // Tech stack
     lines.push(`## Tech Stack`);
     lines.push(``);
     lines.push(`- **zfb** — documentation build framework`);
-    lines.push(`- **MDX** — content format`);
+    lines.push(`- **MDX** — content format, authored under \`src/content/\``);
     lines.push(`- **Tailwind CSS v4** — via \`@tailwindcss/vite\``);
     lines.push(`- **Preact** — for interactive islands only (with compat mode for React API)`);
-    lines.push(`- **syntect** — built-in code highlighting, run by zfb's Rust pipeline at build time (single fixed theme: \`base16-ocean-dark\`)`);
+    lines.push(`- **Shiki** — package-owned code highlighting with the configured light/dark theme pair`);
+    lines.push(`- **@takazudo/zudo-doc** — the package that owns everything: layout, chrome, islands, default \`@theme\` design tokens, and (via \`packageOwnedRoutes\`, on by default) the doc routes themselves`);
     lines.push(``);
     // Commands
     lines.push(`## Commands`);
     lines.push(``);
     const pm = choices.packageManager;
-    lines.push(`- \`${runCmd(pm, "dev")}\` — zfb dev server (port 4321)`);
-    lines.push(`- \`${runCmd(pm, "build")}\` — static HTML export to \`dist/\``);
-    lines.push(`- \`${runCmd(pm, "check")}\` — TypeScript type checking`);
+    lines.push(`- \`${pmRunCommand(pm, "dev")}\` — zfb dev server (port 4321)`);
+    lines.push(`- \`${pmRunCommand(pm, "build")}\` — static HTML export to \`dist/\``);
+    lines.push(`- \`${pmRunCommand(pm, "check")}\` — TypeScript type checking`);
+    lines.push(`- \`${pmRunCommand(pm, "preview")}\` — serve the built \`dist/\``);
     lines.push(``);
     // Key directories
     lines.push(`## Key Directories`);
     lines.push(``);
     lines.push("```");
+    lines.push(`zfb.config.ts             # THE one config file — zudoDoc({ ...only fields you chose })`);
+    lines.push(`pages/`);
+    lines.push(`├── index.tsx             # 1-line re-export of the package home route`);
+    lines.push(`└── docs/[[...slug]].tsx  # self-contained doc-route stub (required for \`${pm} dev\`)`);
+    if (choices.features.includes("i18n")) {
+        lines.push(`  [locale]/docs/[[...slug]].tsx  # same, for non-default locales`);
+    }
     lines.push(`src/`);
-    lines.push(`├── components/          # JSX + Preact components`);
-    lines.push(`│   └── admonitions/     # Note, Tip, Info, Warning, Danger`);
-    lines.push(`├── config/              # Settings, color schemes`);
+    lines.push(`├── chrome-bindings.tsx   # optional typed primary chrome / named header / MDX bindings`);
     lines.push(`├── content/`);
-    lines.push(`│   └── docs/            # MDX content`);
+    lines.push(`│   └── docs/             # MDX content (this project's showcase docs)`);
     if (choices.features.includes("i18n")) {
         const secondaryLang = choices.defaultLang === "ja" ? "en" : "ja";
         lines.push(`│   └── docs-${secondaryLang}/         # ${secondaryLang === "ja" ? "Japanese" : "English"} MDX content (mirrors docs/)`);
     }
-    lines.push(`├── layouts/             # JSX layouts`);
-    lines.push(`├── pages/               # File-based routing`);
     lines.push(`└── styles/`);
-    lines.push(`    └── global.css       # Design tokens & Tailwind config`);
+    lines.push(`    └── global.css        # @import chain + a token-override slot — that's it`);
     lines.push("```");
     lines.push(``);
+    lines.push(`Everything else — layout, header, sidebar, footer, doc chrome, islands, and the default design tokens — lives in \`node_modules/@takazudo/zudo-doc\`. For supported markup replacement, create \`src/chrome-bindings.tsx\` with \`defineChromeBindings\`, set \`chromeBindingsModule\`, and use the primary \`Header\` / \`Footer\` / \`Sidebar\` / \`Toc\` / \`Breadcrumb\` / \`DocPager\` slots or the named \`headerRightComponents\` registry. The generated default, locale, and doc-history route shapes already consume the same binding object; do not fork a route stub for presentational customization. \`npx zudo-doc eject <component>\` only copies source: heed its primary, nested-chrome, or content-layer remediation before expecting the copy to render. Settings you didn't set explicitly in \`zfb.config.ts\` use the package's documented defaults — hover \`zudoDoc\`'s \`ZudoDocConfig\` argument in your editor to see every field and its \`@default\`.`);
+    lines.push(``);
     // Content conventions
     lines.push(`## Content Conventions`);
     lines.push(``);
@@ -59,18 +69,24 @@ export function generateCLAUDEFile(choices) {
     lines.push(``);
     lines.push(`### Admonitions`);
     lines.push(``);
-    lines.push(`Available in all MDX files without imports: \`<Note>\`, \`<Tip>\`, \`<Info>\`, \`<Warning>\`, \`<Danger>\``);
-    lines.push(`Each accepts an optional \`title\` prop.`);
+    lines.push(`Available in all MDX files without imports, via directive syntax: \`:::note\`, \`:::tip\`, \`:::info\`, \`:::warning\`, \`:::danger\`, \`:::caution\`, \`:::details\`. Each accepts an optional \`{title="..."}\` attribute.`);
     lines.push(``);
     lines.push(`### Headings`);
     lines.push(``);
     lines.push(`Do NOT use h1 (\`#\`) in doc content — the page title from frontmatter is rendered as h1. Start content headings from h2 (\`##\`).`);
     lines.push(``);
-    // Components
-    lines.push(`## Components`);
+    // Built-in MDX components. The seeded getting-started/index.mdx uses
+    // <CategoryNav>, a package-provided global — without this section a new user
+    // has no in-project pointer to what it is or which siblings exist (#2703).
+    lines.push(`### Built-in MDX components`);
+    lines.push(``);
+    lines.push(`\`@takazudo/zudo-doc\` ships a few **globally-available MDX components** — usable in any \`.mdx\` file with **no import**. The seeded \`getting-started/index.mdx\` already uses one:`);
+    lines.push(``);
+    lines.push(`- \`<CategoryNav category="..." />\` — a card-grid list of the pages in a docs category (this is the one seeded into \`getting-started/index.mdx\`).`);
+    lines.push(`- \`<CategoryTreeNav category="..." />\` — the same listing as a compact nested tree, better for deeper hierarchies.`);
+    lines.push(`- \`<SiteTreeNavDemo />\` — a full-site documentation tree (the MDX-available wrapper of the \`SiteTreeNav\` island).`);
     lines.push(``);
-    lines.push(`- Default to **server-rendered JSX components** (\`.tsx\`) — zero JS, server-rendered`);
-    lines.push(`- Use **Preact islands** (\`client:load\`) only when client-side interactivity is needed`);
+    lines.push(`Admonitions (above), tabbed content (\`<Tabs>\` / \`<TabItem>\`, \`<CodeGroup>\`), and block math (\`<MathBlock>\`) work the same way — no import. Full reference: https://zudo-doc.takazudomodular.com/docs/components/`);
     lines.push(``);
     // i18n section
     if (choices.features.includes("i18n")) {
@@ -82,12 +98,12 @@ export function generateCLAUDEFile(choices) {
         lines.push(`- ${defaultLabel} (default): \`/docs/...\` — content in \`src/content/docs/\``);
         lines.push(`- ${secondaryLabel}: \`/${secondaryLang}/docs/...\` — content in \`src/content/docs-${secondaryLang}/\``);
         lines.push(`- ${secondaryLabel} docs should mirror the ${defaultLabel} directory structure`);
+        lines.push(`- Both \`pages/docs/[[...slug]].tsx\` and \`pages/[locale]/docs/[[...slug]].tsx\` are self-contained doc-route stubs shipped by the generator — required so \`${pm} dev\` doesn't 404 on doc pages (a zfb dev-mode limitation on package-injected dynamic routes). Don't delete them.`);
         lines.push(``);
     }
     // Enabled features
     const featureDescriptions = {
         search: "Full-text search via Pagefind",
-        sidebarFilter: "Real-time sidebar filtering",
         designTokenPanel: "Interactive tabbed panel for tweaking spacing, font, size, and color tokens",
         sidebarResizer: "Draggable sidebar width",
         sidebarToggle: "Show/hide desktop sidebar",
@@ -96,6 +112,8 @@ export function generateCLAUDEFile(choices) {
         llmsTxt: "Generates llms.txt for LLM consumption",
         claudeResources: "Auto-generated docs for Claude Code resources",
         changelog: "Changelog page at `/docs/changelog`",
+        tauri: "Desktop app wrapper (`cargo tauri dev` / `cargo tauri build`) — Cmd/Ctrl+F find bar via the package-owned `FindInPageInit` island (`findInPage: true` in `zfb.config.ts`)",
+        tagGovernance: "Vocabulary-aware tag audit (`tags:audit`) / suggest (`tags:suggest`) scripts",
     };
     const enabledFeatures = choices.features.filter((f) => featureDescriptions[f] !== undefined &&
         f !== "footerNavGroup" &&

package/dist/cli.d.ts

@@ -7,6 +7,8 @@ export interface CliArgs {
     darkScheme?: string;
     defaultMode?: "light" | "dark";
     respectSystemPreference?: boolean;
+    /** Theme pack slug (ADR #2818 Decision 7). Validated against THEME_PACKS. */
+    themePack?: string;
     i18n?: boolean;
     search?: boolean;
     sidebarFilter?: boolean;

package/dist/cli.js

@@ -1,6 +1,6 @@
 import minimist from "minimist";
 import pc from "picocolors";
-import { FEATURES, SINGLE_SCHEMES, SUPPORTED_LANGS } from "./constants.js";
+import { FEATURES, SINGLE_SCHEMES, SUPPORTED_LANGS, THEME_PACKS } from "./constants.js";
 import { validateProjectName } from "./utils.js";
 export function parseArgs(argv = process.argv.slice(2)) {
     const raw = minimist(argv, {
@@ -12,6 +12,7 @@ export function parseArgs(argv = process.argv.slice(2)) {
             "light-scheme",
             "dark-scheme",
             "default-mode",
+            "theme-pack",
             "github-url",
             "preset",
             "pm",
@@ -49,6 +50,8 @@ export function parseArgs(argv = process.argv.slice(2)) {
         args.darkScheme = raw["dark-scheme"];
     if (raw["default-mode"])
         args.defaultMode = raw["default-mode"];
+    if (raw["theme-pack"])
+        args.themePack = raw["theme-pack"];
     if (raw.preset)
         args.preset = raw.preset;
     if (raw.pm)
@@ -77,6 +80,7 @@ export function parseArgs(argv = process.argv.slice(2)) {
 }
 export function printHelp() {
     const langList = SUPPORTED_LANGS.map((l) => l.value).join(", ");
+    const themePackList = THEME_PACKS.map((t) => t.slug).join(", ");
     const featureHelp = FEATURES.map((f) => `  --[no-]${f.cliFlag.padEnd(22)} ${f.hint}`).join("\n");
     console.log(`
 ${pc.bold("Usage:")} create-zudo-doc [project-name] [options]
@@ -92,6 +96,8 @@ ${pc.bold("Options:")}
   --default-mode <mode>        light | dark (light-dark mode)
   --[no-]respect-system-preference
                                Respect OS color scheme preference
+  --theme-pack <slug>          Theme pack (${themePackList})
+                               Default: default
 ${featureHelp}
   --github-url <url>           GitHub repository URL (drives header link + source link)
   --preset <path>              Load settings from a JSON preset file (use "-" for stdin)
@@ -135,6 +141,10 @@ export function validateArgs(args) {
     if (args.defaultMode && !["light", "dark"].includes(args.defaultMode)) {
         return `Invalid default-mode "${args.defaultMode}". Must be "light" or "dark"`;
     }
+    if (args.themePack && !THEME_PACKS.some((t) => t.slug === args.themePack)) {
+        const catalog = THEME_PACKS.map((t) => t.slug).join(", ");
+        return `Unknown theme pack "${args.themePack}". Available: ${catalog}`;
+    }
     if (args.pm && !["pnpm", "npm", "yarn", "bun"].includes(args.pm)) {
         return `Invalid package manager "${args.pm}". Must be pnpm, npm, yarn, or bun`;
     }

package/dist/compose.d.ts

@@ -68,27 +68,21 @@ export declare function resolveSelectedFeatures(choices: UserChoices, featureMod
  * Throws if a selected feature depends on one that isn't selected.
  */
 export declare function validateDependencies(features: FeatureDefinition[], allSelectedNames: Set<string>): void;
-/** Files that may contain injection anchors and need cleaning.
- *
- * The anchor targets today are:
- * - `global.css` — design-token-panel.ts injects
- *   `@import "@takazudo/zdtp/styles.css";` at `@slot:global-css:feature-styles`.
- *   The sibling `@slot:global-css:theme-tokens` anchor is consumed by the
- *   color-scheme palette generator and must remain.
- * - `pages/lib/_body-end-islands.tsx` — tauri.ts injects the FindInPageInit
- *   island (import, displayName, Island mount) when tauri is enabled.
- *   design-token-panel.ts injects the DesignTokenPanelBootstrap island
- *   (import, displayName, Island mount + toggle shim) when designTokenPanel
- *   is enabled.
- * - `src/config/settings-types.ts` — design-token-panel.ts injects the
- *   `"design-token-panel"` member into `HeaderRightTriggerName` when the
- *   feature is enabled (replace-range between the :start/:end anchors).
+/**
+ * Files that may contain injection anchors and need cleaning.
  *
- * NOTE: `pages/_mdx-components.ts` was removed (#2360 / E2). The imageEnlarge
- * p-override injections (ENLARGE_SVG, EnlargeableParagraph, p: entry) are now
- * handled inside the @takazudo/zudo-doc/mdx-components factory — the template
- * no longer carries @slot anchors for this file and the feature module's
- * injections are a no-op (the factory reads settings.imageEnlarge at render time).
+ * EMPTY as of the minimal-scaffold cutover (epic zudolab/zudo-doc#2651,
+ * Wave 6 #2660). Every anchor target this list used to name —
+ * `src/styles/global.css`'s `@slot:global-css:*` comments,
+ * `pages/lib/_body-end-islands.tsx`, `src/config/settings-types.ts` — is
+ * GONE from `templates/base/` (the package now owns chrome/islands/settings
+ * types entirely; see `templates/base/src/styles/global.css`'s fixed
+ * ~20-line `@import` chain). Feature modules are pure settings-field
+ * emission + genuine file copies now (see `src/features/*.ts`) — none of
+ * them call `applyInjections` with a real anchor anymore. The
+ * `Injection`/`applyInjections`/`cleanAnchors` machinery below is kept as
+ * infrastructure for a future feature that genuinely needs it (e.g. an
+ * eventual host-side extension point), not because anything uses it today.
  */
 export declare const ANCHOR_FILES: string[];
 /**

package/dist/compose.js

@@ -154,33 +154,23 @@ export function validateDependencies(features, allSelectedNames) {
         }
     }
 }
-/** Files that may contain injection anchors and need cleaning.
- *
- * The anchor targets today are:
- * - `global.css` — design-token-panel.ts injects
- *   `@import "@takazudo/zdtp/styles.css";` at `@slot:global-css:feature-styles`.
- *   The sibling `@slot:global-css:theme-tokens` anchor is consumed by the
- *   color-scheme palette generator and must remain.
- * - `pages/lib/_body-end-islands.tsx` — tauri.ts injects the FindInPageInit
- *   island (import, displayName, Island mount) when tauri is enabled.
- *   design-token-panel.ts injects the DesignTokenPanelBootstrap island
- *   (import, displayName, Island mount + toggle shim) when designTokenPanel
- *   is enabled.
- * - `src/config/settings-types.ts` — design-token-panel.ts injects the
- *   `"design-token-panel"` member into `HeaderRightTriggerName` when the
- *   feature is enabled (replace-range between the :start/:end anchors).
+/**
+ * Files that may contain injection anchors and need cleaning.
  *
- * NOTE: `pages/_mdx-components.ts` was removed (#2360 / E2). The imageEnlarge
- * p-override injections (ENLARGE_SVG, EnlargeableParagraph, p: entry) are now
- * handled inside the @takazudo/zudo-doc/mdx-components factory — the template
- * no longer carries @slot anchors for this file and the feature module's
- * injections are a no-op (the factory reads settings.imageEnlarge at render time).
+ * EMPTY as of the minimal-scaffold cutover (epic zudolab/zudo-doc#2651,
+ * Wave 6 #2660). Every anchor target this list used to name —
+ * `src/styles/global.css`'s `@slot:global-css:*` comments,
+ * `pages/lib/_body-end-islands.tsx`, `src/config/settings-types.ts` — is
+ * GONE from `templates/base/` (the package now owns chrome/islands/settings
+ * types entirely; see `templates/base/src/styles/global.css`'s fixed
+ * ~20-line `@import` chain). Feature modules are pure settings-field
+ * emission + genuine file copies now (see `src/features/*.ts`) — none of
+ * them call `applyInjections` with a real anchor anymore. The
+ * `Injection`/`applyInjections`/`cleanAnchors` machinery below is kept as
+ * infrastructure for a future feature that genuinely needs it (e.g. an
+ * eventual host-side extension point), not because anything uses it today.
  */
-export const ANCHOR_FILES = [
-    "src/styles/global.css",
-    "pages/lib/_body-end-islands.tsx",
-    "src/config/settings-types.ts",
-];
+export const ANCHOR_FILES = [];
 /**
  * Main composition entry point. Orchestrates the full feature composition
  * pipeline for a generated project.

package/dist/constants.d.ts

@@ -11,6 +11,12 @@ export interface SupportedLang {
     label: string;
 }
 export declare const SUPPORTED_LANGS: SupportedLang[];
+export interface ThemePackOption {
+    slug: string;
+    label: string;
+    hint: string;
+}
+export declare const THEME_PACKS: ThemePackOption[];
 export interface Feature {
     value: string;
     label: string;

package/dist/constants.js

@@ -18,6 +18,121 @@ export const SUPPORTED_LANGS = [
     { value: "de", label: "German" },
     { value: "pt", label: "Portuguese" },
 ];
+// Hand-kept mirror of the bundled theme-pack registry
+// (packages/zudo-doc/src/theme-packs/<slug>/meta.json — theme pack ADR
+// #2818, census landed by #2819, full catalog synced by the Finalize epic's
+// catalog-sync sub-issue #2855). Same convention as DEFAULT_MIRROR in
+// zfb-config-gen.ts: create-zudo-doc cannot import @takazudo/zudo-doc at
+// generator-build time, so the CLI/prompt catalog is a local copy. Order
+// mirrors the package's own default enablement order (resolveEnabledPacks):
+// "default" first, then the rest alphabetically by slug.
+export const THEME_PACKS = [
+    {
+        slug: "default",
+        label: "Default",
+        hint: "Stock zudo-doc look — no extra stylesheet loaded",
+    },
+    {
+        slug: "beacon",
+        label: "Beacon",
+        hint: "WCAG-AAA high contrast — 7:1+ ink, 3px focus rings, always-underlined links",
+    },
+    {
+        slug: "broadsheet",
+        label: "Broadsheet",
+        hint: "Newspaper editorial — Playfair masthead, Oxford ink rules, a red drop cap",
+    },
+    {
+        slug: "brutalist",
+        label: "Brutalist",
+        hint: "Raw concrete web — stark black on white, 4px slab borders, hazard-orange tape",
+    },
+    {
+        slug: "drift",
+        label: "Drift",
+        hint: "Floaty slate-blue comfort dark for long reading, relaxed Plex type",
+    },
+    {
+        slug: "fjord",
+        label: "Fjord",
+        hint: "Polar-night blue under a faint aurora — frost-cyan accents, icy borders",
+    },
+    {
+        slug: "foundry",
+        label: "Foundry",
+        hint: "GitHub-neutral baseline — white paper, Primer-blue accents",
+    },
+    {
+        slug: "futura-editorial",
+        label: "Futura Editorial",
+        hint: "Geometric Futura headings over Noto Sans body, one restrained red accent",
+    },
+    {
+        slug: "hearth",
+        label: "Hearth",
+        hint: "Warm cream & brick-red fireside docs — Fraunces headings, ember-glow dark mode",
+    },
+    {
+        slug: "hollow",
+        label: "Hollow",
+        hint: "Dark violet space — neon pink headings, violet links, a quiet starfield",
+    },
+    {
+        slug: "ledger",
+        label: "Ledger",
+        hint: "Cream academic serif in the Tufte tradition — warm paper, oxblood links",
+    },
+    {
+        slug: "manuscript",
+        label: "Manuscript",
+        hint: "A quiet Garamond book page — warm paper, soft ink, sepia rubrication",
+    },
+    {
+        slug: "matcha",
+        label: "Matcha",
+        hint: "Green tea ceremony — deep matcha on warm cream, mincho headings, zen whitespace",
+    },
+    {
+        slug: "nocturne",
+        label: "Nocturne",
+        hint: "Purple midnight — velvet aubergine depths, lavender links, muted gold hairlines",
+    },
+    {
+        slug: "observatory",
+        label: "Observatory",
+        hint: "Night-sky atlas — star-field depth, nebula violet and comet gold over navy",
+    },
+    {
+        slug: "onyx",
+        label: "Onyx",
+        hint: "Luxury noir — jet black, champagne serif headings, a single gold hairline accent",
+    },
+    {
+        slug: "phosphor",
+        label: "Phosphor",
+        hint: "Green CRT terminal — phosphor glow, scanlines, inverse-video nav",
+    },
+    {
+        slug: "solar",
+        label: "Solar",
+        hint: "Solarized precision — low-eyestrain paper tones, blue/cyan/orange accents",
+    },
+    {
+        slug: "sumi",
+        label: "Sumi",
+        hint: "Sumi-e ink on washi — bold mincho brush headings, one vermillion hanko seal accent",
+    },
+    {
+        slug: "swissgrid",
+        label: "Swissgrid",
+        hint: "International Typographic Style — grid discipline, one hot Swiss-red accent",
+    },
+    {
+        slug: "washi",
+        label: "Washi",
+        hint: "Warm washi paper, sumi ink, and ai-iro indigo seals for calm documentation",
+    },
+];
 export const FEATURES = [
     {
         value: "i18n",
@@ -61,6 +176,13 @@ export const FEATURES = [
         default: false,
         cliFlag: "design-token-panel",
     },
+    {
+        value: "themePackSwitcher",
+        label: "Theme pack switcher",
+        hint: "Bottom-right flyout to switch between installed theme packs",
+        default: false,
+        cliFlag: "theme-pack-switcher",
+    },
     {
         value: "sidebarResizer",
         label: "Sidebar resizer",
@@ -149,7 +271,7 @@ export const FEATURES = [
         value: "footerCopyright",
         label: "Footer copyright",
         hint: "Copyright notice in the footer",
-        default: false,
+        default: true,
         cliFlag: "footer-copyright",
     },
     {

package/dist/features/body-foot-util.d.ts

@@ -2,9 +2,13 @@ import type { FeatureModule } from "../compose.js";
 /**
  * body-foot-util feature.
  *
- * W7A (#1736): post-cutover, the body-foot-util area is hosted by
- * `pages/lib/_doc-history-area.tsx` which wraps `BodyFootUtilArea`
- * unconditionally. The component itself runtime-gates on
- * `settings.bodyFootUtilArea`, so there is nothing to inject.
+ * Purely a `zudoDoc({ bodyFootUtilArea: {...} })` field (see
+ * `zfb-config-gen.ts`) — `BodyFootUtilArea` is fully package-owned
+ * (`@takazudo/zudo-doc/body-foot-util`, wired through `doc-page-shell`) and
+ * runtime-gates on `settings.bodyFootUtilArea`. The old host thin-stub
+ * (`src/utils/github.ts`, which depended on the now-deleted
+ * `@/config/settings`) is gone too — the package component reads
+ * `settings.githubUrl` from the route context directly via
+ * `@takazudo/zudo-doc/github-helpers`. Nothing to inject or copy.
  */
 export declare const bodyFootUtilFeature: FeatureModule;

package/dist/features/body-foot-util.js

@@ -1,10 +1,14 @@
 /**
  * body-foot-util feature.
  *
- * W7A (#1736): post-cutover, the body-foot-util area is hosted by
- * `pages/lib/_doc-history-area.tsx` which wraps `BodyFootUtilArea`
- * unconditionally. The component itself runtime-gates on
- * `settings.bodyFootUtilArea`, so there is nothing to inject.
+ * Purely a `zudoDoc({ bodyFootUtilArea: {...} })` field (see
+ * `zfb-config-gen.ts`) — `BodyFootUtilArea` is fully package-owned
+ * (`@takazudo/zudo-doc/body-foot-util`, wired through `doc-page-shell`) and
+ * runtime-gates on `settings.bodyFootUtilArea`. The old host thin-stub
+ * (`src/utils/github.ts`, which depended on the now-deleted
+ * `@/config/settings`) is gone too — the package component reads
+ * `settings.githubUrl` from the route context directly via
+ * `@takazudo/zudo-doc/github-helpers`. Nothing to inject or copy.
  */
 export const bodyFootUtilFeature = () => ({
     name: "bodyFootUtil",

package/dist/features/claude-resources.d.ts

@@ -1,2 +1,11 @@
 import type { FeatureModule } from "../compose.js";
+/**
+ * Claude-resources feature.
+ *
+ * Fully plugin-owned (`@takazudo/zudo-doc/plugins/claude-resources`,
+ * `zudoDocPreset()` wires it whenever `settings.claudeResources` is
+ * truthy). Generation is package-owned. This feature's touch points are now
+ * just: `claudeResources` + `defaultLocaleOnlyPrefixes` fields
+ * (`zfb-config-gen.ts`).
+ */
 export declare const claudeResourcesFeature: FeatureModule;

package/dist/features/claude-resources.js

@@ -1,9 +1,13 @@
+/**
+ * Claude-resources feature.
+ *
+ * Fully plugin-owned (`@takazudo/zudo-doc/plugins/claude-resources`,
+ * `zudoDocPreset()` wires it whenever `settings.claudeResources` is
+ * truthy). Generation is package-owned. This feature's touch points are now
+ * just: `claudeResources` + `defaultLocaleOnlyPrefixes` fields
+ * (`zfb-config-gen.ts`).
+ */
 export const claudeResourcesFeature = () => ({
     name: "claudeResources",
-    injections: [
-    // No shared file injection needed — this feature's touch points are:
-    //   - plugin entry: zfb-config-gen.ts (claudeResources conditional import/plugin)
-    //   - settings: settings-gen.ts (claudeResources object + defaultLocaleOnlyPrefixes array)
-    //   - devDep: scaffold.ts (tsx devDep — same subprocess runner as docHistory)
-    ],
+    injections: [],
 });

package/dist/features/design-token-panel.d.ts

@@ -1,14 +1,2 @@
 import type { FeatureModule } from "../compose.js";
-/**
- * Design-token-panel (zdtp) feature.
- *
- * Injects:
- * 1. The zdtp CSS @import at `@slot:global-css:feature-styles` in
- *    `src/styles/global.css`.
- * 2. The DesignTokenPanelBootstrap import, displayName, and Island mount
- *    (with pre-hydration toggle shim) into
- *    `pages/lib/_body-end-islands.tsx` via the three @slot: anchors
- *    (imports / display-names / extra-islands). Mirrors the tauri feature
- *    injection shape (zudolab/zudo-doc#2162).
- */
 export declare const designTokenPanelFeature: FeatureModule;