@fumadocs/cli 1.5.0 → 1.6.0

package/dist/project/index.js

@@ -0,0 +1,2 @@
+import { i as loadProject, n as frameworks, r as isSupportedFramework, t as detectFramework } from "../project-DwRVTm4p.js";
+export { detectFramework, frameworks, isSupportedFramework, loadProject };

package/dist/project-DwRVTm4p.js

@@ -0,0 +1,110 @@
+import { t as exists } from "./fs-D6J9dOEx.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { detectFramework as detectFramework$1, detectPackageManager } from "fuma-cli/detect";
+//#region src/project/index.ts
+const frameworks = {
+	next: {
+		provider: "fumadocs-ui/provider/next",
+		rootFile: "app/layout.tsx",
+		routesDir: "app",
+		configFiles: [
+			"next.config.mjs",
+			"next.config.ts",
+			"next.config.js"
+		],
+		isStatic: (config) => /output:\s*['"]export['"]/.test(config)
+	},
+	"react-router": {
+		provider: "fumadocs-ui/provider/react-router",
+		rootFile: "root.tsx",
+		routesDir: "routes",
+		configFiles: ["vite.config.ts"]
+	},
+	"tanstack-start": {
+		provider: "fumadocs-ui/provider/tanstack",
+		rootFile: "routes/__root.tsx",
+		routesDir: "routes",
+		configFiles: ["vite.config.ts"],
+		isStatic: (config) => /\bspa:\s*\{/.test(config)
+	},
+	waku: {
+		provider: "fumadocs-ui/provider/waku",
+		rootFile: "pages/_root.tsx",
+		routesDir: "pages",
+		configFiles: ["waku.config.ts"]
+	},
+	astro: {
+		provider: "fumadocs-ui/provider/astro",
+		rootFile: "layouts/Layout.astro",
+		routesDir: "pages",
+		configFiles: ["astro.config.mjs", "astro.config.ts"]
+	}
+};
+function isSupportedFramework(v) {
+	return v in frameworks;
+}
+async function loadProject(config, cwd = process.cwd(), framework = assertFramework(config.framework)) {
+	const info = frameworks[framework];
+	const [packageJson, pm] = await Promise.all([fs.readFile(path.join(cwd, "package.json"), "utf-8").then((content) => JSON.parse(content)).catch(() => ({})), detectPackageManager({ cwd })]);
+	let configFile;
+	let configContent;
+	for (const file of info.configFiles) if (await exists(path.join(cwd, file))) {
+		configFile = file;
+		configContent = await fs.readFile(path.join(cwd, file), "utf-8");
+		break;
+	}
+	let isStatic = false;
+	if (framework === "react-router") {
+		const content = await fs.readFile(path.join(cwd, "react-router.config.ts"), "utf-8").catch(() => "");
+		isStatic = /ssr:\s*false/.test(content);
+	} else if (configContent && info.isStatic) isStatic = info.isStatic(configContent);
+	const read = (file) => fs.readFile(path.join(cwd, file), "utf-8").catch(() => null);
+	const i18nConfig = await read(path.join(config.baseDir, "lib/i18n.ts"));
+	return {
+		cwd,
+		framework,
+		info,
+		static: isStatic,
+		i18n: i18nConfig === null ? null : { optionalLocale: /hideLocale:\s*['"]default-locale['"]/.test(i18nConfig) },
+		packageManager: pm?.name ?? "npm",
+		baseDir: config.baseDir,
+		config,
+		configFile,
+		packageJson,
+		source: await detectSource(cwd, config.baseDir, read)
+	};
+}
+async function detectSource(cwd, baseDir, read) {
+	const sourceFile = path.join(baseDir, "lib/source.ts");
+	const source = await read(sourceFile) ?? "";
+	let collections = null;
+	let content = source;
+	if (source.includes("defineDocs(")) collections = sourceFile;
+	else if (await exists(path.join(cwd, "source.config.ts"))) {
+		collections = "source.config.ts";
+		content = await read(collections) ?? "";
+	}
+	let baseUrl = /baseUrl:\s*['"]([^'"]*)['"]/.exec(source)?.[1];
+	const ref = /baseUrl:\s*(\w+)/.exec(source)?.[1];
+	if (!baseUrl && ref) {
+		const shared = await read(path.join(baseDir, "lib/shared.ts")) ?? "";
+		baseUrl = new RegExp(`${ref}\\s*=\\s*['"]([^'"]*)['"]`).exec(shared)?.[1];
+	}
+	return {
+		loader: /export const source\b/.test(source),
+		dynamic: /export (async )?function getSource\b/.test(source),
+		collections,
+		async: /async:\s*true/.test(content),
+		baseUrl: baseUrl ?? "/docs",
+		dir: /dir:\s*['"]([^'"]*)['"]/.exec(content)?.[1] ?? "content/docs"
+	};
+}
+function assertFramework(framework) {
+	if (isSupportedFramework(framework)) return framework;
+	throw new Error(`Unsupported framework "${framework}", supported: ${Object.keys(frameworks).join(", ")}.`);
+}
+//#endregion
+export { loadProject as i, frameworks as n, isSupportedFramework as r, detectFramework$1 as t };
+
+//# sourceMappingURL=project-DwRVTm4p.js.map

package/dist/project-DwRVTm4p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-DwRVTm4p.js","names":[],"sources":["../src/project/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { detectFramework, detectPackageManager } from 'fuma-cli/detect';\nimport type { LoadedConfig } from '@/config';\nimport { exists } from '@/utils/fs';\n\nexport type PackageManager = NonNullable<Awaited<ReturnType<typeof detectPackageManager>>>['name'];\n\nexport type Framework = 'next' | 'react-router' | 'tanstack-start' | 'waku' | 'astro';\n/** frameworks supported by features that generate routes */\nexport type ReactFramework = Exclude<Framework, 'astro'>;\n\nexport interface FrameworkInfo {\n  /** import specifier of `RootProvider` */\n  provider: string;\n  /** root file that imports the global CSS, relative to base dir */\n  rootFile: string;\n  /** routes directory, relative to base dir */\n  routesDir: string;\n  /** config file candidates (relative to cwd) that register bundler plugins */\n  configFiles: string[];\n  /** how to detect `static` mode from the config file */\n  isStatic?: (config: string) => boolean;\n}\n\nexport const frameworks: Record<Framework, FrameworkInfo> = {\n  next: {\n    provider: 'fumadocs-ui/provider/next',\n    rootFile: 'app/layout.tsx',\n    routesDir: 'app',\n    configFiles: ['next.config.mjs', 'next.config.ts', 'next.config.js'],\n    isStatic: (config) => /output:\\s*['\"]export['\"]/.test(config),\n  },\n  'react-router': {\n    provider: 'fumadocs-ui/provider/react-router',\n    rootFile: 'root.tsx',\n    routesDir: 'routes',\n    configFiles: ['vite.config.ts'],\n  },\n  'tanstack-start': {\n    provider: 'fumadocs-ui/provider/tanstack',\n    rootFile: 'routes/__root.tsx',\n    routesDir: 'routes',\n    configFiles: ['vite.config.ts'],\n    isStatic: (config) => /\\bspa:\\s*\\{/.test(config),\n  },\n  waku: {\n    provider: 'fumadocs-ui/provider/waku',\n    rootFile: 'pages/_root.tsx',\n    routesDir: 'pages',\n    configFiles: ['waku.config.ts'],\n  },\n  astro: {\n    provider: 'fumadocs-ui/provider/astro',\n    rootFile: 'layouts/Layout.astro',\n    routesDir: 'pages',\n    configFiles: ['astro.config.mjs', 'astro.config.ts'],\n  },\n};\n\n/** how docs content is loaded, detected from `lib/source.ts` */\nexport interface SourceInfo {\n  /** `lib/source.ts` exports a `source` loader */\n  loader: boolean;\n  /** `lib/source.ts` exports `getSource()`, a runtime content source resolved on demand */\n  dynamic: boolean;\n  /** file defining the Fumadocs MDX collections, relative to cwd: `lib/source.ts` (macro) or `source.config.ts`; `null` for other content sources */\n  collections: string | null;\n  /** collections are loaded lazily, `structuredData` is a function */\n  async: boolean;\n  /** base URL of docs pages */\n  baseUrl: string;\n  /** content directory */\n  dir: string;\n}\n\nexport interface I18nInfo {\n  /** the default locale is hidden from URLs (`hideLocale: 'default-locale'`) */\n  optionalLocale: boolean;\n}\n\nexport interface Project {\n  cwd: string;\n  framework: Framework;\n  info: FrameworkInfo;\n  /** prerendered to static HTML, no server at runtime */\n  static: boolean;\n  /** `lib/i18n.ts` exists */\n  i18n: I18nInfo | null;\n  source: SourceInfo;\n  packageManager: PackageManager;\n  /** directory of app code, relative to `cwd` */\n  baseDir: string;\n  config: LoadedConfig;\n  /** config file that registers bundler plugins, relative to `cwd` */\n  configFile?: string;\n  packageJson: {\n    dependencies?: Record<string, string>;\n    devDependencies?: Record<string, string>;\n  };\n}\n\nexport function isSupportedFramework(v: string): v is Framework {\n  return v in frameworks;\n}\n\nexport async function loadProject(\n  config: LoadedConfig,\n  cwd = process.cwd(),\n  framework: Framework = assertFramework(config.framework),\n): Promise<Project> {\n  const info = frameworks[framework];\n  const [packageJson, pm] = await Promise.all([\n    fs\n      .readFile(path.join(cwd, 'package.json'), 'utf-8')\n      .then((content) => JSON.parse(content))\n      .catch(() => ({})),\n    detectPackageManager({ cwd }),\n  ]);\n  let configFile: string | undefined;\n  let configContent: string | undefined;\n  for (const file of info.configFiles) {\n    if (await exists(path.join(cwd, file))) {\n      configFile = file;\n      configContent = await fs.readFile(path.join(cwd, file), 'utf-8');\n      break;\n    }\n  }\n\n  let isStatic = false;\n  if (framework === 'react-router') {\n    const content = await fs\n      .readFile(path.join(cwd, 'react-router.config.ts'), 'utf-8')\n      .catch(() => '');\n    isStatic = /ssr:\\s*false/.test(content);\n  } else if (configContent && info.isStatic) {\n    isStatic = info.isStatic(configContent);\n  }\n\n  const read = (file: string) => fs.readFile(path.join(cwd, file), 'utf-8').catch(() => null);\n  const i18nConfig = await read(path.join(config.baseDir, 'lib/i18n.ts'));\n\n  return {\n    cwd,\n    framework,\n    info,\n    static: isStatic,\n    i18n:\n      i18nConfig === null\n        ? null\n        : { optionalLocale: /hideLocale:\\s*['\"]default-locale['\"]/.test(i18nConfig) },\n    packageManager: pm?.name ?? 'npm',\n    baseDir: config.baseDir,\n    config,\n    configFile,\n    packageJson,\n    source: await detectSource(cwd, config.baseDir, read),\n  };\n}\n\nasync function detectSource(\n  cwd: string,\n  baseDir: string,\n  read: (file: string) => Promise<string | null>,\n): Promise<SourceInfo> {\n  const sourceFile = path.join(baseDir, 'lib/source.ts');\n  const source = (await read(sourceFile)) ?? '';\n  let collections: string | null = null;\n  let content = source;\n  if (source.includes('defineDocs(')) {\n    collections = sourceFile;\n  } else if (await exists(path.join(cwd, 'source.config.ts'))) {\n    collections = 'source.config.ts';\n    content = (await read(collections)) ?? '';\n  }\n\n  let baseUrl = /baseUrl:\\s*['\"]([^'\"]*)['\"]/.exec(source)?.[1];\n  // e.g. `baseUrl: docsRoute` from `lib/shared.ts`\n  const ref = /baseUrl:\\s*(\\w+)/.exec(source)?.[1];\n  if (!baseUrl && ref) {\n    const shared = (await read(path.join(baseDir, 'lib/shared.ts'))) ?? '';\n    baseUrl = new RegExp(`${ref}\\\\s*=\\\\s*['\"]([^'\"]*)['\"]`).exec(shared)?.[1];\n  }\n\n  return {\n    loader: /export const source\\b/.test(source),\n    dynamic: /export (async )?function getSource\\b/.test(source),\n    collections,\n    async: /async:\\s*true/.test(content),\n    baseUrl: baseUrl ?? '/docs',\n    dir: /dir:\\s*['\"]([^'\"]*)['\"]/.exec(content)?.[1] ?? 'content/docs',\n  };\n}\n\nfunction assertFramework(framework: string): Framework {\n  if (isSupportedFramework(framework)) return framework;\n  throw new Error(\n    `Unsupported framework \"${framework}\", supported: ${Object.keys(frameworks).join(', ')}.`,\n  );\n}\n\nexport { detectFramework };\n"],"mappings":"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"}

package/dist/registry/installer.d.ts

@@ -1,12 +1,11 @@
-import { LoadedConfig } from "../config.js";
-import { ComponentInstaller } from "fuma-cli/registry/installer";
+import { r as LoadedConfig } from "../config-CT2jj39D.js";
+import { ComponentInstaller, IOInterface } from "fuma-cli/registry/installer";
 import { RegistryConnector } from "fuma-cli/registry/connector";
 //#region src/registry/installer.d.ts
-declare class FumadocsComponentInstaller extends ComponentInstaller {
+export declare class FumadocsComponentInstaller extends ComponentInstaller {
   private interactive;
-  constructor(connector: RegistryConnector, config: LoadedConfig, cwd?: string);
+  constructor(connector: RegistryConnector, config: LoadedConfig, cwd?: string, io?: Partial<IOInterface>);
   installInteractive(name: string, subRegistry?: string): Promise<void>;
 }
 //#endregion
-export { FumadocsComponentInstaller };
 //# sourceMappingURL=installer.d.ts.map

package/dist/registry/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","names":[],"sources":["../../src/registry/installer.ts"],"mappings":";;;;cAQa,mCAAmC;UACtC;EAKI,YAAA,WAAW,mBAAmB,QAAQ,cAAc;EAuC1D,mBAAmB,cAAc,uBAAuB"}
+{"version":3,"file":"installer.d.ts","names":[],"sources":["../../src/registry/installer.ts"],"mappings":";;;;qBASa,mCAAmC;UACtC;EAKR,YACE,WAAW,mBACX,QAAQ,cACR,cACA,KAAK,QAAQ;EAyCT,mBAAmB,cAAc,uBAAuB"}

package/dist/registry/installer.js

@@ -1,2 +1,2 @@
-import { t as FumadocsComponentInstaller } from "../installer-Ci3Hf9it.js";
+import { t as FumadocsComponentInstaller } from "../installer-D0Obb2Md.js";
 export { FumadocsComponentInstaller };

package/dist/schema.json

@@ -1 +1 @@
-{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"$schema":{"default":"node_modules/@fumadocs/cli/dist/schema.json","type":"string"},"aliases":{"default":{"uiDir":"./components/ui","componentsDir":"./components","layoutDir":"./layouts","cssDir":"./styles","libDir":"./lib"},"type":"object","properties":{"uiDir":{"default":"./components/ui","type":"string"},"componentsDir":{"default":"./components/ui","type":"string"},"layoutDir":{"default":"./layouts","type":"string"},"cssDir":{"default":"./components","type":"string"},"libDir":{"default":"./lib","type":"string"}}},"baseDir":{"default":"src","type":"string"},"uiLibrary":{"default":"base-ui","type":"string","enum":["radix-ui","base-ui"]},"framework":{"default":"next","type":"string","enum":["next","astro","waku","react-router","tanstack-start"]},"commands":{"default":{},"type":"object","properties":{"format":{"type":"string"}}}}}
+{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"$schema":{"default":"node_modules/@fumadocs/cli/dist/schema.json","type":"string"},"aliases":{"default":{"uiDir":"./components/ui","componentsDir":"./components","layoutDir":"./layouts","cssDir":"./styles","libDir":"./lib"},"type":"object","properties":{"uiDir":{"default":"./components/ui","type":"string"},"componentsDir":{"default":"./components","type":"string"},"layoutDir":{"default":"./layouts","type":"string"},"cssDir":{"default":"./styles","type":"string"},"libDir":{"default":"./lib","type":"string"}}},"baseDir":{"default":"src","type":"string"},"uiLibrary":{"default":"base-ui","type":"string","enum":["radix-ui","base-ui"]},"framework":{"default":"next","type":"string","enum":["next","astro","waku","react-router","tanstack-start"]},"commands":{"default":{},"type":"object","properties":{"format":{"type":"string"}}}}}

package/dist/search-iphnSVVY.js

@@ -0,0 +1,381 @@
+import { b as findJsxElement, m as addJsxAttribute, o as filterReactRouterPrerenderArray, p as addImport, r as addTanstackPrerender, s as filterReactRouterRoute } from "./codemod-auol-p4R.js";
+import { a as routeModule, r as formatRoute, t as docs } from "./docs-DeIEl_Kt.js";
+import { a as reactFramework, d as sourceRef, i as posix, l as scripts, r as findSource, s as registerReactRouterRoutes } from "./utils-DbMe7h6c.js";
+import path from "node:path";
+//#region src/features/search.ts
+const publicEnv = (next) => next ? {
+	prefix: "NEXT_PUBLIC_",
+	read: "process.env.NEXT_PUBLIC_"
+} : {
+	prefix: "VITE_",
+	read: "import.meta.env.VITE_"
+};
+const dialogImports = `import {
+  SearchDialog,
+  SearchDialogClose,
+  SearchDialogContent,
+  SearchDialogFooter,
+  SearchDialogHeader,
+  SearchDialogIcon,
+  SearchDialogInput,
+  SearchDialogList,
+  SearchDialogOverlay,
+  type SharedProps,
+} from 'fumadocs-ui/components/dialog/search';
+import { useI18n } from 'fumadocs-ui/contexts/i18n';`;
+const dialogBody = (footer, url) => `  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} />
+        <SearchDialogFooter>
+          <a
+            href="${url}"
+            rel="noreferrer noopener"
+            className="ms-auto text-xs text-fd-muted-foreground"
+          >
+            Search powered by ${footer}
+          </a>
+        </SearchDialogFooter>
+      </SearchDialogContent>
+    </SearchDialog>
+  );
+}
+`;
+/** `structuredData` is a function on async collections (React Router & TanStack Start) */
+const typesenseIndexes = (async, { ref, resolved }) => `import { ${ref} } from '@/lib/source';
+import type { DocumentRecord } from 'typesense-fumadocs-adapter';
+
+export async function exportSearchIndexes() {
+  const results: DocumentRecord[] = [];
+  for (const page of ${resolved}.getPages()) {
+    results.push({
+      _id: page.url,
+      structured: ${async ? "await page.data.structuredData()" : "page.data.structuredData"},
+      url: page.url,
+      title: page.data.title,
+      description: page.data.description,
+      locale: page.locale,
+    });
+  }
+  return results;
+}
+`;
+const syncScript = (imports, body) => `import * as fs from 'node:fs/promises';
+${imports}
+
+async function main(filePath: string) {
+  const content = await fs.readFile(filePath);
+  const records = JSON.parse(content.toString()) as DocumentRecord[];
+${body}
+  console.log(\`search updated: \${records.length} records\`);
+}
+
+// the path of pre-rendered \`static.json\`
+const filePath = process.argv[2];
+if (!filePath) throw new Error('missing the path of static.json');
+void main(filePath);
+`;
+const providers = {
+	"orama-cloud": {
+		label: "Orama Cloud",
+		hint: "signup needed",
+		dependencies: { "@orama/core": null },
+		publicEnv: [
+			"ORAMA_DATASOURCE_ID",
+			"ORAMA_PROJECT_ID",
+			"ORAMA_API_KEY"
+		],
+		privateEnv: ["ORAMA_PRIVATE_API_KEY"],
+		static: true,
+		dialog: (env) => `'use client';
+${dialogImports}
+import { useDocsSearch } from 'fumadocs-core/search/client';
+import { OramaCloud } from '@orama/core';
+
+const client = new OramaCloud({
+  projectId: ${env.read}ORAMA_PROJECT_ID!,
+  apiKey: ${env.read}ORAMA_API_KEY!,
+});
+
+export default function CustomSearchDialog(props: SharedProps) {
+  const { locale } = useI18n();
+  const { search, setSearch, query } = useDocsSearch({
+    type: 'orama-cloud',
+    client,
+    locale,
+  });
+
+${dialogBody("Orama", "https://orama.com")}`,
+		exportIndexes: ({ ref }) => ({
+			imports: `import { ${ref} } from '@/lib/source';
+import { toDocuments } from 'fumadocs-core/search/orama-cloud';`,
+			documents: `toDocuments(${ref})`
+		}),
+		sync: (env) => syncScript(`import { type OramaDocument as DocumentRecord, sync } from 'fumadocs-core/search/orama-cloud';
+import { OramaCloud } from '@orama/core';`, `  const orama = new OramaCloud({
+    projectId: process.env.${env.prefix}ORAMA_PROJECT_ID!,
+    apiKey: process.env.ORAMA_PRIVATE_API_KEY!,
+  });
+
+  await sync(orama, {
+    index: process.env.${env.prefix}ORAMA_DATASOURCE_ID!,
+    documents: records,
+  });
+`)
+	},
+	algolia: {
+		label: "Algolia",
+		hint: "signup needed",
+		dependencies: { algoliasearch: null },
+		publicEnv: ["ALGOLIA_APP_ID", "ALGOLIA_SEARCH_KEY"],
+		privateEnv: ["ALGOLIA_WRITE_KEY"],
+		static: true,
+		dialog: (env) => `'use client';
+${dialogImports}
+import { useDocsSearch } from 'fumadocs-core/search/client';
+import { algoliaClient } from 'fumadocs-core/search/client/algolia';
+import { liteClient } from 'algoliasearch/lite';
+
+const algolia = liteClient(${env.read}ALGOLIA_APP_ID!, ${env.read}ALGOLIA_SEARCH_KEY!);
+
+export default function CustomSearchDialog(props: SharedProps) {
+  const { locale } = useI18n();
+  const { search, setSearch, query } = useDocsSearch({
+    client: algoliaClient({
+      client: algolia,
+      indexName: 'document',
+      locale,
+    }),
+  });
+
+${dialogBody("Algolia", "https://algolia.com")}`,
+		exportIndexes: ({ ref }) => ({
+			imports: `import { ${ref} } from '@/lib/source';
+import { toDocuments } from 'fumadocs-core/search/algolia';`,
+			documents: `toDocuments(${ref})`
+		}),
+		sync: (env) => syncScript(`import { type DocumentRecord, sync } from 'fumadocs-core/search/algolia';
+import { algoliasearch } from 'algoliasearch';`, `  const client = algoliasearch(
+    process.env.${env.prefix}ALGOLIA_APP_ID!,
+    process.env.ALGOLIA_WRITE_KEY!,
+  );
+
+  await sync(client, {
+    indexName: 'document',
+    documents: records,
+  });
+`)
+	},
+	typesense: {
+		label: "Typesense",
+		hint: "self-hosted or cloud, community adapter",
+		dependencies: {
+			typesense: null,
+			"typesense-fumadocs-adapter": null
+		},
+		publicEnv: ["TYPESENSE_URL", "TYPESENSE_SEARCH_KEY"],
+		privateEnv: ["TYPESENSE_API_KEY"],
+		static: true,
+		dialog: (env) => `'use client';
+${dialogImports}
+import { Client } from 'typesense';
+import { useTypesenseSearch } from 'typesense-fumadocs-adapter/client';
+
+const client = new Client({
+  nodes: [{ url: ${env.read}TYPESENSE_URL! }],
+  apiKey: ${env.read}TYPESENSE_SEARCH_KEY!,
+});
+
+export default function CustomSearchDialog(props: SharedProps) {
+  const { locale } = useI18n();
+  const { search, setSearch, query } = useTypesenseSearch({
+    typesenseCollectionName: 'docs',
+    locale,
+    client,
+  });
+
+${dialogBody("Typesense", "https://typesense.org")}`,
+		exportIndexes: (src) => ({
+			imports: "import { exportSearchIndexes } from '@/lib/export-search-indexes';",
+			documents: "exportSearchIndexes()",
+			file: (async) => typesenseIndexes(async, src)
+		}),
+		sync: (env) => syncScript(`import { type DocumentRecord, sync } from 'typesense-fumadocs-adapter';
+import { Client } from 'typesense';`, `  const client = new Client({
+    nodes: [{ url: process.env.${env.prefix}TYPESENSE_URL! }],
+    apiKey: process.env.TYPESENSE_API_KEY!,
+    connectionTimeoutSeconds: 60 * 15,
+  });
+
+  await sync(client, {
+    typesenseCollectionName: 'docs',
+    documents: records,
+  });
+`)
+	},
+	mixedbread: {
+		label: "Mixedbread",
+		hint: "AI search, signup needed",
+		dependencies: { "@mixedbread/sdk": null },
+		publicEnv: [],
+		privateEnv: ["MIXEDBREAD_API_KEY", "MIXEDBREAD_STORE_ID"],
+		static: false,
+		dialog: () => `'use client';
+${dialogImports}
+import { useDocsSearch } from 'fumadocs-core/search/client';
+import { fetchClient } from 'fumadocs-core/search/client/fetch';
+
+export default function CustomSearchDialog(props: SharedProps) {
+  const { locale } = useI18n();
+  const { search, setSearch, query } = useDocsSearch({
+    client: fetchClient({
+      api: '/api/search',
+      locale,
+    }),
+  });
+
+${dialogBody("Mixedbread", "https://mixedbread.com")}`,
+		sync: (_env, dir) => `import { spawnSync } from 'node:child_process';
+
+// sync the content with Mixedbread CLI
+const result = spawnSync(
+  'npx',
+  ['--yes', '@mixedbread/cli', 'vs', 'sync', process.env.MIXEDBREAD_STORE_ID!, '${dir}', '--ci'],
+  { stdio: 'inherit' },
+);
+
+process.exit(result.status ?? 1);
+`,
+		searchRoute: (() => {
+			const server = `import { createMixedbreadSearchAPI } from 'fumadocs-core/search/mixedbread';
+import Mixedbread from '@mixedbread/sdk';
+
+const server = createMixedbreadSearchAPI({
+  client: new Mixedbread({
+    apiKey: process.env.MIXEDBREAD_API_KEY,
+  }),
+  storeIdentifier: process.env.MIXEDBREAD_STORE_ID!,
+});
+`;
+			return {
+				next: `${server}
+export const { GET } = server;
+`,
+				"react-router": `import type { Route } from './+types/search';
+${server}
+export async function loader({ request }: Route.LoaderArgs) {
+  return server.GET(request);
+}
+`,
+				"tanstack-start": `import { createFileRoute } from '@tanstack/react-router';
+${server}
+export const Route = createFileRoute('/api/search')({
+  server: {
+    handlers: {
+      GET: async ({ request }) => server.GET(request),
+    },
+  },
+});
+`,
+				waku: `${server}
+export const { GET } = server;
+`
+			};
+		})()
+	}
+};
+const staticRoute = (framework, route, imports, documents) => routeModule(framework, route, {
+	imports,
+	body: `Response.json(await ${documents})`,
+	revalidate: true,
+	static: true
+});
+const search = {
+	id: "search",
+	title: "Search",
+	description: "replace the default search with a 3rd party search solution",
+	requires: [docs],
+	supports: (project) => project.source.loader || project.source.dynamic || "`lib/source.ts` must export a `source` loader",
+	options: { provider: {
+		message: "Choose a search provider",
+		choices: Object.entries(providers).map(([value, { label, hint }]) => ({
+			value,
+			label,
+			hint
+		}))
+	} },
+	async apply(ctx, { provider: name }) {
+		const { project } = ctx;
+		const { baseDir } = project;
+		const framework = reactFramework(project);
+		const provider = providers[name];
+		if (project.static && !provider.static) throw new Error(`${provider.label} requires a server at runtime`);
+		const env = publicEnv(framework === "next");
+		ctx.addDependencies(provider.dependencies);
+		await ctx.write(path.join(baseDir, "components/search.tsx"), provider.dialog(env));
+		const searchRoute = await findSource(project.cwd, path.join(baseDir, project.info.routesDir), "createFromSource(", (file) => /(^|[\\/])search(\.ts|[\\/]route\.ts)$/.test(file));
+		if (provider.searchRoute) {
+			if (searchRoute) await ctx.write(searchRoute, provider.searchRoute[framework]);
+			else ctx.note("Create the search route with `createMixedbreadSearchAPI`, see https://fumadocs.dev/docs/headless/search/mixedbread.");
+		} else if (searchRoute) await removeDefaultSearch(ctx, searchRoute);
+		if (provider.exportIndexes) {
+			const { imports, documents, file } = provider.exportIndexes(sourceRef(project.source.dynamic));
+			if (file) await ctx.write(path.join(baseDir, "lib/export-search-indexes.ts"), file(project.source.async));
+			const route = formatRoute({ segments: ["static.json"] }, framework, null);
+			await ctx.write(path.join(baseDir, route.file), staticRoute(framework, route, imports, documents));
+			if (framework === "react-router") await registerReactRouterRoutes(ctx, [route]);
+			else if (framework === "tanstack-start" && project.configFile) await ctx.source(project.configFile, (file) => addTanstackPrerender(file, [route.path]));
+		}
+		const rootProvider = await findSource(project.cwd, baseDir, "<RootProvider");
+		if (!(rootProvider !== void 0 && await ctx.source(rootProvider, (file) => {
+			const element = findJsxElement(file, "RootProvider")?.openingElement;
+			if (!element || file.code.slice(element.start, element.end).includes("search=")) return;
+			addJsxAttribute(file, element, "search={{ SearchDialog }}");
+			addImport(file, {
+				from: "@/components/search",
+				default: "SearchDialog"
+			});
+		}))) ctx.note("Pass `search={{ SearchDialog }}` from `@/components/search` to `<RootProvider />`.");
+		if (provider.sync) {
+			const output = {
+				next: ".next/server/app/static.json.body",
+				"react-router": "build/client/static.json",
+				"tanstack-start": project.static ? "dist/client/static.json" : ".output/public/static.json",
+				waku: "dist/public/static.json"
+			}[framework];
+			await ctx.write("scripts/sync-content.ts", provider.sync(env, project.source.dir));
+			await ctx.packageJson((data) => {
+				const build = data.scripts?.build ?? "";
+				if (build.includes("sync-content")) return;
+				const sync = `node --env-file-if-exists=.env.local scripts/sync-content.ts${provider.exportIndexes ? ` ${output}` : ""}`;
+				scripts(data, { build: build ? `${build} && ${sync}` : sync });
+			});
+		}
+		for (const key of provider.publicEnv) ctx.env(env.prefix + key, "");
+		for (const key of provider.privateEnv) ctx.env(key, "");
+		ctx.note(`Fill the ${provider.label} keys in \`.env.local\`, the search index is synced after each build.\nSee https://fumadocs.dev/docs/headless/search/${name}.`);
+	}
+};
+/** remove the default search route, which conflicts with the search provider */
+async function removeDefaultSearch(ctx, file) {
+	const { baseDir, framework } = ctx.project;
+	await ctx.remove(file);
+	if (framework !== "react-router") return;
+	const entry = posix(path.relative(baseDir, file));
+	await ctx.source(path.join(baseDir, "routes.ts"), (source) => {
+		filterReactRouterRoute(source, (item) => item.entry !== entry);
+	});
+	await ctx.source("react-router.config.ts", (source) => {
+		filterReactRouterPrerenderArray(source, "excluded", (item) => item !== "/api/search");
+	});
+}
+//#endregion
+export { search as t };
+
+//# sourceMappingURL=search-iphnSVVY.js.map

package/dist/search-iphnSVVY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-iphnSVVY.js","names":[],"sources":["../src/features/search.ts"],"sourcesContent":["import path from 'node:path';\nimport type { Feature, FeatureContext } from '@/features';\nimport type { ReactFramework } from '@/project';\nimport { type FormattedRoute, formatRoute, routeModule } from '@/project/route';\nimport {\n  addImport,\n  addJsxAttribute,\n  addTanstackPrerender,\n  filterReactRouterPrerenderArray,\n  filterReactRouterRoute,\n  findJsxElement,\n} from '@/codemod';\nimport { docs } from './docs';\nimport {\n  findSource,\n  posix,\n  reactFramework,\n  registerReactRouterRoutes,\n  scripts,\n  type SourceRef,\n  sourceRef,\n} from './utils';\n\n/** how client code reads public env variables */\ninterface Env {\n  prefix: string;\n  read: string;\n}\n\nconst publicEnv = (next: boolean): Env =>\n  next\n    ? { prefix: 'NEXT_PUBLIC_', read: 'process.env.NEXT_PUBLIC_' }\n    : { prefix: 'VITE_', read: 'import.meta.env.VITE_' };\n\nconst dialogImports = `import {\n  SearchDialog,\n  SearchDialogClose,\n  SearchDialogContent,\n  SearchDialogFooter,\n  SearchDialogHeader,\n  SearchDialogIcon,\n  SearchDialogInput,\n  SearchDialogList,\n  SearchDialogOverlay,\n  type SharedProps,\n} from 'fumadocs-ui/components/dialog/search';\nimport { useI18n } from 'fumadocs-ui/contexts/i18n';`;\n\nconst dialogBody = (footer: string, url: string) => `  return (\n    <SearchDialog search={search} onSearchChange={setSearch} isLoading={query.isLoading} {...props}>\n      <SearchDialogOverlay />\n      <SearchDialogContent>\n        <SearchDialogHeader>\n          <SearchDialogIcon />\n          <SearchDialogInput />\n          <SearchDialogClose />\n        </SearchDialogHeader>\n        <SearchDialogList items={query.data !== 'empty' ? query.data : null} />\n        <SearchDialogFooter>\n          <a\n            href=\"${url}\"\n            rel=\"noreferrer noopener\"\n            className=\"ms-auto text-xs text-fd-muted-foreground\"\n          >\n            Search powered by ${footer}\n          </a>\n        </SearchDialogFooter>\n      </SearchDialogContent>\n    </SearchDialog>\n  );\n}\n`;\n\n/** `structuredData` is a function on async collections (React Router & TanStack Start) */\nconst typesenseIndexes = (\n  async: boolean,\n  { ref, resolved }: SourceRef,\n) => `import { ${ref} } from '@/lib/source';\nimport type { DocumentRecord } from 'typesense-fumadocs-adapter';\n\nexport async function exportSearchIndexes() {\n  const results: DocumentRecord[] = [];\n  for (const page of ${resolved}.getPages()) {\n    results.push({\n      _id: page.url,\n      structured: ${async ? 'await page.data.structuredData()' : 'page.data.structuredData'},\n      url: page.url,\n      title: page.data.title,\n      description: page.data.description,\n      locale: page.locale,\n    });\n  }\n  return results;\n}\n`;\n\nconst syncScript = (imports: string, body: string) => `import * as fs from 'node:fs/promises';\n${imports}\n\nasync function main(filePath: string) {\n  const content = await fs.readFile(filePath);\n  const records = JSON.parse(content.toString()) as DocumentRecord[];\n${body}\n  console.log(\\`search updated: \\${records.length} records\\`);\n}\n\n// the path of pre-rendered \\`static.json\\`\nconst filePath = process.argv[2];\nif (!filePath) throw new Error('missing the path of static.json');\nvoid main(filePath);\n`;\n\ninterface Provider {\n  label: string;\n  hint: string;\n  dependencies: Record<string, string | null>;\n  /** keys exposed to the client, prefixed per framework */\n  publicEnv: string[];\n  privateEnv: string[];\n  /** works without a server at runtime */\n  static: boolean;\n  dialog: (env: Env) => string;\n  /** exports search indexes to a pre-rendered `static.json`, synced by `sync` after build */\n  exportIndexes?: (src: SourceRef) => {\n    imports: string;\n    /** expression producing the documents */\n    documents: string;\n    /** generated `lib/export-search-indexes.ts`, for providers without a `toDocuments()` */\n    file?: (async: boolean) => string;\n  };\n  sync?: (env: Env, dir: string) => string;\n  /** server-side search, replaces the default search route */\n  searchRoute?: Record<ReactFramework, string>;\n}\n\nconst providers = {\n  'orama-cloud': {\n    label: 'Orama Cloud',\n    hint: 'signup needed',\n    dependencies: { '@orama/core': null },\n    publicEnv: ['ORAMA_DATASOURCE_ID', 'ORAMA_PROJECT_ID', 'ORAMA_API_KEY'],\n    privateEnv: ['ORAMA_PRIVATE_API_KEY'],\n    static: true,\n    dialog: (env) => `'use client';\n${dialogImports}\nimport { useDocsSearch } from 'fumadocs-core/search/client';\nimport { OramaCloud } from '@orama/core';\n\nconst client = new OramaCloud({\n  projectId: ${env.read}ORAMA_PROJECT_ID!,\n  apiKey: ${env.read}ORAMA_API_KEY!,\n});\n\nexport default function CustomSearchDialog(props: SharedProps) {\n  const { locale } = useI18n();\n  const { search, setSearch, query } = useDocsSearch({\n    type: 'orama-cloud',\n    client,\n    locale,\n  });\n\n${dialogBody('Orama', 'https://orama.com')}`,\n    exportIndexes: ({ ref }) => ({\n      imports: `import { ${ref} } from '@/lib/source';\nimport { toDocuments } from 'fumadocs-core/search/orama-cloud';`,\n      documents: `toDocuments(${ref})`,\n    }),\n    sync: (env) =>\n      syncScript(\n        `import { type OramaDocument as DocumentRecord, sync } from 'fumadocs-core/search/orama-cloud';\nimport { OramaCloud } from '@orama/core';`,\n        `  const orama = new OramaCloud({\n    projectId: process.env.${env.prefix}ORAMA_PROJECT_ID!,\n    apiKey: process.env.ORAMA_PRIVATE_API_KEY!,\n  });\n\n  await sync(orama, {\n    index: process.env.${env.prefix}ORAMA_DATASOURCE_ID!,\n    documents: records,\n  });\n`,\n      ),\n  },\n  algolia: {\n    label: 'Algolia',\n    hint: 'signup needed',\n    dependencies: { algoliasearch: null },\n    publicEnv: ['ALGOLIA_APP_ID', 'ALGOLIA_SEARCH_KEY'],\n    privateEnv: ['ALGOLIA_WRITE_KEY'],\n    static: true,\n    dialog: (env) => `'use client';\n${dialogImports}\nimport { useDocsSearch } from 'fumadocs-core/search/client';\nimport { algoliaClient } from 'fumadocs-core/search/client/algolia';\nimport { liteClient } from 'algoliasearch/lite';\n\nconst algolia = liteClient(${env.read}ALGOLIA_APP_ID!, ${env.read}ALGOLIA_SEARCH_KEY!);\n\nexport default function CustomSearchDialog(props: SharedProps) {\n  const { locale } = useI18n();\n  const { search, setSearch, query } = useDocsSearch({\n    client: algoliaClient({\n      client: algolia,\n      indexName: 'document',\n      locale,\n    }),\n  });\n\n${dialogBody('Algolia', 'https://algolia.com')}`,\n    exportIndexes: ({ ref }) => ({\n      imports: `import { ${ref} } from '@/lib/source';\nimport { toDocuments } from 'fumadocs-core/search/algolia';`,\n      documents: `toDocuments(${ref})`,\n    }),\n    sync: (env) =>\n      syncScript(\n        `import { type DocumentRecord, sync } from 'fumadocs-core/search/algolia';\nimport { algoliasearch } from 'algoliasearch';`,\n        `  const client = algoliasearch(\n    process.env.${env.prefix}ALGOLIA_APP_ID!,\n    process.env.ALGOLIA_WRITE_KEY!,\n  );\n\n  await sync(client, {\n    indexName: 'document',\n    documents: records,\n  });\n`,\n      ),\n  },\n  typesense: {\n    label: 'Typesense',\n    hint: 'self-hosted or cloud, community adapter',\n    dependencies: { typesense: null, 'typesense-fumadocs-adapter': null },\n    publicEnv: ['TYPESENSE_URL', 'TYPESENSE_SEARCH_KEY'],\n    privateEnv: ['TYPESENSE_API_KEY'],\n    static: true,\n    dialog: (env) => `'use client';\n${dialogImports}\nimport { Client } from 'typesense';\nimport { useTypesenseSearch } from 'typesense-fumadocs-adapter/client';\n\nconst client = new Client({\n  nodes: [{ url: ${env.read}TYPESENSE_URL! }],\n  apiKey: ${env.read}TYPESENSE_SEARCH_KEY!,\n});\n\nexport default function CustomSearchDialog(props: SharedProps) {\n  const { locale } = useI18n();\n  const { search, setSearch, query } = useTypesenseSearch({\n    typesenseCollectionName: 'docs',\n    locale,\n    client,\n  });\n\n${dialogBody('Typesense', 'https://typesense.org')}`,\n    exportIndexes: (src) => ({\n      imports: \"import { exportSearchIndexes } from '@/lib/export-search-indexes';\",\n      documents: 'exportSearchIndexes()',\n      file: (async) => typesenseIndexes(async, src),\n    }),\n    sync: (env) =>\n      syncScript(\n        `import { type DocumentRecord, sync } from 'typesense-fumadocs-adapter';\nimport { Client } from 'typesense';`,\n        `  const client = new Client({\n    nodes: [{ url: process.env.${env.prefix}TYPESENSE_URL! }],\n    apiKey: process.env.TYPESENSE_API_KEY!,\n    connectionTimeoutSeconds: 60 * 15,\n  });\n\n  await sync(client, {\n    typesenseCollectionName: 'docs',\n    documents: records,\n  });\n`,\n      ),\n  },\n  mixedbread: {\n    label: 'Mixedbread',\n    hint: 'AI search, signup needed',\n    dependencies: { '@mixedbread/sdk': null },\n    publicEnv: [],\n    privateEnv: ['MIXEDBREAD_API_KEY', 'MIXEDBREAD_STORE_ID'],\n    static: false,\n    dialog: () => `'use client';\n${dialogImports}\nimport { useDocsSearch } from 'fumadocs-core/search/client';\nimport { fetchClient } from 'fumadocs-core/search/client/fetch';\n\nexport default function CustomSearchDialog(props: SharedProps) {\n  const { locale } = useI18n();\n  const { search, setSearch, query } = useDocsSearch({\n    client: fetchClient({\n      api: '/api/search',\n      locale,\n    }),\n  });\n\n${dialogBody('Mixedbread', 'https://mixedbread.com')}`,\n    sync: (_env, dir) => `import { spawnSync } from 'node:child_process';\n\n// sync the content with Mixedbread CLI\nconst result = spawnSync(\n  'npx',\n  ['--yes', '@mixedbread/cli', 'vs', 'sync', process.env.MIXEDBREAD_STORE_ID!, '${dir}', '--ci'],\n  { stdio: 'inherit' },\n);\n\nprocess.exit(result.status ?? 1);\n`,\n    searchRoute: (() => {\n      const server = `import { createMixedbreadSearchAPI } from 'fumadocs-core/search/mixedbread';\nimport Mixedbread from '@mixedbread/sdk';\n\nconst server = createMixedbreadSearchAPI({\n  client: new Mixedbread({\n    apiKey: process.env.MIXEDBREAD_API_KEY,\n  }),\n  storeIdentifier: process.env.MIXEDBREAD_STORE_ID!,\n});\n`;\n      return {\n        next: `${server}\nexport const { GET } = server;\n`,\n        'react-router': `import type { Route } from './+types/search';\n${server}\nexport async function loader({ request }: Route.LoaderArgs) {\n  return server.GET(request);\n}\n`,\n        'tanstack-start': `import { createFileRoute } from '@tanstack/react-router';\n${server}\nexport const Route = createFileRoute('/api/search')({\n  server: {\n    handlers: {\n      GET: async ({ request }) => server.GET(request),\n    },\n  },\n});\n`,\n        waku: `${server}\nexport const { GET } = server;\n`,\n      };\n    })(),\n  },\n} satisfies Record<string, Provider>;\n\nexport type SearchProvider = keyof typeof providers;\n\nconst staticRoute = (\n  framework: ReactFramework,\n  route: FormattedRoute,\n  imports: string,\n  documents: string,\n) =>\n  routeModule(framework, route, {\n    imports,\n    body: `Response.json(await ${documents})`,\n    revalidate: true,\n    static: true,\n  });\n\nexport const search: Feature<{ provider: SearchProvider }> = {\n  id: 'search',\n  title: 'Search',\n  description: 'replace the default search with a 3rd party search solution',\n  requires: [docs],\n  supports: (project) =>\n    project.source.loader ||\n    project.source.dynamic ||\n    '`lib/source.ts` must export a `source` loader',\n  options: {\n    provider: {\n      message: 'Choose a search provider',\n      choices: Object.entries(providers).map(([value, { label, hint }]) => ({\n        value: value as SearchProvider,\n        label,\n        hint,\n      })),\n    },\n  },\n  async apply(ctx, { provider: name }) {\n    const { project } = ctx;\n    const { baseDir } = project;\n    const framework = reactFramework(project);\n    const provider: Provider = providers[name];\n    if (project.static && !provider.static)\n      throw new Error(`${provider.label} requires a server at runtime`);\n    const env = publicEnv(framework === 'next');\n\n    ctx.addDependencies(provider.dependencies);\n    await ctx.write(path.join(baseDir, 'components/search.tsx'), provider.dialog(env));\n\n    // other routes (e.g. MCP) also create a search server, only match the search route itself\n    const searchRoute = await findSource(\n      project.cwd,\n      path.join(baseDir, project.info.routesDir),\n      'createFromSource(',\n      (file) => /(^|[\\\\/])search(\\.ts|[\\\\/]route\\.ts)$/.test(file),\n    );\n    if (provider.searchRoute) {\n      if (searchRoute) await ctx.write(searchRoute, provider.searchRoute[framework]);\n      else\n        ctx.note(\n          'Create the search route with `createMixedbreadSearchAPI`, see https://fumadocs.dev/docs/headless/search/mixedbread.',\n        );\n    } else if (searchRoute) {\n      await removeDefaultSearch(ctx, searchRoute);\n    }\n\n    if (provider.exportIndexes) {\n      const { imports, documents, file } = provider.exportIndexes(\n        sourceRef(project.source.dynamic),\n      );\n      if (file)\n        await ctx.write(\n          path.join(baseDir, 'lib/export-search-indexes.ts'),\n          file(project.source.async),\n        );\n\n      const route = formatRoute({ segments: ['static.json'] }, framework, null);\n      await ctx.write(\n        path.join(baseDir, route.file),\n        staticRoute(framework, route, imports, documents),\n      );\n\n      if (framework === 'react-router') {\n        await registerReactRouterRoutes(ctx, [route]);\n      } else if (framework === 'tanstack-start' && project.configFile) {\n        await ctx.source(project.configFile, (file) => addTanstackPrerender(file, [route.path]));\n      }\n    }\n\n    const rootProvider = await findSource(project.cwd, baseDir, '<RootProvider');\n    const edited =\n      rootProvider !== undefined &&\n      (await ctx.source(rootProvider, (file) => {\n        const element = findJsxElement(file, 'RootProvider')?.openingElement;\n        if (!element || file.code.slice(element.start, element.end).includes('search=')) return;\n        addJsxAttribute(file, element, 'search={{ SearchDialog }}');\n        addImport(file, { from: '@/components/search', default: 'SearchDialog' });\n      }));\n    if (!edited)\n      ctx.note(\n        'Pass `search={{ SearchDialog }}` from `@/components/search` to `<RootProvider />`.',\n      );\n\n    if (provider.sync) {\n      // path of the pre-rendered `static.json`, passed to the sync script\n      const output = {\n        next: '.next/server/app/static.json.body',\n        'react-router': 'build/client/static.json',\n        'tanstack-start': project.static ? 'dist/client/static.json' : '.output/public/static.json',\n        waku: 'dist/public/static.json',\n      }[framework];\n      await ctx.write('scripts/sync-content.ts', provider.sync(env, project.source.dir));\n      await ctx.packageJson((data) => {\n        const build = data.scripts?.build ?? '';\n        if (build.includes('sync-content')) return;\n        const sync = `node --env-file-if-exists=.env.local scripts/sync-content.ts${provider.exportIndexes ? ` ${output}` : ''}`;\n        scripts(data, { build: build ? `${build} && ${sync}` : sync });\n      });\n    }\n\n    for (const key of provider.publicEnv) ctx.env(env.prefix + key, '');\n    for (const key of provider.privateEnv) ctx.env(key, '');\n    ctx.note(\n      `Fill the ${provider.label} keys in \\`.env.local\\`, the search index is synced after each build.\\nSee https://fumadocs.dev/docs/headless/search/${name}.`,\n    );\n  },\n};\n\n/** remove the default search route, which conflicts with the search provider */\nasync function removeDefaultSearch(ctx: FeatureContext, file: string) {\n  const { baseDir, framework } = ctx.project;\n  await ctx.remove(file);\n  if (framework !== 'react-router') return;\n\n  const entry = posix(path.relative(baseDir, file));\n  await ctx.source(path.join(baseDir, 'routes.ts'), (source) => {\n    filterReactRouterRoute(source, (item) => item.entry !== entry);\n  });\n  await ctx.source('react-router.config.ts', (source) => {\n    filterReactRouterPrerenderArray(source, 'excluded', (item) => item !== '/api/search');\n  });\n}\n"],"mappings":"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"}

package/dist/utils-B1Xy4l_a.d.ts

@@ -0,0 +1,43 @@
+import { a as Project, o as ReactFramework } from "./index-BCVGQxn9.js";
+import { i as FeatureContext, s as PackageJson } from "./index-CR9T40ox.js";
+//#region src/project/route.d.ts
+interface FormattedRoute {
+  /** route file, relative to the base dir */
+  file: string;
+  /** route string of the framework, e.g. for `RouteContext<'...'>`, `createFileRoute('...')`, `route('...')` or `ApiContext<'...'>` */
+  path: string;
+  /** path-to-regexp pattern, for the Next.js proxy matcher and rewrites */
+  pattern: string;
+}
+//#endregion
+//#region src/features/utils.d.ts
+/** the shallowest `.ts`/`.tsx` file under `dir` whose content includes `needle`, relative to `cwd` */
+declare function findSource(cwd: string, dir: string, needle: string, match?: (file: string) => boolean): Promise<string | undefined>;
+declare function scripts(json: PackageJson, scripts: Record<string, string>): void;
+declare const reactOnly: (project: Project) => "Astro is not supported by this feature" | true;
+declare function reactFramework(project: Project): ReactFramework;
+/** POSIX path for generated code and route configs */
+declare const posix: (file: string) => string;
+/** add an export to a source file, unless a declaration with the same name exists */
+declare function addExport(ctx: FeatureContext, file: string, name: string, code: string): Promise<boolean>;
+/** add a page URL helper to `lib/shared.ts`, where the route constants live */
+declare function addPageUrl(ctx: FeatureContext, name: string, code: string): Promise<boolean>;
+/** the value of a route constant in `lib/shared.ts`, defined with `value` when missing */
+declare function sharedRoute(ctx: FeatureContext, name: string, value: string): Promise<string>;
+/** add routes to `routes.ts`, or tell the user when the config isn't an array (e.g. file-based routes) */
+declare function registerReactRouterRoutes(ctx: FeatureContext, routes: (FormattedRoute | string)[]): Promise<boolean>;
+/** features reading page Markdown need Fumadocs MDX collections, or a runtime source exposing `page.data.content` */
+declare const requiresMarkdown: (project: Project) => "Astro is not supported by this feature" | "requires Fumadocs MDX or a runtime content source" | true;
+/** how generated code refers to the loader of `lib/source.ts` */
+interface SourceRef {
+  /** resolved on demand, `lib/source.ts` exports `getSource()` instead of `source` */
+  dynamic: boolean;
+  /** passed to Fumadocs APIs, which accept a loader or a function resolving one */
+  ref: string;
+  /** reads the loader inside an async function */
+  resolved: string;
+}
+declare function sourceRef(dynamic: boolean): SourceRef;
+//#endregion
+export { posix as a, registerReactRouterRoutes as c, sharedRoute as d, sourceRef as f, findSource as i, requiresMarkdown as l, addExport as n, reactFramework as o, FormattedRoute as p, addPageUrl as r, reactOnly as s, SourceRef as t, scripts as u };
+//# sourceMappingURL=utils-B1Xy4l_a.d.ts.map

package/dist/utils-B1Xy4l_a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-B1Xy4l_a.d.ts","names":[],"sources":["../src/project/route.ts","../src/features/utils.ts"],"mappings":";;;UAoBiB;;EAEf;;EAEA;;EAEA;;;;;iBClBoB,WACpB,aACA,aACA,gBACA,SAAQ,2BAAqC;iBAiB/B,QAAQ,MAAM,aAAa,SAAS;cAIvC,YAAS,SAAa;iBAGnB,eAAe,SAAS,UAAU;;cAMrC,QAAK;;iBAGI,UAAU,KAAK,gBAAgB,cAAc,cAAc,eAAY;;iBAQvE,WAAW,KAAK,gBAAgB,cAAc,eAAY;;iBAe1D,YAAY,KAAK,gBAAgB,cAAc,gBAAa;;iBAY5D,0BACpB,KAAK,gBACL,SAAS,6BACR;;cAyBU,mBAAgB,SAAa;;UAQzB;;EAEf;;EAEA;;EAEA;;iBAGc,UAAU,mBAAmB"}