@fumadocs/cli 1.5.0 → 1.6.1

package/dist/docs--WqEHTyl.js

@@ -0,0 +1,738 @@
+import { b as findJsxElement, d as wrapNextConfig, l as addVitePlugin, m as addJsxAttribute, p as addImport } from "./codemod-auol-p4R.js";
+import { t as exists } from "./fs-D6J9dOEx.js";
+import { a as reactFramework, o as reactOnly, s as registerReactRouterRoutes } from "./utils-DbMe7h6c.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+//#region src/project/route.ts
+const conventions = {
+	next: {
+		locale: () => "[lang]",
+		param: (name, catchAll, optional) => catchAll ? optional ? `[[...${name}]]` : `[...${name}]` : `[${name}]`,
+		file: (segments, ext) => `app/${segments.join("/")}/route.${ext}`,
+		path: (segments) => `/${segments.join("/")}`
+	},
+	"react-router": {
+		locale: (optional) => optional ? ":lang?" : ":lang",
+		param: (name, catchAll) => catchAll ? "*" : `:${name}`,
+		file: (segments, ext) => `routes/${segments.filter((segment) => !/^[:*]/.test(segment)).join(".")}.${ext}`,
+		path: (segments) => segments.join("/")
+	},
+	"tanstack-start": {
+		locale: (optional) => optional ? "{-$lang}" : "$lang",
+		param: (name, catchAll) => catchAll ? "$" : `$${name}`,
+		file: (segments, ext) => `routes/${segments.join("/").replaceAll(".", "[.]")}.${ext}`,
+		path: (segments) => `/${segments.join("/")}`
+	},
+	waku: {
+		locale: () => "[lang]",
+		param: (name, catchAll, _optional, suffix) => catchAll ? `[...${name}]${suffix ? `/${suffix}` : ""}` : `[${name}]`,
+		file: (segments, ext) => `pages/_api/${segments.join("/")}.${ext}`,
+		path: (segments) => `/${segments.join("/")}`
+	}
+};
+/** the locale segment of route files, with a trailing slash */
+function localeSegment(framework, i18n) {
+	return i18n ? `${conventions[framework].locale(i18n.optionalLocale)}/` : "";
+}
+function formatRoute(route, framework, i18n, ext = "ts") {
+	const convention = conventions[framework];
+	const segments = [];
+	const patterns = [];
+	if (route.locale && i18n) {
+		segments.push(convention.locale(i18n.optionalLocale));
+		patterns.push(":lang");
+	}
+	for (const segment of route.segments) if (typeof segment === "string") for (const part of segment.split("/")) {
+		if (part.length === 0) continue;
+		segments.push(part);
+		patterns.push(part);
+	}
+	else {
+		const { param, catchAll = false, optional = false, suffix } = segment;
+		segments.push(convention.param(param, catchAll, optional, suffix));
+		patterns.push(catchAll ? `:${param}*` : `:${param}`);
+	}
+	return {
+		file: convention.file(segments, ext),
+		path: convention.path(segments),
+		pattern: `/${patterns.join("/")}`
+	};
+}
+/** the route module of a handler that only reads the request, per framework */
+function routeModule(framework, route, mod) {
+	const { imports, body, request, methods = ["GET"], revalidate, static: isStatic } = mod;
+	const arg = request ? "request: Request" : "";
+	const head = `${imports.trim()}\n\n`;
+	if (framework === "react-router") {
+		const out = [];
+		out.push(handler("loader", "Route.LoaderArgs"));
+		if (methods.length > 1) out.push(handler("action", "Route.ActionArgs"));
+		return `${request ? `${reactRouterTypes(route)}\n` : ""}${head}${out.join("\n")}`;
+	}
+	if (framework === "tanstack-start") {
+		const out = [];
+		for (const method of methods) out.push(`      ${method}: async (${request ? "{ request }" : ""}) => ${body},`);
+		return `import { createFileRoute } from '@tanstack/react-router';
+${head}export const Route = createFileRoute('${route.path}')({
+  server: {
+    handlers: {
+${out.join("\n")}
+    },
+  },
+});
+`;
+	}
+	const out = [];
+	if (framework === "next" && revalidate) out.push("export const revalidate = false;\n");
+	for (const method of methods) out.push(`export async function ${method}(${arg}) {
+  return ${body};
+}
+`);
+	if (framework === "waku" && isStatic) out.push(`export async function getConfig() {
+  return {
+    render: 'static' as const,
+  } as const;
+}
+`);
+	return `${head}${out.join("\n")}`;
+	function handler(name, type) {
+		return `export async function ${name}(${request ? `{ request }: ${type}` : ""}) {
+  return ${body};
+}
+`;
+	}
+}
+/** import of the generated types of a React Router route module */
+const reactRouterTypes = (route) => `import type { Route } from './+types/${route.file.split("/").pop().replace(/\.tsx?$/, "")}';`;
+//#endregion
+//#region src/features/docs/templates.ts
+const wrapper = (children) => `<div className="flex flex-col min-h-screen">${children}</div>`;
+const i18nConfig = (optionalLocale) => `import { defineI18n } from 'fumadocs-core/i18n';
+
+export const i18n = defineI18n({
+  defaultLanguage: 'en',
+  languages: ['en', 'cn'],${optionalLocale ? "\n  hideLocale: 'default-locale'," : ""}
+});
+`;
+const sharedConstants = `export const docsRoute = '/docs';
+`;
+const source = (async, i18n) => `import { loader } from 'fumadocs-core/source';
+import { defineDocs } from 'fumadocs-mdx/macro';
+import { docsRoute } from './shared';
+${i18n ? "import { i18n } from '@/lib/i18n';\n" : ""}
+export const docs = defineDocs({
+  dir: 'content/docs',${async ? "\n  docs: {\n    async: true,\n  }," : ""}
+});
+
+export const source = loader({
+  baseUrl: docsRoute,
+  source: docs.toFumadocsSource(),${i18n ? "\n  i18n," : ""}
+});
+`;
+const layoutShared = (i18n) => i18n ? `import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+import { uiTranslations } from 'fumadocs-ui/i18n';
+import { i18n } from '@/lib/i18n';
+
+export const translations = i18n.translations().extend(uiTranslations());
+
+export function baseOptions(locale: string = i18n.defaultLanguage): BaseLayoutProps {
+  return {
+    nav: {
+      title: 'My App',
+      url: \`/\${locale}\`,
+    },
+  };
+}
+` : `import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+
+export function baseOptions(): BaseLayoutProps {
+  return {
+    nav: {
+      title: 'My App',
+    },
+  };
+}
+`;
+const mdx = `import defaultMdxComponents from 'fumadocs-ui/mdx';
+import type { MDXComponents } from 'mdx/types';
+
+export function getMDXComponents(components?: MDXComponents) {
+  return {
+    ...defaultMdxComponents,
+    ...components,
+  } satisfies MDXComponents;
+}
+
+export const useMDXComponents = getMDXComponents;
+
+declare global {
+  type MDXProvidedComponents = ReturnType<typeof getMDXComponents>;
+}
+`;
+const search = (i18n) => `'use client';
+import {
+  SearchDialog,
+  SearchDialogClose,
+  SearchDialogContent,
+  SearchDialogHeader,
+  SearchDialogIcon,
+  SearchDialogInput,
+  SearchDialogList,
+  SearchDialogOverlay,
+  type SharedProps,
+} from 'fumadocs-ui/components/dialog/search';
+import { useDocsSearch } from 'fumadocs-core/search/client';
+import { staticClient } from 'fumadocs-core/search/client/orama-static';
+${i18n ? "import { useI18n } from 'fumadocs-ui/contexts/i18n';\n" : ""}
+export default function DefaultSearchDialog(props: SharedProps) {
+${i18n ? "  const { locale } = useI18n();\n" : ""}  const { search, setSearch, query } = useDocsSearch({
+    client: staticClient(${i18n ? "{ locale }" : ""}),
+  });
+
+  return (
+    <SearchDialog search={search} onSearchChange={setSearch} isLoading={query.isLoading} {...props}>
+      <SearchDialogOverlay />
+      <SearchDialogContent>
+        <SearchDialogHeader>
+          <SearchDialogIcon />
+          <SearchDialogInput />
+          <SearchDialogClose />
+        </SearchDialogHeader>
+        <SearchDialogList items={query.data !== 'empty' ? query.data : null} />
+      </SearchDialogContent>
+    </SearchDialog>
+  );
+}
+`;
+function shared(input, async) {
+	const i18n = input.i18n !== null;
+	return {
+		"lib/shared.ts": sharedConstants,
+		"lib/source.ts": source(async, i18n),
+		"lib/layout.shared.tsx": layoutShared(i18n),
+		"components/mdx.tsx": mdx,
+		...input.static ? { "components/search.tsx": search(i18n) } : {},
+		...input.i18n ? { "lib/i18n.ts": i18nConfig(input.i18n.optionalLocale) } : {}
+	};
+}
+const searchImport = (input) => input.static ? `import SearchDialog from '@/components/search';\n` : "";
+/** imports of the root provider, with the i18n provider */
+const providerImports = (input) => `import { RootProvider } from '${input.provider}';
+${searchImport(input)}${input.i18n ? `import { i18nProvider } from 'fumadocs-ui/i18n';
+import { translations } from '@/lib/layout.shared';
+import { i18n } from '@/lib/i18n';
+` : ""}`;
+const providerProps = (input) => `${input.i18n ? " i18n={i18nProvider(translations, lang)}" : ""}${input.providerProps}`;
+/** the docs page for React Router & TanStack Start, where MDX content is loaded lazily on client */
+const clientContent = `function Content({ path }: { path: string }) {
+  const page = docs.getPage(path);
+  if (!page) throw new Error(\`unknown page: \${path}\`);
+
+  const { toc } = use(page.load());
+  const MDX = page.body;
+
+  return (
+    <DocsPage toc={toc}>
+      <DocsTitle>{page.title}</DocsTitle>
+      <DocsDescription>{page.description}</DocsDescription>
+      <DocsBody>
+        <MDX components={useMDXComponents()} />
+      </DocsBody>
+    </DocsPage>
+  );
+}`;
+const searchRoute = {
+	next: (input) => `import { source } from '@/lib/source';
+import { createFromSource } from 'fumadocs-core/search/server';
+${input.static ? "\nexport const revalidate = false;\n" : ""}
+export const { ${input.static ? "staticGET: GET" : "GET"} } = createFromSource(source);
+`,
+	waku: `import { createFromSource } from 'fumadocs-core/search/server';
+import { source } from '@/lib/source';
+
+export const { GET } = createFromSource(source);
+`
+};
+const templates = {
+	next: (input) => {
+		const i18n = input.i18n !== null;
+		const dir = i18n ? "app/(docs)/[lang]" : "app/(docs)";
+		const route = i18n ? "/[lang]" : "";
+		const lang = i18n ? ", params.lang" : "";
+		return {
+			...shared(input, false),
+			[`${dir}/layout.tsx`]: input.static ? `'use client';
+${providerImports(input)}${i18n ? "import { use } from 'react';\n" : ""}
+export default function Layout({ ${i18n ? "params, " : ""}children }: LayoutProps<'${route || "/"}'>) {
+${i18n ? "  const { lang } = use(params);\n\n" : ""}  return (
+    <RootProvider${providerProps(input)}>
+      ${wrapper("{children}")}
+    </RootProvider>
+  );
+}
+` : `${providerImports(input)}
+export default ${i18n ? "async " : ""}function Layout({ ${i18n ? "params, " : ""}children }: LayoutProps<'${route || "/"}'>) {
+${i18n ? "  const { lang } = await params;\n\n" : ""}  return (
+    <RootProvider${providerProps(input)}>
+      ${wrapper("{children}")}
+    </RootProvider>
+  );
+}
+`,
+			[`${dir}/docs/layout.tsx`]: `import { source } from '@/lib/source';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default ${i18n ? "async " : ""}function Layout({ ${i18n ? "params, " : ""}children }: LayoutProps<'${route}/docs'>) {
+${i18n ? "  const { lang } = await params;\n\n" : ""}  return (
+    <DocsLayout tree={source.getPageTree(${i18n ? "lang" : ""})} {...baseOptions(${i18n ? "lang" : ""})}>
+      {children}
+    </DocsLayout>
+  );
+}
+`,
+			[`${dir}/docs/[[...slug]]/page.tsx`]: `import { source } from '@/lib/source';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page';
+import { notFound } from 'next/navigation';
+import { getMDXComponents } from '@/components/mdx';
+import type { Metadata } from 'next';
+import { createRelativeLink } from 'fumadocs-ui/mdx';
+
+export default async function Page(props: PageProps<'${route}/docs/[[...slug]]'>) {
+  const params = await props.params;
+  const page = source.getPage(params.slug${lang});
+  if (!page) notFound();
+
+  const MDX = page.data.body;
+
+  return (
+    <DocsPage toc={page.data.toc} full={page.data.full}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX
+          components={getMDXComponents({
+            // this allows you to link to other pages with relative file paths
+            a: createRelativeLink(source, page),
+          })}
+        />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export async function generateStaticParams() {
+  return source.generateParams();
+}
+
+export async function generateMetadata(props: PageProps<'${route}/docs/[[...slug]]'>): Promise<Metadata> {
+  const params = await props.params;
+  const page = source.getPage(params.slug${lang});
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+  };
+}
+`,
+			"app/api/search/route.ts": searchRoute.next(input)
+		};
+	},
+	"react-router": (input) => {
+		const i18n = input.i18n !== null;
+		return {
+			...shared(input, true),
+			"routes/docs/layout.tsx": `import { Outlet${i18n ? ", useParams" : ""} } from 'react-router';
+${providerImports(input)}
+export default function Layout() {
+${i18n ? "  const { lang = i18n.defaultLanguage } = useParams();\n\n" : ""}  return (
+    <RootProvider${providerProps(input)}>
+      ${wrapper("\n        <Outlet />\n      ")}
+    </RootProvider>
+  );
+}
+`,
+			"routes/docs/page.tsx": `import type { Route } from './+types/page';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page';
+import { docs, source } from '@/lib/source';
+import { baseOptions } from '@/lib/layout.shared';
+import { useFumadocsLoader } from 'fumadocs-core/source/client';
+import { useMDXComponents } from '@/components/mdx';
+import { use } from 'react';
+
+export async function loader({ params }: Route.LoaderArgs) {
+  const slugs = params['*'].split('/').filter((v) => v.length > 0);
+  const page = source.getPage(slugs${i18n ? ", params.lang" : ""});
+  if (!page) throw new Response('Not found', { status: 404 });
+
+  return {
+    path: page.path,
+    url: page.url,
+    pageTree: await source.serializePageTree(source.getPageTree(${i18n ? "params.lang" : ""})),
+  };
+}
+
+${clientContent.replace("<DocsPage toc={toc}>", "<DocsPage toc={toc}>\n      <title>{page.title}</title>\n      <meta name=\"description\" content={page.description} />")}
+
+export default function Page({ loaderData${i18n ? ", params" : ""} }: Route.ComponentProps) {
+  const { path, pageTree } = useFumadocsLoader(loaderData);
+
+  return (
+    <DocsLayout {...baseOptions(${i18n ? "params.lang" : ""})} tree={pageTree}>
+      <Content path={path} />
+    </DocsLayout>
+  );
+}
+`,
+			"routes/docs/search.ts": `import type { Route } from './+types/search';
+import { createFromSource } from 'fumadocs-core/search/server';
+import { source } from '@/lib/source';
+
+const server = createFromSource(source);
+
+export async function loader(${input.static ? "" : "{ request }: Route.LoaderArgs"}) {
+  return server.${input.static ? "staticGET()" : "GET(request)"};
+}
+`
+		};
+	},
+	"tanstack-start": (input) => {
+		const seg = localeSegment("tanstack-start", input.i18n);
+		const i18n = input.i18n !== null;
+		return {
+			...shared(input, true),
+			"routes/_docs.tsx": `import { createFileRoute, Outlet${i18n ? ", useParams" : ""} } from '@tanstack/react-router';
+${providerImports(input)}
+export const Route = createFileRoute('/_docs')({
+  component: Layout,
+});
+
+function Layout() {
+${i18n ? "  const { lang = i18n.defaultLanguage } = useParams({ strict: false });\n\n" : ""}  return (
+    <RootProvider${providerProps(input)}>
+      ${wrapper("\n        <Outlet />\n      ")}
+    </RootProvider>
+  );
+}
+`,
+			[`routes/_docs/${seg}docs/$.tsx`]: `import { createFileRoute, notFound } from '@tanstack/react-router';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { createServerFn } from '@tanstack/react-start';
+import { docs, source } from '@/lib/source';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page';
+import { baseOptions } from '@/lib/layout.shared';
+import { useFumadocsLoader } from 'fumadocs-core/source/client';
+import { Suspense, use } from 'react';
+import { useMDXComponents } from '@/components/mdx';
+
+export const Route = createFileRoute('/_docs/${seg}docs/$')({
+  component: Page,
+  loader: async ({ params }) => {
+    const data = await serverLoader({
+      data: {
+        slugs: params._splat?.split('/') ?? [],${i18n ? "\n        lang: params.lang," : ""}
+      },
+    });
+    await docs.getPage(data.path)?.preload();
+    return data;
+  },
+});
+
+const serverLoader = createServerFn({
+  method: 'GET',
+})
+  .validator((params: { slugs: string[]${i18n ? "; lang?: string" : ""} }) => params)
+  .handler(async ({ data: { slugs${i18n ? ", lang" : ""} } }) => {
+    const page = source.getPage(slugs${i18n ? ", lang" : ""});
+    if (!page) throw notFound();
+
+    return {
+      path: page.path,
+      pageTree: await source.serializePageTree(source.getPageTree(${i18n ? "lang" : ""})),
+    };
+  });
+
+${clientContent}
+
+function Page() {
+${i18n ? "  const { lang } = Route.useParams();\n" : ""}  const data = useFumadocsLoader(Route.useLoaderData());
+
+  return (
+    <DocsLayout {...baseOptions(${i18n ? "lang" : ""})} tree={data.pageTree}>
+      <Suspense>
+        <Content path={data.path} />
+      </Suspense>
+    </DocsLayout>
+  );
+}
+`,
+			"routes/api/search.ts": `import { createFileRoute } from '@tanstack/react-router';
+import { source } from '@/lib/source';
+import { createFromSource } from 'fumadocs-core/search/server';
+
+const server = createFromSource(source);
+
+export const Route = createFileRoute('/api/search')({
+  server: {
+    handlers: {
+      GET: ${input.static ? "() => server.staticGET()" : "async ({ request }) => server.GET(request)"},
+    },
+  },
+});
+`
+		};
+	},
+	waku: (input) => {
+		const i18n = input.i18n !== null;
+		const page = `import { source } from '@/lib/source';
+import type { PageProps } from 'waku/router';
+import { unstable_notFound } from 'waku/router/server';
+import { createRelativeLink } from 'fumadocs-ui/mdx';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page';
+import { getMDXComponents } from '@/components/mdx';
+${i18n ? "import { DocsLayout } from 'fumadocs-ui/layouts/docs';\nimport { baseOptions } from '@/lib/layout.shared';\n" : ""}
+export default function Page({ slug${i18n ? ", lang" : ""} }: PageProps<'${i18n ? "/[lang]" : ""}/docs/[...slug]'>) {
+  const page = source.getPage(slug${i18n ? ", lang" : ""});
+  if (!page) unstable_notFound();
+
+  const MDX = page.data.body;
+  const content = (
+    <DocsPage toc={page.data.toc}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX
+          components={getMDXComponents({
+            // this allows you to link to other pages with relative file paths
+            a: createRelativeLink(source, page),
+          })}
+        />
+      </DocsBody>
+    </DocsPage>
+  );
+${i18n ? `
+  // layouts don't receive the locale, render the docs layout here
+  return (
+    <DocsLayout {...baseOptions(lang)} tree={source.getPageTree(lang)}>
+      {content}
+    </DocsLayout>
+  );` : `
+  return content;`}
+}
+
+export async function getConfig() {
+  return {
+    render: 'static',
+    staticPaths: source.generateParams().map((item) => ${i18n ? "[item.lang, ...item.slug]" : "item.slug"}),
+  } as const;
+}
+`;
+		return {
+			...shared(input, false),
+			"pages/(docs)/_layout.tsx": i18n ? `import type { ReactNode } from 'react';
+import { Provider } from '@/components/provider';
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <Provider>
+      ${wrapper("{children}")}
+    </Provider>
+  );
+}
+` : `import type { ReactNode } from 'react';
+${providerImports(input)}
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <RootProvider${providerProps(input)}>
+      ${wrapper("{children}")}
+    </RootProvider>
+  );
+}
+`,
+			...i18n ? {
+				"components/provider.tsx": `'use client';
+import type { ReactNode } from 'react';
+import { useRouter } from 'waku/router/client';
+${providerImports(input)}
+export function Provider({ children }: { children: ReactNode }) {
+  const router = useRouter();
+  const lang = router.path.split('/')[1] || i18n.defaultLanguage;
+
+  return <RootProvider${providerProps(input)}>{children}</RootProvider>;
+}
+`,
+				"pages/(docs)/[lang]/docs/[...slug].tsx": page
+			} : {
+				"pages/(docs)/docs/_layout.tsx": `import type { ReactNode } from 'react';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { source } from '@/lib/source';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <DocsLayout {...baseOptions()} tree={source.getPageTree()}>
+      {children}
+    </DocsLayout>
+  );
+}
+`,
+				"pages/(docs)/docs/[...slug].tsx": page
+			},
+			"pages/_api/api/search.ts": searchRoute.waku
+		};
+	}
+};
+const nextProxy = `import { createI18nMiddleware } from 'fumadocs-core/i18n/middleware';
+import { i18n } from '@/lib/i18n';
+
+export default createI18nMiddleware(i18n);
+
+export const config = {
+  // only the docs routes, add the ones of other features here
+  matcher: ['/docs/:path*', '/:lang/docs/:path*'],
+};
+`;
+const sampleContent = `---
+title: Hello World
+description: Your first document
+---
+
+Welcome to the docs! You can edit this page in \`content/docs/index.mdx\`.
+
+## Heading
+
+<Cards>
+  <Card title="Learn more about Fumadocs" href="https://fumadocs.dev" />
+</Cards>
+`;
+const sampleContentCn = `---
+title: 你好，世界
+description: 你的第一份文檔
+---
+
+歡迎來到文檔！你可以在 \`content/docs/index.cn.mdx\` 編輯這個頁面。
+`;
+//#endregion
+//#region src/features/docs/index.ts
+const cssImports = (preset) => [`@import 'fumadocs-ui/css/${preset}.css';`, `@import 'fumadocs-ui/css/preset.css';`];
+const docs = {
+	id: "docs",
+	title: "Docs",
+	description: "set up Fumadocs on your app, in a dedicated route group",
+	supports: reactOnly,
+	options: { i18n: {
+		message: "Enable internationalization?",
+		initialValue: false
+	} },
+	async detect(project) {
+		return exists(path.join(project.cwd, project.baseDir, "lib/source.ts"));
+	},
+	async apply(ctx, options) {
+		const { project } = ctx;
+		const { baseDir, packageJson, config } = project;
+		const framework = reactFramework(project);
+		const i18n = project.i18n ?? (options.i18n ? { optionalLocale: framework !== "waku" } : null);
+		const providerProps = [];
+		if (project.static) providerProps.push("search={{ SearchDialog }}");
+		if ("next-themes" in (packageJson.dependencies ?? {})) providerProps.push("theme={{ enabled: false }}");
+		ctx.addDependencies({
+			"fumadocs-core": null,
+			"fumadocs-mdx": null,
+			"fumadocs-ui": config.uiLibrary === "base-ui" ? "npm:@fumadocs/base-ui" : null
+		});
+		ctx.addDependencies({ "@types/mdx": null }, true);
+		const files = templates[framework]({
+			static: project.static,
+			i18n,
+			provider: project.info.provider,
+			providerProps: providerProps.map((prop) => ` ${prop}`).join("")
+		});
+		for (const [file, content] of Object.entries(files)) await ctx.write(path.posix.join(baseDir, file), content);
+		await ctx.write("content/docs/index.mdx", sampleContent);
+		if (i18n) await ctx.write("content/docs/index.cn.mdx", sampleContentCn);
+		await ctx.append(".gitignore", [".source"]);
+		if (i18n && framework === "next") await configureProxy(ctx);
+		await configureBundler(ctx);
+		await configureCss(ctx);
+		await suppressHydrationWarning(ctx);
+		if (framework === "react-router") await configureRoutes(ctx, i18n);
+		if (!(await fs.readFile(path.join(project.cwd, "tsconfig.json"), "utf-8").catch(() => "")).includes("\"@/*\"")) ctx.note(`Generated files import from the \`@/*\` alias, add it to \`tsconfig.json\`:\n  "paths": { "@/*": ["./${baseDir ? `${baseDir}/` : ""}*"] }`);
+		if (project.static && framework === "tanstack-start") ctx.note("In SPA mode, prerender the docs pages and search index, see https://fumadocs.dev/docs/manual-installation/tanstack-start.");
+		if (i18n && framework === "react-router") ctx.note("When prerendering, list the docs pages with `source.getPages().map((page) => page.url)` instead of globbing content files, see https://fumadocs.dev/docs/internationalization/react-router.");
+		if (i18n) ctx.note(`Languages are configured in \`lib/i18n.ts\`, translated content uses a locale suffix like \`index.cn.mdx\`.\nUI translations: https://fumadocs.dev/docs/internationalization#translations`);
+		ctx.note(`Start the dev server and open ${i18n && !i18n.optionalLocale ? "/en/docs" : "/docs"} to see your docs.`);
+	}
+};
+/** the Next.js proxy (middleware) file of the project, relative to cwd */
+async function findNextProxy({ cwd, baseDir }) {
+	for (const file of ["proxy.ts", "middleware.ts"]) for (const dir of /* @__PURE__ */ new Set([baseDir, ""])) {
+		const target = path.join(dir, file);
+		if (await exists(path.join(cwd, target))) return target;
+	}
+}
+/** the i18n middleware redirects & rewrites docs URLs without locale */
+async function configureProxy(ctx) {
+	const existing = await findNextProxy(ctx.project);
+	if (!existing) {
+		await ctx.write(path.join(ctx.project.baseDir, "proxy.ts"), nextProxy);
+		return;
+	}
+	ctx.note(`A proxy already exists at ${existing}, handle the docs locale there. Fumadocs provides \`createI18nMiddleware\` from 'fumadocs-core/i18n/middleware', see https://fumadocs.dev/docs/internationalization/next.`);
+}
+async function configureBundler(ctx) {
+	const { framework, configFile } = ctx.project;
+	if (!(configFile !== void 0 && await ctx.source(configFile, (file) => {
+		if (!(framework === "next" ? wrapNextConfig(file) : addVitePlugin(file, {
+			name: "fumadocsMdx",
+			from: "fumadocs-mdx/vite"
+		}, framework === "waku" ? ["vite", "plugins"] : ["plugins"]))) throw new Error(`cannot update ${configFile}`);
+	}).catch(() => false))) ctx.note(framework === "next" ? "Wrap your Next.js config with `createMDX()` from 'fumadocs-mdx/next', see https://fumadocs.dev/docs/mdx/next." : "Add `fumadocsMdx()` from 'fumadocs-mdx/vite' to the Vite plugins of your config file.");
+}
+/** resolve the global CSS file imported by the root file */
+async function findCssEntry({ cwd, baseDir, info }) {
+	const rootFile = path.join(baseDir, info.rootFile);
+	const content = await fs.readFile(path.join(cwd, rootFile), "utf-8").catch(() => "");
+	const match = /import\s+(?:\w+\s+from\s+)?['"]([^'"]+\.css)(?:\?url)?['"]/.exec(content);
+	if (!match) return;
+	const specifier = match[1];
+	if (specifier.startsWith("@/")) return path.join(baseDir, specifier.slice(2));
+	if (specifier.startsWith(".")) return path.join(path.dirname(rootFile), specifier);
+}
+async function configureCss(ctx) {
+	const { cwd } = ctx.project;
+	const preset = await exists(path.join(cwd, "components.json")) ? "shadcn" : "neutral";
+	const entry = await findCssEntry(ctx.project);
+	if (entry && await exists(path.join(cwd, entry))) {
+		await ctx.append(entry, cssImports(preset));
+		return;
+	}
+	ctx.note(`Add the styles to your global CSS file (after \`@import 'tailwindcss'\`):\n  ${cssImports(preset).join("\n  ")}`);
+}
+/** `next-themes` sets the theme class on `<html>`, React warns about the mismatch without this attribute */
+async function suppressHydrationWarning(ctx) {
+	const { baseDir, info } = ctx.project;
+	if (!await ctx.source(path.join(baseDir, info.rootFile), (file) => {
+		const html = findJsxElement(file, "html")?.openingElement;
+		if (!html || file.code.slice(html.start, html.end).includes("suppressHydrationWarning")) return;
+		addJsxAttribute(file, html, "suppressHydrationWarning");
+	})) ctx.note("Add `suppressHydrationWarning` to the `<html>` element of your root layout.");
+}
+async function configureRoutes(ctx, i18n) {
+	if (!await registerReactRouterRoutes(ctx, [`layout('routes/docs/layout.tsx', [route('${localeSegment("react-router", i18n)}docs/*', 'routes/docs/page.tsx')])`, {
+		path: "api/search",
+		file: "routes/docs/search.ts",
+		pattern: "/api/search"
+	}])) return;
+	await ctx.source(path.join(ctx.project.baseDir, "routes.ts"), (file) => {
+		addImport(file, {
+			from: "@react-router/dev/routes",
+			named: ["layout", "route"]
+		});
+	});
+}
+//#endregion
+export { routeModule as a, reactRouterTypes as i, findNextProxy as n, formatRoute as r, docs as t };
+
+//# sourceMappingURL=docs--WqEHTyl.js.map