@takazudo/zudo-doc 0.2.21 → 1.0.0

package/dist/icons/index.d.ts

@@ -1,18 +1,14 @@
-import { VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface IconProps {
+import type { VNode } from "preact";
+export interface IconProps {
     /** CSS class string forwarded to the root `<svg>` element. */
     className?: string;
 }
-declare function ChevronRight({ className }: IconProps): VNode;
-declare function ChevronLeft({ className }: IconProps): VNode;
-declare function Search({ className }: IconProps): VNode;
-declare function History({ className }: IconProps): VNode;
-declare function Close({ className }: IconProps): VNode;
-declare function ArrowLeft({ className }: IconProps): VNode;
-declare function GitHub({ className }: IconProps): VNode;
-
-export { ArrowLeft, ChevronLeft, ChevronRight, Close, GitHub, History, type IconProps, Search };
+export declare function ChevronRight({ className }: IconProps): VNode;
+export declare function ChevronLeft({ className }: IconProps): VNode;
+export declare function Search({ className }: IconProps): VNode;
+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;

package/dist/image-enlarge/index.d.ts

@@ -0,0 +1,13 @@
+export declare function ImageEnlarge(): import("preact").JSX.Element;
+export declare namespace ImageEnlarge {
+    var displayName: string;
+}
+/**
+ * Static SSR fallback for the {@link ImageEnlarge} island.
+ *
+ * Renders an empty, closed `<dialog class="zd-enlarge-dialog ...">` so the
+ * dist HTML carries the dialog shell even before hydration. Sources its
+ * class and inline style from the shared constants in island-types so the
+ * SSR fallback cannot drift from the hydrated dialog above.
+ */
+export declare function ImageEnlargeSsrFallback(): import("preact").JSX.Element;

package/dist/image-enlarge/index.js

@@ -0,0 +1,176 @@
+"use client";
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { useState, useEffect } from "preact/compat";
+import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
+import { useModalDialog } from "../use-modal-dialog/index.js";
+import {
+  IMAGE_ENLARGE_DIALOG_CLASS,
+  ENLARGE_DIALOG_STYLE
+} from "../island-types/index.js";
+function ImageEnlarge() {
+  const [imgData, setImgData] = useState(null);
+  useEffect(() => {
+    const observedImages = /* @__PURE__ */ new Set();
+    const sharedResizeObserver = new ResizeObserver((entries) => {
+      for (const entry of entries) {
+        evaluateEligibility(entry.target);
+      }
+    });
+    let mutationObserver = null;
+    let resizeTimer = 0;
+    let loadAbortController = new AbortController();
+    function evaluateEligibility(img) {
+      const container = img.closest(".zd-enlargeable");
+      if (!container) return;
+      const btn = container.querySelector(".zd-enlarge-btn");
+      if (!btn) return;
+      const eligible = img.naturalWidth > img.clientWidth * window.devicePixelRatio;
+      if (eligible) {
+        btn.removeAttribute("hidden");
+      } else {
+        btn.setAttribute("hidden", "");
+      }
+    }
+    function observeImage(img) {
+      if (observedImages.has(img)) return;
+      observedImages.add(img);
+      sharedResizeObserver.observe(img);
+      if (img.complete) {
+        evaluateEligibility(img);
+      } else {
+        img.addEventListener(
+          "load",
+          () => evaluateEligibility(img),
+          { once: true, signal: loadAbortController.signal }
+        );
+      }
+    }
+    function scanContent() {
+      const scope = document.querySelector("main .zd-content");
+      if (!scope) return;
+      scope.querySelectorAll(".zd-enlargeable img").forEach(observeImage);
+    }
+    function startObserving() {
+      const scope = document.querySelector("main .zd-content");
+      if (scope) {
+        mutationObserver = new MutationObserver((mutations) => {
+          for (const mutation of mutations) {
+            for (const node of mutation.addedNodes) {
+              if (!(node instanceof Element)) continue;
+              if (node.matches(".zd-enlargeable")) {
+                node.querySelectorAll("img").forEach(observeImage);
+              }
+              node.querySelectorAll(".zd-enlargeable img").forEach(observeImage);
+            }
+          }
+        });
+        mutationObserver.observe(scope, { childList: true, subtree: true });
+      }
+      scanContent();
+    }
+    function handleWindowResize() {
+      clearTimeout(resizeTimer);
+      resizeTimer = window.setTimeout(() => {
+        observedImages.forEach((img) => evaluateEligibility(img));
+      }, 150);
+    }
+    function handleAfterSwap() {
+      sharedResizeObserver.disconnect();
+      observedImages.clear();
+      mutationObserver?.disconnect();
+      mutationObserver = null;
+      loadAbortController.abort();
+      loadAbortController = new AbortController();
+      startObserving();
+    }
+    startObserving();
+    window.addEventListener("resize", handleWindowResize);
+    document.addEventListener(AFTER_NAVIGATE_EVENT, handleAfterSwap);
+    return () => {
+      sharedResizeObserver.disconnect();
+      observedImages.clear();
+      mutationObserver?.disconnect();
+      loadAbortController.abort();
+      window.removeEventListener("resize", handleWindowResize);
+      document.removeEventListener(AFTER_NAVIGATE_EVENT, handleAfterSwap);
+      clearTimeout(resizeTimer);
+    };
+  }, []);
+  useEffect(() => {
+    function handleDocumentClick(e) {
+      const sel = window.getSelection();
+      if (sel && !sel.isCollapsed) return;
+      const target = e.target;
+      const container = target.closest(".zd-enlargeable");
+      if (!container) return;
+      if (!target.closest(".zd-enlarge-btn") && !target.closest("img")) return;
+      const btn = container.querySelector(".zd-enlarge-btn");
+      if (!btn || btn.hasAttribute("hidden")) return;
+      const img = container.querySelector("img");
+      if (!img) return;
+      setImgData({
+        src: img.src,
+        currentSrc: img.currentSrc,
+        srcset: img.srcset || void 0,
+        sizes: img.sizes || void 0,
+        alt: img.alt,
+        naturalWidth: img.naturalWidth,
+        naturalHeight: img.naturalHeight
+      });
+    }
+    document.addEventListener("click", handleDocumentClick);
+    return () => document.removeEventListener("click", handleDocumentClick);
+  }, []);
+  const handleClose = () => setImgData(null);
+  const { dialogRef, handleBackdropClick } = useModalDialog({
+    isOpen: imgData !== null,
+    onClose: handleClose,
+    navigateEvent: AFTER_NAVIGATE_EVENT,
+    backdropClickClose: true
+  });
+  return /* @__PURE__ */ jsx(
+    "dialog",
+    {
+      ref: dialogRef,
+      onClick: handleBackdropClick,
+      className: IMAGE_ENLARGE_DIALOG_CLASS,
+      style: ENLARGE_DIALOG_STYLE,
+      children: imgData && /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx("div", { className: "relative", children: /* @__PURE__ */ jsx(
+          "img",
+          {
+            src: imgData.currentSrc || imgData.src,
+            srcSet: imgData.srcset,
+            sizes: imgData.srcset ? "85vw" : void 0,
+            alt: imgData.alt,
+            className: "block max-h-[85vh] max-w-[85vw] object-contain"
+          }
+        ) }),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            onClick: () => dialogRef.current?.close(),
+            className: "zd-enlarge-dialog-close",
+            "aria-label": "Close enlarged image",
+            children: /* @__PURE__ */ jsx("svg", { viewBox: "0 0 161.03 161.03", fill: "currentColor", "aria-hidden": "true", focusable: "false", children: /* @__PURE__ */ jsx("polygon", { points: "161.03 10.27 150.76 0 80.51 70.24 10.27 0 0 10.27 70.24 80.51 0 150.76 10.27 161.03 80.51 90.78 150.76 161.03 161.03 150.76 90.78 80.51 161.03 10.27" }) })
+          }
+        )
+      ] })
+    }
+  );
+}
+ImageEnlarge.displayName = "ImageEnlarge";
+function ImageEnlargeSsrFallback() {
+  return /* @__PURE__ */ jsx(
+    "dialog",
+    {
+      className: IMAGE_ENLARGE_DIALOG_CLASS,
+      style: ENLARGE_DIALOG_STYLE
+    }
+  );
+}
+export {
+  ImageEnlarge,
+  ImageEnlargeSsrFallback
+};

package/dist/index.d.ts

@@ -1,2 +1,26 @@
-
-export {  }
+/**
+ * @takazudo/zudo-doc — framework primitives that sit on top of zfb's engine.
+ *
+ * **Use the subpath exports for actual imports.** This root barrel deliberately
+ * stays empty so consumers don't drag in the entire framework when they only
+ * need one piece. Each topic area publishes its own subpath (declared in
+ * `package.json#exports`):
+ *
+ *   import { buildSidebarTree, type SidebarNode } from "@takazudo/zudo-doc/sidebar-tree";
+ *   import { DocHead, type HeadProps }              from "@takazudo/zudo-doc/head";
+ *   import { Toc, MobileToc }                       from "@takazudo/zudo-doc/toc";
+ *   import { Breadcrumb }                           from "@takazudo/zudo-doc/breadcrumb";
+ *   import { DocLayout, DocLayoutWithDefaults }     from "@takazudo/zudo-doc/doclayout";
+ *   import { ColorSchemeProvider, ThemeToggle }     from "@takazudo/zudo-doc/theme";
+ *   import { startViewTransition, sidebarPersistName } from "@takazudo/zudo-doc/transitions";
+ *   import { initSidebarResizer }                      from "@takazudo/zudo-doc/sidebar-resizer";
+ *
+ * The SSR-skip wrapper subpath (`@takazudo/zudo-doc/ssr-skip`) was
+ * removed in Wave 8 (super-epic #1333 / child epic #1355). Hosts now
+ * compose body-end islands directly with zfb's native `<Island
+ * ssrFallback>` API so the page → real-component import chain stays
+ * walkable by zfb's island scanner.
+ *
+ * See packages/zudo-doc/README.md for the topic map.
+ */
+export {};

package/dist/inline-version-switcher/index.d.ts

@@ -0,0 +1,31 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+/** Minimal version config entry needed by the inline version switcher. */
+export interface InlineVersionSwitcherVersionEntry {
+    slug: string;
+    label?: string;
+}
+/** Settings subset read by the inline version switcher factory. */
+export interface InlineVersionSwitcherSettings {
+    versions: InlineVersionSwitcherVersionEntry[] | false;
+}
+/** Injected dependencies for {@link createInlineVersionSwitcher}. */
+export interface InlineVersionSwitcherDeps {
+    settings: InlineVersionSwitcherSettings;
+    /** Default locale code (e.g. `"en"`). */
+    defaultLocale: string;
+    /** Translate a UI string key for a locale. */
+    t: (key: string, locale: string) => string;
+    /** Build a docs URL for the given slug and lang. */
+    docsUrl: (slug: string, lang?: string) => string;
+    /** Build a versioned docs URL for the given slug, version, and lang. */
+    versionedDocsUrl: (slug: string, versionSlug: string, lang?: string) => string;
+    /** Prefix a path with the configured base directory. */
+    withBase: (path: string) => string;
+}
+/**
+ * Build the `buildInlineVersionSwitcher` function bound to the host's settings
+ * and dependencies.
+ */
+export declare function createInlineVersionSwitcher(deps: InlineVersionSwitcherDeps): (slug: string, locale: string, currentVersion?: string) => JSX.Element | undefined;

package/dist/inline-version-switcher/index.js

@@ -0,0 +1,44 @@
+import { jsx } from "preact/jsx-runtime";
+import {
+  VersionSwitcher
+} from "../i18n-version/index.js";
+function createInlineVersionSwitcher(deps) {
+  const { settings, defaultLocale, t, docsUrl, versionedDocsUrl, withBase } = deps;
+  function buildInlineVersionSwitcher(slug, locale, currentVersion) {
+    if (!settings.versions || settings.versions.length === 0) return void 0;
+    const isNonDefaultLocale = locale !== defaultLocale;
+    const versionsPageUrl = withBase(
+      isNonDefaultLocale ? `/${locale}/docs/versions` : "/docs/versions"
+    );
+    const latestUrl = docsUrl(slug, locale);
+    const versionUrls = {};
+    for (const v of settings.versions) {
+      versionUrls[v.slug] = versionedDocsUrl(slug, v.slug, locale);
+    }
+    const labels = {
+      latest: t("version.latest", locale),
+      switcher: t("version.switcher.label", locale),
+      unavailable: t("version.switcher.unavailable", locale),
+      allVersions: t("version.switcher.allVersions", locale)
+    };
+    return /* @__PURE__ */ jsx(
+      VersionSwitcher,
+      {
+        versions: settings.versions.map((v) => ({
+          slug: v.slug,
+          label: v.label ?? v.slug
+        })),
+        currentVersion,
+        latestUrl,
+        versionsPageUrl,
+        versionUrls,
+        labels,
+        idSuffix: "inline"
+      }
+    );
+  }
+  return buildInlineVersionSwitcher;
+}
+export {
+  createInlineVersionSwitcher
+};

package/dist/integrations/claude-resources/escape-for-mdx.d.ts

@@ -3,6 +3,4 @@
  * Preserves content inside code blocks (``` ... ```) and inline code (` ... `).
  * Handles 3+ backtick fenced blocks correctly.
  */
-declare function escapeForMdx(content: string): string;
-
-export { escapeForMdx };
+export declare function escapeForMdx(content: string): string;

package/dist/integrations/claude-resources/generate.d.ts

@@ -1,13 +1,11 @@
-interface ClaudeResourcesConfig {
+export interface ClaudeResourcesConfig {
     claudeDir: string;
     projectRoot?: string;
     docsDir: string;
 }
-declare function generateClaudeResourcesDocs(config: ClaudeResourcesConfig): {
+export declare function generateClaudeResourcesDocs(config: ClaudeResourcesConfig): {
     claudemd: number;
     commands: number;
     skills: number;
     agents: number;
 };
-
-export { type ClaudeResourcesConfig, generateClaudeResourcesDocs };

package/dist/integrations/claude-resources/index.d.ts

@@ -1,13 +1,11 @@
-import { generateClaudeResourcesDocs } from './generate.js';
-export { ClaudeResourcesConfig } from './generate.js';
-
-interface ZfbPluginConfig {
+import { generateClaudeResourcesDocs, type ClaudeResourcesConfig } from "./generate.js";
+export interface ZfbPluginConfig {
     name: string;
     options?: Record<string, unknown>;
 }
-declare const CLAUDE_RESOURCES_PLUGIN_NAME = "@takazudo/zudo-doc-claude-resources";
+export declare const CLAUDE_RESOURCES_PLUGIN_NAME = "@takazudo/zudo-doc-claude-resources";
 /** Options accepted by both the plugin entry and the imperative runner. */
-interface ClaudeResourcesPluginOptions {
+export interface ClaudeResourcesPluginOptions {
     /**
      * Path to the project's `.claude/` directory holding `commands/`,
      * `skills/`, `agents/`. Resolved against `projectRoot` when relative.
@@ -34,13 +32,12 @@ interface ClaudeResourcesPluginOptions {
  * `runClaudeResourcesPreStep` from a `prebuild`-style script until the
  * lifecycle hook lands. The plugin entry itself is forward-compatible.
  */
-declare function claudeResourcesPlugin(options: ClaudeResourcesPluginOptions): ZfbPluginConfig;
+export declare function claudeResourcesPlugin(options: ClaudeResourcesPluginOptions): ZfbPluginConfig;
 /**
  * Imperative pre-step runner. Resolves relative paths against
  * `projectRoot` (defaults to `process.cwd()`) and invokes the underlying
  * generator. Output is byte-equivalent to the Astro integration when
  * given the same inputs.
  */
-declare function runClaudeResourcesPreStep(options: ClaudeResourcesPluginOptions): ReturnType<typeof generateClaudeResourcesDocs>;
-
-export { CLAUDE_RESOURCES_PLUGIN_NAME, type ClaudeResourcesPluginOptions, type ZfbPluginConfig, claudeResourcesPlugin, generateClaudeResourcesDocs, runClaudeResourcesPreStep };
+export declare function runClaudeResourcesPreStep(options: ClaudeResourcesPluginOptions): ReturnType<typeof generateClaudeResourcesDocs>;
+export { generateClaudeResourcesDocs, type ClaudeResourcesConfig, };

package/dist/integrations/doc-history/index.d.ts

@@ -1,13 +1,12 @@
-import { IncomingMessage, ServerResponse } from 'node:http';
-export { DocHistoryMetaEntry, DocHistoryMetaLocaleConfig, DocHistoryMetaManifest, DocHistoryMetaVersionConfig, RunDocHistoryMetaOptions, runDocHistoryMetaStep } from './pre-build.js';
-
+import type { IncomingMessage, ServerResponse } from "node:http";
+export { runDocHistoryMetaStep, type RunDocHistoryMetaOptions, type DocHistoryMetaEntry, type DocHistoryMetaLocaleConfig, type DocHistoryMetaManifest, type DocHistoryMetaVersionConfig, } from "./pre-build.js";
 /** A single non-default locale entry; mirrors `settings.locales[*]`. */
-interface DocHistoryLocaleConfig {
+export interface DocHistoryLocaleConfig {
     /** Absolute or project-relative directory holding this locale's MDX content. */
     dir: string;
 }
 /** Build-time + dev-time options for the doc-history integration. */
-interface DocHistoryOptions {
+export interface DocHistoryOptions {
     /** Default-locale content directory (e.g. `src/content/docs`). */
     docsDir: string;
     /** Optional non-default locales, keyed by locale code (e.g. `{ ja: { dir: "src/content/docs-ja" } }`). */
@@ -26,22 +25,22 @@ interface DocHistoryOptions {
     maxEntries?: number;
 }
 /** zfb v0 plugin descriptor — mirrors `PluginConfig` in `zfb/config`. */
-interface DocHistoryPluginDescriptor {
+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`. */
-declare const DEFAULT_SERVER_PORT = 4322;
+export declare const DEFAULT_SERVER_PORT = 4322;
 /** Default git history depth — matches `@takazudo/zudo-doc-history-server`. */
-declare const DEFAULT_MAX_ENTRIES = 50;
+export declare const DEFAULT_MAX_ENTRIES = 50;
 /** Public route prefix the dev middleware and the standalone server agree on. */
-declare const DOC_HISTORY_ROUTE_PREFIX = "/doc-history/";
+export declare const DOC_HISTORY_ROUTE_PREFIX = "/doc-history/";
 /** Subdirectory within the build output that receives the generated JSON files. */
-declare const DOC_HISTORY_OUTPUT_DIRNAME = "doc-history";
+export declare const DOC_HISTORY_OUTPUT_DIRNAME = "doc-history";
 /** CLI bin name exposed by `@takazudo/zudo-doc-history-server` for inline generation. */
-declare const DOC_HISTORY_GENERATE_BIN = "doc-history-generate";
+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`.
@@ -51,11 +50,11 @@ declare const DOC_HISTORY_GENERATE_BIN = "doc-history-generate";
  * Rust `PluginConfig` struct in zfb's `config.rs`). Runtime wiring is
  * done through the sibling helpers in this module.
  */
-declare function docHistoryPlugin(options: DocHistoryOptions): DocHistoryPluginDescriptor;
+export declare function docHistoryPlugin(options: DocHistoryOptions): DocHistoryPluginDescriptor;
 /** Connect-style middleware signature — works as a Vite plugin middleware. */
-type ConnectMiddleware = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
+export type ConnectMiddleware = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
 /** Minimal logger surface used by the middleware on proxy failure. */
-interface MiddlewareLogger {
+export interface MiddlewareLogger {
     warn(msg: string): void;
 }
 /**
@@ -74,21 +73,21 @@ interface MiddlewareLogger {
  *     with a stable error envelope so the client island can render a
  *     graceful empty state.
  */
-declare function createDocHistoryDevMiddleware(options: DocHistoryOptions, logger?: MiddlewareLogger): ConnectMiddleware;
+export declare function createDocHistoryDevMiddleware(options: DocHistoryOptions, logger?: MiddlewareLogger): ConnectMiddleware;
 /** Minimal logger surface used by the post-build hook. */
-interface PostBuildLogger {
+export interface PostBuildLogger {
     info(msg: string): void;
     warn(msg: string): void;
 }
 /** Invocation context for the post-build hook. */
-interface PostBuildContext {
+export interface PostBuildContext {
     /** Absolute path to the build output directory (zfb `outDir`). */
     outDir: string;
     /** Optional logger; falls back to silent no-ops when omitted. */
     logger?: PostBuildLogger;
 }
 /** Env var that opts a LOCAL build back into postBuild per-page JSON generation. */
-declare const DOC_HISTORY_GEN_ENV = "GEN_DOC_HISTORY";
+export declare const DOC_HISTORY_GEN_ENV = "GEN_DOC_HISTORY";
 /**
  * Decide whether the postBuild hook should generate per-page doc-history JSON.
  *
@@ -111,7 +110,7 @@ declare const DOC_HISTORY_GEN_ENV = "GEN_DOC_HISTORY";
  * `SKIP_DOC_HISTORY` alone — so a plain local build still shows real page
  * metadata; only the per-page history dropdown JSON is absent until opt-in.
  */
-declare function shouldGeneratePostBuild(env?: NodeJS.ProcessEnv): {
+export declare function shouldGeneratePostBuild(env?: NodeJS.ProcessEnv): {
     generate: boolean;
     reason: string;
 };
@@ -128,13 +127,13 @@ declare function shouldGeneratePostBuild(env?: NodeJS.ProcessEnv): {
  * paths are never interpolated into a command line. Output is inherited so
  * progress and warnings surface in the user's terminal exactly as in CI.
  */
-declare function runDocHistoryPostBuild(options: DocHistoryOptions, ctx: PostBuildContext): Promise<void>;
+export declare function runDocHistoryPostBuild(options: DocHistoryOptions, ctx: PostBuildContext): Promise<void>;
 /**
  * Build the argv passed to `doc-history-generate`. Exposed for unit
  * tests; the CLI surface is documented in
  * `packages/doc-history-server/src/args.ts`.
  */
-declare function buildGenerateCliArgs(options: DocHistoryOptions, outDir: string): string[];
+export declare function buildGenerateCliArgs(options: DocHistoryOptions, outDir: string): string[];
 /**
  * Resolve the absolute path of the `doc-history-generate` script
  * shipped by `@takazudo/zudo-doc-history-server`.
@@ -157,6 +156,4 @@ declare function buildGenerateCliArgs(options: DocHistoryOptions, outDir: string
  * unconditionally), so this is safe even if the package later
  * tightens its exports surface.
  */
-declare function resolveDocHistoryGenerateBin(): string;
-
-export { type ConnectMiddleware, DEFAULT_MAX_ENTRIES, DEFAULT_SERVER_PORT, DOC_HISTORY_GENERATE_BIN, DOC_HISTORY_GEN_ENV, DOC_HISTORY_OUTPUT_DIRNAME, DOC_HISTORY_ROUTE_PREFIX, type DocHistoryLocaleConfig, type DocHistoryOptions, type DocHistoryPluginDescriptor, type MiddlewareLogger, type PostBuildContext, type PostBuildLogger, buildGenerateCliArgs, createDocHistoryDevMiddleware, docHistoryPlugin, resolveDocHistoryGenerateBin, runDocHistoryPostBuild, shouldGeneratePostBuild };
+export declare function resolveDocHistoryGenerateBin(): string;

package/dist/integrations/doc-history/pre-build.d.ts

@@ -1,10 +1,10 @@
 /** A single non-default locale entry; mirrors `settings.locales[*]`. */
-interface DocHistoryMetaLocaleConfig {
+export interface DocHistoryMetaLocaleConfig {
     /** Absolute or project-relative directory holding this locale's MDX content. */
     dir: string;
 }
 /** A versioned docs entry; mirrors `settings.versions[*]`. */
-interface DocHistoryMetaVersionConfig {
+export interface DocHistoryMetaVersionConfig {
     /** Slug used to namespace the version (e.g. `"1.0"`). */
     slug: string;
     /** Default-locale content directory for this version. */
@@ -13,7 +13,7 @@ interface DocHistoryMetaVersionConfig {
     locales?: Record<string, DocHistoryMetaLocaleConfig>;
 }
 /** Options accepted by the preBuild runner. */
-interface RunDocHistoryMetaOptions {
+export interface RunDocHistoryMetaOptions {
     /** Project root — directory containing `zfb.config.ts`. Resolves all relative paths. */
     projectRoot: string;
     /** Default-locale content directory (e.g. `"src/content/docs"`). */
@@ -35,7 +35,7 @@ interface RunDocHistoryMetaOptions {
     };
 }
 /** A single manifest entry. */
-interface DocHistoryMetaEntry {
+export interface DocHistoryMetaEntry {
     author: string;
     createdDate: string;
     updatedDate: string;
@@ -49,13 +49,13 @@ interface DocHistoryMetaEntry {
     ext?: ".mdx" | ".md";
 }
 /** Manifest shape — keyed by composedSlug. */
-type DocHistoryMetaManifest = Record<string, DocHistoryMetaEntry>;
+export type DocHistoryMetaManifest = Record<string, DocHistoryMetaEntry>;
 /**
  * Derive the manifest `ext` value from a content file path. The walkers
  * only collect `.md` / `.mdx` files (`collectContentFiles` matches
  * `\.mdx?$`), so anything not ending in ".md" is ".mdx".
  */
-declare function deriveSourceExt(filePath: string): ".mdx" | ".md";
+export declare function deriveSourceExt(filePath: string): ".mdx" | ".md";
 /**
  * Emit `<projectRoot>/.zfb/doc-history-meta.json` from git history.
  *
@@ -67,6 +67,4 @@ declare function deriveSourceExt(filePath: string): ".mdx" | ".md";
  * omitting them from the manifest — the page-side wrapper treats
  * undefined entries as "no SSR data".
  */
-declare function runDocHistoryMetaStep(options: RunDocHistoryMetaOptions): Promise<void>;
-
-export { type DocHistoryMetaEntry, type DocHistoryMetaLocaleConfig, type DocHistoryMetaManifest, type DocHistoryMetaVersionConfig, type RunDocHistoryMetaOptions, deriveSourceExt, runDocHistoryMetaStep };
+export declare function runDocHistoryMetaStep(options: RunDocHistoryMetaOptions): Promise<void>;

package/dist/integrations/llms-txt/dev-middleware.d.ts

@@ -1,12 +1,10 @@
-import { IncomingMessage, ServerResponse } from 'node:http';
-import { LlmsTxtSiteMeta, LlmsTxtLocaleConfig } from './types.js';
-import '../../md-utils/index.js';
-
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { LlmsTxtLocaleConfig, LlmsTxtSiteMeta } from "./types.js";
 /** Connect-style middleware signature — works as a Vite plugin middleware. */
-type LlmsTxtNextFn = (err?: unknown) => void;
-type LlmsTxtMiddleware = (req: IncomingMessage, res: ServerResponse, next: LlmsTxtNextFn) => void;
+export type LlmsTxtNextFn = (err?: unknown) => void;
+export type LlmsTxtMiddleware = (req: IncomingMessage, res: ServerResponse, next: LlmsTxtNextFn) => void;
 /** Minimal logger surface used by the middleware on generation failure. */
-interface LlmsTxtMiddlewareLogger {
+export interface LlmsTxtMiddlewareLogger {
     warn(msg: string): void;
 }
 /**
@@ -15,7 +13,7 @@ interface LlmsTxtMiddlewareLogger {
  * so callers can hand a single options object to both `emitLlmsTxt`
  * (build) and `createLlmsTxtDevMiddleware` (dev).
  */
-interface LlmsTxtDevMiddlewareOptions extends LlmsTxtSiteMeta {
+export interface LlmsTxtDevMiddlewareOptions extends LlmsTxtSiteMeta {
     /** URL base used when materialising per-page links. */
     base: string;
     /** Optional absolute site URL; see `LlmsTxtLoadOptions.siteUrl`. */
@@ -36,6 +34,4 @@ interface LlmsTxtDevMiddlewareOptions extends LlmsTxtSiteMeta {
  * sibling `searchIndex` middleware uses — so authoring loops surface
  * content edits without a dev-server restart.
  */
-declare function createLlmsTxtDevMiddleware(options: LlmsTxtDevMiddlewareOptions, logger?: LlmsTxtMiddlewareLogger): LlmsTxtMiddleware;
-
-export { type LlmsTxtDevMiddlewareOptions, type LlmsTxtMiddleware, type LlmsTxtMiddlewareLogger, type LlmsTxtNextFn, createLlmsTxtDevMiddleware };
+export declare function createLlmsTxtDevMiddleware(options: LlmsTxtDevMiddlewareOptions, logger?: LlmsTxtMiddlewareLogger): LlmsTxtMiddleware;

package/dist/integrations/llms-txt/emit.d.ts

@@ -1,6 +1,3 @@
-import { LlmsTxtEmitOptions, LlmsTxtEmitResult } from './types.js';
-import '../../md-utils/index.js';
-
 /**
  * Build-time emitter that writes `llms.txt` and `llms-full.txt` for the
  * default locale plus every additional locale.
@@ -11,13 +8,11 @@ import '../../md-utils/index.js';
  * Astro's `astro:build:done`, a future zfb plugin's `onBuildDone`,
  * a Node CLI in CI, etc.
  */
-
+import type { LlmsTxtEmitOptions, LlmsTxtEmitResult } from "./types.js";
 /**
  * Walk every configured content root, generate the two files per
  * locale, and write them to `outDir` (default locale) and
  * `outDir/<code>/` (additional locales). The output directory is
  * created if needed; existing files are overwritten.
  */
-declare function emitLlmsTxt(options: LlmsTxtEmitOptions): LlmsTxtEmitResult;
-
-export { emitLlmsTxt };
+export declare function emitLlmsTxt(options: LlmsTxtEmitOptions): LlmsTxtEmitResult;

package/dist/integrations/llms-txt/generate.d.ts

@@ -1,6 +1,3 @@
-import { LlmsDocEntry, LlmsTxtSiteMeta } from './types.js';
-import '../../md-utils/index.js';
-
 /**
  * Pure string generators for `llms.txt` and `llms-full.txt`.
  *
@@ -12,16 +9,14 @@ import '../../md-utils/index.js';
  * Output format must remain byte-identical to the legacy Astro emitter
  * — the file shape is part of the project's public surface.
  */
-
+import type { LlmsDocEntry, LlmsTxtSiteMeta } from "./types.js";
 /**
  * Slim index — site header followed by a markdown bullet per page with
  * `[title](url): description`.
  */
-declare function generateLlmsTxt(entries: readonly LlmsDocEntry[], meta: LlmsTxtSiteMeta): string;
+export declare function generateLlmsTxt(entries: readonly LlmsDocEntry[], meta: LlmsTxtSiteMeta): string;
 /**
  * Full content concatenation — site header followed by every page's
  * stripped body separated by `---` rules.
  */
-declare function generateLlmsFullTxt(entries: readonly LlmsDocEntry[], meta: LlmsTxtSiteMeta): string;
-
-export { generateLlmsFullTxt, generateLlmsTxt };
+export declare function generateLlmsFullTxt(entries: readonly LlmsDocEntry[], meta: LlmsTxtSiteMeta): string;