@takazudo/zudo-doc 3.2.0 → 4.0.0

package/routes-src/_context.ts

@@ -22,6 +22,7 @@ import { routeContext } from "virtual:zudo-doc-route-context";
 
 import type { Settings } from "@takazudo/zudo-doc/settings";
 import type { ColorScheme } from "@takazudo/zudo-doc/color-scheme-utils";
+import type { ThemePackRegistry } from "@takazudo/zudo-doc/theme-packs-registry";
 import {
   createRouteContext,
   type RouteContextPayload,
@@ -42,6 +43,9 @@ export const settings: Settings = routeCtx.settings;
 /** Host color-scheme palette map. `null` when not supplied — `_chrome.tsx`
  *  falls back to `DEFAULT_SCHEME` in that case. */
 export const colorSchemes: Record<string, ColorScheme> | null = routeCtx.colorSchemes;
+/** Resolved, enabled, ordered theme-pack registry. `null` when the routes
+ *  plugin did not thread one (ADR `docs/adr/theme-packs.md`, Decision 2). */
+export const themePackRegistry: ThemePackRegistry | null = routeCtx.themePackRegistry;
 
 export const {
   i18n,

package/routes-src/_docs-helpers.ts

@@ -22,7 +22,6 @@
 import {
   getCollection,
   getContentSnapshot,
-  type CollectionEntry,
 } from "@takazudo/zfb/content";
 import {
   buildSidebarTree,
@@ -44,29 +43,10 @@ function snapshotAnchor(name: string): readonly unknown[] | undefined {
   return getContentSnapshot()?.collections[name];
 }
 
-const bridgedByAnchor = new WeakMap<object, DocPageEntry[]>();
+const docsByAnchor = new WeakMap<object, DocPageEntry[]>();
 
-/** Bridge a raw zfb collection entry onto the `DocPageEntry` shape the factories
- *  expect (Astro-compat `id`/`collection`, with `index` suffix stripped via the
- *  canonical root-slug rule). */
-function bridgeEntry(
-  e: CollectionEntry<DocPageFrontmatter>,
-  collectionName: string,
-): DocPageEntry {
-  return {
-    slug: e.slug,
-    id: toRouteSlug(e.slug),
-    collection: collectionName,
-    data: e.data,
-    body: e.body,
-    module_specifier: e.module_specifier,
-    Content: e.Content,
-  };
-}
-
-function buildBridged(collectionName: string): DocPageEntry[] {
-  const raw = getCollection<DocPageFrontmatter>(collectionName);
-  return raw.map((e) => bridgeEntry(e, collectionName)).filter((d) => !d.data.draft);
+function buildDocs(collectionName: string): DocPageEntry[] {
+  return getCollection<DocPageFrontmatter>(collectionName).filter((entry) => !entry.data.draft);
 }
 
 /**
@@ -77,11 +57,11 @@ function buildBridged(collectionName: string): DocPageEntry[] {
  */
 export function stableDocs(collectionName: string): DocPageEntry[] {
   const anchor = snapshotAnchor(collectionName);
-  if (anchor === undefined) return buildBridged(collectionName);
-  const cached = bridgedByAnchor.get(anchor);
+  if (anchor === undefined) return buildDocs(collectionName);
+  const cached = docsByAnchor.get(anchor);
   if (cached) return cached;
-  const built = buildBridged(collectionName);
-  bridgedByAnchor.set(anchor, built);
+  const built = buildDocs(collectionName);
+  docsByAnchor.set(anchor, built);
   return built;
 }
 
@@ -119,7 +99,7 @@ function toNavNode(node: SidebarNode): DocNavNode {
 function findRootIndexDoc(docs: DocPageEntry[]): DocPageEntry | undefined {
   let found: DocPageEntry | undefined;
   for (const d of docs) {
-    const slug = d.data.slug ?? d.id.replace(/\/index$/, "");
+    const slug = d.data.slug ?? toRouteSlug(d.slug);
     if (slug === "") found = d;
   }
   return found;
@@ -169,7 +149,7 @@ export function buildNavTree(
 ): DocNavNode[] {
   const href: BuildHref = options?.buildHref ?? buildHref;
   const sidebarTree = buildSidebarTree(
-    docs.map((d) => ({ id: d.id, data: d.data })),
+    docs,
     locale,
     {
       categoryMeta,

package/routes-src/_virtual.d.ts

@@ -6,6 +6,20 @@
 // The payload is SERIALIZABLE DATA ONLY (ADR Decision 1): `settings`,
 // `translations`, `tagVocabulary`, `colorSchemes`. `_context.ts` narrows it
 // to the concrete `RouteContextPayload` at the seam.
+//
+// SINGLE SOURCE OF TRUTH for three shipped copies (#2656) — edit HERE only:
+//   1. This file itself — typechecks the package's own `src/routes/*.tsx`.
+//   2. `routes-src/_virtual.d.ts` — copied by `scripts/copy-routes-src.mjs`
+//      for downstream `packageOwnedRoutes` consumers.
+//   3. `<package root>/virtual-modules.d.ts` — GENERATED by
+//      `scripts/copy-virtual-modules.mjs` (tsup onSuccess; gitignored like
+//      `routes-src/`), shipped via `tsconfig.base.json`'s `files` so a HOST
+//      project that imports these virtual modules directly (e.g. a `pages/`
+//      re-export stub calling `createRouteContext(routeContext)`) typechecks.
+// Both copy steps rewrite parent-relative `import(...)` specifiers to bare
+// `@takazudo/zudo-doc/*` subpaths, so the relative specifier below stays
+// correct here while the shipped copies resolve from a consumer's
+// node_modules.
 declare module "virtual:zudo-doc-route-context" {
   export const routeContext: {
     settings: unknown;
@@ -15,6 +29,10 @@ declare module "virtual:zudo-doc-route-context" {
      *  `colorSchemes` to `zudoDocPreset` — `_chrome.tsx` falls back to
      *  `DEFAULT_SCHEME` in that case. */
     colorSchemes: Record<string, unknown> | null;
+    /** Resolved, enabled, ordered theme-pack registry (ADR
+     *  `docs/adr/theme-packs.md`, Decision 2). `null` when the routes plugin
+     *  did not thread one. */
+    themePackRegistry: Array<Record<string, unknown>> | null;
   };
 }
 
@@ -27,8 +45,26 @@ declare module "virtual:zudo-doc-route-context" {
 // chromeBindingsModule").
 //
 // Typed via an INLINE `import(...)` type (not a top-level import, which would
-// break this file's ambient module declarations) — see
-// `../factory-context/index.js` for the `ChromeHostBindings` shape.
+// break this file's ambient module declarations) — see the package's
+// factory-context module (`src/factory-context/index.ts`) for the
+// `ChromeHostBindings` shape.
 declare module "virtual:zudo-doc-chrome-bindings" {
   export const chromeBindings: import("@takazudo/zudo-doc/factory-context").ChromeHostBindings;
 }
+
+// Ambient typing for the design-token-panel-config virtual module emitted by
+// the routes plugin (`addVirtualModule("virtual:zudo-doc-design-token-panel-config",
+// …)`, #2658). No on-disk source — materialised at build, either as a
+// re-export of the host's `settings.designTokenPanelConfigModule` file or as
+// a re-export of the package default (`@takazudo/zudo-doc/design-token-panel-config`)
+// when the setting is absent. See `plugins/routes.ts` and this package's
+// `design-token-panel-bootstrap.tsx` for the full contract.
+//
+// Typed via an inline `import(...)` type (not a top-level import, for the
+// same ambient-module-declaration reason as `chromeBindings` above) — see
+// `@takazudo/zdtp`'s `PanelConfig`.
+declare module "virtual:zudo-doc-design-token-panel-config" {
+  export const buildDesignTokenPanelConfig: (
+    mode: "light" | "dark",
+  ) => import("@takazudo/zdtp").PanelConfig;
+}

package/tsconfig.base.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "forceConsistentCasingInFileNames": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowJs": true,
+    "jsx": "preserve",
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "useUnknownInCatchVariables": true,
+    "alwaysStrict": true,
+    "baseUrl": "."
+  },
+  "files": ["./zfb-config-shim.d.ts", "./virtual-modules.d.ts"]
+}

package/virtual-modules.d.ts

@@ -0,0 +1,83 @@
+// GENERATED FILE — DO NOT EDIT.
+// Built from src/routes/_virtual.d.ts by scripts/copy-virtual-modules.mjs
+// (tsup onSuccess), with parent-relative import(...) type specifiers
+// rewritten to bare @takazudo/zudo-doc/* subpaths. Edit the source file and
+// rebuild the package (pnpm --filter @takazudo/zudo-doc build) instead.
+//
+// Host-facing: pulled into consumer projects via tsconfig.base.json's
+// top-level "files" so host code importing the zfb virtual modules
+// (virtual:zudo-doc-route-context / virtual:zudo-doc-chrome-bindings)
+// typechecks. Consumer-level regression proof (tsc/zfb check against a
+// fixture extending tsconfig.base.json) lives in the Wave-5 confirm case
+// (zudolab/zudo-doc#2659).
+
+// Ambient typing for the route-context virtual module emitted by the routes
+// plugin (`addVirtualModule("virtual:zudo-doc-route-context", …)`). The module
+// has no on-disk source — it is materialised at build by the zfb plugin runtime
+// — so this declaration gives the package route entrypoints a typed import.
+//
+// The payload is SERIALIZABLE DATA ONLY (ADR Decision 1): `settings`,
+// `translations`, `tagVocabulary`, `colorSchemes`. `_context.ts` narrows it
+// to the concrete `RouteContextPayload` at the seam.
+//
+// SINGLE SOURCE OF TRUTH for three shipped copies (#2656) — edit HERE only:
+//   1. This file itself — typechecks the package's own `src/routes/*.tsx`.
+//   2. `routes-src/_virtual.d.ts` — copied by `scripts/copy-routes-src.mjs`
+//      for downstream `packageOwnedRoutes` consumers.
+//   3. `<package root>/virtual-modules.d.ts` — GENERATED by
+//      `scripts/copy-virtual-modules.mjs` (tsup onSuccess; gitignored like
+//      `routes-src/`), shipped via `tsconfig.base.json`'s `files` so a HOST
+//      project that imports these virtual modules directly (e.g. a `pages/`
+//      re-export stub calling `createRouteContext(routeContext)`) typechecks.
+// Both copy steps rewrite parent-relative `import(...)` specifiers to bare
+// `@takazudo/zudo-doc/*` subpaths, so the relative specifier below stays
+// correct here while the shipped copies resolve from a consumer's
+// node_modules.
+declare module "virtual:zudo-doc-route-context" {
+  export const routeContext: {
+    settings: unknown;
+    translations: Record<string, Record<string, string>>;
+    tagVocabulary: ReadonlyArray<Record<string, unknown>>;
+    /** Host color-scheme palette map. `null` when the caller did not pass
+     *  `colorSchemes` to `zudoDocPreset` — `_chrome.tsx` falls back to
+     *  `DEFAULT_SCHEME` in that case. */
+    colorSchemes: Record<string, unknown> | null;
+    /** Resolved, enabled, ordered theme-pack registry (ADR
+     *  `docs/adr/theme-packs.md`, Decision 2). `null` when the routes plugin
+     *  did not thread one. */
+    themePackRegistry: Array<Record<string, unknown>> | null;
+  };
+}
+
+// Ambient typing for the chrome-bindings virtual module emitted by the routes
+// plugin (`addVirtualModule("virtual:zudo-doc-chrome-bindings", …)`, #2501).
+// No on-disk source — materialised at build, either as a re-export of the
+// host's `settings.chromeBindingsModule` file or as an empty-object fallback
+// when the setting is absent. See `plugins/routes.ts` and
+// `docs/adr/route-injection-seam.md` ("Host-callables channel —
+// chromeBindingsModule").
+//
+// Typed via an INLINE `import(...)` type (not a top-level import, which would
+// break this file's ambient module declarations) — see the package's
+// factory-context module (`src/factory-context/index.ts`) for the
+// `ChromeHostBindings` shape.
+declare module "virtual:zudo-doc-chrome-bindings" {
+  export const chromeBindings: import("@takazudo/zudo-doc/factory-context").ChromeHostBindings;
+}
+
+// Ambient typing for the design-token-panel-config virtual module emitted by
+// the routes plugin (`addVirtualModule("virtual:zudo-doc-design-token-panel-config",
+// …)`, #2658). No on-disk source — materialised at build, either as a
+// re-export of the host's `settings.designTokenPanelConfigModule` file or as
+// a re-export of the package default (`@takazudo/zudo-doc/design-token-panel-config`)
+// when the setting is absent. See `plugins/routes.ts` and this package's
+// `design-token-panel-bootstrap.tsx` for the full contract.
+//
+// Typed via an inline `import(...)` type (not a top-level import, for the
+// same ambient-module-declaration reason as `chromeBindings` above) — see
+// `@takazudo/zdtp`'s `PanelConfig`.
+declare module "virtual:zudo-doc-design-token-panel-config" {
+  export const buildDesignTokenPanelConfig: (
+    mode: "light" | "dark",
+  ) => import("@takazudo/zdtp").PanelConfig;
+}

package/zfb-config-shim.d.ts

@@ -0,0 +1,210 @@
+// Package-shipped type shim for the bare `zfb/config` specifier (#2656).
+//
+// `@takazudo/zfb` is consumed as a published npm package. The package
+// exposes its real config types under the *scoped* subpath
+// `@takazudo/zfb/config` → `dist/config.d.ts`. But `zfb.config.ts` imports
+// from the *bare* specifier `zfb/config`, which zfb's build tool aliases to
+// a runtime-only stub at parse time (`zfb-config-stub.mjs` — `defineConfig`
+// is identity, carrying no types). No real file backs `zfb/config` in
+// `node_modules`, so this ambient declaration is what supplies the
+// `ZfbConfig` type to `zfb.config.ts`.
+//
+// Pulled into a consuming project via `tsconfig.base.json`'s
+// `files: ["./zfb-config-shim.d.ts", "./virtual-modules.d.ts"]` — a project
+// extending the base no longer needs its own local `zfb-shim.d.ts`.
+//
+// IMPORTANT — this block is the source of truth for the type `zfb check`
+// (plain `tsc --noEmit`) binds against the config. An ambient `declare
+// module` wins over node resolution AND over tsconfig `paths`, so it must
+// be kept in sync BY HAND with the published `@takazudo/zfb/config`
+// (`dist/config.d.ts`). When it lags the engine, valid config fields fail
+// `pnpm check` with TS2353 (see Takazudo/zudo-front-builder#678 +
+// zudolab/zudo-doc#1834 — `bundle` was missing here, blocking next.22's
+// `bundle.exclude`). See `packages/zudo-doc/CLAUDE.md` ("Shipped ambient
+// type shims") for the hand-sync duty this file carries.
+
+declare module "zfb/config" {
+  /** JSX framework runtime. */
+  export type Framework = "preact" | "react";
+
+  /** A content collection registered with the zfb engine. */
+  export interface CollectionDef {
+    /** Identifier used at the call site (e.g. `"docs"`). */
+    name: string;
+    /** Directory (relative to the project root) holding the entries. */
+    path: string;
+    /**
+     * Optional schema. Reserved for v1.1 — accepted but not enforced
+     * today. Authored as zod and converted to JSON Schema via
+     * `z.toJSONSchema()` at the boundary.
+     */
+    schema?: Record<string, unknown>;
+  }
+
+  /** Tailwind options; absent = defaults. */
+  export interface TailwindConfig {
+    enabled?: boolean;
+  }
+
+  /** User-supplied plugin configuration entry. */
+  export interface PluginConfig {
+    name: string;
+    options?: Record<string, unknown>;
+  }
+
+  /** Output mode for zfb fenced-code highlighting. */
+  export type CodeHighlightMode = "inline" | "class";
+
+  /** Fixed semantic taxonomy accepted by class-mode `roleClasses`. */
+  export type CodeHighlightRole =
+    | "escape"
+    | "operator"
+    | "comment"
+    | "string"
+    | "number"
+    | "constant"
+    | "keyword"
+    | "function"
+    | "type"
+    | "namespace"
+    | "property"
+    | "variable"
+    | "tag"
+    | "attribute"
+    | "punctuation"
+    | "inserted"
+    | "deleted"
+    | "heading";
+
+  /** zfb inline-theme or semantic class-mode configuration. */
+  export type CodeHighlightConfig = {
+    theme?: string;
+    themesDir?: string;
+    themeLight?: string;
+    themeDark?: string;
+    mode?: CodeHighlightMode;
+    classPrefix?: string;
+    roleClasses?: Partial<Record<CodeHighlightRole, string>>;
+    defaultStylesheet?: boolean;
+  };
+
+  /**
+   * Bundler options. Mirrors `BundleConfig` in crates/zfb/src/config.rs
+   * and the published `@takazudo/zfb/config` (`dist/config.d.ts`). Added
+   * in next.22 (`bundle.exclude`, #664) and extended in next.23
+   * (`mainFields` / `external`, #676).
+   */
+  export interface BundleConfig {
+    /**
+     * Project-relative, gitignore-style globs for source files the bundler
+     * must NOT pull into the esbuild graph (e.g. test fixtures or
+     * `*.stories.tsx`). Matched files are skipped from the shadow-tree walk
+     * and dropped from any eager `import.meta.glob(...)` expansion.
+     */
+    exclude?: string[];
+    /**
+     * Explicit esbuild `main-fields` for the `--platform=neutral` page/SSR
+     * pass (empty by default under `neutral`), letting CJS-`main`-only deps
+     * resolve. Mirrors `BundleConfig::main_fields`.
+     */
+    mainFields?: string[];
+    /**
+     * Bare specifiers to mark external in the `--platform=neutral` pass so
+     * esbuild leaves them unbundled. Mirrors `BundleConfig::external`.
+     */
+    external?: string[];
+  }
+
+  /** Mirrors the Rust `Config` struct one-for-one. */
+  export interface ZfbConfig {
+    outDir?: string;
+    publicDir?: string;
+    host?: string;
+    port?: number;
+    framework?: Framework;
+    collections?: CollectionDef[];
+    tailwind?: TailwindConfig;
+    /**
+     * Bundler options. `bundle.exclude` keeps project-relative globs out of
+     * the esbuild graph — used e.g. to skip `e2e/fixtures/**` so the MDX link
+     * resolver doesn't walk committed test-fixture trees (silences spurious
+     * broken-link warnings). Mirrors `Config::bundle`.
+     */
+    bundle?: BundleConfig;
+    plugins?: PluginConfig[];
+    adapter?: string;
+    /**
+     * Strip `.md` / `.mdx` from in-page `<a href>` paths and append a
+     * trailing `/` so author-written `[label](other.mdx)` references
+     * resolve to the rendered route URL. Mirrors Config::strip_md_ext
+     * in crates/zfb/src/config.rs (zudolab/zfb#131).
+     */
+    stripMdExt?: boolean;
+    /**
+     * Site base path. Prefixed onto stable HTML asset URLs (CSS / JS
+     * `<link>` and `<script>` tags). Normalised to start AND end with
+     * `/`; `undefined` / `""` / `"/"` all behave identically (no
+     * prefix). Mirrors Config::base in crates/zfb/src/config.rs
+     * (Takazudo/zudo-front-builder#154).
+     */
+    base?: string;
+    /**
+     * Configures zfb's code highlighter. Class mode is mutually exclusive
+     * with every theme field and emits semantic role classes; inline mode
+     * retains the single/dual theme fields for general zfb consumers.
+     */
+    codeHighlight?: CodeHighlightConfig;
+    /**
+     * Markdown link resolver (port of `remarkResolveMarkdownLinks`).
+     * Mirrors `Config::resolve_markdown_links` in crates/zfb/src/config.rs
+     * (Takazudo/zudo-front-builder PR #234 / zudolab/zudo-doc#1577).
+     * When `enabled: true`, the build appends `ResolveLinksPlugin` to the
+     * mdast pipeline so author-written `[label](./other.mdx)` links are
+     * rewritten to the corresponding rendered route URL — bypassing the
+     * file→directory transformation that breaks relative paths in dist
+     * HTML when `foo.mdx` becomes `foo/index.html`.
+     */
+    resolveMarkdownLinks?: {
+      enabled?: boolean;
+      docsDir?: string;
+      dirs?: Array<{ dir: string; routePrefix: string }>;
+      onBrokenLinks?: "warn" | "error" | "ignore";
+    };
+    /**
+     * Whether the basePath rewriter should append a trailing `/` to
+     * extensionless absolute hrefs. Mirrors `Config::trailing_slash` in
+     * crates/zfb/src/config.rs (Takazudo/zudo-front-builder PR #234 /
+     * zudolab/zudo-doc#1579). Off by default — preserves byte-for-byte
+     * parity with the pre-`trailingSlash` build for projects that
+     * haven't opted in.
+     */
+    trailingSlash?: boolean;
+    /**
+     * Minify production HTML output from `zfb build`.
+     * Mirrors `Config::minify_html` in crates/zfb/src/config.rs.
+     */
+    minifyHtml?: boolean;
+    /**
+     * Markdown / MDX pipeline options. Mirrors `Config::markdown` →
+     * `MarkdownConfig` in crates/zfb/src/config.rs. zfb next.12 moved the
+     * former-Core features under `markdown.features` and next.13 ships the
+     * rest as opt-in; zudo-doc uses `markdown.features` to opt back into the
+     * former-Core four plus the additional opt-in features (#1804). Each
+     * `features` value is per-feature: `true` for boolean-shorthand features,
+     * or an options object for object-typed features.
+     */
+    markdown?: {
+      gfm?: boolean | Record<string, boolean>;
+      toc?: Record<string, unknown>;
+      externalLinks?: Record<string, unknown>;
+      cjkFriendly?: boolean;
+      features?: Record<string, boolean | Record<string, unknown>>;
+    };
+  }
+
+  /**
+   * Identity helper: returns the supplied config as-is, but typed
+   * against `ZfbConfig`. Use as the default export of `zfb.config.ts`.
+   */
+  export function defineConfig(config: ZfbConfig): ZfbConfig;
+}

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

@@ -1,33 +0,0 @@
-/**
- * Public entry for `@takazudo/zudo-doc/integrations/llms-txt`.
- *
- * Framework-agnostic build emitter that produces `dist/llms.txt` and
- * `dist/llms-full.txt` (plus per-locale variants) with byte-identical
- * format vs the legacy Astro integration in
- * `src/integrations/llms-txt.ts`.
- *
- * Typical zfb registration (see ./README.md for the full snippet):
- *
- *   import { emitLlmsTxt } from "@takazudo/zudo-doc/integrations/llms-txt";
- *
- *   // inside a zfb plugin's onBuildDone hook
- *   emitLlmsTxt({
- *     outDir,
- *     siteName: "...",
- *     siteDescription: "...",
- *     base: "/",
- *     defaultLocaleDir: "src/content/docs",
- *     locales: [{ code: "ja", dir: "src/content/docs-ja" }],
- *   });
- *
- * The pure `generate*` and `loadDocEntries` helpers are exported as well
- * so a zfb non-HTML page (`pages/llms.txt.tsx`) or a unit test can build
- * the strings directly without touching the filesystem twice.
- */
-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/theme/color-tweak-export-modal.d.ts

@@ -1,16 +0,0 @@
-import { type DesignTokenManifest } from "./design-token-serde.js";
-import { type ColorTweakState, type TweakState } from "./design-token-types.js";
-interface DesignTokenExportModalProps {
-    onClose: () => void;
-    /** Full unified tweak state — the modal serializes all four categories. */
-    state: TweakState;
-    /** Token manifest (spacing / font / size arrays) used by serialize() to
-     *  compute diff-only output. The caller is expected to forward the same
-     *  manifest the panel was configured with. */
-    manifest: DesignTokenManifest;
-    /** Color baseline used for diff-only output. Optional: callers without DOM
-     *  access (tests) can omit and we'll treat the entire color block as changed. */
-    colorDefaults?: ColorTweakState;
-}
-export default function ColorTweakExportModal({ onClose, state, manifest, colorDefaults, }: DesignTokenExportModalProps): import("preact").JSX.Element;
-export {};

package/dist/theme/color-tweak-export-modal.js

@@ -1,138 +0,0 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
-import { useState, useEffect, useMemo, useRef } from "preact/hooks";
-import { serialize } from "./design-token-serde.js";
-import {
-} from "./design-token-types.js";
-const EXPORT_FILENAME_HINT = "zudo-doc-tokens.json";
-function resolveColorDefaults(fallback, explicit) {
-  return explicit ?? fallback;
-}
-function ColorTweakExportModal({
-  onClose,
-  state,
-  manifest,
-  colorDefaults
-}) {
-  const [copyLabel, setCopyLabel] = useState("Copy");
-  const [includeDefaults, setIncludeDefaults] = useState(false);
-  const dialogRef = useRef(null);
-  const copyTimerRef = useRef(null);
-  const code = useMemo(() => {
-    const baseline = resolveColorDefaults(state.color, colorDefaults);
-    const json = serialize(state, {
-      manifest,
-      includeDefaults,
-      colorDefaults: baseline
-    });
-    return JSON.stringify(json, null, 2);
-  }, [state, manifest, colorDefaults, includeDefaults]);
-  useEffect(() => {
-    const dialog = dialogRef.current;
-    if (!dialog) return;
-    dialog.showModal();
-    return () => {
-      if (dialog.open) dialog.close();
-    };
-  }, []);
-  useEffect(() => {
-    const dialog = dialogRef.current;
-    if (!dialog) return;
-    function handleClose() {
-      onClose();
-    }
-    dialog.addEventListener("close", handleClose);
-    return () => dialog.removeEventListener("close", handleClose);
-  }, [onClose]);
-  useEffect(() => {
-    return () => {
-      if (copyTimerRef.current) clearTimeout(copyTimerRef.current);
-    };
-  }, []);
-  function handleBackdropClick(e) {
-    const dialog = dialogRef.current;
-    if (!dialog) return;
-    const rect = dialog.getBoundingClientRect();
-    if (e.clientX < rect.left || e.clientX > rect.right || e.clientY < rect.top || e.clientY > rect.bottom) {
-      dialog.close();
-    }
-  }
-  async function handleCopy() {
-    let ok = false;
-    const dialog = dialogRef.current;
-    if (dialog) {
-      try {
-        const textarea = document.createElement("textarea");
-        textarea.value = code;
-        textarea.style.cssText = "position:fixed;opacity:0;left:-9999px";
-        dialog.appendChild(textarea);
-        textarea.focus();
-        textarea.select();
-        ok = document.execCommand("copy");
-        dialog.removeChild(textarea);
-      } catch {
-      }
-    }
-    if (!ok) {
-      try {
-        await navigator.clipboard.writeText(code);
-        ok = true;
-      } catch {
-      }
-    }
-    setCopyLabel(ok ? "Copied!" : "Failed");
-    if (copyTimerRef.current) clearTimeout(copyTimerRef.current);
-    copyTimerRef.current = setTimeout(() => setCopyLabel("Copy"), 2e3);
-  }
-  return /* @__PURE__ */ jsxs(
-    "dialog",
-    {
-      ref: dialogRef,
-      onClick: handleBackdropClick,
-      className: "mx-auto max-h-[80vh] w-full max-w-[46rem] overflow-y-auto border border-muted bg-surface p-hsp-xl backdrop:bg-bg/80",
-      style: { color: "var(--color-fg)", position: "fixed", top: "50%", left: "50%", transform: "translate(-50%, -50%)", userSelect: "text" },
-      children: [
-        /* @__PURE__ */ jsx("h2", { className: "mb-vsp-sm text-title font-bold text-fg", children: "Export Design Tokens" }),
-        /* @__PURE__ */ jsxs("p", { className: "mb-vsp-xs text-small text-muted", children: [
-          "Save as ",
-          /* @__PURE__ */ jsx("code", { className: "text-fg", children: EXPORT_FILENAME_HINT }),
-          " to feed this blob back into the panel (or hand to an AI assistant)."
-        ] }),
-        /* @__PURE__ */ jsxs("label", { className: "mb-vsp-xs flex items-center gap-x-hsp-sm text-small text-fg", children: [
-          /* @__PURE__ */ jsx(
-            "input",
-            {
-              type: "checkbox",
-              checked: includeDefaults,
-              onChange: (e) => setIncludeDefaults(e.currentTarget.checked)
-            }
-          ),
-          "Show defaults too"
-        ] }),
-        /* @__PURE__ */ jsx("pre", { className: "overflow-x-auto border border-muted bg-code-bg p-hsp-lg text-small text-code-fg", children: /* @__PURE__ */ jsx("code", { children: code }) }),
-        /* @__PURE__ */ jsxs("div", { className: "mt-vsp-sm flex items-center gap-x-hsp-md", children: [
-          /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              onClick: handleCopy,
-              className: "border border-muted bg-surface px-hsp-lg py-vsp-2xs text-small text-fg transition-colors hover:border-accent hover:text-accent",
-              children: copyLabel
-            }
-          ),
-          /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              onClick: () => dialogRef.current?.close(),
-              className: "border border-muted bg-surface px-hsp-lg py-vsp-2xs text-small text-muted transition-colors hover:border-fg hover:text-fg",
-              children: "Close"
-            }
-          )
-        ] })
-      ]
-    }
-  );
-}
-export {
-  ColorTweakExportModal as default
-};