@farming-labs/docs 0.1.10 → 0.1.11

package/dist/{api-reference-DlfH-Y9c.mjs → api-reference-BQ16eRPP.mjs}

@@ -26,6 +26,7 @@ function resolveApiReferenceConfig(value) {
 		enabled: true,
 		path: "api-reference",
 		specUrl: void 0,
+		renderer: void 0,
 		routeRoot: "api",
 		exclude: []
 	};
@@ -33,6 +34,7 @@ function resolveApiReferenceConfig(value) {
 		enabled: false,
 		path: "api-reference",
 		specUrl: void 0,
+		renderer: void 0,
 		routeRoot: "api",
 		exclude: []
 	};
@@ -40,10 +42,19 @@ function resolveApiReferenceConfig(value) {
 		enabled: value.enabled !== false,
 		path: normalizePathSegment(value.path ?? "api-reference"),
 		specUrl: normalizeRemoteSpecUrl(value.specUrl),
+		renderer: normalizeApiReferenceRenderer(value.renderer),
 		routeRoot: normalizePathSegment(value.routeRoot ?? "api") || "api",
 		exclude: normalizeApiReferenceExcludes(value.exclude)
 	};
 }
+function normalizeApiReferenceRenderer(value) {
+	if (value === "fumadocs" || value === "scalar") return value;
+}
+function resolveApiReferenceRenderer(value, framework) {
+	const config = resolveApiReferenceConfig(value);
+	if (config.renderer) return config.renderer;
+	return framework === "next" ? "fumadocs" : "scalar";
+}
 function normalizeRemoteSpecUrl(value) {
 	const trimmed = value?.trim();
 	if (!trimmed) return void 0;
@@ -420,7 +431,7 @@ async function buildApiReferenceOpenApiDocumentAsync(config, options) {
 	const apiReference = resolveApiReferenceConfig(config.apiReference);
 	if (!apiReference.specUrl) return buildApiReferenceOpenApiDocument(config, options);
 	try {
-		return normalizeRemoteOpenApiDocument(await fetchRemoteOpenApiDocument(apiReference.specUrl), config);
+		return normalizeRemoteOpenApiDocument(await fetchRemoteOpenApiDocument(apiReference.specUrl, options.baseUrl), config);
 	} catch (error) {
 		return buildUnavailableOpenApiDocument(config, `Unable to load the remote OpenAPI JSON. ${error instanceof Error ? error.message : "Unknown error"}`);
 	}
@@ -471,12 +482,12 @@ function buildApiReferenceHtmlDocumentFromDocument(config, options, document) {
 		documentDownloadType: "json"
 	});
 }
-async function fetchRemoteOpenApiDocument(specUrl) {
+async function fetchRemoteOpenApiDocument(specUrl, baseUrl) {
 	let url;
 	try {
-		url = new URL(specUrl);
+		url = baseUrl ? new URL(specUrl, baseUrl) : new URL(specUrl);
 	} catch {
-		throw new Error("`apiReference.specUrl` must be an absolute URL.");
+		throw new Error(baseUrl ? "`apiReference.specUrl` must be an absolute URL or a request-relative path." : "`apiReference.specUrl` must be an absolute URL.");
 	}
 	const response = await fetch(url, { headers: { accept: "application/json" } });
 	if (!response.ok) throw new Error(`Received ${response.status} ${response.statusText}`.trim());
@@ -799,4 +810,4 @@ function humanizeSegment(value) {
 }
 
 //#endregion
-export { buildApiReferencePageTitle as a, buildApiReferenceOpenApiDocumentAsync as i, buildApiReferenceHtmlDocumentAsync as n, buildApiReferenceScalarCss as o, buildApiReferenceOpenApiDocument as r, resolveApiReferenceConfig as s, buildApiReferenceHtmlDocument as t };
+export { buildApiReferencePageTitle as a, resolveApiReferenceRenderer as c, buildApiReferenceOpenApiDocumentAsync as i, buildApiReferenceHtmlDocumentAsync as n, buildApiReferenceScalarCss as o, buildApiReferenceOpenApiDocument as r, resolveApiReferenceConfig as s, buildApiReferenceHtmlDocument as t };

package/dist/cli/index.mjs

@@ -69,13 +69,13 @@ async function main() {
 		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-DfvwcfEI.mjs");
+		const { init } = await import("../init-DwUjo2Kv.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-aXyV1jPp.mjs");
+		const { runMcp } = await import("../mcp-DLP94P1H.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-ChhShKMO.mjs");
+		const { syncSearch } = await import("../search-CLaNOUrd.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { $ as UIConfig, A as GithubConfig, B as PageFrontmatter, C as DocsSearchQuery, D as DocsTheme, E as DocsSearchSourcePage, F as OpenDocsConfig, G as SidebarFolderNode, H as PageTwitter, I as OpenDocsProvider, J as SidebarTree, K as SidebarNode, L as OpenGraphImage, M as LlmsTxtConfig, N as McpDocsSearchConfig, O as FeedbackConfig, P as OGConfig, Q as TypographyConfig, R as OrderingItem, S as DocsSearchEmbeddingsConfig, T as DocsSearchResultType, U as SidebarComponentProps, V as PageOpenGraph, W as SidebarConfig, X as ThemeToggleConfig, Y as SimpleDocsSearchConfig, Z as TypesenseDocsSearchConfig, _ as DocsSearchAdapterContext, a as CodeBlockCopyData, b as DocsSearchConfig, c as DocsConfig, d as DocsI18nConfig, f as DocsMcpConfig, g as DocsSearchAdapter, h as DocsNav, i as BreadcrumbConfig, j as LastUpdatedConfig, k as FontStyle, l as DocsFeedbackData, m as DocsMetadata, n as AlgoliaDocsSearchConfig, o as CopyMarkdownConfig, p as DocsMcpToolsConfig, q as SidebarPageNode, r as ApiReferenceConfig, s as CustomDocsSearchConfig, t as AIConfig, u as DocsFeedbackValue, v as DocsSearchAdapterFactory, w as DocsSearchResult, x as DocsSearchDocument, y as DocsSearchChunkingConfig, z as PageActionsConfig } from "./types-BAulrjlV.mjs";
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-KzREATdM.mjs";
+import { $ as TypographyConfig, A as FontStyle, B as PageActionsConfig, C as DocsSearchEmbeddingsConfig, D as DocsSearchSourcePage, E as DocsSearchResultType, F as OGConfig, G as SidebarConfig, H as PageOpenGraph, I as OpenDocsConfig, J as SidebarPageNode, K as SidebarFolderNode, L as OpenDocsProvider, M as LastUpdatedConfig, N as LlmsTxtConfig, O as DocsTheme, P as McpDocsSearchConfig, Q as TypesenseDocsSearchConfig, R as OpenGraphImage, S as DocsSearchDocument, T as DocsSearchResult, U as PageTwitter, V as PageFrontmatter, W as SidebarComponentProps, X as SimpleDocsSearchConfig, Y as SidebarTree, Z as ThemeToggleConfig, _ as DocsSearchAdapter, a as BreadcrumbConfig, b as DocsSearchChunkingConfig, c as CustomDocsSearchConfig, d as DocsFeedbackValue, et as UIConfig, f as DocsI18nConfig, g as DocsNav, h as DocsMetadata, i as ApiReferenceRenderer, j as GithubConfig, k as FeedbackConfig, l as DocsConfig, m as DocsMcpToolsConfig, n as AlgoliaDocsSearchConfig, o as CodeBlockCopyData, p as DocsMcpConfig, q as SidebarNode, r as ApiReferenceConfig, s as CopyMarkdownConfig, t as AIConfig, u as DocsFeedbackData, v as DocsSearchAdapterContext, w as DocsSearchQuery, x as DocsSearchConfig, y as DocsSearchAdapterFactory, z as OrderingItem } from "./types-B_Qc9Axa.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-DOjDVgyY.mjs";
 
 //#region src/define-docs.d.ts
 /**
@@ -98,4 +98,4 @@ declare function buildPageOpenGraph(page: Pick<PageFrontmatter, "title" | "descr
  */
 declare function buildPageTwitter(page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph" | "twitter">, ogConfig?: OGConfig, baseUrl?: string): PageTwitter | undefined;
 //#endregion
-export { type AIConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type BreadcrumbConfig, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsTheme, type FeedbackConfig, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedDocsI18n, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, performDocsSearch, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };
+export { type AIConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsTheme, type FeedbackConfig, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedDocsI18n, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, performDocsSearch, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };

package/dist/{init-DfvwcfEI.mjs → init-DwUjo2Kv.mjs}

@@ -168,7 +168,8 @@ function renderI18nConfig(cfg, indent = "  ") {
 function renderApiReferenceConfig(cfg, indent = "  ") {
 	const apiReference = cfg.apiReference;
 	if (!apiReference) return "";
-	return `${indent}apiReference: {\n${indent}  enabled: true,\n${indent}  path: "${apiReference.path}",\n${indent}  routeRoot: "${apiReference.routeRoot}",\n${indent}},\n`;
+	const rendererLine = cfg.framework === "nextjs" ? `${indent}  renderer: "fumadocs",\n` : "";
+	return `${indent}apiReference: {\n${indent}  enabled: true,\n${indent}  path: "${apiReference.path}",\n${rendererLine}${indent}  routeRoot: "${apiReference.routeRoot}",\n${indent}},\n`;
 }
 function toLocaleImportName(locale) {
 	return `LocalePage_${locale.replace(/[^a-zA-Z0-9_$]/g, "_")}`;
@@ -424,15 +425,19 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 }
 `;
 }
-function nextApiReferenceRouteTemplate(cfg, filePath) {
+function nextApiReferencePageTemplate(cfg, filePath) {
 	const appDir = cfg.nextAppDir ?? "app";
 	return `
+import "@farming-labs/next/api-reference.css";
 import docsConfig from "${nextApiReferenceConfigImport(cfg.useAlias, appDir, filePath)}";
-import { createNextApiReference } from "@farming-labs/next/api-reference";
+import { createNextApiReferencePage } from "@farming-labs/next/api-reference";
 
-export const GET = createNextApiReference(docsConfig);
+const ApiReferencePage = createNextApiReferencePage(docsConfig);
 
-export const revalidate = false;
+export const dynamic = "force-dynamic";
+export const revalidate = 0;
+
+export default ApiReferencePage;
 `;
 }
 function nextLocaleDocPageTemplate(defaultLocale) {
@@ -3024,8 +3029,8 @@ function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	} else write(globalCssRelPath, globalCssTemplate(cfg.theme, cfg.customThemeName, globalCssRelPath));
 	write(`${appDir}/${cfg.entry}/layout.tsx`, docsLayoutTemplate(cfg));
 	if (cfg.apiReference) {
-		const apiReferenceRoute = `${appDir}/${cfg.apiReference.path}/[[...slug]]/route.ts`;
-		write(apiReferenceRoute, nextApiReferenceRouteTemplate(cfg, apiReferenceRoute));
+		const apiReferencePage = `${appDir}/${cfg.apiReference.path}/[[...slug]]/page.tsx`;
+		write(apiReferencePage, nextApiReferencePageTemplate(cfg, apiReferencePage));
 	}
 	write("postcss.config.mjs", postcssConfigTemplate());
 	if (!fileExists(path.join(cwd, "tsconfig.json"))) write("tsconfig.json", tsconfigTemplate(cfg.useAlias));

package/dist/{mcp-aXyV1jPp.mjs → mcp-DLP94P1H.mjs}

@@ -1,4 +1,4 @@
-import "./api-reference-DlfH-Y9c.mjs";
+import "./api-reference-BQ16eRPP.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./server.mjs";
 import { a as readStringProperty, i as readNavTitle, o as resolveDocsConfigPath, r as readBooleanProperty, s as resolveDocsContentDir, t as extractObjectLiteral } from "./config-CSywk3ou.mjs";

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { R as OrderingItem, b as DocsSearchConfig, f as DocsMcpConfig } from "./types-BAulrjlV.mjs";
+import { p as DocsMcpConfig, x as DocsSearchConfig, z as OrderingItem } from "./types-B_Qc9Axa.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts

package/dist/{search-ChhShKMO.mjs → search-CLaNOUrd.mjs}

@@ -1,5 +1,5 @@
 import { n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, t as buildDocsSearchDocuments } from "./search-BS6C5N1i.mjs";
-import "./api-reference-DlfH-Y9c.mjs";
+import "./api-reference-BQ16eRPP.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
 import { a as readStringProperty, n as loadProjectEnv, o as resolveDocsConfigPath, s as resolveDocsContentDir } from "./config-CSywk3ou.mjs";

package/dist/{search-KzREATdM.d.mts → search-DOjDVgyY.d.mts}

@@ -1,4 +1,4 @@
-import { E as DocsSearchSourcePage, N as McpDocsSearchConfig, Z as TypesenseDocsSearchConfig, b as DocsSearchConfig, g as DocsSearchAdapter, n as AlgoliaDocsSearchConfig, s as CustomDocsSearchConfig, v as DocsSearchAdapterFactory, w as DocsSearchResult, x as DocsSearchDocument, y as DocsSearchChunkingConfig } from "./types-BAulrjlV.mjs";
+import { D as DocsSearchSourcePage, P as McpDocsSearchConfig, Q as TypesenseDocsSearchConfig, S as DocsSearchDocument, T as DocsSearchResult, _ as DocsSearchAdapter, b as DocsSearchChunkingConfig, c as CustomDocsSearchConfig, n as AlgoliaDocsSearchConfig, x as DocsSearchConfig, y as DocsSearchAdapterFactory } from "./types-B_Qc9Axa.mjs";
 
 //#region src/search.d.ts
 declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { C as DocsSearchQuery, E as DocsSearchSourcePage, N as McpDocsSearchConfig, _ as DocsSearchAdapterContext, b as DocsSearchConfig, c as DocsConfig, g as DocsSearchAdapter, v as DocsSearchAdapterFactory, w as DocsSearchResult, x as DocsSearchDocument } from "./types-BAulrjlV.mjs";
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-KzREATdM.mjs";
+import { D as DocsSearchSourcePage, P as McpDocsSearchConfig, S as DocsSearchDocument, T as DocsSearchResult, _ as DocsSearchAdapter, i as ApiReferenceRenderer, l as DocsConfig, v as DocsSearchAdapterContext, w as DocsSearchQuery, x as DocsSearchConfig, y as DocsSearchAdapterFactory } from "./types-B_Qc9Axa.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-DOjDVgyY.mjs";
 import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/api-reference.d.ts
@@ -19,17 +19,20 @@ interface ResolvedApiReferenceConfig {
   enabled: boolean;
   path: string;
   specUrl?: string;
+  renderer?: ApiReferenceRenderer;
   routeRoot: string;
   exclude: string[];
 }
 interface BuildApiReferenceOptions {
   framework: ApiReferenceFramework;
   rootDir?: string;
+  baseUrl?: string;
 }
 interface BuildApiReferenceHtmlOptions extends BuildApiReferenceOptions {
   title?: string;
 }
 declare function resolveApiReferenceConfig(value: DocsConfig["apiReference"]): ResolvedApiReferenceConfig;
+declare function resolveApiReferenceRenderer(value: DocsConfig["apiReference"], framework: ApiReferenceFramework): ApiReferenceRenderer;
 declare function buildApiReferencePageTitle(config: DocsConfig, title?: string): string;
 declare function buildApiReferenceScalarCss(config: DocsConfig): string;
 declare function buildApiReferenceOpenApiDocument(config: DocsConfig, options: BuildApiReferenceOptions): Record<string, unknown>;
@@ -37,4 +40,4 @@ declare function buildApiReferenceOpenApiDocumentAsync(config: DocsConfig, optio
 declare function buildApiReferenceHtmlDocument(config: DocsConfig, options: BuildApiReferenceHtmlOptions): string;
 declare function buildApiReferenceHtmlDocumentAsync(config: DocsConfig, options: BuildApiReferenceHtmlOptions): Promise<string>;
 //#endregion
-export { type ApiReferenceFramework, type ApiReferenceRoute, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type McpDocsSearchConfig, type ResolvedApiReferenceConfig, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, normalizeDocsMcpRoute, performDocsSearch, resolveApiReferenceConfig, resolveDocsMcpConfig, resolveSearchRequestConfig, runDocsMcpStdio };
+export { type ApiReferenceFramework, type ApiReferenceRenderer, type ApiReferenceRoute, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type McpDocsSearchConfig, type ResolvedApiReferenceConfig, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, normalizeDocsMcpRoute, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsMcpConfig, resolveSearchRequestConfig, runDocsMcpStdio };

package/dist/server.mjs

@@ -1,5 +1,5 @@
 import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-BS6C5N1i.mjs";
-import { a as buildApiReferencePageTitle, i as buildApiReferenceOpenApiDocumentAsync, n as buildApiReferenceHtmlDocumentAsync, o as buildApiReferenceScalarCss, r as buildApiReferenceOpenApiDocument, s as resolveApiReferenceConfig, t as buildApiReferenceHtmlDocument } from "./api-reference-DlfH-Y9c.mjs";
+import { a as buildApiReferencePageTitle, c as resolveApiReferenceRenderer, i as buildApiReferenceOpenApiDocumentAsync, n as buildApiReferenceHtmlDocumentAsync, o as buildApiReferenceScalarCss, r as buildApiReferenceOpenApiDocument, s as resolveApiReferenceConfig, t as buildApiReferenceHtmlDocument } from "./api-reference-BQ16eRPP.mjs";
 import { createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
-export { buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, normalizeDocsMcpRoute, performDocsSearch, resolveApiReferenceConfig, resolveDocsMcpConfig, resolveSearchRequestConfig, runDocsMcpStdio };
+export { buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, normalizeDocsMcpRoute, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsMcpConfig, resolveSearchRequestConfig, runDocsMcpStdio };

package/dist/{types-BAulrjlV.d.mts → types-B_Qc9Axa.d.mts}

@@ -1244,6 +1244,7 @@ interface DocsI18nConfig {
   /** Default locale when `?lang=` is missing or invalid. Defaults to first locale. */
   defaultLocale?: string;
 }
+type ApiReferenceRenderer = "fumadocs" | "scalar";
 interface ApiReferenceConfig {
   /**
    * Whether to enable generated API reference pages.
@@ -1258,11 +1259,15 @@ interface ApiReferenceConfig {
    */
   path?: string;
   /**
-   * Absolute URL to a remote OpenAPI JSON document.
+   * URL to a remote OpenAPI JSON document.
    *
    * When provided, the API reference is generated from this hosted spec instead
    * of scanning local framework route files.
    *
+   * Supports:
+   * - absolute URLs like `https://example.com/openapi.json`
+   * - request-relative URLs like `/api/openapi.json` in Next.js
+   *
    * @example
    * ```ts
    * apiReference: {
@@ -1272,6 +1277,17 @@ interface ApiReferenceConfig {
    * ```
    */
   specUrl?: string;
+  /**
+   * Which renderer to use for the API reference UI.
+   *
+   * - `"fumadocs"` uses `fumadocs-openapi`
+   * - `"scalar"` uses the existing Scalar renderer
+   *
+   * Defaults are framework-aware:
+   * - Next.js: `"fumadocs"`
+   * - TanStack Start / SvelteKit / Astro / Nuxt: `"scalar"`
+   */
+  renderer?: ApiReferenceRenderer;
   /**
    * Filesystem route root to scan for API handlers.
    *
@@ -1629,4 +1645,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { UIConfig as $, GithubConfig as A, PageFrontmatter as B, DocsSearchQuery as C, DocsTheme as D, DocsSearchSourcePage as E, OpenDocsConfig as F, SidebarFolderNode as G, PageTwitter as H, OpenDocsProvider as I, SidebarTree as J, SidebarNode as K, OpenGraphImage as L, LlmsTxtConfig as M, McpDocsSearchConfig as N, FeedbackConfig as O, OGConfig as P, TypographyConfig as Q, OrderingItem as R, DocsSearchEmbeddingsConfig as S, DocsSearchResultType as T, SidebarComponentProps as U, PageOpenGraph as V, SidebarConfig as W, ThemeToggleConfig as X, SimpleDocsSearchConfig as Y, TypesenseDocsSearchConfig as Z, DocsSearchAdapterContext as _, CodeBlockCopyData as a, DocsSearchConfig as b, DocsConfig as c, DocsI18nConfig as d, DocsMcpConfig as f, DocsSearchAdapter as g, DocsNav as h, BreadcrumbConfig as i, LastUpdatedConfig as j, FontStyle as k, DocsFeedbackData as l, DocsMetadata as m, AlgoliaDocsSearchConfig as n, CopyMarkdownConfig as o, DocsMcpToolsConfig as p, SidebarPageNode as q, ApiReferenceConfig as r, CustomDocsSearchConfig as s, AIConfig as t, DocsFeedbackValue as u, DocsSearchAdapterFactory as v, DocsSearchResult as w, DocsSearchDocument as x, DocsSearchChunkingConfig as y, PageActionsConfig as z };
+export { TypographyConfig as $, FontStyle as A, PageActionsConfig as B, DocsSearchEmbeddingsConfig as C, DocsSearchSourcePage as D, DocsSearchResultType as E, OGConfig as F, SidebarConfig as G, PageOpenGraph as H, OpenDocsConfig as I, SidebarPageNode as J, SidebarFolderNode as K, OpenDocsProvider as L, LastUpdatedConfig as M, LlmsTxtConfig as N, DocsTheme as O, McpDocsSearchConfig as P, TypesenseDocsSearchConfig as Q, OpenGraphImage as R, DocsSearchDocument as S, DocsSearchResult as T, PageTwitter as U, PageFrontmatter as V, SidebarComponentProps as W, SimpleDocsSearchConfig as X, SidebarTree as Y, ThemeToggleConfig as Z, DocsSearchAdapter as _, BreadcrumbConfig as a, DocsSearchChunkingConfig as b, CustomDocsSearchConfig as c, DocsFeedbackValue as d, UIConfig as et, DocsI18nConfig as f, DocsNav as g, DocsMetadata as h, ApiReferenceRenderer as i, GithubConfig as j, FeedbackConfig as k, DocsConfig as l, DocsMcpToolsConfig as m, AlgoliaDocsSearchConfig as n, CodeBlockCopyData as o, DocsMcpConfig as p, SidebarNode as q, ApiReferenceConfig as r, CopyMarkdownConfig as s, AIConfig as t, DocsFeedbackData as u, DocsSearchAdapterContext as v, DocsSearchQuery as w, DocsSearchConfig as x, DocsSearchAdapterFactory as y, OrderingItem as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",