@krak-stack/registry 0.1.24 → 0.1.25

package/README.md

@@ -20,7 +20,8 @@ import {
 } from "@krak-stack/registry/httpapi-toolkit";
 import { ApiClient } from "@krak-stack/registry/httpapi/client";
 import { HttpApiSpec } from "@krak-stack/registry/httpapi/helpers";
-import { createMdxDocsSource, makeDocs } from "@krak-stack/registry/docs";
+import { createDocsSource, makeDocs } from "@krak-stack/registry/docs";
+import { loadMdxDocsDirectory } from "@krak-stack/registry/docs/server";
 import {
   DocumentationToolkit,
   DocumentationToolkitLayer,
@@ -68,8 +69,18 @@ HTTP API client, schema, AI tool, CLI, and MCP utilities are available under
 the `@krak-stack/registry/httpapi/*` subpaths. Keep application-specific API
 layers, handlers, authentication, and client bindings in the application.
 
-Documentation consumers create their content source in the application so Vite
-can resolve the local `import.meta.glob`, then pass it to `makeDocs`.
+Documentation consumers load and compile their application-owned MDX on the
+server, then pass the validated page records to `createDocsSource` and
+`makeDocs`:
+
+```ts
+const pages = await loadMdxDocsDirectory("src/content/docs");
+const source = createDocsSource({ pages, locales: ["en", "fr"] });
+```
+
+The `@krak-stack/registry/docs/server` export requires the Bun runtime. Keep it
+behind a server-only module or server function so it is not included in browser
+bundles.
 
 Add the package's Tailwind source to the application stylesheet:
 

package/dist/lib/docs.server.d.ts

@@ -0,0 +1,41 @@
+import { type DocsPage } from "./docs.js";
+export declare const compileDocsMarkdown: (source: string) => {
+    codeBlocks: import("./markdown/server.js").MarkdownCodeBlock[];
+    html: string;
+    source: string;
+    headings: {
+        readonly depth: 2 | 3;
+        readonly id: string;
+        readonly title: string;
+    }[];
+    searchText: string;
+};
+export declare const compileMdxDocsPage: (sourceFile: string, source: string) => DocsPage;
+export declare const loadMdxDocsDirectory: (root: string) => Promise<{
+    readonly slug: string;
+    readonly path: string;
+    readonly title: string;
+    readonly description: string;
+    readonly icon?: string | undefined;
+    readonly order: number;
+    readonly locale: string;
+    readonly section: string;
+    readonly type: "concept" | "how-to" | "reference" | "runbook" | "tutorial";
+    readonly createdAt?: string | undefined;
+    readonly updatedAt?: string | undefined;
+    readonly legacySlugs?: readonly string[] | undefined;
+    readonly tags?: readonly string[] | undefined;
+    readonly codeBlocks: readonly {
+        readonly code: string;
+        readonly language: string;
+    }[];
+    readonly headings: readonly {
+        readonly depth: 2 | 3;
+        readonly id: string;
+        readonly title: string;
+    }[];
+    readonly html: string;
+    readonly searchText: string;
+    readonly sourceFile: string;
+    readonly source: string;
+}[]>;

package/dist/lib/docs.server.js

@@ -0,0 +1,473 @@
+// @bun
+// ../../src/lib/docs.server.ts
+import { Schema as Schema4 } from "effect";
+
+// ../../src/lib/docs.tsx
+import { Schema as Schema3 } from "effect";
+import {
+  forwardRef,
+  useDeferredValue,
+  useEffect as useEffect5,
+  useState as useState5
+} from "react";
+
+// ../../src/components/ui/app-brand.tsx
+import { Link } from "@tanstack/react-router";
+
+// ../../src/components/ui/badge.tsx
+import { mergeProps } from "@base-ui/react/merge-props";
+import { useRender } from "@base-ui/react/use-render";
+import { cva } from "class-variance-authority";
+
+// ../../src/lib/utils.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+// ../../src/components/ui/badge.tsx
+var badgeVariants = cva("group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-4xl border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&>svg]:pointer-events-none [&>svg]:size-3!", {
+  variants: {
+    variant: {
+      default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
+      secondary: "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
+      destructive: "bg-destructive/10 text-destructive focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 [a]:hover:bg-destructive/20",
+      outline: "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
+      ghost: "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
+      link: "text-primary underline-offset-4 hover:underline"
+    }
+  },
+  defaultVariants: {
+    variant: "default"
+  }
+});
+
+// ../../src/components/ui/button.tsx
+import { Button as ButtonPrimitive } from "@base-ui/react/button";
+import { cva as cva2 } from "class-variance-authority";
+var buttonVariants = cva2("group/button inline-flex shrink-0 items-center justify-center rounded-md border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", {
+  variants: {
+    variant: {
+      default: "bg-primary text-primary-foreground hover:bg-primary/80",
+      outline: "border-border bg-background shadow-xs hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
+      secondary: "bg-secondary text-secondary-foreground hover:bg-[color-mix(in_oklch,var(--secondary),var(--foreground)_5%)] aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
+      ghost: "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
+      destructive: "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
+      link: "text-primary underline-offset-4 hover:underline"
+    },
+    size: {
+      default: "h-9 gap-1.5 px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
+      xs: "h-6 gap-1 rounded-[min(var(--radius-md),8px)] px-2 text-xs in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
+      sm: "h-8 gap-1 rounded-[min(var(--radius-md),10px)] px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5",
+      lg: "h-10 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
+      icon: "size-9",
+      "icon-xs": "size-6 rounded-[min(var(--radius-md),8px)] in-data-[slot=button-group]:rounded-md [&_svg:not([class*='size-'])]:size-3",
+      "icon-sm": "size-8 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-md",
+      "icon-lg": "size-10"
+    }
+  },
+  defaultVariants: {
+    variant: "default",
+    size: "default"
+  }
+});
+
+// ../../src/components/ui/copy-button.tsx
+import { Check, Copy, TriangleAlert } from "lucide-react";
+import { useEffect, useRef, useState } from "react";
+
+// ../../src/components/ui/code-block.tsx
+import { highlight } from "@tanstack/highlight";
+import { createThemeCss } from "@tanstack/highlight/theme";
+import { githubDarkTheme } from "@tanstack/highlight/themes/github-dark";
+import { githubLightTheme } from "@tanstack/highlight/themes/github-light";
+var themeCss = `${createThemeCss({
+  light: githubLightTheme,
+  dark: githubDarkTheme,
+  lightSelector: "[data-code-theme]",
+  darkSelector: ".dark [data-code-theme]",
+  codeBlockSelector: "[data-code-theme] pre.th-code",
+  lineNumbersSelector: "[data-code-theme] .th-code--line-numbers"
+})}
+[data-code-theme] pre.th-code {
+  margin: 0;
+  overflow: visible;
+  background: transparent;
+  font: inherit;
+  color: inherit;
+}
+[data-code-theme] pre.th-code code { font: inherit; }`;
+
+// ../../src/components/ui/collapsible.tsx
+import { Collapsible as CollapsiblePrimitive } from "@base-ui/react/collapsible";
+
+// ../../src/components/ui/search-menu.tsx
+import { SearchIcon as SearchIcon2 } from "lucide-react";
+import { useCallback, useEffect as useEffect2, useState as useState2 } from "react";
+
+// ../../src/components/ui/command.tsx
+import { Command as CommandPrimitive } from "cmdk";
+import { SearchIcon } from "lucide-react";
+
+// ../../src/components/ui/dialog.tsx
+import { Dialog as DialogPrimitive } from "@base-ui/react/dialog";
+import { XIcon } from "lucide-react";
+
+// ../../src/paraglide/runtime.js
+import"@inlang/paraglide-js/urlpattern-polyfill";
+var isServer = import.meta.env?.SSR ?? typeof window === "undefined";
+globalThis.__paraglide = globalThis.__paraglide ?? {};
+globalThis.__paraglide.ssr = globalThis.__paraglide.ssr ?? {};
+var rtlLanguages = new Set([
+  "ar",
+  "dv",
+  "fa",
+  "he",
+  "ks",
+  "ku",
+  "ps",
+  "sd",
+  "ug",
+  "ur",
+  "yi"
+]);
+var customServerStrategies = new Map;
+var customClientStrategies = new Map;
+
+// ../../src/components/ui/sidebar-layout.tsx
+import { useAtom } from "@effect/atom-react";
+import { BrowserKeyValueStore } from "@effect/platform-browser";
+import { Link as Link2, Outlet, useRouterState } from "@tanstack/react-router";
+import { Schema as Schema2 } from "effect";
+import { Atom } from "effect/unstable/reactivity";
+
+// ../../src/components/ui/sidebar.tsx
+import * as React2 from "react";
+import { mergeProps as mergeProps2 } from "@base-ui/react/merge-props";
+import { useRender as useRender2 } from "@base-ui/react/use-render";
+import { cva as cva3 } from "class-variance-authority";
+
+// ../../src/hooks/use-mobile.ts
+import * as React from "react";
+
+// ../../src/components/ui/input.tsx
+import { Input as InputPrimitive } from "@base-ui/react/input";
+
+// ../../src/components/ui/separator.tsx
+import { Separator as SeparatorPrimitive } from "@base-ui/react/separator";
+
+// ../../src/components/ui/sheet.tsx
+import { Dialog as SheetPrimitive } from "@base-ui/react/dialog";
+import { XIcon as XIcon2 } from "lucide-react";
+"use client";
+
+// ../../src/components/ui/tooltip.tsx
+import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
+"use client";
+
+// ../../src/components/ui/sidebar.tsx
+import { PanelLeftIcon } from "lucide-react";
+import { Schema } from "effect";
+var SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
+var SidebarContext = React2.createContext(null);
+var sidebarMenuButtonVariants = cva3("peer/menu-button group/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md p-2 text-left text-sm ring-sidebar-ring outline-hidden transition-[width,height,padding] group-has-data-[sidebar=menu-action]/menu-item:pr-8 group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2! hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-open:hover:bg-sidebar-accent data-open:hover:text-sidebar-accent-foreground data-active:bg-sidebar-accent data-active:font-medium data-active:text-sidebar-accent-foreground [&_svg]:size-4 [&_svg]:shrink-0 [&>span:last-child]:truncate", {
+  variants: {
+    variant: {
+      default: "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground",
+      outline: "bg-background shadow-[0_0_0_1px_hsl(var(--sidebar-border))] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground hover:shadow-[0_0_0_1px_hsl(var(--sidebar-accent))]"
+    },
+    size: {
+      default: "h-8 text-sm",
+      sm: "h-7 text-xs",
+      lg: "h-12 text-sm group-data-[collapsible=icon]:p-0!"
+    }
+  },
+  defaultVariants: {
+    variant: "default",
+    size: "default"
+  }
+});
+
+// ../../src/components/ui/sidebar-layout.tsx
+var sidebarStorageRuntime = Atom.runtime(BrowserKeyValueStore.layerLocalStorage);
+var sidebarOpenAtom = Atom.kvs({
+  runtime: sidebarStorageRuntime,
+  key: "sidebar:open",
+  schema: Schema2.Boolean,
+  defaultValue: () => true
+});
+
+// ../../src/lib/docs.tsx
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
+var makeIcon = (name, paths) => {
+  const Icon = forwardRef(({ absoluteStrokeWidth: _absoluteStrokeWidth, size = 24, ...props }, ref) => /* @__PURE__ */ jsx("svg", {
+    "aria-hidden": "true",
+    fill: "none",
+    height: size,
+    ref,
+    stroke: "currentColor",
+    strokeLinecap: "round",
+    strokeLinejoin: "round",
+    strokeWidth: "2",
+    viewBox: "0 0 24 24",
+    width: size,
+    ...props,
+    children: paths
+  }));
+  Icon.displayName = name;
+  return Icon;
+};
+var ArrowLeft = makeIcon("ArrowLeft", /* @__PURE__ */ jsxs(Fragment, {
+  children: [
+    /* @__PURE__ */ jsx("path", {
+      d: "m12 19-7-7 7-7"
+    }),
+    /* @__PURE__ */ jsx("path", {
+      d: "M19 12H5"
+    })
+  ]
+}));
+var ArrowRight = makeIcon("ArrowRight", /* @__PURE__ */ jsxs(Fragment, {
+  children: [
+    /* @__PURE__ */ jsx("path", {
+      d: "M5 12h14"
+    }),
+    /* @__PURE__ */ jsx("path", {
+      d: "m12 5 7 7-7 7"
+    })
+  ]
+}));
+var BookOpen = makeIcon("BookOpen", /* @__PURE__ */ jsxs(Fragment, {
+  children: [
+    /* @__PURE__ */ jsx("path", {
+      d: "M12 7v14"
+    }),
+    /* @__PURE__ */ jsx("path", {
+      d: "M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-5a4 4 0 0 0-4 4 4 4 0 0 0-4-4Z"
+    })
+  ]
+}));
+var ChevronDown = makeIcon("ChevronDown", /* @__PURE__ */ jsx("path", {
+  d: "m6 9 6 6 6-6"
+}));
+var ExternalLink = makeIcon("ExternalLink", /* @__PURE__ */ jsxs(Fragment, {
+  children: [
+    /* @__PURE__ */ jsx("path", {
+      d: "M15 3h6v6"
+    }),
+    /* @__PURE__ */ jsx("path", {
+      d: "M10 14 21 3"
+    }),
+    /* @__PURE__ */ jsx("path", {
+      d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"
+    })
+  ]
+}));
+var Hash = makeIcon("Hash", /* @__PURE__ */ jsxs(Fragment, {
+  children: [
+    /* @__PURE__ */ jsx("line", {
+      x1: "4",
+      x2: "20",
+      y1: "9",
+      y2: "9"
+    }),
+    /* @__PURE__ */ jsx("line", {
+      x1: "4",
+      x2: "20",
+      y1: "15",
+      y2: "15"
+    }),
+    /* @__PURE__ */ jsx("line", {
+      x1: "10",
+      x2: "8",
+      y1: "3",
+      y2: "21"
+    }),
+    /* @__PURE__ */ jsx("line", {
+      x1: "16",
+      x2: "14",
+      y1: "3",
+      y2: "21"
+    })
+  ]
+}));
+var DocsSection = Schema3.String.annotate({
+  identifier: "DocsSection"
+});
+var DocsPageType = Schema3.Literals([
+  "concept",
+  "tutorial",
+  "how-to",
+  "reference",
+  "runbook"
+]).annotate({ identifier: "DocsPageType" });
+var DocsDate = Schema3.String.pipe(Schema3.check(Schema3.makeFilter((date) => Number.isNaN(new Date(date).getTime()) ? "Expected a valid date" : undefined)));
+var DocsFrontmatter = Schema3.Struct({
+  slug: Schema3.String,
+  path: Schema3.String,
+  title: Schema3.String,
+  description: Schema3.String,
+  icon: Schema3.optional(Schema3.String),
+  order: Schema3.Number,
+  locale: Schema3.String,
+  section: DocsSection,
+  type: DocsPageType,
+  createdAt: Schema3.optional(DocsDate),
+  updatedAt: Schema3.optional(DocsDate),
+  legacySlugs: Schema3.optional(Schema3.Array(Schema3.String)),
+  tags: Schema3.optional(Schema3.Array(Schema3.NonEmptyString))
+}).annotate({ identifier: "DocsFrontmatter" });
+var DocsHeadingSchema = Schema3.Struct({
+  depth: Schema3.Literals([2, 3]),
+  id: Schema3.String,
+  title: Schema3.String
+}).annotate({ identifier: "DocsHeading" });
+var DocsCodeBlockSchema = Schema3.Struct({
+  code: Schema3.String,
+  language: Schema3.String
+}).annotate({ identifier: "DocsCodeBlock" });
+var DocsPageSchema = Schema3.Struct({
+  ...DocsFrontmatter.fields,
+  codeBlocks: Schema3.Array(DocsCodeBlockSchema),
+  headings: Schema3.Array(DocsHeadingSchema),
+  html: Schema3.String,
+  searchText: Schema3.String,
+  sourceFile: Schema3.String,
+  source: Schema3.String
+}).annotate({ identifier: "DocsPage" });
+var EmptyIcon = forwardRef(() => null);
+
+// ../../src/lib/markdown/server.ts
+var escapeHtml = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var decodeMarkdownCode = (value) => value.replaceAll("&quot;", '"').replaceAll("&#39;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
+var safeUrl = (value, image = false) => {
+  if (value.startsWith("/") || value.startsWith("#") || value.startsWith("https://") || value.startsWith("http://") || !image && value.startsWith("mailto:")) {
+    return value;
+  }
+  return image ? "" : "#";
+};
+var markdownOptions = {
+  autolinks: true,
+  headings: { ids: true },
+  noHtmlBlocks: true,
+  noHtmlSpans: true,
+  tagFilter: true
+};
+var markdownPlainText = (source, includeCode = false) => Bun.markdown.render(source, {
+  blockquote: (children) => `${children} `,
+  code: (children) => includeCode ? `${children} ` : " ",
+  codespan: (children) => `${children} `,
+  heading: (children) => `${children} `,
+  html: () => " ",
+  image: (children) => `${children} `,
+  list: (children) => `${children} `,
+  listItem: (children) => `${children} `,
+  paragraph: (children) => `${children} `,
+  table: (children) => `${children} `,
+  td: (children) => `${children} `,
+  th: (children) => `${children} `,
+  tr: (children) => `${children} `
+}, markdownOptions).replace(/\s+/g, " ").trim();
+var compileMarkdown = (source) => {
+  const codeBlocks = [];
+  const html = Bun.markdown.render(source, {
+    blockquote: (children) => `<blockquote>${children}</blockquote>`,
+    code: (children, meta) => {
+      const index = codeBlocks.length;
+      const code = decodeMarkdownCode(children.replace(/\n$/, ""));
+      const language = meta?.language ?? "text";
+      codeBlocks.push({ code, language });
+      return `<markdown-code-block data-index="${index}"></markdown-code-block>`;
+    },
+    codespan: (children) => `<code data-inline-code>${escapeHtml(children)}</code>`,
+    emphasis: (children) => `<em>${children}</em>`,
+    heading: (children, { id, level }) => {
+      const headingId = escapeHtml(id ?? "");
+      const anchor = level === 2 || level === 3 ? `<a href="#${headingId}" aria-hidden="true">#</a>` : "";
+      return `<h${level} id="${headingId}">${children}${anchor}</h${level}>`;
+    },
+    hr: () => "<hr>",
+    html: (children) => escapeHtml(children),
+    image: (children, { src, title }) => {
+      const resolvedSrc = safeUrl(src, true);
+      if (!resolvedSrc)
+        return children;
+      const titleAttribute = title ? ` title="${escapeHtml(title)}"` : "";
+      return `<img src="${escapeHtml(resolvedSrc)}" alt="${escapeHtml(children)}"${titleAttribute}>`;
+    },
+    link: (children, { href, title }) => {
+      const resolvedHref = safeUrl(href);
+      const external = /^https?:\/\//.test(resolvedHref);
+      const titleAttribute = title ? ` title="${escapeHtml(title)}"` : "";
+      const externalAttributes = external ? ' target="_blank" rel="noreferrer"' : "";
+      return `<a href="${escapeHtml(resolvedHref)}"${titleAttribute}${externalAttributes}>${children}</a>`;
+    },
+    list: (children, { ordered, start }) => ordered ? `<ol${start && start !== 1 ? ` start="${start}"` : ""}>${children}</ol>` : `<ul>${children}</ul>`,
+    listItem: (children, { checked }) => {
+      const checkbox = checked === undefined ? "" : `<input type="checkbox" disabled${checked ? " checked" : ""}>`;
+      return `<li>${checkbox}${children}</li>`;
+    },
+    paragraph: (children) => `<p>${children}</p>`,
+    strikethrough: (children) => `<del>${children}</del>`,
+    strong: (children) => `<strong>${children}</strong>`,
+    table: (children) => `<div data-markdown-table><table>${children}</table></div>`,
+    tbody: (children) => `<tbody>${children}</tbody>`,
+    td: (children, meta) => `<td${meta?.align ? ` align="${meta.align}"` : ""}>${children}</td>`,
+    text: escapeHtml,
+    th: (children, meta) => `<th${meta?.align ? ` align="${meta.align}"` : ""}>${children}</th>`,
+    thead: (children) => `<thead>${children}</thead>`,
+    tr: (children) => `<tr>${children}</tr>`
+  }, markdownOptions);
+  return { codeBlocks, html, source };
+};
+
+// ../../src/lib/docs.server.ts
+var compileDocsMarkdown = (source) => {
+  const headings = [];
+  const seen = new Set;
+  Bun.markdown.render(source, {
+    heading: (children, { id, level }) => {
+      if ((level === 2 || level === 3) && id) {
+        if (seen.has(id))
+          throw new Error(`Duplicate heading ${id}`);
+        seen.add(id);
+        headings.push({ depth: level, id, title: children });
+      }
+      return "";
+    }
+  }, markdownOptions);
+  const compiled = compileMarkdown(source);
+  return {
+    ...compiled,
+    headings,
+    searchText: markdownPlainText(source)
+  };
+};
+var compileMdxDocsPage = (sourceFile, source) => {
+  const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/.exec(source);
+  if (!match)
+    throw new Error(`Missing frontmatter in ${sourceFile}`);
+  const frontmatter = Schema4.decodeUnknownSync(DocsFrontmatter)(Bun.YAML.parse(match[1] ?? ""));
+  const bodySource = match[2] ?? "";
+  const title = /^#\s+(.+?)\s*$/m.exec(bodySource)?.[1];
+  if (!title || markdownPlainText(title, true) !== markdownPlainText(frontmatter.title, true)) {
+    throw new Error(`Body title does not match frontmatter in ${sourceFile}`);
+  }
+  const body = bodySource.replace(/^\s*#\s+.+?\r?\n+/, "");
+  return Schema4.decodeUnknownSync(DocsPageSchema)({
+    ...frontmatter,
+    ...compileDocsMarkdown(body),
+    sourceFile
+  });
+};
+var loadMdxDocsDirectory = async (root) => {
+  const glob = new Bun.Glob("**/*.mdx");
+  const pages = [];
+  for await (const file of glob.scan({ cwd: root, onlyFiles: true })) {
+    pages.push(compileMdxDocsPage(`${root}/${file}`, await Bun.file(`${root}/${file}`).text()));
+  }
+  return pages;
+};
+export {
+  compileDocsMarkdown,
+  compileMdxDocsPage,
+  loadMdxDocsDirectory
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krak-stack/registry",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "Tree-shakable KrakStack components and Effect services.",
   "license": "MIT",
   "repository": {
@@ -52,6 +52,10 @@
       "types": "./dist/lib/docs.d.ts",
       "import": "./dist/lib/docs.js"
     },
+    "./docs/server": {
+      "types": "./dist/lib/docs.server.d.ts",
+      "import": "./dist/lib/docs.server.js"
+    },
     "./documentation-toolkit": {
       "types": "./dist/lib/documentation-toolkit.d.ts",
       "import": "./dist/lib/documentation-toolkit.js"