@takazudo/zudo-doc 3.3.0 → 4.1.0

package/dist/locale-merge/index.d.ts

@@ -1,12 +1,11 @@
 /**
  * Minimal structural interface for a docs entry.
  *
- * Structurally compatible with the host's `DocsEntry` from
- * `@/types/docs-entry`. Callers pass their concrete entry arrays and
- * TypeScript's structural typing ensures compatibility.
+ * Structurally compatible with a current zfb collection entry. Callers pass
+ * concrete entry arrays and TypeScript preserves the subtype in the result.
  */
 export interface MergeDocsEntry {
-    id: string;
+    slug: string;
     data: {
         slug?: string;
         unlisted?: boolean;
@@ -58,13 +57,10 @@ export interface MergeLocaleDocsOptions<T extends MergeDocsEntry = MergeDocsEntr
      * Only called when `applyDefaultLocaleOnlyFilter` is true. The host stub
      * passes `isDefaultLocaleOnlyPath` from `@/utils/base`.
      *
-     * When omitted (or when `applyDefaultLocaleOnlyFilter` is false), no path
-     * filtering is applied.
-     *
-     * Example: host passes `(path) => isDefaultLocaleOnlyPath(path)` where
-     * `isDefaultLocaleOnlyPath` is from `src/utils/base.ts`.
+     * Required explicitly so the merge never silently omits the current
+     * default-locale-only path contract.
      */
-    isDefaultLocaleOnlyPath?: (path: string) => boolean;
+    isDefaultLocaleOnlyPath: (path: string) => boolean;
 }
 /**
  * Result of mergeLocaleDocs.
@@ -103,10 +99,9 @@ export interface MergeLocaleDocsResult<T extends MergeDocsEntry = MergeDocsEntry
  * Locale docs take priority; base docs fill in slugs not covered by the locale
  * collection. Optionally excludes default-locale-only paths and/or unlisted pages.
  *
- * **Slug keying**: slug identity uses `d.data.slug ?? d.id`. Since `loadDocs`
- * already strips the `/index` suffix (via `stripIndexSuffix` in `pages/_data.ts`),
- * this key is consistent across all call sites regardless of whether they
- * loaded docs via `loadDocs` or `bridgeEntries`.
+ * **Slug keying**: slug identity uses the explicit frontmatter override or
+ * the canonical route form of the current zfb `entry.slug`. This preserves
+ * root `index` and nested index-page behavior without mutating the entries.
  *
  * **Array identity**: returns a fresh array on each call — see
  * {@link MergeLocaleDocsResult} for caching guidance.

package/dist/locale-merge/index.js

@@ -1,3 +1,4 @@
+import { toRouteSlug } from "../slug/index.js";
 function mergeLocaleDocs(options) {
   const {
     baseDocs,
@@ -8,13 +9,14 @@ function mergeLocaleDocs(options) {
   } = options;
   const filteredLocale = keepUnlisted ? localeDocs : localeDocs.filter((d) => !d.data.unlisted);
   const filteredBase = keepUnlisted ? baseDocs : baseDocs.filter((d) => !d.data.unlisted);
-  const localeSlugSet = new Set(filteredLocale.map((d) => d.data.slug ?? d.id));
+  const routeSlug = (entry) => entry.data.slug ?? toRouteSlug(entry.slug);
+  const localeSlugSet = new Set(filteredLocale.map(routeSlug));
   let fallbackDocs = filteredBase.filter(
-    (d) => !localeSlugSet.has(d.data.slug ?? d.id)
+    (entry) => !localeSlugSet.has(routeSlug(entry))
   );
-  if (applyDefaultLocaleOnlyFilter && isDefaultLocaleOnlyPath) {
+  if (applyDefaultLocaleOnlyFilter) {
     fallbackDocs = fallbackDocs.filter(
-      (d) => !isDefaultLocaleOnlyPath(`/docs/${d.data.slug ?? d.id}`)
+      (entry) => !isDefaultLocaleOnlyPath("/docs/" + routeSlug(entry))
     );
   }
   return {

package/dist/mdx-components/index.js

@@ -1,5 +1,5 @@
 import { toChildArray } from "preact";
-import { htmlOverrides } from "../content/index.js";
+import { defaultComponents } from "../content/index.js";
 import { makeAdmonition } from "../content-admonition/index.js";
 import { CodeGroup } from "../code-group/index.js";
 import { Tabs } from "../code-syntax/index.js";
@@ -105,7 +105,7 @@ function makeEnlargeableParagraph(imageEnlarge, ContentImg) {
         }
       }
     }
-    return htmlOverrides.p(props);
+    return defaultComponents.p(props);
   };
 }
 function createMdxComponents(options) {
@@ -119,11 +119,11 @@ function createMdxComponents(options) {
   const CategoryTreeNavBound = (props) => navData.CategoryTreeNav({ ...props, lang: locale });
   const SiteTreeNavBound = (props) => navData.SiteTreeNav({ ...props, lang: locale });
   return {
-    ...htmlOverrides,
+    ...defaultComponents,
     // img override: rewrites root-relative src to include settings.base.
     img: ContentImg,
     // p override: wraps block-level images in <figure class="zd-enlargeable">.
-    // Must come AFTER ...htmlOverrides to override ContentParagraph.
+    // Must come AFTER ...defaultComponents to override ContentParagraph.
     p: EnlargeableParagraph,
     // Admonitions — real typed Preact components emitting the
     // `.admonition` / `data-admonition` structure the design-system CSS

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

@@ -1,3 +1,4 @@
 import type { ZfbPlugin } from "@takazudo/zfb/plugins";
+export { runClaudeResourcesPreStep } from "./internal/claude-resources/index.js";
 declare const plugin: ZfbPlugin;
 export default plugin;

package/dist/plugins/claude-resources.js

@@ -1,4 +1,5 @@
-import { runClaudeResourcesPreStep } from "../integrations/claude-resources/index.js";
+import { runClaudeResourcesPreStep } from "./internal/claude-resources/index.js";
+import { runClaudeResourcesPreStep as runClaudeResourcesPreStep2 } from "./internal/claude-resources/index.js";
 const PLUGIN_NAME = "@takazudo/zudo-doc-claude-resources";
 const plugin = {
   name: PLUGIN_NAME,
@@ -25,5 +26,6 @@ const plugin = {
 };
 var claude_resources_default = plugin;
 export {
-  claude_resources_default as default
+  claude_resources_default as default,
+  runClaudeResourcesPreStep2 as runClaudeResourcesPreStep
 };

package/dist/plugins/doc-history.js

@@ -2,7 +2,7 @@ import {
   runDocHistoryMetaStep,
   runDocHistoryPostBuild,
   createDocHistoryDevMiddleware
-} from "../integrations/doc-history/index.js";
+} from "./internal/doc-history/index.js";
 import { connectToZfbHandler } from "./connect-adapter.js";
 import { getBasePrefix } from "./plugin-utils.js";
 const plugin = {

package/dist/{integrations → plugins/internal}/claude-resources/index.d.ts

@@ -1,10 +1,5 @@
 import { generateClaudeResourcesDocs, type ClaudeResourcesConfig } from "./generate.js";
-export interface ZfbPluginConfig {
-    name: string;
-    options?: Record<string, unknown>;
-}
-export declare const CLAUDE_RESOURCES_PLUGIN_NAME = "@takazudo/zudo-doc-claude-resources";
-/** Options accepted by both the plugin entry and the imperative runner. */
+/** Options accepted by the plugin's generator runner. */
 export interface ClaudeResourcesPluginOptions {
     /**
      * Path to the project's `.claude/` directory holding `commands/`,
@@ -40,16 +35,6 @@ export interface ClaudeResourcesPluginOptions {
      */
     docsDir?: string;
 }
-/**
- * Declarative plugin entry for `zfb.config.ts`. Returns the
- * `{ name, options }` shape that zfb's plugins array consumes.
- *
- * v0 note: zfb does not yet invoke plugin lifecycles, so registering the
- * plugin alone does not run generation today. Pair it with a call to
- * `runClaudeResourcesPreStep` from a `prebuild`-style script until the
- * lifecycle hook lands. The plugin entry itself is forward-compatible.
- */
-export declare function claudeResourcesPlugin(options: ClaudeResourcesPluginOptions): ZfbPluginConfig;
 /**
  * Imperative pre-step runner. Resolves relative paths against
  * `projectRoot` (defaults to `process.cwd()`) and invokes the underlying

package/dist/{integrations → plugins/internal}/claude-resources/index.js

@@ -2,13 +2,6 @@ import path from "node:path";
 import {
   generateClaudeResourcesDocs
 } from "./generate.js";
-const CLAUDE_RESOURCES_PLUGIN_NAME = "@takazudo/zudo-doc-claude-resources";
-function claudeResourcesPlugin(options) {
-  return {
-    name: CLAUDE_RESOURCES_PLUGIN_NAME,
-    options: { ...options }
-  };
-}
 function runClaudeResourcesPreStep(options) {
   const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
   const claudeDir = path.isAbsolute(options.claudeDir) ? options.claudeDir : path.resolve(projectRoot, options.claudeDir);
@@ -18,8 +11,6 @@ function runClaudeResourcesPreStep(options) {
   return generateClaudeResourcesDocs({ claudeDir, projectRoot: scanRoot, docsDir });
 }
 export {
-  CLAUDE_RESOURCES_PLUGIN_NAME,
-  claudeResourcesPlugin,
   generateClaudeResourcesDocs,
   runClaudeResourcesPreStep
 };

package/dist/{integrations → plugins/internal}/doc-history/index.d.ts

@@ -24,13 +24,6 @@ export interface DocHistoryOptions {
      */
     maxEntries?: number;
 }
-/** zfb v0 plugin descriptor — mirrors `PluginConfig` in `zfb/config`. */
-export interface DocHistoryPluginDescriptor {
-    /** Stable plugin id used by the future zfb plugin runtime to dispatch hooks. */
-    name: "doc-history";
-    /** Options forwarded verbatim into the zfb config; must be JSON-serialisable. */
-    options: DocHistoryOptions;
-}
 /** Default doc-history-server port — matches `@takazudo/zudo-doc-history-server`. */
 export declare const DEFAULT_SERVER_PORT = 4322;
 /** Default git history depth — matches `@takazudo/zudo-doc-history-server`. */
@@ -41,16 +34,6 @@ export declare const DOC_HISTORY_ROUTE_PREFIX = "/doc-history/";
 export declare const DOC_HISTORY_OUTPUT_DIRNAME = "doc-history";
 /** CLI bin name exposed by `@takazudo/zudo-doc-history-server` for inline generation. */
 export declare const DOC_HISTORY_GENERATE_BIN = "doc-history-generate";
-/**
- * Build the zfb config-side descriptor. Add the return value to the
- * `plugins: [...]` array in `zfb.config.ts`.
- *
- * The shape is intentionally limited to `{ name, options }` because
- * that is the only thing today's zfb config loader consumes (see the
- * Rust `PluginConfig` struct in zfb's `config.rs`). Runtime wiring is
- * done through the sibling helpers in this module.
- */
-export declare function docHistoryPlugin(options: DocHistoryOptions): DocHistoryPluginDescriptor;
 /** Connect-style middleware signature — works as a Vite plugin middleware. */
 export type ConnectMiddleware = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
 /** Minimal logger surface used by the middleware on proxy failure. */

package/dist/{integrations → plugins/internal}/doc-history/index.js

@@ -9,9 +9,6 @@ const DEFAULT_MAX_ENTRIES = 50;
 const DOC_HISTORY_ROUTE_PREFIX = "/doc-history/";
 const DOC_HISTORY_OUTPUT_DIRNAME = "doc-history";
 const DOC_HISTORY_GENERATE_BIN = "doc-history-generate";
-function docHistoryPlugin(options) {
-  return { name: "doc-history", options };
-}
 function createDocHistoryDevMiddleware(options, logger) {
   const port = options.serverPort ?? DEFAULT_SERVER_PORT;
   return (req, res, next) => {
@@ -153,7 +150,6 @@ export {
   DOC_HISTORY_ROUTE_PREFIX,
   buildGenerateCliArgs,
   createDocHistoryDevMiddleware,
-  docHistoryPlugin,
   resolveDocHistoryGenerateBin,
   runDocHistoryMetaStep,
   runDocHistoryPostBuild,

package/dist/{integrations → plugins/internal}/doc-history/pre-build.d.ts

@@ -42,11 +42,9 @@ export interface DocHistoryMetaEntry {
     /**
      * Source file extension (".mdx" or ".md") — the content walkers accept
      * both (`collectContentFiles` matches `\.mdx?$`), so the view-source URL
-     * builder in the host's `_doc-history-area.tsx` reads this instead of
-     * hardcoding ".mdx". Optional in older manifests; readers fall back to
-     * ".mdx" when absent.
+     * builder uses the actual source extension.
      */
-    ext?: ".mdx" | ".md";
+    ext: ".mdx" | ".md";
 }
 /** Manifest shape — keyed by composedSlug. */
 export type DocHistoryMetaManifest = Record<string, DocHistoryMetaEntry>;

package/dist/plugins/internal/llms-txt/index.d.ts

@@ -0,0 +1,7 @@
+export { createLlmsTxtDevMiddleware } from "./dev-middleware.js";
+export type { LlmsTxtDevMiddlewareOptions, LlmsTxtMiddleware, LlmsTxtMiddlewareLogger, LlmsTxtNextFn, } from "./dev-middleware.js";
+export { emitLlmsTxt } from "./emit.js";
+export { generateLlmsFullTxt, generateLlmsTxt, } from "./generate.js";
+export { collectMdFiles, isExcluded, loadDocEntries, parseMarkdownFile, slugToUrl, } from "./load.js";
+export { stripImportsAndJsx, stripMarkdown } from "./strip.js";
+export type { LlmsDocEntry, LlmsTxtEmitOptions, LlmsTxtEmitResult, LlmsTxtFrontmatter, LlmsTxtLoadOptions, LlmsTxtLocaleConfig, LlmsTxtLogger, LlmsTxtSiteMeta, } from "./types.js";

package/dist/{integrations → plugins/internal}/llms-txt/load.d.ts

@@ -9,7 +9,7 @@
  * surface is unchanged.
  */
 import type { LlmsDocEntry, LlmsTxtLoadOptions } from "./types.js";
-export { collectMdFiles, isExcluded, parseMarkdownFile, slugToUrl, } from "../../md-utils/index.js";
+export { collectMdFiles, isExcluded, parseMarkdownFile, slugToUrl, } from "../../../md-utils/index.js";
 /**
  * Build the sorted {@link LlmsDocEntry} list for a single content root.
  * Excluded pages (draft / unlisted / search_exclude) are dropped.

package/dist/{integrations → plugins/internal}/llms-txt/load.js

@@ -5,14 +5,14 @@ import {
   parseMarkdownFile,
   slugToUrl,
   stripMarkdown
-} from "../../md-utils/index.js";
+} from "../../../md-utils/index.js";
 import { stripImportsAndJsx } from "./strip.js";
 import {
   collectMdFiles as collectMdFiles2,
   isExcluded as isExcluded2,
   parseMarkdownFile as parseMarkdownFile2,
   slugToUrl as slugToUrl2
-} from "../../md-utils/index.js";
+} from "../../../md-utils/index.js";
 function loadDocEntries(options) {
   const { contentDir, locale, base, siteUrl } = options;
   const absDir = resolve(contentDir);

package/dist/{integrations → plugins/internal}/llms-txt/strip.d.ts

@@ -10,10 +10,9 @@
  * `stripMarkdown` (used to derive a fallback `description` from the body
  * when frontmatter doesn't carry one) lives in the shared `md-utils`
  * module — one implementation for search-index and llms-txt
- * (zudo-doc#2024) — and is re-exported here to keep the public surface
- * unchanged.
+ * (zudo-doc#2024) — and is re-exported here for the internal loader barrel.
  */
-export { stripMarkdown } from "../../md-utils/index.js";
+export { stripMarkdown } from "../../../md-utils/index.js";
 /**
  * Strip imports, exports, and HTML/JSX tags from MDX/MD content while
  * keeping the prose layout (headings, lists, blockquotes) intact for

package/dist/{integrations → plugins/internal}/llms-txt/strip.js

@@ -1,4 +1,4 @@
-import { stripMarkdown } from "../../md-utils/index.js";
+import { stripMarkdown } from "../../../md-utils/index.js";
 function stripImportsAndJsx(content) {
   return content.replace(/^import\s+.*$/gm, "").replace(/^export\s+.*$/gm, "").replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<\/?[a-zA-Z][a-zA-Z0-9]*[^>]*>/g, "").replace(/\n{3,}/g, "\n\n").trim();
 }

package/dist/{integrations → plugins/internal}/llms-txt/types.d.ts

@@ -1,16 +1,13 @@
 /**
- * Public types for the framework-agnostic llms-txt build emitter.
+ * Internal types for the framework-agnostic llms-txt build emitter.
  *
- * The shapes here are deliberately decoupled from `astro:content` and
- * Astro's `AstroIntegration` API so the emitter can run on top of any
- * pipeline that exposes a `dist/` output directory and a list of
- * markdown content roots — Astro today, zfb tomorrow, plain Node tooling
- * in a unit test, etc.
+ * The shapes are deliberately framework-neutral so the current zfb plugin
+ * and plain Node test tooling can share the same emitter.
  */
-import type { MdDocFrontmatter } from "../../md-utils/index.js";
+import type { MdDocFrontmatter } from "../../../md-utils/index.js";
 /**
  * Frontmatter fields the loader reads off of each MDX/MD file. Callers
- * are free to extend this; unrecognised fields are ignored. Alias of the
+ * are free to extend this; unrecognised fields are ignored. Re-export of the
  * shared {@link MdDocFrontmatter} shape (`md-utils`, zudo-doc#2024) —
  * search-index and llms-txt read the same fields.
  */
@@ -44,8 +41,8 @@ export interface LlmsDocEntry {
 }
 /**
  * Site-level metadata threaded through the generators. Matches the
- * `siteName` / `siteDescription` fields on the legacy settings object
- * one-for-one so callers can pass `settings` straight through.
+ * current `siteName` / `siteDescription` settings one-for-one so callers can
+ * pass the current settings object straight through.
  */
 export interface LlmsTxtSiteMeta {
     siteName: string;
@@ -81,16 +78,13 @@ export interface LlmsTxtLoadOptions {
     /**
      * Optional absolute site URL. When set, the loader produces fully
      * qualified URLs by prefixing the base+path with `siteUrl`. When
-     * empty, URLs are returned path-only (matching the legacy emitter's
-     * behaviour for projects that omit `siteUrl`).
+     * empty, URLs are returned path-only for projects that omit `siteUrl`.
      */
     siteUrl?: string;
 }
 /**
- * Top-level options for {@link emitLlmsTxt}. Mirrors the inputs the
- * legacy Astro emitter pulled implicitly off of the project's `settings`
- * module so that a one-line registration in `zfb.config.ts` (or a
- * `b4-build` hook in Astro) can wire the same behaviour.
+ * Top-level options for {@link emitLlmsTxt}. The current zfb plugin supplies
+ * these explicitly from its resolved config.
  */
 export interface LlmsTxtEmitOptions extends LlmsTxtSiteMeta {
     /** Absolute output directory — typically `dist/`. */
@@ -110,16 +104,13 @@ export interface LlmsTxtEmitOptions extends LlmsTxtSiteMeta {
      */
     locales?: LlmsTxtLocaleConfig[];
     /**
-     * Optional logger. Defaults to a no-op so unit tests stay quiet; the
-     * Astro adapter can wire `astro:build:done`'s `logger` through, and
-     * a future zfb plugin can pipe its own.
+     * Optional logger. Defaults to a no-op so unit tests stay quiet; the zfb
+     * plugin can pipe its logger through.
      */
     logger?: LlmsTxtLogger;
 }
 /**
- * Minimal logger interface — a structural subset of both Astro's
- * `logger` and `console`. Only `info` is used today; the wider shape is
- * provided so the option can hold either object without type acrobatics.
+ * Minimal logger interface. Only `info` is used today.
  */
 export interface LlmsTxtLogger {
     info: (msg: string) => void;

package/dist/{integrations → plugins/internal}/search-index/collect.js

@@ -5,7 +5,7 @@ import {
   parseMarkdownFile,
   slugToUrl,
   stripMarkdown
-} from "../../md-utils/index.js";
+} from "../../../md-utils/index.js";
 import {
   MAX_BODY_LENGTH
 } from "./types.js";

package/dist/plugins/internal/theme-packs/copy.d.ts

@@ -0,0 +1,32 @@
+import type { ThemePackRegistry } from "../../../theme-packs-registry/index.js";
+export interface CopyThemePacksParams {
+    /** The shipped `theme-packs/` directory — `dist/theme-packs/` once
+     *  compiled (workspace-built and published shapes alike), `src/theme-packs/`
+     *  when vitest runs the source directly. Same resolution rule as
+     *  `routes.ts`'s `themePacksDir`. */
+    packsDir: string | URL;
+    /** The ENABLED, ORDERED registry (already resolved via `resolveEnabledPacks`). */
+    enabled: ThemePackRegistry;
+    /** The build's output directory (`ctx.outDir`). */
+    outDir: string;
+}
+export interface CopyThemePacksResult {
+    /** `false` when the ADR's no-op rule applies (no CSS-bearing pack enabled)
+     *  — nothing was written. */
+    copied: boolean;
+    /** Absolute path of `${outDir}/theme-packs/`, when `copied` is `true`. */
+    destDir?: string;
+    /** Absolute path of the written `index.json`, when `copied` is `true`. */
+    indexJsonPath?: string;
+}
+/**
+ * Copy every enabled pack's `meta.json` (+ `pack.css` when it ships one, +
+ * `fonts/*` when present) into `${outDir}/theme-packs/<slug>/…`, and write
+ * the aggregated `${outDir}/theme-packs/index.json` manifest
+ * (`{ schemaVersion: 1, packs: ThemePackMeta[] }`) in resolved order.
+ *
+ * No-ops (writes nothing, returns `{ copied: false }`) when the enabled set
+ * has no CSS-bearing pack — i.e. only `"default"` is enabled — per the ADR's
+ * dead-weight-avoidance rule.
+ */
+export declare function copyEnabledThemePacks({ packsDir, enabled, outDir, }: CopyThemePacksParams): CopyThemePacksResult;

package/dist/plugins/internal/theme-packs/copy.js

@@ -0,0 +1,45 @@
+import { copyFileSync, existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { hasCssBearingPack } from "./resolve.js";
+function copyEnabledThemePacks({
+  packsDir,
+  enabled,
+  outDir
+}) {
+  if (!hasCssBearingPack(enabled)) {
+    return { copied: false };
+  }
+  const srcRoot = packsDir instanceof URL ? fileURLToPath(packsDir) : packsDir;
+  const destRoot = join(outDir, "theme-packs");
+  mkdirSync(destRoot, { recursive: true });
+  for (const entry of enabled) {
+    const srcDir = join(srcRoot, entry.slug);
+    const destDir = join(destRoot, entry.slug);
+    mkdirSync(destDir, { recursive: true });
+    copyFileSync(join(srcDir, "meta.json"), join(destDir, "meta.json"));
+    if (entry.hasStylesheet) {
+      copyFileSync(join(srcDir, "pack.css"), join(destDir, "pack.css"));
+    }
+    const fontsSrcDir = join(srcDir, "fonts");
+    if (existsSync(fontsSrcDir)) {
+      const fontsDestDir = join(destDir, "fonts");
+      mkdirSync(fontsDestDir, { recursive: true });
+      for (const file of readdirSync(fontsSrcDir, { withFileTypes: true })) {
+        if (file.isFile()) {
+          copyFileSync(join(fontsSrcDir, file.name), join(fontsDestDir, file.name));
+        }
+      }
+    }
+  }
+  const manifest = {
+    schemaVersion: 1,
+    packs: enabled.map((entry) => entry.meta)
+  };
+  const indexJsonPath = join(destRoot, "index.json");
+  writeFileSync(indexJsonPath, JSON.stringify(manifest));
+  return { copied: true, destDir: destRoot, indexJsonPath };
+}
+export {
+  copyEnabledThemePacks
+};

package/dist/plugins/internal/theme-packs/dev-middleware.d.ts

@@ -0,0 +1,22 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ThemePackRegistry } from "../../../theme-packs-registry/index.js";
+export type ThemePacksNextFn = (err?: unknown) => void;
+export type ThemePacksMiddleware = (req: IncomingMessage, res: ServerResponse, next: ThemePacksNextFn) => void;
+export interface CreateThemePacksDevMiddlewareParams {
+    /** The shipped `theme-packs/` directory (workspace `src/theme-packs/` under
+     *  vitest, `dist/theme-packs/` from the published/workspace-built package). */
+    packsDir: string | URL;
+    /** The ENABLED, ORDERED registry (already resolved via `resolveEnabledPacks`). */
+    enabled: ThemePackRegistry;
+    /** Base-stripped route prefix this registration matches under, e.g.
+     *  `/theme-packs` for base `/`, or `/my-docs/theme-packs` for base
+     *  `/my-docs/` (same `getBasePrefix` convention as the sibling plugins). */
+    routePrefix: string;
+}
+/**
+ * Build a dev-server middleware serving the enabled packs' files plus a
+ * generated `index.json` aggregate. Every request re-reads from disk (no
+ * caching) so authoring edits to `pack.css` during `zudo-doc` development
+ * surface without a dev-server restart.
+ */
+export declare function createThemePacksDevMiddleware({ packsDir, enabled, routePrefix, }: CreateThemePacksDevMiddlewareParams): ThemePacksMiddleware;

package/dist/plugins/internal/theme-packs/dev-middleware.js

@@ -0,0 +1,80 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve as resolvePath, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+const CONTENT_TYPES = {
+  ".css": "text/css",
+  ".json": "application/json",
+  ".woff2": "font/woff2"
+};
+function contentTypeFor(path) {
+  const dot = path.lastIndexOf(".");
+  if (dot === -1) return void 0;
+  return CONTENT_TYPES[path.slice(dot).toLowerCase()];
+}
+function createThemePacksDevMiddleware({
+  packsDir,
+  enabled,
+  routePrefix
+}) {
+  const rootDir = resolvePath(packsDir instanceof URL ? fileURLToPath(packsDir) : packsDir);
+  const bySlug = new Map(enabled.map((entry) => [entry.slug, entry]));
+  const prefix = routePrefix.endsWith("/") ? routePrefix : `${routePrefix}/`;
+  const indexPath = `${prefix}index.json`;
+  return (req, res, next) => {
+    const url = (req.url ?? "").split("?")[0] ?? "";
+    if (!url.startsWith(prefix)) {
+      next();
+      return;
+    }
+    if (url === indexPath) {
+      const manifest = {
+        schemaVersion: 1,
+        packs: enabled.map((entry2) => entry2.meta)
+      };
+      res.setHeader("Content-Type", "application/json");
+      res.end(JSON.stringify(manifest));
+      return;
+    }
+    const rest = url.slice(prefix.length);
+    const segments = rest.split("/");
+    const slug = segments[0];
+    const tail = segments.slice(1).join("/");
+    if (!slug || segments.some((s) => s === "" || s === "." || s === "..")) {
+      next();
+      return;
+    }
+    const entry = bySlug.get(slug);
+    if (!entry) {
+      next();
+      return;
+    }
+    if (tail !== "pack.css" && !tail.startsWith("fonts/")) {
+      next();
+      return;
+    }
+    if (tail === "pack.css" && !entry.hasStylesheet) {
+      next();
+      return;
+    }
+    const packDir = resolvePath(rootDir, slug);
+    const filePath = resolvePath(packDir, tail);
+    if (!filePath.startsWith(packDir + sep)) {
+      res.statusCode = 400;
+      res.end("Bad Request");
+      return;
+    }
+    if (!existsSync(filePath)) {
+      next();
+      return;
+    }
+    const contentType = contentTypeFor(filePath);
+    const isBinary = contentType === "font/woff2";
+    const body = isBinary ? readFileSync(filePath) : readFileSync(filePath, "utf8");
+    res.statusCode = 200;
+    if (contentType) res.setHeader("Content-Type", contentType);
+    res.end(body);
+  };
+}
+export {
+  createThemePacksDevMiddleware
+};

package/dist/plugins/internal/theme-packs/index.d.ts

@@ -0,0 +1,6 @@
+export { resolveThemePacksForOptions, hasCssBearingPack } from "./resolve.js";
+export { copyEnabledThemePacks } from "./copy.js";
+export type { CopyThemePacksParams, CopyThemePacksResult } from "./copy.js";
+export { createThemePacksDevMiddleware } from "./dev-middleware.js";
+export type { ThemePacksMiddleware, ThemePacksNextFn, CreateThemePacksDevMiddlewareParams, } from "./dev-middleware.js";
+export type { ThemePacksPluginOptions, ThemePacksIndexManifest } from "./types.js";

package/dist/plugins/internal/theme-packs/index.js

@@ -0,0 +1,9 @@
+import { resolveThemePacksForOptions, hasCssBearingPack } from "./resolve.js";
+import { copyEnabledThemePacks } from "./copy.js";
+import { createThemePacksDevMiddleware } from "./dev-middleware.js";
+export {
+  copyEnabledThemePacks,
+  createThemePacksDevMiddleware,
+  hasCssBearingPack,
+  resolveThemePacksForOptions
+};

package/dist/plugins/internal/theme-packs/resolve.d.ts

@@ -0,0 +1,17 @@
+import { type ThemePackRegistry } from "../../../theme-packs-registry/index.js";
+import type { ThemePacksPluginOptions } from "./types.js";
+/**
+ * Resolve the ENABLED, ORDERED pack registry for `options` against the
+ * shipped `packsDir`. Throws — naming the offending pack/slug — on a broken
+ * bundled pack (`loadThemePackRegistry`) or an unknown/duplicate configured
+ * slug (`resolveEnabledPacks`); this is the fail-loudly precedent every hook
+ * (`setup`, `postBuild`, `devMiddleware`) relies on (never a silent
+ * fallback).
+ */
+export declare function resolveThemePacksForOptions(packsDir: string | URL, options: ThemePacksPluginOptions): ThemePackRegistry;
+/**
+ * Whether the resolved enabled set has anything worth copying/serving — the
+ * ADR's dead-weight-avoidance rule: "no-ops when the resolved enabled set has
+ * no CSS-bearing pack (i.e. only `default`)".
+ */
+export declare function hasCssBearingPack(enabled: ThemePackRegistry): boolean;

package/dist/plugins/internal/theme-packs/resolve.js

@@ -0,0 +1,17 @@
+import {
+  loadThemePackRegistry,
+  resolveEnabledPacks
+} from "../../../theme-packs-registry/index.js";
+function resolveThemePacksForOptions(packsDir, options) {
+  return resolveEnabledPacks(loadThemePackRegistry(packsDir), {
+    themePack: options.themePack,
+    themePacks: options.themePacks
+  });
+}
+function hasCssBearingPack(enabled) {
+  return enabled.some((entry) => entry.hasStylesheet);
+}
+export {
+  hasCssBearingPack,
+  resolveThemePacksForOptions
+};