@fumadocs/cli 1.7.1 → 1.7.2

package/dist/ai-wXWLPFI5.js

@@ -0,0 +1,112 @@
+import { t as docs } from "./docs--WqEHTyl.js";
+import { r as findSource } from "./utils-DbMe7h6c.js";
+import path from "node:path";
+//#region src/features/ai.ts
+const providers = {
+	openrouter: {
+		label: "AI SDK",
+		hint: "default to OpenRouter",
+		env: "OPENROUTER_API_KEY"
+	},
+	llmgateway: {
+		label: "LLMGateway",
+		hint: "open-source LLM gateway, API key required",
+		env: "LLM_GATEWAY_API_KEY"
+	},
+	inkeep: {
+		label: "Inkeep AI",
+		hint: "API key required",
+		env: "INKEEP_API_KEY"
+	}
+};
+const ai = {
+	id: "ai",
+	title: "AI Chat",
+	description: "Ask AI dialog for your docs",
+	requires: [docs],
+	options: { provider: {
+		message: "Choose an AI provider",
+		choices: Object.entries(providers).map(([value, { label, hint }]) => ({
+			value,
+			label,
+			hint
+		}))
+	} },
+	supports: (project) => project.static ? "AI chat requires a server to run the chat route handler." : true,
+	async apply(ctx, { provider }) {
+		await ctx.install(`ai/${provider}`);
+		ctx.env(providers[provider].env, "");
+		if (ctx.project.source.dynamic) await readDynamicSource(ctx);
+		const { cwd, baseDir, info, config } = ctx.project;
+		const clientLayoutImport = `@/${path.posix.join(config.aliases.componentsDir, "ai/layout")}`;
+		const layout = await findSource(cwd, path.join(baseDir, info.routesDir), "<DocsLayout");
+		let layoutModule;
+		let wired = false;
+		if (layout !== void 0) await ctx.source(layout, (file) => {
+			wired = file.code.includes(`'${clientLayoutImport}'`);
+			const declaration = !wired && file.program.body.find((node) => node.type === "ImportDeclaration" && node.importKind !== "type" && /^fumadocs-ui\/layouts\/(docs|notebook|glass|spacious)$/.test(node.source.value) && node.specifiers.length === 1 && node.specifiers[0].local.name === "DocsLayout");
+			if (!declaration) return;
+			layoutModule = declaration.source.value;
+			file.s.overwrite(declaration.source.start, declaration.source.end, `'${clientLayoutImport}'`);
+		});
+		if (layoutModule) await ctx.write(path.join(baseDir, config.aliases.componentsDir, "ai/layout.tsx"), clientLayout(layoutModule));
+		else if (!wired) ctx.note("Pass the AI chat to your docs layout, see https://fumadocs.dev/docs/integrations/llms#ask-ai.");
+		ctx.note(`Set ${providers[provider].env} in \`.env.local\`.`);
+	}
+};
+const floatingTrigger = `
+      <AISearchTrigger
+        position="float"
+        className={buttonVariants({
+          variant: 'secondary',
+          className: 'text-fd-muted-foreground rounded-2xl',
+        })}
+      >
+        <MessageCircleIcon className="size-4.5" />
+        Ask AI
+      </AISearchTrigger>`;
+/** a client component rendering the docs layout with the installed chat */
+function clientLayout(layoutModule) {
+	const trigger = /\/(docs|notebook)$/.test(layoutModule);
+	return `'use client';
+import { DocsLayout as Layout, type DocsLayoutProps } from '${layoutModule}';
+${trigger ? `import { buttonVariants } from 'fumadocs-ui/components/ui/button';
+import { MessageCircleIcon } from 'lucide-react';
+` : ""}import {
+  AISearch,
+  AISearchPanel,${trigger ? "\n  AISearchTrigger," : ""}
+  useAISearchContext,
+  useHotKey,
+} from './search';
+
+export function DocsLayout(props: DocsLayoutProps) {
+  return (
+    <AISearch>
+      <ChatLayout {...props} />${trigger ? floatingTrigger : ""}
+    </AISearch>
+  );
+}
+
+function ChatLayout(props: DocsLayoutProps) {
+  const { open, setOpen } = useAISearchContext();
+  useHotKey();
+
+  return <Layout {...props} aiChat={{ open, onOpenChange: setOpen, panel: <AISearchPanel /> }} />;
+}
+`;
+}
+/** the installed chat route indexes pages of a static `source`, runtime sources resolve on demand */
+async function readDynamicSource(ctx) {
+	const { cwd, baseDir } = ctx.project;
+	const route = await findSource(cwd, baseDir, "createSearchServer");
+	if (!(route !== void 0 && await ctx.source(route, (file) => {
+		file.s.replaceAll("import { source } from '@/lib/source';", "import { getSource } from '@/lib/source';");
+		file.s.replaceAll("source.getPages()", "(await getSource()).getPages()");
+		file.s.replaceAll("      if (!('getText' in page.data)) return null;\n\n", "");
+		file.s.replaceAll("await page.data.getText('processed')", "page.data.content");
+	}))) ctx.note("Read pages from `getSource()` in the chat route, the search index is built from `page.data.content`.");
+}
+//#endregion
+export { ai as t };
+
+//# sourceMappingURL=ai-wXWLPFI5.js.map

package/dist/ai-wXWLPFI5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-wXWLPFI5.js","names":[],"sources":["../src/features/ai.ts"],"sourcesContent":["import path from 'node:path';\nimport type { ImportDeclaration } from 'oxc-parser';\nimport type { Feature, FeatureContext } from '@/features';\nimport { findSource } from './utils';\nimport { docs } from './docs';\n\nconst providers = {\n  openrouter: { label: 'AI SDK', hint: 'default to OpenRouter', env: 'OPENROUTER_API_KEY' },\n  llmgateway: {\n    label: 'LLMGateway',\n    hint: 'open-source LLM gateway, API key required',\n    env: 'LLM_GATEWAY_API_KEY',\n  },\n  inkeep: { label: 'Inkeep AI', hint: 'API key required', env: 'INKEEP_API_KEY' },\n};\n\nexport type AIProvider = keyof typeof providers;\n\nexport const ai: Feature<{ provider: AIProvider }> = {\n  id: 'ai',\n  title: 'AI Chat',\n  description: 'Ask AI dialog for your docs',\n  requires: [docs],\n  options: {\n    provider: {\n      message: 'Choose an AI provider',\n      choices: Object.entries(providers).map(([value, { label, hint }]) => ({\n        value: value as AIProvider,\n        label,\n        hint,\n      })),\n    },\n  },\n  supports: (project) =>\n    project.static ? 'AI chat requires a server to run the chat route handler.' : true,\n  async apply(ctx, { provider }) {\n    await ctx.install(`ai/${provider}`);\n    ctx.env(providers[provider].env, '');\n    if (ctx.project.source.dynamic) await readDynamicSource(ctx);\n\n    const { cwd, baseDir, info, config } = ctx.project;\n    // e.g. `./components` -> `@/components/ai/layout`\n    const clientLayoutImport = `@/${path.posix.join(config.aliases.componentsDir, 'ai/layout')}`;\n    const layout = await findSource(cwd, path.join(baseDir, info.routesDir), '<DocsLayout');\n    let layoutModule: string | undefined;\n    let wired = false;\n\n    if (layout !== undefined) {\n      await ctx.source(layout, (file) => {\n        wired = file.code.includes(`'${clientLayoutImport}'`);\n        // `aiChat` takes client state, render the layout from a client component\n        const declaration =\n          !wired &&\n          file.program.body.find(\n            (node): node is ImportDeclaration =>\n              node.type === 'ImportDeclaration' &&\n              node.importKind !== 'type' &&\n              /^fumadocs-ui\\/layouts\\/(docs|notebook|glass|spacious)$/.test(node.source.value) &&\n              node.specifiers.length === 1 &&\n              node.specifiers[0].local.name === 'DocsLayout',\n          );\n        if (!declaration) return;\n\n        layoutModule = declaration.source.value;\n        file.s.overwrite(\n          declaration.source.start,\n          declaration.source.end,\n          `'${clientLayoutImport}'`,\n        );\n      });\n    }\n\n    if (layoutModule) {\n      await ctx.write(\n        path.join(baseDir, config.aliases.componentsDir, 'ai/layout.tsx'),\n        clientLayout(layoutModule),\n      );\n    } else if (!wired) {\n      ctx.note(\n        'Pass the AI chat to your docs layout, see https://fumadocs.dev/docs/integrations/llms#ask-ai.',\n      );\n    }\n    ctx.note(`Set ${providers[provider].env} in \\`.env.local\\`.`);\n  },\n};\n\nconst floatingTrigger = `\n      <AISearchTrigger\n        position=\"float\"\n        className={buttonVariants({\n          variant: 'secondary',\n          className: 'text-fd-muted-foreground rounded-2xl',\n        })}\n      >\n        <MessageCircleIcon className=\"size-4.5\" />\n        Ask AI\n      </AISearchTrigger>`;\n\n/** a client component rendering the docs layout with the installed chat */\nfunction clientLayout(layoutModule: string) {\n  // Glass and Spacious layouts have their own trigger\n  const trigger = /\\/(docs|notebook)$/.test(layoutModule);\n\n  return `'use client';\nimport { DocsLayout as Layout, type DocsLayoutProps } from '${layoutModule}';\n${\n  trigger\n    ? `import { buttonVariants } from 'fumadocs-ui/components/ui/button';\nimport { MessageCircleIcon } from 'lucide-react';\n`\n    : ''\n}import {\n  AISearch,\n  AISearchPanel,${trigger ? '\\n  AISearchTrigger,' : ''}\n  useAISearchContext,\n  useHotKey,\n} from './search';\n\nexport function DocsLayout(props: DocsLayoutProps) {\n  return (\n    <AISearch>\n      <ChatLayout {...props} />${trigger ? floatingTrigger : ''}\n    </AISearch>\n  );\n}\n\nfunction ChatLayout(props: DocsLayoutProps) {\n  const { open, setOpen } = useAISearchContext();\n  useHotKey();\n\n  return <Layout {...props} aiChat={{ open, onOpenChange: setOpen, panel: <AISearchPanel /> }} />;\n}\n`;\n}\n\n/** the installed chat route indexes pages of a static `source`, runtime sources resolve on demand */\nasync function readDynamicSource(ctx: FeatureContext) {\n  const { cwd, baseDir } = ctx.project;\n  const route = await findSource(cwd, baseDir, 'createSearchServer');\n  const edited =\n    route !== undefined &&\n    (await ctx.source(route, (file) => {\n      file.s.replaceAll(\n        \"import { source } from '@/lib/source';\",\n        \"import { getSource } from '@/lib/source';\",\n      );\n      file.s.replaceAll('source.getPages()', '(await getSource()).getPages()');\n      // every page of a runtime source carries its Markdown\n      file.s.replaceAll(\"      if (!('getText' in page.data)) return null;\\n\\n\", '');\n      file.s.replaceAll(\"await page.data.getText('processed')\", 'page.data.content');\n    }));\n\n  if (!edited)\n    ctx.note(\n      'Read pages from `getSource()` in the chat route, the search index is built from `page.data.content`.',\n    );\n}\n"],"mappings":";;;;AAMA,MAAM,YAAY;CAChB,YAAY;EAAE,OAAO;EAAU,MAAM;EAAyB,KAAK;CAAqB;CACxF,YAAY;EACV,OAAO;EACP,MAAM;EACN,KAAK;CACP;CACA,QAAQ;EAAE,OAAO;EAAa,MAAM;EAAoB,KAAK;CAAiB;AAChF;AAIA,MAAa,KAAwC;CACnD,IAAI;CACJ,OAAO;CACP,aAAa;CACb,UAAU,CAAC,IAAI;CACf,SAAS,EACP,UAAU;EACR,SAAS;EACT,SAAS,OAAO,QAAQ,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,aAAa;GAC7D;GACP;GACA;EACF,EAAE;CACJ,EACF;CACA,WAAW,YACT,QAAQ,SAAS,6DAA6D;CAChF,MAAM,MAAM,KAAK,EAAE,YAAY;EAC7B,MAAM,IAAI,QAAQ,MAAM,UAAU;EAClC,IAAI,IAAI,UAAU,SAAS,CAAC,KAAK,EAAE;EACnC,IAAI,IAAI,QAAQ,OAAO,SAAS,MAAM,kBAAkB,GAAG;EAE3D,MAAM,EAAE,KAAK,SAAS,MAAM,WAAW,IAAI;EAE3C,MAAM,qBAAqB,KAAK,KAAK,MAAM,KAAK,OAAO,QAAQ,eAAe,WAAW;EACzF,MAAM,SAAS,MAAM,WAAW,KAAK,KAAK,KAAK,SAAS,KAAK,SAAS,GAAG,aAAa;EACtF,IAAI;EACJ,IAAI,QAAQ;EAEZ,IAAI,WAAW,KAAA,GACb,MAAM,IAAI,OAAO,SAAS,SAAS;GACjC,QAAQ,KAAK,KAAK,SAAS,IAAI,mBAAmB,EAAE;GAEpD,MAAM,cACJ,CAAC,SACD,KAAK,QAAQ,KAAK,MACf,SACC,KAAK,SAAS,uBACd,KAAK,eAAe,UACpB,yDAAyD,KAAK,KAAK,OAAO,KAAK,KAC/E,KAAK,WAAW,WAAW,KAC3B,KAAK,WAAW,EAAE,CAAC,MAAM,SAAS,YACtC;GACF,IAAI,CAAC,aAAa;GAElB,eAAe,YAAY,OAAO;GAClC,KAAK,EAAE,UACL,YAAY,OAAO,OACnB,YAAY,OAAO,KACnB,IAAI,mBAAmB,EACzB;EACF,CAAC;EAGH,IAAI,cACF,MAAM,IAAI,MACR,KAAK,KAAK,SAAS,OAAO,QAAQ,eAAe,eAAe,GAChE,aAAa,YAAY,CAC3B;OACK,IAAI,CAAC,OACV,IAAI,KACF,+FACF;EAEF,IAAI,KAAK,OAAO,UAAU,SAAS,CAAC,IAAI,oBAAoB;CAC9D;AACF;AAEA,MAAM,kBAAkB;;;;;;;;;;;;AAaxB,SAAS,aAAa,cAAsB;CAE1C,MAAM,UAAU,qBAAqB,KAAK,YAAY;CAEtD,OAAO;8DACqD,aAAa;EAEzE,UACI;;IAGA,GACL;;kBAEiB,UAAU,yBAAyB,GAAG;;;;;;;;iCAQvB,UAAU,kBAAkB,GAAG;;;;;;;;;;;;AAYhE;;AAGA,eAAe,kBAAkB,KAAqB;CACpD,MAAM,EAAE,KAAK,YAAY,IAAI;CAC7B,MAAM,QAAQ,MAAM,WAAW,KAAK,SAAS,oBAAoB;CAcjE,IAAI,EAZF,UAAU,KAAA,KACT,MAAM,IAAI,OAAO,QAAQ,SAAS;EACjC,KAAK,EAAE,WACL,0CACA,2CACF;EACA,KAAK,EAAE,WAAW,qBAAqB,gCAAgC;EAEvE,KAAK,EAAE,WAAW,yDAAyD,EAAE;EAC7E,KAAK,EAAE,WAAW,wCAAwC,mBAAmB;CAC/E,CAAC,IAGD,IAAI,KACF,sGACF;AACJ"}

package/dist/{all-BVSylqu2.js → all-BmDsMSFN.js}

@@ -1,5 +1,5 @@
 import { t as docs } from "./docs--WqEHTyl.js";
-import { t as ai } from "./ai-C19ZOP53.js";
+import { t as ai } from "./ai-wXWLPFI5.js";
 import { r as llms } from "./llms-Br0RJXXg.js";
 import { t as og } from "./og-LFlX1Bl4.js";
 import { t as search } from "./search-BbzvfJal.js";
@@ -24,4 +24,4 @@ const features = [
 //#endregion
 export { features as t };
 
-//# sourceMappingURL=all-BVSylqu2.js.map
+//# sourceMappingURL=all-BmDsMSFN.js.map

package/dist/{all-BVSylqu2.js.map → all-BmDsMSFN.js.map}

@@ -1 +1 @@
-{"version":3,"file":"all-BVSylqu2.js","names":[],"sources":["../src/features/all.ts"],"sourcesContent":["import type { AnyFeature } from '.';\nimport { docs } from './docs';\nimport { ai } from './ai';\nimport { llms } from './llms';\nimport { og } from './og';\nimport { search } from './search';\nimport { mcp } from './mcp';\nimport { webmcp } from './webmcp';\nimport { feedback } from './feedback';\nimport { epub } from './epub';\nimport { lint } from './lint';\n\nexport const features: AnyFeature[] = [\n  docs,\n  ai,\n  llms,\n  mcp,\n  webmcp,\n  og,\n  search,\n  feedback,\n  epub,\n  lint,\n];\n"],"mappings":";;;;;;;;;;;AAYA,MAAa,WAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}
+{"version":3,"file":"all-BmDsMSFN.js","names":[],"sources":["../src/features/all.ts"],"sourcesContent":["import type { AnyFeature } from '.';\nimport { docs } from './docs';\nimport { ai } from './ai';\nimport { llms } from './llms';\nimport { og } from './og';\nimport { search } from './search';\nimport { mcp } from './mcp';\nimport { webmcp } from './webmcp';\nimport { feedback } from './feedback';\nimport { epub } from './epub';\nimport { lint } from './lint';\n\nexport const features: AnyFeature[] = [\n  docs,\n  ai,\n  llms,\n  mcp,\n  webmcp,\n  og,\n  search,\n  feedback,\n  epub,\n  lint,\n];\n"],"mappings":";;;;;;;;;;;AAYA,MAAa,WAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/dist/features/ai.js

@@ -1,2 +1,2 @@
-import { t as ai } from "../ai-C19ZOP53.js";
+import { t as ai } from "../ai-wXWLPFI5.js";
 export { ai };

package/dist/features/all.js

@@ -1,2 +1,2 @@
-import { t as features } from "../all-BVSylqu2.js";
+import { t as features } from "../all-BmDsMSFN.js";
 export { features };

package/dist/features/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","names":[],"sources":["../../src/features/search.ts"],"mappings":";;;;;UAyBU;EACR;EACA;;;qBAsEW,aAAU,gBACP,iBACC;cAqCX;;;;;MAIc;;;;;;;;;;;MATc;MAAgB;;;;;;;MAyD9B;;;;;;;;;;;MAzDc;MAAgB;;;;;;;MAyG9B;;;;;;;;;;;MAzGc;MAAgB;;;;;;;MA4J9B;MAAiB;;;;;;;;;;;MA5JH;MAAgB;;;;;;;MA4M9B;;;;;;;MA5Mc;MAAgB;;;;;;;;;;YAiRtC,8BAA8B;;qBAG7B,aAAU,WAAe,mBAAA;qBAGzB,cAAW,WAAe,gBAAc,cAAc;;wBASnD,aAAa,WAAW,gBAAgB;;qBAgB3C;;wBAGG,UACd,MAAM,gBACN,WAAW,kBACT,SAAS;EAAY;EAAiB,QAAQ,KAAK;GACrD,kBACE,cAAc;qBAmBL,QAAQ;EAAU,UAAU"}
+{"version":3,"file":"search.d.ts","names":["_$__project_route0.FormattedRoute"],"sources":["../../src/features/search.ts"],"mappings":";;;;;UAyBU;EACR;EACA;;;qBAsEW,aAAU,gBACP,iBACC;cAqCX;;;;;MAIc;;;;;;;;;;;MATc;MAAgB;;;;;;;MAyD9B;;;;;;;;;;;MAzDc;MAAgB;;;;;;;MAyG9B;;;;;;;;;;;MAzGc;MAAgB;;;;;;;MA4J9B;MAAiB;;;;;;;;;;;MA5JH;MAAgB;;;;;;;MA4M9B;;;;;;;MA5Mc;MAAgB;;;;;;;;;;YAiRtC,8BAA8B;;qBAG7B,aAAU,WAAe,mBAAAA;qBAGzB,cAAW,WAAe,gBAAc,cAAc;;wBASnD,aAAa,WAAW,gBAAgB;;qBAgB3C;;wBAGG,UACd,MAAM,gBACN,WAAW,kBACT,SAAS;EAAY;EAAiB,QAAQ,KAAK;GACrD,kBACE,cAAc;qBAmBL,QAAQ;EAAU,UAAU"}

package/dist/index.js

@@ -5,7 +5,7 @@ import { t as exists } from "./fs-D6J9dOEx.js";
 import { i as loadProject, n as frameworks } from "./project-DwRVTm4p.js";
 import { n as UIRegistries, t as FumadocsComponentInstaller } from "./installer-C4662Woc.js";
 import { t as runFeature } from "./features-Do6x9Tsz.js";
-import { t as features } from "./all-BVSylqu2.js";
+import { t as features } from "./all-BmDsMSFN.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { cac } from "cac";
@@ -66,7 +66,7 @@ async function runTree(args) {
 }
 //#endregion
 //#region package.json
-var version = "1.7.1";
+var version = "1.7.2";
 //#endregion
 //#region src/commands/customise.ts
 async function customise(config, connector) {
@@ -126,6 +126,18 @@ async function customise(config, connector) {
 					},
 					hint: "a docs layout with floating, translucent panels"
 				},
+				...config.uiLibrary === "base-ui" ? [{
+					label: "Spacious Layout",
+					value: {
+						id: "spacious",
+						targets: [{
+							subRegistry,
+							name: "layouts/spacious"
+						}],
+						print: () => printLayout(config, ["fumadocs-ui/layouts/spacious", "@/layouts/spacious"], ["fumadocs-ui/layouts/spacious/page", "@/layouts/spacious/page"])
+					},
+					hint: "a docs layout with the page in an inset panel, Base UI only"
+				}] : [],
 				{
 					label: "Home Layout",
 					value: {
@@ -235,202 +247,89 @@ async function printLayout(config, ...maps) {
 function printSlot({ at, layoutId, name, isPage, uiLibrary }) {
 	intro(picocolors.bold("What is Next?"));
 	log.info(`You can check the installed layout slot in "${at}".`);
-	const code = getSlotCode({
-		at,
+	const slot = getSlot({
 		layoutId,
 		name,
 		isPage,
 		uiLibrary
 	});
-	if (code) {
-		const layoutComponent = layoutId === "glass" ? "<GlassLayout />" : "<DocsLayout />";
-		if (isPage) log.info(`${picocolors.bold("At your <DocsPage /> component, update your \"slots\" prop:")}\n\n${code}`);
-		else log.info(`${picocolors.bold(`At your ${layoutComponent} component, update your "slots" prop:`)}\n\n${code}`);
-	}
-}
-function getSlotCode({ at, layoutId, name, isPage, uiLibrary }) {
-	if (layoutId === "glass") {
-		if (isPage) return;
-		switch (name) {
-			case "header": return `import { Header } from '${at}';
+	if (!slot) return;
+	const [imports, value] = slot;
+	const component = isPage ? "DocsPage" : "DocsLayout";
+	log.info(`${picocolors.bold(`At your <${component} /> component, update your "slots" prop:`)}
 
-return (
-  <GlassLayout
-    slots={{
-      header: Header,
-    }}
-  >
-    ...
-  </GlassLayout>
-);`;
-			case "sidebar": {
-				const imports = [
-					"Sidebar",
-					"SidebarDrawer",
-					"SidebarProvider",
-					"useSidebar"
-				];
-				if (uiLibrary === "base-ui") imports.push("drawerHandle");
-				return `import { ${imports.join(", ")} } from '${at}';
+import { ${imports} } from '${at}';
 
 return (
-  <GlassLayout
+  <${component}
     slots={{
-      sidebar: {
-        main: Sidebar,
-        provider: SidebarProvider,
-        use: useSidebar,
-        drawer: SidebarDrawer,${uiLibrary === "base-ui" ? "\n        drawerHandle," : ""}
-      },
+      ${value},
     }}
   >
     ...
-  </GlassLayout>
-);`;
-			}
-			default: return;
-		}
-	}
-	if (isPage) switch (name) {
-		case "toc":
-			if (layoutId === "flux") return `import { TOCProvider, TOC } from '${at}';
-
-return (
-  <DocsPage
-    slots={{
-      toc: {
+  </${component}>
+);`);
+}
+/** the names to import from slot file, and the entry of `slots` prop */
+function getSlot({ layoutId, name, isPage, uiLibrary }) {
+	if (isPage) {
+		if (layoutId === "glass") return;
+		switch (name) {
+			case "toc":
+				if (layoutId === "flux") return ["TOCProvider, TOC", `toc: {
         provider: TOCProvider,
         main: TOC,
-      },
-    }}
-  >
-    ...
-  </DocsPage>
-);`;
-			return `import { TOCProvider, TOC, TOCPopover } from '${at}';
-
-return (
-  <DocsPage
-    slots={{
-      toc: {
+      }`];
+				if (layoutId === "spacious") return ["TOCProvider, TOC, TOCPopover, TOCDropdown", `toc: {
         provider: TOCProvider,
         main: TOC,
         popover: TOCPopover,
-      },
-    }}
-  >
-    ...
-  </DocsPage>
-);`;
-		case "container": return `import { Container } from '${at}';
-
-return (
-  <DocsPage
-    slots={{
-      container: Container,
-    }}
-  >
-    ...
-  </DocsPage>
-);`;
-		case "footer": return `import { Footer } from '${at}';
-
-return (
-  <DocsPage
-    slots={{
-      footer: Footer,
-    }}
-  >
-    ...
-  </DocsPage>
-);`;
-		case "breadcrumb": return `import { Breadcrumb } from '${at}';
-
-return (
-  <DocsPage
-    slots={{
-      breadcrumb: Breadcrumb,
-    }}
-  >
-    ...
-  </DocsPage>
-);`;
-		default: return;
+        dropdown: TOCDropdown,
+      }`];
+				return ["TOCProvider, TOC, TOCPopover", `toc: {
+        provider: TOCProvider,
+        main: TOC,
+        popover: TOCPopover,
+      }`];
+			case "container": return ["Container", "container: Container"];
+			case "footer": return ["Footer", "footer: Footer"];
+			case "breadcrumb": return ["Breadcrumb", "breadcrumb: Breadcrumb"];
+			default: return;
+		}
 	}
 	switch (name) {
 		case "sidebar":
-			if (layoutId === "notebook") return `import {
-  SidebarProvider,
-  Sidebar,
-  SidebarTrigger,
-  SidebarCollapseTrigger,
-  useSidebar,
-} from '${at}';
-
-return (
-  <DocsLayout
-    slots={{
-      sidebar: {
+			if (layoutId === "glass") {
+				const drawerHandle = uiLibrary === "base-ui";
+				return [`Sidebar, SidebarDrawer, SidebarProvider, useSidebar${drawerHandle ? ", drawerHandle" : ""}`, `sidebar: {
+        main: Sidebar,
+        provider: SidebarProvider,
+        use: useSidebar,
+        drawer: SidebarDrawer,${drawerHandle ? "\n        drawerHandle," : ""}
+      }`];
+			}
+			if (layoutId === "spacious") return ["Sidebar, SidebarDrawer, SidebarProvider", `sidebar: {
+        provider: SidebarProvider,
+        main: Sidebar,
+        drawer: SidebarDrawer,
+      }`];
+			if (layoutId === "notebook") return ["SidebarProvider, Sidebar, SidebarTrigger, SidebarCollapseTrigger, useSidebar", `sidebar: {
         provider: SidebarProvider,
         root: Sidebar,
         trigger: SidebarTrigger,
         collapseTrigger: SidebarCollapseTrigger,
         useSidebar: useSidebar,
-      },
-    }}
-  >
-    ...
-  </DocsLayout>
-);`;
-			return `import { SidebarProvider, Sidebar, SidebarTrigger, useSidebar } from '${at}';
-
-return (
-  <DocsLayout
-    slots={{
-      sidebar: {
+      }`];
+			return ["SidebarProvider, Sidebar, SidebarTrigger, useSidebar", `sidebar: {
         provider: SidebarProvider,
         root: Sidebar,
         trigger: SidebarTrigger,
         useSidebar: useSidebar,
-      },
-    }}
-  >
-    ...
-  </DocsLayout>
-);`;
-		case "container": return `import { Container } from '${at}';
-
-return (
-  <DocsLayout
-    slots={{
-      container: Container,
-    }}
-  >
-    ...
-  </DocsLayout>
-);`;
-		case "header": return `import { Header } from '${at}';
-
-return (
-  <DocsLayout
-    slots={{
-      header: Header,
-    }}
-  >
-    ...
-  </DocsLayout>
-);`;
-		case "tab-dropdown": return `import { TabDropdown } from '${at}';
-
-return (
-  <DocsLayout
-    slots={{
-      tabDropdown: TabDropdown,
-    }}
-  >
-    ...
-  </DocsLayout>
-);`;
+      }`];
+		case "header": return ["Header", "header: Header"];
+		case "container": return ["Container", "container: Container"];
+		case "tab-dropdown": return ["TabDropdown", "tabDropdown: TabDropdown"];
+		case "actions": return ["HeaderActions", "actions: HeaderActions"];
 		default: return;
 	}
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["isCancel","isCancelSymbol","isCancel","isCancel","packageJson.version"],"sources":["../src/commands/file-tree.ts","../src/utils/file-tree/run-tree.ts","../package.json","../src/commands/customise.ts","../src/utils/prompt.ts","../src/commands/add.ts","../src/commands/export-epub.ts","../src/commands/feature.ts","../src/index.ts"],"sourcesContent":["export type JsonTreeNode =\n  | {\n      type: 'file';\n      name: string;\n    }\n  | {\n      type: 'directory';\n      name: string;\n      contents: JsonTreeNode[];\n    }\n  | {\n      type: 'report';\n    }\n  | {\n      type: 'link';\n      name: string;\n    };\n\nconst scanned = ['file', 'directory', 'link'];\n\nexport function treeToMdx(input: JsonTreeNode[], noRoot = false): string {\n  function toNode(item: JsonTreeNode): string {\n    if (item.type === 'file' || item.type === 'link') {\n      return `<File name=${JSON.stringify(item.name)} />`;\n    }\n\n    if (item.type === 'directory') {\n      if (item.contents.length === 1 && 'name' in item.contents[0]) {\n        const child = item.contents[0];\n\n        return toNode({\n          ...child,\n          name: `${item.name}/${child.name}`,\n        });\n      }\n\n      return `<Folder name=${JSON.stringify(item.name)}>\n${item.contents.map(toNode).filter(Boolean).join('\\n')}\n</Folder>`;\n    }\n\n    return '';\n  }\n\n  let children = input.filter((v) => scanned.includes(v.type));\n\n  if (noRoot && children.length === 1 && input[0].type === 'directory') {\n    children = input[0].contents;\n  }\n\n  return `<Files>\n${children.map(toNode).filter(Boolean).join('\\n')}\n</Files>`;\n}\n\nexport function treeToJavaScript(\n  input: JsonTreeNode[],\n  noRoot?: boolean,\n  importName = 'fumadocs-ui/components/files',\n): string {\n  return `import { File, Files, Folder } from ${JSON.stringify(importName)}\n\nexport default (${treeToMdx(input, noRoot)})`;\n}\n","import { x } from 'tinyexec';\nimport type { JsonTreeNode } from '@/commands/file-tree';\n\nexport async function runTree(args: string): Promise<JsonTreeNode[]> {\n  const out = await x('tree', [args, '--gitignore', '--prune', '-J']);\n\n  try {\n    return JSON.parse(out.stdout) as JsonTreeNode[];\n  } catch (e) {\n    throw new Error('failed to run `tree` command', {\n      cause: e,\n    });\n  }\n}\n","","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { cancel, group, intro, log, outro, select, type Option } from '@clack/prompts';\nimport picocolors from 'picocolors';\nimport { parseSourceFile } from '@/codemod';\nimport { frameworks } from '@/project';\nimport type { Target } from '@/commands/add';\nimport { UIRegistries } from '@/commands/shared';\nimport { LoadedConfig } from '@/config';\nimport { RegistryConnector } from 'fuma-cli/registry/connector';\nimport { FumadocsComponentInstaller } from '@/registry/installer';\n\ninterface TargetInfo {\n  targets: Target[];\n  id: string;\n  print?: () => void | Promise<void>;\n}\n\ninterface SlotPrintInfo {\n  at: string;\n  layoutId: string;\n  name: string;\n  isPage: boolean;\n  uiLibrary: LoadedConfig['uiLibrary'];\n}\n\nexport async function customise(config: LoadedConfig, connector: RegistryConnector) {\n  intro(picocolors.bgBlack(picocolors.whiteBright('Customize Fumadocs UI')));\n\n  const installer = new FumadocsComponentInstaller(connector, config);\n  const subRegistry = UIRegistries[config.uiLibrary];\n  const manifest = await installer.fetchManifest(subRegistry);\n\n  const result = await group(\n    {\n      layout: (): Promise<TargetInfo | symbol> =>\n        select({\n          message: 'What do you want to customize?',\n          options: [\n            {\n              label: 'Docs Layout',\n              value: {\n                id: 'docs',\n                targets: [{ subRegistry, name: 'layouts/docs' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/docs', '@/layouts/docs'],\n                    ['fumadocs-ui/layouts/docs/page', '@/layouts/docs/page'],\n                  ),\n              },\n              hint: 'the default docs layout',\n            },\n            {\n              label: 'Notebook Layout',\n              value: {\n                id: 'notebook',\n                targets: [{ subRegistry, name: 'layouts/notebook' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/notebook', '@/layouts/notebook'],\n                    ['fumadocs-ui/layouts/notebook/page', '@/layouts/notebook/page'],\n                  ),\n              },\n              hint: 'a more compact version of docs layout',\n            },\n            {\n              label: 'Flux Layout',\n              value: {\n                id: 'flux',\n                targets: [{ subRegistry, name: 'layouts/flux' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/flux', '@/layouts/flux'],\n                    ['fumadocs-ui/layouts/flux/page', '@/layouts/flux/page'],\n                  ),\n              },\n              hint: 'the experimental variant of docs layout',\n            },\n            {\n              label: 'Glass Layout',\n              value: {\n                id: 'glass',\n                targets: [{ subRegistry, name: 'layouts/glass' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/glass', '@/layouts/glass'],\n                    ['fumadocs-ui/layouts/glass/page', '@/layouts/glass/page'],\n                  ),\n              },\n              hint: 'a docs layout with floating, translucent panels',\n            },\n            {\n              label: 'Home Layout',\n              value: {\n                id: 'home',\n                targets: [{ subRegistry, name: 'layouts/home' }],\n                print: () => printLayout(config, ['fumadocs-ui/layouts/home', '@/layouts/home']),\n              },\n              hint: 'the layout for other non-docs pages',\n            },\n          ],\n        }),\n      target: (v): Promise<TargetInfo | symbol> => {\n        const selected = v.results.layout!;\n        if (selected.id === 'home') return Promise.resolve(selected);\n\n        const slots: Option<TargetInfo>[] = [];\n        const prefix = `layouts/${selected.id}/`;\n        for (const { name: id } of manifest.components) {\n          // <layout>/slots/<name> or <layout>/page/slots/<name>\n          const [dir, name] = id.startsWith(prefix) ? id.slice(prefix.length).split('slots/') : [];\n          if (name === undefined) continue;\n          const isPage = dir === 'page/';\n\n          slots.push({\n            label: `${isPage ? 'Page' : 'Layout'}: ${name}`,\n            hint: `only replace a part of layout${isPage ? \"'s page\" : ''}, useful for adjusting details`,\n            value: {\n              id,\n              targets: [{ subRegistry, name: id }],\n              print() {\n                printSlot({\n                  at: `@/${id}`,\n                  layoutId: selected.id,\n                  name,\n                  isPage,\n                  uiLibrary: config.uiLibrary,\n                });\n              },\n            },\n          });\n        }\n\n        return select<TargetInfo>({\n          message: 'Which part do you want to customize?',\n          options: [\n            {\n              label: 'All',\n              hint: 'install the entire layout',\n              value: selected,\n            },\n            {\n              label: 'Replace & rewrite from minimal styles',\n              hint: 'for those who want to build their own UI from ground up',\n              value: {\n                id: 'docs-min',\n                targets: [{ name: 'layouts/docs-min' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/docs', '@/layouts/docs'],\n                    ['fumadocs-ui/layouts/docs/page', '@/layouts/docs/page'],\n                  ),\n              },\n            },\n            ...slots,\n          ],\n        });\n      },\n    },\n    {\n      onCancel: () => {\n        cancel('Installation Stopped.');\n        process.exit(0);\n      },\n    },\n  );\n\n  const targetInfo = result.target as TargetInfo;\n  for (const target of targetInfo.targets) {\n    await installer.installInteractive(target.name, target.subRegistry);\n  }\n\n  await targetInfo.print?.();\n\n  outro(picocolors.bold('Have fun!'));\n}\n\n/** point the imports of route files at the installed layouts */\nexport async function rewriteLayoutImports(config: LoadedConfig, map: Map<string, string>) {\n  const dir = path.join(config.baseDir, frameworks[config.framework].routesDir);\n  const entries = await fs.readdir(dir, { recursive: true, withFileTypes: true }).catch(() => []);\n  const updated: string[] = [];\n\n  for (const entry of entries) {\n    if (!entry.isFile() || !entry.name.endsWith('.tsx')) continue;\n    const file = path.join(entry.parentPath, entry.name);\n    const source = parseSourceFile(file, await fs.readFile(file, 'utf-8'));\n    for (const node of source.program.body) {\n      if (node.type !== 'ImportDeclaration') continue;\n      const to = map.get(node.source.value);\n      if (to) source.s.overwrite(node.source.start + 1, node.source.end - 1, to);\n    }\n    if (!source.s.hasChanged()) continue;\n    await source.save();\n    updated.push(file);\n  }\n\n  return updated;\n}\n\nasync function printLayout(config: LoadedConfig, ...maps: [from: string, to: string][]) {\n  intro(picocolors.bold('What is Next?'));\n  const updated = await rewriteLayoutImports(config, new Map(maps));\n\n  log.info(\n    [\n      'You can check the installed layouts in `layouts` folder.',\n      picocolors.dim('---'),\n      updated.length > 0\n        ? `Updated the imports of ${updated.join(', ')}.`\n        : 'Open your `layout.tsx` files, replace the imports of components:',\n      ...maps.map(([from, to]) => picocolors.greenBright(`\"${from}\" -> \"${to}\"`)),\n    ].join('\\n'),\n  );\n}\n\nfunction printSlot({ at, layoutId, name, isPage, uiLibrary }: SlotPrintInfo) {\n  intro(picocolors.bold('What is Next?'));\n\n  log.info(`You can check the installed layout slot in \"${at}\".`);\n\n  const code = getSlotCode({ at, layoutId, name, isPage, uiLibrary });\n\n  if (code) {\n    const layoutComponent = layoutId === 'glass' ? '<GlassLayout />' : '<DocsLayout />';\n\n    if (isPage) {\n      log.info(\n        `${picocolors.bold('At your <DocsPage /> component, update your \"slots\" prop:')}\\n\\n${code}`,\n      );\n    } else {\n      log.info(\n        `${picocolors.bold(`At your ${layoutComponent} component, update your \"slots\" prop:`)}\\n\\n${code}`,\n      );\n    }\n  }\n}\n\nfunction getSlotCode({ at, layoutId, name, isPage, uiLibrary }: SlotPrintInfo): string | undefined {\n  if (layoutId === 'glass') {\n    // Glass layout wires its page slots directly, only layout-level slots are swappable.\n    if (isPage) return;\n\n    switch (name) {\n      case 'header':\n        return `import { Header } from '${at}';\n\nreturn (\n  <GlassLayout\n    slots={{\n      header: Header,\n    }}\n  >\n    ...\n  </GlassLayout>\n);`;\n      case 'sidebar': {\n        // `sidebar` slot file holds the whole sidebar system (desktop, mobile drawer, provider).\n        // Base UI additionally exposes a `drawerHandle` for its swipeable drawer.\n        const imports = ['Sidebar', 'SidebarDrawer', 'SidebarProvider', 'useSidebar'];\n        if (uiLibrary === 'base-ui') imports.push('drawerHandle');\n\n        return `import { ${imports.join(', ')} } from '${at}';\n\nreturn (\n  <GlassLayout\n    slots={{\n      sidebar: {\n        main: Sidebar,\n        provider: SidebarProvider,\n        use: useSidebar,\n        drawer: SidebarDrawer,${uiLibrary === 'base-ui' ? '\\n        drawerHandle,' : ''}\n      },\n    }}\n  >\n    ...\n  </GlassLayout>\n);`;\n      }\n      default:\n        return;\n    }\n  }\n\n  if (isPage) {\n    switch (name) {\n      case 'toc':\n        if (layoutId === 'flux') {\n          return `import { TOCProvider, TOC } from '${at}';\n\nreturn (\n  <DocsPage\n    slots={{\n      toc: {\n        provider: TOCProvider,\n        main: TOC,\n      },\n    }}\n  >\n    ...\n  </DocsPage>\n);`;\n        }\n\n        return `import { TOCProvider, TOC, TOCPopover } from '${at}';\n\nreturn (\n  <DocsPage\n    slots={{\n      toc: {\n        provider: TOCProvider,\n        main: TOC,\n        popover: TOCPopover,\n      },\n    }}\n  >\n    ...\n  </DocsPage>\n);`;\n      case 'container': {\n        return `import { Container } from '${at}';\n\nreturn (\n  <DocsPage\n    slots={{\n      container: Container,\n    }}\n  >\n    ...\n  </DocsPage>\n);`;\n      }\n      case 'footer': {\n        return `import { Footer } from '${at}';\n\nreturn (\n  <DocsPage\n    slots={{\n      footer: Footer,\n    }}\n  >\n    ...\n  </DocsPage>\n);`;\n      }\n      case 'breadcrumb': {\n        return `import { Breadcrumb } from '${at}';\n\nreturn (\n  <DocsPage\n    slots={{\n      breadcrumb: Breadcrumb,\n    }}\n  >\n    ...\n  </DocsPage>\n);`;\n      }\n      default:\n        return;\n    }\n  }\n\n  switch (name) {\n    case 'sidebar': {\n      if (layoutId === 'notebook') {\n        return `import {\n  SidebarProvider,\n  Sidebar,\n  SidebarTrigger,\n  SidebarCollapseTrigger,\n  useSidebar,\n} from '${at}';\n\nreturn (\n  <DocsLayout\n    slots={{\n      sidebar: {\n        provider: SidebarProvider,\n        root: Sidebar,\n        trigger: SidebarTrigger,\n        collapseTrigger: SidebarCollapseTrigger,\n        useSidebar: useSidebar,\n      },\n    }}\n  >\n    ...\n  </DocsLayout>\n);`;\n      }\n\n      return `import { SidebarProvider, Sidebar, SidebarTrigger, useSidebar } from '${at}';\n\nreturn (\n  <DocsLayout\n    slots={{\n      sidebar: {\n        provider: SidebarProvider,\n        root: Sidebar,\n        trigger: SidebarTrigger,\n        useSidebar: useSidebar,\n      },\n    }}\n  >\n    ...\n  </DocsLayout>\n);`;\n    }\n    case 'container': {\n      return `import { Container } from '${at}';\n\nreturn (\n  <DocsLayout\n    slots={{\n      container: Container,\n    }}\n  >\n    ...\n  </DocsLayout>\n);`;\n    }\n    case 'header': {\n      return `import { Header } from '${at}';\n\nreturn (\n  <DocsLayout\n    slots={{\n      header: Header,\n    }}\n  >\n    ...\n  </DocsLayout>\n);`;\n    }\n    case 'tab-dropdown': {\n      return `import { TabDropdown } from '${at}';\n\nreturn (\n  <DocsLayout\n    slots={{\n      tabDropdown: TabDropdown,\n    }}\n  >\n    ...\n  </DocsLayout>\n);`;\n    }\n    default:\n      return;\n  }\n}\n","import { isCancel as isCancelSymbol } from '@clack/prompts';\n\n/**\n * `@clack/core` narrows to its own `unique symbol`, which can't exclude the wider `symbol` that\n * `@clack/prompts` returns, so a prompt result never narrows without this.\n */\nexport function isCancel<T>(value: T | symbol): value is symbol {\n  return isCancelSymbol(value);\n}\n","import { autocompleteMultiselect, outro, spinner } from '@clack/prompts';\nimport { isCancel } from '@/utils/prompt';\nimport picocolors from 'picocolors';\nimport { UIRegistries } from '@/commands/shared';\nimport { RegistryConnector } from 'fuma-cli/registry/connector';\nimport { LoadedConfig } from '@/config';\nimport { FumadocsComponentInstaller } from '@/registry/installer';\n\ninterface AddOption {\n  label: string;\n  value: Target;\n  hint?: string;\n}\n\nexport interface Target {\n  name: string;\n  subRegistry?: string;\n}\n\nexport async function add(input: string[], connector: RegistryConnector, config: LoadedConfig) {\n  let targets: Target[];\n  const installer = new FumadocsComponentInstaller(connector, config);\n  const subRegistry = UIRegistries[config.uiLibrary];\n\n  if (input.length === 0) {\n    const spin = spinner();\n    spin.start('fetching registry');\n\n    async function scan(subRegistry?: string, prefix?: string): Promise<AddOption[]> {\n      const manifest = await installer.fetchManifest(subRegistry);\n      const options: AddOption[] = [];\n\n      for (const item of manifest.components) {\n        if (item.unlisted) continue;\n        options.push({\n          label: `${prefix ? `${picocolors.bold(prefix)} - ` : ''}${item.title ?? item.name}`,\n          value: { name: item.name, subRegistry },\n          hint: item.description,\n        });\n      }\n      return options;\n    }\n\n    const groups = await Promise.all([\n      scan(undefined, 'common'),\n      scan('sanity', 'sanity'),\n      scan('openapi', 'openapi'),\n      scan('api-docs', 'api-docs'),\n      scan(subRegistry, 'ui'),\n    ]);\n\n    spin.stop(picocolors.bold(picocolors.greenBright('registry fetched')));\n    const value = await autocompleteMultiselect({\n      message: 'Select components to install',\n      options: groups.flat().sort((a, b) => a.label.localeCompare(b.label)),\n    });\n\n    if (isCancel(value)) {\n      outro('Ended');\n      return;\n    }\n\n    targets = value;\n  } else {\n    const root = new Set<string>();\n    for (const item of (await installer.fetchManifest()).components) root.add(item.name);\n    targets = input.map((name) => (root.has(name) ? { name } : { subRegistry, name }));\n  }\n\n  for (const target of targets) {\n    await installer.installInteractive(target.name, target.subRegistry);\n  }\n\n  outro(picocolors.bold(picocolors.greenBright('Successful')));\n}\n","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { exists } from '@/utils/fs';\nimport picocolors from 'picocolors';\nimport { spinner } from '@clack/prompts';\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\n\nconst execAsync = promisify(exec);\n\ninterface PackageJson {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n}\n\nasync function readPackageJson(cwd: string): Promise<PackageJson | null> {\n  try {\n    const raw = await fs.readFile(path.join(cwd, 'package.json'), 'utf-8');\n    return JSON.parse(raw) as PackageJson;\n  } catch {\n    return null;\n  }\n}\n\n/** Path of pre-rendered EPUB, choose one according to your React framework. Next.js fetches from the running server instead. */\nconst EPUB_BUILD_PATHS: Record<string, string> = {\n  next: '', // Fetched from /export/epub at runtime; route handlers don't produce static files\n  astro: 'dist/export/epub',\n  'tanstack-start': '.output/public/export/epub',\n  'tanstack-start-spa': 'dist/client/export/epub',\n  'react-router': 'build/client/export/epub',\n  'react-router-spa': 'build/client/export/epub',\n  waku: 'dist/public/export/epub',\n};\n\nexport async function exportEpub(options: { output?: string; framework: string }) {\n  const cwd = process.cwd();\n  const outputPath = path.resolve(cwd, options.output ?? 'docs.epub');\n  const framework = options.framework;\n\n  const spin = spinner();\n\n  const buildPath = EPUB_BUILD_PATHS[framework];\n  if (!(framework in EPUB_BUILD_PATHS)) {\n    const valid = Object.keys(EPUB_BUILD_PATHS).join(', ');\n    console.error(picocolors.red(`Invalid --framework \"${framework}\". Must be one of: ${valid}`));\n    process.exit(1);\n  }\n\n  const pkg = await readPackageJson(cwd);\n  // Check for fumadocs-epub dependency\n  if (!pkg) {\n    console.error(\n      picocolors.red('Cannot read or parse package.json. Ensure it exists and is valid JSON.'),\n    );\n    process.exit(1);\n  }\n  const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n  if (!deps['fumadocs-epub']) {\n    console.log(picocolors.yellow('\\nInstalling fumadocs-epub...'));\n    const packageManager = process.env.npm_execpath?.includes('pnpm')\n      ? 'pnpm'\n      : process.env.npm_execpath?.includes('bun')\n        ? 'bun'\n        : 'npm';\n    const installCmd = `${packageManager} add fumadocs-epub`;\n    try {\n      await execAsync(installCmd, { cwd });\n    } catch (err: unknown) {\n      const stderr =\n        err && typeof err === 'object' && 'stderr' in err\n          ? String((err as { stderr?: string }).stderr)\n          : '';\n      console.error(picocolors.red(`Failed to install fumadocs-epub. Command: ${installCmd}`));\n      if (stderr) console.error(stderr);\n      process.exit(1);\n    }\n  }\n\n  if (framework === 'next') {\n    const secret = process.env.EXPORT_SECRET;\n    if (!secret) {\n      console.error(\n        picocolors.red('EXPORT_SECRET is required for Next.js export. Set it in your environment.'),\n      );\n      process.exit(1);\n    }\n    const port = process.env.PORT || '3000';\n    const url = `http://localhost:${port}/export/epub`;\n    spin.start('Fetching EPUB from server');\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), 30_000);\n    try {\n      const res = await fetch(url, {\n        headers: { Authorization: `Bearer ${secret}` },\n        signal: controller.signal,\n      });\n      if (!res.ok) {\n        if (res.status === 401 || res.status === 403) {\n          console.error(\n            picocolors.red('Auth failed. Check that EXPORT_SECRET matches the value in your app.'),\n          );\n        } else if (res.status === 404) {\n          console.error(\n            picocolors.red('Export route not found, run `fumadocs feature epub` to create it.'),\n          );\n        } else {\n          console.error(\n            picocolors.red(\n              `Server returned ${res.status}. Ensure the app is running (e.g. pnpm start) on port ${port}.`,\n            ),\n          );\n        }\n        process.exit(1);\n      }\n      const buffer = Buffer.from(await res.arrayBuffer());\n      await fs.mkdir(path.dirname(outputPath), { recursive: true });\n      await fs.writeFile(outputPath, buffer);\n      spin.stop(picocolors.green(`EPUB saved to ${outputPath}`));\n    } catch (err: unknown) {\n      if (err instanceof Error && err.name === 'AbortError') {\n        console.error(picocolors.red('Request timed out after 30 seconds.'));\n      } else {\n        const msg = err instanceof Error ? err.message : String(err);\n        console.error(picocolors.red(`Could not fetch EPUB: ${msg}`));\n      }\n      console.error(\n        picocolors.yellow(`Ensure the server is running (e.g. pnpm start) on port ${port}.`),\n      );\n      process.exit(1);\n    } finally {\n      clearTimeout(timeoutId);\n    }\n    return;\n  }\n\n  const fullBuildPath = path.join(cwd, buildPath);\n  if (!(await exists(fullBuildPath))) {\n    console.error(\n      picocolors.red(\n        `EPUB not found at ${buildPath}. Run production build first (e.g. pnpm build).`,\n      ),\n    );\n    process.exit(1);\n  }\n\n  spin.start('Copying EPUB');\n  await fs.mkdir(path.dirname(outputPath), { recursive: true });\n  await fs.copyFile(fullBuildPath, outputPath);\n  spin.stop(picocolors.green(`EPUB saved to ${outputPath}`));\n}\n","import type { CAC, Command } from 'cac';\nimport { cancel, confirm, intro, log, note, outro, select, spinner } from '@clack/prompts';\nimport { isCancel } from '@/utils/prompt';\nimport picocolors from 'picocolors';\nimport type { RegistryConnector } from 'fuma-cli/registry/connector';\nimport { createOrLoadConfig } from '@/config';\nimport { loadProject } from '@/project';\nimport { type AnyFeature, type FeatureIO, runFeature } from '@/features';\nimport { features } from '@/features/all';\n\ninterface CommandOptions extends Record<string, string | boolean | undefined> {\n  config?: string;\n  dir?: string;\n  yes?: boolean;\n  install?: boolean;\n}\n\nexport function registerFeatureCommands(\n  cli: CAC,\n  createConnector: (dir?: string) => RegistryConnector,\n) {\n  const ids = features.map((feature) => feature.id).join(', ');\n\n  register(\n    cli.command('feature <id>', `configure a feature on your project (${ids})`),\n    features,\n  ).action(async (id: string, options: CommandOptions) => {\n    const feature = features.find((item) => item.id === id);\n    if (!feature) throw new Error(`unknown feature: ${id}, available: ${ids}`);\n\n    await run(feature, options, createConnector(options.dir));\n  });\n\n  register(cli.command('init', 'set up Fumadocs on an existing app, same as `feature docs`'), [\n    features[0],\n  ]).action(async (options: CommandOptions) => {\n    await run(features[0], options, createConnector(options.dir));\n  });\n}\n\nfunction register(command: Command, list: AnyFeature[]) {\n  command\n    .option('--dir <string>', 'the root url or directory to resolve registry')\n    .option('-y, --yes', 'skip prompts, overwrite existing files')\n    .option('--no-install', 'write dependencies to package.json without installing');\n\n  for (const feature of list) {\n    for (const [key, option] of Object.entries(feature.options ?? {})) {\n      if ('choices' in option) {\n        command.option(\n          `--${key} <value>`,\n          `${option.message} (${option.choices.map((choice) => choice.value).join(', ')})`,\n        );\n      } else {\n        command.option(`--${key}`, option.message);\n      }\n    }\n  }\n\n  return command;\n}\n\nasync function run(feature: AnyFeature, options: CommandOptions, connector: RegistryConnector) {\n  intro(picocolors.bgBlack(picocolors.whiteBright(feature.title)));\n  const config = await createOrLoadConfig(options.config);\n  const project = await loadProject(config);\n  log.info(`${project.framework}${project.static ? ' (static)' : ''}, ${project.packageManager}`);\n\n  const values: Record<string, unknown> = {};\n  for (const [key, option] of Object.entries(feature.options ?? {})) {\n    const given = options[key];\n    if ('choices' in option) {\n      if (given !== undefined) {\n        if (!option.choices.some((choice) => choice.value === given))\n          throw new Error(`invalid value for --${key}: ${given}`);\n        values[key] = given;\n        continue;\n      }\n\n      const value = await select({ message: option.message, options: option.choices });\n      if (isCancel(value)) {\n        cancel('Stopped.');\n        process.exit(0);\n      }\n      values[key] = value;\n    } else if (given !== undefined) {\n      values[key] = given === true;\n    } else if (options.yes) {\n      values[key] = option.initialValue ?? false;\n    } else {\n      const value = await confirm({ message: option.message, initialValue: option.initialValue });\n      if (isCancel(value)) {\n        cancel('Stopped.');\n        process.exit(0);\n      }\n      values[key] = value;\n    }\n  }\n\n  const spin = spinner();\n  const io: FeatureIO = {\n    installDependencies: options.install !== false,\n    log: (message) => spin.message(message),\n    async confirmOverwrite(file) {\n      if (options.yes) return true;\n      spin.clear();\n      const value = await confirm({ message: `Overwrite ${file}?`, initialValue: false });\n      if (isCancel(value)) {\n        cancel('Stopped.');\n        process.exit(0);\n      }\n      spin.start();\n      return value;\n    },\n  };\n\n  spin.start(`Applying ${feature.title}`);\n  try {\n    const { notes } = await runFeature(feature, values, { project, connector, io });\n    spin.stop(`${feature.title} applied`);\n    if (notes.length > 0) note(notes.join('\\n\\n'), 'What is Next?');\n  } catch (e) {\n    spin.error(e instanceof Error ? e.message : String(e));\n    process.exit(1);\n  }\n  outro(picocolors.bold(picocolors.greenBright('Done')));\n}\n","#!/usr/bin/env node\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { cac } from 'cac';\nimport picocolors from 'picocolors';\nimport { createOrLoadConfig, initConfig } from '@/config';\nimport { type JsonTreeNode, treeToJavaScript, treeToMdx } from '@/commands/file-tree';\nimport { runTree } from '@/utils/file-tree/run-tree';\nimport packageJson from '../package.json';\nimport { customise } from '@/commands/customise';\nimport { add } from '@/commands/add';\nimport { exportEpub } from '@/commands/export-epub';\nimport { registerFeatureCommands } from '@/commands/feature';\nimport { HttpRegistryConnector, LocalRegistryConnector } from 'fuma-cli/registry/connector';\n\nconst cli = cac('fumadocs');\ncli.option('--config <string>', 'path to the config file');\n\ncli.command('', 'init a `cli.json` config file').action(async () => {\n  if (await initConfig()) {\n    console.log(picocolors.green('Initialized a `./cli.json` config file.'));\n  } else {\n    console.log(picocolors.redBright('A config file already exists.'));\n  }\n});\n\ncli\n  .command('customise', 'simple way to customize layouts with Fumadocs UI')\n  .alias('customize')\n  .option('--dir <string>', 'the root url or directory to resolve registry')\n  .action(async (options: { config?: string; dir?: string }) => {\n    const config = await createOrLoadConfig(options.config);\n    await customise(config, createClientFromDir(options.dir));\n  });\n\nconst dirShortcuts: Record<string, string> = {\n  ':preview': 'https://preview.fumadocs.dev/registry',\n  ':dev': 'http://localhost:3000/registry',\n};\n\ncli\n  .command('add [...components]', 'add a new component to your docs')\n  .option('--dir <string>', 'the root url or directory to resolve registry')\n  .action(async (input: string[], options: { config?: string; dir?: string }) => {\n    const config = await createOrLoadConfig(options.config);\n    const client = createClientFromDir(options.dir);\n    await add(input, client, config);\n  });\n\nregisterFeatureCommands(cli, createClientFromDir);\n\ncli\n  .command(\n    'export <format>',\n    'export documentation to various formats (run after production build)',\n  )\n  .option('--framework <name>', 'framework: next, astro, tanstack-start, react-router, waku')\n  .option('--output <path>', 'output file path', { default: 'docs.epub' })\n  .action(async (format: string, options: { framework?: string; output: string }) => {\n    if (format !== 'epub')\n      throw new Error(`unsupported format: ${format}, only \\`epub\\` is supported.`);\n    if (!options.framework) throw new Error('option `--framework <name>` is required.');\n\n    await exportEpub({ framework: options.framework, output: options.output });\n  });\n\ncli\n  .command(\n    'tree [json_or_args] [output]',\n    'generate a file tree for the Files component, from a directory or JSON output of `tree`',\n  )\n  .option('--js', 'output as JavaScript file')\n  .option('--no-root', 'remove the root node')\n  .option('--import-name <name>', 'where to import components (JS only)')\n  .action(\n    async (\n      str: string | undefined,\n      output: string | undefined,\n      { js, root, importName }: { js: boolean; root: boolean; importName?: string },\n    ) => {\n      const jsExtensions = ['.js', '.tsx', '.jsx'];\n      const noRoot = !root;\n      let nodes: JsonTreeNode[];\n\n      try {\n        nodes = JSON.parse(str ?? '') as JsonTreeNode[];\n      } catch {\n        nodes = await runTree(str ?? './');\n      }\n\n      const out =\n        js || (output && jsExtensions.includes(path.extname(output)))\n          ? treeToJavaScript(nodes, noRoot, importName)\n          : treeToMdx(nodes, noRoot);\n\n      if (output) {\n        await fs.mkdir(path.dirname(output), { recursive: true });\n        await fs.writeFile(output, out);\n      } else {\n        console.log(out);\n      }\n    },\n  );\n\nfunction createClientFromDir(dir = 'https://fumadocs.dev/registry') {\n  if (dir in dirShortcuts) dir = dirShortcuts[dir];\n\n  return dir.startsWith('http://') || dir.startsWith('https://')\n    ? new HttpRegistryConnector(dir)\n    : new LocalRegistryConnector(dir);\n}\n\ncli.help();\ncli.version(packageJson.version);\n\ntry {\n  cli.parse(process.argv, { run: false });\n  await cli.runMatchedCommand();\n} catch (e) {\n  console.error(picocolors.redBright(e instanceof Error ? e.message : String(e)));\n  process.exit(1);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["isCancel","isCancelSymbol","isCancel","isCancel","packageJson.version"],"sources":["../src/commands/file-tree.ts","../src/utils/file-tree/run-tree.ts","../package.json","../src/commands/customise.ts","../src/utils/prompt.ts","../src/commands/add.ts","../src/commands/export-epub.ts","../src/commands/feature.ts","../src/index.ts"],"sourcesContent":["export type JsonTreeNode =\n  | {\n      type: 'file';\n      name: string;\n    }\n  | {\n      type: 'directory';\n      name: string;\n      contents: JsonTreeNode[];\n    }\n  | {\n      type: 'report';\n    }\n  | {\n      type: 'link';\n      name: string;\n    };\n\nconst scanned = ['file', 'directory', 'link'];\n\nexport function treeToMdx(input: JsonTreeNode[], noRoot = false): string {\n  function toNode(item: JsonTreeNode): string {\n    if (item.type === 'file' || item.type === 'link') {\n      return `<File name=${JSON.stringify(item.name)} />`;\n    }\n\n    if (item.type === 'directory') {\n      if (item.contents.length === 1 && 'name' in item.contents[0]) {\n        const child = item.contents[0];\n\n        return toNode({\n          ...child,\n          name: `${item.name}/${child.name}`,\n        });\n      }\n\n      return `<Folder name=${JSON.stringify(item.name)}>\n${item.contents.map(toNode).filter(Boolean).join('\\n')}\n</Folder>`;\n    }\n\n    return '';\n  }\n\n  let children = input.filter((v) => scanned.includes(v.type));\n\n  if (noRoot && children.length === 1 && input[0].type === 'directory') {\n    children = input[0].contents;\n  }\n\n  return `<Files>\n${children.map(toNode).filter(Boolean).join('\\n')}\n</Files>`;\n}\n\nexport function treeToJavaScript(\n  input: JsonTreeNode[],\n  noRoot?: boolean,\n  importName = 'fumadocs-ui/components/files',\n): string {\n  return `import { File, Files, Folder } from ${JSON.stringify(importName)}\n\nexport default (${treeToMdx(input, noRoot)})`;\n}\n","import { x } from 'tinyexec';\nimport type { JsonTreeNode } from '@/commands/file-tree';\n\nexport async function runTree(args: string): Promise<JsonTreeNode[]> {\n  const out = await x('tree', [args, '--gitignore', '--prune', '-J']);\n\n  try {\n    return JSON.parse(out.stdout) as JsonTreeNode[];\n  } catch (e) {\n    throw new Error('failed to run `tree` command', {\n      cause: e,\n    });\n  }\n}\n","","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { cancel, group, intro, log, outro, select, type Option } from '@clack/prompts';\nimport picocolors from 'picocolors';\nimport { parseSourceFile } from '@/codemod';\nimport { frameworks } from '@/project';\nimport type { Target } from '@/commands/add';\nimport { UIRegistries } from '@/commands/shared';\nimport { LoadedConfig } from '@/config';\nimport { RegistryConnector } from 'fuma-cli/registry/connector';\nimport { FumadocsComponentInstaller } from '@/registry/installer';\n\ninterface TargetInfo {\n  targets: Target[];\n  id: string;\n  print?: () => void | Promise<void>;\n}\n\ninterface SlotPrintInfo {\n  at: string;\n  layoutId: string;\n  name: string;\n  isPage: boolean;\n  uiLibrary: LoadedConfig['uiLibrary'];\n}\n\nexport async function customise(config: LoadedConfig, connector: RegistryConnector) {\n  intro(picocolors.bgBlack(picocolors.whiteBright('Customize Fumadocs UI')));\n\n  const installer = new FumadocsComponentInstaller(connector, config);\n  const subRegistry = UIRegistries[config.uiLibrary];\n  const manifest = await installer.fetchManifest(subRegistry);\n\n  const result = await group(\n    {\n      layout: (): Promise<TargetInfo | symbol> =>\n        select({\n          message: 'What do you want to customize?',\n          options: [\n            {\n              label: 'Docs Layout',\n              value: {\n                id: 'docs',\n                targets: [{ subRegistry, name: 'layouts/docs' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/docs', '@/layouts/docs'],\n                    ['fumadocs-ui/layouts/docs/page', '@/layouts/docs/page'],\n                  ),\n              },\n              hint: 'the default docs layout',\n            },\n            {\n              label: 'Notebook Layout',\n              value: {\n                id: 'notebook',\n                targets: [{ subRegistry, name: 'layouts/notebook' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/notebook', '@/layouts/notebook'],\n                    ['fumadocs-ui/layouts/notebook/page', '@/layouts/notebook/page'],\n                  ),\n              },\n              hint: 'a more compact version of docs layout',\n            },\n            {\n              label: 'Flux Layout',\n              value: {\n                id: 'flux',\n                targets: [{ subRegistry, name: 'layouts/flux' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/flux', '@/layouts/flux'],\n                    ['fumadocs-ui/layouts/flux/page', '@/layouts/flux/page'],\n                  ),\n              },\n              hint: 'the experimental variant of docs layout',\n            },\n            {\n              label: 'Glass Layout',\n              value: {\n                id: 'glass',\n                targets: [{ subRegistry, name: 'layouts/glass' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/glass', '@/layouts/glass'],\n                    ['fumadocs-ui/layouts/glass/page', '@/layouts/glass/page'],\n                  ),\n              },\n              hint: 'a docs layout with floating, translucent panels',\n            },\n            ...(config.uiLibrary === 'base-ui'\n              ? [\n                  {\n                    label: 'Spacious Layout',\n                    value: {\n                      id: 'spacious',\n                      targets: [{ subRegistry, name: 'layouts/spacious' }],\n                      print: () =>\n                        printLayout(\n                          config,\n                          ['fumadocs-ui/layouts/spacious', '@/layouts/spacious'],\n                          ['fumadocs-ui/layouts/spacious/page', '@/layouts/spacious/page'],\n                        ),\n                    },\n                    hint: 'a docs layout with the page in an inset panel, Base UI only',\n                  },\n                ]\n              : []),\n            {\n              label: 'Home Layout',\n              value: {\n                id: 'home',\n                targets: [{ subRegistry, name: 'layouts/home' }],\n                print: () => printLayout(config, ['fumadocs-ui/layouts/home', '@/layouts/home']),\n              },\n              hint: 'the layout for other non-docs pages',\n            },\n          ],\n        }),\n      target: (v): Promise<TargetInfo | symbol> => {\n        const selected = v.results.layout!;\n        if (selected.id === 'home') return Promise.resolve(selected);\n\n        const slots: Option<TargetInfo>[] = [];\n        const prefix = `layouts/${selected.id}/`;\n        for (const { name: id } of manifest.components) {\n          // <layout>/slots/<name> or <layout>/page/slots/<name>\n          const [dir, name] = id.startsWith(prefix) ? id.slice(prefix.length).split('slots/') : [];\n          if (name === undefined) continue;\n          const isPage = dir === 'page/';\n\n          slots.push({\n            label: `${isPage ? 'Page' : 'Layout'}: ${name}`,\n            hint: `only replace a part of layout${isPage ? \"'s page\" : ''}, useful for adjusting details`,\n            value: {\n              id,\n              targets: [{ subRegistry, name: id }],\n              print() {\n                printSlot({\n                  at: `@/${id}`,\n                  layoutId: selected.id,\n                  name,\n                  isPage,\n                  uiLibrary: config.uiLibrary,\n                });\n              },\n            },\n          });\n        }\n\n        return select<TargetInfo>({\n          message: 'Which part do you want to customize?',\n          options: [\n            {\n              label: 'All',\n              hint: 'install the entire layout',\n              value: selected,\n            },\n            {\n              label: 'Replace & rewrite from minimal styles',\n              hint: 'for those who want to build their own UI from ground up',\n              value: {\n                id: 'docs-min',\n                targets: [{ name: 'layouts/docs-min' }],\n                print: () =>\n                  printLayout(\n                    config,\n                    ['fumadocs-ui/layouts/docs', '@/layouts/docs'],\n                    ['fumadocs-ui/layouts/docs/page', '@/layouts/docs/page'],\n                  ),\n              },\n            },\n            ...slots,\n          ],\n        });\n      },\n    },\n    {\n      onCancel: () => {\n        cancel('Installation Stopped.');\n        process.exit(0);\n      },\n    },\n  );\n\n  const targetInfo = result.target as TargetInfo;\n  for (const target of targetInfo.targets) {\n    await installer.installInteractive(target.name, target.subRegistry);\n  }\n\n  await targetInfo.print?.();\n\n  outro(picocolors.bold('Have fun!'));\n}\n\n/** point the imports of route files at the installed layouts */\nexport async function rewriteLayoutImports(config: LoadedConfig, map: Map<string, string>) {\n  const dir = path.join(config.baseDir, frameworks[config.framework].routesDir);\n  const entries = await fs.readdir(dir, { recursive: true, withFileTypes: true }).catch(() => []);\n  const updated: string[] = [];\n\n  for (const entry of entries) {\n    if (!entry.isFile() || !entry.name.endsWith('.tsx')) continue;\n    const file = path.join(entry.parentPath, entry.name);\n    const source = parseSourceFile(file, await fs.readFile(file, 'utf-8'));\n    for (const node of source.program.body) {\n      if (node.type !== 'ImportDeclaration') continue;\n      const to = map.get(node.source.value);\n      if (to) source.s.overwrite(node.source.start + 1, node.source.end - 1, to);\n    }\n    if (!source.s.hasChanged()) continue;\n    await source.save();\n    updated.push(file);\n  }\n\n  return updated;\n}\n\nasync function printLayout(config: LoadedConfig, ...maps: [from: string, to: string][]) {\n  intro(picocolors.bold('What is Next?'));\n  const updated = await rewriteLayoutImports(config, new Map(maps));\n\n  log.info(\n    [\n      'You can check the installed layouts in `layouts` folder.',\n      picocolors.dim('---'),\n      updated.length > 0\n        ? `Updated the imports of ${updated.join(', ')}.`\n        : 'Open your `layout.tsx` files, replace the imports of components:',\n      ...maps.map(([from, to]) => picocolors.greenBright(`\"${from}\" -> \"${to}\"`)),\n    ].join('\\n'),\n  );\n}\n\nfunction printSlot({ at, layoutId, name, isPage, uiLibrary }: SlotPrintInfo) {\n  intro(picocolors.bold('What is Next?'));\n\n  log.info(`You can check the installed layout slot in \"${at}\".`);\n\n  const slot = getSlot({ layoutId, name, isPage, uiLibrary });\n  if (!slot) return;\n\n  const [imports, value] = slot;\n  // every layout names its components `DocsLayout` and `DocsPage`\n  const component = isPage ? 'DocsPage' : 'DocsLayout';\n  log.info(`${picocolors.bold(`At your <${component} /> component, update your \"slots\" prop:`)}\n\nimport { ${imports} } from '${at}';\n\nreturn (\n  <${component}\n    slots={{\n      ${value},\n    }}\n  >\n    ...\n  </${component}>\n);`);\n}\n\n/** the names to import from slot file, and the entry of `slots` prop */\nfunction getSlot({\n  layoutId,\n  name,\n  isPage,\n  uiLibrary,\n}: Omit<SlotPrintInfo, 'at'>): [imports: string, value: string] | undefined {\n  if (isPage) {\n    // Glass layout wires its page slots directly, only layout-level slots are swappable.\n    if (layoutId === 'glass') return;\n\n    switch (name) {\n      case 'toc':\n        if (layoutId === 'flux')\n          return [\n            'TOCProvider, TOC',\n            `toc: {\n        provider: TOCProvider,\n        main: TOC,\n      }`,\n          ];\n        if (layoutId === 'spacious')\n          return [\n            'TOCProvider, TOC, TOCPopover, TOCDropdown',\n            `toc: {\n        provider: TOCProvider,\n        main: TOC,\n        popover: TOCPopover,\n        dropdown: TOCDropdown,\n      }`,\n          ];\n        return [\n          'TOCProvider, TOC, TOCPopover',\n          `toc: {\n        provider: TOCProvider,\n        main: TOC,\n        popover: TOCPopover,\n      }`,\n        ];\n      case 'container':\n        return ['Container', 'container: Container'];\n      case 'footer':\n        return ['Footer', 'footer: Footer'];\n      case 'breadcrumb':\n        return ['Breadcrumb', 'breadcrumb: Breadcrumb'];\n      default:\n        return;\n    }\n  }\n\n  switch (name) {\n    case 'sidebar':\n      if (layoutId === 'glass') {\n        // the slot file holds the whole sidebar system, Base UI additionally exposes a `drawerHandle` for its swipeable drawer\n        const drawerHandle = uiLibrary === 'base-ui';\n        return [\n          `Sidebar, SidebarDrawer, SidebarProvider, useSidebar${drawerHandle ? ', drawerHandle' : ''}`,\n          `sidebar: {\n        main: Sidebar,\n        provider: SidebarProvider,\n        use: useSidebar,\n        drawer: SidebarDrawer,${drawerHandle ? '\\n        drawerHandle,' : ''}\n      }`,\n        ];\n      }\n      if (layoutId === 'spacious')\n        return [\n          'Sidebar, SidebarDrawer, SidebarProvider',\n          `sidebar: {\n        provider: SidebarProvider,\n        main: Sidebar,\n        drawer: SidebarDrawer,\n      }`,\n        ];\n      if (layoutId === 'notebook')\n        return [\n          'SidebarProvider, Sidebar, SidebarTrigger, SidebarCollapseTrigger, useSidebar',\n          `sidebar: {\n        provider: SidebarProvider,\n        root: Sidebar,\n        trigger: SidebarTrigger,\n        collapseTrigger: SidebarCollapseTrigger,\n        useSidebar: useSidebar,\n      }`,\n        ];\n      return [\n        'SidebarProvider, Sidebar, SidebarTrigger, useSidebar',\n        `sidebar: {\n        provider: SidebarProvider,\n        root: Sidebar,\n        trigger: SidebarTrigger,\n        useSidebar: useSidebar,\n      }`,\n      ];\n    case 'header':\n      return ['Header', 'header: Header'];\n    case 'container':\n      return ['Container', 'container: Container'];\n    case 'tab-dropdown':\n      return ['TabDropdown', 'tabDropdown: TabDropdown'];\n    case 'actions':\n      return ['HeaderActions', 'actions: HeaderActions'];\n    default:\n      return;\n  }\n}\n","import { isCancel as isCancelSymbol } from '@clack/prompts';\n\n/**\n * `@clack/core` narrows to its own `unique symbol`, which can't exclude the wider `symbol` that\n * `@clack/prompts` returns, so a prompt result never narrows without this.\n */\nexport function isCancel<T>(value: T | symbol): value is symbol {\n  return isCancelSymbol(value);\n}\n","import { autocompleteMultiselect, outro, spinner } from '@clack/prompts';\nimport { isCancel } from '@/utils/prompt';\nimport picocolors from 'picocolors';\nimport { UIRegistries } from '@/commands/shared';\nimport { RegistryConnector } from 'fuma-cli/registry/connector';\nimport { LoadedConfig } from '@/config';\nimport { FumadocsComponentInstaller } from '@/registry/installer';\n\ninterface AddOption {\n  label: string;\n  value: Target;\n  hint?: string;\n}\n\nexport interface Target {\n  name: string;\n  subRegistry?: string;\n}\n\nexport async function add(input: string[], connector: RegistryConnector, config: LoadedConfig) {\n  let targets: Target[];\n  const installer = new FumadocsComponentInstaller(connector, config);\n  const subRegistry = UIRegistries[config.uiLibrary];\n\n  if (input.length === 0) {\n    const spin = spinner();\n    spin.start('fetching registry');\n\n    async function scan(subRegistry?: string, prefix?: string): Promise<AddOption[]> {\n      const manifest = await installer.fetchManifest(subRegistry);\n      const options: AddOption[] = [];\n\n      for (const item of manifest.components) {\n        if (item.unlisted) continue;\n        options.push({\n          label: `${prefix ? `${picocolors.bold(prefix)} - ` : ''}${item.title ?? item.name}`,\n          value: { name: item.name, subRegistry },\n          hint: item.description,\n        });\n      }\n      return options;\n    }\n\n    const groups = await Promise.all([\n      scan(undefined, 'common'),\n      scan('sanity', 'sanity'),\n      scan('openapi', 'openapi'),\n      scan('api-docs', 'api-docs'),\n      scan(subRegistry, 'ui'),\n    ]);\n\n    spin.stop(picocolors.bold(picocolors.greenBright('registry fetched')));\n    const value = await autocompleteMultiselect({\n      message: 'Select components to install',\n      options: groups.flat().sort((a, b) => a.label.localeCompare(b.label)),\n    });\n\n    if (isCancel(value)) {\n      outro('Ended');\n      return;\n    }\n\n    targets = value;\n  } else {\n    const root = new Set<string>();\n    for (const item of (await installer.fetchManifest()).components) root.add(item.name);\n    targets = input.map((name) => (root.has(name) ? { name } : { subRegistry, name }));\n  }\n\n  for (const target of targets) {\n    await installer.installInteractive(target.name, target.subRegistry);\n  }\n\n  outro(picocolors.bold(picocolors.greenBright('Successful')));\n}\n","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { exists } from '@/utils/fs';\nimport picocolors from 'picocolors';\nimport { spinner } from '@clack/prompts';\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\n\nconst execAsync = promisify(exec);\n\ninterface PackageJson {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n}\n\nasync function readPackageJson(cwd: string): Promise<PackageJson | null> {\n  try {\n    const raw = await fs.readFile(path.join(cwd, 'package.json'), 'utf-8');\n    return JSON.parse(raw) as PackageJson;\n  } catch {\n    return null;\n  }\n}\n\n/** Path of pre-rendered EPUB, choose one according to your React framework. Next.js fetches from the running server instead. */\nconst EPUB_BUILD_PATHS: Record<string, string> = {\n  next: '', // Fetched from /export/epub at runtime; route handlers don't produce static files\n  astro: 'dist/export/epub',\n  'tanstack-start': '.output/public/export/epub',\n  'tanstack-start-spa': 'dist/client/export/epub',\n  'react-router': 'build/client/export/epub',\n  'react-router-spa': 'build/client/export/epub',\n  waku: 'dist/public/export/epub',\n};\n\nexport async function exportEpub(options: { output?: string; framework: string }) {\n  const cwd = process.cwd();\n  const outputPath = path.resolve(cwd, options.output ?? 'docs.epub');\n  const framework = options.framework;\n\n  const spin = spinner();\n\n  const buildPath = EPUB_BUILD_PATHS[framework];\n  if (!(framework in EPUB_BUILD_PATHS)) {\n    const valid = Object.keys(EPUB_BUILD_PATHS).join(', ');\n    console.error(picocolors.red(`Invalid --framework \"${framework}\". Must be one of: ${valid}`));\n    process.exit(1);\n  }\n\n  const pkg = await readPackageJson(cwd);\n  // Check for fumadocs-epub dependency\n  if (!pkg) {\n    console.error(\n      picocolors.red('Cannot read or parse package.json. Ensure it exists and is valid JSON.'),\n    );\n    process.exit(1);\n  }\n  const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n  if (!deps['fumadocs-epub']) {\n    console.log(picocolors.yellow('\\nInstalling fumadocs-epub...'));\n    const packageManager = process.env.npm_execpath?.includes('pnpm')\n      ? 'pnpm'\n      : process.env.npm_execpath?.includes('bun')\n        ? 'bun'\n        : 'npm';\n    const installCmd = `${packageManager} add fumadocs-epub`;\n    try {\n      await execAsync(installCmd, { cwd });\n    } catch (err: unknown) {\n      const stderr =\n        err && typeof err === 'object' && 'stderr' in err\n          ? String((err as { stderr?: string }).stderr)\n          : '';\n      console.error(picocolors.red(`Failed to install fumadocs-epub. Command: ${installCmd}`));\n      if (stderr) console.error(stderr);\n      process.exit(1);\n    }\n  }\n\n  if (framework === 'next') {\n    const secret = process.env.EXPORT_SECRET;\n    if (!secret) {\n      console.error(\n        picocolors.red('EXPORT_SECRET is required for Next.js export. Set it in your environment.'),\n      );\n      process.exit(1);\n    }\n    const port = process.env.PORT || '3000';\n    const url = `http://localhost:${port}/export/epub`;\n    spin.start('Fetching EPUB from server');\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), 30_000);\n    try {\n      const res = await fetch(url, {\n        headers: { Authorization: `Bearer ${secret}` },\n        signal: controller.signal,\n      });\n      if (!res.ok) {\n        if (res.status === 401 || res.status === 403) {\n          console.error(\n            picocolors.red('Auth failed. Check that EXPORT_SECRET matches the value in your app.'),\n          );\n        } else if (res.status === 404) {\n          console.error(\n            picocolors.red('Export route not found, run `fumadocs feature epub` to create it.'),\n          );\n        } else {\n          console.error(\n            picocolors.red(\n              `Server returned ${res.status}. Ensure the app is running (e.g. pnpm start) on port ${port}.`,\n            ),\n          );\n        }\n        process.exit(1);\n      }\n      const buffer = Buffer.from(await res.arrayBuffer());\n      await fs.mkdir(path.dirname(outputPath), { recursive: true });\n      await fs.writeFile(outputPath, buffer);\n      spin.stop(picocolors.green(`EPUB saved to ${outputPath}`));\n    } catch (err: unknown) {\n      if (err instanceof Error && err.name === 'AbortError') {\n        console.error(picocolors.red('Request timed out after 30 seconds.'));\n      } else {\n        const msg = err instanceof Error ? err.message : String(err);\n        console.error(picocolors.red(`Could not fetch EPUB: ${msg}`));\n      }\n      console.error(\n        picocolors.yellow(`Ensure the server is running (e.g. pnpm start) on port ${port}.`),\n      );\n      process.exit(1);\n    } finally {\n      clearTimeout(timeoutId);\n    }\n    return;\n  }\n\n  const fullBuildPath = path.join(cwd, buildPath);\n  if (!(await exists(fullBuildPath))) {\n    console.error(\n      picocolors.red(\n        `EPUB not found at ${buildPath}. Run production build first (e.g. pnpm build).`,\n      ),\n    );\n    process.exit(1);\n  }\n\n  spin.start('Copying EPUB');\n  await fs.mkdir(path.dirname(outputPath), { recursive: true });\n  await fs.copyFile(fullBuildPath, outputPath);\n  spin.stop(picocolors.green(`EPUB saved to ${outputPath}`));\n}\n","import type { CAC, Command } from 'cac';\nimport { cancel, confirm, intro, log, note, outro, select, spinner } from '@clack/prompts';\nimport { isCancel } from '@/utils/prompt';\nimport picocolors from 'picocolors';\nimport type { RegistryConnector } from 'fuma-cli/registry/connector';\nimport { createOrLoadConfig } from '@/config';\nimport { loadProject } from '@/project';\nimport { type AnyFeature, type FeatureIO, runFeature } from '@/features';\nimport { features } from '@/features/all';\n\ninterface CommandOptions extends Record<string, string | boolean | undefined> {\n  config?: string;\n  dir?: string;\n  yes?: boolean;\n  install?: boolean;\n}\n\nexport function registerFeatureCommands(\n  cli: CAC,\n  createConnector: (dir?: string) => RegistryConnector,\n) {\n  const ids = features.map((feature) => feature.id).join(', ');\n\n  register(\n    cli.command('feature <id>', `configure a feature on your project (${ids})`),\n    features,\n  ).action(async (id: string, options: CommandOptions) => {\n    const feature = features.find((item) => item.id === id);\n    if (!feature) throw new Error(`unknown feature: ${id}, available: ${ids}`);\n\n    await run(feature, options, createConnector(options.dir));\n  });\n\n  register(cli.command('init', 'set up Fumadocs on an existing app, same as `feature docs`'), [\n    features[0],\n  ]).action(async (options: CommandOptions) => {\n    await run(features[0], options, createConnector(options.dir));\n  });\n}\n\nfunction register(command: Command, list: AnyFeature[]) {\n  command\n    .option('--dir <string>', 'the root url or directory to resolve registry')\n    .option('-y, --yes', 'skip prompts, overwrite existing files')\n    .option('--no-install', 'write dependencies to package.json without installing');\n\n  for (const feature of list) {\n    for (const [key, option] of Object.entries(feature.options ?? {})) {\n      if ('choices' in option) {\n        command.option(\n          `--${key} <value>`,\n          `${option.message} (${option.choices.map((choice) => choice.value).join(', ')})`,\n        );\n      } else {\n        command.option(`--${key}`, option.message);\n      }\n    }\n  }\n\n  return command;\n}\n\nasync function run(feature: AnyFeature, options: CommandOptions, connector: RegistryConnector) {\n  intro(picocolors.bgBlack(picocolors.whiteBright(feature.title)));\n  const config = await createOrLoadConfig(options.config);\n  const project = await loadProject(config);\n  log.info(`${project.framework}${project.static ? ' (static)' : ''}, ${project.packageManager}`);\n\n  const values: Record<string, unknown> = {};\n  for (const [key, option] of Object.entries(feature.options ?? {})) {\n    const given = options[key];\n    if ('choices' in option) {\n      if (given !== undefined) {\n        if (!option.choices.some((choice) => choice.value === given))\n          throw new Error(`invalid value for --${key}: ${given}`);\n        values[key] = given;\n        continue;\n      }\n\n      const value = await select({ message: option.message, options: option.choices });\n      if (isCancel(value)) {\n        cancel('Stopped.');\n        process.exit(0);\n      }\n      values[key] = value;\n    } else if (given !== undefined) {\n      values[key] = given === true;\n    } else if (options.yes) {\n      values[key] = option.initialValue ?? false;\n    } else {\n      const value = await confirm({ message: option.message, initialValue: option.initialValue });\n      if (isCancel(value)) {\n        cancel('Stopped.');\n        process.exit(0);\n      }\n      values[key] = value;\n    }\n  }\n\n  const spin = spinner();\n  const io: FeatureIO = {\n    installDependencies: options.install !== false,\n    log: (message) => spin.message(message),\n    async confirmOverwrite(file) {\n      if (options.yes) return true;\n      spin.clear();\n      const value = await confirm({ message: `Overwrite ${file}?`, initialValue: false });\n      if (isCancel(value)) {\n        cancel('Stopped.');\n        process.exit(0);\n      }\n      spin.start();\n      return value;\n    },\n  };\n\n  spin.start(`Applying ${feature.title}`);\n  try {\n    const { notes } = await runFeature(feature, values, { project, connector, io });\n    spin.stop(`${feature.title} applied`);\n    if (notes.length > 0) note(notes.join('\\n\\n'), 'What is Next?');\n  } catch (e) {\n    spin.error(e instanceof Error ? e.message : String(e));\n    process.exit(1);\n  }\n  outro(picocolors.bold(picocolors.greenBright('Done')));\n}\n","#!/usr/bin/env node\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { cac } from 'cac';\nimport picocolors from 'picocolors';\nimport { createOrLoadConfig, initConfig } from '@/config';\nimport { type JsonTreeNode, treeToJavaScript, treeToMdx } from '@/commands/file-tree';\nimport { runTree } from '@/utils/file-tree/run-tree';\nimport packageJson from '../package.json';\nimport { customise } from '@/commands/customise';\nimport { add } from '@/commands/add';\nimport { exportEpub } from '@/commands/export-epub';\nimport { registerFeatureCommands } from '@/commands/feature';\nimport { HttpRegistryConnector, LocalRegistryConnector } from 'fuma-cli/registry/connector';\n\nconst cli = cac('fumadocs');\ncli.option('--config <string>', 'path to the config file');\n\ncli.command('', 'init a `cli.json` config file').action(async () => {\n  if (await initConfig()) {\n    console.log(picocolors.green('Initialized a `./cli.json` config file.'));\n  } else {\n    console.log(picocolors.redBright('A config file already exists.'));\n  }\n});\n\ncli\n  .command('customise', 'simple way to customize layouts with Fumadocs UI')\n  .alias('customize')\n  .option('--dir <string>', 'the root url or directory to resolve registry')\n  .action(async (options: { config?: string; dir?: string }) => {\n    const config = await createOrLoadConfig(options.config);\n    await customise(config, createClientFromDir(options.dir));\n  });\n\nconst dirShortcuts: Record<string, string> = {\n  ':preview': 'https://preview.fumadocs.dev/registry',\n  ':dev': 'http://localhost:3000/registry',\n};\n\ncli\n  .command('add [...components]', 'add a new component to your docs')\n  .option('--dir <string>', 'the root url or directory to resolve registry')\n  .action(async (input: string[], options: { config?: string; dir?: string }) => {\n    const config = await createOrLoadConfig(options.config);\n    const client = createClientFromDir(options.dir);\n    await add(input, client, config);\n  });\n\nregisterFeatureCommands(cli, createClientFromDir);\n\ncli\n  .command(\n    'export <format>',\n    'export documentation to various formats (run after production build)',\n  )\n  .option('--framework <name>', 'framework: next, astro, tanstack-start, react-router, waku')\n  .option('--output <path>', 'output file path', { default: 'docs.epub' })\n  .action(async (format: string, options: { framework?: string; output: string }) => {\n    if (format !== 'epub')\n      throw new Error(`unsupported format: ${format}, only \\`epub\\` is supported.`);\n    if (!options.framework) throw new Error('option `--framework <name>` is required.');\n\n    await exportEpub({ framework: options.framework, output: options.output });\n  });\n\ncli\n  .command(\n    'tree [json_or_args] [output]',\n    'generate a file tree for the Files component, from a directory or JSON output of `tree`',\n  )\n  .option('--js', 'output as JavaScript file')\n  .option('--no-root', 'remove the root node')\n  .option('--import-name <name>', 'where to import components (JS only)')\n  .action(\n    async (\n      str: string | undefined,\n      output: string | undefined,\n      { js, root, importName }: { js: boolean; root: boolean; importName?: string },\n    ) => {\n      const jsExtensions = ['.js', '.tsx', '.jsx'];\n      const noRoot = !root;\n      let nodes: JsonTreeNode[];\n\n      try {\n        nodes = JSON.parse(str ?? '') as JsonTreeNode[];\n      } catch {\n        nodes = await runTree(str ?? './');\n      }\n\n      const out =\n        js || (output && jsExtensions.includes(path.extname(output)))\n          ? treeToJavaScript(nodes, noRoot, importName)\n          : treeToMdx(nodes, noRoot);\n\n      if (output) {\n        await fs.mkdir(path.dirname(output), { recursive: true });\n        await fs.writeFile(output, out);\n      } else {\n        console.log(out);\n      }\n    },\n  );\n\nfunction createClientFromDir(dir = 'https://fumadocs.dev/registry') {\n  if (dir in dirShortcuts) dir = dirShortcuts[dir];\n\n  return dir.startsWith('http://') || dir.startsWith('https://')\n    ? new HttpRegistryConnector(dir)\n    : new LocalRegistryConnector(dir);\n}\n\ncli.help();\ncli.version(packageJson.version);\n\ntry {\n  cli.parse(process.argv, { run: false });\n  await cli.runMatchedCommand();\n} catch (e) {\n  console.error(picocolors.redBright(e instanceof Error ? e.message : String(e)));\n  process.exit(1);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fumadocs/cli",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "description": "The CLI tool for Fumadocs",
   "keywords": [
     "Docs",
@@ -49,14 +49,14 @@
     "@fuma-cli/interactive": "^0.1.2",
     "cac": "^7.0.0",
     "fuma-cli": "^0.3.1",
-    "magic-string": "^1.4.1",
-    "oxc-parser": "^0.150.0",
+    "magic-string": "^1.4.2",
+    "oxc-parser": "^0.152.0",
     "picocolors": "^1.1.1",
     "tinyexec": "^1.3.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@types/node": "26.6.1",
+    "@types/node": "26.6.4",
     "tsconfig": "0.0.0",
     "tsdown": "0.23.0"
   },

package/dist/ai-C19ZOP53.js

@@ -1,100 +0,0 @@
-import { E as prependJsxChildren, b as findJsxElement, p as addImport } from "./codemod-auol-p4R.js";
-import { t as docs } from "./docs--WqEHTyl.js";
-import { r as findSource } from "./utils-DbMe7h6c.js";
-import path from "node:path";
-//#region src/features/ai.ts
-const providers = {
-	openrouter: {
-		label: "AI SDK",
-		hint: "default to OpenRouter",
-		env: "OPENROUTER_API_KEY"
-	},
-	llmgateway: {
-		label: "LLMGateway",
-		hint: "open-source LLM gateway, API key required",
-		env: "LLM_GATEWAY_API_KEY"
-	},
-	inkeep: {
-		label: "Inkeep AI",
-		hint: "API key required",
-		env: "INKEEP_API_KEY"
-	}
-};
-const ai = {
-	id: "ai",
-	title: "AI Chat",
-	description: "Ask AI dialog for your docs",
-	requires: [docs],
-	options: { provider: {
-		message: "Choose an AI provider",
-		choices: Object.entries(providers).map(([value, { label, hint }]) => ({
-			value,
-			label,
-			hint
-		}))
-	} },
-	supports: (project) => project.static ? "AI chat requires a server to run the chat route handler." : true,
-	async apply(ctx, { provider }) {
-		await ctx.install(`ai/${provider}`);
-		ctx.env(providers[provider].env, "");
-		if (ctx.project.source.dynamic) await readDynamicSource(ctx);
-		const { cwd, baseDir, info } = ctx.project;
-		const layout = await findSource(cwd, path.join(baseDir, info.routesDir), "<DocsLayout");
-		if (!(layout !== void 0 && await ctx.source(layout, (file) => {
-			if (file.code.includes("<AISearch")) return;
-			const element = findJsxElement(file, "DocsLayout");
-			if (!element) return;
-			prependJsxChildren(file, element, `<AISearch>
-  <AISearchPanel />
-  <AISearchTrigger
-    position="float"
-    className={cn(
-      buttonVariants({
-        variant: 'secondary',
-        className: 'text-fd-muted-foreground rounded-2xl',
-      }),
-    )}
-  >
-    <MessageCircleIcon className="size-4.5" />
-    Ask AI
-  </AISearchTrigger>
-</AISearch>`);
-			addImport(file, {
-				from: "@/components/ai/search",
-				named: [
-					"AISearch",
-					"AISearchPanel",
-					"AISearchTrigger"
-				]
-			});
-			addImport(file, {
-				from: "lucide-react",
-				named: ["MessageCircleIcon"]
-			});
-			addImport(file, {
-				from: "@/lib/cn",
-				named: ["cn"]
-			});
-			addImport(file, {
-				from: "fumadocs-ui/components/ui/button",
-				named: ["buttonVariants"]
-			});
-		}))) ctx.note("Add `<AISearch>` from `@/components/ai/search` to your docs layout, see https://fumadocs.dev/docs/integrations/llms#ask-ai.");
-		ctx.note(`Set ${providers[provider].env} in \`.env.local\`.`);
-	}
-};
-/** the installed chat route indexes pages of a static `source`, runtime sources resolve on demand */
-async function readDynamicSource(ctx) {
-	const { cwd, baseDir } = ctx.project;
-	const route = await findSource(cwd, baseDir, "createSearchServer");
-	if (!(route !== void 0 && await ctx.source(route, (file) => {
-		file.s.replaceAll("import { source } from '@/lib/source';", "import { getSource } from '@/lib/source';");
-		file.s.replaceAll("source.getPages()", "(await getSource()).getPages()");
-		file.s.replaceAll("      if (!('getText' in page.data)) return null;\n\n", "");
-		file.s.replaceAll("await page.data.getText('processed')", "page.data.content");
-	}))) ctx.note("Read pages from `getSource()` in the chat route, the search index is built from `page.data.content`.");
-}
-//#endregion
-export { ai as t };
-
-//# sourceMappingURL=ai-C19ZOP53.js.map

package/dist/ai-C19ZOP53.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-C19ZOP53.js","names":[],"sources":["../src/features/ai.ts"],"sourcesContent":["import path from 'node:path';\nimport type { Feature, FeatureContext } from '@/features';\nimport { findSource } from './utils';\nimport { addImport, findJsxElement, prependJsxChildren } from '@/codemod';\nimport { docs } from './docs';\n\nconst providers = {\n  openrouter: { label: 'AI SDK', hint: 'default to OpenRouter', env: 'OPENROUTER_API_KEY' },\n  llmgateway: {\n    label: 'LLMGateway',\n    hint: 'open-source LLM gateway, API key required',\n    env: 'LLM_GATEWAY_API_KEY',\n  },\n  inkeep: { label: 'Inkeep AI', hint: 'API key required', env: 'INKEEP_API_KEY' },\n};\n\nexport type AIProvider = keyof typeof providers;\n\nexport const ai: Feature<{ provider: AIProvider }> = {\n  id: 'ai',\n  title: 'AI Chat',\n  description: 'Ask AI dialog for your docs',\n  requires: [docs],\n  options: {\n    provider: {\n      message: 'Choose an AI provider',\n      choices: Object.entries(providers).map(([value, { label, hint }]) => ({\n        value: value as AIProvider,\n        label,\n        hint,\n      })),\n    },\n  },\n  supports: (project) =>\n    project.static ? 'AI chat requires a server to run the chat route handler.' : true,\n  async apply(ctx, { provider }) {\n    await ctx.install(`ai/${provider}`);\n    ctx.env(providers[provider].env, '');\n    if (ctx.project.source.dynamic) await readDynamicSource(ctx);\n\n    const { cwd, baseDir, info } = ctx.project;\n    const layout = await findSource(cwd, path.join(baseDir, info.routesDir), '<DocsLayout');\n    const edited =\n      layout !== undefined &&\n      (await ctx.source(layout, (file) => {\n        if (file.code.includes('<AISearch')) return;\n        const element = findJsxElement(file, 'DocsLayout');\n        if (!element) return;\n\n        prependJsxChildren(\n          file,\n          element,\n          `<AISearch>\n  <AISearchPanel />\n  <AISearchTrigger\n    position=\"float\"\n    className={cn(\n      buttonVariants({\n        variant: 'secondary',\n        className: 'text-fd-muted-foreground rounded-2xl',\n      }),\n    )}\n  >\n    <MessageCircleIcon className=\"size-4.5\" />\n    Ask AI\n  </AISearchTrigger>\n</AISearch>`,\n        );\n        addImport(file, {\n          from: '@/components/ai/search',\n          named: ['AISearch', 'AISearchPanel', 'AISearchTrigger'],\n        });\n        addImport(file, { from: 'lucide-react', named: ['MessageCircleIcon'] });\n        addImport(file, { from: '@/lib/cn', named: ['cn'] });\n        addImport(file, { from: 'fumadocs-ui/components/ui/button', named: ['buttonVariants'] });\n      }));\n\n    if (!edited) {\n      ctx.note(\n        'Add `<AISearch>` from `@/components/ai/search` to your docs layout, see https://fumadocs.dev/docs/integrations/llms#ask-ai.',\n      );\n    }\n    ctx.note(`Set ${providers[provider].env} in \\`.env.local\\`.`);\n  },\n};\n\n/** the installed chat route indexes pages of a static `source`, runtime sources resolve on demand */\nasync function readDynamicSource(ctx: FeatureContext) {\n  const { cwd, baseDir } = ctx.project;\n  const route = await findSource(cwd, baseDir, 'createSearchServer');\n  const edited =\n    route !== undefined &&\n    (await ctx.source(route, (file) => {\n      file.s.replaceAll(\n        \"import { source } from '@/lib/source';\",\n        \"import { getSource } from '@/lib/source';\",\n      );\n      file.s.replaceAll('source.getPages()', '(await getSource()).getPages()');\n      // every page of a runtime source carries its Markdown\n      file.s.replaceAll(\"      if (!('getText' in page.data)) return null;\\n\\n\", '');\n      file.s.replaceAll(\"await page.data.getText('processed')\", 'page.data.content');\n    }));\n\n  if (!edited)\n    ctx.note(\n      'Read pages from `getSource()` in the chat route, the search index is built from `page.data.content`.',\n    );\n}\n"],"mappings":";;;;;AAMA,MAAM,YAAY;CAChB,YAAY;EAAE,OAAO;EAAU,MAAM;EAAyB,KAAK;CAAqB;CACxF,YAAY;EACV,OAAO;EACP,MAAM;EACN,KAAK;CACP;CACA,QAAQ;EAAE,OAAO;EAAa,MAAM;EAAoB,KAAK;CAAiB;AAChF;AAIA,MAAa,KAAwC;CACnD,IAAI;CACJ,OAAO;CACP,aAAa;CACb,UAAU,CAAC,IAAI;CACf,SAAS,EACP,UAAU;EACR,SAAS;EACT,SAAS,OAAO,QAAQ,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,aAAa;GAC7D;GACP;GACA;EACF,EAAE;CACJ,EACF;CACA,WAAW,YACT,QAAQ,SAAS,6DAA6D;CAChF,MAAM,MAAM,KAAK,EAAE,YAAY;EAC7B,MAAM,IAAI,QAAQ,MAAM,UAAU;EAClC,IAAI,IAAI,UAAU,SAAS,CAAC,KAAK,EAAE;EACnC,IAAI,IAAI,QAAQ,OAAO,SAAS,MAAM,kBAAkB,GAAG;EAE3D,MAAM,EAAE,KAAK,SAAS,SAAS,IAAI;EACnC,MAAM,SAAS,MAAM,WAAW,KAAK,KAAK,KAAK,SAAS,KAAK,SAAS,GAAG,aAAa;EAoCtF,IAAI,EAlCF,WAAW,KAAA,KACV,MAAM,IAAI,OAAO,SAAS,SAAS;GAClC,IAAI,KAAK,KAAK,SAAS,WAAW,GAAG;GACrC,MAAM,UAAU,eAAe,MAAM,YAAY;GACjD,IAAI,CAAC,SAAS;GAEd,mBACE,MACA,SACA;;;;;;;;;;;;;;YAeF;GACA,UAAU,MAAM;IACd,MAAM;IACN,OAAO;KAAC;KAAY;KAAiB;IAAiB;GACxD,CAAC;GACD,UAAU,MAAM;IAAE,MAAM;IAAgB,OAAO,CAAC,mBAAmB;GAAE,CAAC;GACtE,UAAU,MAAM;IAAE,MAAM;IAAY,OAAO,CAAC,IAAI;GAAE,CAAC;GACnD,UAAU,MAAM;IAAE,MAAM;IAAoC,OAAO,CAAC,gBAAgB;GAAE,CAAC;EACzF,CAAC,IAGD,IAAI,KACF,6HACF;EAEF,IAAI,KAAK,OAAO,UAAU,SAAS,CAAC,IAAI,oBAAoB;CAC9D;AACF;;AAGA,eAAe,kBAAkB,KAAqB;CACpD,MAAM,EAAE,KAAK,YAAY,IAAI;CAC7B,MAAM,QAAQ,MAAM,WAAW,KAAK,SAAS,oBAAoB;CAcjE,IAAI,EAZF,UAAU,KAAA,KACT,MAAM,IAAI,OAAO,QAAQ,SAAS;EACjC,KAAK,EAAE,WACL,0CACA,2CACF;EACA,KAAK,EAAE,WAAW,qBAAqB,gCAAgC;EAEvE,KAAK,EAAE,WAAW,yDAAyD,EAAE;EAC7E,KAAK,EAAE,WAAW,wCAAwC,mBAAmB;CAC/E,CAAC,IAGD,IAAI,KACF,sGACF;AACJ"}