@takazudo/zudo-doc 0.1.0

package/dist/content/heading-h3.js

@@ -0,0 +1,18 @@
+import { jsx } from "preact/jsx-runtime";
+function HeadingH3({ id, children, className, ...rest }) {
+  return /* @__PURE__ */ jsx(
+    "h3",
+    {
+      id,
+      className: `text-body font-bold leading-snug pt-vsp-xs border-t-[2px] border-transparent${className ? ` ${className}` : ""}`,
+      style: {
+        borderImage: "linear-gradient(to right, var(--color-muted), transparent) 1"
+      },
+      ...rest,
+      children
+    }
+  );
+}
+export {
+  HeadingH3
+};

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

@@ -0,0 +1,14 @@
+import { ComponentChildren, JSX } from 'preact';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+type Props = {
+    id?: string;
+    className?: string;
+    children?: ComponentChildren;
+    [key: string]: any;
+};
+declare function HeadingH4({ id, children, className, ...rest }: Props): JSX.Element;
+
+export { HeadingH4 };

package/dist/content/heading-h4.js

@@ -0,0 +1,18 @@
+import { jsx } from "preact/jsx-runtime";
+function HeadingH4({ id, children, className, ...rest }) {
+  return /* @__PURE__ */ jsx(
+    "h4",
+    {
+      id,
+      className: `text-body font-semibold leading-snug pt-vsp-xs border-t border-transparent${className ? ` ${className}` : ""}`,
+      style: {
+        borderImage: "linear-gradient(to right, var(--color-muted), transparent) 1"
+      },
+      ...rest,
+      children
+    }
+  );
+}
+export {
+  HeadingH4
+};

package/dist/content/index.d.ts

@@ -0,0 +1,13 @@
+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';

package/dist/content/index.js

@@ -0,0 +1,27 @@
+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 { htmlOverrides, defaultComponents } from "./component-map.js";
+export {
+  ContentBlockquote,
+  ContentCode,
+  ContentLink,
+  ContentOl,
+  ContentParagraph,
+  ContentStrong,
+  ContentTable,
+  ContentUl,
+  HeadingH2,
+  HeadingH3,
+  HeadingH4,
+  defaultComponents,
+  htmlOverrides
+};

package/dist/details/details.d.ts

@@ -0,0 +1,26 @@
+import { ComponentChildren, VNode } from 'preact';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface DetailsProps {
+    /**
+     * Summary / toggle label shown in the `<summary>` element.
+     * Defaults to `"Details"` — the same fallback used by the legacy
+     * `src/components/details.astro`.
+     */
+    title?: string;
+    /** Slot content rendered inside the collapsed body. */
+    children?: ComponentChildren;
+}
+/**
+ * Collapsible `<details>` / `<summary>` block — JSX port of
+ * `src/components/details.astro`.
+ *
+ * Keeps layout and token classes identical to the original template.
+ * The legacy component used Astro's `<slot />`; v2 accepts standard
+ * Preact `children`.
+ */
+declare function Details({ title, children }: DetailsProps): VNode;
+
+export { Details, type DetailsProps };

package/dist/details/details.js

@@ -0,0 +1,10 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+function Details({ title = "Details", children }) {
+  return /* @__PURE__ */ jsxs("details", { class: "my-vsp-md border border-muted rounded-lg overflow-hidden", children: [
+    /* @__PURE__ */ jsx("summary", { class: "cursor-pointer px-hsp-lg py-vsp-sm bg-surface font-medium text-fg select-none hover:text-accent", children: title }),
+    /* @__PURE__ */ jsx("div", { class: "px-hsp-lg py-vsp-sm zd-content", children })
+  ] });
+}
+export {
+  Details
+};

package/dist/details/index.d.ts

@@ -0,0 +1,2 @@
+export { Details, DetailsProps } from './details.js';
+import 'preact';

package/dist/details/index.js

@@ -0,0 +1,4 @@
+import { Details } from "./details.js";
+export {
+  Details
+};

package/dist/doclayout/anchors.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Anchor identifier — the unique fragment after `@slot:doc-layout:` in
+ * the literal anchor text. This is the stable key the drift checker keys
+ * off of; the surrounding comment syntax is derived from `kind`.
+ */
+type DocLayoutAnchorId = "imports" | "frontmatter" | "head-scripts" | "head-links" | "header-call:start" | "header-call:end" | "after-sidebar" | "content-wrapper:start" | "content-wrapper:end" | "breadcrumb:start" | "breadcrumb:end" | "after-breadcrumb" | "after-content" | "footer" | "body-end-components" | "body-end-scripts";
+/**
+ * Whether the anchor lives in the frontmatter region (`---` block in
+ * Astro / module-scope in JSX) or in the body markup region.
+ *
+ * - `frontmatter` anchors are emitted as `// @slot:doc-layout:<id>` line
+ *   comments — both Astro frontmatter and TS module scope accept them.
+ * - `body` anchors are emitted as `<!-- @slot:doc-layout:<id> -->` HTML
+ *   comments — JSX accepts these as `{/* … *\/}` blocks (we keep the
+ *   literal HTML form for byte-for-byte parity with the existing
+ *   create-zudo-doc anchor strings).
+ */
+type DocLayoutAnchorKind = "frontmatter" | "body";
+interface DocLayoutAnchor {
+    readonly id: DocLayoutAnchorId;
+    readonly kind: DocLayoutAnchorKind;
+}
+/**
+ * The 16 doc-layout anchors, in the order they appear in a scaffolded
+ * `doc-layout.astro`. Order is informational (useful for the drift
+ * checker's diagnostic output); identity is what matters.
+ */
+declare const DOC_LAYOUT_ANCHORS: readonly DocLayoutAnchor[];
+/**
+ * Build the literal anchor *comment string* the drift checker greps for
+ * in a scaffolded file.
+ *
+ * - `frontmatter` → `// @slot:doc-layout:<id>`
+ * - `body`        → `<!-- @slot:doc-layout:<id> -->`
+ *
+ * Examples:
+ *   anchorComment({ id: "imports", kind: "frontmatter" })
+ *     // "// @slot:doc-layout:imports"
+ *   anchorComment({ id: "footer", kind: "body" })
+ *     // "<!-- @slot:doc-layout:footer -->"
+ */
+declare function anchorComment(anchor: DocLayoutAnchor): string;
+/**
+ * Convenience: every anchor's comment string, in declaration order. The
+ * drift checker can iterate this and assert each substring appears in the
+ * scaffolded `doc-layout.astro`.
+ */
+declare function allAnchorComments(): readonly string[];
+/**
+ * Convenience: anchor IDs as a typed set. Useful when a caller wants to
+ * verify "is this id one of ours?" without scanning the full list.
+ */
+declare const DOC_LAYOUT_ANCHOR_IDS: ReadonlySet<DocLayoutAnchorId>;
+
+export { DOC_LAYOUT_ANCHORS, DOC_LAYOUT_ANCHOR_IDS, type DocLayoutAnchor, type DocLayoutAnchorId, type DocLayoutAnchorKind, allAnchorComments, anchorComment };

package/dist/doclayout/anchors.js

@@ -0,0 +1,42 @@
+const DOC_LAYOUT_ANCHORS = [
+  { id: "imports", kind: "frontmatter" },
+  { id: "frontmatter", kind: "frontmatter" },
+  { id: "head-scripts", kind: "body" },
+  { id: "head-links", kind: "body" },
+  { id: "header-call:start", kind: "body" },
+  { id: "header-call:end", kind: "body" },
+  { id: "after-sidebar", kind: "body" },
+  { id: "content-wrapper:start", kind: "body" },
+  { id: "content-wrapper:end", kind: "body" },
+  { id: "breadcrumb:start", kind: "body" },
+  { id: "breadcrumb:end", kind: "body" },
+  { id: "after-breadcrumb", kind: "body" },
+  { id: "after-content", kind: "body" },
+  { id: "footer", kind: "body" },
+  { id: "body-end-components", kind: "body" },
+  { id: "body-end-scripts", kind: "body" }
+];
+const EXPECTED_ANCHOR_COUNT = 16;
+if (DOC_LAYOUT_ANCHORS.length !== EXPECTED_ANCHOR_COUNT) {
+  throw new Error(
+    `DOC_LAYOUT_ANCHORS must have exactly ${EXPECTED_ANCHOR_COUNT} entries, got ${DOC_LAYOUT_ANCHORS.length}`
+  );
+}
+function anchorComment(anchor) {
+  if (anchor.kind === "frontmatter") {
+    return `// @slot:doc-layout:${anchor.id}`;
+  }
+  return `<!-- @slot:doc-layout:${anchor.id} -->`;
+}
+function allAnchorComments() {
+  return DOC_LAYOUT_ANCHORS.map(anchorComment);
+}
+const DOC_LAYOUT_ANCHOR_IDS = new Set(
+  DOC_LAYOUT_ANCHORS.map((a) => a.id)
+);
+export {
+  DOC_LAYOUT_ANCHORS,
+  DOC_LAYOUT_ANCHOR_IDS,
+  allAnchorComments,
+  anchorComment
+};

package/dist/doclayout/doc-layout-with-defaults.d.ts

@@ -0,0 +1,83 @@
+import { DocLayoutProps } from './doc-layout.js';
+import { ComponentChildren, JSX } from 'preact';
+import { HeadingItem } from '../toc/types.js';
+import { VersionBannerLabels } from '../i18n-version/version-banner.js';
+export { DOC_LAYOUT_ANCHORS, DOC_LAYOUT_ANCHOR_IDS, DocLayoutAnchor, DocLayoutAnchorId, DocLayoutAnchorKind, allAnchorComments, anchorComment } from './anchors.js';
+
+/** @jsxImportSource preact */
+
+/**
+ * Override slots for the default-bearing wrapper. Any slot that the
+ * caller wants to replace can be passed here; otherwise the package
+ * defaults are used.
+ *
+ * Footer default: a bare `<Footer />` shell so the contentinfo ARIA
+ * landmark is always present. Callers that want full footer content
+ * (link columns, copyright, taglist) pass `footerOverride` with a
+ * host-side data-aware wrapper — see `pages/lib/footer-with-defaults.tsx`.
+ */
+interface DocLayoutWithDefaultsProps extends Omit<DocLayoutProps, "header" | "sidebar" | "toc" | "mobileToc" | "breadcrumb" | "footer" | "main"> {
+    /** The page's article body. Required. */
+    children: ComponentChildren;
+    /** Replace the default site header. */
+    headerOverride?: ComponentChildren;
+    /** Replace the default sidebar contents. */
+    sidebarOverride?: ComponentChildren;
+    /** Replace the default desktop TOC. */
+    tocOverride?: ComponentChildren;
+    /** Replace the default mobile TOC. */
+    mobileTocOverride?: ComponentChildren;
+    /** Replace the default breadcrumb. */
+    breadcrumbOverride?: ComponentChildren;
+    /** Replace the default footer. */
+    footerOverride?: ComponentChildren;
+    /**
+     * Heading items extracted from the page's MDX body. When provided, the
+     * default Toc and MobileToc instances render the full item list in SSG
+     * HTML (anchor links visible to crawlers and JS-off users). Auto-index
+     * pages and pages with no qualifying headings should pass `[]` or omit
+     * this prop — the components gracefully handle both cases.
+     */
+    headings?: readonly HeadingItem[];
+    /**
+     * Absolute canonical URL for this page. When supplied, the host page
+     * should pass this through to `<HeadWithDefaults canonical={...} />` in
+     * the `head` slot so `<link rel="canonical">` is emitted. Compute as:
+     *   settings.siteUrl.replace(/\/$/, '') + pageUrl
+     * when settings.siteUrl is non-empty; omit otherwise.
+     *
+     * This prop is declared here so the host's call sites have a single
+     * place to express the canonical intent. The actual emission happens in
+     * the `head` slot child (HeadWithDefaults).
+     */
+    canonical?: string;
+    /**
+     * Version-banner variant. When set, a `<VersionBanner>` is rendered in
+     * the `afterBreadcrumb` slot. `false` / `undefined` suppress it. This
+     * matches the legacy `version.banner` frontmatter shape.
+     *
+     * The host must also pass `versionBannerLatestUrl` and
+     * `versionBannerLabels` so the banner can render a localized notice
+     * with a link to the latest version of the current page.
+     */
+    versionBanner?: "unmaintained" | "unreleased" | false;
+    /** Pre-resolved href used by the version banner's "view latest" link. */
+    versionBannerLatestUrl?: string;
+    /** Localized labels used by the version banner. */
+    versionBannerLabels?: VersionBannerLabels;
+}
+
+/**
+ * Default-bearing wrapper. Consumers who don't need composable layout
+ * control reach for this; it forwards to `<DocLayout>` and inserts
+ * sensible (and overridable) defaults into each slot.
+ *
+ * The body of this component contains every body-region injection
+ * anchor as a JSX comment expression, so a literal-substring drift
+ * check between this file and the scaffolded `doc-layout.astro` will
+ * find each anchor in both places. JSX comment expressions are
+ * compile-time-only and do not affect runtime output.
+ */
+declare function DocLayoutWithDefaults(props: DocLayoutWithDefaultsProps): JSX.Element;
+
+export { DocLayoutWithDefaults, type DocLayoutWithDefaultsProps };

package/dist/doclayout/doc-layout-with-defaults.js

@@ -0,0 +1,159 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Island } from "@takazudo/zfb";
+import { DocLayout } from "./doc-layout.js";
+import { Sidebar } from "../sidebar/sidebar.js";
+import { Toc } from "../toc/toc.js";
+import { MobileToc } from "../toc/mobile-toc.js";
+import { getTocTitle } from "../toc/toc-title.js";
+import ThemeToggle from "../theme/theme-toggle.js";
+import { Footer } from "../footer/footer.js";
+import { CodeBlockEnhancer } from "../code-syntax/code-block-enhancer.js";
+import { MermaidInit } from "../code-syntax/mermaid-init.js";
+import { TabsInit } from "../code-syntax/tabs-init.js";
+import { VERSION_SWITCHER_INIT_SCRIPT } from "../i18n-version/version-switcher.js";
+import {
+  VersionBanner
+} from "../i18n-version/version-banner.js";
+import {
+  DOC_LAYOUT_ANCHORS,
+  DOC_LAYOUT_ANCHOR_IDS,
+  allAnchorComments,
+  anchorComment
+} from "./anchors.js";
+function DocLayoutWithDefaults(props) {
+  const {
+    children,
+    headerOverride,
+    sidebarOverride,
+    tocOverride,
+    mobileTocOverride,
+    breadcrumbOverride,
+    footerOverride,
+    headings,
+    bodyEndComponents,
+    bodyEndScripts,
+    afterSidebar,
+    afterBreadcrumb,
+    afterContent,
+    head,
+    lang,
+    canonical,
+    versionBanner,
+    versionBannerLatestUrl,
+    versionBannerLabels,
+    ...rest
+  } = props;
+  void canonical;
+  const versionBannerActive = versionBanner !== void 0 && versionBanner !== false;
+  const versionBannerComplete = versionBannerLatestUrl !== void 0 && versionBannerLabels !== void 0;
+  if (versionBannerActive && !versionBannerComplete && typeof process !== "undefined" && process.env?.NODE_ENV !== "production") {
+    const missing = [];
+    if (versionBannerLatestUrl === void 0) missing.push("versionBannerLatestUrl");
+    if (versionBannerLabels === void 0) missing.push("versionBannerLabels");
+    console.warn(
+      `[doc-layout] versionBanner=${String(versionBanner)} requires ${missing.join(
+        " + "
+      )}; banner will be skipped.`
+    );
+  }
+  const composedAfterBreadcrumb = versionBanner !== void 0 && versionBanner !== false && versionBannerLatestUrl !== void 0 && versionBannerLabels !== void 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      VersionBanner,
+      {
+        type: versionBanner,
+        latestUrl: versionBannerLatestUrl,
+        labels: versionBannerLabels
+      }
+    ),
+    afterBreadcrumb
+  ] }) : afterBreadcrumb;
+  const tocHeadings = headings ?? [];
+  const tocTitle = getTocTitle(lang);
+  const shouldRenderDefaultToc = !props.hideToc && tocHeadings.length > 0;
+  const defaultToc = shouldRenderDefaultToc ? Island({
+    when: "load",
+    children: /* @__PURE__ */ jsx(Toc, { headings: tocHeadings, title: tocTitle })
+  }) : void 0;
+  const defaultMobileToc = shouldRenderDefaultToc ? Island({
+    when: "load",
+    children: /* @__PURE__ */ jsx(MobileToc, { headings: tocHeadings, title: tocTitle })
+  }) : void 0;
+  return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(
+    DocLayout,
+    {
+      ...rest,
+      lang,
+      head,
+      header: headerOverride ?? // Minimal default header — surfaces a `<ThemeToggle>` island
+      // so SSG output emits `data-zfb-island="ThemeToggle"` on
+      // every page. Pages with bespoke chrome should pass
+      // `headerOverride` to swap this out wholesale.
+      /* @__PURE__ */ jsx(
+        "header",
+        {
+          class: "sticky top-0 z-50 flex h-[3.5rem] items-center justify-end border-b border-muted bg-surface px-hsp-lg",
+          "data-header": true,
+          children: /* @__PURE__ */ jsx(ThemeToggle, {})
+        }
+      ),
+      sidebar: (
+        // Empty-data Sidebar emits the SSG marker via an explicit
+        // `<Island when="load">` wrap at this call site (not inside
+        // `<Sidebar>` itself) so the bundle's hydrate pass targets
+        // the bare component and Preact doesn't append a duplicate
+        // wrapper-div alongside the SSR'd tree. See `../sidebar/sidebar.tsx`
+        // for the full diagnosis. Hosts that have a real nav tree
+        // pass it through `sidebarOverride` and apply their own
+        // `<Island>` wrap (see `pages/lib/_sidebar-with-defaults.tsx`
+        // in the host project).
+        sidebarOverride ?? Island({
+          when: "load",
+          children: /* @__PURE__ */ jsx(Sidebar, { nodes: [] })
+        })
+      ),
+      toc: tocOverride ?? defaultToc,
+      mobileToc: mobileTocOverride ?? defaultMobileToc,
+      breadcrumb: breadcrumbOverride,
+      afterBreadcrumb: composedAfterBreadcrumb,
+      afterSidebar,
+      afterContent,
+      footer: footerOverride ?? /* @__PURE__ */ jsx(Footer, {}),
+      bodyEndComponents,
+      bodyEndScripts: bodyEndScripts ?? // Default body-end scripts:
+      //   - CodeBlockEnhancer wraps every <pre class="syntect-*"> with
+      //     copy + word-wrap controls and emits an SR-announce live
+      //     region for clipboard feedback. Idempotent on pages with no
+      //     fenced code.
+      //   - TabsInit activates the correct tab panel and wires click
+      //     handlers for <Tabs> components.
+      //   - MermaidInit lazily imports the mermaid library from
+      //     `MERMAID_CDN_MODULE_URL` (esm.sh by default) on
+      //     `AFTER_NAVIGATE_EVENT` and renders any `[data-mermaid]`
+      //     containers emitted by zfb's MermaidPlugin (zfb#104).
+      //     Pages without diagrams pay zero runtime cost because
+      //     the dynamic import is gated on a non-empty
+      //     `querySelectorAll("[data-mermaid]:not([data-mermaid-rendered])")`.
+      //   - The version-switcher script wires the dropdown toggle /
+      //     outside-click / Escape-key behavior for every
+      //     [data-version-switcher] element.
+      // All four scripts are idempotent and safe on pages that have
+      // no matching elements, so they are included unconditionally.
+      // Callers that need a different body-end script set should pass
+      // `bodyEndScripts` explicitly to override this default.
+      /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(CodeBlockEnhancer, {}),
+        /* @__PURE__ */ jsx(TabsInit, {}),
+        /* @__PURE__ */ jsx(MermaidInit, {}),
+        /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: VERSION_SWITCHER_INIT_SCRIPT } })
+      ] }),
+      main: children
+    }
+  ) });
+}
+export {
+  DOC_LAYOUT_ANCHORS,
+  DOC_LAYOUT_ANCHOR_IDS,
+  DocLayoutWithDefaults,
+  allAnchorComments,
+  anchorComment
+};

package/dist/doclayout/doc-layout.d.ts

@@ -0,0 +1,121 @@
+import { ComponentChildren, JSX } from 'preact';
+
+/** @jsxImportSource preact */
+
+/**
+ * Direction-and-mode metadata for the root `<html>` element. Keeps the
+ * shell from depending on a project's i18n module.
+ */
+interface DocLayoutHtmlAttrs {
+    /** BCP-47 language tag, e.g. `"en"`, `"ja"`. Defaults to `"en"`. */
+    lang?: string;
+    /**
+     * Optional `data-theme` attribute value (e.g. `"light"` / `"dark"`).
+     * Set per `<html>`-level color-scheme strategy.
+     */
+    dataTheme?: string;
+    /**
+     * Optional inline `style` value to apply to `<html>` — in practice this
+     * is `color-scheme: light` / `color-scheme: dark`.
+     */
+    htmlStyle?: string;
+}
+/**
+ * Full prop surface for the composable layout. Every "slot" is a
+ * `ComponentChildren` so consumers can pass arbitrary JSX (Preact, zfb
+ * Island wrappers, server-rendered output projected through the
+ * boundary, etc.).
+ */
+interface DocLayoutProps extends DocLayoutHtmlAttrs {
+    /** Page title — rendered as the `<title>` value. */
+    title: string;
+    /** Optional `<meta name="description">`. */
+    description?: string;
+    /** Optional `<meta name="robots" content="noindex">` toggle. */
+    noindex?: boolean;
+    /**
+     * Free-form children injected at the top of `<head>`, after the
+     * baseline `<title>` / charset / viewport meta. Use this for OG/
+     * Twitter meta, preload hints, color-scheme provider scripts, RSS
+     * links, the `<ClientRouter />` (Astro) or its zfb-equivalent — the
+     * shell stays out of the way.
+     */
+    head?: ComponentChildren;
+    /** Required. The site header. Consumer ships its own `<header>`. */
+    header: ComponentChildren;
+    /**
+     * Optional sidebar content. When omitted (or when `hideSidebar` is
+     * true) the desktop-sidebar `<aside>` is not rendered and the
+     * content-margin wrapper collapses to full width.
+     */
+    sidebar?: ComponentChildren;
+    /**
+     * Hide the sidebar even if the slot is provided. Mirrors the
+     * `hide_sidebar` page frontmatter flag.
+     */
+    hideSidebar?: boolean;
+    /**
+     * When present, sets `data-zfb-transition-persist` on the desktop
+     * sidebar `<aside>`. Keyed as `sidebar-{lang}-{navSection}` so zfb's
+     * Strategy B persist swaps reuse the same DOM node across same-locale +
+     * same-section navigations. Omit for back-compat (no attribute). Must
+     * NOT be passed when `hideSidebar` is true — the sr-only aside contains
+     * no real sidebar content and persisting it conflicts with the new
+     * page's tree on cross-type navigations. Resolves #1546.
+     */
+    sidebarPersistKey?: string;
+    /**
+     * Slot rendered between the desktop sidebar and the content-margin
+     * wrapper. Used by the sidebar-toggle feature in `create-zudo-doc`.
+     */
+    afterSidebar?: ComponentChildren;
+    /** Optional breadcrumb shown above the article. */
+    breadcrumb?: ComponentChildren;
+    /** Optional content slot rendered between breadcrumb and article. */
+    afterBreadcrumb?: ComponentChildren;
+    /** Optional mobile-only TOC, rendered above the article. */
+    mobileToc?: ComponentChildren;
+    /** Required. The page's article body. */
+    main: ComponentChildren;
+    /**
+     * Optional content slot rendered immediately after `<article>` but
+     * still inside `<main>`. Used by the body-foot util area and the
+     * doc-history feature.
+     */
+    afterContent?: ComponentChildren;
+    /** Optional desktop TOC rendered alongside `<main>` on wide screens. */
+    toc?: ComponentChildren;
+    /** Hide the TOC (both desktop and mobile) regardless of slot value. */
+    hideToc?: boolean;
+    /** Optional footer rendered below the content. */
+    footer?: ComponentChildren;
+    /**
+     * Components rendered just before `</body>`. Use for modals,
+     * design-token panels, code-block enhancers, mock initializers, and
+     * other globally-mounted islands.
+     */
+    bodyEndComponents?: ComponentChildren;
+    /**
+     * Scripts / inline `<script>` islands rendered last in `</body>`.
+     * Kept distinct from `bodyEndComponents` because the original Astro
+     * layout had two separate anchors here, and downstream features (e.g.
+     * the sidebar resizer) inject into the scripts slot specifically.
+     */
+    bodyEndScripts?: ComponentChildren;
+}
+/**
+ * `id` attribute of the desktop sidebar `<aside>`. Used by consumer code
+ * (e.g. sidebar-toggle island) to locate the element in the DOM.
+ */
+declare const DESKTOP_SIDEBAR_ID = "desktop-sidebar";
+/**
+ * Composable documentation-page layout shell.
+ *
+ * Renders a complete `<html>` document. Treat this as the *outermost*
+ * component; do not nest another `<html>` around it. The slot props let
+ * a downstream framework (e.g. `<DocLayoutWithDefaults>` or a fully
+ * custom layout) decide what fills each region.
+ */
+declare function DocLayout(props: DocLayoutProps): JSX.Element;
+
+export { DESKTOP_SIDEBAR_ID, DocLayout, type DocLayoutHtmlAttrs, type DocLayoutProps };