fumadocs-openapi 10.4.1 → 10.6.0

package/css/generated/shared.css

@@ -2,6 +2,7 @@
 @source inline("!last");
 @source inline("*:data-[collapsible=true]:order-last");
 @source inline("*:min-w-0");
+@source inline("---");
 @source inline("--fd-docs-row-1");
 @source inline("--initial-height");
 @source inline("-mode");
@@ -107,6 +108,7 @@
 @source inline("border-x");
 @source inline("border-y");
 @source inline("both");
+@source inline("bundled");
 @source inline("but");
 @source inline("button");
 @source inline("buttonVariants");
@@ -138,6 +140,7 @@
 @source inline("cloned");
 @source inline("cn");
 @source inline("code");
+@source inline("codeProps");
 @source inline("codeUsages");
 @source inline("codegen");
 @source inline("codegens");
@@ -194,10 +197,11 @@
 @source inline("data-collapsible");
 @source inline("data-object-search-input");
 @source inline("data-placeholder:text-fd-muted-foreground");
+@source inline("data-type");
 @source inline("dataEngine");
 @source inline("declare");
 @source inline("default");
-@source inline("defaultBaseUrl");
+@source inline("defaultAdapters");
 @source inline("defaultColor");
 @source inline("defaultExampleId");
 @source inline("defaultItem");
@@ -209,12 +213,13 @@
 @source inline("definitions");
 @source inline("deprecated");
 @source inline("depth");
+@source inline("dereferenceMap");
+@source inline("dereferenceSync");
 @source inline("dereferenced");
 @source inline("description");
 @source inline("descriptionNode");
 @source inline("development");
 @source inline("deviceAuthorization");
-@source inline("directive");
 @source inline("disable");
 @source inline("disabled");
 @source inline("disabled:cursor-not-allowed");
@@ -226,13 +231,13 @@
 @source inline("divide-fd-border");
 @source inline("divide-y");
 @source inline("document");
+@source inline("doesn");
 @source inline("domain");
 @source inline("duplicated");
 @source inline("duration-200");
 @source inline("dynamic");
 @source inline("e");
 @source inline("each");
-@source inline("either");
 @source inline("element");
 @source inline("else");
 @source inline("empty");
@@ -254,13 +259,13 @@
 @source inline("eslint-disable-next-line");
 @source inline("example");
 @source inline("exampleId");
+@source inline("exampleRequests");
 @source inline("examples");
 @source inline("exclusiveMax");
 @source inline("exclusiveMin");
 @source inline("expand");
 @source inline("export");
 @source inline("extends");
-@source inline("extra");
 @source inline("factory");
 @source inline("fallback");
 @source inline("false");
@@ -300,6 +305,8 @@
 @source inline("focus:ring");
 @source inline("focus:ring-fd-ring");
 @source inline("focus:text-fd-accent-foreground");
+@source inline("folder");
+@source inline("folderStyle");
 @source inline("font-medium");
 @source inline("font-mono");
 @source inline("font-semibold");
@@ -335,11 +342,13 @@
 @source inline("generate");
 @source inline("generateDefault");
 @source inline("generateTypeScriptDefinitions");
+@source inline("generateTypeScriptSchema");
 @source inline("generated");
 @source inline("generated/defined");
-@source inline("generator");
 @source inline("generators");
 @source inline("getAPIPageProps");
+@source inline("getClientAPIPageProps");
+@source inline("getExampleRequests");
 @source inline("getSchema");
 @source inline("getSchemaId");
 @source inline("getStatusInfo");
@@ -390,9 +399,9 @@
 @source inline("idx");
 @source inline("if");
 @source inline("ignore");
+@source inline("img");
 @source inline("implicit");
 @source inline("import");
-@source inline("imported");
 @source inline("imports");
 @source inline("in");
 @source inline("include");
@@ -431,6 +440,7 @@
 @source inline("j");
 @source inline("json");
 @source inline("json-schema-typed");
+@source inline("json-schema-typed/draft-2020-12");
 @source inline("justify-between");
 @source inline("justify-center");
 @source inline("k");
@@ -441,7 +451,6 @@
 @source inline("labelVariants");
 @source inline("lang");
 @source inline("langs");
-@source inline("language");
 @source inline("last");
 @source inline("last:border-b");
 @source inline("last:border-b-0");
@@ -470,16 +479,20 @@
 @source inline("max-w-[600px]");
 @source inline("max-w-full");
 @source inline("max-w-lg");
+@source inline("may");
 @source inline("mb-2");
 @source inline("mb-4");
 @source inline("md");
+@source inline("mdxComponents");
 @source inline("me-auto");
 @source inline("media");
 @source inline("mediaAdapters");
 @source inline("mediaType");
 @source inline("merge");
 @source inline("mergeAllOf");
+@source inline("merged");
 @source inline("message");
+@source inline("meta");
 @source inline("metaData");
 @source inline("method");
 @source inline("min");
@@ -516,6 +529,8 @@
 @source inline("next-themes");
 @source inline("no-cache");
 @source inline("node");
+@source inline("node:path");
+@source inline("non-RSC");
 @source inline("non-string");
 @source inline("not");
 @source inline("not-last:pb-0");
@@ -575,13 +590,13 @@
 @source inline("page");
 @source inline("pageData");
 @source inline("pages");
-@source inline("panels");
 @source inline("param");
 @source inline("paramTypeKeys");
 @source inline("parameter");
 @source inline("parameterNode");
 @source inline("parameters");
 @source inline("params");
+@source inline("parent");
 @source inline("parsed");
 @source inline("parsedState");
 @source inline("parts");
@@ -590,13 +605,13 @@
 @source inline("password");
 @source inline("path");
 @source inline("pathItem");
-@source inline("pathItems");
 @source inline("pathName");
 @source inline("pathNodes");
 @source inline("pathParameters");
 @source inline("paths");
 @source inline("pattern");
 @source inline("patternProperties");
+@source inline("payload");
 @source inline("pb-0");
 @source inline("pb-2");
 @source inline("pe-2");
@@ -610,7 +625,6 @@
 @source inline("placeholder:text-fd-muted-foreground");
 @source inline("placeholders");
 @source inline("playground");
-@source inline("playground/index.tsx");
 @source inline("playgroundEnabled");
 @source inline("playgrounds");
 @source inline("please");
@@ -618,7 +632,6 @@
 @source inline("position");
 @source inline("pre");
 @source inline("prefix");
-@source inline("preprocessed");
 @source inline("prev");
 @source inline("prevProperties");
 @source inline("prevent");
@@ -627,7 +640,6 @@
 @source inline("primitive");
 @source inline("processed");
 @source inline("processor");
-@source inline("programming");
 @source inline("prop");
 @source inline("properties");
 @source inline("property");
@@ -662,6 +674,7 @@
 @source inline("react");
 @source inline("react-hook-form");
 @source inline("react-hooks/exhaustive-deps");
+@source inline("react-hooks/rules-of-hooks");
 @source inline("react/jsx-runtime");
 @source inline("read");
 @source inline("readOnly");
@@ -677,6 +690,7 @@
 @source inline("registered");
 @source inline("registry");
 @source inline("rehype-react");
+@source inline("relativePath");
 @source inline("remark");
 @source inline("remark-rehype");
 @source inline("remarkGfm");
@@ -687,7 +701,6 @@
 @source inline("render");
 @source inline("renderAPIExampleLayout");
 @source inline("renderAPIExampleUsageTabs");
-@source inline("renderBodyField");
 @source inline("renderOperationLayout");
 @source inline("renderPageLayout");
 @source inline("renderParameterField");
@@ -712,12 +725,11 @@
 @source inline("requests");
 @source inline("required");
 @source inline("res");
-@source inline("resType");
 @source inline("reset");
 @source inline("resize-none");
-@source inline("resolution");
 @source inline("resolve");
 @source inline("resolveMediaAdapter");
+@source inline("resolveRefSync");
 @source inline("resolveRequestData");
 @source inline("resolved");
 @source inline("resolvedTheme");
@@ -733,6 +745,7 @@
 @source inline("rest");
 @source inline("result");
 @source inline("return");
+@source inline("returned");
 @source inline("root");
 @source inline("rotate-90");
 @source inline("rounded-lg");
@@ -782,13 +795,14 @@
 @source inline("selector");
 @source inline("selectorNode");
 @source inline("sep");
+@source inline("separator");
 @source inline("server");
 @source inline("server-side");
 @source inline("server-url");
 @source inline("serverContext");
-@source inline("serverRef");
 @source inline("serverSchema");
 @source inline("servers");
+@source inline("set");
 @source inline("setData");
 @source inline("setError");
 @source inline("setExample");
@@ -834,6 +848,7 @@
 @source inline("slot");
 @source inline("slotType");
 @source inline("slots");
+@source inline("slug");
 @source inline("slugger");
 @source inline("sm");
 @source inline("sm:flex-row");
@@ -841,7 +856,6 @@
 @source inline("sm:justify-end");
 @source inline("sm:text-start");
 @source inline("so");
-@source inline("source");
 @source inline("spec");
 @source inline("specify");
 @source inline("stack");
@@ -859,6 +873,7 @@
 @source inline("step");
 @source inline("stf");
 @source inline("sticky");
+@source inline("storageKey");
 @source inline("storageKeyPrefix");
 @source inline("storageKeys");
 @source inline("store");
@@ -871,15 +886,14 @@
 @source inline("submit");
 @source inline("such");
 @source inline("summary");
+@source inline("support");
 @source inline("supported");
-@source inline("swallow");
 @source inline("switch");
 @source inline("t");
 @source inline("tab");
 @source inline("tabs");
 @source inline("tag");
 @source inline("takenIds");
-@source inline("targetServer");
 @source inline("testQuery");
 @source inline("text");
 @source inline("text-[0.8125rem]");
@@ -924,7 +938,6 @@
 @source inline("titleRequestTabs");
 @source inline("titleResponseBody");
 @source inline("to");
-@source inline("toBody");
 @source inline("toJsxRuntime");
 @source inline("toStaticData");
 @source inline("toc");
@@ -972,18 +985,17 @@
 @source inline("useApiClientModal");
 @source inline("useApiContext");
 @source inline("useCopyButton");
-@source inline("useExampleRequests");
 @source inline("useFieldValue");
 @source inline("useForm");
 @source inline("useI18n");
 @source inline("useMemo");
 @source inline("useNamespace");
 @source inline("useObject");
+@source inline("useOperationContext");
 @source inline("useQuery");
 @source inline("useRef");
 @source inline("useResolvedSchema");
 @source inline("useServerContext");
-@source inline("useServerSelectContext");
 @source inline("useState");
 @source inline("useStf");
 @source inline("useStorageKey");

package/dist/generate-file.d.ts

@@ -1,6 +1,7 @@
 import { OpenAPIServer } from "./server/create.js";
 import { OutputEntry } from "./utils/pages/builder.js";
 import { SchemaToPagesOptions } from "./utils/pages/preset-auto.js";
+import { DistributiveOmit } from "./types.js";
 import { ProcessedDocument } from "./utils/process-document.js";
 import { PagesToTextOptions } from "./utils/pages/to-text.js";
 
@@ -23,13 +24,14 @@ interface IndexConfig {
   };
 }
 interface IndexItem {
+  /** output path of index page */
   path: string;
   title?: string;
   description?: string;
   /**
    * Specify linked pages:
    * - items in `inputs` to include all generated pages of a specific schema.
-   * - specific Markdown/MDX files.
+   * - file paths (using forward slash).
    */
   only?: string[];
 }
@@ -46,19 +48,35 @@ interface GenerateFilesConfig extends PagesToTextOptions {
    * Generate index files with cards linking to generated pages.
    */
   index?: IndexConfig;
+  /**
+   * Generate `meta.json` files.
+   *
+   * Note: for flexibility, it's recommended to define them on your own.
+   */
+  meta?: boolean | MetaOptions;
   /**
    * Can add/change/remove output files before writing to file system
    **/
   beforeWrite?: (this: BeforeWriteContext, files: OutputFile[]) => void | Promise<void>;
 }
-type Config = SchemaToPagesOptions & GenerateFilesConfig;
+interface MetaOptions {
+  groupStyle?: 'folder' | 'separator';
+}
+type Config = SchemaToPagesOptions & GenerateFilesConfig & {
+  /**
+   * Re-generate when **schema files are changed**, ignores custom input functions & URLs.
+   *
+   * Note: it is recommended to configure & use `chokidar` on your own, this is only for simple cases.
+   */
+  watch?: boolean;
+};
 interface BeforeWriteContext {
   readonly generated: Record<string, OutputFile[]>;
   readonly generatedEntries: Record<string, OutputEntry[]>;
   readonly documents: Record<string, ProcessedDocument>;
 }
 declare function generateFiles(options: Config): Promise<void>;
-declare function generateFilesOnly(options: SchemaToPagesOptions & Omit<GenerateFilesConfig, 'output'>): Promise<OutputFile[]>;
+declare function generateFilesOnly(options: DistributiveOmit<Config, 'output'>): Promise<OutputFile[]>;
 //#endregion
 export { Config, OutputFile, generateFiles, generateFilesOnly };
 //# sourceMappingURL=generate-file.d.ts.map

package/dist/generate-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-file.d.ts","names":[],"sources":["../src/generate-file.ts"],"mappings":";;;;;;;UASiB,UAAA;EACf,IAAA;EACA,OAAA;AAAA;AAAA,UAGQ,WAAA;EACR,KAAA,EAAO,SAAA,OAAgB,GAAA,EAAK,kBAAA,KAAuB,SAAA;EALnD;;AAED;EAQC,GAAA,IACM,QAAA;IAEA,OAAA;IARC;;;IAYD,UAAA;EAAA;AAAA;AAAA,UAIE,SAAA;EACR,IAAA;EACA,KAAA;EACA,WAAA;EAdA;;;;;EAqBA,IAAA;AAAA;AAAA,UAGQ,mBAAA,SAA4B,kBAAA;;;;EAIpC,KAAA,EAAO,aAAA;EAdP;;;EAmBA,MAAA;EATQ;;;EAcR,KAAA,GAAQ,WAAA;EAAA;;;EAKR,WAAA,IAAe,IAAA,EAAM,kBAAA,EAAoB,KAAA,EAAO,UAAA,cAAwB,OAAA;AAAA;AAAA,KAG9D,MAAA,GAAS,oBAAA,GAAuB,mBAAA;AAAA,UAElC,kBAAA;EAAA,SACC,SAAA,EAAW,MAAA,SAAe,UAAA;EAAA,SAC1B,gBAAA,EAAkB,MAAA,SAAe,WAAA;EAAA,SACjC,SAAA,EAAW,MAAA,SAAe,iBAAA;AAAA;AAAA,iBAGf,aAAA,CAAc,OAAA,EAAS,MAAA,GAAS,OAAA;AAAA,iBAehC,iBAAA,CACpB,OAAA,EAAS,oBAAA,GAAuB,IAAA,CAAK,mBAAA,cACpC,OAAA,CAAQ,UAAA"}
+{"version":3,"file":"generate-file.d.ts","names":[],"sources":["../src/generate-file.ts"],"mappings":";;;;;;;;UAUiB,UAAA;EACf,IAAA;EACA,OAAA;AAAA;AAAA,UAGQ,WAAA;EACR,KAAA,EAAO,SAAA,OAAgB,GAAA,EAAK,kBAAA,KAAuB,SAAA;EALnD;;AAED;EAQC,GAAA,IACM,QAAA;IAEA,OAAA;IARC;;;IAYD,UAAA;EAAA;AAAA;AAAA,UAIE,SAAA;EAhBoB;EAkB5B,IAAA;EACA,KAAA;EACA,WAAA;EAdM;;;;;EAqBN,IAAA;AAAA;AAAA,UAGQ,mBAAA,SAA4B,kBAAA;EAdnB;;;EAkBjB,KAAA,EAAO,aAAA;EAPP;;;EAYA,MAAA;EAT4B;;;EAc5B,KAAA,GAAQ,WAAA;EAOS;;;;;EAAjB,IAAA,aAAiB,WAAA;EArBqC;;;EA0BtD,WAAA,IAAe,IAAA,EAAM,kBAAA,EAAoB,KAAA,EAAO,UAAA,cAAwB,OAAA;AAAA;AAAA,UAGhE,WAAA;EACR,UAAA;AAAA;AAAA,KAGU,MAAA,GAAS,oBAAA,GACnB,mBAAA;EARA;;;;;EAcE,KAAA;AAAA;AAAA,UAGM,kBAAA;EAAA,SACC,SAAA,EAAW,MAAA,SAAe,UAAA;EAAA,SAC1B,gBAAA,EAAkB,MAAA,SAAe,WAAA;EAAA,SACjC,SAAA,EAAW,MAAA,SAAe,iBAAA;AAAA;AAAA,iBAGf,aAAA,CAAc,OAAA,EAAS,MAAA,GAAS,OAAA;AAAA,iBA2BhC,iBAAA,CACpB,OAAA,EAAS,gBAAA,CAAiB,MAAA,cACzB,OAAA,CAAQ,UAAA"}

package/dist/generate-file.js

@@ -2,15 +2,26 @@ import { generateDocument, toText } from "./utils/pages/to-text.js";
 import { createAutoPreset } from "./utils/pages/preset-auto.js";
 import { fromSchema } from "./utils/pages/builder.js";
 import { mkdir, writeFile } from "node:fs/promises";
-import * as path from "node:path";
-import { createGetUrl, getSlugs } from "fumadocs-core/source";
+import * as path$1 from "node:path";
+import { PathUtils, createGetUrl, getSlugs } from "fumadocs-core/source";
 //#region src/generate-file.ts
 async function generateFiles(options) {
+	if (options.watch) {
+		const { watch } = await import("chokidar");
+		const subOptions = {
+			...options,
+			watch: false
+		};
+		await generateFiles(subOptions);
+		const targets = options.input._getWatchPaths();
+		console.log(`[Fumadocs OpenAPI] watching ${targets.join(", ")}`);
+		watch(targets, { ignoreInitial: true }).on("all", () => generateFiles(subOptions));
+		return;
+	}
 	const files = await generateFilesOnly(options);
-	const { output } = options;
 	await Promise.all(files.map(async (file) => {
-		const filePath = path.join(output, file.path);
-		await mkdir(path.dirname(filePath), { recursive: true });
+		const filePath = path$1.join(options.output, file.path);
+		await mkdir(path$1.dirname(filePath), { recursive: true });
 		await writeFile(filePath, file.content);
 		console.log(`Generated: ${filePath}`);
 	}));
@@ -25,54 +36,87 @@ async function generateFilesOnly(options) {
 	const preset = createAutoPreset(options);
 	for (const [id, schema] of entries) {
 		const entries = fromSchema(id, schema, preset);
-		const schemaFiles = generated[id] ??= [];
+		const schemaFiles = [];
 		generatedEntries[id] = entries;
-		for (const entry of entries) {
-			const file = {
+		function scan(entry) {
+			if (entry.type === "group") {
+				for (const child of entry.entries) scan(child);
+				return;
+			}
+			schemaFiles.push({
 				path: entry.path,
 				content: toText(entry, schema, options)
-			};
-			schemaFiles.push(file);
-			files.push(file);
+			});
 		}
+		for (const entry of entries) scan(entry);
+		generated[id] = schemaFiles;
+		files.push(...schemaFiles);
 	}
 	const context = {
 		generated,
 		generatedEntries,
 		documents: schemas
 	};
-	if (options.index) writeIndexFiles(files, context, options);
+	if (options.index) files.push(...writeIndexFiles(context, options));
+	if (options.meta) files.push(...generateMeta(context, options.meta === true ? {} : options.meta));
 	await options.beforeWrite?.call(context, files);
 	return files;
 }
-function writeIndexFiles(files, context, options) {
+function generateMeta(context, options) {
+	const files = [];
+	const { groupStyle = "folder" } = options;
+	function scan(entries, parent) {
+		const pages = [];
+		for (const entry of entries) {
+			const relativePath = PathUtils.slash(parent ? path$1.relative(parent.path, entry.path) : entry.path);
+			if (entry.type === "group") {
+				scan(entry.entries, entry);
+				if (groupStyle === "folder") pages.push(relativePath);
+				else pages.push(`---${entry.info.title}---`, `...${relativePath}`);
+			} else pages.push(relativePath.slice(0, -path$1.extname(entry.path).length));
+		}
+		if (pages.length === 0) return;
+		files.push({
+			path: parent ? path$1.join(parent.path, "meta.json") : "meta.json",
+			content: JSON.stringify({
+				title: parent?.info.title,
+				description: parent?.info.description,
+				pages
+			}, null, 2)
+		});
+	}
+	for (const entries of Object.values(context.generatedEntries)) scan(entries);
+	return files;
+}
+function writeIndexFiles(context, options) {
+	const files = [];
 	const { generatedEntries } = context;
+	const pathToEntry = /* @__PURE__ */ new Map();
 	const { items, url } = options.index;
+	function indexEntry(entry) {
+		pathToEntry.set(PathUtils.slash(entry.path), entry);
+		if (entry.type === "group") for (const child of entry.entries) indexEntry(child);
+	}
 	let urlFn;
 	if (typeof url === "object") {
 		const getUrl = createGetUrl(url.baseUrl);
-		urlFn = (file) => getUrl(getSlugs(path.relative(url.contentDir, file)));
+		urlFn = (file) => getUrl(getSlugs(path$1.relative(url.contentDir, file)));
 	} else urlFn = url;
-	function findEntryByPath(path) {
-		for (const entries of Object.values(generatedEntries)) {
-			const match = entries.find((entry) => entry.path === path);
-			if (match) return match;
-		}
-	}
 	function fileContent(index) {
 		const content = [];
 		content.push("<Cards>");
-		const pathToEntry = /* @__PURE__ */ new Map();
+		const outputEntries = [];
 		const only = index.only ?? Object.keys(context.generated);
-		for (const item of only) if (generatedEntries[item]) for (const entry of generatedEntries[item]) pathToEntry.set(entry.path, entry);
+		for (const item of only) if (generatedEntries[item]) for (const entry of generatedEntries[item]) outputEntries.push(entry);
 		else {
-			const match = findEntryByPath(item);
+			const match = pathToEntry.get(item);
 			if (!match) throw new Error(`${item} does not exist on "input", available: ${Object.keys(generatedEntries).join(", ")}.`);
-			pathToEntry.set(match.path, match);
+			outputEntries.push(match);
 		}
-		for (const file of pathToEntry.values()) {
-			const descriptionAttr = file.info.description ? `description=${JSON.stringify(file.info.description)} ` : "";
-			content.push(`<Card href="${urlFn(file.path)}" title=${JSON.stringify(file.info.title)} ${descriptionAttr}/>`);
+		for (const entry of outputEntries) {
+			if (entry.type === "group") continue;
+			const descriptionAttr = entry.info.description ? `description=${JSON.stringify(entry.info.description)} ` : "";
+			content.push(`<Card href="${urlFn(entry.path)}" title=${JSON.stringify(entry.info.title)} ${descriptionAttr}/>`);
 		}
 		content.push("</Cards>");
 		return generateDocument({
@@ -80,10 +124,12 @@ function writeIndexFiles(files, context, options) {
 			description: index.description
 		}, content.join("\n"), options);
 	}
+	for (const list of Object.values(context.generatedEntries)) for (const item of list) indexEntry(item);
 	for (const item of typeof items === "function" ? items(context) : items) files.push({
-		path: path.extname(item.path).length === 0 ? `${item.path}.mdx` : item.path,
+		path: path$1.extname(item.path).length === 0 ? `${item.path}.mdx` : item.path,
 		content: fileContent(item)
 	});
+	return files;
 }
 //#endregion
 export { generateFiles, generateFilesOnly };

package/dist/generate-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-file.js","names":[],"sources":["../src/generate-file.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { generateDocument, type PagesToTextOptions, toText } from './utils/pages/to-text';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport type { OpenAPIServer } from '@/server';\nimport { createGetUrl, getSlugs } from 'fumadocs-core/source';\nimport { createAutoPreset, type SchemaToPagesOptions } from '@/utils/pages/preset-auto';\nimport { fromSchema, type OutputEntry } from '@/utils/pages/builder';\n\nexport interface OutputFile {\n  path: string;\n  content: string;\n}\n\ninterface IndexConfig {\n  items: IndexItem[] | ((ctx: BeforeWriteContext) => IndexItem[]);\n\n  /**\n   * Generate URLs for cards\n   */\n  url:\n    | ((filePath: string) => string)\n    | {\n        baseUrl: string;\n        /**\n         * Base content directory\n         */\n        contentDir: string;\n      };\n}\n\ninterface IndexItem {\n  path: string;\n  title?: string;\n  description?: string;\n\n  /**\n   * Specify linked pages:\n   * - items in `inputs` to include all generated pages of a specific schema.\n   * - specific Markdown/MDX files.\n   */\n  only?: string[];\n}\n\ninterface GenerateFilesConfig extends PagesToTextOptions {\n  /**\n   * the OpenAPI server object\n   */\n  input: OpenAPIServer;\n\n  /**\n   * Output directory\n   */\n  output: string;\n\n  /**\n   * Generate index files with cards linking to generated pages.\n   */\n  index?: IndexConfig;\n\n  /**\n   * Can add/change/remove output files before writing to file system\n   **/\n  beforeWrite?: (this: BeforeWriteContext, files: OutputFile[]) => void | Promise<void>;\n}\n\nexport type Config = SchemaToPagesOptions & GenerateFilesConfig;\n\ninterface BeforeWriteContext {\n  readonly generated: Record<string, OutputFile[]>;\n  readonly generatedEntries: Record<string, OutputEntry[]>;\n  readonly documents: Record<string, ProcessedDocument>;\n}\n\nexport async function generateFiles(options: Config): Promise<void> {\n  const files = await generateFilesOnly(options);\n  const { output } = options;\n\n  await Promise.all(\n    files.map(async (file) => {\n      const filePath = path.join(output, file.path);\n\n      await mkdir(path.dirname(filePath), { recursive: true });\n      await writeFile(filePath, file.content);\n      console.log(`Generated: ${filePath}`);\n    }),\n  );\n}\n\nexport async function generateFilesOnly(\n  options: SchemaToPagesOptions & Omit<GenerateFilesConfig, 'output'>,\n): Promise<OutputFile[]> {\n  const schemas = await options.input.getSchemas();\n\n  const files: OutputFile[] = [];\n  const generated: Record<string, OutputFile[]> = {};\n  const generatedEntries: Record<string, OutputEntry[]> = {};\n\n  const entries = Object.entries(schemas);\n  if (entries.length === 0) {\n    throw new Error('No input files found.');\n  }\n  const preset = createAutoPreset(options);\n  for (const [id, schema] of entries) {\n    const entries = fromSchema(id, schema, preset);\n    const schemaFiles = (generated[id] ??= []);\n\n    generatedEntries[id] = entries;\n    for (const entry of entries) {\n      const file: OutputFile = {\n        path: entry.path,\n        content: toText(entry, schema, options),\n      };\n\n      schemaFiles.push(file);\n      files.push(file);\n    }\n  }\n\n  const context: BeforeWriteContext = {\n    generated,\n    generatedEntries,\n    documents: schemas,\n  };\n\n  if (options.index) {\n    writeIndexFiles(files, context, options);\n  }\n\n  await options.beforeWrite?.call(context, files);\n  return files;\n}\n\nfunction writeIndexFiles(\n  files: OutputFile[],\n  context: BeforeWriteContext,\n  options: SchemaToPagesOptions & Omit<GenerateFilesConfig, 'output'>,\n) {\n  const { generatedEntries } = context;\n  const { items, url } = options.index!;\n\n  let urlFn: (path: string) => string;\n  if (typeof url === 'object') {\n    const getUrl = createGetUrl(url.baseUrl);\n\n    urlFn = (file) => getUrl(getSlugs(path.relative(url.contentDir, file)));\n  } else {\n    urlFn = url;\n  }\n\n  function findEntryByPath(path: string) {\n    for (const entries of Object.values(generatedEntries)) {\n      const match = entries.find((entry) => entry.path === path);\n\n      if (match) return match;\n    }\n  }\n\n  function fileContent(index: IndexItem): string {\n    const content: string[] = [];\n    content.push('<Cards>');\n    const pathToEntry = new Map<string, OutputEntry>();\n    const only = index.only ?? Object.keys(context.generated);\n\n    for (const item of only) {\n      if (generatedEntries[item]) {\n        for (const entry of generatedEntries[item]) {\n          pathToEntry.set(entry.path, entry);\n        }\n      } else {\n        const match = findEntryByPath(item);\n        if (!match) {\n          throw new Error(\n            `${item} does not exist on \"input\", available: ${Object.keys(generatedEntries).join(', ')}.`,\n          );\n        }\n\n        pathToEntry.set(match.path, match);\n      }\n    }\n\n    for (const file of pathToEntry.values()) {\n      const descriptionAttr = file.info.description\n        ? `description=${JSON.stringify(file.info.description)} `\n        : '';\n      content.push(\n        `<Card href=\"${urlFn(file.path)}\" title=${JSON.stringify(file.info.title)} ${descriptionAttr}/>`,\n      );\n    }\n\n    content.push('</Cards>');\n    return generateDocument(\n      {\n        title: index.title ?? 'Overview',\n        description: index.description,\n      },\n      content.join('\\n'),\n      options,\n    );\n  }\n\n  for (const item of typeof items === 'function' ? items(context) : items) {\n    files.push({\n      path: path.extname(item.path).length === 0 ? `${item.path}.mdx` : item.path,\n      content: fileContent(item),\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"generate-file.js","names":["path"],"sources":["../src/generate-file.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { generateDocument, type PagesToTextOptions, toText } from './utils/pages/to-text';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport type { OpenAPIServer } from '@/server';\nimport { createGetUrl, getSlugs, PathUtils } from 'fumadocs-core/source';\nimport { createAutoPreset, type SchemaToPagesOptions } from '@/utils/pages/preset-auto';\nimport { fromSchema, type OutputGroup, type OutputEntry } from '@/utils/pages/builder';\nimport type { DistributiveOmit } from './types';\n\nexport interface OutputFile {\n  path: string;\n  content: string;\n}\n\ninterface IndexConfig {\n  items: IndexItem[] | ((ctx: BeforeWriteContext) => IndexItem[]);\n\n  /**\n   * Generate URLs for cards\n   */\n  url:\n    | ((filePath: string) => string)\n    | {\n        baseUrl: string;\n        /**\n         * Base content directory\n         */\n        contentDir: string;\n      };\n}\n\ninterface IndexItem {\n  /** output path of index page */\n  path: string;\n  title?: string;\n  description?: string;\n\n  /**\n   * Specify linked pages:\n   * - items in `inputs` to include all generated pages of a specific schema.\n   * - file paths (using forward slash).\n   */\n  only?: string[];\n}\n\ninterface GenerateFilesConfig extends PagesToTextOptions {\n  /**\n   * the OpenAPI server object\n   */\n  input: OpenAPIServer;\n\n  /**\n   * Output directory\n   */\n  output: string;\n\n  /**\n   * Generate index files with cards linking to generated pages.\n   */\n  index?: IndexConfig;\n\n  /**\n   * Generate `meta.json` files.\n   *\n   * Note: for flexibility, it's recommended to define them on your own.\n   */\n  meta?: boolean | MetaOptions;\n\n  /**\n   * Can add/change/remove output files before writing to file system\n   **/\n  beforeWrite?: (this: BeforeWriteContext, files: OutputFile[]) => void | Promise<void>;\n}\n\ninterface MetaOptions {\n  groupStyle?: 'folder' | 'separator';\n}\n\nexport type Config = SchemaToPagesOptions &\n  GenerateFilesConfig & {\n    /**\n     * Re-generate when **schema files are changed**, ignores custom input functions & URLs.\n     *\n     * Note: it is recommended to configure & use `chokidar` on your own, this is only for simple cases.\n     */\n    watch?: boolean;\n  };\n\ninterface BeforeWriteContext {\n  readonly generated: Record<string, OutputFile[]>;\n  readonly generatedEntries: Record<string, OutputEntry[]>;\n  readonly documents: Record<string, ProcessedDocument>;\n}\n\nexport async function generateFiles(options: Config): Promise<void> {\n  if (options.watch) {\n    const { watch } = await import('chokidar');\n    const subOptions: Config = { ...options, watch: false };\n\n    await generateFiles(subOptions);\n    const targets = options.input._getWatchPaths();\n    console.log(`[Fumadocs OpenAPI] watching ${targets.join(', ')}`);\n    watch(targets, {\n      ignoreInitial: true,\n    }).on('all', () => generateFiles(subOptions));\n    return;\n  }\n\n  const files = await generateFilesOnly(options);\n\n  await Promise.all(\n    files.map(async (file) => {\n      const filePath = path.join(options.output, file.path);\n\n      await mkdir(path.dirname(filePath), { recursive: true });\n      await writeFile(filePath, file.content);\n      console.log(`Generated: ${filePath}`);\n    }),\n  );\n}\n\nexport async function generateFilesOnly(\n  options: DistributiveOmit<Config, 'output'>,\n): Promise<OutputFile[]> {\n  const schemas = await options.input.getSchemas();\n\n  const files: OutputFile[] = [];\n  const generated: Record<string, OutputFile[]> = {};\n  const generatedEntries: Record<string, OutputEntry[]> = {};\n\n  const entries = Object.entries(schemas);\n  if (entries.length === 0) {\n    throw new Error('No input files found.');\n  }\n  const preset = createAutoPreset(options);\n  for (const [id, schema] of entries) {\n    const entries = fromSchema(id, schema, preset);\n    const schemaFiles: OutputFile[] = [];\n\n    generatedEntries[id] = entries;\n    function scan(entry: OutputEntry) {\n      if (entry.type === 'group') {\n        for (const child of entry.entries) scan(child);\n        return;\n      }\n\n      schemaFiles.push({\n        path: entry.path,\n        content: toText(entry, schema, options),\n      });\n    }\n\n    for (const entry of entries) scan(entry);\n    generated[id] = schemaFiles;\n    files.push(...schemaFiles);\n  }\n\n  const context: BeforeWriteContext = {\n    generated,\n    generatedEntries,\n    documents: schemas,\n  };\n\n  if (options.index) {\n    files.push(...writeIndexFiles(context, options));\n  }\n\n  if (options.meta) {\n    files.push(...generateMeta(context, options.meta === true ? {} : options.meta));\n  }\n\n  await options.beforeWrite?.call(context, files);\n  return files;\n}\n\nfunction generateMeta(context: BeforeWriteContext, options: MetaOptions): OutputFile[] {\n  const files: OutputFile[] = [];\n  const { groupStyle = 'folder' } = options;\n\n  function scan(entries: OutputEntry[], parent?: OutputGroup) {\n    const pages: string[] = [];\n\n    for (const entry of entries) {\n      const relativePath = PathUtils.slash(\n        parent ? path.relative(parent.path, entry.path) : entry.path,\n      );\n\n      if (entry.type === 'group') {\n        scan(entry.entries, entry);\n\n        if (groupStyle === 'folder') {\n          pages.push(relativePath);\n        } else {\n          pages.push(`---${entry.info.title}---`, `...${relativePath}`);\n        }\n      } else {\n        pages.push(relativePath.slice(0, -path.extname(entry.path).length));\n      }\n    }\n\n    if (pages.length === 0) return;\n    files.push({\n      path: parent ? path.join(parent.path, 'meta.json') : 'meta.json',\n      content: JSON.stringify(\n        {\n          title: parent?.info.title,\n          description: parent?.info.description,\n          pages,\n        },\n        null,\n        2,\n      ),\n    });\n  }\n\n  for (const entries of Object.values(context.generatedEntries)) {\n    scan(entries);\n  }\n\n  return files;\n}\n\nfunction writeIndexFiles(\n  context: BeforeWriteContext,\n  options: SchemaToPagesOptions & Omit<GenerateFilesConfig, 'output'>,\n): OutputFile[] {\n  const files: OutputFile[] = [];\n  const { generatedEntries } = context;\n  const pathToEntry = new Map<string, OutputEntry>();\n  const { items, url } = options.index!;\n\n  function indexEntry(entry: OutputEntry) {\n    pathToEntry.set(PathUtils.slash(entry.path), entry);\n    if (entry.type === 'group') {\n      for (const child of entry.entries) {\n        indexEntry(child);\n      }\n    }\n  }\n\n  let urlFn: (path: string) => string;\n  if (typeof url === 'object') {\n    const getUrl = createGetUrl(url.baseUrl);\n\n    urlFn = (file) => getUrl(getSlugs(path.relative(url.contentDir, file)));\n  } else {\n    urlFn = url;\n  }\n\n  function fileContent(index: IndexItem): string {\n    const content: string[] = [];\n    content.push('<Cards>');\n    const outputEntries: OutputEntry[] = [];\n    const only = index.only ?? Object.keys(context.generated);\n\n    for (const item of only) {\n      if (generatedEntries[item]) {\n        for (const entry of generatedEntries[item]) {\n          outputEntries.push(entry);\n        }\n      } else {\n        const match = pathToEntry.get(item);\n        if (!match) {\n          throw new Error(\n            `${item} does not exist on \"input\", available: ${Object.keys(generatedEntries).join(', ')}.`,\n          );\n        }\n\n        outputEntries.push(match);\n      }\n    }\n\n    for (const entry of outputEntries) {\n      // cannot link to groups\n      if (entry.type === 'group') continue;\n      const descriptionAttr = entry.info.description\n        ? `description=${JSON.stringify(entry.info.description)} `\n        : '';\n      content.push(\n        `<Card href=\"${urlFn(entry.path)}\" title=${JSON.stringify(entry.info.title)} ${descriptionAttr}/>`,\n      );\n    }\n\n    content.push('</Cards>');\n    return generateDocument(\n      {\n        title: index.title ?? 'Overview',\n        description: index.description,\n      },\n      content.join('\\n'),\n      options,\n    );\n  }\n\n  for (const list of Object.values(context.generatedEntries)) {\n    for (const item of list) indexEntry(item);\n  }\n\n  for (const item of typeof items === 'function' ? items(context) : items) {\n    files.push({\n      path: path.extname(item.path).length === 0 ? `${item.path}.mdx` : item.path,\n      content: fileContent(item),\n    });\n  }\n\n  return files;\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { MediaAdapter } from "./requests/media/adapter.js";
-import { OperationOutput, OutputEntry, OutputGroup, PagesBuilder, PagesBuilderConfig, TagOutput, WebhookOutput, fromSchema, fromServer } from "./utils/pages/builder.js";
+import { OperationOutput, OutputEntry, OutputGroup, PageOutput, PagesBuilder, PagesBuilderConfig, WebhookOutput, fromSchema, fromServer } from "./utils/pages/builder.js";
 import { SchemaToPagesOptions, createAutoPreset } from "./utils/pages/preset-auto.js";
 import { Awaitable, CallbackObject, DistributiveOmit, Document, ExampleObject, HttpMethods, MediaTypeObject, MethodInformation, OAuth2SecurityScheme, OperationObject, ParameterObject, PathItemObject, ReferenceObject, RenderContext, RequestBodyObject, ResponseObject, SecuritySchemeObject, ServerObject, ServerVariableObject, TagObject } from "./types.js";
 import { Config, OutputFile, generateFiles, generateFilesOnly } from "./generate-file.js";
-export { Awaitable, CallbackObject, Config, DistributiveOmit, Document, ExampleObject, HttpMethods, type MediaAdapter, MediaTypeObject, MethodInformation, OAuth2SecurityScheme, OperationObject, OperationOutput, OutputEntry, OutputFile, OutputGroup, PagesBuilder, PagesBuilderConfig, ParameterObject, PathItemObject, ReferenceObject, RenderContext, RequestBodyObject, ResponseObject, SchemaToPagesOptions, SecuritySchemeObject, ServerObject, ServerVariableObject, TagObject, TagOutput, WebhookOutput, createAutoPreset, fromSchema, fromServer, generateFiles, generateFilesOnly };
+export { Awaitable, CallbackObject, Config, DistributiveOmit, Document, ExampleObject, HttpMethods, type MediaAdapter, MediaTypeObject, MethodInformation, OAuth2SecurityScheme, OperationObject, OperationOutput, OutputEntry, OutputFile, OutputGroup, PageOutput, PagesBuilder, PagesBuilderConfig, ParameterObject, PathItemObject, ReferenceObject, RenderContext, RequestBodyObject, ResponseObject, SchemaToPagesOptions, SecuritySchemeObject, ServerObject, ServerVariableObject, TagObject, WebhookOutput, createAutoPreset, fromSchema, fromServer, generateFiles, generateFilesOnly };