From 6d747fba2ea5a3113cc2ef77ba2c121d88fa4ce5 Mon Sep 17 00:00:00 2001
From: phev8 <phev8@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:11:41 +0100
Subject: [PATCH 1/2] feat: integrate fumadocs for documentation, add new
 layout and source configuration, and update README with installation
 instructions

---
 .gitignore                                    |   1 +
 README.md                                     | 225 ++----
 app/docs/[[...slug]]/page.tsx                 |  44 ++
 app/docs/layout.tsx                           |  15 +
 app/globals.css                               |   2 +-
 app/layout.config.tsx                         |  10 +
 app/layout.tsx                                |   8 +-
 app/page.tsx                                  | 219 +-----
 components/docs/component-overview.tsx        |  19 +
 .../docs}/interactive-examples.tsx            |  64 +-
 content/docs/components/alert-provider.mdx    |  73 ++
 content/docs/components/button.mdx            |  48 ++
 content/docs/components/confirm.mdx           |  82 +++
 content/docs/components/dialog.mdx            |  72 ++
 content/docs/components/loading-button.mdx    |  56 ++
 content/docs/index.mdx                        |  45 ++
 content/docs/meta.json                        |   9 +
 lib/source.ts                                 |   7 +
 next.config.mjs                               |   6 +-
 package.json                                  |   2 +
 pnpm-lock.yaml                                | 665 +++++++++++++++++-
 source.config.ts                              |   7 +
 tsconfig.json                                 |   7 +-
 23 files changed, 1289 insertions(+), 397 deletions(-)
 create mode 100644 app/docs/[[...slug]]/page.tsx
 create mode 100644 app/docs/layout.tsx
 create mode 100644 app/layout.config.tsx
 create mode 100644 components/docs/component-overview.tsx
 rename {app => components/docs}/interactive-examples.tsx (71%)
 create mode 100644 content/docs/components/alert-provider.mdx
 create mode 100644 content/docs/components/button.mdx
 create mode 100644 content/docs/components/confirm.mdx
 create mode 100644 content/docs/components/dialog.mdx
 create mode 100644 content/docs/components/loading-button.mdx
 create mode 100644 content/docs/index.mdx
 create mode 100644 content/docs/meta.json
 create mode 100644 lib/source.ts
 create mode 100644 source.config.ts

diff --git a/.gitignore b/.gitignore
index 7f4fd4f..a8b36d2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,6 +16,7 @@
 # next.js
 /.next/
 /out/
+/.source/
 
 # production
 /build
diff --git a/README.md b/README.md
index a63aa32..7ceaf67 100644
--- a/README.md
+++ b/README.md
@@ -1,162 +1,91 @@
 # c-ui registry
 
-Custom [shadcn/ui](https://ui.shadcn.com) registry for common coneno components.
-
-This repo builds registry JSON files into `public/r/radix-nova` and deploys them via the static export in `out/` (GitHub Pages).
-
-## Hosted registry URLs
+Repository for the coneno shadcn registry and its documentation site.
 
+- Public docs: `https://coneno.github.io/c-ui/docs/`
 - Registry index: `https://coneno.github.io/c-ui/r/radix-nova/registry.json`
-- Style-aware component entries: `https://coneno.github.io/c-ui/r/<style>/<component-name>.json`
-- Canonical style: `radix-nova`
-
-## Install via namespace (recommended)
-
-Configure the registry once in your consumer app's `components.json`:
-
-```json
-{
-  "style": "radix-nova",
-  "registries": {
-    "@c-ui": "https://coneno.github.io/c-ui/r/{style}/{name}.json"
-  }
-}
-```
-
-This registry currently supports only `radix-nova`. Set `"style": "radix-nova"` in the consumer app before installing components.
-
-Then install components without repeating full URLs:
-
-```bash
-npx shadcn@latest add @c-ui/loading-button
-```
-
-You can also install multiple components in one command:
-
-```bash
-npx shadcn@latest add @c-ui/alert-provider @c-ui/confirm
-```
-
-## Local registry testing
-
-For local development/testing of this registry, point `@c-ui` to localhost in the consumer app:
-
-```json
-{
-  "style": "radix-nova",
-  "registries": {
-    "@c-ui": "http://localhost:3000/c-ui/r/{style}/{name}.json"
-  }
-}
-```
-
-Then install as usual:
-
-```bash
-npx shadcn@latest add @c-ui/loading-button
-```
-
-## Direct URL install (optional)
-
-If needed, you can still install directly from a component URL:
-
-```bash
-npx shadcn@latest add https://coneno.github.io/c-ui/r/radix-nova/loading-button.json
-```
-
-Current components in this registry:
-
-- `alert-provider`: Alert dialog service with provider + hook for promise-based alerts.
-- `button`: Press-animated base button used across components.
-- `confirm`: Confirmation dialog service with provider + hook.
-- `dialog`: Customized replacement for shadcn `components/ui/dialog.tsx` with overridable close labels to support i18n and screen-reader accessibility.
-- `loading-button`: Button with a built-in loading state.
-
-## Usage examples
 
-```tsx
-import { Button } from "@/components/ui/button"
+This README is intentionally contributor-focused. End-user installation and component usage live in the docs site.
 
-export function SaveAction() {
-  return <Button>Save changes</Button>
-}
-```
-
-```tsx
-import { LoadingButton } from "@/components/c-ui/loading-button"
-
-export function SubmitAction() {
-  return <LoadingButton isLoading>Submitting</LoadingButton>
-}
-```
-
-## Deployment (GitHub Pages)
-
-The workflow in `.github/workflows/deploy-registry-pages.yml` deploys on pushes to `main`.
-
-First-time setup:
-
-1. Open GitHub repository settings.
-2. Go to **Pages**.
-3. Set **Source** to **GitHub Actions**.
-4. Push to `main` (or run the workflow manually from the Actions tab).
-
-The workflow does:
-
-1. Install dependencies with pnpm.
-2. Build registry output with `pnpm registry:build`.
-3. Build the static site with `pnpm build`.
-4. Publish `out/` to GitHub Pages.
-
-## Local development
-
-Install dependencies:
-
-```bash
-pnpm install
-```
-
-Run the app locally (registry files available at `/c-ui/r/radix-nova/*`):
+## What this repo contains
 
-```bash
-pnpm dev
-```
-
-Build registry JSON output:
-
-```bash
-pnpm registry:build
-```
-
-## Add a new component to the registry
-
-1. Create the component source file in `registry/radix-nova/` (example: `registry/radix-nova/my-component.tsx`).
-2. Add a new item to `registry.json`.
-3. Set `name`, `type`, `title`, `description`, `registryDependencies`, and `files`.
-   - You can organize component files in subfolders as well.
-   - Example source path: `registry/radix-nova/forms/my-component.tsx`
-   - Example target path: `components/c-ui/forms/my-component.tsx`
-4. Rebuild output:
-
-```bash
-pnpm registry:build
-```
-
-5. Confirm generated files exist in `public/r/radix-nova/`.
-6. Validate install in a consumer app:
-
-```bash
-npx shadcn@latest add @c-ui/my-component
-```
+- `registry/radix-nova/*`: source component files used to generate registry JSON.
+- `registry.json`: registry manifest consumed by `shadcn build`.
+- `public/r/radix-nova/*`: generated registry JSON artifacts (committed).
+- `content/docs/*`: Fumadocs content for the documentation pages.
+- `app/docs/*`: Fumadocs app routes/layout.
+- `.github/workflows/deploy-registry-pages.yml`: GitHub Pages build/deploy workflow.
 
-7. Commit both source files and generated registry output.
+## Prerequisites
 
-## Build output details
+- Node.js 22 (matches CI)
+- pnpm 10.28.2
 
-`pnpm registry:build` runs:
+## Common commands
 
 ```bash
-shadcn build --output public/r/radix-nova
+pnpm install         # install dependencies
+pnpm dev             # run local site at http://localhost:3000/c-ui
+pnpm registry:build  # generate registry JSON into public/r/radix-nova
+pnpm build           # production build + static export into out/
 ```
 
-That command reads `registry.json` and writes distributable registry JSON files to `public/r/radix-nova`.
+## Contributor workflow
+
+1. Install dependencies with `pnpm install`.
+2. Make your code/docs changes.
+3. Regenerate registry artifacts with `pnpm registry:build` if registry items changed.
+4. Validate with `pnpm build`.
+5. Commit source changes and generated `public/r/radix-nova/*` output together.
+
+## Add a new registry item
+
+1. Add the component source file(s) under `registry/radix-nova/`.
+2. Add an item in `registry.json`:
+   - required baseline: `name`, `type`, `title`, `description`, `files`, `style`
+   - optional: `registryDependencies`, `dependencies`
+3. Ensure each `files[]` entry has:
+   - `path`: source file in this repo
+   - `target`: destination path in consumer projects
+   - `type`: usually `registry:component`
+4. Run:
+   ```bash
+   pnpm registry:build
+   ```
+5. Confirm generated files:
+   - `public/r/radix-nova/<name>.json`
+   - `public/r/radix-nova/registry.json` includes the item
+6. Add docs page for the new item:
+   - create `content/docs/components/<name>.mdx`
+   - add the page slug to `content/docs/components/meta.json`
+7. Run `pnpm build` and verify the docs route and static export succeed.
+
+## Update existing items
+
+When component APIs or behavior change:
+
+1. Update source files in `registry/radix-nova/`.
+2. Update metadata in `registry.json` if title/description/dependencies changed.
+3. Update the corresponding docs page in `content/docs/components/`.
+4. Regenerate registry JSON with `pnpm registry:build`.
+
+## Docs authoring notes
+
+- Docs are built with Fumadocs and rendered from `content/docs`.
+- Sidebar order is controlled by `meta.json` files.
+- Interactive demos used in docs live in `components/docs/interactive-examples.tsx`.
+
+## Deployment
+
+Deploy runs automatically on pushes to `main` via GitHub Actions:
+
+1. `pnpm install --frozen-lockfile`
+2. `pnpm registry:build`
+3. `pnpm build`
+4. publish `out/` to GitHub Pages
+
+## Important conventions
+
+- Do not edit `public/r/radix-nova/*` manually.
+- Always rebuild artifacts after changing `registry.json` or files in `registry/radix-nova/`.
+- Keep docs in sync with component APIs to avoid stale installation/configuration guidance.
diff --git a/app/docs/[[...slug]]/page.tsx b/app/docs/[[...slug]]/page.tsx
new file mode 100644
index 0000000..2e9d156
--- /dev/null
+++ b/app/docs/[[...slug]]/page.tsx
@@ -0,0 +1,44 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import defaultMdxComponents from "fumadocs-ui/mdx";
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from "fumadocs-ui/page";
+import { source } from "@/lib/source";
+
+type PageProps = {
+	params: Promise<{ slug?: string[] }>;
+};
+
+export default async function Page(props: PageProps) {
+	const params = await props.params;
+	const page = source.getPage(params.slug);
+
+	if (!page) notFound();
+
+	const Mdx = page.data.body;
+
+	return (
+		<DocsPage toc={page.data.toc} full={page.data.full}>
+			<DocsTitle>{page.data.title}</DocsTitle>
+			<DocsDescription>{page.data.description}</DocsDescription>
+			<DocsBody>
+				<Mdx components={defaultMdxComponents} />
+			</DocsBody>
+		</DocsPage>
+	);
+}
+
+export function generateStaticParams() {
+	return source.generateParams();
+}
+
+export async function generateMetadata(props: PageProps): Promise<Metadata> {
+	const params = await props.params;
+	const page = source.getPage(params.slug);
+
+	if (!page) notFound();
+
+	return {
+		title: `${page.data.title} | c-ui registry docs`,
+		description: page.data.description,
+	};
+}
diff --git a/app/docs/layout.tsx b/app/docs/layout.tsx
new file mode 100644
index 0000000..933c6d2
--- /dev/null
+++ b/app/docs/layout.tsx
@@ -0,0 +1,15 @@
+import type { ReactNode } from "react";
+import { DocsLayout } from "fumadocs-ui/layouts/docs";
+import { baseOptions } from "@/app/layout.config";
+import { source } from "@/lib/source";
+
+export default function Layout({ children }: { children: ReactNode }) {
+	return (
+		<DocsLayout
+			tree={source.pageTree}
+			{...baseOptions}
+		>
+			{children}
+		</DocsLayout>
+	);
+}
diff --git a/app/globals.css b/app/globals.css
index 70d3eab..d82edcf 100644
--- a/app/globals.css
+++ b/app/globals.css
@@ -2,7 +2,7 @@
 @import "tw-animate-css";
 @import "shadcn/tailwind.css";
 @import "fumadocs-ui/style.css";
-@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/shadcn.css';
 @import 'fumadocs-ui/css/preset.css';
 
 @custom-variant dark (&:is(.dark *));
diff --git a/app/layout.config.tsx b/app/layout.config.tsx
new file mode 100644
index 0000000..5bd7f12
--- /dev/null
+++ b/app/layout.config.tsx
@@ -0,0 +1,10 @@
+import type { BaseLayoutProps } from "fumadocs-ui/layouts/shared";
+
+export const baseOptions: BaseLayoutProps = {
+	nav: {
+		title: "c-ui registry docs",
+	},
+	searchToggle: {
+		enabled: false,
+	},
+};
diff --git a/app/layout.tsx b/app/layout.tsx
index 3663d53..d5be13d 100644
--- a/app/layout.tsx
+++ b/app/layout.tsx
@@ -1,4 +1,6 @@
 import "./globals.css";
+import { RootProvider } from "fumadocs-ui/provider/next";
+
 
 export default function RootLayout({
 	children,
@@ -6,8 +8,10 @@ export default function RootLayout({
 	children: React.ReactNode;
 }>) {
 	return (
-		<html lang="en">
-			<body>{children}</body>
+		<html lang="en" suppressHydrationWarning>
+			<body className="min-h-screen bg-background text-foreground">
+				<RootProvider search={{ enabled: false }}>{children}</RootProvider>
+			</body>
 		</html>
 	);
 }
diff --git a/app/page.tsx b/app/page.tsx
index fda548a..025400a 100644
--- a/app/page.tsx
+++ b/app/page.tsx
@@ -1,220 +1,5 @@
-import registry from "@/registry.json";
-import { DynamicCodeBlock } from "fumadocs-ui/components/dynamic-codeblock";
-import { Button } from "@/registry/radix-nova/button";
-import {
-	AlertDialogInteractiveExample,
-	ConfirmDialogInteractiveExample,
-	LoadingButtonInteractiveExample,
-} from "./interactive-examples";
-
-const hostedBaseUrl = "https://coneno.github.io/c-ui/r";
-const supportedStyle = "radix-nova";
-const registryAlias = "@c-ui";
-const registryTemplateUrl = `${hostedBaseUrl}/{style}/{name}.json`;
-const registryIndexUrl = `${hostedBaseUrl}/${supportedStyle}/registry.json`;
-const usageExamples: Record<string, string> = {
-	"alert-provider": `import { Button } from "@/components/ui/button"
-import { AlertDialogProvider, useAlert } from "@/components/c-ui/alert-provider"
-
-function AlertAction() {
-	const alert = useAlert()
-
-	return (
-		<Button
-			onClick={() =>
-				void alert({
-					title: "Heads up",
-					description: "Your changes were applied.",
-					buttonLabel: "OK",
-				})
-			}
-		>
-			Open alert
-		</Button>
-	)
-}
-
-export function AlertExample() {
-	return (
-		<AlertDialogProvider>
-			<AlertAction />
-		</AlertDialogProvider>
-	)
-}`,
-	"button": `import { Button } from "@/components/ui/button"
-
-export function ButtonExample() {
-	return (
-		<div className="flex flex-wrap gap-3">
-			<Button>Default</Button>
-			<Button variant="outline">Outline</Button>
-		</div>
-	)
-}`,
-	"confirm": `import { Button } from "@/components/ui/button"
-import { ConfirmDialogProvider, useConfirm } from "@/components/c-ui/confirm-provider"
-
-function DeleteAction() {
-	const confirm = useConfirm()
-
-	return (
-		<Button
-			variant="destructive"
-			onClick={async () => {
-				const confirmed = await confirm({
-					title: "Delete item?",
-					description: "This action cannot be undone.",
-					confirmButtonText: "Delete",
-					variant: "destructive",
-				})
-
-				if (confirmed) {
-					// perform destructive action
-				}
-			}}
-		>
-			Delete item
-		</Button>
-	)
-}
-
-export function ConfirmExample() {
-	return (
-		<ConfirmDialogProvider>
-			<DeleteAction />
-		</ConfirmDialogProvider>
-	)
-}`,
-	"loading-button": `import { LoadingButton } from "@/components/c-ui/loading-button"
-import { useState } from "react"
-
-export function SubmitAction() {
-	const [isLoading, setIsLoading] = useState(false)
-
-	const submit = async () => {
-		setIsLoading(true)
-		await new Promise((resolve) => setTimeout(resolve, 1200))
-		setIsLoading(false)
-	}
-
-	return (
-		<LoadingButton isLoading={isLoading} onClick={() => void submit()}>
-			{isLoading ? "Submitting..." : "Submit"}
-		</LoadingButton>
-	)
-}`,
-};
+import { redirect } from "next/navigation";
 
 export default function Home() {
-	const configureRegistriesJson = `{
-  "style": "${supportedStyle}",
-  "registries": {
-    "${registryAlias}": "${registryTemplateUrl}"
-  }
-}`;
-
-	return (
-		<main className="mx-auto min-h-screen w-full max-w-3xl px-4 py-10">
-			<div className="space-y-3">
-				<h1 className="text-3xl font-semibold tracking-tight">c-ui registry</h1>
-				<p className="text-sm text-muted-foreground">
-					Configure this registry once, then install components via{" "}
-					<code>{registryAlias}/&lt;component&gt;</code>.
-				</p>
-				<p className="text-sm text-muted-foreground">
-					This registry currently supports only <code>{supportedStyle}</code>. In the
-					importing project, set <code>{`"style": "${supportedStyle}"`}</code> in{" "}
-					<code>components.json</code> before installing components.
-				</p>
-				<p className="text-sm">
-					Registry index:{" "}
-					<a className="underline underline-offset-4" href={registryIndexUrl}>
-						{registryIndexUrl}
-					</a>
-				</p>
-			</div>
-
-			<section className="mt-8 rounded-lg border bg-card p-4 text-card-foreground">
-				<h2 className="text-lg font-medium">1. Configure style and registries in components.json</h2>
-				<p className="mt-1 text-sm text-muted-foreground">
-					Add this once in your consumer project:
-				</p>
-				<div className="mt-3">
-					<DynamicCodeBlock
-						lang="json"
-						code={configureRegistriesJson}
-						codeblock={{ className: "my-0" }}
-					/>
-				</div>
-			</section>
-
-			<section className="mt-6 space-y-4">
-				{registry.items.map((item) => {
-					const addCommand = `npx shadcn@latest add ${registryAlias}/${item.name}`;
-					const directUrlCommand = `npx shadcn@latest add ${hostedBaseUrl}/${supportedStyle}/${item.name}.json`;
-					const usageExample = usageExamples[item.name];
-					const hasLivePreview = ["alert-provider", "button", "confirm", "loading-button"].includes(
-						item.name
-					);
-
-					return (
-						<article
-							key={item.name}
-							className="rounded-lg border bg-card p-4 text-card-foreground"
-						>
-							<h2 className="text-lg font-medium">{item.title}</h2>
-							<p className="mt-1 text-sm text-muted-foreground">{item.description}</p>
-							<div className="mt-3 space-y-3">
-								<DynamicCodeBlock
-									lang="bash"
-									code={addCommand}
-									codeblock={{ className: "my-0" }}
-								/>
-								<details className="text-xs mt-2 ps-4">
-									<summary className="cursor-pointer text-muted-foreground">
-										Direct URL install
-									</summary>
-									<div className="mt-1">
-										<DynamicCodeBlock
-											lang="bash"
-											code={directUrlCommand}
-											codeblock={{ className: "my-0" }}
-										/>
-									</div>
-								</details>
-								{hasLivePreview ? (
-									<div>
-										<p className="mb-2 text-sm text-muted-foreground">
-											Live preview
-										</p>
-										<div className="rounded-md border p-3">
-											{item.name === "button" ? (
-												<div className="flex flex-wrap gap-3">
-													<Button>Default</Button>
-													<Button variant="outline">Outline</Button>
-												</div>
-											) : null}
-											{item.name === "alert-provider" ? <AlertDialogInteractiveExample /> : null}
-											{item.name === "confirm" ? <ConfirmDialogInteractiveExample /> : null}
-											{item.name === "loading-button" ? <LoadingButtonInteractiveExample /> : null}
-										</div>
-									</div>
-								) : null}
-								{usageExample ? (
-									<div>
-										<p className="mb-2 text-sm text-muted-foreground">Usage</p>
-										<DynamicCodeBlock
-											lang="tsx"
-											code={usageExample}
-											codeblock={{ className: "my-0" }}
-										/>
-									</div>
-								) : null}
-							</div>
-						</article>
-					);
-				})}
-			</section>
-		</main>
-	);
+	redirect("/docs");
 }
diff --git a/components/docs/component-overview.tsx b/components/docs/component-overview.tsx
new file mode 100644
index 0000000..2171541
--- /dev/null
+++ b/components/docs/component-overview.tsx
@@ -0,0 +1,19 @@
+import Link from "next/link";
+import registry from "@/registry.json";
+
+export function ComponentOverview() {
+	return (
+		<div className="not-prose grid gap-3 sm:grid-cols-2">
+			{registry.items.map((item) => (
+				<Link
+					key={item.name}
+					href={`/docs/components/${item.name}`}
+					className="block rounded-lg border bg-card p-4 text-card-foreground no-underline transition-colors hover:bg-muted/50 hover:no-underline"
+				>
+					<div className="text-sm font-medium">{item.title}</div>
+					<p className="mt-1 text-sm text-muted-foreground">{item.description}</p>
+				</Link>
+			))}
+		</div>
+	);
+}
diff --git a/app/interactive-examples.tsx b/components/docs/interactive-examples.tsx
similarity index 71%
rename from app/interactive-examples.tsx
rename to components/docs/interactive-examples.tsx
index f58e66c..1c787de 100644
--- a/app/interactive-examples.tsx
+++ b/components/docs/interactive-examples.tsx
@@ -1,9 +1,18 @@
 "use client";
 
 import { useState } from "react";
-import { Button } from "@/registry/radix-nova/button";
 import { AlertDialogProvider, useAlert } from "@/registry/radix-nova/alert-provider";
+import { Button } from "@/registry/radix-nova/button";
 import { ConfirmDialogProvider, useConfirm } from "@/registry/radix-nova/confirm-provider";
+import {
+	Dialog,
+	DialogContent,
+	DialogDescription,
+	DialogFooter,
+	DialogHeader,
+	DialogTitle,
+	DialogTrigger,
+} from "@/registry/radix-nova/dialog";
 import { LoadingButton } from "@/registry/radix-nova/loading-button";
 
 const wait = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -21,27 +30,11 @@ function AlertExampleContent() {
 		setStatus("Alert dismissed.");
 	};
 
-	const openAlert2 = async () => {
-		await alert({
-			title: "Heads up 2",
-			description: "This is an interactive alert demo 2.",
-			buttonLabel: "Alright",
-			dismissButtonVariant: "outline",
-			dismissButtonClassName: "min-w-32",
-		});
-		setStatus("Alert 2 dismissed.");
-	};
-
 	return (
 		<div className="space-y-2">
-			<div className="flex flex-row gap-2">
-				<Button type="button" onClick={() => void openAlert()}>
-					Open Alert
-				</Button>
-				<Button type="button" onClick={() => void openAlert2()}>
-					Open Alert 2
-				</Button>
-			</div>
+			<Button type="button" onClick={() => void openAlert()}>
+				Open Alert
+			</Button>
 			<p className="text-xs text-muted-foreground">{status}</p>
 		</div>
 	);
@@ -84,6 +77,16 @@ export function AlertDialogInteractiveExample() {
 	);
 }
 
+export function ButtonInteractiveExample() {
+	return (
+		<div className="flex flex-wrap gap-3">
+			<Button>Default</Button>
+			<Button variant="outline">Outline</Button>
+			<Button size="sm">Small</Button>
+		</div>
+	);
+}
+
 export function ConfirmDialogInteractiveExample() {
 	return (
 		<ConfirmDialogProvider>
@@ -92,13 +95,32 @@ export function ConfirmDialogInteractiveExample() {
 	);
 }
 
+export function DialogInteractiveExample() {
+	return (
+		<Dialog>
+			<DialogTrigger asChild>
+				<Button type="button">Open Dialog</Button>
+			</DialogTrigger>
+			<DialogContent closeLabel="Close dialog">
+				<DialogHeader>
+					<DialogTitle>Profile updated</DialogTitle>
+					<DialogDescription>
+						This example uses custom close labels and the footer close button.
+					</DialogDescription>
+				</DialogHeader>
+				<DialogFooter showCloseButton closeLabel="Dismiss" />
+			</DialogContent>
+		</Dialog>
+	);
+}
+
 export function LoadingButtonInteractiveExample() {
 	const [isLoading, setIsLoading] = useState(false);
 	const [count, setCount] = useState(0);
 
 	const triggerLoading = async () => {
 		setIsLoading(true);
-		await wait(1400);
+		await wait(1200);
 		setIsLoading(false);
 		setCount((prev) => prev + 1);
 	};
diff --git a/content/docs/components/alert-provider.mdx b/content/docs/components/alert-provider.mdx
new file mode 100644
index 0000000..5a5abc0
--- /dev/null
+++ b/content/docs/components/alert-provider.mdx
@@ -0,0 +1,73 @@
+---
+title: Alert Provider
+description: Promise-based alert dialog service with provider and hook.
+---
+
+import { AlertDialogInteractiveExample } from "@/components/docs/interactive-examples";
+
+## Install
+
+```bash
+npx shadcn@latest add @c-ui/alert-provider
+```
+
+Direct URL install:
+
+```bash
+npx shadcn@latest add https://coneno.github.io/c-ui/r/radix-nova/alert-provider.json
+```
+
+## Live Example
+
+<AlertDialogInteractiveExample />
+
+## Usage
+
+```tsx
+import { Button } from "@/components/ui/button"
+import { AlertDialogProvider, useAlert } from "@/components/c-ui/alert-provider"
+
+function AlertAction() {
+	const alert = useAlert()
+
+	return (
+		<Button
+			onClick={() =>
+				void alert({
+					title: "Heads up",
+					description: "Your changes were applied.",
+					buttonLabel: "OK",
+				})
+			}
+		>
+			Open alert
+		</Button>
+	)
+}
+
+export function AlertExample() {
+	return (
+		<AlertDialogProvider>
+			<AlertAction />
+		</AlertDialogProvider>
+	)
+}
+```
+
+## Configuration
+
+`useAlert()` accepts these options:
+
+| Option | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `title` | `string` | `"Notice"` | Dialog title |
+| `description` | `string` | `""` | Supporting text under title |
+| `buttonLabel` | `string` | `"OK"` | Dismiss button label |
+| `dismissButtonVariant` | `AlertDialogCancel["variant"]` | `"default"` | Button style variant |
+| `dismissButtonClassName` | `string` | `undefined` | Extra class names for dismiss button |
+| `children` | `ReactNode` | `undefined` | Optional custom content between description and footer |
+
+API behavior:
+
+- `alert(options)` opens the dialog and resolves when dismissed.
+- `alert.dismiss()` closes the current dialog and resolves any pending call.
diff --git a/content/docs/components/button.mdx b/content/docs/components/button.mdx
new file mode 100644
index 0000000..bf6e795
--- /dev/null
+++ b/content/docs/components/button.mdx
@@ -0,0 +1,48 @@
+---
+title: Button
+description: Base button component with variants, sizes, and a subtle press animation.
+---
+
+import { ButtonInteractiveExample } from "@/components/docs/interactive-examples";
+
+## Install
+
+```bash
+npx shadcn@latest add @c-ui/button
+```
+
+Direct URL install:
+
+```bash
+npx shadcn@latest add https://coneno.github.io/c-ui/r/radix-nova/button.json
+```
+
+## Live Example
+
+<ButtonInteractiveExample />
+
+## Usage
+
+```tsx
+import { Button } from "@/components/ui/button"
+
+export function ButtonExample() {
+	return (
+		<div className="flex flex-wrap gap-3">
+			<Button>Default</Button>
+			<Button variant="outline">Outline</Button>
+		</div>
+	)
+}
+```
+
+## Configuration
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `variant` | `"default" \| "outline" \| "secondary" \| "ghost" \| "destructive" \| "link"` | `"default"` | Visual style |
+| `size` | `"default" \| "xs" \| "sm" \| "lg" \| "icon" \| "icon-xs" \| "icon-sm" \| "icon-lg"` | `"default"` | Button sizing |
+| `asChild` | `boolean` | `false` | Render with Radix `Slot` for custom child element |
+| `className` | `string` | `undefined` | Extends styles |
+
+All native `<button>` props are supported.
diff --git a/content/docs/components/confirm.mdx b/content/docs/components/confirm.mdx
new file mode 100644
index 0000000..6c0e356
--- /dev/null
+++ b/content/docs/components/confirm.mdx
@@ -0,0 +1,82 @@
+---
+title: Confirm Dialog
+description: Promise-based confirmation service with optional typed confirmation guard.
+---
+
+import { ConfirmDialogInteractiveExample } from "@/components/docs/interactive-examples";
+
+## Install
+
+```bash
+npx shadcn@latest add @c-ui/confirm
+```
+
+Direct URL install:
+
+```bash
+npx shadcn@latest add https://coneno.github.io/c-ui/r/radix-nova/confirm.json
+```
+
+## Live Example
+
+<ConfirmDialogInteractiveExample />
+
+## Usage
+
+```tsx
+import { Button } from "@/components/ui/button"
+import { ConfirmDialogProvider, useConfirm } from "@/components/c-ui/confirm-provider"
+
+function DeleteAction() {
+	const confirm = useConfirm()
+
+	return (
+		<Button
+			variant="destructive"
+			onClick={async () => {
+				const confirmed = await confirm({
+					title: "Delete item?",
+					description: "This action cannot be undone.",
+					confirmButtonText: "Delete",
+					variant: "destructive",
+				})
+
+				if (confirmed) {
+					// perform destructive action
+				}
+			}}
+		>
+			Delete item
+		</Button>
+	)
+}
+
+export function ConfirmExample() {
+	return (
+		<ConfirmDialogProvider>
+			<DeleteAction />
+		</ConfirmDialogProvider>
+	)
+}
+```
+
+## Configuration
+
+`useConfirm()` accepts these options:
+
+| Option | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `title` | `string` | `"Confirm Action"` | Dialog title |
+| `description` | `string` | `"Are you sure you want to proceed?"` | Description text |
+| `confirmButtonText` | `string` | `"Confirm"` | Confirm action label |
+| `cancelButtonText` | `string` | `"Cancel"` | Cancel action label |
+| `variant` | `"default" \| "destructive"` | `"default"` | Confirm button style |
+| `requireConfirmationInput` | `RequireConfirmationInput` | `undefined` | Forces typed confirmation |
+
+`RequireConfirmationInput`:
+
+| Field | Type | Required | Notes |
+| --- | --- | --- | --- |
+| `confirmTerm` | `string` | Yes | Exact term user must type |
+| `label` | `string` | No | Supports `{{confirmTerm}}` placeholder |
+| `hint` | `string` | No | Helper text below input |
diff --git a/content/docs/components/dialog.mdx b/content/docs/components/dialog.mdx
new file mode 100644
index 0000000..965ab1a
--- /dev/null
+++ b/content/docs/components/dialog.mdx
@@ -0,0 +1,72 @@
+---
+title: Dialog
+description: Customized shadcn dialog primitives with overridable close labels for better i18n and accessibility.
+---
+
+import { DialogInteractiveExample } from "@/components/docs/interactive-examples";
+
+## Install
+
+```bash
+npx shadcn@latest add @c-ui/dialog
+```
+
+Direct URL install:
+
+```bash
+npx shadcn@latest add https://coneno.github.io/c-ui/r/radix-nova/dialog.json
+```
+
+## Live Example
+
+<DialogInteractiveExample />
+
+## Usage
+
+```tsx
+import { Button } from "@/components/ui/button"
+import {
+	Dialog,
+	DialogContent,
+	DialogDescription,
+	DialogFooter,
+	DialogHeader,
+	DialogTitle,
+	DialogTrigger,
+} from "@/components/ui/dialog"
+
+export function ExampleDialog() {
+	return (
+		<Dialog>
+			<DialogTrigger asChild>
+				<Button>Open dialog</Button>
+			</DialogTrigger>
+			<DialogContent closeLabel="Close dialog">
+				<DialogHeader>
+					<DialogTitle>Dialog title</DialogTitle>
+					<DialogDescription>Dialog description.</DialogDescription>
+				</DialogHeader>
+				<DialogFooter showCloseButton closeLabel="Dismiss" />
+			</DialogContent>
+		</Dialog>
+	)
+}
+```
+
+## Configuration
+
+`DialogContent` adds:
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `showCloseButton` | `boolean` | `true` | Toggles top-right close icon button |
+| `closeLabel` | `string` | `"Close"` | `aria-label` + screen reader text for close control |
+
+`DialogFooter` adds:
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `showCloseButton` | `boolean` | `false` | Adds a secondary footer close button |
+| `closeLabel` | `string` | `"Close"` | Label for footer close button |
+
+All other shadcn/Radix dialog props remain available.
diff --git a/content/docs/components/loading-button.mdx b/content/docs/components/loading-button.mdx
new file mode 100644
index 0000000..62ee794
--- /dev/null
+++ b/content/docs/components/loading-button.mdx
@@ -0,0 +1,56 @@
+---
+title: Loading Button
+description: Button wrapper with built-in loading state handling.
+---
+
+import { LoadingButtonInteractiveExample } from "@/components/docs/interactive-examples";
+
+## Install
+
+```bash
+npx shadcn@latest add @c-ui/loading-button
+```
+
+Direct URL install:
+
+```bash
+npx shadcn@latest add https://coneno.github.io/c-ui/r/radix-nova/loading-button.json
+```
+
+## Live Example
+
+<LoadingButtonInteractiveExample />
+
+## Usage
+
+```tsx
+import { LoadingButton } from "@/components/c-ui/loading-button"
+import { useState } from "react"
+
+export function SubmitAction() {
+	const [isLoading, setIsLoading] = useState(false)
+
+	const submit = async () => {
+		setIsLoading(true)
+		await new Promise((resolve) => setTimeout(resolve, 1200))
+		setIsLoading(false)
+	}
+
+	return (
+		<LoadingButton isLoading={isLoading} onClick={() => void submit()}>
+			{isLoading ? "Submitting..." : "Submit"}
+		</LoadingButton>
+	)
+}
+```
+
+## Configuration
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `isLoading` | `boolean` | `false` | Shows spinner and disables button |
+| `variant` | same as `Button` variants | `"default"` | Forwarded to base button |
+| `size` | same as `Button` sizes | `"default"` | Forwarded to base button |
+| `asChild` | `boolean` | `false` | Forwarded to base button |
+
+All native `<button>` props are supported and forwarded.
diff --git a/content/docs/index.mdx b/content/docs/index.mdx
new file mode 100644
index 0000000..d2551e1
--- /dev/null
+++ b/content/docs/index.mdx
@@ -0,0 +1,45 @@
+---
+title: Getting Started
+description: Configure your project once, then install c-ui components via namespace aliases.
+---
+
+import { ComponentOverview } from "@/components/docs/component-overview";
+
+## Required Setup
+
+Add `@c-ui` to your consumer app's `components.json` and set style to `radix-nova`:
+
+```json
+{
+  "style": "radix-nova",
+  "registries": {
+    "@c-ui": "https://coneno.github.io/c-ui/r/{style}/{name}.json"
+  }
+}
+```
+
+This registry currently supports only `radix-nova`.
+
+## Install Components
+
+Install a component by alias:
+
+```bash
+npx shadcn@latest add @c-ui/loading-button
+```
+
+Install multiple components at once:
+
+```bash
+npx shadcn@latest add @c-ui/alert-provider @c-ui/confirm @c-ui/dialog
+```
+
+Registry index:
+
+`https://coneno.github.io/c-ui/r/radix-nova/registry.json`
+
+## Component Overview
+
+Select a component to view installation, live example, and configuration details.
+
+<ComponentOverview />
diff --git a/content/docs/meta.json b/content/docs/meta.json
new file mode 100644
index 0000000..486add5
--- /dev/null
+++ b/content/docs/meta.json
@@ -0,0 +1,9 @@
+{
+	"title": "c-ui registry docs",
+	"pages": [
+		"--- Overview ---",
+		"index",
+		"--- Components ---",
+		"...components"
+	]
+}
\ No newline at end of file
diff --git a/lib/source.ts b/lib/source.ts
new file mode 100644
index 0000000..db9b6f7
--- /dev/null
+++ b/lib/source.ts
@@ -0,0 +1,7 @@
+import { loader } from "fumadocs-core/source";
+import { docs } from "fumadocs-mdx:collections/server";
+
+export const source = loader({
+	baseUrl: "/docs",
+	source: docs.toFumadocsSource(),
+});
diff --git a/next.config.mjs b/next.config.mjs
index 82957e1..691ab9e 100644
--- a/next.config.mjs
+++ b/next.config.mjs
@@ -1,3 +1,5 @@
+import { createMDX } from "fumadocs-mdx/next";
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
 	output: "export",
@@ -5,4 +7,6 @@ const nextConfig = {
 	trailingSlash: true,
 };
 
-export default nextConfig;
+const withMDX = createMDX();
+
+export default withMDX(nextConfig);
diff --git a/package.json b/package.json
index 4943c3a..008ac14 100644
--- a/package.json
+++ b/package.json
@@ -13,12 +13,14 @@
 	"packageManager": "pnpm@10.28.2",
 	"devDependencies": {
 		"@tailwindcss/postcss": "^4.2.0",
+		"@types/mdx": "^2.0.13",
 		"@types/node": "^25.3.0",
 		"@types/react": "^19.2.14",
 		"@types/react-dom": "^19.2.3",
 		"eslint": "^9.39.0",
 		"eslint-config-next": "^16.1.6",
 		"eslint-plugin-react": "^7.37.5",
+		"fumadocs-mdx": "^14.2.8",
 		"postcss": "^8.5.6",
 		"shadcn": "^3.8.5",
 		"tailwindcss": "^4.2.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index c452d9a..9db1fd9 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -19,10 +19,10 @@ importers:
         version: 2.1.1
       fumadocs-core:
         specifier: ^16.6.5
-        version: 16.6.5(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76)
+        version: 16.6.5(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76)
       fumadocs-ui:
         specifier: ^16.6.5
-        version: 16.6.5(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(fumadocs-core@16.6.5(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(tailwindcss@4.2.0)
+        version: 16.6.5(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(fumadocs-core@16.6.5(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(tailwindcss@4.2.0)
       lucide-react:
         specifier: ^0.575.0
         version: 0.575.0(react@19.2.4)
@@ -45,6 +45,9 @@ importers:
       '@tailwindcss/postcss':
         specifier: ^4.2.0
         version: 4.2.0
+      '@types/mdx':
+        specifier: ^2.0.13
+        version: 2.0.13
       '@types/node':
         specifier: ^25.3.0
         version: 25.3.0
@@ -63,6 +66,9 @@ importers:
       eslint-plugin-react:
         specifier: ^7.37.5
         version: 7.37.5(eslint@9.39.3(jiti@2.6.1))
+      fumadocs-mdx:
+        specifier: ^14.2.8
+        version: 14.2.8(@types/mdast@4.0.4)(@types/mdx@2.0.13)(@types/react@19.2.14)(fumadocs-core@16.6.5(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react@19.2.4)
       postcss:
         specifier: ^8.5.6
         version: 8.5.6
@@ -240,6 +246,162 @@ packages:
   '@emnapi/wasi-threads@1.1.0':
     resolution: {integrity: sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ==}
 
+  '@esbuild/aix-ppc64@0.27.3':
+    resolution: {integrity: sha512-9fJMTNFTWZMh5qwrBItuziu834eOCUcEqymSH7pY+zoMVEZg3gcPuBNxH1EvfVYe9h0x/Ptw8KBzv7qxb7l8dg==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.27.3':
+    resolution: {integrity: sha512-YdghPYUmj/FX2SYKJ0OZxf+iaKgMsKHVPF1MAq/P8WirnSpCStzKJFjOjzsW0QQ7oIAiccHdcqjbHmJxRb/dmg==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.27.3':
+    resolution: {integrity: sha512-i5D1hPY7GIQmXlXhs2w8AWHhenb00+GxjxRncS2ZM7YNVGNfaMxgzSGuO8o8SJzRc/oZwU2bcScvVERk03QhzA==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.27.3':
+    resolution: {integrity: sha512-IN/0BNTkHtk8lkOM8JWAYFg4ORxBkZQf9zXiEOfERX/CzxW3Vg1ewAhU7QSWQpVIzTW+b8Xy+lGzdYXV6UZObQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.27.3':
+    resolution: {integrity: sha512-Re491k7ByTVRy0t3EKWajdLIr0gz2kKKfzafkth4Q8A5n1xTHrkqZgLLjFEHVD+AXdUGgQMq+Godfq45mGpCKg==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.27.3':
+    resolution: {integrity: sha512-vHk/hA7/1AckjGzRqi6wbo+jaShzRowYip6rt6q7VYEDX4LEy1pZfDpdxCBnGtl+A5zq8iXDcyuxwtv3hNtHFg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.27.3':
+    resolution: {integrity: sha512-ipTYM2fjt3kQAYOvo6vcxJx3nBYAzPjgTCk7QEgZG8AUO3ydUhvelmhrbOheMnGOlaSFUoHXB6un+A7q4ygY9w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.27.3':
+    resolution: {integrity: sha512-dDk0X87T7mI6U3K9VjWtHOXqwAMJBNN2r7bejDsc+j03SEjtD9HrOl8gVFByeM0aJksoUuUVU9TBaZa2rgj0oA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.27.3':
+    resolution: {integrity: sha512-sZOuFz/xWnZ4KH3YfFrKCf1WyPZHakVzTiqji3WDc0BCl2kBwiJLCXpzLzUBLgmp4veFZdvN5ChW4Eq/8Fc2Fg==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.27.3':
+    resolution: {integrity: sha512-s6nPv2QkSupJwLYyfS+gwdirm0ukyTFNl3KTgZEAiJDd+iHZcbTPPcWCcRYH+WlNbwChgH2QkE9NSlNrMT8Gfw==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.27.3':
+    resolution: {integrity: sha512-yGlQYjdxtLdh0a3jHjuwOrxQjOZYD/C9PfdbgJJF3TIZWnm/tMd/RcNiLngiu4iwcBAOezdnSLAwQDPqTmtTYg==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.27.3':
+    resolution: {integrity: sha512-WO60Sn8ly3gtzhyjATDgieJNet/KqsDlX5nRC5Y3oTFcS1l0KWba+SEa9Ja1GfDqSF1z6hif/SkpQJbL63cgOA==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.27.3':
+    resolution: {integrity: sha512-APsymYA6sGcZ4pD6k+UxbDjOFSvPWyZhjaiPyl/f79xKxwTnrn5QUnXR5prvetuaSMsb4jgeHewIDCIWljrSxw==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.27.3':
+    resolution: {integrity: sha512-eizBnTeBefojtDb9nSh4vvVQ3V9Qf9Df01PfawPcRzJH4gFSgrObw+LveUyDoKU3kxi5+9RJTCWlj4FjYXVPEA==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.27.3':
+    resolution: {integrity: sha512-3Emwh0r5wmfm3ssTWRQSyVhbOHvqegUDRd0WhmXKX2mkHJe1SFCMJhagUleMq+Uci34wLSipf8Lagt4LlpRFWQ==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.27.3':
+    resolution: {integrity: sha512-pBHUx9LzXWBc7MFIEEL0yD/ZVtNgLytvx60gES28GcWMqil8ElCYR4kvbV2BDqsHOvVDRrOxGySBM9Fcv744hw==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.27.3':
+    resolution: {integrity: sha512-Czi8yzXUWIQYAtL/2y6vogER8pvcsOsk5cpwL4Gk5nJqH5UZiVByIY8Eorm5R13gq+DQKYg0+JyQoytLQas4dA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.27.3':
+    resolution: {integrity: sha512-sDpk0RgmTCR/5HguIZa9n9u+HVKf40fbEUt+iTzSnCaGvY9kFP0YKBWZtJaraonFnqef5SlJ8/TiPAxzyS+UoA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.27.3':
+    resolution: {integrity: sha512-P14lFKJl/DdaE00LItAukUdZO5iqNH7+PjoBm+fLQjtxfcfFE20Xf5CrLsmZdq5LFFZzb5JMZ9grUwvtVYzjiA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.27.3':
+    resolution: {integrity: sha512-AIcMP77AvirGbRl/UZFTq5hjXK+2wC7qFRGoHSDrZ5v5b8DK/GYpXW3CPRL53NkvDqb9D+alBiC/dV0Fb7eJcw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.27.3':
+    resolution: {integrity: sha512-DnW2sRrBzA+YnE70LKqnM3P+z8vehfJWHXECbwBmH/CU51z6FiqTQTHFenPlHmo3a8UgpLyH3PT+87OViOh1AQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.27.3':
+    resolution: {integrity: sha512-NinAEgr/etERPTsZJ7aEZQvvg/A6IsZG/LgZy+81wON2huV7SrK3e63dU0XhyZP4RKGyTm7aOgmQk0bGp0fy2g==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.27.3':
+    resolution: {integrity: sha512-PanZ+nEz+eWoBJ8/f8HKxTTD172SKwdXebZ0ndd953gt1HRBbhMsaNqjTyYLGLPdoWHy4zLU7bDVJztF5f3BHA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.27.3':
+    resolution: {integrity: sha512-B2t59lWWYrbRDw/tjiWOuzSsFh1Y/E95ofKz7rIVYSQkUYBjfSgf6oeYPNWHToFRr2zx52JKApIcAS/D5TUBnA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.27.3':
+    resolution: {integrity: sha512-QLKSFeXNS8+tHW7tZpMtjlNb7HKau0QDpwm49u0vUp9y1WOF+PEzkU84y9GqYaAVW8aH8f3GcBck26jh54cX4Q==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.27.3':
+    resolution: {integrity: sha512-4uJGhsxuptu3OcpVAzli+/gWusVGwZZHTlS63hh++ehExkVT8SgiEf7/uC/PclrPPkLhZqGgCTjd0VWLo6xMqA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
   '@eslint-community/eslint-utils@4.9.1':
     resolution: {integrity: sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==}
     engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
@@ -533,6 +695,9 @@ packages:
   '@jridgewell/trace-mapping@0.3.31':
     resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
 
+  '@mdx-js/mdx@3.1.1':
+    resolution: {integrity: sha512-f6ZO2ifpwAQIpzGWaBQT2TXxPv6z3RBzQKpVftEWN78Vl/YweF1uwussDx8ECAXVtr3Rs89fKyG9YlzUs9DyGQ==}
+
   '@modelcontextprotocol/sdk@1.26.0':
     resolution: {integrity: sha512-Y5RmPncpiDtTXDbLKswIJzTqu2hyBKxTNsgKqKclDbhIgg1wgtf1fRuvxgTnRfcnxtvvgbIEcqUOzZrJ6iSReg==}
     engines: {node: '>=18'}
@@ -1385,6 +1550,9 @@ packages:
     resolution: {integrity: sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ==}
     engines: {node: '>=18'}
 
+  '@standard-schema/spec@1.1.0':
+    resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
+
   '@swc/helpers@0.5.15':
     resolution: {integrity: sha512-JQ5TuMi45Owi4/BIMAJBoSQoOJu12oOk/gADqlcUL9JEdHB8vyjUSsxqeNXnmXHjYKMi2WcYtezGEEhqUI/E2g==}
 
@@ -1507,6 +1675,9 @@ packages:
   '@types/mdast@4.0.4':
     resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
 
+  '@types/mdx@2.0.13':
+    resolution: {integrity: sha512-+OWZQfAYyio6YkJb3HLxDrvnx6SWWDbC0zVPfBRzUk0/nqoDyf6dNxQi3eArPe8rJ473nobTMQ/8Zk+LxJ+Yuw==}
+
   '@types/ms@2.1.0':
     resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==}
 
@@ -1799,6 +1970,10 @@ packages:
     resolution: {integrity: sha512-6t10qk83GOG8p0vKmaCr8eiilZwO171AvbROMtvvNiwrTly62t+7XkA8RdIIVbpMhCASAsxgAzdRSwh6nw/5Dg==}
     engines: {node: '>=4'}
 
+  astring@1.9.0:
+    resolution: {integrity: sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg==}
+    hasBin: true
+
   async-function@1.0.0:
     resolution: {integrity: sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==}
     engines: {node: '>= 0.4'}
@@ -1903,6 +2078,10 @@ packages:
   character-reference-invalid@2.0.1:
     resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
 
+  chokidar@5.0.0:
+    resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==}
+    engines: {node: '>= 20.19.0'}
+
   class-variance-authority@0.7.1:
     resolution: {integrity: sha512-Ka+9Trutv7G8M6WT6SeiRWz792K5qEqIGEGzXKhAE6xOWAY6pPH8U+9IY3oCMv6kqTmLsv7Xh/2w2RigkePMsg==}
 
@@ -1932,6 +2111,9 @@ packages:
   code-block-writer@13.0.3:
     resolution: {integrity: sha512-Oofo0pq3IKnsFtuHqSF7TqBfr71aeyZDVJ0HpmqB7FBM2qEigL0iPONSCZSO9pE9dZTAxANe5XHG9Uy0YMv8cg==}
 
+  collapse-white-space@2.1.0:
+    resolution: {integrity: sha512-loKTxY1zCOuG4j9f6EPnuyyYkf58RnhhWTvRoZEokgB+WbdXehfjFviyOVYkqzEWz1Q5kRiZdBYS5SwxbQYwzw==}
+
   color-convert@2.0.1:
     resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
     engines: {node: '>=7.0.0'}
@@ -2182,6 +2364,17 @@ packages:
     resolution: {integrity: sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g==}
     engines: {node: '>= 0.4'}
 
+  esast-util-from-estree@2.0.0:
+    resolution: {integrity: sha512-4CyanoAudUSBAn5K13H4JhsMH6L9ZP7XbLVe/dKybkxMO7eDyLsT8UHl9TRNrU2Gr9nz+FovfSIjuXWJ81uVwQ==}
+
+  esast-util-from-js@2.0.1:
+    resolution: {integrity: sha512-8Ja+rNJ0Lt56Pcf3TAmpBZjmx8ZcK5Ts4cAzIOjsjevg9oSXJnl6SUQ2EevU8tv3h6ZLWmoKL5H4fgWvdvfETw==}
+
+  esbuild@0.27.3:
+    resolution: {integrity: sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==}
+    engines: {node: '>=18'}
+    hasBin: true
+
   escalade@3.2.0:
     resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==}
     engines: {node: '>=6'}
@@ -2321,12 +2514,27 @@ packages:
   estree-util-attach-comments@3.0.0:
     resolution: {integrity: sha512-cKUwm/HUcTDsYh/9FgnuFqpfquUbwIqwKM26BVCGDPVgvaCl/nDCCjUfiLlx6lsEZ3Z4RFxNbOQ60pkaEwFxGw==}
 
+  estree-util-build-jsx@3.0.1:
+    resolution: {integrity: sha512-8U5eiL6BTrPxp/CHbs2yMgP8ftMhR5ww1eIKoWRMlqvltHF8fZn5LRDvTKuxD3DUn+shRbLGqXemcP51oFCsGQ==}
+
   estree-util-is-identifier-name@3.0.0:
     resolution: {integrity: sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==}
 
+  estree-util-scope@1.0.0:
+    resolution: {integrity: sha512-2CAASclonf+JFWBNJPndcOpA8EMJwa0Q8LUFJEKqXLW6+qBvbFZuF5gItbQOs/umBUkjviCSDCbBwU2cXbmrhQ==}
+
+  estree-util-to-js@2.0.0:
+    resolution: {integrity: sha512-WDF+xj5rRWmD5tj6bIqRi6CkLIXbbNQUcxQHzGysQzvHmdYG2G7p/Tf0J0gpxGgkeMZNTIjT/AoSvC9Xehcgdg==}
+
   estree-util-value-to-estree@3.5.0:
     resolution: {integrity: sha512-aMV56R27Gv3QmfmF1MY12GWkGzzeAezAX+UplqHVASfjc9wNzI/X6hC0S9oxq61WT4aQesLGslWP9tKk6ghRZQ==}
 
+  estree-util-visit@2.0.0:
+    resolution: {integrity: sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==}
+
+  estree-walker@3.0.3:
+    resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
+
   esutils@2.0.3:
     resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==}
     engines: {node: '>=0.10.0'}
@@ -2517,6 +2725,37 @@ packages:
       zod:
         optional: true
 
+  fumadocs-mdx@14.2.8:
+    resolution: {integrity: sha512-B3ST+kNftmS3r4R2mQqJn0h9CUld1YU0VPu1hTgrigp8xfwhWsPJ8aBoOPpYX9uW6VBlmB1Lu/gkeB4AuQD8UA==}
+    hasBin: true
+    peerDependencies:
+      '@fumadocs/mdx-remote': ^1.4.0
+      '@types/mdast': '*'
+      '@types/mdx': '*'
+      '@types/react': '*'
+      fumadocs-core: ^15.0.0 || ^16.0.0
+      mdast-util-directive: '*'
+      next: ^15.3.0 || ^16.0.0
+      react: '*'
+      vite: 6.x.x || 7.x.x
+    peerDependenciesMeta:
+      '@fumadocs/mdx-remote':
+        optional: true
+      '@types/mdast':
+        optional: true
+      '@types/mdx':
+        optional: true
+      '@types/react':
+        optional: true
+      mdast-util-directive:
+        optional: true
+      next:
+        optional: true
+      react:
+        optional: true
+      vite:
+        optional: true
+
   fumadocs-ui@16.6.5:
     resolution: {integrity: sha512-R2Rb0t85y4kiqeDQy1I2CfYCxYiE0XsATlyNWumDpMd92HAZKfQ1zLtr9ldJLDWi7C9SQWrPmFxSC8khnS5Hqw==}
     peerDependencies:
@@ -3141,6 +3380,10 @@ packages:
   magic-string@0.30.21:
     resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
 
+  markdown-extensions@2.0.0:
+    resolution: {integrity: sha512-o5vL7aDWatOTX8LzaS1WMoaoxIiLRQJuIKKe2wAw6IeULDHaqbiqiggmx+pKvZDb1Sj+pE46Sn1T7lCqfFtg1Q==}
+    engines: {node: '>=16'}
+
   markdown-table@3.0.4:
     resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
 
@@ -3235,12 +3478,30 @@ packages:
   micromark-extension-gfm@3.0.0:
     resolution: {integrity: sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==}
 
+  micromark-extension-mdx-expression@3.0.1:
+    resolution: {integrity: sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==}
+
+  micromark-extension-mdx-jsx@3.0.2:
+    resolution: {integrity: sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==}
+
+  micromark-extension-mdx-md@2.0.0:
+    resolution: {integrity: sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==}
+
+  micromark-extension-mdxjs-esm@3.0.0:
+    resolution: {integrity: sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==}
+
+  micromark-extension-mdxjs@3.0.0:
+    resolution: {integrity: sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==}
+
   micromark-factory-destination@2.0.1:
     resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==}
 
   micromark-factory-label@2.0.1:
     resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==}
 
+  micromark-factory-mdx-expression@2.0.3:
+    resolution: {integrity: sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==}
+
   micromark-factory-space@2.0.1:
     resolution: {integrity: sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==}
 
@@ -3271,6 +3532,9 @@ packages:
   micromark-util-encode@2.0.1:
     resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==}
 
+  micromark-util-events-to-acorn@2.0.3:
+    resolution: {integrity: sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==}
+
   micromark-util-html-tag-name@2.0.1:
     resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==}
 
@@ -3711,10 +3975,28 @@ packages:
     resolution: {integrity: sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==}
     engines: {node: '>=0.10.0'}
 
+  readdirp@5.0.0:
+    resolution: {integrity: sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==}
+    engines: {node: '>= 20.19.0'}
+
   recast@0.23.11:
     resolution: {integrity: sha512-YTUo+Flmw4ZXiWfQKGcwwc11KnoRAYgzAE2E7mXKCjSviTKShtxBsN6YUUBB2gtaBzKzeKunxhUwNHQuRryhWA==}
     engines: {node: '>= 4'}
 
+  recma-build-jsx@1.0.0:
+    resolution: {integrity: sha512-8GtdyqaBcDfva+GUKDr3nev3VpKAhup1+RvkMvUxURHpW7QyIvk9F5wz7Vzo06CEMSilw6uArgRqhpiUcWp8ew==}
+
+  recma-jsx@1.0.1:
+    resolution: {integrity: sha512-huSIy7VU2Z5OLv6oFLosQGGDqPqdO1iq6bWNAdhzMxSJP7RAso4fCZ1cKu8j9YHCZf3TPrq4dw3okhrylgcd7w==}
+    peerDependencies:
+      acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+  recma-parse@1.0.0:
+    resolution: {integrity: sha512-OYLsIGBB5Y5wjnSnQW6t3Xg7q3fQ7FWbw/vcXtORTnyaSFscOtABg+7Pnz6YZ6c27fG1/aN8CjfwoUEUIdwqWQ==}
+
+  recma-stringify@1.0.0:
+    resolution: {integrity: sha512-cjwII1MdIIVloKvC9ErQ+OgAtwHBmcZ0Bg4ciz78FtbT8In39aAYbaA7zvxQ61xVMSPE8WxhLwLbhif4Js2C+g==}
+
   reflect.getprototypeof@1.0.10:
     resolution: {integrity: sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==}
     engines: {node: '>= 0.4'}
@@ -3735,9 +4017,15 @@ packages:
   rehype-raw@7.0.0:
     resolution: {integrity: sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==}
 
+  rehype-recma@1.0.0:
+    resolution: {integrity: sha512-lqA4rGUf1JmacCNWWZx0Wv1dHqMwxzsDWYMTowuplHF3xH0N/MmrZ/G3BDZnzAkRmxDadujCjaKM2hqYdCBOGw==}
+
   remark-gfm@4.0.1:
     resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==}
 
+  remark-mdx@3.1.1:
+    resolution: {integrity: sha512-Pjj2IYlUY3+D8x00UJsIOg5BEvfMyeI+2uLPn9VO9Wg4MEtN/VTIq2NEJQfde9PnX15KgtHyl9S0BcTnWrIuWg==}
+
   remark-parse@11.0.0:
     resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==}
 
@@ -3903,6 +4191,10 @@ packages:
     resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==}
     engines: {node: '>=0.10.0'}
 
+  source-map@0.7.6:
+    resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==}
+    engines: {node: '>= 12'}
+
   space-separated-tokens@2.0.2:
     resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==}
 
@@ -4142,9 +4434,15 @@ packages:
   unist-util-is@6.0.1:
     resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==}
 
+  unist-util-position-from-estree@2.0.0:
+    resolution: {integrity: sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==}
+
   unist-util-position@5.0.0:
     resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==}
 
+  unist-util-remove-position@5.0.0:
+    resolution: {integrity: sha512-Hp5Kh3wLxv0PHj9m2yZhhLt58KzPtEYKQQ4yxfYFEO7EvHwzyDYnduhHnY1mDxoqr7VUwVuHXk9RXKIiYS1N8Q==}
+
   unist-util-stringify-position@4.0.0:
     resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==}
 
@@ -4315,6 +4613,9 @@ packages:
   zod@3.25.76:
     resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==}
 
+  zod@4.3.6:
+    resolution: {integrity: sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg==}
+
   zwitch@2.0.4:
     resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==}
 
@@ -4547,6 +4848,84 @@ snapshots:
       tslib: 2.8.1
     optional: true
 
+  '@esbuild/aix-ppc64@0.27.3':
+    optional: true
+
+  '@esbuild/android-arm64@0.27.3':
+    optional: true
+
+  '@esbuild/android-arm@0.27.3':
+    optional: true
+
+  '@esbuild/android-x64@0.27.3':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.27.3':
+    optional: true
+
+  '@esbuild/darwin-x64@0.27.3':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.27.3':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.27.3':
+    optional: true
+
+  '@esbuild/linux-arm64@0.27.3':
+    optional: true
+
+  '@esbuild/linux-arm@0.27.3':
+    optional: true
+
+  '@esbuild/linux-ia32@0.27.3':
+    optional: true
+
+  '@esbuild/linux-loong64@0.27.3':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.27.3':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.27.3':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.27.3':
+    optional: true
+
+  '@esbuild/linux-s390x@0.27.3':
+    optional: true
+
+  '@esbuild/linux-x64@0.27.3':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.27.3':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.27.3':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.27.3':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.27.3':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.27.3':
+    optional: true
+
+  '@esbuild/sunos-x64@0.27.3':
+    optional: true
+
+  '@esbuild/win32-arm64@0.27.3':
+    optional: true
+
+  '@esbuild/win32-ia32@0.27.3':
+    optional: true
+
+  '@esbuild/win32-x64@0.27.3':
+    optional: true
+
   '@eslint-community/eslint-utils@4.9.1(eslint@9.39.3(jiti@2.6.1))':
     dependencies:
       eslint: 9.39.3(jiti@2.6.1)
@@ -4784,6 +5163,36 @@ snapshots:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.5
 
+  '@mdx-js/mdx@3.1.1':
+    dependencies:
+      '@types/estree': 1.0.8
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdx': 2.0.13
+      acorn: 8.16.0
+      collapse-white-space: 2.1.0
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      estree-util-scope: 1.0.0
+      estree-walker: 3.0.3
+      hast-util-to-jsx-runtime: 2.3.6
+      markdown-extensions: 2.0.0
+      recma-build-jsx: 1.0.0
+      recma-jsx: 1.0.1(acorn@8.16.0)
+      recma-stringify: 1.0.0
+      rehype-recma: 1.0.0
+      remark-mdx: 3.1.1
+      remark-parse: 11.0.0
+      remark-rehype: 11.1.2
+      source-map: 0.7.6
+      unified: 11.0.5
+      unist-util-position-from-estree: 2.0.0
+      unist-util-stringify-position: 4.0.0
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+    transitivePeerDependencies:
+      - supports-color
+
   '@modelcontextprotocol/sdk@1.26.0(zod@3.25.76)':
     dependencies:
       '@hono/node-server': 1.19.9(hono@4.12.0)
@@ -5692,6 +6101,8 @@ snapshots:
 
   '@sindresorhus/merge-streams@4.0.0': {}
 
+  '@standard-schema/spec@1.1.0': {}
+
   '@swc/helpers@0.5.15':
     dependencies:
       tslib: 2.8.1
@@ -5798,6 +6209,8 @@ snapshots:
     dependencies:
       '@types/unist': 3.0.3
 
+  '@types/mdx@2.0.13': {}
+
   '@types/ms@2.1.0': {}
 
   '@types/node@25.3.0':
@@ -6101,6 +6514,8 @@ snapshots:
     dependencies:
       tslib: 2.8.1
 
+  astring@1.9.0: {}
+
   async-function@1.0.0: {}
 
   available-typed-arrays@1.0.7:
@@ -6202,6 +6617,10 @@ snapshots:
 
   character-reference-invalid@2.0.1: {}
 
+  chokidar@5.0.0:
+    dependencies:
+      readdirp: 5.0.0
+
   class-variance-authority@0.7.1:
     dependencies:
       clsx: 2.1.1
@@ -6226,6 +6645,8 @@ snapshots:
 
   code-block-writer@13.0.3: {}
 
+  collapse-white-space@2.1.0: {}
+
   color-convert@2.0.1:
     dependencies:
       color-name: 1.1.4
@@ -6498,6 +6919,49 @@ snapshots:
       is-date-object: 1.1.0
       is-symbol: 1.1.1
 
+  esast-util-from-estree@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      devlop: 1.1.0
+      estree-util-visit: 2.0.0
+      unist-util-position-from-estree: 2.0.0
+
+  esast-util-from-js@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      acorn: 8.16.0
+      esast-util-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  esbuild@0.27.3:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.27.3
+      '@esbuild/android-arm': 0.27.3
+      '@esbuild/android-arm64': 0.27.3
+      '@esbuild/android-x64': 0.27.3
+      '@esbuild/darwin-arm64': 0.27.3
+      '@esbuild/darwin-x64': 0.27.3
+      '@esbuild/freebsd-arm64': 0.27.3
+      '@esbuild/freebsd-x64': 0.27.3
+      '@esbuild/linux-arm': 0.27.3
+      '@esbuild/linux-arm64': 0.27.3
+      '@esbuild/linux-ia32': 0.27.3
+      '@esbuild/linux-loong64': 0.27.3
+      '@esbuild/linux-mips64el': 0.27.3
+      '@esbuild/linux-ppc64': 0.27.3
+      '@esbuild/linux-riscv64': 0.27.3
+      '@esbuild/linux-s390x': 0.27.3
+      '@esbuild/linux-x64': 0.27.3
+      '@esbuild/netbsd-arm64': 0.27.3
+      '@esbuild/netbsd-x64': 0.27.3
+      '@esbuild/openbsd-arm64': 0.27.3
+      '@esbuild/openbsd-x64': 0.27.3
+      '@esbuild/openharmony-arm64': 0.27.3
+      '@esbuild/sunos-x64': 0.27.3
+      '@esbuild/win32-arm64': 0.27.3
+      '@esbuild/win32-ia32': 0.27.3
+      '@esbuild/win32-x64': 0.27.3
+
   escalade@3.2.0: {}
 
   escape-html@1.0.3: {}
@@ -6715,12 +7179,39 @@ snapshots:
     dependencies:
       '@types/estree': 1.0.8
 
+  estree-util-build-jsx@3.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      estree-walker: 3.0.3
+
   estree-util-is-identifier-name@3.0.0: {}
 
+  estree-util-scope@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.8
+      devlop: 1.1.0
+
+  estree-util-to-js@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      astring: 1.9.0
+      source-map: 0.7.6
+
   estree-util-value-to-estree@3.5.0:
     dependencies:
       '@types/estree': 1.0.8
 
+  estree-util-visit@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/unist': 3.0.3
+
+  estree-walker@3.0.3:
+    dependencies:
+      '@types/estree': 1.0.8
+
   esutils@2.0.3: {}
 
   etag@1.8.1: {}
@@ -6897,7 +7388,7 @@ snapshots:
       jsonfile: 6.2.0
       universalify: 2.0.1
 
-  fumadocs-core@16.6.5(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76):
+  fumadocs-core@16.6.5(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76):
     dependencies:
       '@formatjs/intl-localematcher': 0.8.1
       '@orama/orama': 3.1.18
@@ -6923,6 +7414,7 @@ snapshots:
       unist-util-visit: 5.1.0
       vfile: 6.0.3
     optionalDependencies:
+      '@mdx-js/mdx': 3.1.1
       '@types/estree-jsx': 1.0.5
       '@types/hast': 3.0.4
       '@types/mdast': 4.0.4
@@ -6935,7 +7427,36 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  fumadocs-ui@16.6.5(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(fumadocs-core@16.6.5(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(tailwindcss@4.2.0):
+  fumadocs-mdx@14.2.8(@types/mdast@4.0.4)(@types/mdx@2.0.13)(@types/react@19.2.14)(fumadocs-core@16.6.5(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react@19.2.4):
+    dependencies:
+      '@mdx-js/mdx': 3.1.1
+      '@standard-schema/spec': 1.1.0
+      chokidar: 5.0.0
+      esbuild: 0.27.3
+      estree-util-value-to-estree: 3.5.0
+      fumadocs-core: 16.6.5(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76)
+      js-yaml: 4.1.1
+      mdast-util-mdx: 3.0.0
+      mdast-util-to-markdown: 2.1.2
+      picocolors: 1.1.1
+      picomatch: 4.0.3
+      tinyexec: 1.0.2
+      tinyglobby: 0.2.15
+      unified: 11.0.5
+      unist-util-remove-position: 5.0.0
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+      zod: 4.3.6
+    optionalDependencies:
+      '@types/mdast': 4.0.4
+      '@types/mdx': 2.0.13
+      '@types/react': 19.2.14
+      next: 16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
+      react: 19.2.4
+    transitivePeerDependencies:
+      - supports-color
+
+  fumadocs-ui@16.6.5(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(fumadocs-core@16.6.5(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(tailwindcss@4.2.0):
     dependencies:
       '@fumadocs/tailwind': 0.0.2(tailwindcss@4.2.0)
       '@radix-ui/react-accordion': 1.2.12(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
@@ -6949,7 +7470,7 @@ snapshots:
       '@radix-ui/react-slot': 1.2.4(@types/react@19.2.14)(react@19.2.4)
       '@radix-ui/react-tabs': 1.1.13(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       class-variance-authority: 0.7.1
-      fumadocs-core: 16.6.5(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76)
+      fumadocs-core: 16.6.5(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.14)(lucide-react@0.575.0(react@19.2.4))(next@16.1.6(@babel/core@7.29.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76)
       lucide-react: 0.570.0(react@19.2.4)
       motion: 12.34.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       next-themes: 0.4.6(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
@@ -7574,6 +8095,8 @@ snapshots:
     dependencies:
       '@jridgewell/sourcemap-codec': 1.5.5
 
+  markdown-extensions@2.0.0: {}
+
   markdown-table@3.0.4: {}
 
   math-intrinsics@1.1.0: {}
@@ -7826,6 +8349,57 @@ snapshots:
       micromark-util-combine-extensions: 2.0.1
       micromark-util-types: 2.0.2
 
+  micromark-extension-mdx-expression@3.0.1:
+    dependencies:
+      '@types/estree': 1.0.8
+      devlop: 1.1.0
+      micromark-factory-mdx-expression: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-mdx-jsx@3.0.2:
+    dependencies:
+      '@types/estree': 1.0.8
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      micromark-factory-mdx-expression: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      vfile-message: 4.0.3
+
+  micromark-extension-mdx-md@2.0.0:
+    dependencies:
+      micromark-util-types: 2.0.2
+
+  micromark-extension-mdxjs-esm@3.0.0:
+    dependencies:
+      '@types/estree': 1.0.8
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.3
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-position-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  micromark-extension-mdxjs@3.0.0:
+    dependencies:
+      acorn: 8.16.0
+      acorn-jsx: 5.3.2(acorn@8.16.0)
+      micromark-extension-mdx-expression: 3.0.1
+      micromark-extension-mdx-jsx: 3.0.2
+      micromark-extension-mdx-md: 2.0.0
+      micromark-extension-mdxjs-esm: 3.0.0
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-types: 2.0.2
+
   micromark-factory-destination@2.0.1:
     dependencies:
       micromark-util-character: 2.1.1
@@ -7839,6 +8413,18 @@ snapshots:
       micromark-util-symbol: 2.0.1
       micromark-util-types: 2.0.2
 
+  micromark-factory-mdx-expression@2.0.3:
+    dependencies:
+      '@types/estree': 1.0.8
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-position-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
   micromark-factory-space@2.0.1:
     dependencies:
       micromark-util-character: 2.1.1
@@ -7891,6 +8477,16 @@ snapshots:
 
   micromark-util-encode@2.0.1: {}
 
+  micromark-util-events-to-acorn@2.0.3:
+    dependencies:
+      '@types/estree': 1.0.8
+      '@types/unist': 3.0.3
+      devlop: 1.1.0
+      estree-util-visit: 2.0.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      vfile-message: 4.0.3
+
   micromark-util-html-tag-name@2.0.1: {}
 
   micromark-util-normalize-identifier@2.0.1:
@@ -8414,6 +9010,8 @@ snapshots:
 
   react@19.2.4: {}
 
+  readdirp@5.0.0: {}
+
   recast@0.23.11:
     dependencies:
       ast-types: 0.16.1
@@ -8422,6 +9020,35 @@ snapshots:
       tiny-invariant: 1.3.3
       tslib: 2.8.1
 
+  recma-build-jsx@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.8
+      estree-util-build-jsx: 3.0.1
+      vfile: 6.0.3
+
+  recma-jsx@1.0.1(acorn@8.16.0):
+    dependencies:
+      acorn: 8.16.0
+      acorn-jsx: 5.3.2(acorn@8.16.0)
+      estree-util-to-js: 2.0.0
+      recma-parse: 1.0.0
+      recma-stringify: 1.0.0
+      unified: 11.0.5
+
+  recma-parse@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.8
+      esast-util-from-js: 2.0.1
+      unified: 11.0.5
+      vfile: 6.0.3
+
+  recma-stringify@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.8
+      estree-util-to-js: 2.0.0
+      unified: 11.0.5
+      vfile: 6.0.3
+
   reflect.getprototypeof@1.0.10:
     dependencies:
       call-bind: 1.0.8
@@ -8458,6 +9085,14 @@ snapshots:
       hast-util-raw: 9.1.0
       vfile: 6.0.3
 
+  rehype-recma@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.8
+      '@types/hast': 3.0.4
+      hast-util-to-estree: 3.1.3
+    transitivePeerDependencies:
+      - supports-color
+
   remark-gfm@4.0.1:
     dependencies:
       '@types/mdast': 4.0.4
@@ -8469,6 +9104,13 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  remark-mdx@3.1.1:
+    dependencies:
+      mdast-util-mdx: 3.0.0
+      micromark-extension-mdxjs: 3.0.0
+    transitivePeerDependencies:
+      - supports-color
+
   remark-parse@11.0.0:
     dependencies:
       '@types/mdast': 4.0.4
@@ -8760,6 +9402,8 @@ snapshots:
 
   source-map@0.6.1: {}
 
+  source-map@0.7.6: {}
+
   space-separated-tokens@2.0.2: {}
 
   stable-hash@0.0.5: {}
@@ -9033,10 +9677,19 @@ snapshots:
     dependencies:
       '@types/unist': 3.0.3
 
+  unist-util-position-from-estree@2.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
   unist-util-position@5.0.0:
     dependencies:
       '@types/unist': 3.0.3
 
+  unist-util-remove-position@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-visit: 5.1.0
+
   unist-util-stringify-position@4.0.0:
     dependencies:
       '@types/unist': 3.0.3
@@ -9238,4 +9891,6 @@ snapshots:
 
   zod@3.25.76: {}
 
+  zod@4.3.6: {}
+
   zwitch@2.0.4: {}
diff --git a/source.config.ts b/source.config.ts
new file mode 100644
index 0000000..335435c
--- /dev/null
+++ b/source.config.ts
@@ -0,0 +1,7 @@
+import { defineConfig, defineDocs } from "fumadocs-mdx/config";
+
+export const docs = defineDocs({
+	dir: "content/docs",
+});
+
+export default defineConfig();
diff --git a/tsconfig.json b/tsconfig.json
index efb33a9..ec6ca93 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -18,9 +18,12 @@
     "jsx": "react-jsx",
     "incremental": true,
     "paths": {
+      "fumadocs-mdx:collections/*": [
+        "./.source/*"
+      ],
       "@/components/c-ui/*": [
         "./components/c-ui/*",
-        "./registry/radix-nova/*",
+        "./registry/radix-nova/*"
       ],
       "@/*": [
         "./*"
@@ -42,4 +45,4 @@
     "node_modules",
     "public"
   ]
-}
\ No newline at end of file
+}

From 046eeb110215af47e51c478860bb8890f4a36eba Mon Sep 17 00:00:00 2001
From: phev8 <phev8@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:32:02 +0100
Subject: [PATCH 2/2] chore: update configuration for base path and add start
 script to package.json; enhance README with build and start instructions

---
 .github/workflows/deploy-registry-pages.yml | 2 ++
 README.md                                   | 5 ++++-
 next.config.mjs                             | 4 +++-
 package.json                                | 3 ++-
 4 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/deploy-registry-pages.yml b/.github/workflows/deploy-registry-pages.yml
index 4bbad85..2fb639b 100644
--- a/.github/workflows/deploy-registry-pages.yml
+++ b/.github/workflows/deploy-registry-pages.yml
@@ -18,6 +18,8 @@ concurrency:
 jobs:
   build:
     runs-on: ubuntu-latest
+    env:
+      NEXT_PUBLIC_BASE_PATH: /c-ui
     steps:
       - name: Checkout
         uses: actions/checkout@v4
diff --git a/README.md b/README.md
index 7ceaf67..538676c 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,8 @@ This README is intentionally contributor-focused. End-user installation and comp
 pnpm install         # install dependencies
 pnpm dev             # run local site at http://localhost:3000/c-ui
 pnpm registry:build  # generate registry JSON into public/r/radix-nova
-pnpm build           # production build + static export into out/
+pnpm build           # GitHub Pages build (basePath=/c-ui) + static export into out/
+pnpm start           # serve ./out with a static file server
 ```
 
 ## Contributor workflow
@@ -49,9 +50,11 @@ pnpm build           # production build + static export into out/
    - `target`: destination path in consumer projects
    - `type`: usually `registry:component`
 4. Run:
+
    ```bash
    pnpm registry:build
    ```
+
 5. Confirm generated files:
    - `public/r/radix-nova/<name>.json`
    - `public/r/radix-nova/registry.json` includes the item
diff --git a/next.config.mjs b/next.config.mjs
index 691ab9e..11b201b 100644
--- a/next.config.mjs
+++ b/next.config.mjs
@@ -1,10 +1,12 @@
 import { createMDX } from "fumadocs-mdx/next";
 
+const basePath = process.env.NEXT_PUBLIC_BASE_PATH ?? "/c-ui";
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
 	output: "export",
-	basePath: "/c-ui",
 	trailingSlash: true,
+	...(basePath ? { basePath } : {}),
 };
 
 const withMDX = createMDX();
diff --git a/package.json b/package.json
index 008ac14..f9ca16f 100644
--- a/package.json
+++ b/package.json
@@ -7,7 +7,8 @@
 		"dev": "next dev",
 		"build": "next build",
 		"test": "echo \"Error: no test specified\" && exit 1",
-		"registry:build": "shadcn build --output public/r/radix-nova"
+		"registry:build": "shadcn build --output public/r/radix-nova",
+		"start": "pnpm dlx serve@latest out"
 	},
 	"author": "coneno GmbH",
 	"packageManager": "pnpm@10.28.2",