@takazudo/zudo-doc 0.1.0

package/dist/doclayout/doc-layout.js

@@ -0,0 +1,89 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+import { ClientRouter } from "@takazudo/zfb-runtime";
+const DESKTOP_SIDEBAR_ID = "desktop-sidebar";
+function DocLayout(props) {
+  const {
+    title,
+    description,
+    noindex,
+    lang = "en",
+    dataTheme,
+    htmlStyle,
+    head,
+    header,
+    sidebar,
+    hideSidebar = false,
+    sidebarPersistKey,
+    afterSidebar,
+    breadcrumb,
+    afterBreadcrumb,
+    mobileToc,
+    main,
+    afterContent,
+    toc,
+    hideToc = false,
+    footer,
+    bodyEndComponents,
+    bodyEndScripts
+  } = props;
+  const hasSidebar = sidebar !== void 0;
+  const showSidebar = !hideSidebar && hasSidebar;
+  const showToc = !hideToc && toc !== void 0;
+  const htmlAttrs = { lang };
+  if (dataTheme !== void 0) {
+    htmlAttrs["data-theme"] = dataTheme;
+  }
+  if (htmlStyle !== void 0) {
+    htmlAttrs.style = htmlStyle;
+  }
+  return /* @__PURE__ */ jsxs("html", { ...htmlAttrs, children: [
+    /* @__PURE__ */ jsxs("head", { children: [
+      /* @__PURE__ */ jsx("meta", { charSet: "utf-8" }),
+      /* @__PURE__ */ jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }),
+      /* @__PURE__ */ jsx("title", { children: title }),
+      description !== void 0 && /* @__PURE__ */ jsx("meta", { name: "description", content: description }),
+      noindex && /* @__PURE__ */ jsx("meta", { name: "robots", content: "noindex, nofollow" }),
+      ClientRouter(),
+      head
+    ] }),
+    /* @__PURE__ */ jsxs("body", { class: "min-h-screen antialiased", children: [
+      header,
+      hasSidebar && /* @__PURE__ */ jsx(
+        "aside",
+        {
+          id: DESKTOP_SIDEBAR_ID,
+          "aria-label": "Documentation sidebar",
+          class: showSidebar ? "hidden lg:block fixed top-[3.5rem] left-0 z-30 w-[var(--zd-sidebar-w)] h-[calc(100vh-3.5rem)] overflow-y-auto bg-bg border-r border-muted pb-vsp-xl" : "sr-only",
+          ...sidebarPersistKey !== void 0 ? { "data-zfb-transition-persist": sidebarPersistKey } : {},
+          children: sidebar
+        }
+      ),
+      afterSidebar,
+      /* @__PURE__ */ jsxs("div", { class: showSidebar ? "lg:ml-[var(--zd-sidebar-w)]" : void 0, children: [
+        /* @__PURE__ */ jsx("div", { class: "flex min-h-[calc(100vh-3.5rem)] justify-center", children: /* @__PURE__ */ jsxs(
+          "div",
+          {
+            class: `flex w-full gap-[clamp(1.5rem,3vw,4rem)] ${showSidebar ? "max-w-[clamp(50rem,75vw,90rem)]" : "max-w-[80rem]"}`,
+            children: [
+              /* @__PURE__ */ jsxs("main", { class: "flex-1 min-w-0 px-hsp-xl py-vsp-xl lg:px-hsp-2xl lg:py-vsp-2xl", children: [
+                breadcrumb,
+                afterBreadcrumb,
+                !hideToc && mobileToc,
+                /* @__PURE__ */ jsx("article", { class: "zd-content max-w-none", children: main }),
+                afterContent
+              ] }),
+              showToc && toc
+            ]
+          }
+        ) }),
+        footer
+      ] }),
+      bodyEndComponents,
+      bodyEndScripts
+    ] })
+  ] });
+}
+export {
+  DESKTOP_SIDEBAR_ID,
+  DocLayout
+};

package/dist/doclayout/index.d.ts

@@ -0,0 +1,6 @@
+export { DESKTOP_SIDEBAR_ID, DocLayout, DocLayoutHtmlAttrs, DocLayoutProps } from './doc-layout.js';
+export { DocLayoutWithDefaults, DocLayoutWithDefaultsProps } from './doc-layout-with-defaults.js';
+export { DOC_LAYOUT_ANCHORS, DOC_LAYOUT_ANCHOR_IDS, DocLayoutAnchor, DocLayoutAnchorId, DocLayoutAnchorKind, allAnchorComments, anchorComment } from './anchors.js';
+import 'preact';
+import '../toc/types.js';
+import '../i18n-version/version-banner.js';

package/dist/doclayout/index.js

@@ -0,0 +1,17 @@
+import { DocLayout, DESKTOP_SIDEBAR_ID } from "./doc-layout.js";
+import { DocLayoutWithDefaults } from "./doc-layout-with-defaults.js";
+import {
+  DOC_LAYOUT_ANCHORS,
+  DOC_LAYOUT_ANCHOR_IDS,
+  allAnchorComments,
+  anchorComment
+} from "./anchors.js";
+export {
+  DESKTOP_SIDEBAR_ID,
+  DOC_LAYOUT_ANCHORS,
+  DOC_LAYOUT_ANCHOR_IDS,
+  DocLayout,
+  DocLayoutWithDefaults,
+  allAnchorComments,
+  anchorComment
+};

package/dist/footer/footer.d.ts

@@ -0,0 +1,42 @@
+import { VNode } from 'preact';
+import { FooterLinkColumn, FooterTagColumn } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface FooterProps {
+    /**
+     * Already-localized link columns. Each item's href should be
+     * base-prefixed and locale-aware; `isExternal` controls the
+     * target/rel attributes.
+     */
+    linkColumns?: FooterLinkColumn[];
+    /**
+     * Already-resolved tag columns. Empty array (or omitted) hides the
+     * taglist entirely. Each tag's href should already be base-prefixed.
+     */
+    tagColumns?: FooterTagColumn[];
+    /**
+     * Copyright HTML. Rendered via `dangerouslySetInnerHTML` so embedded
+     * anchors work. The caller is responsible for the contents.
+     */
+    copyright?: string;
+    /**
+     * When provided, adds `data-zfb-transition-persist` to the `<footer>`
+     * element. Use a locale-keyed value (e.g. `footer-en`, `footer-ja`) so
+     * cross-locale swaps discard the stale footer while same-locale swaps
+     * preserve DOM-node identity. See zudolab/zudo-doc#1546.
+     */
+    persistKey?: string;
+}
+/**
+ * Footer shell for the documentation layout.
+ *
+ * Always renders the `<footer>` shell so the contentinfo ARIA landmark
+ * is present on every page — even when no columns or copyright are
+ * configured. The inner content (link grid, copyright) is only emitted
+ * when the respective slots carry data.
+ */
+declare function Footer(props: FooterProps): VNode;
+
+export { Footer, type FooterProps };

package/dist/footer/footer.js

@@ -0,0 +1,79 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+function Footer(props) {
+  const linkColumns = props.linkColumns ?? [];
+  const tagColumns = props.tagColumns ?? [];
+  const copyright = props.copyright ?? "";
+  const persistKey = props.persistKey;
+  const hasColumns = linkColumns.length > 0 || tagColumns.length > 0;
+  const hasCopyright = copyright.length > 0;
+  const copyrightClass = hasColumns ? "text-center text-caption text-muted [&_a]:text-accent [&_a]:underline mt-vsp-lg border-t border-muted pt-vsp-md" : "text-center text-caption text-muted [&_a]:text-accent [&_a]:underline";
+  return /* @__PURE__ */ jsx(
+    "footer",
+    {
+      class: "border-t border-muted bg-surface",
+      ...persistKey ? { "data-zfb-transition-persist": persistKey } : {},
+      children: /* @__PURE__ */ jsxs("div", { class: "mx-auto max-w-[clamp(50rem,75vw,90rem)] px-hsp-xl py-vsp-xl lg:px-hsp-2xl lg:py-vsp-2xl", children: [
+        hasColumns && /* @__PURE__ */ jsxs("div", { class: "grid grid-cols-1 gap-vsp-lg sm:grid-cols-2 lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))]", children: [
+          linkColumns.map((column, i) => /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("p", { class: "text-small font-semibold text-fg mb-vsp-xs", children: column.title }),
+            /* @__PURE__ */ jsx("ul", { class: "list-none p-0", children: column.items.map((item, j) => /* @__PURE__ */ jsx(
+              "li",
+              {
+                class: "mb-vsp-2xs",
+                children: /* @__PURE__ */ jsx(
+                  "a",
+                  {
+                    href: item.href,
+                    class: "text-caption text-muted hover:text-accent hover:underline focus-visible:underline",
+                    ...item.isExternal ? {
+                      target: "_blank",
+                      rel: "noopener noreferrer"
+                    } : {},
+                    children: item.label
+                  }
+                )
+              },
+              `item-${i}-${j}-${item.href}`
+            )) })
+          ] }, `link-${i}-${column.title}`)),
+          tagColumns.map((column, i) => /* @__PURE__ */ jsxs(
+            "div",
+            {
+              "data-taglist-group": column.group,
+              children: [
+                /* @__PURE__ */ jsx("h2", { class: "text-small font-semibold text-fg mb-vsp-xs", children: column.title }),
+                /* @__PURE__ */ jsx("ul", { class: "list-none p-0", children: column.tags.map(({ tag, count, href }) => /* @__PURE__ */ jsx("li", { class: "mb-vsp-2xs", children: /* @__PURE__ */ jsxs(
+                  "a",
+                  {
+                    href,
+                    class: "text-caption text-muted hover:text-accent hover:underline focus-visible:underline",
+                    children: [
+                      "#",
+                      tag,
+                      /* @__PURE__ */ jsxs("span", { class: "opacity-60", "aria-hidden": "true", children: [
+                        "\xA0(",
+                        count,
+                        ")"
+                      ] })
+                    ]
+                  }
+                ) }, `tag-item-${tag}`)) })
+              ]
+            },
+            `tag-${i}-${column.group}`
+          ))
+        ] }),
+        hasCopyright && /* @__PURE__ */ jsx(
+          "div",
+          {
+            class: copyrightClass,
+            dangerouslySetInnerHTML: { __html: copyright }
+          }
+        )
+      ] })
+    }
+  );
+}
+export {
+  Footer
+};

package/dist/footer/index.d.ts

@@ -0,0 +1,3 @@
+export { Footer, FooterProps } from './footer.js';
+export { FooterLinkColumn, FooterLinkItem, FooterTagColumn, FooterTagItem } from './types.js';
+import 'preact';

package/dist/footer/index.js

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

package/dist/footer/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Public types for the framework-agnostic footer shell.
+ *
+ * The original Astro `footer.astro` mixed three concerns:
+ *   1. Reading `settings.footer` and applying locale overrides.
+ *   2. Loading the docs collection + tag vocabulary to build the
+ *      optional taglist columns.
+ *   3. Rendering the footer markup.
+ *
+ * Concerns (1) and (2) depend on host-side helpers (`@/config/settings`,
+ * `@/utils/get-docs-collection`, `tag-vocabulary`, etc.) that v2 must
+ * not reach into. So this package only ports concern (3): the
+ * presentational shell. Callers prepare the columns upstream and pass
+ * already-localized, already-resolved hrefs in.
+ */
+/** A single link rendered inside a {@link FooterLinkColumn}. */
+interface FooterLinkItem {
+    /** Visible label (already locale-resolved by the caller). */
+    label: string;
+    /** Resolved href (already base-prefixed and locale-aware). */
+    href: string;
+    /**
+     * When true, the rendered anchor adds `target="_blank"` and
+     * `rel="noopener noreferrer"`. Callers compute this from their own
+     * external-href detector.
+     */
+    isExternal?: boolean;
+}
+/** One column in the footer's link grid. */
+interface FooterLinkColumn {
+    /** Visible heading for the column (already locale-resolved). */
+    title: string;
+    items: FooterLinkItem[];
+}
+/** A single tag rendered inside a {@link FooterTagColumn}. */
+interface FooterTagItem {
+    /** Canonical tag id (rendered as `#<tag>`). */
+    tag: string;
+    /** Document count shown next to the tag. */
+    count: number;
+    /** Resolved href to the tag's index page. */
+    href: string;
+}
+/** One column in the footer's tag grid. */
+interface FooterTagColumn {
+    /**
+     * Group identifier — usually a vocabulary group name like `"topic"`,
+     * or the literal `"__flat__"` sentinel for the ungrouped/flat column.
+     * Surfaced as `data-taglist-group` on the rendered column wrapper so
+     * downstream tests / e2e selectors keep working.
+     */
+    group: string;
+    /** Visible heading for the column (already locale-resolved). */
+    title: string;
+    tags: FooterTagItem[];
+}
+
+export type { FooterLinkColumn, FooterLinkItem, FooterTagColumn, FooterTagItem };

package/dist/head/doc-head.d.ts

@@ -0,0 +1,33 @@
+import { JSX } from 'preact';
+import { HeadProps } from './types.js';
+
+/**
+ * Framework head tag emission. Renders only the meta-tag layer of <head>;
+ * provider components such as ColorSchemeProvider or astro:transitions'
+ * ClientRouter and any inline boot scripts (sidebar toggle, design token
+ * panel, etc.) are owned by other topic folders and composed by the host
+ * layout alongside this primitive.
+ *
+ * Output order is fixed and matches the existing src/layouts/doc-layout.astro
+ * emission so head HTML stays byte-identical (modulo asset hashes) to the
+ * pre-migration build for any fixture page:
+ *
+ *   1. <meta charset>
+ *   2. <meta name="viewport">
+ *   3. <title>
+ *   4. <meta name="description">          (if description)
+ *   5. <meta name="robots">                (noindex sitewide OR unlisted page)
+ *   6. <link rel="canonical">              (if canonical)
+ *   7. <meta name="theme-color">           (if themeColor)
+ *   8. og:* tags                           (og:title always; rest conditional)
+ *   9. twitter:* tags                      (only when twitterCard set)
+ *  10. <link rel="stylesheet"> ...         (in supplied order — e.g. KaTeX)
+ *  11. <link rel="alternate"> ...          (in supplied order — e.g. llms.txt)
+ *  12. <link rel="preload"> ...            (in supplied order)
+ *
+ * Never reorder existing slots; append new tag families at the end so
+ * downstream byte-diffs remain stable.
+ */
+declare function DocHead(props: HeadProps): JSX.Element;
+
+export { DocHead };

package/dist/head/doc-head.js

@@ -0,0 +1,90 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { OgTags } from "./og-tags.js";
+import { TwitterCard } from "./twitter-card.js";
+function DocHead(props) {
+  const {
+    title,
+    description,
+    noindex,
+    unlisted,
+    canonical,
+    themeColor,
+    twitterCard,
+    twitterSite,
+    twitterCreator,
+    twitterTitle,
+    twitterDescription,
+    twitterImage,
+    stylesheets,
+    alternateLinks,
+    preload
+  } = props;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("meta", { charset: "utf-8" }),
+    /* @__PURE__ */ jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }),
+    /* @__PURE__ */ jsx("title", { children: title }),
+    description !== void 0 && /* @__PURE__ */ jsx("meta", { name: "description", content: description }),
+    noindex && /* @__PURE__ */ jsx("meta", { name: "robots", content: "noindex, nofollow" }),
+    !noindex && unlisted && /* @__PURE__ */ jsx("meta", { name: "robots", content: "noindex" }),
+    canonical !== void 0 && /* @__PURE__ */ jsx("link", { rel: "canonical", href: canonical }),
+    themeColor !== void 0 && /* @__PURE__ */ jsx("meta", { name: "theme-color", content: themeColor }),
+    /* @__PURE__ */ jsx(
+      OgTags,
+      {
+        title,
+        description,
+        ogTitle: props.ogTitle,
+        ogDescription: props.ogDescription,
+        ogType: props.ogType,
+        ogUrl: props.ogUrl,
+        ogImage: props.ogImage,
+        ogSiteName: props.ogSiteName
+      }
+    ),
+    twitterCard !== void 0 && /* @__PURE__ */ jsx(
+      TwitterCard,
+      {
+        card: twitterCard,
+        site: twitterSite,
+        creator: twitterCreator,
+        title: twitterTitle,
+        description: twitterDescription,
+        image: twitterImage
+      }
+    ),
+    stylesheets?.map((s) => /* @__PURE__ */ jsx(
+      "link",
+      {
+        rel: "stylesheet",
+        href: s.href,
+        ...s.integrity !== void 0 ? { integrity: s.integrity } : {},
+        ...s.crossorigin !== void 0 ? { crossorigin: s.crossorigin } : {}
+      },
+      `stylesheet:${s.href}`
+    )),
+    alternateLinks?.map((l) => /* @__PURE__ */ jsx(
+      "link",
+      {
+        rel: l.rel,
+        ...l.type !== void 0 ? { type: l.type } : {},
+        href: l.href,
+        ...l.title !== void 0 ? { title: l.title } : {}
+      },
+      `${l.rel}:${l.type ?? ""}:${l.href}`
+    )),
+    preload?.map((p) => /* @__PURE__ */ jsx(
+      "link",
+      {
+        rel: "preload",
+        as: p.as,
+        href: p.href,
+        ...p.type !== void 0 ? { type: p.type } : {},
+        ...p.crossorigin !== void 0 ? { crossorigin: p.crossorigin } : {}
+      },
+      `preload:${p.as}:${p.href}`
+    ))
+  ] });
+}
+export {
+  DocHead
+};

package/dist/head/index.d.ts

@@ -0,0 +1,5 @@
+export { DocHead } from './doc-head.js';
+export { OgTags } from './og-tags.js';
+export { TwitterCard } from './twitter-card.js';
+export { HeadProps } from './types.js';
+import 'preact';

package/dist/head/index.js

@@ -0,0 +1,8 @@
+import { DocHead } from "./doc-head.js";
+import { OgTags } from "./og-tags.js";
+import { TwitterCard } from "./twitter-card.js";
+export {
+  DocHead,
+  OgTags,
+  TwitterCard
+};

package/dist/head/og-tags.d.ts

@@ -0,0 +1,25 @@
+import { JSX } from 'preact';
+import { HeadProps } from './types.js';
+
+/**
+ * Open Graph meta tags. Emits og:title (always — defaults to `title`) plus
+ * any other og:* fields the caller has supplied.
+ *
+ * Output order matches the order in src/layouts/doc-layout.astro for byte
+ * parity: og:title → og:description → og:type → og:url → og:image →
+ * og:site_name. New og:* tags should be appended at the end of the list,
+ * never reordered, to keep snapshot diffs minimal.
+ */
+declare function OgTags(props: {
+    title: string;
+    description?: string;
+    ogTitle?: string;
+    ogDescription?: string;
+    ogType?: string;
+    ogUrl?: string;
+    ogImage?: string;
+    ogSiteName?: string;
+}): JSX.Element;
+type OgInputs = Pick<HeadProps, "ogTitle" | "ogDescription" | "ogType" | "ogUrl" | "ogImage" | "ogSiteName">;
+
+export { type OgInputs, OgTags };

package/dist/head/og-tags.js

@@ -0,0 +1,16 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+function OgTags(props) {
+  const ogTitle = props.ogTitle ?? props.title;
+  const ogDescription = props.ogDescription ?? props.description;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("meta", { property: "og:title", content: ogTitle }),
+    ogDescription !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:description", content: ogDescription }),
+    props.ogType !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:type", content: props.ogType }),
+    props.ogUrl !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:url", content: props.ogUrl }),
+    props.ogImage !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:image", content: props.ogImage }),
+    props.ogSiteName !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:site_name", content: props.ogSiteName })
+  ] });
+}
+export {
+  OgTags
+};

package/dist/head/twitter-card.d.ts

@@ -0,0 +1,21 @@
+import { JSX } from 'preact';
+import { HeadProps } from './types.js';
+
+/**
+ * Twitter card meta tags. The host renders this only when a card type is
+ * configured; this component itself assumes `card` is set and emits twitter:card
+ * plus whichever other twitter:* fields the caller has supplied.
+ *
+ * Field order: card → site → creator → title → description → image. Preserve
+ * this order to keep snapshot diffs predictable.
+ */
+declare function TwitterCard(props: {
+    card: NonNullable<HeadProps["twitterCard"]>;
+    site?: string;
+    creator?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+}): JSX.Element;
+
+export { TwitterCard };

package/dist/head/twitter-card.js

@@ -0,0 +1,14 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+function TwitterCard(props) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("meta", { name: "twitter:card", content: props.card }),
+    props.site !== void 0 && /* @__PURE__ */ jsx("meta", { name: "twitter:site", content: props.site }),
+    props.creator !== void 0 && /* @__PURE__ */ jsx("meta", { name: "twitter:creator", content: props.creator }),
+    props.title !== void 0 && /* @__PURE__ */ jsx("meta", { name: "twitter:title", content: props.title }),
+    props.description !== void 0 && /* @__PURE__ */ jsx("meta", { name: "twitter:description", content: props.description }),
+    props.image !== void 0 && /* @__PURE__ */ jsx("meta", { name: "twitter:image", content: props.image })
+  ] });
+}
+export {
+  TwitterCard
+};

package/dist/head/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Input props for {@link DocHead}.
+ *
+ * The framework component is intentionally free of project-specific globals
+ * (settings.ts, i18n helpers, base path). Callers build a HeadProps object
+ * from their own config and pass it in. This keeps the head primitive
+ * portable across Astro and zfb hosts and lets us assert byte-parity in
+ * unit tests without bootstrapping a full runtime.
+ */
+interface HeadProps {
+    /**
+     * Full title string. The caller is responsible for composing
+     * "{Page Title} | {Site Name}" — DocHead does not append the site name.
+     */
+    title: string;
+    /** Page description; emitted as <meta name="description"> and og:description. */
+    description?: string;
+    /**
+     * Apply <meta name="robots" content="noindex, nofollow"> sitewide.
+     * When true, takes precedence over `unlisted`.
+     */
+    noindex?: boolean;
+    /**
+     * Mark this individual page as unlisted. When `noindex` is false and
+     * `unlisted` is true, emits <meta name="robots" content="noindex">.
+     */
+    unlisted?: boolean;
+    /** Override og:title. Defaults to `title`. */
+    ogTitle?: string;
+    /** Override og:description. Defaults to `description`. */
+    ogDescription?: string;
+    /** og:type, e.g. "website" or "article". Omitted if undefined. */
+    ogType?: string;
+    /** og:url. Omitted if undefined. */
+    ogUrl?: string;
+    /** og:image. Omitted if undefined. */
+    ogImage?: string;
+    /** og:site_name. Omitted if undefined. */
+    ogSiteName?: string;
+    /**
+     * When set, emits twitter:card and any of the other twitter:* fields that
+     * are also supplied. When undefined, no twitter:* tags are emitted.
+     */
+    twitterCard?: "summary" | "summary_large_image" | "app" | "player";
+    twitterSite?: string;
+    twitterCreator?: string;
+    twitterTitle?: string;
+    twitterDescription?: string;
+    twitterImage?: string;
+    /** Canonical URL emitted as <link rel="canonical">. */
+    canonical?: string;
+    /** theme-color meta value (e.g. "#ffffff"). */
+    themeColor?: string;
+    /** Generic stylesheet links (e.g. KaTeX). Emitted in order. */
+    stylesheets?: ReadonlyArray<{
+        href: string;
+        integrity?: string;
+        crossorigin?: "anonymous" | "use-credentials";
+    }>;
+    /**
+     * Generic alternate / RSS / sitemap links emitted as
+     * <link rel={rel} type={type} href={href} title={title}>.
+     * Used for llms.txt, RSS feed discovery, sitemap discovery, etc.
+     */
+    alternateLinks?: ReadonlyArray<{
+        rel: string;
+        href: string;
+        type?: string;
+        title?: string;
+    }>;
+    /**
+     * Generic preload hints emitted as
+     * <link rel="preload" as={as} href={href} type={type} crossorigin={crossorigin}>.
+     */
+    preload?: ReadonlyArray<{
+        href: string;
+        as: string;
+        type?: string;
+        crossorigin?: "anonymous" | "use-credentials";
+    }>;
+}
+
+export type { HeadProps };