@takazudo/zudo-doc 0.2.21 → 1.0.0

package/dist/color-scheme-utils.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Color-scheme MECHANISM — palette → `--zd-*` CSS custom-property injection.
+ *
+ * This module ships the pure computation layer used by every project that
+ * builds on @takazudo/zudo-doc. It is DATA-free: callers pass in their own
+ * color-scheme manifest and settings.
+ *
+ * Moved from the host's `src/config/color-scheme-utils.ts` as part of the
+ * package-first migration (S9a zudolab/zudo-doc#2333). The DATA (palette
+ * values, scheme names, `colorMode` settings) stays project-side.
+ */
+/** A color reference: palette index (number) or direct color value (string) */
+export type ColorRef = number | string;
+export interface ColorScheme {
+    background: ColorRef;
+    foreground: ColorRef;
+    cursor: ColorRef;
+    selectionBg: ColorRef;
+    selectionFg: ColorRef;
+    palette: [
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string
+    ];
+    /** Optional, vestigial — no visible effect on rendering; carried only for
+     *  the zdtp design-token panel config envelope. See project CLAUDE.md. */
+    shikiTheme?: string;
+    /** Optional semantic overrides. When omitted, defaults from
+     *  `SEMANTIC_DEFAULTS` are used (surface=p0, muted=p8, accent=p5, …). */
+    semantic?: {
+        surface?: ColorRef;
+        muted?: ColorRef;
+        accent?: ColorRef;
+        accentHover?: ColorRef;
+        codeBg?: ColorRef;
+        codeFg?: ColorRef;
+        success?: ColorRef;
+        danger?: ColorRef;
+        warning?: ColorRef;
+        info?: ColorRef;
+        mermaidNodeBg?: ColorRef;
+        mermaidText?: ColorRef;
+        mermaidLine?: ColorRef;
+        mermaidLabelBg?: ColorRef;
+        mermaidNoteBg?: ColorRef;
+        chatUserBg?: ColorRef;
+        chatUserText?: ColorRef;
+        chatAssistantBg?: ColorRef;
+        chatAssistantText?: ColorRef;
+        /** UI chrome over user images — enlarge/close overlay buttons */
+        imageOverlayBg?: ColorRef;
+        imageOverlayFg?: ColorRef;
+        /** <mark> highlight for matched keywords in search results */
+        matchedKeywordBg?: ColorRef;
+        matchedKeywordFg?: ColorRef;
+    };
+}
+/** Default mapping: semantic token name → palette index */
+export declare const SEMANTIC_DEFAULTS: Record<string, number>;
+export declare const SEMANTIC_CSS_NAMES: Record<string, string>;
+/** Resolve a ColorRef to a concrete color string.
+ *  - number → palette[value]
+ *  - string → used as-is
+ *  - undefined → fallback */
+export declare function resolveColor(value: ColorRef | undefined, palette: string[], fallback: string): string;
+/** Resolve semantic colors with fallbacks to default palette slots */
+export declare function resolveSemanticColors(scheme: ColorScheme): {
+    surface: string;
+    muted: string;
+    accent: string;
+    accentHover: string;
+    codeBg: string;
+    codeFg: string;
+    success: string;
+    danger: string;
+    warning: string;
+    info: string;
+    mermaidNodeBg: string;
+    mermaidText: string;
+    mermaidLine: string;
+    mermaidLabelBg: string;
+    mermaidNoteBg: string;
+    chatUserBg: string;
+    chatUserText: string;
+    chatAssistantBg: string;
+    chatAssistantText: string;
+    imageOverlayBg: string;
+    imageOverlayFg: string;
+    matchedKeywordBg: string;
+    matchedKeywordFg: string;
+};
+/** Convert a ColorScheme to a flat list of [cssProperty, value] pairs.
+ *  The result is the exact set of `--zd-*` custom properties that the
+ *  ColorSchemeProvider emits onto `:root`. */
+export declare function schemeToCssPairs(scheme: ColorScheme): [string, string][];
+/**
+ * Generate the `:root { --zd-* }` CSS block for a single active color scheme.
+ *
+ * The caller passes in the active `ColorScheme` object — resolved from the
+ * project's `colorSchemes` map and `settings.colorScheme`. This function is
+ * DATA-free: it performs no settings lookup itself.
+ */
+export declare function generateCssCustomProperties(scheme: ColorScheme): string;
+/**
+ * Generate the `:root { --zd-*: light-dark(…, …); }` CSS block for a
+ * light/dark pair.
+ *
+ * The caller passes in the `light` and `dark` `ColorScheme` objects — resolved
+ * from the project's `colorSchemes` map and `settings.colorMode`. This
+ * function is DATA-free.
+ */
+export declare function generateLightDarkCssProperties(light: ColorScheme, dark: ColorScheme): string;

package/dist/color-scheme-utils.js

@@ -0,0 +1,151 @@
+const SEMANTIC_DEFAULTS = {
+  surface: 0,
+  muted: 8,
+  accent: 5,
+  accentHover: 14,
+  codeBg: 10,
+  codeFg: 11,
+  success: 2,
+  danger: 1,
+  warning: 3,
+  info: 4,
+  mermaidNodeBg: 9,
+  mermaidText: 11,
+  mermaidLine: 8,
+  mermaidLabelBg: 10,
+  mermaidNoteBg: 0,
+  chatUserBg: 5,
+  chatUserText: 9,
+  chatAssistantBg: 9,
+  chatAssistantText: 11,
+  imageOverlayBg: 0,
+  imageOverlayFg: 11,
+  matchedKeywordBg: 3,
+  matchedKeywordFg: 15
+};
+const SEMANTIC_CSS_NAMES = {
+  surface: "--zd-surface",
+  muted: "--zd-muted",
+  accent: "--zd-accent",
+  accentHover: "--zd-accent-hover",
+  codeBg: "--zd-code-bg",
+  codeFg: "--zd-code-fg",
+  success: "--zd-success",
+  danger: "--zd-danger",
+  warning: "--zd-warning",
+  info: "--zd-info",
+  mermaidNodeBg: "--zd-mermaid-node-bg",
+  mermaidText: "--zd-mermaid-text",
+  mermaidLine: "--zd-mermaid-line",
+  mermaidLabelBg: "--zd-mermaid-label-bg",
+  mermaidNoteBg: "--zd-mermaid-note-bg",
+  chatUserBg: "--zd-chat-user-bg",
+  chatUserText: "--zd-chat-user-text",
+  chatAssistantBg: "--zd-chat-assistant-bg",
+  chatAssistantText: "--zd-chat-assistant-text",
+  imageOverlayBg: "--zd-image-overlay-bg",
+  imageOverlayFg: "--zd-image-overlay-fg",
+  matchedKeywordBg: "--zd-matched-keyword-bg",
+  matchedKeywordFg: "--zd-matched-keyword-fg"
+};
+function resolveColor(value, palette, fallback) {
+  if (value === void 0) return fallback;
+  if (typeof value === "number") return palette[value] ?? fallback;
+  return value;
+}
+function resolveSemanticColors(scheme) {
+  const p = scheme.palette;
+  return {
+    surface: resolveColor(scheme.semantic?.surface, p, p[0]),
+    muted: resolveColor(scheme.semantic?.muted, p, p[8]),
+    accent: resolveColor(scheme.semantic?.accent, p, p[5]),
+    accentHover: resolveColor(scheme.semantic?.accentHover, p, p[14]),
+    codeBg: resolveColor(scheme.semantic?.codeBg, p, p[10]),
+    codeFg: resolveColor(scheme.semantic?.codeFg, p, p[11]),
+    success: resolveColor(scheme.semantic?.success, p, p[2]),
+    danger: resolveColor(scheme.semantic?.danger, p, p[1]),
+    warning: resolveColor(scheme.semantic?.warning, p, p[3]),
+    info: resolveColor(scheme.semantic?.info, p, p[4]),
+    mermaidNodeBg: resolveColor(scheme.semantic?.mermaidNodeBg, p, p[9]),
+    mermaidText: resolveColor(scheme.semantic?.mermaidText, p, p[11]),
+    mermaidLine: resolveColor(scheme.semantic?.mermaidLine, p, p[8]),
+    mermaidLabelBg: resolveColor(scheme.semantic?.mermaidLabelBg, p, p[10]),
+    mermaidNoteBg: resolveColor(scheme.semantic?.mermaidNoteBg, p, p[0]),
+    chatUserBg: resolveColor(scheme.semantic?.chatUserBg, p, p[5]),
+    chatUserText: resolveColor(scheme.semantic?.chatUserText, p, p[9]),
+    chatAssistantBg: resolveColor(scheme.semantic?.chatAssistantBg, p, p[9]),
+    chatAssistantText: resolveColor(scheme.semantic?.chatAssistantText, p, p[11]),
+    imageOverlayBg: resolveColor(scheme.semantic?.imageOverlayBg, p, p[0]),
+    imageOverlayFg: resolveColor(scheme.semantic?.imageOverlayFg, p, p[11]),
+    matchedKeywordBg: resolveColor(scheme.semantic?.matchedKeywordBg, p, p[3]),
+    matchedKeywordFg: resolveColor(scheme.semantic?.matchedKeywordFg, p, p[15])
+  };
+}
+function schemeToCssPairs(scheme) {
+  const p = scheme.palette;
+  const sem = resolveSemanticColors(scheme);
+  return [
+    ["--zd-bg", resolveColor(scheme.background, p, p[0])],
+    ["--zd-fg", resolveColor(scheme.foreground, p, p[15])],
+    ["--zd-cursor", resolveColor(scheme.cursor, p, p[6])],
+    // intentionally inert/vestigial: exposed in the design-token panel but no CSS rule consumes it (no caret-color wiring); mirrors shikiTheme's status
+    ["--zd-sel-bg", resolveColor(scheme.selectionBg, p, resolveColor(scheme.background, p, p[0]))],
+    ["--zd-sel-fg", resolveColor(scheme.selectionFg, p, resolveColor(scheme.foreground, p, p[15]))],
+    ...p.map((color, i) => [`--zd-${i}`, color]),
+    ["--zd-surface", sem.surface],
+    ["--zd-muted", sem.muted],
+    ["--zd-accent", sem.accent],
+    ["--zd-accent-hover", sem.accentHover],
+    ["--zd-code-bg", sem.codeBg],
+    ["--zd-code-fg", sem.codeFg],
+    ["--zd-success", sem.success],
+    ["--zd-danger", sem.danger],
+    ["--zd-warning", sem.warning],
+    ["--zd-info", sem.info],
+    ["--zd-mermaid-node-bg", sem.mermaidNodeBg],
+    ["--zd-mermaid-text", sem.mermaidText],
+    ["--zd-mermaid-line", sem.mermaidLine],
+    ["--zd-mermaid-label-bg", sem.mermaidLabelBg],
+    ["--zd-mermaid-note-bg", sem.mermaidNoteBg],
+    ["--zd-chat-user-bg", sem.chatUserBg],
+    ["--zd-chat-user-text", sem.chatUserText],
+    ["--zd-chat-assistant-bg", sem.chatAssistantBg],
+    ["--zd-chat-assistant-text", sem.chatAssistantText],
+    ["--zd-image-overlay-bg", sem.imageOverlayBg],
+    ["--zd-image-overlay-fg", sem.imageOverlayFg],
+    ["--zd-matched-keyword-bg", sem.matchedKeywordBg],
+    ["--zd-matched-keyword-fg", sem.matchedKeywordFg]
+  ];
+}
+function generateCssCustomProperties(scheme) {
+  const pairs = schemeToCssPairs(scheme);
+  const lines = [":root {", ...pairs.map(([prop, value]) => `  ${prop}: ${value};`), "}"];
+  return lines.join("\n");
+}
+function generateLightDarkCssProperties(light, dark) {
+  const lightPairs = schemeToCssPairs(light);
+  const darkPairs = schemeToCssPairs(dark);
+  if (lightPairs.length !== darkPairs.length) {
+    throw new Error(`Light scheme has ${lightPairs.length} properties but dark scheme has ${darkPairs.length}`);
+  }
+  const lines = [":root {", "  color-scheme: light dark;"];
+  for (let i = 0; i < lightPairs.length; i++) {
+    const lightPair = lightPairs[i];
+    const darkPair = darkPairs[i];
+    if (!lightPair || !darkPair) continue;
+    const [prop, lightVal] = lightPair;
+    const darkVal = darkPair[1];
+    lines.push(`  ${prop}: light-dark(${lightVal}, ${darkVal});`);
+  }
+  lines.push("}");
+  return lines.join("\n");
+}
+export {
+  SEMANTIC_CSS_NAMES,
+  SEMANTIC_DEFAULTS,
+  generateCssCustomProperties,
+  generateLightDarkCssProperties,
+  resolveColor,
+  resolveSemanticColors,
+  schemeToCssPairs
+};

package/dist/compose-meta-title/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Create a `composeMetaTitle` helper bound to the given site name.
+ *
+ * Mirrors the shape of `makeUrlHelpers` (S1a) — the host stub calls this
+ * once with its concrete `settings.siteName` and re-exports the result.
+ */
+export declare function createComposeMetaTitle(siteName: string): (title: string) => string;

package/dist/compose-meta-title/index.js

@@ -0,0 +1,10 @@
+function createComposeMetaTitle(siteName) {
+  return function composeMetaTitle(title) {
+    if (!siteName) return title;
+    if (title === siteName) return siteName;
+    return `${title} | ${siteName}`;
+  };
+}
+export {
+  createComposeMetaTitle
+};

package/dist/content/component-map.d.ts

@@ -1,16 +1,14 @@
-import { HeadingH2 } from './heading-h2.js';
-import { HeadingH3 } from './heading-h3.js';
-import { HeadingH4 } from './heading-h4.js';
-import { ContentParagraph } from './content-paragraph.js';
-import { ContentLink } from './content-link.js';
-import { ContentStrong } from './content-strong.js';
-import { ContentBlockquote } from './content-blockquote.js';
-import { ContentUl } from './content-ul.js';
-import { ContentOl } from './content-ol.js';
-import { ContentTable } from './content-table.js';
-import { ContentCode } from './content-code.js';
-import 'preact';
-
+import { HeadingH2 } from "./heading-h2.js";
+import { HeadingH3 } from "./heading-h3.js";
+import { HeadingH4 } from "./heading-h4.js";
+import { ContentParagraph } from "./content-paragraph.js";
+import { ContentLink } from "./content-link.js";
+import { ContentStrong } from "./content-strong.js";
+import { ContentBlockquote } from "./content-blockquote.js";
+import { ContentUl } from "./content-ul.js";
+import { ContentOl } from "./content-ol.js";
+import { ContentTable } from "./content-table.js";
+import { ContentCode } from "./content-code.js";
 /**
  * MDX component overrides map for the HTML elements used in doc content.
  *
@@ -18,7 +16,7 @@ import 'preact';
  * into a larger components object that also includes admonition overrides,
  * custom shortcodes, etc.) at the Astro page layer.
  */
-declare const htmlOverrides: {
+export declare const htmlOverrides: {
     h2: typeof HeadingH2;
     h3: typeof HeadingH3;
     h4: typeof HeadingH4;
@@ -34,7 +32,7 @@ declare const htmlOverrides: {
 /**
  * Alias for `htmlOverrides`. Prefer this name in new consumer code.
  */
-declare const defaultComponents: {
+export declare const defaultComponents: {
     h2: typeof HeadingH2;
     h3: typeof HeadingH3;
     h4: typeof HeadingH4;
@@ -47,5 +45,3 @@ declare const defaultComponents: {
     table: typeof ContentTable;
     code: typeof ContentCode;
 };
-
-export { defaultComponents, htmlOverrides };

package/dist/content/content-blockquote.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["blockquote"];
-declare function ContentBlockquote({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentBlockquote };
+export declare function ContentBlockquote({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-code.d.ts

@@ -1,8 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["code"];
 /**
  * Override for inline `<code>` in MDX. Wraps text-only inline code with
@@ -19,6 +17,5 @@ type Props = JSX.IntrinsicElements["code"];
  * `extractText` unwraps that so the heuristic works regardless of MDX's
  * internal wrapping.
  */
-declare function ContentCode({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentCode };
+export declare function ContentCode({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-code.js

@@ -1,5 +1,5 @@
 import { jsx } from "preact/jsx-runtime";
-import { SmartBreak as SmartBreakImpl } from "../toc/smart-break.js";
+import { SmartBreak as SmartBreakImpl } from "../smart-break/index.js";
 const SmartBreak = SmartBreakImpl;
 function ContentCode({ children, className, ...rest }) {
   const isShikiBlock = typeof className === "string" && /(^|\s)language-/.test(className);

package/dist/content/content-link.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["a"];
-declare function ContentLink({ href, className, children, ...rest }: Props): JSX.Element;
-
-export { ContentLink };
+export declare function ContentLink({ href, className, children, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-link.js

@@ -1,5 +1,5 @@
 import { jsx } from "preact/jsx-runtime";
-import { SmartBreak as SmartBreakBase } from "../toc/smart-break.js";
+import { SmartBreak as SmartBreakBase } from "../smart-break/index.js";
 const SmartBreak = SmartBreakBase;
 function ContentLink({ href, className, children, ...rest }) {
   const classes = typeof className === "string" ? className.split(" ") : [];

package/dist/content/content-ol.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["ol"];
-declare function ContentOl({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentOl };
+export declare function ContentOl({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-paragraph.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["p"];
-declare function ContentParagraph({ children, ...rest }: Props): JSX.Element;
-
-export { ContentParagraph };
+export declare function ContentParagraph({ children, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-strong.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["strong"];
-declare function ContentStrong({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentStrong };
+export declare function ContentStrong({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-table.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["table"];
-declare function ContentTable({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentTable };
+export declare function ContentTable({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-ul.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["ul"];
-declare function ContentUl({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentUl };
+export declare function ContentUl({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/heading-h2.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["h2"];
-declare function HeadingH2({ id, children, className, ...rest }: Props): JSX.Element;
-
-export { HeadingH2 };
+export declare function HeadingH2({ id, children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/heading-h3.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["h3"];
-declare function HeadingH3({ id, children, className, ...rest }: Props): JSX.Element;
-
-export { HeadingH3 };
+export declare function HeadingH3({ id, children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/heading-h4.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["h4"];
-declare function HeadingH4({ id, children, className, ...rest }: Props): JSX.Element;
-
-export { HeadingH4 };
+export declare function HeadingH4({ id, children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/index.d.ts

@@ -1,13 +1,29 @@
-export { HeadingH2 } from './heading-h2.js';
-export { HeadingH3 } from './heading-h3.js';
-export { HeadingH4 } from './heading-h4.js';
-export { ContentParagraph } from './content-paragraph.js';
-export { ContentLink } from './content-link.js';
-export { ContentStrong } from './content-strong.js';
-export { ContentBlockquote } from './content-blockquote.js';
-export { ContentUl } from './content-ul.js';
-export { ContentOl } from './content-ol.js';
-export { ContentTable } from './content-table.js';
-export { ContentCode } from './content-code.js';
-export { defaultComponents, htmlOverrides } from './component-map.js';
-import 'preact';
+/**
+ * Public entry for `@takazudo/zudo-doc/content`.
+ *
+ * Exports the 11 MDX typography override components and the pre-assembled
+ * component map. Consumers compose the map at the Astro page layer:
+ *
+ *   import { defaultComponents } from "@takazudo/zudo-doc/content";
+ *
+ *   const components = {
+ *     ...defaultComponents,
+ *     Note,
+ *     Tip,
+ *     // ... admonitions, shortcodes, etc.
+ *   };
+ *
+ *   <Content components={components} />
+ */
+export { HeadingH2 } from "./heading-h2.js";
+export { HeadingH3 } from "./heading-h3.js";
+export { HeadingH4 } from "./heading-h4.js";
+export { ContentParagraph } from "./content-paragraph.js";
+export { ContentLink } from "./content-link.js";
+export { ContentStrong } from "./content-strong.js";
+export { ContentBlockquote } from "./content-blockquote.js";
+export { ContentUl } from "./content-ul.js";
+export { ContentOl } from "./content-ol.js";
+export { ContentTable } from "./content-table.js";
+export { ContentCode } from "./content-code.js";
+export { htmlOverrides, defaultComponents } from "./component-map.js";

package/dist/content-admonition/index.d.ts

@@ -0,0 +1,15 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { ComponentChildren, VNode } from "preact";
+export type AdmonitionVariant = "note" | "tip" | "info" | "warning" | "danger" | "caution" | "important";
+export interface AdmonitionProps {
+    /** Custom title; falls back to the capitalized variant name (e.g. "Note"). */
+    title?: string;
+    children?: ComponentChildren;
+}
+/**
+ * Build the admonition component for a single variant. The title row is always
+ * rendered — defaulting to the capitalized variant name when the author gives
+ * no `title` — matching the Astro reference where every callout shows a title.
+ */
+export declare function makeAdmonition(variant: AdmonitionVariant): ({ title, children }: AdmonitionProps) => VNode;

package/dist/content-admonition/index.js

@@ -0,0 +1,14 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+function makeAdmonition(variant) {
+  const defaultTitle = variant.charAt(0).toUpperCase() + variant.slice(1);
+  return function Admonition({ title, children }) {
+    const heading = title && title.length > 0 ? title : defaultTitle;
+    return /* @__PURE__ */ jsxs("div", { "data-admonition": variant, class: `admonition admonition-${variant}`, children: [
+      /* @__PURE__ */ jsx("p", { class: "admonition-title", children: heading }),
+      /* @__PURE__ */ jsx("div", { class: "admonition-body", children })
+    ] });
+  };
+}
+export {
+  makeAdmonition
+};

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

@@ -0,0 +1,38 @@
+/**
+ * Design-token panel (zdtp) WIRING MECHANISM.
+ *
+ * A side-effect module that calls `configurePanel(panelConfig)` and wires
+ * zdtp's lifecycle hooks to zfb's navigation events via
+ * `setLifecycleAdapter()`. Projects import this with their own
+ * `designTokenPanelConfig` object — the DATA stays project-side.
+ *
+ * Usage (project-side `src/lib/design-token-panel-bootstrap.ts`):
+ *
+ *   import { bootstrapDesignTokenPanel } from "@takazudo/zudo-doc/design-token-panel-bootstrap";
+ *   import { designTokenPanelConfig } from "@/config/design-token-panel-config";
+ *   bootstrapDesignTokenPanel(designTokenPanelConfig);
+ *
+ * Moved from the host's `src/lib/design-token-panel-bootstrap.ts` as part of
+ * the package-first migration (S9a zudolab/zudo-doc#2333). The PanelConfig
+ * DATA stays project-side.
+ *
+ * CSS is pulled via `@import "@takazudo/zdtp/styles.css"` in the project's
+ * `src/styles/global.css` so the panel chrome lands in the main page CSS
+ * bundle (not a deferred chunk). Vite library mode strips the source CSS
+ * import from the emitted JS, so the explicit CSS-side import is the
+ * required pull point. See @takazudo/zdtp PORTABLE-CONTRACT.md §7.
+ */
+import { type PanelConfig } from "@takazudo/zdtp";
+/**
+ * Bootstrap zdtp for a project. Calls `configurePanel(panelConfig)`,
+ * drains any pre-hydration click queue, and wires the zdtp lifecycle
+ * adapter to zfb's navigation events so persisted token overrides are
+ * re-applied on every soft navigation.
+ *
+ * Call this once, as a side-effect import from the project's island
+ * wrapper (`src/components/design-token-panel-bootstrap.tsx`).
+ *
+ * @param panelConfig - The project's `PanelConfig` object (data stays
+ *   project-side in `src/config/design-token-panel-config.ts`).
+ */
+export declare function bootstrapDesignTokenPanel(panelConfig: PanelConfig): void;