fumadocs-openapi 10.5.0 → 10.6.1

package/css/generated/shared.css

@@ -84,6 +84,7 @@
 @source inline("basic");
 @source inline("be");
 @source inline("because");
+@source inline("before");
 @source inline("between");
 @source inline("bg-black/30");
 @source inline("bg-fd-background/50");
@@ -108,6 +109,7 @@
 @source inline("border-x");
 @source inline("border-y");
 @source inline("both");
+@source inline("bundled");
 @source inline("but");
 @source inline("button");
 @source inline("buttonVariants");
@@ -139,6 +141,7 @@
 @source inline("cloned");
 @source inline("cn");
 @source inline("code");
+@source inline("codeProps");
 @source inline("codeUsages");
 @source inline("codegen");
 @source inline("codegens");
@@ -168,6 +171,7 @@
 @source inline("createContext");
 @source inline("createMethod");
 @source inline("createRehypeCode");
+@source inline("credentials");
 @source inline("css");
 @source inline("ctx");
 @source inline("current");
@@ -195,10 +199,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");
@@ -210,12 +215,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");
@@ -227,13 +233,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");
@@ -255,17 +261,18 @@
 @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");
 @source inline("fetch");
+@source inline("fetchOptions");
 @source inline("fetcher");
 @source inline("fetchingToken");
 @source inline("field");
@@ -338,11 +345,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");
@@ -393,9 +402,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");
@@ -434,6 +443,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");
@@ -444,7 +454,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");
@@ -473,15 +482,18 @@
 @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");
@@ -521,6 +533,7 @@
 @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");
@@ -580,7 +593,6 @@
 @source inline("page");
 @source inline("pageData");
 @source inline("pages");
-@source inline("panels");
 @source inline("param");
 @source inline("paramTypeKeys");
 @source inline("parameter");
@@ -596,13 +608,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");
@@ -616,7 +628,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");
@@ -624,7 +635,6 @@
 @source inline("position");
 @source inline("pre");
 @source inline("prefix");
-@source inline("preprocessed");
 @source inline("prev");
 @source inline("prevProperties");
 @source inline("prevent");
@@ -633,12 +643,13 @@
 @source inline("primitive");
 @source inline("processed");
 @source inline("processor");
-@source inline("programming");
 @source inline("prop");
 @source inline("properties");
 @source inline("property");
 @source inline("props");
 @source inline("prose-no-margin");
+@source inline("proxy");
+@source inline("proxyForwardCookie");
 @source inline("proxyUrl");
 @source inline("ps-2");
 @source inline("ps-4.5");
@@ -668,6 +679,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");
@@ -694,7 +706,6 @@
 @source inline("render");
 @source inline("renderAPIExampleLayout");
 @source inline("renderAPIExampleUsageTabs");
-@source inline("renderBodyField");
 @source inline("renderOperationLayout");
 @source inline("renderPageLayout");
 @source inline("renderParameterField");
@@ -714,17 +725,18 @@
 @source inline("request-body");
 @source inline("requestBody");
 @source inline("requestData");
+@source inline("requestInit");
 @source inline("requestTabNameDefault");
 @source inline("requestTimeout");
+@source inline("requestUrl");
 @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");
@@ -740,6 +752,7 @@
 @source inline("rest");
 @source inline("result");
 @source inline("return");
+@source inline("returned");
 @source inline("root");
 @source inline("rotate-90");
 @source inline("rounded-lg");
@@ -794,9 +807,9 @@
 @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");
@@ -842,6 +855,7 @@
 @source inline("slot");
 @source inline("slotType");
 @source inline("slots");
+@source inline("slug");
 @source inline("slugger");
 @source inline("sm");
 @source inline("sm:flex-row");
@@ -849,7 +863,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");
@@ -867,6 +880,7 @@
 @source inline("step");
 @source inline("stf");
 @source inline("sticky");
+@source inline("storageKey");
 @source inline("storageKeyPrefix");
 @source inline("storageKeys");
 @source inline("store");
@@ -879,15 +893,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]");
@@ -979,18 +992,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";
 
@@ -61,14 +62,21 @@ interface GenerateFilesConfig extends PagesToTextOptions {
 interface MetaOptions {
   groupStyle?: 'folder' | 'separator';
 }
-type Config = SchemaToPagesOptions & GenerateFilesConfig;
+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;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,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

@@ -6,10 +6,21 @@ 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$1.join(output, file.path);
+		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,7 +36,7 @@ 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;
 		function scan(entry) {
 			if (entry.type === "group") {
@@ -38,6 +49,7 @@ async function generateFilesOnly(options) {
 			});
 		}
 		for (const entry of entries) scan(entry);
+		generated[id] = schemaFiles;
 		files.push(...schemaFiles);
 	}
 	const context = {

package/dist/generate-file.js.map

@@ -1 +1 @@
-{"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';\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 & 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    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    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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"}
+{"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/playground/client.d.ts

@@ -1,10 +1,11 @@
-import { ParsedSchema } from "../utils/schema.js";
-import { FetchResult } from "./fetcher.js";
+import { ParsedSchema } from "../utils/schema/index.js";
+import { BrowserFetcherOptions, FetchResult } from "./fetcher.js";
 import { SecurityEntry } from "./index.js";
 import { SchemaScope } from "./schema.js";
 import { ParameterObject } from "../types.js";
 import { ComponentProps, FC, ReactNode } from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { Collapsible } from "fumadocs-ui/components/ui/collapsible";
 import { FieldKey } from "@fumari/stf";
 
 //#region src/playground/client.d.ts
@@ -30,20 +31,29 @@ interface PlaygroundClientProps extends ComponentProps<'form'>, SchemaScope {
   references: Record<string, ParsedSchema>;
   proxyUrl?: string;
 }
+interface ResultDisplayProps extends ComponentProps<'div'> {
+  data: FetchResult;
+  reset: () => void;
+}
+interface CollapsiblePanelProps extends Omit<ComponentProps<typeof Collapsible>, 'title'> {
+  'data-type': 'authorization' | 'body' | ParamType;
+  title: ReactNode;
+}
 interface PlaygroundClientOptions {
   /**
    * transform fields for auth-specific parameters (e.g. header)
    */
   transformAuthInputs?: (fields: AuthField[]) => AuthField[];
+  fetchOptions?: BrowserFetcherOptions;
   /**
    * Request timeout in seconds (default: 10s)
+   * @deprecated use `fetchOptions.requestTimeout` instead.
    */
   requestTimeout?: number;
-  components?: Partial<{
-    ResultDisplay: FC<{
-      data: FetchResult;
-    }>;
-  }>;
+  components?: {
+    ResultDisplay?: FC<ResultDisplayProps>;
+    CollapsiblePanel?: FC<CollapsiblePanelProps>;
+  };
   /**
    * render the parameter inputs of API endpoint.
    *
@@ -74,7 +84,9 @@ declare function PlaygroundClient({
   writeOnly,
   readOnly,
   ...rest
-}: PlaygroundClientProps): react_jsx_runtime0.JSX.Element;
+}: PlaygroundClientProps): _$react_jsx_runtime0.JSX.Element;
+declare const ParamTypes: readonly ["path", "header", "cookie", "query"];
+type ParamType = (typeof ParamTypes)[number];
 interface AuthField {
   fieldName: FieldKey;
   defaultValue: unknown;
@@ -82,6 +94,16 @@ interface AuthField {
   children: ReactNode;
   mapOutput?: (values: unknown) => unknown;
 }
+declare function DefaultResultDisplay({
+  data,
+  reset,
+  ...rest
+}: ResultDisplayProps): _$react_jsx_runtime0.JSX.Element;
+declare function DefaultCollapsiblePanel({
+  title,
+  children,
+  ...props
+}: CollapsiblePanelProps): _$react_jsx_runtime0.JSX.Element;
 declare const Custom: {
   useController(fieldName: FieldKey, options?: {
     defaultValue?: unknown;
@@ -91,5 +113,5 @@ declare const Custom: {
   };
 };
 //#endregion
-export { AuthField, Custom, FormValues, PlaygroundClientOptions, PlaygroundClientProps, PlaygroundClient as default };
+export { AuthField, CollapsiblePanelProps, Custom, DefaultCollapsiblePanel, DefaultResultDisplay, FormValues, PlaygroundClientOptions, PlaygroundClientProps, ResultDisplayProps, PlaygroundClient as default };
 //# sourceMappingURL=client.d.ts.map

package/dist/playground/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/playground/client.tsx"],"mappings":";;;;;;;;;;UAwDiB,UAAA,SAAmB,MAAA;EAClC,IAAA,EAAM,MAAA;EACN,KAAA,EAAO,MAAA;EACP,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,MAAA;EACR,IAAA;AAAA;AAAA,UAGe,qBAAA,SAA8B,cAAA,UAAwB,WAAA;EACrE,KAAA;EACA,MAAA;EACA,UAAA,GAAa,eAAA;EACb,UAAA,EAAY,aAAA;EACZ,IAAA;IACE,MAAA,EAAQ,YAAA;IACR,SAAA;EAAA;EAbF;;;EAkBA,UAAA,EAAY,MAAA,SAAe,YAAA;EAC3B,QAAA;AAAA;AAAA,UAGe,uBAAA;EAnBX;;AAGN;EAoBE,mBAAA,IAAuB,MAAA,EAAQ,SAAA,OAAgB,SAAA;;;;EAK/C,cAAA;EAEA,UAAA,GAAa,OAAA;IACX,aAAA,EAAe,EAAA;MAAK,IAAA,EAAM,WAAA;IAAA;EAAA;EA5BoD;;;;;;;;EAuChF,oBAAA,IAAwB,SAAA,EAAW,QAAA,EAAU,KAAA,EAAO,eAAA,KAAoB,SAAA;EAlCxE;;;;;EAyCA,eAAA,IACE,SAAA,UACA,IAAA;IACE,MAAA,EAAQ,YAAA;IACR,SAAA;EAAA,MAEC,SAAA;AAAA;AAAA,iBAciB,gBAAA,CAAA;EACtB,KAAA;EACA,MAAA;EACA,UAAA;EACA,UAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EACA,SAAA;EACA,QAAA;EAAA,GACG;AAAA,GACF,qBAAA,GAAqB,kBAAA,CAAA,GAAA,CAAA,OAAA;AAAA,UAqVP,SAAA;EACf,SAAA,EAAW,QAAA;EACX,YAAA;EAEA,QAAA,GAAW,aAAA;EACX,QAAA,EAAU,SAAA;EAEV,SAAA,IAAa,MAAA;AAAA;AAAA,cAgQF,MAAA;2BAEE,QAAA,EAAQ,OAAA;IAEjB,YAAA;EAAA"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/playground/client.tsx"],"mappings":";;;;;;;;;;;UAwDiB,UAAA,SAAmB,MAAA;EAClC,IAAA,EAAM,MAAA;EACN,KAAA,EAAO,MAAA;EACP,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,MAAA;EACR,IAAA;AAAA;AAAA,UAGe,qBAAA,SAA8B,cAAA,UAAwB,WAAA;EACrE,KAAA;EACA,MAAA;EACA,UAAA,GAAa,eAAA;EACb,UAAA,EAAY,aAAA;EACZ,IAAA;IACE,MAAA,EAAQ,YAAA;IACR,SAAA;EAAA;EAbF;;;EAkBA,UAAA,EAAY,MAAA,SAAe,YAAA;EAC3B,QAAA;AAAA;AAAA,UAGe,kBAAA,SAA2B,cAAA;EAC1C,IAAA,EAAM,WAAA;EACN,KAAA;AAAA;AAAA,UAGe,qBAAA,SAA8B,IAAA,CAAK,cAAA,QAAsB,WAAA;EACxE,WAAA,6BAAwC,SAAA;EACxC,KAAA,EAAO,SAAA;AAAA;AAAA,UAGQ,uBAAA;EAdY;;;EAkB3B,mBAAA,IAAuB,MAAA,EAAQ,SAAA,OAAgB,SAAA;EAE/C,YAAA,GAAe,qBAAA;EAhCiE;;;;EAsChF,cAAA;EAEA,UAAA;IACE,aAAA,GAAgB,EAAA,CAAG,kBAAA;IACnB,gBAAA,GAAmB,EAAA,CAAG,qBAAA;EAAA;EArCxB;;;;;;;;EAgDA,oBAAA,IAAwB,SAAA,EAAW,QAAA,EAAU,KAAA,EAAO,eAAA,KAAoB,SAAA;EAxChE;AAGV;;;;EA4CE,eAAA,IACE,SAAA,UACA,IAAA;IACE,MAAA,EAAQ,YAAA;IACR,SAAA;EAAA,MAEC,SAAA;AAAA;AAAA,iBAciB,gBAAA,CAAA;EACtB,KAAA;EACA,MAAA;EACA,UAAA;EACA,UAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EACA,SAAA;EACA,QAAA;EAAA,GACG;AAAA,GACF,qBAAA,GAAqB,oBAAA,CAAA,GAAA,CAAA,OAAA;AAAA,cA4OlB,UAAA;AAAA,KACD,SAAA,WAAoB,UAAA;AAAA,UAiHR,SAAA;EACf,SAAA,EAAW,QAAA;EACX,YAAA;EAEA,QAAA,GAAW,aAAA;EACX,QAAA,EAAU,SAAA;EAEV,SAAA,IAAa,MAAA;AAAA;AAAA,iBA8MC,oBAAA,CAAA;EAAuB,IAAA;EAAM,KAAA;EAAA,GAAU;AAAA,GAAQ,kBAAA,GAAkB,oBAAA,CAAA,GAAA,CAAA,OAAA;AAAA,iBAoCjE,uBAAA,CAAA;EAA0B,KAAA;EAAO,QAAA;EAAA,GAAa;AAAA,GAAS,qBAAA,GAAqB,oBAAA,CAAA,GAAA,CAAA,OAAA;AAAA,cAc/E,MAAA;2BAEE,QAAA,EAAQ,OAAA;IAEjB,YAAA;EAAA"}