@hanzo/docs-create-app 16.0.50

package/dist/plugins/orama-cloud.js

@@ -0,0 +1,296 @@
+import { a as copy, c as writeFile, o as pick, r as sourceDir, t as depVersions } from "../constants-CbNzssp2.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { IndentationText, Project, QuoteKind, StructureKind, SyntaxKind, ts } from "ts-morph";
+
+//#region src/transform/shared.ts
+const project = new Project({ manipulationSettings: {
+	indentationText: IndentationText.TwoSpaces,
+	quoteKind: QuoteKind.Single
+} });
+async function createSourceFile(path) {
+	return project.createSourceFile(path, (await fs.readFile(path)).toString(), { overwrite: true });
+}
+function getCodeValue(v) {
+	return new Function(`return ${v}`)();
+}
+
+//#endregion
+//#region src/transform/react-router.ts
+var SyntaxKind$1 = ts.SyntaxKind;
+/**
+* filter items in a specific array initializer in the prerender function
+*/
+function filterReactRouterPrerenderArray(sourceFile, array, filter) {
+	const methodBody = getPrerenderMethod(sourceFile)?.getBody();
+	if (!methodBody) return;
+	const initializer = methodBody.getDescendantsOfKind(SyntaxKind$1.VariableDeclaration).find((item) => item.getName() === array)?.getInitializerIfKind(SyntaxKind$1.ArrayLiteralExpression);
+	if (!initializer) return;
+	for (const element of initializer.getElements()) if (!filter(getCodeValue(element.getText()))) initializer.removeElement(element);
+}
+/**
+* Add a new route to route config
+*/
+function addReactRouterRoute(sourceFile, routes) {
+	modifyReactRouterRoutes(sourceFile, (arr) => {
+		for (const { path, entry } of routes) arr.addElement(`route('${path}', '${entry}')`);
+	});
+}
+/**
+* Remove routes from route config (root level only)
+*/
+function filterReactRouterRoute(sourceFile, filter) {
+	modifyReactRouterRoutes(sourceFile, (arr) => {
+		for (const element of arr.getElements()) {
+			if (!element.isKind(SyntaxKind$1.CallExpression) || element.getFirstChildByKind(SyntaxKind$1.Identifier)?.getText() !== "route") continue;
+			const args = element.getArguments();
+			if (filter({
+				path: getCodeValue(args[0].getText()),
+				entry: getCodeValue(args[1].getText())
+			})) continue;
+			arr.removeElement(element);
+		}
+	});
+}
+function modifyReactRouterRoutes(sourceFile, mod) {
+	const initializer = sourceFile.getDefaultExportSymbol()?.getValueDeclaration()?.getFirstDescendantByKind(SyntaxKind$1.ArrayLiteralExpression);
+	if (initializer) mod(initializer);
+}
+/**
+* Find the prerender method from the config
+*/
+function getPrerenderMethod(sourceFile) {
+	return sourceFile.getDefaultExportSymbol()?.getValueDeclaration()?.getFirstDescendantByKind(SyntaxKind$1.ObjectLiteralExpression)?.getProperty("prerender")?.asKind(SyntaxKind$1.MethodDeclaration) ?? null;
+}
+
+//#endregion
+//#region src/transform/tanstack-start.ts
+/**
+* Add path to the `pages` array in tanstack start vite config.
+*
+* If the `pages` property doesn't exist, create one.
+*/
+function addTanstackPrerender(sourceFile, paths) {
+	const optionsArg = getTanstackStartCall(sourceFile)?.getArguments()[0]?.asKind(SyntaxKind.ObjectLiteralExpression);
+	if (!optionsArg) return;
+	const pagesProperty = optionsArg.getProperty("pages")?.asKind(SyntaxKind.PropertyAssignment);
+	function toItem(path) {
+		return `{ path: '${path}' }`;
+	}
+	if (pagesProperty) {
+		const initializer = pagesProperty.getInitializerIfKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+		const existingPaths = /* @__PURE__ */ new Set();
+		for (const element of initializer.getElements()) {
+			const value = element.asKind(SyntaxKind.ObjectLiteralExpression)?.getProperty("path")?.asKind(SyntaxKind.PropertyAssignment)?.getInitializer()?.getText();
+			if (value) existingPaths.add(getCodeValue(value));
+		}
+		for (const path of paths) {
+			if (existingPaths.has(path)) continue;
+			initializer.addElement(toItem(path));
+		}
+	} else optionsArg.addProperty(`pages: [\n${paths.map((path) => `  ${toItem(path)}`).join(",\n")}\n]`);
+}
+/**
+* Find the tanstackStart call expression
+*/
+function getTanstackStartCall(sourceFile) {
+	const pluginsProperty = sourceFile.getDefaultExportSymbol()?.getValueDeclaration()?.getFirstDescendantByKind(SyntaxKind.ObjectLiteralExpression)?.getProperty("plugins")?.getFirstChildByKind(SyntaxKind.ArrayLiteralExpression);
+	if (!pluginsProperty) return;
+	for (const element of pluginsProperty.getElements()) {
+		const expression = element.asKind(SyntaxKind.CallExpression);
+		if (expression?.getFirstChildByKind(SyntaxKind.Identifier)?.getText() === "tanstackStart") return expression;
+	}
+}
+
+//#endregion
+//#region src/transform/index.ts
+async function rootProvider({ appDir, template }, fn) {
+	const file = await createSourceFile(path.join(appDir, template.rootProviderPath));
+	fn({ addSearchDialog(specifier) {
+		const elements = file.getDescendantsOfKind(SyntaxKind.JsxElement);
+		for (const element of elements) {
+			const provider = element.getFirstChildByKind(SyntaxKind.JsxOpeningElement);
+			if (provider?.getTagNameNode().getText() !== "RootProvider") continue;
+			if (provider.getAttributes().some((attr) => attr.isKind(SyntaxKind.JsxAttribute) && attr.getNameNode().getText() === "search")) continue;
+			provider.addAttribute({
+				kind: StructureKind.JsxAttribute,
+				name: "search",
+				initializer: "{{ SearchDialog }}"
+			});
+			file.addImportDeclaration({
+				moduleSpecifier: specifier,
+				defaultImport: "SearchDialog"
+			});
+			break;
+		}
+	} });
+	await file.save();
+}
+async function reactRouterRoutes({ dest, appDir }, fn) {
+	const configFile = await createSourceFile(path.join(dest, "react-router.config.ts"));
+	const routesFile = await createSourceFile(path.join(appDir, "routes.ts"));
+	const tasks = [];
+	function normalizePath(v) {
+		return v.split("/").filter(Boolean).join("/");
+	}
+	fn({
+		addRoute: (p, entry, code) => {
+			addReactRouterRoute(routesFile, [{
+				path: p,
+				entry
+			}]);
+			if (code) tasks.push(fs.writeFile(path.join(appDir, entry), code));
+		},
+		removeRoute: (p) => {
+			const normalizedPath = normalizePath(p);
+			filterReactRouterRoute(routesFile, (item) => {
+				if (normalizePath(item.path) !== normalizedPath) return true;
+				tasks.push(fs.unlink(path.join(appDir, item.entry)).catch(() => null));
+				return false;
+			});
+			filterReactRouterPrerenderArray(configFile, "excluded", (item) => normalizePath(item) !== normalizedPath);
+			filterReactRouterPrerenderArray(configFile, "paths", (item) => normalizePath(item) !== normalizedPath);
+		}
+	});
+	await Promise.all([
+		...tasks,
+		routesFile.save(),
+		configFile.save()
+	]);
+}
+async function tanstackStartRoutes({ appDir, dest }, fn) {
+	const configFile = await createSourceFile(path.join(dest, "vite.config.ts"));
+	const tasks = [];
+	fn({
+		addRoute(options) {
+			if (options.code) tasks.push(fs.writeFile(path.join(appDir, "routes", options.path), options.code));
+			if (options.prerender) addTanstackPrerender(configFile, [options.route]);
+		},
+		removeRoute(options) {
+			tasks.push(fs.unlink(path.join(appDir, "routes", options.path)).catch(() => null));
+		}
+	});
+	await Promise.all([...tasks, configFile.save()]);
+}
+
+//#endregion
+//#region src/plugins/orama-cloud.ts
+function oramaCloud() {
+	return {
+		packageJson(packageJson) {
+			return {
+				...packageJson,
+				scripts: {
+					...packageJson.scripts,
+					build: `${packageJson.scripts.build} && bun scripts/sync-content.ts`
+				},
+				dependencies: {
+					...packageJson.dependencies,
+					...pick(depVersions, ["@orama/core"])
+				}
+			};
+		},
+		readme(content) {
+			return `${content}\n\n## Orama Cloud
+    
+This project uses Orama Cloud for 3rd party search solution.
+
+See https://hanzoai.github.io/docs/docs/headless/search/orama-cloud for integrating Orama Cloud to Hanzo Docs.`;
+		},
+		async afterWrite() {
+			const { dest, appDir, template } = this;
+			await copy(path.join(sourceDir, "template/+orama-cloud/@root"), dest);
+			await copy(path.join(sourceDir, "template/+orama-cloud/@app"), appDir);
+			await rootProvider(this, (mod) => mod.addSearchDialog("@/components/search"));
+			if (template.value === "tanstack-start") await tanstackStartRoutes(this, (mod) => {
+				mod.addRoute({
+					path: "static[.]json.ts",
+					route: "/static.json",
+					code: route.tanstack,
+					prerender: true
+				});
+				mod.removeRoute({
+					path: "api/search.ts",
+					route: "/api/search"
+				});
+			});
+			else if (template.value.startsWith("react-router")) await reactRouterRoutes(this, (mod) => {
+				mod.addRoute("static.json", "routes/static.ts", route["react-router"]);
+				mod.removeRoute("api/search");
+			});
+			else if (template.value.startsWith("+next")) await Promise.all([fs.unlink(path.join(appDir, "app/api/search/route.ts")).catch(() => null), writeFile(path.join(appDir, "app/static.json/route.ts"), route.next)]);
+			else await Promise.all([fs.unlink(path.join(appDir, "pages/_api/api/search.ts")).catch(() => null), writeFile(path.join(appDir, "pages/_api/static.json.ts"), route.waku)]);
+			const filePath = {
+				"+next+fuma-docs-mdx": ".next/server/app/static.json.body",
+				"+next+fuma-docs-mdx+static": ".next/server/app/static.json.body",
+				"tanstack-start": ".output/public/static.json",
+				"tanstack-start-spa": "dist/client/static.json",
+				"react-router": "build/client/static.json",
+				"react-router-spa": "build/client/static.json",
+				waku: "dist/public/static.json"
+			}[template.value];
+			await writeFile(path.join(dest, "scripts/sync-content.ts"), `import { type OramaDocument, sync } from '@hanzo/docs-core/search/orama-cloud';
+import * as fs from 'node:fs/promises';
+import { OramaCloud } from '@orama/core';
+
+// the path of pre-rendered \`static.json\`
+const filePath = '${filePath}';
+
+async function main() {
+  const orama = new OramaCloud({
+    projectId: process.env.NEXT_PUBLIC_ORAMA_PROJECT_ID,
+    apiKey: process.env.ORAMA_PRIVATE_API_KEY,
+  });
+
+  const content = await fs.readFile(filePath);
+  const records = JSON.parse(content.toString()) as OramaDocument[];
+
+  await sync(orama, {
+    index: process.env.NEXT_PUBLIC_ORAMA_DATASOURCE_ID,
+    documents: records,
+  });
+
+  console.log(\`search updated: \${records.length} records\`);
+}
+
+void main();`);
+		}
+	};
+}
+const route = {
+	next: `import { exportSearchIndexes } from '@/lib/export-search-indexes';
+
+export const revalidate = false;
+
+export async function GET() {
+  return Response.json(await exportSearchIndexes());
+}`,
+	"react-router": `import { exportSearchIndexes } from '@/lib/export-search-indexes';
+
+export async function loader() {
+  return Response.json(await exportSearchIndexes());
+}`,
+	tanstack: `import { createFileRoute } from '@tanstack/react-router';
+import { exportSearchIndexes } from '@/lib/export-search-indexes';
+
+export const Route = createFileRoute('/static.json')({
+  server: {
+    handlers: {
+      GET: async () => Response.json(await exportSearchIndexes()),
+    },
+  },
+});`,
+	waku: `import { exportSearchIndexes } from '@/lib/export-search-indexes';
+
+export async function GET() {
+  return Response.json(await exportSearchIndexes());
+}
+
+export const getConfig = () => ({
+  render: 'static',
+});`
+};
+
+//#endregion
+export { oramaCloud };
+//# sourceMappingURL=orama-cloud.js.map

package/dist/plugins/orama-cloud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orama-cloud.js","names":["SyntaxKind"],"sources":["../../src/transform/shared.ts","../../src/transform/react-router.ts","../../src/transform/tanstack-start.ts","../../src/transform/index.ts","../../src/plugins/orama-cloud.ts"],"sourcesContent":["import { IndentationText, Project, QuoteKind } from 'ts-morph';\nimport fs from 'node:fs/promises';\n\nconst project = new Project({\n  manipulationSettings: {\n    indentationText: IndentationText.TwoSpaces,\n    quoteKind: QuoteKind.Single,\n  },\n});\n\nexport async function createSourceFile(path: string) {\n  return project.createSourceFile(path, (await fs.readFile(path)).toString(), {\n    overwrite: true,\n  });\n}\n\nexport function getCodeValue(v: string) {\n  return new Function(`return ${v}`)();\n}\n","import { ArrayLiteralExpression, MethodDeclaration, SourceFile, ts } from 'ts-morph';\nimport { getCodeValue } from '@/transform/shared';\nimport SyntaxKind = ts.SyntaxKind;\n\n/**\n * filter items in a specific array initializer in the prerender function\n */\nexport function filterReactRouterPrerenderArray(\n  sourceFile: SourceFile,\n  array: 'paths' | 'excluded',\n  filter: (item: string) => boolean,\n) {\n  const methodBody = getPrerenderMethod(sourceFile)?.getBody();\n  if (!methodBody) return;\n\n  const initializer = methodBody\n    .getDescendantsOfKind(SyntaxKind.VariableDeclaration)\n    .find((item) => item.getName() === array)\n    ?.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression);\n\n  if (!initializer) return;\n  for (const element of initializer.getElements()) {\n    if (!filter(getCodeValue(element.getText()))) {\n      initializer.removeElement(element);\n    }\n  }\n}\n\n/**\n * Add a new route to route config\n */\nexport function addReactRouterRoute(\n  sourceFile: SourceFile,\n  routes: { path: string; entry: string }[],\n) {\n  modifyReactRouterRoutes(sourceFile, (arr) => {\n    for (const { path, entry } of routes) {\n      arr.addElement(`route('${path}', '${entry}')`);\n    }\n  });\n}\n\n/**\n * Remove routes from route config (root level only)\n */\nexport function filterReactRouterRoute(\n  sourceFile: SourceFile,\n  filter: (item: { path: string; entry: string }) => boolean,\n) {\n  modifyReactRouterRoutes(sourceFile, (arr) => {\n    for (const element of arr.getElements()) {\n      if (\n        !element.isKind(SyntaxKind.CallExpression) ||\n        element.getFirstChildByKind(SyntaxKind.Identifier)?.getText() !== 'route'\n      )\n        continue;\n      const args = element.getArguments();\n\n      if (\n        filter({\n          path: getCodeValue(args[0].getText()),\n          entry: getCodeValue(args[1].getText()),\n        })\n      )\n        continue;\n\n      arr.removeElement(element);\n    }\n  });\n}\n\nexport function modifyReactRouterRoutes(\n  sourceFile: SourceFile,\n  mod: (array: ArrayLiteralExpression) => void,\n) {\n  const initializer = sourceFile\n    .getDefaultExportSymbol()\n    ?.getValueDeclaration()\n    ?.getFirstDescendantByKind(SyntaxKind.ArrayLiteralExpression);\n  if (initializer) mod(initializer);\n}\n\n/**\n * Find the prerender method from the config\n */\nfunction getPrerenderMethod(sourceFile: SourceFile): MethodDeclaration | null {\n  return (\n    sourceFile\n      .getDefaultExportSymbol()\n      ?.getValueDeclaration()\n      ?.getFirstDescendantByKind(SyntaxKind.ObjectLiteralExpression)\n      ?.getProperty('prerender')\n      ?.asKind(SyntaxKind.MethodDeclaration) ?? null\n  );\n}\n","import { CallExpression, SourceFile, SyntaxKind } from 'ts-morph';\nimport { getCodeValue } from '@/transform/shared';\n\n/**\n * Add path to the `pages` array in tanstack start vite config.\n *\n * If the `pages` property doesn't exist, create one.\n */\nexport function addTanstackPrerender(sourceFile: SourceFile, paths: string[]) {\n  const optionsArg = getTanstackStartCall(sourceFile)\n    ?.getArguments()[0]\n    ?.asKind(SyntaxKind.ObjectLiteralExpression);\n  if (!optionsArg) {\n    return;\n  }\n\n  const pagesProperty = optionsArg.getProperty('pages')?.asKind(SyntaxKind.PropertyAssignment);\n\n  function toItem(path: string) {\n    return `{ path: '${path}' }`;\n  }\n\n  if (pagesProperty) {\n    const initializer = pagesProperty.getInitializerIfKindOrThrow(\n      SyntaxKind.ArrayLiteralExpression,\n    );\n\n    const existingPaths = new Set<string>();\n    for (const element of initializer.getElements()) {\n      const value = element\n        .asKind(SyntaxKind.ObjectLiteralExpression)\n        ?.getProperty('path')\n        ?.asKind(SyntaxKind.PropertyAssignment)\n        ?.getInitializer()\n        ?.getText();\n\n      if (value) {\n        existingPaths.add(getCodeValue(value));\n      }\n    }\n\n    for (const path of paths) {\n      if (existingPaths.has(path)) continue;\n      initializer.addElement(toItem(path));\n    }\n  } else {\n    optionsArg.addProperty(`pages: [\\n${paths.map((path) => `  ${toItem(path)}`).join(',\\n')}\\n]`);\n  }\n}\n\n/**\n * Find the tanstackStart call expression\n */\nfunction getTanstackStartCall(sourceFile: SourceFile): CallExpression | undefined {\n  const pluginsProperty = sourceFile\n    .getDefaultExportSymbol()\n    ?.getValueDeclaration()\n    ?.getFirstDescendantByKind(SyntaxKind.ObjectLiteralExpression)\n    ?.getProperty('plugins')\n    ?.getFirstChildByKind(SyntaxKind.ArrayLiteralExpression);\n\n  if (!pluginsProperty) return;\n\n  for (const element of pluginsProperty.getElements()) {\n    const expression = element.asKind(SyntaxKind.CallExpression);\n    if (expression?.getFirstChildByKind(SyntaxKind.Identifier)?.getText() === 'tanstackStart') {\n      return expression;\n    }\n  }\n}\n","import { TemplatePluginContext } from '@/index';\nimport { createSourceFile } from '@/transform/shared';\nimport path from 'node:path';\nimport {\n  addReactRouterRoute,\n  filterReactRouterPrerenderArray,\n  filterReactRouterRoute,\n} from '@/transform/react-router';\nimport fs from 'node:fs/promises';\nimport { addTanstackPrerender } from '@/transform/tanstack-start';\nimport { StructureKind, SyntaxKind } from 'ts-morph';\n\ninterface RootLayoutMod {\n  addSearchDialog: (specifier: string) => void;\n}\n\nexport async function rootProvider(\n  { appDir, template }: TemplatePluginContext,\n  fn: (mod: RootLayoutMod) => void,\n) {\n  const file = await createSourceFile(path.join(appDir, template.rootProviderPath));\n  fn({\n    addSearchDialog(specifier) {\n      const elements = file.getDescendantsOfKind(SyntaxKind.JsxElement);\n\n      for (const element of elements) {\n        const provider = element.getFirstChildByKind(SyntaxKind.JsxOpeningElement);\n        if (provider?.getTagNameNode().getText() !== 'RootProvider') continue;\n\n        // Skip if search prop already exists\n        if (\n          provider\n            .getAttributes()\n            .some(\n              (attr) =>\n                attr.isKind(SyntaxKind.JsxAttribute) && attr.getNameNode().getText() === 'search',\n            )\n        )\n          continue;\n\n        provider.addAttribute({\n          kind: StructureKind.JsxAttribute,\n          name: 'search',\n          initializer: '{{ SearchDialog }}',\n        });\n        file.addImportDeclaration({\n          moduleSpecifier: specifier,\n          defaultImport: 'SearchDialog',\n        });\n        break;\n      }\n    },\n  });\n  await file.save();\n}\n\ninterface ReactRouterRoutesMod {\n  /**\n   * @param path API route's path\n   * @param entry route's file path\n   * @param code create the file if specified\n   */\n  addRoute: (path: string, entry: string, code?: string) => void;\n\n  /**\n   * @param path API route's path\n   */\n  removeRoute: (path: string) => void;\n}\n\nexport async function reactRouterRoutes(\n  { dest, appDir }: TemplatePluginContext,\n  fn: (mod: ReactRouterRoutesMod) => void,\n) {\n  const configFile = await createSourceFile(path.join(dest, 'react-router.config.ts'));\n  const routesFile = await createSourceFile(path.join(appDir, 'routes.ts'));\n  const tasks: Promise<unknown>[] = [];\n\n  function normalizePath(v: string) {\n    return v.split('/').filter(Boolean).join('/');\n  }\n\n  fn({\n    addRoute: (p, entry, code) => {\n      addReactRouterRoute(routesFile, [{ path: p, entry }]);\n\n      if (code) {\n        tasks.push(fs.writeFile(path.join(appDir, entry), code));\n      }\n    },\n    removeRoute: (p) => {\n      const normalizedPath = normalizePath(p);\n\n      filterReactRouterRoute(routesFile, (item) => {\n        if (normalizePath(item.path) !== normalizedPath) return true;\n\n        tasks.push(fs.unlink(path.join(appDir, item.entry)).catch(() => null));\n        return false;\n      });\n\n      filterReactRouterPrerenderArray(\n        configFile,\n        'excluded',\n        (item) => normalizePath(item) !== normalizedPath,\n      );\n\n      filterReactRouterPrerenderArray(\n        configFile,\n        'paths',\n        (item) => normalizePath(item) !== normalizedPath,\n      );\n    },\n  });\n\n  await Promise.all([...tasks, routesFile.save(), configFile.save()]);\n}\n\nexport interface TanstackStartRoutesMod {\n  addRoute: (options: {\n    /**\n     * file path relative to `routes`\n     */\n    path: string;\n\n    /**\n     * Generated route path of `path`\n     */\n    route: string;\n\n    /**\n     * if specified, create the file\n     */\n    code?: string;\n\n    /**\n     * if true, add to prerender list\n     */\n    prerender?: boolean;\n  }) => void;\n\n  removeRoute: (options: {\n    /**\n     * file path relative to routes directory\n     */\n    path: string;\n\n    route: string;\n  }) => void;\n}\n\nexport async function tanstackStartRoutes(\n  { appDir, dest }: TemplatePluginContext,\n  fn: (mod: TanstackStartRoutesMod) => void,\n) {\n  const configFile = await createSourceFile(path.join(dest, 'vite.config.ts'));\n  const tasks: Promise<unknown>[] = [];\n\n  fn({\n    addRoute(options) {\n      if (options.code) {\n        tasks.push(fs.writeFile(path.join(appDir, 'routes', options.path), options.code));\n      }\n\n      if (options.prerender) {\n        addTanstackPrerender(configFile, [options.route]);\n      }\n    },\n    removeRoute(options) {\n      tasks.push(fs.unlink(path.join(appDir, 'routes', options.path)).catch(() => null));\n    },\n  });\n\n  await Promise.all([...tasks, configFile.save()]);\n}\n","import { TemplatePlugin } from '@/index';\nimport { copy, pick, writeFile } from '@/utils';\nimport path from 'node:path';\nimport { depVersions, sourceDir } from '@/constants';\nimport fs from 'node:fs/promises';\nimport { reactRouterRoutes, rootProvider, tanstackStartRoutes } from '@/transform';\n\nexport function oramaCloud(): TemplatePlugin {\n  return {\n    packageJson(packageJson) {\n      return {\n        ...packageJson,\n        scripts: {\n          ...packageJson.scripts,\n          build: `${packageJson.scripts!.build} && bun scripts/sync-content.ts`,\n        },\n        dependencies: {\n          ...packageJson.dependencies,\n          ...pick(depVersions, ['@orama/core']),\n        },\n      };\n    },\n    readme(content) {\n      return `${content}\\n\\n## Orama Cloud\n    \nThis project uses Orama Cloud for 3rd party search solution.\n\nSee https://hanzoai.github.io/docs/docs/headless/search/orama-cloud for integrating Orama Cloud to Hanzo Docs.`;\n    },\n    async afterWrite() {\n      const { dest, appDir, template } = this;\n      await copy(path.join(sourceDir, 'template/+orama-cloud/@root'), dest);\n      await copy(path.join(sourceDir, 'template/+orama-cloud/@app'), appDir);\n\n      await rootProvider(this, (mod) => mod.addSearchDialog('@/components/search'));\n\n      if (template.value === 'tanstack-start') {\n        await tanstackStartRoutes(this, (mod) => {\n          mod.addRoute({\n            path: 'static[.]json.ts',\n            route: '/static.json',\n            code: route.tanstack,\n            prerender: true,\n          });\n          mod.removeRoute({\n            path: 'api/search.ts',\n            route: '/api/search',\n          });\n        });\n      } else if (template.value.startsWith('react-router')) {\n        await reactRouterRoutes(this, (mod) => {\n          mod.addRoute('static.json', 'routes/static.ts', route['react-router']);\n          mod.removeRoute('api/search');\n        });\n      } else if (template.value.startsWith('+next')) {\n        await Promise.all([\n          fs.unlink(path.join(appDir, 'app/api/search/route.ts')).catch(() => null),\n          writeFile(path.join(appDir, 'app/static.json/route.ts'), route.next),\n        ]);\n      } else {\n        await Promise.all([\n          fs.unlink(path.join(appDir, 'pages/_api/api/search.ts')).catch(() => null),\n          writeFile(path.join(appDir, 'pages/_api/static.json.ts'), route.waku),\n        ]);\n      }\n\n      const filePath = {\n        '+next+fuma-docs-mdx': '.next/server/app/static.json.body',\n        '+next+fuma-docs-mdx+static': '.next/server/app/static.json.body',\n        'tanstack-start': '.output/public/static.json',\n        'tanstack-start-spa': 'dist/client/static.json',\n        'react-router': 'build/client/static.json',\n        'react-router-spa': 'build/client/static.json',\n        waku: 'dist/public/static.json',\n      }[template.value];\n\n      await writeFile(\n        path.join(dest, 'scripts/sync-content.ts'),\n        `import { type OramaDocument, sync } from '@hanzo/docs-core/search/orama-cloud';\nimport * as fs from 'node:fs/promises';\nimport { OramaCloud } from '@orama/core';\n\n// the path of pre-rendered \\`static.json\\`\nconst filePath = '${filePath}';\n\nasync function main() {\n  const orama = new OramaCloud({\n    projectId: process.env.NEXT_PUBLIC_ORAMA_PROJECT_ID,\n    apiKey: process.env.ORAMA_PRIVATE_API_KEY,\n  });\n\n  const content = await fs.readFile(filePath);\n  const records = JSON.parse(content.toString()) as OramaDocument[];\n\n  await sync(orama, {\n    index: process.env.NEXT_PUBLIC_ORAMA_DATASOURCE_ID,\n    documents: records,\n  });\n\n  console.log(\\`search updated: \\${records.length} records\\`);\n}\n\nvoid main();`,\n      );\n    },\n  };\n}\n\nconst route = {\n  next: `import { exportSearchIndexes } from '@/lib/export-search-indexes';\n\nexport const revalidate = false;\n\nexport async function GET() {\n  return Response.json(await exportSearchIndexes());\n}`,\n  'react-router': `import { exportSearchIndexes } from '@/lib/export-search-indexes';\n\nexport async function loader() {\n  return Response.json(await exportSearchIndexes());\n}`,\n  tanstack: `import { createFileRoute } from '@tanstack/react-router';\nimport { exportSearchIndexes } from '@/lib/export-search-indexes';\n\nexport const Route = createFileRoute('/static.json')({\n  server: {\n    handlers: {\n      GET: async () => Response.json(await exportSearchIndexes()),\n    },\n  },\n});`,\n  waku: `import { exportSearchIndexes } from '@/lib/export-search-indexes';\n\nexport async function GET() {\n  return Response.json(await exportSearchIndexes());\n}\n\nexport const getConfig = () => ({\n  render: 'static',\n});`,\n};\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@hanzo/docs-create-app",
+  "version": "16.0.50",
+  "description": "Create a new documentation site with Hanzo Docs",
+  "keywords": [
+    "Docs",
+    "Hanzo Docs",
+    "react"
+  ],
+  "homepage": "https://hanzoai.github.io/docs",
+  "license": "MIT",
+  "author": "Hanzo AI",
+  "repository": "github:hanzoai/docs",
+  "bin": "./dist/bin.js",
+  "files": [
+    "dist/*",
+    "template/*"
+  ],
+  "type": "module",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./plugins/*": {
+      "types": "./dist/plugins/*.d.ts",
+      "import": "./dist/plugins/*.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "@commander-js/extra-typings": "^14.0.0",
+    "commander": "^14.0.3",
+    "picocolors": "^1.1.1",
+    "tinyexec": "^1.0.2",
+    "ts-morph": "^27.0.2"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "25.2.1",
+    "tinyglobby": "^0.2.15",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3",
+    "eslint-config-custom": "0.0.0",
+    "tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "scripts": {
+    "build": "pnpm run sync && tsdown",
+    "clean": "rimraf dist",
+    "dev": "tsdown --watch",
+    "lint": "eslint .",
+    "types:check": "tsc --noEmit",
+    "sync": "bun ./scripts/sync.ts"
+  }
+}

package/template/+next+fuma-docs-mdx/app/(home)/layout.tsx

@@ -0,0 +1,6 @@
+import { HomeLayout } from '@hanzo/docs-base-ui/layouts/home';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default function Layout({ children }: LayoutProps<'/'>) {
+  return <HomeLayout {...baseOptions()}>{children}</HomeLayout>;
+}

package/template/+next+fuma-docs-mdx/app/(home)/page.tsx

@@ -0,0 +1,16 @@
+import Link from 'next/link';
+
+export default function HomePage() {
+  return (
+    <div className="flex flex-col justify-center text-center flex-1">
+      <h1 className="text-2xl font-bold mb-4">Hello World</h1>
+      <p>
+        You can open{' '}
+        <Link href="/docs" className="font-medium underline">
+          /docs
+        </Link>{' '}
+        and see the documentation.
+      </p>
+    </div>
+  );
+}

package/template/+next+fuma-docs-mdx/app/api/search/route.ts

@@ -0,0 +1,7 @@
+import { source } from '@/lib/source';
+import { createFromSource } from '@hanzo/docs/core/search/server';
+
+export const { GET } = createFromSource(source, {
+  // https://docs.orama.com/docs/orama-js/supported-languages
+  language: 'english',
+});

package/template/+next+fuma-docs-mdx/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,57 @@
+import { getPageImage, source } from '@/lib/source';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from '@hanzo/docs-ui/layouts/docs/page';
+import { notFound } from 'next/navigation';
+import { getMDXComponents } from '@/mdx-components';
+import type { Metadata } from 'next';
+import { createRelativeLink } from '@hanzo/docs-ui/mdx';
+import { LLMCopyButton, ViewOptions } from '@/components/ai/page-actions';
+import { gitConfig } from '@/lib/layout.shared';
+
+export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+
+  const MDX = page.data.body;
+
+  return (
+    <DocsPage toc={page.data.toc} full={page.data.full}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription className="mb-0">{page.data.description}</DocsDescription>
+      <div className="flex flex-row gap-2 items-center border-b pb-6">
+        <LLMCopyButton markdownUrl={`${page.url}.mdx`} />
+        <ViewOptions
+          markdownUrl={`${page.url}.mdx`}
+          // update it to match your repo
+          githubUrl={`https://github.com/${gitConfig.user}/${gitConfig.repo}/blob/${gitConfig.branch}/content/docs/${page.path}`}
+        />
+      </div>
+      <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<'/docs/[[...slug]]'>): Promise<Metadata> {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+    openGraph: {
+      images: getPageImage(page).url,
+    },
+  };
+}

package/template/+next+fuma-docs-mdx/app/docs/layout.tsx

@@ -0,0 +1,11 @@
+import { source } from '@/lib/source';
+import { DocsLayout } from '@hanzo/docs-ui/layouts/docs';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default function Layout({ children }: LayoutProps<'/docs'>) {
+  return (
+    <DocsLayout tree={source.getPageTree()} {...baseOptions()}>
+      {children}
+    </DocsLayout>
+  );
+}

package/template/+next+fuma-docs-mdx/app/global.css

@@ -0,0 +1,3 @@
+@import 'tailwindcss';
+@import '@hanzo/docs-base-ui/css/neutral.css';
+@import '@hanzo/docs-base-ui/css/preset.css';

package/template/+next+fuma-docs-mdx/app/layout.tsx

@@ -0,0 +1,17 @@
+import { RootProvider } from '@hanzo/docs/ui/provider/next';
+import './global.css';
+import { Inter } from 'next/font/google';
+
+const inter = Inter({
+  subsets: ['latin'],
+});
+
+export default function Layout({ children }: LayoutProps<'/'>) {
+  return (
+    <html lang="en" className={inter.className} suppressHydrationWarning>
+      <body className="flex flex-col min-h-screen">
+        <RootProvider>{children}</RootProvider>
+      </body>
+    </html>
+  );
+}

package/template/+next+fuma-docs-mdx/app/llms-full.txt/route.ts

@@ -0,0 +1,10 @@
+import { getLLMText, source } from '@/lib/source';
+
+export const revalidate = false;
+
+export async function GET() {
+  const scan = source.getPages().map(getLLMText);
+  const scanned = await Promise.all(scan);
+
+  return new Response(scanned.join('\n\n'));
+}

package/template/+next+fuma-docs-mdx/app/llms.mdx/docs/[[...slug]]/route.ts

@@ -0,0 +1,20 @@
+import { getLLMText, source } from '@/lib/source';
+import { notFound } from 'next/navigation';
+
+export const revalidate = false;
+
+export async function GET(_req: Request, { params }: RouteContext<'/llms.mdx/docs/[[...slug]]'>) {
+  const { slug } = await params;
+  const page = source.getPage(slug);
+  if (!page) notFound();
+
+  return new Response(await getLLMText(page), {
+    headers: {
+      'Content-Type': 'text/markdown',
+    },
+  });
+}
+
+export function generateStaticParams() {
+  return source.generateParams();
+}

package/template/+next+fuma-docs-mdx/app/llms.txt/route.ts

@@ -0,0 +1,13 @@
+import { source } from '@/lib/source';
+
+export const revalidate = false;
+
+export async function GET() {
+  const lines: string[] = [];
+  lines.push('# Documentation');
+  lines.push('');
+  for (const page of source.getPages()) {
+    lines.push(`- [${page.data.title}](${page.url}): ${page.data.description}`);
+  }
+  return new Response(lines.join('\n'));
+}

package/template/+next+fuma-docs-mdx/app/og/docs/[...slug]/route.tsx

@@ -0,0 +1,27 @@
+import { getPageImage, source } from '@/lib/source';
+import { notFound } from 'next/navigation';
+import { ImageResponse } from 'next/og';
+import { generate as DefaultImage } from '@hanzo/docs-ui/og';
+
+export const revalidate = false;
+
+export async function GET(_req: Request, { params }: RouteContext<'/og/docs/[...slug]'>) {
+  const { slug } = await params;
+  const page = source.getPage(slug.slice(0, -1));
+  if (!page) notFound();
+
+  return new ImageResponse(
+    <DefaultImage title={page.data.title} description={page.data.description} site="My App" />,
+    {
+      width: 1200,
+      height: 630,
+    },
+  );
+}
+
+export function generateStaticParams() {
+  return source.getPages().map((page) => ({
+    lang: page.locale,
+    slug: getPageImage(page).segments,
+  }));
+}