@kuckit/docs-module 0.1.1

package/dist/client/index.d.ts

@@ -0,0 +1,62 @@
+import { KuckitClientModuleContext } from "@kuckit/sdk-react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/client/pages/DocsPage.d.ts
+declare function DocsPage(): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+//#region src/client/types.d.ts
+interface DocSlug {
+  readonly segments: readonly string[];
+  readonly versionId?: string;
+}
+interface DocFrontmatter {
+  readonly title: string;
+  readonly description?: string;
+  readonly order?: number;
+  readonly group?: string;
+  readonly icon?: string;
+  readonly tags?: readonly string[];
+  readonly sidebarHidden?: boolean;
+  readonly searchHidden?: boolean;
+}
+interface DocTocItem {
+  readonly id: string;
+  readonly depth: number;
+  readonly text: string;
+}
+interface DocTreeNode {
+  readonly slug: DocSlug;
+  readonly path: string;
+  readonly title: string;
+  readonly group?: string;
+  readonly icon?: string;
+  readonly order: number;
+  readonly children: readonly DocTreeNode[];
+  readonly isIndex: boolean;
+  readonly versionId?: string;
+}
+interface CompiledMdxPayload {
+  readonly kind: 'mdx-serialized';
+  readonly code: string;
+  readonly scope: Record<string, unknown>;
+}
+interface DocPage {
+  readonly slug: DocSlug;
+  readonly path: string;
+  readonly frontmatter: DocFrontmatter;
+  readonly toc: readonly DocTocItem[];
+  readonly compiled: CompiledMdxPayload;
+  readonly lastModified?: string;
+  readonly versionId?: string;
+}
+//#endregion
+//#region src/client/index.d.ts
+declare const kuckitClientModule: {
+  id: string;
+  displayName: string;
+  version: string;
+  register(ctx: KuckitClientModuleContext): void;
+};
+//#endregion
+export { CompiledMdxPayload, DocFrontmatter, DocPage, DocSlug, DocTocItem, DocTreeNode, DocsPage, kuckitClientModule };
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.js

@@ -0,0 +1,220 @@
+import { defineKuckitClientModule, useRpc } from "@kuckit/sdk-react";
+import { Suspense, createContext, useContext, useEffect, useMemo, useState } from "react";
+import { useRouterState } from "@tanstack/react-router";
+import { executeMdxSync } from "@fumadocs/mdx-remote/client";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/client/pages/DocsPage.tsx
+const DocsConfigContext = createContext({ basePath: "/docs" });
+function DocsPage() {
+	const rpc = useRpc();
+	const pathname = useRouterState().location.pathname;
+	const { basePath } = useContext(DocsConfigContext);
+	const slugPath = pathname.replace(/^\/docs\/?/, "");
+	const slug = slugPath ? slugPath.split("/").filter(Boolean) : [];
+	const [tree, setTree] = useState([]);
+	const [treeLoading, setTreeLoading] = useState(true);
+	const [page, setPage] = useState(null);
+	const [loading, setLoading] = useState(true);
+	const [error, setError] = useState(null);
+	useEffect(() => {
+		rpc.docs.getTree({}).then((data) => {
+			setTree(data);
+			setTreeLoading(false);
+		});
+	}, [rpc]);
+	useEffect(() => {
+		async function load() {
+			setLoading(true);
+			setError(null);
+			try {
+				const pageData = await rpc.docs.getPage({ slug });
+				if (!pageData) setError({
+					type: "not-found",
+					message: "The documentation page you're looking for doesn't exist."
+				});
+				else setPage(pageData);
+			} catch (err) {
+				if (err?.data?.code === "COMPILE_ERROR") setError({
+					type: "compile-error",
+					message: "Failed to render page. Check MDX syntax."
+				});
+				else setError({
+					type: "load-error",
+					message: "Unable to load documentation content."
+				});
+			} finally {
+				setLoading(false);
+			}
+		}
+		load();
+	}, [slug.join("/"), rpc]);
+	const MdxContent = useMemo(() => {
+		if (!page) return null;
+		return executeMdxSync(page.compiled.code, { scope: page.compiled.scope }).default;
+	}, [page]);
+	if (loading || treeLoading) return /* @__PURE__ */ jsx("div", {
+		className: "flex items-center justify-center min-h-screen bg-background",
+		children: /* @__PURE__ */ jsx("div", { className: "animate-spin rounded-full h-8 w-8 border-b-2 border-primary" })
+	});
+	if (error) return /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col items-center justify-center min-h-screen bg-background",
+		children: [
+			/* @__PURE__ */ jsx("h1", {
+				className: "text-2xl font-bold",
+				children: error.type === "not-found" ? "Page Not Found" : "Error"
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: "text-muted-foreground mt-2",
+				children: error.message
+			}),
+			/* @__PURE__ */ jsx("a", {
+				href: "/docs",
+				className: "mt-4 text-primary hover:underline",
+				children: "← Back to Documentation"
+			})
+		]
+	});
+	if (!page || !MdxContent) return null;
+	const currentPath = slug.length > 0 ? `${basePath}/${slug.join("/")}` : basePath;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex min-h-screen bg-background text-foreground",
+		children: [
+			/* @__PURE__ */ jsxs("aside", {
+				className: "w-64 shrink-0 border-r border-border hidden md:block sticky top-0 h-screen overflow-y-auto",
+				children: [/* @__PURE__ */ jsx("div", {
+					className: "p-6",
+					children: /* @__PURE__ */ jsx("a", {
+						href: "/docs",
+						className: "text-lg font-semibold text-foreground hover:text-primary transition-colors",
+						children: "Documentation"
+					})
+				}), /* @__PURE__ */ jsx("nav", {
+					className: "px-4 pb-6",
+					children: /* @__PURE__ */ jsx(DocsSidebar, {
+						tree,
+						currentPath,
+						basePath
+					})
+				})]
+			}),
+			/* @__PURE__ */ jsx("main", {
+				className: "flex-1 min-w-0",
+				children: /* @__PURE__ */ jsx("div", {
+					className: "max-w-3xl mx-auto px-8 py-12",
+					children: /* @__PURE__ */ jsx(Suspense, {
+						fallback: /* @__PURE__ */ jsx("div", {
+							className: "p-8 text-muted-foreground",
+							children: "Loading..."
+						}),
+						children: /* @__PURE__ */ jsxs("article", {
+							className: "prose prose-neutral dark:prose-invert max-w-none",
+							children: [
+								/* @__PURE__ */ jsx("h1", { children: page.frontmatter.title }),
+								page.frontmatter.description && /* @__PURE__ */ jsx("p", {
+									className: "lead",
+									children: page.frontmatter.description
+								}),
+								/* @__PURE__ */ jsx(MdxContent, {})
+							]
+						})
+					})
+				})
+			}),
+			/* @__PURE__ */ jsx("aside", {
+				className: "w-56 shrink-0 hidden lg:block sticky top-0 h-screen overflow-y-auto border-l border-border",
+				children: /* @__PURE__ */ jsx("div", {
+					className: "p-6",
+					children: /* @__PURE__ */ jsx(DocsToc, { toc: page.toc })
+				})
+			})
+		]
+	});
+}
+function DocsSidebar({ tree, currentPath, basePath }) {
+	return /* @__PURE__ */ jsx("nav", {
+		className: "space-y-1",
+		children: tree.map((node) => /* @__PURE__ */ jsx(SidebarNode, {
+			node,
+			currentPath,
+			basePath,
+			depth: 0
+		}, node.path))
+	});
+}
+function SidebarNode({ node, currentPath, basePath, depth }) {
+	const nodePath = `${basePath}/${node.slug.segments.join("/")}`;
+	const isActive = currentPath === nodePath;
+	const hasChildren = node.children && node.children.length > 0;
+	return /* @__PURE__ */ jsxs("div", {
+		className: depth > 0 ? "ml-3 border-l border-border/50 pl-3" : "",
+		children: [/* @__PURE__ */ jsx("a", {
+			href: nodePath,
+			className: `block px-3 py-2 rounded-md text-sm transition-colors ${isActive ? "bg-primary text-primary-foreground font-medium" : "text-muted-foreground hover:text-foreground hover:bg-muted"}`,
+			children: node.title
+		}), hasChildren && /* @__PURE__ */ jsx("div", {
+			className: "mt-1 space-y-1",
+			children: node.children.map((child) => /* @__PURE__ */ jsx(SidebarNode, {
+				node: child,
+				currentPath,
+				basePath,
+				depth: depth + 1
+			}, child.path))
+		})]
+	});
+}
+function DocsToc({ toc }) {
+	if (!toc || toc.length === 0) return null;
+	return /* @__PURE__ */ jsxs("nav", {
+		className: "space-y-1",
+		children: [/* @__PURE__ */ jsx("h3", {
+			className: "font-semibold text-sm mb-3 text-foreground",
+			children: "On this page"
+		}), toc.map((item) => /* @__PURE__ */ jsx("a", {
+			href: `#${item.id}`,
+			className: "block text-sm text-muted-foreground hover:text-foreground transition-colors py-1",
+			style: { paddingLeft: `${(item.depth - 2) * 12}px` },
+			children: item.text
+		}, item.id))]
+	});
+}
+
+//#endregion
+//#region src/client/index.ts
+const kuckitClientModule = defineKuckitClientModule({
+	id: "kuckit.docs",
+	displayName: "Documentation",
+	version: "0.1.0",
+	register(ctx) {
+		ctx.registerComponent("DocsPage", DocsPage);
+		ctx.addRoute({
+			id: "docs-index",
+			path: "/docs",
+			component: DocsPage,
+			meta: {
+				title: "Documentation",
+				requiresAuth: false
+			}
+		});
+		ctx.addRoute({
+			id: "docs-page",
+			path: "/docs/$",
+			component: DocsPage,
+			meta: {
+				title: "Documentation",
+				requiresAuth: false
+			}
+		});
+		ctx.addNavItem({
+			id: "nav-docs",
+			label: "Docs",
+			path: "/docs",
+			icon: "book-open",
+			order: 20
+		});
+	}
+});
+
+//#endregion
+export { DocsPage, kuckitClientModule };
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["err: unknown"],"sources":["../../src/client/pages/DocsPage.tsx","../../src/client/index.ts"],"sourcesContent":["import { Suspense, useEffect, useState, createContext, useContext, useMemo } from 'react'\nimport { useRouterState } from '@tanstack/react-router'\nimport { useRpc } from '@kuckit/sdk-react'\nimport { executeMdxSync } from '@fumadocs/mdx-remote/client'\nimport type { DocTreeNode, DocPage as DocPageType, DocTocItem } from '../types'\n\ninterface DocsRpc {\n\tdocs: {\n\t\tgetTree: (input: { versionId?: string }) => Promise<DocTreeNode[]>\n\t\tgetPage: (input: { slug: string[]; versionId?: string }) => Promise<DocPageType | null>\n\t}\n}\n\nconst DocsConfigContext = createContext<{ basePath: string }>({ basePath: '/docs' })\n\nexport function DocsPage() {\n\tconst rpc = useRpc<DocsRpc>()\n\tconst routerState = useRouterState()\n\tconst pathname = routerState.location.pathname\n\n\tconst { basePath } = useContext(DocsConfigContext)\n\tconst slugPath = pathname.replace(/^\\/docs\\/?/, '')\n\tconst slug = slugPath ? slugPath.split('/').filter(Boolean) : []\n\n\tconst [tree, setTree] = useState<DocTreeNode[]>([])\n\tconst [treeLoading, setTreeLoading] = useState(true)\n\tconst [page, setPage] = useState<DocPageType | null>(null)\n\tconst [loading, setLoading] = useState(true)\n\tconst [error, setError] = useState<{\n\t\ttype: 'not-found' | 'compile-error' | 'load-error'\n\t\tmessage: string\n\t} | null>(null)\n\n\tuseEffect(() => {\n\t\trpc.docs.getTree({}).then((data) => {\n\t\t\tsetTree(data)\n\t\t\tsetTreeLoading(false)\n\t\t})\n\t}, [rpc])\n\n\tuseEffect(() => {\n\t\tasync function load() {\n\t\t\tsetLoading(true)\n\t\t\tsetError(null)\n\t\t\ttry {\n\t\t\t\tconst pageData = await rpc.docs.getPage({ slug })\n\t\t\t\tif (!pageData) {\n\t\t\t\t\tsetError({\n\t\t\t\t\t\ttype: 'not-found',\n\t\t\t\t\t\tmessage: \"The documentation page you're looking for doesn't exist.\",\n\t\t\t\t\t})\n\t\t\t\t} else {\n\t\t\t\t\tsetPage(pageData)\n\t\t\t\t}\n\t\t\t} catch (err: unknown) {\n\t\t\t\tconst errorData = err as { data?: { code?: string } }\n\t\t\t\tif (errorData?.data?.code === 'COMPILE_ERROR') {\n\t\t\t\t\tsetError({ type: 'compile-error', message: 'Failed to render page. Check MDX syntax.' })\n\t\t\t\t} else {\n\t\t\t\t\tsetError({ type: 'load-error', message: 'Unable to load documentation content.' })\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\tsetLoading(false)\n\t\t\t}\n\t\t}\n\t\tload()\n\t}, [slug.join('/'), rpc])\n\n\tconst MdxContent = useMemo(() => {\n\t\tif (!page) return null\n\t\tconst result = executeMdxSync(page.compiled.code, {\n\t\t\tscope: page.compiled.scope,\n\t\t})\n\t\treturn result.default\n\t}, [page])\n\n\tif (loading || treeLoading) {\n\t\treturn (\n\t\t\t<div className=\"flex items-center justify-center min-h-screen bg-background\">\n\t\t\t\t<div className=\"animate-spin rounded-full h-8 w-8 border-b-2 border-primary\" />\n\t\t\t</div>\n\t\t)\n\t}\n\n\tif (error) {\n\t\treturn (\n\t\t\t<div className=\"flex flex-col items-center justify-center min-h-screen bg-background\">\n\t\t\t\t<h1 className=\"text-2xl font-bold\">\n\t\t\t\t\t{error.type === 'not-found' ? 'Page Not Found' : 'Error'}\n\t\t\t\t</h1>\n\t\t\t\t<p className=\"text-muted-foreground mt-2\">{error.message}</p>\n\t\t\t\t<a href=\"/docs\" className=\"mt-4 text-primary hover:underline\">\n\t\t\t\t\t← Back to Documentation\n\t\t\t\t</a>\n\t\t\t</div>\n\t\t)\n\t}\n\n\tif (!page || !MdxContent) return null\n\n\tconst currentPath = slug.length > 0 ? `${basePath}/${slug.join('/')}` : basePath\n\n\treturn (\n\t\t<div className=\"flex min-h-screen bg-background text-foreground\">\n\t\t\t{/* Sidebar */}\n\t\t\t<aside className=\"w-64 shrink-0 border-r border-border hidden md:block sticky top-0 h-screen overflow-y-auto\">\n\t\t\t\t<div className=\"p-6\">\n\t\t\t\t\t<a\n\t\t\t\t\t\thref=\"/docs\"\n\t\t\t\t\t\tclassName=\"text-lg font-semibold text-foreground hover:text-primary transition-colors\"\n\t\t\t\t\t>\n\t\t\t\t\t\tDocumentation\n\t\t\t\t\t</a>\n\t\t\t\t</div>\n\t\t\t\t<nav className=\"px-4 pb-6\">\n\t\t\t\t\t<DocsSidebar tree={tree} currentPath={currentPath} basePath={basePath} />\n\t\t\t\t</nav>\n\t\t\t</aside>\n\n\t\t\t{/* Main content */}\n\t\t\t<main className=\"flex-1 min-w-0\">\n\t\t\t\t<div className=\"max-w-3xl mx-auto px-8 py-12\">\n\t\t\t\t\t<Suspense fallback={<div className=\"p-8 text-muted-foreground\">Loading...</div>}>\n\t\t\t\t\t\t<article className=\"prose prose-neutral dark:prose-invert max-w-none\">\n\t\t\t\t\t\t\t<h1>{page.frontmatter.title}</h1>\n\t\t\t\t\t\t\t{page.frontmatter.description && (\n\t\t\t\t\t\t\t\t<p className=\"lead\">{page.frontmatter.description}</p>\n\t\t\t\t\t\t\t)}\n\t\t\t\t\t\t\t<MdxContent />\n\t\t\t\t\t\t</article>\n\t\t\t\t\t</Suspense>\n\t\t\t\t</div>\n\t\t\t</main>\n\n\t\t\t{/* Table of contents */}\n\t\t\t<aside className=\"w-56 shrink-0 hidden lg:block sticky top-0 h-screen overflow-y-auto border-l border-border\">\n\t\t\t\t<div className=\"p-6\">\n\t\t\t\t\t<DocsToc toc={page.toc as DocTocItem[]} />\n\t\t\t\t</div>\n\t\t\t</aside>\n\t\t</div>\n\t)\n}\n\nfunction DocsSidebar({\n\ttree,\n\tcurrentPath,\n\tbasePath,\n}: {\n\ttree: DocTreeNode[]\n\tcurrentPath: string\n\tbasePath: string\n}) {\n\treturn (\n\t\t<nav className=\"space-y-1\">\n\t\t\t{tree.map((node) => (\n\t\t\t\t<SidebarNode\n\t\t\t\t\tkey={node.path}\n\t\t\t\t\tnode={node}\n\t\t\t\t\tcurrentPath={currentPath}\n\t\t\t\t\tbasePath={basePath}\n\t\t\t\t\tdepth={0}\n\t\t\t\t/>\n\t\t\t))}\n\t\t</nav>\n\t)\n}\n\nfunction SidebarNode({\n\tnode,\n\tcurrentPath,\n\tbasePath,\n\tdepth,\n}: {\n\tnode: DocTreeNode\n\tcurrentPath: string\n\tbasePath: string\n\tdepth: number\n}) {\n\tconst nodePath = `${basePath}/${node.slug.segments.join('/')}`\n\tconst isActive = currentPath === nodePath\n\tconst hasChildren = node.children && node.children.length > 0\n\n\treturn (\n\t\t<div className={depth > 0 ? 'ml-3 border-l border-border/50 pl-3' : ''}>\n\t\t\t<a\n\t\t\t\thref={nodePath}\n\t\t\t\tclassName={`block px-3 py-2 rounded-md text-sm transition-colors ${\n\t\t\t\t\tisActive\n\t\t\t\t\t\t? 'bg-primary text-primary-foreground font-medium'\n\t\t\t\t\t\t: 'text-muted-foreground hover:text-foreground hover:bg-muted'\n\t\t\t\t}`}\n\t\t\t>\n\t\t\t\t{node.title}\n\t\t\t</a>\n\t\t\t{hasChildren && (\n\t\t\t\t<div className=\"mt-1 space-y-1\">\n\t\t\t\t\t{node.children!.map((child) => (\n\t\t\t\t\t\t<SidebarNode\n\t\t\t\t\t\t\tkey={child.path}\n\t\t\t\t\t\t\tnode={child as DocTreeNode}\n\t\t\t\t\t\t\tcurrentPath={currentPath}\n\t\t\t\t\t\t\tbasePath={basePath}\n\t\t\t\t\t\t\tdepth={depth + 1}\n\t\t\t\t\t\t/>\n\t\t\t\t\t))}\n\t\t\t\t</div>\n\t\t\t)}\n\t\t</div>\n\t)\n}\n\nfunction DocsToc({ toc }: { toc: DocTocItem[] }) {\n\tif (!toc || toc.length === 0) return null\n\n\treturn (\n\t\t<nav className=\"space-y-1\">\n\t\t\t<h3 className=\"font-semibold text-sm mb-3 text-foreground\">On this page</h3>\n\t\t\t{toc.map((item) => (\n\t\t\t\t<a\n\t\t\t\t\tkey={item.id}\n\t\t\t\t\thref={`#${item.id}`}\n\t\t\t\t\tclassName=\"block text-sm text-muted-foreground hover:text-foreground transition-colors py-1\"\n\t\t\t\t\tstyle={{ paddingLeft: `${(item.depth - 2) * 12}px` }}\n\t\t\t\t>\n\t\t\t\t\t{item.text}\n\t\t\t\t</a>\n\t\t\t))}\n\t\t</nav>\n\t)\n}\n","import { defineKuckitClientModule, type KuckitClientModuleContext } from '@kuckit/sdk-react'\nimport { DocsPage } from './pages/DocsPage'\n\nexport const kuckitClientModule = defineKuckitClientModule({\n\tid: 'kuckit.docs',\n\tdisplayName: 'Documentation',\n\tversion: '0.1.0',\n\n\tregister(ctx: KuckitClientModuleContext) {\n\t\tctx.registerComponent('DocsPage', DocsPage)\n\n\t\tctx.addRoute({\n\t\t\tid: 'docs-index',\n\t\t\tpath: '/docs',\n\t\t\tcomponent: DocsPage,\n\t\t\tmeta: {\n\t\t\t\ttitle: 'Documentation',\n\t\t\t\trequiresAuth: false,\n\t\t\t},\n\t\t})\n\n\t\tctx.addRoute({\n\t\t\tid: 'docs-page',\n\t\t\tpath: '/docs/$',\n\t\t\tcomponent: DocsPage,\n\t\t\tmeta: {\n\t\t\t\ttitle: 'Documentation',\n\t\t\t\trequiresAuth: false,\n\t\t\t},\n\t\t})\n\n\t\tctx.addNavItem({\n\t\t\tid: 'nav-docs',\n\t\t\tlabel: 'Docs',\n\t\t\tpath: '/docs',\n\t\t\ticon: 'book-open',\n\t\t\torder: 20,\n\t\t})\n\t},\n})\n\nexport { DocsPage } from './pages/DocsPage'\nexport type * from './types'\n"],"mappings":"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"}

package/dist/server/module.d.ts

@@ -0,0 +1,53 @@
+import * as _kuckit_sdk0 from "@kuckit/sdk";
+import { z } from "zod";
+
+//#region src/server/config.d.ts
+
+declare const docsModuleConfigSchema: z.ZodObject<{
+  docsDir: z.ZodDefault<z.ZodString>;
+  basePath: z.ZodDefault<z.ZodString>;
+  enableSearch: z.ZodDefault<z.ZodBoolean>;
+  cacheTtlSeconds: z.ZodDefault<z.ZodNumber>;
+  devMode: z.ZodOptional<z.ZodBoolean>;
+  versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    pathSegment: z.ZodString;
+    default: z.ZodOptional<z.ZodBoolean>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+  fumadocs: z.ZodOptional<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    logoSrc: z.ZodOptional<z.ZodString>;
+    primaryColor: z.ZodOptional<z.ZodString>;
+    tocDepth: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type DocsModuleConfig = z.infer<typeof docsModuleConfigSchema>;
+//#endregion
+//#region src/server/module.d.ts
+declare const kuckitModule: _kuckit_sdk0.KuckitModuleDefinition<{
+  docsDir: string;
+  basePath: string;
+  enableSearch: boolean;
+  cacheTtlSeconds: number;
+  devMode?: boolean | undefined;
+  versions?: {
+    id: string;
+    label: string;
+    pathSegment: string;
+    default?: boolean | undefined;
+    hidden?: boolean | undefined;
+  }[] | undefined;
+  fumadocs?: {
+    tocDepth: number;
+    title?: string | undefined;
+    description?: string | undefined;
+    logoSrc?: string | undefined;
+    primaryColor?: string | undefined;
+  } | undefined;
+}>;
+//#endregion
+export { type DocsModuleConfig, kuckitModule };
+//# sourceMappingURL=module.d.ts.map

package/dist/server/module.js

@@ -0,0 +1,525 @@
+import * as path from "node:path";
+import { asFunction, defineKuckitModule } from "@kuckit/sdk";
+import { z } from "zod";
+import * as fs from "node:fs/promises";
+import matter from "gray-matter";
+import { createCompiler, parseFrontmatter } from "@fumadocs/mdx-remote";
+import { publicProcedure } from "@kuckit/api";
+
+//#region src/server/config.ts
+const docsVersionConfigSchema = z.object({
+	id: z.string(),
+	label: z.string(),
+	pathSegment: z.string(),
+	default: z.boolean().optional(),
+	hidden: z.boolean().optional()
+});
+const docsModuleConfigSchema = z.object({
+	docsDir: z.string().default("content/docs"),
+	basePath: z.string().default("/docs"),
+	enableSearch: z.boolean().default(true),
+	cacheTtlSeconds: z.number().default(300),
+	devMode: z.boolean().optional(),
+	versions: z.array(docsVersionConfigSchema).optional(),
+	fumadocs: z.object({
+		title: z.string().optional(),
+		description: z.string().optional(),
+		logoSrc: z.string().optional(),
+		primaryColor: z.string().optional(),
+		tocDepth: z.number().default(3)
+	}).optional()
+});
+
+//#endregion
+//#region src/server/domain/doc-node.ts
+const docSlugSchema = z.object({
+	segments: z.array(z.string()),
+	versionId: z.string().optional()
+});
+const docFrontmatterSchema = z.object({
+	title: z.string(),
+	description: z.string().optional(),
+	order: z.number().optional(),
+	group: z.string().optional(),
+	icon: z.string().optional(),
+	sidebarHidden: z.boolean().optional(),
+	searchHidden: z.boolean().optional(),
+	tags: z.array(z.string()).optional()
+});
+const docTocItemSchema = z.object({
+	id: z.string(),
+	text: z.string(),
+	depth: z.number()
+});
+
+//#endregion
+//#region src/server/adapters/filesystem-docs.repository.ts
+const FRONTMATTER_HEAD_BYTES = 2048;
+function makeFilesystemDocsRepository(options) {
+	const { docsDir, versions } = options;
+	const frontmatterCache = /* @__PURE__ */ new Map();
+	function validateSlug(slug) {
+		if (slug.some((segment) => segment === ".." || segment === "" || segment.startsWith("/"))) throw new Error("Invalid slug: path traversal detected");
+	}
+	function getDocsPath(versionId) {
+		if (versionId && versions) {
+			const version = versions.find((v) => v.id === versionId);
+			if (version) return path.join(docsDir, version.pathSegment);
+		}
+		return docsDir;
+	}
+	async function findMdxFile(basePath, slug) {
+		const slugPath = slug.join("/");
+		const candidates = [
+			path.join(basePath, `${slugPath}.mdx`),
+			path.join(basePath, `${slugPath}.md`),
+			path.join(basePath, slugPath, "index.mdx"),
+			path.join(basePath, slugPath, "index.md")
+		];
+		if (slug.length === 0) candidates.unshift(path.join(basePath, "index.mdx"), path.join(basePath, "index.md"));
+		for (const candidate of candidates) try {
+			const resolved = path.resolve(candidate);
+			if (!resolved.startsWith(path.resolve(docsDir))) continue;
+			await fs.access(resolved);
+			return resolved;
+		} catch {
+			continue;
+		}
+		return null;
+	}
+	async function buildTree(dir, parentSlug = [], versionId) {
+		const nodes = [];
+		let entries;
+		try {
+			entries = await fs.readdir(dir, { withFileTypes: true });
+		} catch {
+			return [];
+		}
+		for (const entry of entries) {
+			const entryName = entry.name;
+			const fullPath = path.join(dir, entryName);
+			if (entry.isDirectory()) {
+				const childSlug = [...parentSlug, entryName];
+				const children = await buildTree(fullPath, childSlug, versionId);
+				const indexFile = await findMdxFile(fullPath, []);
+				if (indexFile) {
+					const frontmatter = await extractFrontmatterCached(indexFile, entryName);
+					if (!frontmatter.sidebarHidden) nodes.push({
+						slug: {
+							segments: childSlug,
+							versionId
+						},
+						path: `/${childSlug.join("/")}`,
+						title: frontmatter.title,
+						group: frontmatter.group,
+						icon: frontmatter.icon,
+						order: frontmatter.order ?? 999,
+						children,
+						isIndex: true,
+						versionId
+					});
+				} else if (children.length > 0) nodes.push({
+					slug: {
+						segments: childSlug,
+						versionId
+					},
+					path: `/${childSlug.join("/")}`,
+					title: formatTitle(entryName),
+					order: 999,
+					children,
+					isIndex: false,
+					versionId
+				});
+			} else if (entry.isFile() && /\.(mdx?|md)$/.test(entryName)) {
+				const baseName = entryName.replace(/\.(mdx?|md)$/, "");
+				if (baseName === "index") continue;
+				const frontmatter = await extractFrontmatterCached(fullPath, baseName);
+				if (!frontmatter.sidebarHidden) {
+					const childSlug = [...parentSlug, baseName];
+					nodes.push({
+						slug: {
+							segments: childSlug,
+							versionId
+						},
+						path: `/${childSlug.join("/")}`,
+						title: frontmatter.title,
+						group: frontmatter.group,
+						icon: frontmatter.icon,
+						order: frontmatter.order ?? 999,
+						children: [],
+						isIndex: false,
+						versionId
+					});
+				}
+			}
+		}
+		return nodes.sort((a, b) => a.order - b.order);
+	}
+	function parseFrontmatter$1(data, fallbackTitle) {
+		const result = docFrontmatterSchema.safeParse({
+			title: fallbackTitle,
+			...data
+		});
+		if (result.success) return result.data;
+		return { title: formatTitle(fallbackTitle) };
+	}
+	function formatTitle(slug) {
+		return slug.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+	}
+	async function extractFrontmatterCached(filePath, fallbackTitle) {
+		const mtime = (await fs.stat(filePath)).mtimeMs;
+		const cached = frontmatterCache.get(filePath);
+		if (cached && cached.mtime === mtime) return cached.frontmatter;
+		const handle = await fs.open(filePath, "r");
+		try {
+			const buffer = Buffer.alloc(FRONTMATTER_HEAD_BYTES);
+			const { bytesRead } = await handle.read(buffer, 0, FRONTMATTER_HEAD_BYTES, 0);
+			const head = buffer.subarray(0, bytesRead).toString("utf-8");
+			if (!head.startsWith("---")) {
+				const frontmatter$1 = { title: formatTitle(fallbackTitle) };
+				frontmatterCache.set(filePath, {
+					mtime,
+					frontmatter: frontmatter$1
+				});
+				return frontmatter$1;
+			}
+			if (!head.slice(3).match(/\r?\n---/)) {
+				const { data: data$1 } = matter(await fs.readFile(filePath, "utf-8"));
+				const frontmatter$1 = parseFrontmatter$1(data$1, fallbackTitle);
+				frontmatterCache.set(filePath, {
+					mtime,
+					frontmatter: frontmatter$1
+				});
+				return frontmatter$1;
+			}
+			const { data } = matter(head);
+			const frontmatter = parseFrontmatter$1(data, fallbackTitle);
+			frontmatterCache.set(filePath, {
+				mtime,
+				frontmatter
+			});
+			return frontmatter;
+		} finally {
+			await handle.close();
+		}
+	}
+	return {
+		async getTree(versionId) {
+			return buildTree(getDocsPath(versionId), [], versionId);
+		},
+		async getPage(_slug) {
+			return null;
+		},
+		async getPageRaw(slug) {
+			validateSlug(slug.segments);
+			const filePath = await findMdxFile(getDocsPath(slug.versionId), slug.segments);
+			if (!filePath) return null;
+			return {
+				content: await fs.readFile(filePath, "utf-8"),
+				filePath
+			};
+		}
+	};
+}
+
+//#endregion
+//#region src/server/adapters/cached-docs.repository.ts
+/**
+* Caching decorator for DocsRepository with L1 (in-memory LRU) + L2 (CacheStore) layers.
+*
+* L1: In-process LRU cache for hot reads (60s TTL, 1s in dev)
+* L2: Shared CacheStore (e.g., Redis) for cross-instance caching
+*/
+function makeCachedDocsRepository(options) {
+	const { inner, cacheStore, logger, ttlSeconds, devMode } = options;
+	const lruCache = /* @__PURE__ */ new Map();
+	const LRU_TTL_MS = devMode ? 1e3 : 6e4;
+	const L2_TTL_MS = devMode ? 1e4 : ttlSeconds * 1e3;
+	const MAX_LRU_SIZE = 100;
+	function getFromLru(key) {
+		const entry = lruCache.get(key);
+		if (entry && entry.expires > Date.now()) {
+			lruCache.delete(key);
+			lruCache.set(key, entry);
+			logger.debug("Docs L1 cache hit", { key });
+			return entry.data;
+		}
+		lruCache.delete(key);
+	}
+	function setLru(key, data) {
+		if (lruCache.size >= MAX_LRU_SIZE) {
+			const firstKey = lruCache.keys().next().value;
+			if (firstKey) lruCache.delete(firstKey);
+		}
+		lruCache.set(key, {
+			data,
+			expires: Date.now() + LRU_TTL_MS
+		});
+	}
+	return {
+		async getTree(versionId) {
+			const key = `docs:tree:${versionId ?? "default"}`;
+			const lruHit = getFromLru(key);
+			if (lruHit) return lruHit;
+			const cached = await cacheStore.get(key);
+			if (cached) {
+				logger.debug("Docs L2 cache hit", { key });
+				setLru(key, cached);
+				return cached;
+			}
+			logger.debug("Docs cache miss, fetching tree", { key });
+			const tree = await inner.getTree(versionId);
+			await cacheStore.set(key, tree, L2_TTL_MS);
+			setLru(key, tree);
+			return tree;
+		},
+		async getPage(slug) {
+			const slugPath = slug.segments.join("/");
+			const key = `docs:page:${slug.versionId ?? "default"}:${slugPath}`;
+			const lruHit = getFromLru(key);
+			if (lruHit) return lruHit;
+			const cached = await cacheStore.get(key);
+			if (cached) {
+				logger.debug("Docs L2 cache hit", { key });
+				setLru(key, cached);
+				return cached;
+			}
+			const page = await inner.getPage(slug);
+			if (page) {
+				await cacheStore.set(key, page, L2_TTL_MS);
+				setLru(key, page);
+			}
+			return page;
+		},
+		getPageRaw: (slug) => inner.getPageRaw(slug)
+	};
+}
+
+//#endregion
+//#region src/server/adapters/fumadocs-compiler.ts
+const compiler = createCompiler({ preset: "fumadocs" });
+function makeFumadocsCompiler() {
+	return { async compile(content, filePath) {
+		const { frontmatter, content: mdxContent } = parseFrontmatter(content);
+		const result = await compiler.compile({
+			source: mdxContent,
+			filePath,
+			skipRender: true
+		});
+		const toc = result.toc.map((item) => ({
+			id: item.url.replace(/^#/, ""),
+			text: typeof item.title === "string" ? item.title : String(item.title),
+			depth: item.depth
+		}));
+		return {
+			compiled: {
+				kind: "mdx-serialized",
+				code: result.compiled,
+				scope: {}
+			},
+			toc,
+			frontmatter
+		};
+	} };
+}
+
+//#endregion
+//#region src/server/adapters/inmemory-search.adapter.ts
+function makeInMemorySearch() {
+	let entries = [];
+	return {
+		async buildIndex(pages) {
+			entries = pages.map((page) => ({
+				id: page.slug.segments.join("/"),
+				path: page.path,
+				title: page.frontmatter.title,
+				snippet: page.frontmatter.description || "",
+				headings: page.toc.map((t) => t.text),
+				tags: page.frontmatter.tags || [],
+				versionId: page.versionId
+			}));
+		},
+		async search(query, versionId, limit = 10) {
+			const lowerQuery = query.toLowerCase();
+			const results = [];
+			for (const entry of entries) {
+				if (versionId && entry.versionId !== versionId) continue;
+				const titleMatch = entry.title.toLowerCase().includes(lowerQuery);
+				const snippetMatch = entry.snippet.toLowerCase().includes(lowerQuery);
+				const headingMatch = entry.headings.some((h) => h.toLowerCase().includes(lowerQuery));
+				const tagMatch = entry.tags.some((t) => t.toLowerCase().includes(lowerQuery));
+				if (titleMatch || snippetMatch || headingMatch || tagMatch) {
+					const score = titleMatch ? 10 : headingMatch ? 5 : tagMatch ? 3 : 1;
+					results.push({
+						entry,
+						score
+					});
+				}
+				if (results.length >= limit) break;
+			}
+			return results.sort((a, b) => b.score - a.score);
+		}
+	};
+}
+
+//#endregion
+//#region src/server/usecases/get-doc-tree.ts
+const makeGetDocTree = (deps) => {
+	return async (input) => {
+		return deps.docsRepository.getTree(input.versionId);
+	};
+};
+
+//#endregion
+//#region src/server/usecases/get-doc-page.ts
+const makeGetDocPage = (deps) => {
+	return async (input) => {
+		const { docsRepository, docsCompiler } = deps;
+		const docSlug = {
+			segments: input.slug,
+			versionId: input.versionId
+		};
+		const cached = await docsRepository.getPage(docSlug);
+		if (cached) return cached;
+		const raw = await docsRepository.getPageRaw(docSlug);
+		if (!raw) return null;
+		const result = await docsCompiler.compile(raw.content, raw.filePath);
+		const parsedFrontmatter = docFrontmatterSchema.parse(result.frontmatter);
+		return {
+			slug: docSlug,
+			path: raw.filePath,
+			frontmatter: parsedFrontmatter,
+			toc: result.toc,
+			compiled: result.compiled,
+			versionId: input.versionId
+		};
+	};
+};
+
+//#endregion
+//#region src/server/usecases/search-docs.ts
+const makeSearchDocs = (deps) => {
+	return async (input) => {
+		return deps.docsSearch.search(input.query, input.versionId, input.limit);
+	};
+};
+
+//#endregion
+//#region src/server/router/docs.router.ts
+const getTreeInputSchema = z.object({ versionId: z.string().optional() });
+const getPageInputSchema = z.object({
+	slug: z.array(z.string()),
+	versionId: z.string().optional()
+});
+const searchInputSchema = z.object({
+	query: z.string(),
+	versionId: z.string().optional(),
+	limit: z.number().optional()
+});
+const docsRouter = {
+	getTree: publicProcedure.input(getTreeInputSchema).handler(async ({ input, context }) => {
+		const { getDocTree } = context.di.cradle;
+		return getDocTree({ versionId: input.versionId });
+	}),
+	getPage: publicProcedure.input(getPageInputSchema).handler(async ({ input, context }) => {
+		const { getDocPage } = context.di.cradle;
+		return getDocPage({
+			slug: input.slug,
+			versionId: input.versionId
+		});
+	}),
+	search: publicProcedure.input(searchInputSchema).handler(async ({ input, context }) => {
+		const { searchDocs } = context.di.cradle;
+		return searchDocs({
+			query: input.query,
+			versionId: input.versionId,
+			limit: input.limit
+		});
+	})
+};
+
+//#endregion
+//#region src/server/module.ts
+function collectSlugsFromTree(nodes) {
+	const result = [];
+	for (const node of nodes) {
+		result.push(node);
+		if (node.children.length > 0) result.push(...collectSlugsFromTree(node.children));
+	}
+	return result;
+}
+const kuckitModule = defineKuckitModule({
+	id: "kuckit.docs",
+	displayName: "Documentation",
+	description: "Markdown documentation with Fumadocs UI",
+	version: "0.1.0",
+	async register(ctx) {
+		const { container, config } = ctx;
+		const resolvedConfig = docsModuleConfigSchema.parse(config ?? {});
+		const filesystemDocsRepository = makeFilesystemDocsRepository({
+			docsDir: path.isAbsolute(resolvedConfig.docsDir) ? resolvedConfig.docsDir : path.resolve(process.cwd(), resolvedConfig.docsDir),
+			versions: resolvedConfig.versions
+		});
+		container.register({
+			docsCompiler: asFunction(() => makeFumadocsCompiler()).singleton(),
+			docsRepository: asFunction(({ cacheStore, logger }) => makeCachedDocsRepository({
+				inner: filesystemDocsRepository,
+				cacheStore,
+				logger,
+				ttlSeconds: resolvedConfig.cacheTtlSeconds,
+				devMode: resolvedConfig.devMode
+			})).singleton(),
+			docsSearch: asFunction(() => makeInMemorySearch()).singleton()
+		});
+		container.register({
+			getDocTree: asFunction(({ docsRepository }) => makeGetDocTree({ docsRepository })).scoped(),
+			getDocPage: asFunction(({ docsRepository, docsCompiler }) => makeGetDocPage({
+				docsRepository,
+				docsCompiler
+			})).scoped(),
+			searchDocs: asFunction(({ docsSearch }) => makeSearchDocs({ docsSearch })).scoped()
+		});
+	},
+	registerApi(ctx) {
+		ctx.addApiRegistration({
+			type: "rpc-router",
+			name: "docs",
+			router: docsRouter
+		});
+	},
+	async onBootstrap(ctx) {
+		const { container, config } = ctx;
+		const logger = container.resolve("logger");
+		const resolvedConfig = docsModuleConfigSchema.parse(config ?? {});
+		const absoluteDocsDir = path.isAbsolute(resolvedConfig.docsDir) ? resolvedConfig.docsDir : path.resolve(process.cwd(), resolvedConfig.docsDir);
+		logger.info(`Documentation module initialized. Docs dir: ${absoluteDocsDir}, cwd: ${process.cwd()}`);
+		setImmediate(async () => {
+			try {
+				const getDocTree = container.resolve("getDocTree");
+				const getDocPage = container.resolve("getDocPage");
+				const docsSearch = container.resolve("docsSearch");
+				const nodes = collectSlugsFromTree(await getDocTree());
+				const pages = [];
+				for (const node of nodes) {
+					const page = await getDocPage({
+						slug: node.slug.segments,
+						versionId: node.versionId
+					});
+					if (page && !page.frontmatter.searchHidden) pages.push(page);
+				}
+				await docsSearch.buildIndex(pages);
+				logger.info(`Search index built with ${pages.length} pages`);
+			} catch (error) {
+				logger.error("Failed to build search index", { error });
+			}
+		});
+	},
+	async onShutdown(ctx) {
+		const { container } = ctx;
+		container.resolve("logger").info("Documentation module shutting down");
+	}
+});
+
+//#endregion
+export { kuckitModule };
+//# sourceMappingURL=module.js.map

package/dist/server/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","names":["nodes: DocTreeNode[]","entries: Dirent[]","parseFrontmatter","frontmatter","data","toc: DocTocItem[]","entries: DocSearchEntry[]","results: DocSearchResult[]","docSlug: DocSlug","result: DocTreeNode[]","pages: DocPage[]"],"sources":["../../src/server/config.ts","../../src/server/domain/doc-node.ts","../../src/server/adapters/filesystem-docs.repository.ts","../../src/server/adapters/cached-docs.repository.ts","../../src/server/adapters/fumadocs-compiler.ts","../../src/server/adapters/inmemory-search.adapter.ts","../../src/server/usecases/get-doc-tree.ts","../../src/server/usecases/get-doc-page.ts","../../src/server/usecases/search-docs.ts","../../src/server/router/docs.router.ts","../../src/server/module.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport const docsVersionConfigSchema = z.object({\n\tid: z.string(),\n\tlabel: z.string(),\n\tpathSegment: z.string(),\n\tdefault: z.boolean().optional(),\n\thidden: z.boolean().optional(),\n})\n\nexport const docsModuleConfigSchema = z.object({\n\tdocsDir: z.string().default('content/docs'),\n\tbasePath: z.string().default('/docs'),\n\tenableSearch: z.boolean().default(true),\n\tcacheTtlSeconds: z.number().default(300),\n\tdevMode: z.boolean().optional(),\n\tversions: z.array(docsVersionConfigSchema).optional(),\n\tfumadocs: z\n\t\t.object({\n\t\t\ttitle: z.string().optional(),\n\t\t\tdescription: z.string().optional(),\n\t\t\tlogoSrc: z.string().optional(),\n\t\t\tprimaryColor: z.string().optional(),\n\t\t\ttocDepth: z.number().default(3),\n\t\t})\n\t\t.optional(),\n})\n\nexport type DocsVersionConfig = z.infer<typeof docsVersionConfigSchema>\nexport type DocsModuleConfig = z.infer<typeof docsModuleConfigSchema>\n","import { z } from 'zod'\n\nexport const docSlugSchema = z.object({\n\tsegments: z.array(z.string()),\n\tversionId: z.string().optional(),\n})\n\nexport type DocSlug = z.infer<typeof docSlugSchema>\n\nexport interface DocFrontmatter {\n\treadonly title: string\n\treadonly description?: string\n\treadonly order?: number\n\treadonly group?: string\n\treadonly icon?: string\n\treadonly tags?: readonly string[]\n\treadonly sidebarHidden?: boolean\n\treadonly searchHidden?: boolean\n}\n\nexport const docFrontmatterSchema = z.object({\n\ttitle: z.string(),\n\tdescription: z.string().optional(),\n\torder: z.number().optional(),\n\tgroup: z.string().optional(),\n\ticon: z.string().optional(),\n\tsidebarHidden: z.boolean().optional(),\n\tsearchHidden: z.boolean().optional(),\n\ttags: z.array(z.string()).optional(),\n})\n\nexport interface DocTocItem {\n\treadonly id: string\n\treadonly depth: number\n\treadonly text: string\n}\n\nexport const docTocItemSchema = z.object({\n\tid: z.string(),\n\ttext: z.string(),\n\tdepth: z.number(),\n})\n\nexport interface DocTreeNode {\n\treadonly slug: DocSlug\n\treadonly path: string\n\treadonly title: string\n\treadonly group?: string\n\treadonly icon?: string\n\treadonly order: number\n\treadonly children: readonly DocTreeNode[]\n\treadonly isIndex: boolean\n\treadonly versionId?: string\n}\n\nexport interface CompiledMdxPayload {\n\treadonly kind: 'mdx-serialized'\n\treadonly code: string\n\treadonly scope: Record<string, unknown>\n}\n\nexport interface DocPage {\n\treadonly slug: DocSlug\n\treadonly path: string\n\treadonly frontmatter: DocFrontmatter\n\treadonly toc: readonly DocTocItem[]\n\treadonly compiled: CompiledMdxPayload\n\treadonly lastModified?: string\n\treadonly versionId?: string\n}\n","import * as fs from 'node:fs/promises'\nimport type { Dirent } from 'node:fs'\nimport * as path from 'node:path'\nimport matter from 'gray-matter'\nimport type { DocsRepository } from '../ports/docs-repository'\nimport type { DocTreeNode, DocPage, DocSlug, DocFrontmatter } from '../domain/doc-node'\nimport { docFrontmatterSchema } from '../domain/doc-node'\n\nexport interface FilesystemDocsRepositoryOptions {\n\tdocsDir: string\n\tversions?: { id: string; pathSegment: string }[]\n}\n\ninterface FrontmatterCacheEntry {\n\tmtime: number\n\tfrontmatter: DocFrontmatter\n}\n\nconst FRONTMATTER_HEAD_BYTES = 2048\n\nexport function makeFilesystemDocsRepository(\n\toptions: FilesystemDocsRepositoryOptions\n): DocsRepository {\n\tconst { docsDir, versions } = options\n\n\tconst frontmatterCache = new Map<string, FrontmatterCacheEntry>()\n\n\tfunction validateSlug(slug: string[]): void {\n\t\tif (slug.some((segment) => segment === '..' || segment === '' || segment.startsWith('/'))) {\n\t\t\tthrow new Error('Invalid slug: path traversal detected')\n\t\t}\n\t}\n\n\tfunction getDocsPath(versionId?: string): string {\n\t\tif (versionId && versions) {\n\t\t\tconst version = versions.find((v) => v.id === versionId)\n\t\t\tif (version) {\n\t\t\t\treturn path.join(docsDir, version.pathSegment)\n\t\t\t}\n\t\t}\n\t\treturn docsDir\n\t}\n\n\tasync function findMdxFile(basePath: string, slug: string[]): Promise<string | null> {\n\t\tconst slugPath = slug.join('/')\n\n\t\tconst candidates = [\n\t\t\tpath.join(basePath, `${slugPath}.mdx`),\n\t\t\tpath.join(basePath, `${slugPath}.md`),\n\t\t\tpath.join(basePath, slugPath, 'index.mdx'),\n\t\t\tpath.join(basePath, slugPath, 'index.md'),\n\t\t]\n\n\t\tif (slug.length === 0) {\n\t\t\tcandidates.unshift(path.join(basePath, 'index.mdx'), path.join(basePath, 'index.md'))\n\t\t}\n\n\t\tfor (const candidate of candidates) {\n\t\t\ttry {\n\t\t\t\tconst resolved = path.resolve(candidate)\n\t\t\t\tif (!resolved.startsWith(path.resolve(docsDir))) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tawait fs.access(resolved)\n\t\t\t\treturn resolved\n\t\t\t} catch {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t}\n\n\t\treturn null\n\t}\n\n\tasync function buildTree(\n\t\tdir: string,\n\t\tparentSlug: string[] = [],\n\t\tversionId?: string\n\t): Promise<DocTreeNode[]> {\n\t\tconst nodes: DocTreeNode[] = []\n\n\t\tlet entries: Dirent[]\n\t\ttry {\n\t\t\tentries = await fs.readdir(dir, { withFileTypes: true })\n\t\t} catch {\n\t\t\treturn []\n\t\t}\n\n\t\tfor (const entry of entries) {\n\t\t\tconst entryName = entry.name as string\n\t\t\tconst fullPath = path.join(dir, entryName)\n\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tconst childSlug = [...parentSlug, entryName]\n\t\t\t\tconst children = await buildTree(fullPath, childSlug, versionId)\n\n\t\t\t\tconst indexFile = await findMdxFile(fullPath, [])\n\t\t\t\tif (indexFile) {\n\t\t\t\t\tconst frontmatter = await extractFrontmatterCached(indexFile, entryName)\n\n\t\t\t\t\tif (!frontmatter.sidebarHidden) {\n\t\t\t\t\t\tnodes.push({\n\t\t\t\t\t\t\tslug: { segments: childSlug, versionId },\n\t\t\t\t\t\t\tpath: `/${childSlug.join('/')}`,\n\t\t\t\t\t\t\ttitle: frontmatter.title,\n\t\t\t\t\t\t\tgroup: frontmatter.group,\n\t\t\t\t\t\t\ticon: frontmatter.icon,\n\t\t\t\t\t\t\torder: frontmatter.order ?? 999,\n\t\t\t\t\t\t\tchildren,\n\t\t\t\t\t\t\tisIndex: true,\n\t\t\t\t\t\t\tversionId,\n\t\t\t\t\t\t})\n\t\t\t\t\t}\n\t\t\t\t} else if (children.length > 0) {\n\t\t\t\t\tnodes.push({\n\t\t\t\t\t\tslug: { segments: childSlug, versionId },\n\t\t\t\t\t\tpath: `/${childSlug.join('/')}`,\n\t\t\t\t\t\ttitle: formatTitle(entryName),\n\t\t\t\t\t\torder: 999,\n\t\t\t\t\t\tchildren,\n\t\t\t\t\t\tisIndex: false,\n\t\t\t\t\t\tversionId,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t} else if (entry.isFile() && /\\.(mdx?|md)$/.test(entryName)) {\n\t\t\t\tconst baseName = entryName.replace(/\\.(mdx?|md)$/, '')\n\t\t\t\tif (baseName === 'index') continue\n\n\t\t\t\tconst frontmatter = await extractFrontmatterCached(fullPath, baseName)\n\n\t\t\t\tif (!frontmatter.sidebarHidden) {\n\t\t\t\t\tconst childSlug = [...parentSlug, baseName]\n\t\t\t\t\tnodes.push({\n\t\t\t\t\t\tslug: { segments: childSlug, versionId },\n\t\t\t\t\t\tpath: `/${childSlug.join('/')}`,\n\t\t\t\t\t\ttitle: frontmatter.title,\n\t\t\t\t\t\tgroup: frontmatter.group,\n\t\t\t\t\t\ticon: frontmatter.icon,\n\t\t\t\t\t\torder: frontmatter.order ?? 999,\n\t\t\t\t\t\tchildren: [],\n\t\t\t\t\t\tisIndex: false,\n\t\t\t\t\t\tversionId,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn nodes.sort((a, b) => a.order - b.order)\n\t}\n\n\tfunction parseFrontmatter(data: Record<string, unknown>, fallbackTitle: string): DocFrontmatter {\n\t\tconst result = docFrontmatterSchema.safeParse({\n\t\t\ttitle: fallbackTitle,\n\t\t\t...data,\n\t\t})\n\t\tif (result.success) {\n\t\t\treturn result.data as DocFrontmatter\n\t\t}\n\t\treturn { title: formatTitle(fallbackTitle) }\n\t}\n\n\tfunction formatTitle(slug: string): string {\n\t\treturn slug.replace(/[-_]/g, ' ').replace(/\\b\\w/g, (c) => c.toUpperCase())\n\t}\n\n\tasync function extractFrontmatterCached(\n\t\tfilePath: string,\n\t\tfallbackTitle: string\n\t): Promise<DocFrontmatter> {\n\t\tconst stat = await fs.stat(filePath)\n\t\tconst mtime = stat.mtimeMs\n\t\tconst cached = frontmatterCache.get(filePath)\n\n\t\tif (cached && cached.mtime === mtime) {\n\t\t\treturn cached.frontmatter\n\t\t}\n\n\t\tconst handle = await fs.open(filePath, 'r')\n\t\ttry {\n\t\t\tconst buffer = Buffer.alloc(FRONTMATTER_HEAD_BYTES)\n\t\t\tconst { bytesRead } = await handle.read(buffer, 0, FRONTMATTER_HEAD_BYTES, 0)\n\t\t\tconst head = buffer.subarray(0, bytesRead).toString('utf-8')\n\n\t\t\tif (!head.startsWith('---')) {\n\t\t\t\tconst frontmatter = { title: formatTitle(fallbackTitle) }\n\t\t\t\tfrontmatterCache.set(filePath, { mtime, frontmatter })\n\t\t\t\treturn frontmatter\n\t\t\t}\n\n\t\t\tconst endMatch = head.slice(3).match(/\\r?\\n---/)\n\t\t\tif (!endMatch) {\n\t\t\t\tconst fullContent = await fs.readFile(filePath, 'utf-8')\n\t\t\t\tconst { data } = matter(fullContent)\n\t\t\t\tconst frontmatter = parseFrontmatter(data, fallbackTitle)\n\t\t\t\tfrontmatterCache.set(filePath, { mtime, frontmatter })\n\t\t\t\treturn frontmatter\n\t\t\t}\n\n\t\t\tconst { data } = matter(head)\n\t\t\tconst frontmatter = parseFrontmatter(data, fallbackTitle)\n\t\t\tfrontmatterCache.set(filePath, { mtime, frontmatter })\n\t\t\treturn frontmatter\n\t\t} finally {\n\t\t\tawait handle.close()\n\t\t}\n\t}\n\n\treturn {\n\t\tasync getTree(versionId?: string): Promise<DocTreeNode[]> {\n\t\t\tconst basePath = getDocsPath(versionId)\n\t\t\treturn buildTree(basePath, [], versionId)\n\t\t},\n\n\t\tasync getPage(_slug: DocSlug): Promise<DocPage | null> {\n\t\t\treturn null\n\t\t},\n\n\t\tasync getPageRaw(slug: DocSlug): Promise<{ content: string; filePath: string } | null> {\n\t\t\tvalidateSlug(slug.segments)\n\t\t\tconst basePath = getDocsPath(slug.versionId)\n\t\t\tconst filePath = await findMdxFile(basePath, slug.segments)\n\n\t\t\tif (!filePath) {\n\t\t\t\treturn null\n\t\t\t}\n\n\t\t\tconst content = await fs.readFile(filePath, 'utf-8')\n\t\t\treturn { content, filePath }\n\t\t},\n\t}\n}\n","import type { CacheStore, Logger } from '@kuckit/domain'\nimport type { DocsRepository } from '../ports/docs-repository'\nimport type { DocTreeNode, DocPage, DocSlug } from '../domain/doc-node'\n\nexport interface CachedDocsRepositoryOptions {\n\treadonly inner: DocsRepository\n\treadonly cacheStore: CacheStore\n\treadonly logger: Logger\n\treadonly ttlSeconds: number\n\treadonly devMode?: boolean\n}\n\ninterface LruEntry<T> {\n\tdata: T\n\texpires: number\n}\n\n/**\n * Caching decorator for DocsRepository with L1 (in-memory LRU) + L2 (CacheStore) layers.\n *\n * L1: In-process LRU cache for hot reads (60s TTL, 1s in dev)\n * L2: Shared CacheStore (e.g., Redis) for cross-instance caching\n */\nexport function makeCachedDocsRepository(options: CachedDocsRepositoryOptions): DocsRepository {\n\tconst { inner, cacheStore, logger, ttlSeconds, devMode } = options\n\n\tconst lruCache = new Map<string, LruEntry<unknown>>()\n\tconst LRU_TTL_MS = devMode ? 1_000 : 60_000\n\tconst L2_TTL_MS = devMode ? 10_000 : ttlSeconds * 1000\n\tconst MAX_LRU_SIZE = 100\n\n\tfunction getFromLru<T>(key: string): T | undefined {\n\t\tconst entry = lruCache.get(key)\n\t\tif (entry && entry.expires > Date.now()) {\n\t\t\t// Move to end of iteration order (LRU behavior)\n\t\t\tlruCache.delete(key)\n\t\t\tlruCache.set(key, entry)\n\t\t\tlogger.debug('Docs L1 cache hit', { key })\n\t\t\treturn entry.data as T\n\t\t}\n\t\tlruCache.delete(key)\n\t\treturn undefined\n\t}\n\n\tfunction setLru<T>(key: string, data: T): void {\n\t\tif (lruCache.size >= MAX_LRU_SIZE) {\n\t\t\tconst firstKey = lruCache.keys().next().value\n\t\t\tif (firstKey) lruCache.delete(firstKey)\n\t\t}\n\t\tlruCache.set(key, { data, expires: Date.now() + LRU_TTL_MS })\n\t}\n\n\treturn {\n\t\tasync getTree(versionId?: string): Promise<DocTreeNode[]> {\n\t\t\tconst key = `docs:tree:${versionId ?? 'default'}`\n\n\t\t\tconst lruHit = getFromLru<DocTreeNode[]>(key)\n\t\t\tif (lruHit) return lruHit\n\n\t\t\tconst cached = await cacheStore.get<DocTreeNode[]>(key)\n\t\t\tif (cached) {\n\t\t\t\tlogger.debug('Docs L2 cache hit', { key })\n\t\t\t\tsetLru(key, cached)\n\t\t\t\treturn cached\n\t\t\t}\n\n\t\t\tlogger.debug('Docs cache miss, fetching tree', { key })\n\t\t\tconst tree = await inner.getTree(versionId)\n\t\t\tawait cacheStore.set(key, tree, L2_TTL_MS)\n\t\t\tsetLru(key, tree)\n\t\t\treturn tree\n\t\t},\n\n\t\tasync getPage(slug: DocSlug): Promise<DocPage | null> {\n\t\t\tconst slugPath = slug.segments.join('/')\n\t\t\tconst key = `docs:page:${slug.versionId ?? 'default'}:${slugPath}`\n\n\t\t\tconst lruHit = getFromLru<DocPage>(key)\n\t\t\tif (lruHit) return lruHit\n\n\t\t\tconst cached = await cacheStore.get<DocPage>(key)\n\t\t\tif (cached) {\n\t\t\t\tlogger.debug('Docs L2 cache hit', { key })\n\t\t\t\tsetLru(key, cached)\n\t\t\t\treturn cached\n\t\t\t}\n\n\t\t\tconst page = await inner.getPage(slug)\n\t\t\tif (page) {\n\t\t\t\tawait cacheStore.set(key, page, L2_TTL_MS)\n\t\t\t\tsetLru(key, page)\n\t\t\t}\n\t\t\treturn page\n\t\t},\n\n\t\tgetPageRaw: (slug) => inner.getPageRaw(slug),\n\t}\n}\n","import { createCompiler, parseFrontmatter } from '@fumadocs/mdx-remote'\nimport type { DocsCompiler, CompileResult } from '../ports/docs-compiler'\nimport type { DocTocItem } from '../domain/doc-node'\n\nconst compiler = createCompiler({\n\tpreset: 'fumadocs',\n})\n\nexport function makeFumadocsCompiler(): DocsCompiler {\n\treturn {\n\t\tasync compile(content: string, filePath: string): Promise<CompileResult> {\n\t\t\tconst { frontmatter, content: mdxContent } = parseFrontmatter(content)\n\n\t\t\tconst result = await compiler.compile({\n\t\t\t\tsource: mdxContent,\n\t\t\t\tfilePath,\n\t\t\t\tskipRender: true,\n\t\t\t})\n\n\t\t\tconst toc: DocTocItem[] = result.toc.map((item) => ({\n\t\t\t\tid: item.url.replace(/^#/, ''),\n\t\t\t\ttext: typeof item.title === 'string' ? item.title : String(item.title),\n\t\t\t\tdepth: item.depth,\n\t\t\t}))\n\n\t\t\treturn {\n\t\t\t\tcompiled: {\n\t\t\t\t\tkind: 'mdx-serialized',\n\t\t\t\t\tcode: result.compiled,\n\t\t\t\t\tscope: {},\n\t\t\t\t},\n\t\t\t\ttoc,\n\t\t\t\tfrontmatter,\n\t\t\t}\n\t\t},\n\t}\n}\n","import type { DocsSearch } from '../ports/docs-search'\nimport type { DocPage } from '../domain/doc-node'\nimport type { DocSearchEntry, DocSearchResult } from '../domain/search-entry'\n\nexport function makeInMemorySearch(): DocsSearch {\n\tlet entries: DocSearchEntry[] = []\n\n\treturn {\n\t\tasync buildIndex(pages: DocPage[]): Promise<void> {\n\t\t\tentries = pages.map((page) => ({\n\t\t\t\tid: page.slug.segments.join('/'),\n\t\t\t\tpath: page.path,\n\t\t\t\ttitle: page.frontmatter.title,\n\t\t\t\tsnippet: page.frontmatter.description || '',\n\t\t\t\theadings: page.toc.map((t) => t.text),\n\t\t\t\ttags: page.frontmatter.tags || [],\n\t\t\t\tversionId: page.versionId,\n\t\t\t}))\n\t\t},\n\n\t\tasync search(query: string, versionId?: string, limit = 10): Promise<DocSearchResult[]> {\n\t\t\tconst lowerQuery = query.toLowerCase()\n\t\t\tconst results: DocSearchResult[] = []\n\n\t\t\tfor (const entry of entries) {\n\t\t\t\tif (versionId && entry.versionId !== versionId) continue\n\n\t\t\t\tconst titleMatch = entry.title.toLowerCase().includes(lowerQuery)\n\t\t\t\tconst snippetMatch = entry.snippet.toLowerCase().includes(lowerQuery)\n\t\t\t\tconst headingMatch = entry.headings.some((h) => h.toLowerCase().includes(lowerQuery))\n\t\t\t\tconst tagMatch = entry.tags.some((t) => t.toLowerCase().includes(lowerQuery))\n\n\t\t\t\tif (titleMatch || snippetMatch || headingMatch || tagMatch) {\n\t\t\t\t\tconst score = titleMatch ? 10 : headingMatch ? 5 : tagMatch ? 3 : 1\n\t\t\t\t\tresults.push({ entry, score })\n\t\t\t\t}\n\n\t\t\t\tif (results.length >= limit) break\n\t\t\t}\n\n\t\t\treturn results.sort((a, b) => b.score - a.score)\n\t\t},\n\t}\n}\n","import type { DocsRepository } from '../ports/docs-repository'\nimport type { DocTreeNode } from '../domain/doc-node'\n\nexport interface GetDocTreeDeps {\n\treadonly docsRepository: DocsRepository\n}\n\nexport interface GetDocTreeInput {\n\treadonly versionId?: string\n}\n\nexport type GetDocTreeOutput = DocTreeNode[]\n\nexport const makeGetDocTree = (deps: GetDocTreeDeps) => {\n\treturn async (input: GetDocTreeInput): Promise<GetDocTreeOutput> => {\n\t\treturn deps.docsRepository.getTree(input.versionId)\n\t}\n}\n","import type { DocsRepository } from '../ports/docs-repository'\nimport type { DocsCompiler } from '../ports/docs-compiler'\nimport type { DocPage, DocSlug, DocFrontmatter } from '../domain/doc-node'\nimport { docFrontmatterSchema } from '../domain/doc-node'\n\nexport interface GetDocPageDeps {\n\treadonly docsRepository: DocsRepository\n\treadonly docsCompiler: DocsCompiler\n}\n\nexport interface GetDocPageInput {\n\treadonly slug: string[]\n\treadonly versionId?: string\n}\n\nexport type GetDocPageOutput = DocPage | null\n\nexport const makeGetDocPage = (deps: GetDocPageDeps) => {\n\treturn async (input: GetDocPageInput): Promise<GetDocPageOutput> => {\n\t\tconst { docsRepository, docsCompiler } = deps\n\n\t\tconst docSlug: DocSlug = {\n\t\t\tsegments: input.slug,\n\t\t\tversionId: input.versionId,\n\t\t}\n\n\t\tconst cached = await docsRepository.getPage(docSlug)\n\t\tif (cached) {\n\t\t\treturn cached\n\t\t}\n\n\t\tconst raw = await docsRepository.getPageRaw(docSlug)\n\t\tif (!raw) {\n\t\t\treturn null\n\t\t}\n\n\t\tconst result = await docsCompiler.compile(raw.content, raw.filePath)\n\t\tconst parsedFrontmatter = docFrontmatterSchema.parse(result.frontmatter)\n\n\t\treturn {\n\t\t\tslug: docSlug,\n\t\t\tpath: raw.filePath,\n\t\t\tfrontmatter: parsedFrontmatter as DocFrontmatter,\n\t\t\ttoc: result.toc,\n\t\t\tcompiled: result.compiled,\n\t\t\tversionId: input.versionId,\n\t\t}\n\t}\n}\n","import type { DocsSearch } from '../ports/docs-search'\nimport type { DocSearchResult } from '../domain/search-entry'\n\nexport interface SearchDocsDeps {\n\treadonly docsSearch: DocsSearch\n}\n\nexport interface SearchDocsInput {\n\treadonly query: string\n\treadonly versionId?: string\n\treadonly limit?: number\n}\n\nexport type SearchDocsOutput = DocSearchResult[]\n\nexport const makeSearchDocs = (deps: SearchDocsDeps) => {\n\treturn async (input: SearchDocsInput): Promise<SearchDocsOutput> => {\n\t\treturn deps.docsSearch.search(input.query, input.versionId, input.limit)\n\t}\n}\n","import { publicProcedure } from '@kuckit/api'\nimport { z } from 'zod'\nimport type { GetDocTreeInput, GetDocTreeOutput } from '../usecases/get-doc-tree'\nimport type { GetDocPageInput, GetDocPageOutput } from '../usecases/get-doc-page'\nimport type { SearchDocsInput, SearchDocsOutput } from '../usecases/search-docs'\n\nconst getTreeInputSchema = z.object({\n\tversionId: z.string().optional(),\n})\n\nconst getPageInputSchema = z.object({\n\tslug: z.array(z.string()),\n\tversionId: z.string().optional(),\n})\n\nconst searchInputSchema = z.object({\n\tquery: z.string(),\n\tversionId: z.string().optional(),\n\tlimit: z.number().optional(),\n})\n\ninterface DocsCradle {\n\tgetDocTree: (input: GetDocTreeInput) => Promise<GetDocTreeOutput>\n\tgetDocPage: (input: GetDocPageInput) => Promise<GetDocPageOutput>\n\tsearchDocs: (input: SearchDocsInput) => Promise<SearchDocsOutput>\n}\n\nexport const docsRouter = {\n\tgetTree: publicProcedure.input(getTreeInputSchema).handler(async ({ input, context }) => {\n\t\tconst { getDocTree } = context.di.cradle as DocsCradle\n\t\treturn getDocTree({ versionId: input.versionId })\n\t}),\n\n\tgetPage: publicProcedure.input(getPageInputSchema).handler(async ({ input, context }) => {\n\t\tconst { getDocPage } = context.di.cradle as DocsCradle\n\t\treturn getDocPage({ slug: input.slug, versionId: input.versionId })\n\t}),\n\n\tsearch: publicProcedure.input(searchInputSchema).handler(async ({ input, context }) => {\n\t\tconst { searchDocs } = context.di.cradle as DocsCradle\n\t\treturn searchDocs({ query: input.query, versionId: input.versionId, limit: input.limit })\n\t}),\n}\n","import * as path from 'node:path'\nimport { defineKuckitModule, asFunction, type KuckitModuleContext } from '@kuckit/sdk'\nimport { docsModuleConfigSchema, type DocsModuleConfig } from './config'\nimport { makeFilesystemDocsRepository } from './adapters/filesystem-docs.repository'\nimport { makeCachedDocsRepository } from './adapters/cached-docs.repository'\nimport { makeFumadocsCompiler } from './adapters/fumadocs-compiler'\nimport { makeInMemorySearch } from './adapters/inmemory-search.adapter'\nimport { makeGetDocTree } from './usecases/get-doc-tree'\nimport { makeGetDocPage } from './usecases/get-doc-page'\nimport { makeSearchDocs } from './usecases/search-docs'\nimport { docsRouter } from './router/docs.router'\nimport type { DocTreeNode, DocPage } from './domain/doc-node'\n\nexport type { DocsModuleConfig }\n\nfunction collectSlugsFromTree(nodes: readonly DocTreeNode[]): DocTreeNode[] {\n\tconst result: DocTreeNode[] = []\n\tfor (const node of nodes) {\n\t\tresult.push(node)\n\t\tif (node.children.length > 0) {\n\t\t\tresult.push(...collectSlugsFromTree(node.children))\n\t\t}\n\t}\n\treturn result\n}\n\nexport const kuckitModule = defineKuckitModule<DocsModuleConfig>({\n\tid: 'kuckit.docs',\n\tdisplayName: 'Documentation',\n\tdescription: 'Markdown documentation with Fumadocs UI',\n\tversion: '0.1.0',\n\n\tasync register(ctx: KuckitModuleContext<DocsModuleConfig>) {\n\t\tconst { container, config } = ctx\n\t\tconst resolvedConfig = docsModuleConfigSchema.parse(config ?? {})\n\n\t\tconst absoluteDocsDir = path.isAbsolute(resolvedConfig.docsDir)\n\t\t\t? resolvedConfig.docsDir\n\t\t\t: path.resolve(process.cwd(), resolvedConfig.docsDir)\n\n\t\tconst filesystemDocsRepository = makeFilesystemDocsRepository({\n\t\t\tdocsDir: absoluteDocsDir,\n\t\t\tversions: resolvedConfig.versions,\n\t\t})\n\n\t\tcontainer.register({\n\t\t\tdocsCompiler: asFunction(() => makeFumadocsCompiler()).singleton(),\n\n\t\t\tdocsRepository: asFunction(({ cacheStore, logger }) =>\n\t\t\t\tmakeCachedDocsRepository({\n\t\t\t\t\tinner: filesystemDocsRepository,\n\t\t\t\t\tcacheStore,\n\t\t\t\t\tlogger,\n\t\t\t\t\tttlSeconds: resolvedConfig.cacheTtlSeconds,\n\t\t\t\t\tdevMode: resolvedConfig.devMode,\n\t\t\t\t})\n\t\t\t).singleton(),\n\n\t\t\tdocsSearch: asFunction(() => makeInMemorySearch()).singleton(),\n\t\t})\n\n\t\tcontainer.register({\n\t\t\tgetDocTree: asFunction(({ docsRepository }) => makeGetDocTree({ docsRepository })).scoped(),\n\n\t\t\tgetDocPage: asFunction(({ docsRepository, docsCompiler }) =>\n\t\t\t\tmakeGetDocPage({ docsRepository, docsCompiler })\n\t\t\t).scoped(),\n\n\t\t\tsearchDocs: asFunction(({ docsSearch }) => makeSearchDocs({ docsSearch })).scoped(),\n\t\t})\n\t},\n\n\tregisterApi(ctx) {\n\t\tctx.addApiRegistration({\n\t\t\ttype: 'rpc-router',\n\t\t\tname: 'docs',\n\t\t\trouter: docsRouter,\n\t\t})\n\t},\n\n\tasync onBootstrap(ctx: KuckitModuleContext<DocsModuleConfig>) {\n\t\tconst { container, config } = ctx\n\t\tconst logger = container.resolve('logger')\n\t\tconst resolvedConfig = docsModuleConfigSchema.parse(config ?? {})\n\t\tconst absoluteDocsDir = path.isAbsolute(resolvedConfig.docsDir)\n\t\t\t? resolvedConfig.docsDir\n\t\t\t: path.resolve(process.cwd(), resolvedConfig.docsDir)\n\t\tlogger.info(\n\t\t\t`Documentation module initialized. Docs dir: ${absoluteDocsDir}, cwd: ${process.cwd()}`\n\t\t)\n\n\t\t// Build search index in background to not block startup\n\t\tsetImmediate(async () => {\n\t\t\ttry {\n\t\t\t\tconst getDocTree = container.resolve('getDocTree')\n\t\t\t\tconst getDocPage = container.resolve('getDocPage')\n\t\t\t\tconst docsSearch = container.resolve('docsSearch')\n\n\t\t\t\tconst tree = await getDocTree()\n\t\t\t\tconst nodes = collectSlugsFromTree(tree)\n\n\t\t\t\tconst pages: DocPage[] = []\n\t\t\t\tfor (const node of nodes) {\n\t\t\t\t\tconst page = await getDocPage({ slug: node.slug.segments, versionId: node.versionId })\n\t\t\t\t\tif (page && !page.frontmatter.searchHidden) {\n\t\t\t\t\t\tpages.push(page)\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tawait docsSearch.buildIndex(pages)\n\t\t\t\tlogger.info(`Search index built with ${pages.length} pages`)\n\t\t\t} catch (error) {\n\t\t\t\tlogger.error('Failed to build search index', { error })\n\t\t\t}\n\t\t})\n\t},\n\n\tasync onShutdown(ctx: KuckitModuleContext<DocsModuleConfig>) {\n\t\tconst { container } = ctx\n\t\tconst logger = container.resolve('logger')\n\t\tlogger.info('Documentation module shutting down')\n\t},\n})\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "@kuckit/docs-module",
+	"version": "0.1.1",
+	"description": "Documentation module for Kuckit using Fumadocs",
+	"type": "module",
+	"main": "dist/server/module.js",
+	"types": "dist/server/module.d.ts",
+	"files": [
+		"dist"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/server/module.d.ts",
+			"default": "./dist/server/module.js"
+		},
+		"./client": {
+			"types": "./dist/client/index.d.ts",
+			"default": "./dist/client/index.js"
+		}
+	},
+	"kuckit": {
+		"id": "kuckit.docs",
+		"server": ".",
+		"client": "./client"
+	},
+	"scripts": {
+		"build": "tsdown",
+		"prepublishOnly": "npm run build && node ../../scripts/resolve-workspace-protocols.cjs && node ../../scripts/check-no-workspace-protocol.cjs"
+	},
+	"peerDependencies": {
+		"@kuckit/sdk": "^2.0.1",
+		"@kuckit/sdk-react": "^2.0.1",
+		"@tanstack/react-router": "^1",
+		"react": "^18 || ^19",
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"@kuckit/api": "^2.0.1",
+		"@kuckit/domain": "^2.0.1",
+		"@fumadocs/mdx-remote": "^1.3.0",
+		"fumadocs-core": "^15.3.1",
+		"fumadocs-ui": "^15.3.1",
+		"gray-matter": "^4.0.3",
+		"lucide-react": "^0.379.0",
+		"zod": "^4.1.11"
+	},
+	"devDependencies": {
+		"@types/react": "^19.0.0",
+		"tsdown": "catalog:"
+	}
+}