fumadocs-openapi 10.4.0 → 10.5.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");
@@ -300,6 +301,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");
@@ -480,6 +483,7 @@
 @source inline("merge");
 @source inline("mergeAllOf");
 @source inline("message");
+@source inline("meta");
 @source inline("metaData");
 @source inline("method");
 @source inline("min");
@@ -516,6 +520,7 @@
 @source inline("next-themes");
 @source inline("no-cache");
 @source inline("node");
+@source inline("node:path");
 @source inline("non-string");
 @source inline("not");
 @source inline("not-last:pb-0");
@@ -582,8 +587,7 @@
 @source inline("parameterNode");
 @source inline("parameters");
 @source inline("params");
-@source inline("paremeter");
-@source inline("paremeters");
+@source inline("parent");
 @source inline("parsed");
 @source inline("parsedState");
 @source inline("parts");
@@ -679,6 +683,7 @@
 @source inline("registered");
 @source inline("registry");
 @source inline("rehype-react");
+@source inline("relativePath");
 @source inline("remark");
 @source inline("remark-rehype");
 @source inline("remarkGfm");
@@ -784,6 +789,7 @@
 @source inline("selector");
 @source inline("selectorNode");
 @source inline("sep");
+@source inline("separator");
 @source inline("server");
 @source inline("server-side");
 @source inline("server-url");
@@ -926,7 +932,6 @@
 @source inline("titleRequestTabs");
 @source inline("titleResponseBody");
 @source inline("to");
-@source inline("toBody");
 @source inline("toJsxRuntime");
 @source inline("toStaticData");
 @source inline("toc");

package/dist/generate-file.d.ts

@@ -23,13 +23,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,11 +47,20 @@ 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>;
 }
+interface MetaOptions {
+  groupStyle?: 'folder' | 'separator';
+}
 type Config = SchemaToPagesOptions & GenerateFilesConfig;
 interface BeforeWriteContext {
   readonly generated: Record<string, OutputFile[]>;

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":";;;;;;;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"}

package/dist/generate-file.js

@@ -2,15 +2,15 @@ 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) {
 	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(output, file.path);
+		await mkdir(path$1.dirname(filePath), { recursive: true });
 		await writeFile(filePath, file.content);
 		console.log(`Generated: ${filePath}`);
 	}));
@@ -27,52 +27,84 @@ async function generateFilesOnly(options) {
 		const entries = fromSchema(id, schema, preset);
 		const schemaFiles = generated[id] ??= [];
 		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);
+		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 +112,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';\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":";;;;;;;AAsFA,eAAsB,cAAc,SAAgC;CAClE,MAAM,QAAQ,MAAM,kBAAkB,QAAQ;CAC9C,MAAM,EAAE,WAAW;AAEnB,OAAM,QAAQ,IACZ,MAAM,IAAI,OAAO,SAAS;EACxB,MAAM,WAAWA,OAAK,KAAK,QAAQ,KAAK,KAAK;AAE7C,QAAM,MAAMA,OAAK,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;AACxD,QAAM,UAAU,UAAU,KAAK,QAAQ;AACvC,UAAQ,IAAI,cAAc,WAAW;GACrC,CACH;;AAGH,eAAsB,kBACpB,SACuB;CACvB,MAAM,UAAU,MAAM,QAAQ,MAAM,YAAY;CAEhD,MAAM,QAAsB,EAAE;CAC9B,MAAM,YAA0C,EAAE;CAClD,MAAM,mBAAkD,EAAE;CAE1D,MAAM,UAAU,OAAO,QAAQ,QAAQ;AACvC,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,MAAM,wBAAwB;CAE1C,MAAM,SAAS,iBAAiB,QAAQ;AACxC,MAAK,MAAM,CAAC,IAAI,WAAW,SAAS;EAClC,MAAM,UAAU,WAAW,IAAI,QAAQ,OAAO;EAC9C,MAAM,cAAe,UAAU,QAAQ,EAAE;AAEzC,mBAAiB,MAAM;EACvB,SAAS,KAAK,OAAoB;AAChC,OAAI,MAAM,SAAS,SAAS;AAC1B,SAAK,MAAM,SAAS,MAAM,QAAS,MAAK,MAAM;AAC9C;;AAGF,eAAY,KAAK;IACf,MAAM,MAAM;IACZ,SAAS,OAAO,OAAO,QAAQ,QAAQ;IACxC,CAAC;;AAGJ,OAAK,MAAM,SAAS,QAAS,MAAK,MAAM;AACxC,QAAM,KAAK,GAAG,YAAY;;CAG5B,MAAM,UAA8B;EAClC;EACA;EACA,WAAW;EACZ;AAED,KAAI,QAAQ,MACV,OAAM,KAAK,GAAG,gBAAgB,SAAS,QAAQ,CAAC;AAGlD,KAAI,QAAQ,KACV,OAAM,KAAK,GAAG,aAAa,SAAS,QAAQ,SAAS,OAAO,EAAE,GAAG,QAAQ,KAAK,CAAC;AAGjF,OAAM,QAAQ,aAAa,KAAK,SAAS,MAAM;AAC/C,QAAO;;AAGT,SAAS,aAAa,SAA6B,SAAoC;CACrF,MAAM,QAAsB,EAAE;CAC9B,MAAM,EAAE,aAAa,aAAa;CAElC,SAAS,KAAK,SAAwB,QAAsB;EAC1D,MAAM,QAAkB,EAAE;AAE1B,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,eAAe,UAAU,MAC7B,SAASA,OAAK,SAAS,OAAO,MAAM,MAAM,KAAK,GAAG,MAAM,KACzD;AAED,OAAI,MAAM,SAAS,SAAS;AAC1B,SAAK,MAAM,SAAS,MAAM;AAE1B,QAAI,eAAe,SACjB,OAAM,KAAK,aAAa;QAExB,OAAM,KAAK,MAAM,MAAM,KAAK,MAAM,MAAM,MAAM,eAAe;SAG/D,OAAM,KAAK,aAAa,MAAM,GAAG,CAACA,OAAK,QAAQ,MAAM,KAAK,CAAC,OAAO,CAAC;;AAIvE,MAAI,MAAM,WAAW,EAAG;AACxB,QAAM,KAAK;GACT,MAAM,SAASA,OAAK,KAAK,OAAO,MAAM,YAAY,GAAG;GACrD,SAAS,KAAK,UACZ;IACE,OAAO,QAAQ,KAAK;IACpB,aAAa,QAAQ,KAAK;IAC1B;IACD,EACD,MACA,EACD;GACF,CAAC;;AAGJ,MAAK,MAAM,WAAW,OAAO,OAAO,QAAQ,iBAAiB,CAC3D,MAAK,QAAQ;AAGf,QAAO;;AAGT,SAAS,gBACP,SACA,SACc;CACd,MAAM,QAAsB,EAAE;CAC9B,MAAM,EAAE,qBAAqB;CAC7B,MAAM,8BAAc,IAAI,KAA0B;CAClD,MAAM,EAAE,OAAO,QAAQ,QAAQ;CAE/B,SAAS,WAAW,OAAoB;AACtC,cAAY,IAAI,UAAU,MAAM,MAAM,KAAK,EAAE,MAAM;AACnD,MAAI,MAAM,SAAS,QACjB,MAAK,MAAM,SAAS,MAAM,QACxB,YAAW,MAAM;;CAKvB,IAAI;AACJ,KAAI,OAAO,QAAQ,UAAU;EAC3B,MAAM,SAAS,aAAa,IAAI,QAAQ;AAExC,WAAS,SAAS,OAAO,SAASA,OAAK,SAAS,IAAI,YAAY,KAAK,CAAC,CAAC;OAEvE,SAAQ;CAGV,SAAS,YAAY,OAA0B;EAC7C,MAAM,UAAoB,EAAE;AAC5B,UAAQ,KAAK,UAAU;EACvB,MAAM,gBAA+B,EAAE;EACvC,MAAM,OAAO,MAAM,QAAQ,OAAO,KAAK,QAAQ,UAAU;AAEzD,OAAK,MAAM,QAAQ,KACjB,KAAI,iBAAiB,MACnB,MAAK,MAAM,SAAS,iBAAiB,MACnC,eAAc,KAAK,MAAM;OAEtB;GACL,MAAM,QAAQ,YAAY,IAAI,KAAK;AACnC,OAAI,CAAC,MACH,OAAM,IAAI,MACR,GAAG,KAAK,yCAAyC,OAAO,KAAK,iBAAiB,CAAC,KAAK,KAAK,CAAC,GAC3F;AAGH,iBAAc,KAAK,MAAM;;AAI7B,OAAK,MAAM,SAAS,eAAe;AAEjC,OAAI,MAAM,SAAS,QAAS;GAC5B,MAAM,kBAAkB,MAAM,KAAK,cAC/B,eAAe,KAAK,UAAU,MAAM,KAAK,YAAY,CAAC,KACtD;AACJ,WAAQ,KACN,eAAe,MAAM,MAAM,KAAK,CAAC,UAAU,KAAK,UAAU,MAAM,KAAK,MAAM,CAAC,GAAG,gBAAgB,IAChG;;AAGH,UAAQ,KAAK,WAAW;AACxB,SAAO,iBACL;GACE,OAAO,MAAM,SAAS;GACtB,aAAa,MAAM;GACpB,EACD,QAAQ,KAAK,KAAK,EAClB,QACD;;AAGH,MAAK,MAAM,QAAQ,OAAO,OAAO,QAAQ,iBAAiB,CACxD,MAAK,MAAM,QAAQ,KAAM,YAAW,KAAK;AAG3C,MAAK,MAAM,QAAQ,OAAO,UAAU,aAAa,MAAM,QAAQ,GAAG,MAChE,OAAM,KAAK;EACT,MAAMA,OAAK,QAAQ,KAAK,KAAK,CAAC,WAAW,IAAI,GAAG,KAAK,KAAK,QAAQ,KAAK;EACvE,SAAS,YAAY,KAAK;EAC3B,CAAC;AAGJ,QAAO"}

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 };

package/dist/playground/client.d.ts

@@ -45,7 +45,7 @@ interface PlaygroundClientOptions {
     }>;
   }>;
   /**
-   * render the paremeter inputs of API endpoint.
+   * render the parameter inputs of API endpoint.
    *
    * for updating values, use:
    * - the `Custom.useController()` from `fumadocs-openapi/playground/client`.

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,cAoQF,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,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"}

package/dist/playground/client.js

@@ -274,7 +274,10 @@ function useAuthInputs(securities, transform) {
 					password: ""
 				},
 				mapOutput(out) {
-					if (out && typeof out === "object") return `Basic ${btoa(`${"username" in out ? out.username : ""}:${"password" in out ? out.password : ""}`)}`;
+					if (out && typeof out === "object") {
+						const obj = out;
+						return `Basic ${btoa(`${obj.username ?? ""}:${obj.password ?? ""}`)}`;
+					}
 					return out;
 				},
 				children: /* @__PURE__ */ jsx(ObjectInput, {
@@ -283,8 +286,7 @@ function useAuthInputs(securities, transform) {
 						properties: {
 							username: { type: "string" },
 							password: { type: "string" }
-						},
-						required: ["username", "password"]
+						}
 					},
 					fieldName
 				})
@@ -305,7 +307,6 @@ function useAuthInputs(securities, transform) {
 						className: "flex gap-2",
 						children: [/* @__PURE__ */ jsx(FieldInput, {
 							fieldName,
-							isRequired: true,
 							field: { type: "string" },
 							className: "flex-1"
 						}), /* @__PURE__ */ jsx(OauthDialogTrigger, {
@@ -328,7 +329,6 @@ function useAuthInputs(securities, transform) {
 				children: /* @__PURE__ */ jsx(FieldSet, {
 					name: `${t.authorization} (${t.header})`,
 					fieldName,
-					isRequired: true,
 					field: { type: "string" }
 				})
 			});
@@ -341,7 +341,6 @@ function useAuthInputs(securities, transform) {
 				children: /* @__PURE__ */ jsx(FieldSet, {
 					fieldName,
 					name: `${security.name} (${security.in})`,
-					isRequired: true,
 					field: { type: "string" }
 				})
 			});
@@ -353,7 +352,6 @@ function useAuthInputs(securities, transform) {
 				original: security,
 				children: /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(FieldSet, {
 					name: `${t.authorization} (${t.header})`,
-					isRequired: true,
 					fieldName,
 					field: { type: "string" }
 				}), /* @__PURE__ */ jsx("p", {

package/dist/playground/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/playground/client.tsx"],"sourcesContent":["'use client';\nimport {\n  type FC,\n  Fragment,\n  lazy,\n  type ReactNode,\n  useEffect,\n  useMemo,\n  useState,\n  type ComponentProps,\n  useRef,\n} from 'react';\nimport { useApiContext, useServerContext } from '@/ui/contexts/api';\nimport type { FetchResult } from '@/playground/fetcher';\nimport type { SecurityEntry } from '@/playground/index';\nimport { getStatusInfo } from './status-info';\nimport { joinURL, resolveRequestData, resolveServerUrl, withBase } from '@/utils/url';\nimport { MethodLabel } from '@/ui/components/method-label';\nimport { useQuery } from '@/utils/use-query';\nimport {\n  Collapsible,\n  CollapsibleContent,\n  CollapsibleTrigger,\n} from 'fumadocs-ui/components/ui/collapsible';\nimport { ChevronDown, LoaderCircle } from 'lucide-react';\nimport { encodeRequestData } from '@/requests/media/encode';\nimport { buttonVariants } from 'fumadocs-ui/components/ui/button';\nimport { cn } from '@/utils/cn';\nimport { SchemaProvider, SchemaScope, useResolvedSchema } from '@/playground/schema';\nimport {\n  Select,\n  SelectContent,\n  SelectItem,\n  SelectTrigger,\n  SelectValue,\n} from '@/ui/components/select';\nimport { labelVariants } from '@/ui/components/input';\nimport type { ParsedSchema } from '@/utils/schema';\nimport ServerSelect from './components/server-select';\nimport { useStorageKey } from '@/ui/client/storage-key';\nimport { useExampleRequests } from '@/ui/operation/usage-tabs/client';\nimport {\n  FieldKey,\n  Stf,\n  StfProvider,\n  useDataEngine,\n  useFieldValue,\n  useListener,\n  useStf,\n} from '@fumari/stf';\nimport { objectGet, objectSet, stringifyFieldKey } from '@fumari/stf/lib/utils';\nimport { FieldInput, FieldSet, JsonInput, ObjectInput } from './components/inputs';\nimport type { ParameterObject } from '@/types';\nimport { ClientCodeBlock } from '@/ui/components/codeblock';\nimport { useTranslations } from '@/ui/client/i18n';\n\nexport interface FormValues extends Record<string, unknown> {\n  path: Record<string, unknown>;\n  query: Record<string, unknown>;\n  header: Record<string, unknown>;\n  cookie: Record<string, unknown>;\n  body: unknown;\n}\n\nexport interface PlaygroundClientProps extends ComponentProps<'form'>, SchemaScope {\n  route: string;\n  method: string;\n  parameters?: ParameterObject[];\n  securities: SecurityEntry[][];\n  body?: {\n    schema: ParsedSchema;\n    mediaType: string;\n  };\n  /**\n   * Resolver for $ref schemas you've passed\n   */\n  references: Record<string, ParsedSchema>;\n  proxyUrl?: string;\n}\n\nexport interface PlaygroundClientOptions {\n  /**\n   * transform fields for auth-specific parameters (e.g. header)\n   */\n  transformAuthInputs?: (fields: AuthField[]) => AuthField[];\n\n  /**\n   * Request timeout in seconds (default: 10s)\n   */\n  requestTimeout?: number;\n\n  components?: Partial<{\n    ResultDisplay: FC<{ data: FetchResult }>;\n  }>;\n\n  /**\n   * render the paremeter inputs of API endpoint.\n   *\n   * for updating values, use:\n   * - the `Custom.useController()` from `fumadocs-openapi/playground/client`.\n   *\n   * Recommended types packages: `json-schema-typed`, `openapi-types`.\n   */\n  renderParameterField?: (fieldName: FieldKey, param: ParameterObject) => ReactNode;\n\n  /**\n   * render the input for API endpoint body.\n   *\n   * @see renderParameterField for customisation tips\n   */\n  renderBodyField?: (\n    fieldName: 'body',\n    info: {\n      schema: ParsedSchema;\n      mediaType: string;\n    },\n  ) => ReactNode;\n}\n\nconst OauthDialog = lazy(() =>\n  import('./components/oauth-dialog').then((mod) => ({\n    default: mod.OauthDialog,\n  })),\n);\nconst OauthDialogTrigger = lazy(() =>\n  import('./components/oauth-dialog').then((mod) => ({\n    default: mod.OauthDialogTrigger,\n  })),\n);\n\nexport default function PlaygroundClient({\n  route,\n  method = 'GET',\n  securities,\n  parameters = [],\n  body,\n  references,\n  proxyUrl,\n  writeOnly,\n  readOnly,\n  ...rest\n}: PlaygroundClientProps) {\n  const t = useTranslations();\n  const { example: exampleId, examples, setExampleData } = useExampleRequests();\n  const storageKeys = useStorageKey();\n  const {\n    mediaAdapters,\n    client: {\n      playground: {\n        components: { ResultDisplay = DefaultResultDisplay } = {},\n        requestTimeout = 10,\n        transformAuthInputs,\n      } = {},\n    },\n  } = useApiContext();\n  const { serverRef } = useServerContext();\n  const [securityId, setSecurityId] = useState(() => {\n    const idx = securities.findIndex((s) => s.every((entry) => !entry.deprecated));\n    return idx === -1 ? 0 : idx;\n  });\n  const { inputs, mapInputs, initAuthValues } = useAuthInputs(\n    securities[securityId],\n    transformAuthInputs,\n  );\n\n  const defaultValues: FormValues = useMemo(() => {\n    const requestData = examples.find((example) => example.id === exampleId)?.data;\n\n    return {\n      path: requestData?.path ?? {},\n      query: requestData?.query ?? {},\n      header: requestData?.header ?? {},\n      body: requestData?.body ?? {},\n      cookie: requestData?.cookie ?? {},\n    };\n  }, [examples, exampleId]);\n\n  const stf = useStf({\n    // it is fine to modify `defaultValues` in place\n    // because we already try to persist the form values via `setExampleData`.\n    defaultValues,\n  });\n\n  const testQuery = useQuery(async (input: FormValues) => {\n    const targetServer = serverRef.current;\n    const fetcher = await import('./fetcher').then((mod) =>\n      mod.createBrowserFetcher(mediaAdapters, requestTimeout),\n    );\n    const encoded = encodeRequestData(\n      { ...mapInputs(input), method, bodyMediaType: body?.mediaType },\n      mediaAdapters,\n      parameters,\n    );\n    return fetcher.fetch(\n      joinURL(\n        withBase(\n          targetServer ? resolveServerUrl(targetServer.url, targetServer.variables) : '/',\n          window.location.origin,\n        ),\n        resolveRequestData(route, encoded),\n      ),\n      {\n        proxyUrl,\n        ...encoded,\n      },\n    );\n  });\n\n  const timerRef = useRef<number | null>(null);\n  useListener({\n    stf,\n    onUpdate() {\n      if (timerRef.current) window.clearTimeout(timerRef.current);\n      timerRef.current = window.setTimeout(\n        () => {\n          const values = stf.dataEngine.getData() as FormValues;\n          for (const item of inputs) {\n            const value = stf.dataEngine.get(item.fieldName);\n\n            if (value) {\n              localStorage.setItem(storageKeys.AuthField(item), JSON.stringify(value));\n            }\n          }\n\n          const data = {\n            ...mapInputs(values),\n            method,\n            bodyMediaType: body?.mediaType,\n          };\n          setExampleData(data, encodeRequestData(data, mediaAdapters, parameters));\n        },\n        timerRef.current ? 400 : 0,\n      );\n    },\n  });\n\n  useEffect(() => {\n    // same object reference = unchanged\n    if (stf.dataEngine.getData() === defaultValues) return;\n\n    stf.dataEngine.reset(defaultValues);\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- ignore other parts\n  }, [defaultValues]);\n\n  useEffect(() => {\n    return initAuthValues(stf);\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- ignore other parts\n  }, [defaultValues, inputs]);\n\n  return (\n    <StfProvider value={stf}>\n      <SchemaProvider references={references} writeOnly={writeOnly} readOnly={readOnly}>\n        <form\n          {...rest}\n          className={cn(\n            'not-prose flex flex-col rounded-xl border shadow-md overflow-hidden bg-fd-card text-fd-card-foreground',\n            rest.className,\n          )}\n          onSubmit={(e) => {\n            testQuery.start(mapInputs(stf.dataEngine.getData() as FormValues));\n            e.preventDefault();\n          }}\n        >\n          <ServerSelect className=\"border-b\" />\n          <div className=\"flex flex-row items-center gap-2 text-sm p-3 not-last:pb-0\">\n            <MethodLabel>{method}</MethodLabel>\n            <Route route={route} className=\"flex-1\" />\n            <button\n              type=\"submit\"\n              className={cn(buttonVariants({ color: 'primary', size: 'sm' }), 'w-14 py-1.5')}\n              disabled={testQuery.isLoading}\n            >\n              {testQuery.isLoading ? <LoaderCircle className=\"size-4 animate-spin\" /> : t.send}\n            </button>\n          </div>\n          {testQuery.data ? <ResultDisplay data={testQuery.data} reset={testQuery.reset} /> : null}\n\n          {securities.length > 0 && (\n            <SecurityTabs\n              securities={securities}\n              securityId={securityId}\n              setSecurityId={setSecurityId}\n            >\n              {inputs.map((input) => (\n                <Fragment key={stringifyFieldKey(input.fieldName)}>{input.children}</Fragment>\n              ))}\n            </SecurityTabs>\n          )}\n          <FormBody body={body} parameters={parameters} />\n        </form>\n      </SchemaProvider>\n    </StfProvider>\n  );\n}\n\nfunction SecurityTabs({\n  securities,\n  setSecurityId,\n  securityId,\n  children,\n}: {\n  securities: SecurityEntry[][];\n  securityId: number;\n  setSecurityId: (value: number) => void;\n  children: ReactNode;\n}) {\n  const [open, setOpen] = useState(false);\n  const engine = useDataEngine();\n  const t = useTranslations();\n\n  const result = (\n    <CollapsiblePanel title={t.authorization}>\n      <Select value={securityId.toString()} onValueChange={(v) => setSecurityId(Number(v))}>\n        <SelectTrigger>\n          <SelectValue />\n        </SelectTrigger>\n        <SelectContent>\n          {securities.map((security, i) => (\n            <SelectItem key={i} value={i.toString()}>\n              {security.map((item) => (\n                <div key={item.id} className=\"max-w-[600px]\">\n                  <p\n                    className={cn(\n                      'font-mono font-medium',\n                      item.deprecated && 'text-fd-muted-foreground line-through',\n                    )}\n                  >\n                    {item.id}\n                  </p>\n                  <p className=\"text-fd-muted-foreground whitespace-pre-wrap\">{item.description}</p>\n                </div>\n              ))}\n            </SelectItem>\n          ))}\n        </SelectContent>\n      </Select>\n      {children}\n    </CollapsiblePanel>\n  );\n\n  for (let i = 0; i < securities.length; i++) {\n    const security = securities[i];\n\n    for (const item of security) {\n      if (item.type === 'oauth2') {\n        return (\n          <OauthDialog\n            scheme={item}\n            scopes={item.scopes}\n            open={open}\n            setOpen={(v) => {\n              setOpen(v);\n              if (v) {\n                setSecurityId(i);\n              }\n            }}\n            setToken={(token) => engine.update(['header', 'Authorization'], token)}\n          >\n            {result}\n          </OauthDialog>\n        );\n      }\n    }\n  }\n\n  return result;\n}\n\nconst ParamTypes = ['path', 'header', 'cookie', 'query'] as const;\n\nfunction FormBody({ parameters = [], body }: Pick<PlaygroundClientProps, 'parameters' | 'body'>) {\n  const { renderParameterField, renderBodyField } = useApiContext().client.playground ?? {};\n  const t = useTranslations();\n  const panels = useMemo(() => {\n    return ParamTypes.map((type) => {\n      const items = parameters.filter((v) => v.in === type);\n      if (items.length === 0) return;\n\n      return (\n        <CollapsiblePanel\n          key={type}\n          title={\n            {\n              header: t.header,\n              cookie: t.cookies,\n              query: t.query,\n              path: t.path,\n            }[type]\n          }\n        >\n          {items.map((field) => {\n            const fieldName: FieldKey = [type, field.name!];\n            if (renderParameterField) {\n              return renderParameterField(fieldName, field);\n            }\n\n            const contentTypes = field.content && Object.keys(field.content);\n            const schema = (\n              field.content && contentTypes && contentTypes.length > 0\n                ? field.content[contentTypes[0]].schema\n                : field.schema\n            ) as ParsedSchema;\n\n            return (\n              <FieldSet\n                key={stringifyFieldKey(fieldName)}\n                name={field.name}\n                fieldName={fieldName}\n                field={schema}\n                isRequired={field.required}\n              />\n            );\n          })}\n        </CollapsiblePanel>\n      );\n    });\n  }, [parameters, renderParameterField, t]);\n\n  return (\n    <>\n      {panels}\n      {body && (\n        <CollapsiblePanel title={t.body}>\n          {renderBodyField ? renderBodyField('body', body) : <BodyInput field={body.schema} />}\n        </CollapsiblePanel>\n      )}\n    </>\n  );\n}\n\nfunction BodyInput({ field: _field }: { field: ParsedSchema }) {\n  const field = useResolvedSchema(_field);\n  const [isJson, setIsJson] = useState(false);\n  const t = useTranslations();\n\n  if (field.format === 'binary') return <FieldSet field={field} fieldName={['body']} isRequired />;\n\n  if (isJson)\n    return (\n      <>\n        <button\n          className={cn(\n            buttonVariants({\n              color: 'secondary',\n              size: 'sm',\n              className: 'w-fit font-mono p-2',\n            }),\n          )}\n          onClick={() => setIsJson(false)}\n          type=\"button\"\n        >\n          {t.closeJsonEditor}\n        </button>\n        <JsonInput fieldName={['body']} />\n      </>\n    );\n\n  return (\n    <FieldSet\n      field={field}\n      fieldName={['body']}\n      collapsible={false}\n      isRequired\n      name={\n        <button\n          type=\"button\"\n          className={cn(\n            buttonVariants({\n              color: 'secondary',\n              size: 'sm',\n              className: 'p-2',\n            }),\n          )}\n          onClick={() => setIsJson(true)}\n        >\n          {t.openJsonEditor}\n        </button>\n      }\n    />\n  );\n}\n\nexport interface AuthField {\n  fieldName: FieldKey;\n  defaultValue: unknown;\n\n  original?: SecurityEntry;\n  children: ReactNode;\n\n  mapOutput?: (values: unknown) => unknown;\n}\n\nfunction useAuthInputs(\n  securities?: SecurityEntry[],\n  transform?: (fields: AuthField[]) => AuthField[],\n) {\n  const storageKeys = useStorageKey();\n  const t = useTranslations();\n  const inputs = useMemo(() => {\n    const result: AuthField[] = [];\n    if (!securities) return result;\n\n    for (const security of securities) {\n      if (security.type === 'http' && security.scheme === 'basic') {\n        const fieldName: FieldKey = ['header', 'Authorization'];\n\n        result.push({\n          fieldName,\n          original: security,\n          defaultValue: {\n            username: '',\n            password: '',\n          },\n          mapOutput(out) {\n            if (out && typeof out === 'object') {\n              return `Basic ${btoa(`${'username' in out ? out.username : ''}:${'password' in out ? out.password : ''}`)}`;\n            }\n\n            return out;\n          },\n          children: (\n            <ObjectInput\n              field={{\n                type: 'object',\n                properties: {\n                  username: {\n                    type: 'string',\n                  },\n                  password: {\n                    type: 'string',\n                  },\n                },\n                required: ['username', 'password'],\n              }}\n              fieldName={fieldName}\n            />\n          ),\n        });\n      } else if (security.type === 'oauth2') {\n        const fieldName: FieldKey = ['header', 'Authorization'];\n\n        result.push({\n          fieldName,\n          original: security,\n          defaultValue: 'Bearer ',\n          children: (\n            <fieldset className=\"flex flex-col gap-2\">\n              <label htmlFor={stringifyFieldKey(fieldName)} className={cn(labelVariants())}>\n                {t.accessToken}\n              </label>\n              <div className=\"flex gap-2\">\n                <FieldInput\n                  fieldName={fieldName}\n                  isRequired\n                  field={{\n                    type: 'string',\n                  }}\n                  className=\"flex-1\"\n                />\n\n                <OauthDialogTrigger\n                  type=\"button\"\n                  className={cn(\n                    buttonVariants({\n                      size: 'sm',\n                      color: 'secondary',\n                    }),\n                  )}\n                >\n                  {t.authorize}\n                </OauthDialogTrigger>\n              </div>\n            </fieldset>\n          ),\n        });\n      } else if (security.type === 'http') {\n        const fieldName: FieldKey = ['header', 'Authorization'];\n\n        result.push({\n          fieldName,\n          original: security,\n          defaultValue: 'Bearer ',\n          children: (\n            <FieldSet\n              name={`${t.authorization} (${t.header})`}\n              fieldName={fieldName}\n              isRequired\n              field={{\n                type: 'string',\n              }}\n            />\n          ),\n        });\n      } else if (security.type === 'apiKey') {\n        const fieldName: FieldKey = [security.in!, security.name!];\n\n        result.push({\n          fieldName,\n          defaultValue: '',\n          original: security,\n          children: (\n            <FieldSet\n              fieldName={fieldName}\n              name={`${security.name} (${security.in})`}\n              isRequired\n              field={{\n                type: 'string',\n              }}\n            />\n          ),\n        });\n      } else {\n        const fieldName: FieldKey = ['header', 'Authorization'];\n\n        result.push({\n          fieldName,\n          defaultValue: '',\n          original: security,\n          children: (\n            <>\n              <FieldSet\n                name={`${t.authorization} (${t.header})`}\n                isRequired\n                fieldName={fieldName}\n                field={{\n                  type: 'string',\n                }}\n              />\n              <p className=\"text-fd-muted-foreground text-xs\">{t.openIdUnsupported}</p>\n            </>\n          ),\n        });\n      }\n    }\n\n    return transform ? transform(result) : result;\n  }, [securities, transform, t]);\n\n  const mapInputs = (values: FormValues) => {\n    const cloned = structuredClone(values);\n\n    for (const item of inputs) {\n      if (!item.mapOutput) continue;\n      objectSet(cloned, item.fieldName, item.mapOutput(objectGet(cloned, item.fieldName)));\n    }\n\n    return cloned;\n  };\n\n  const initAuthValues = (stf: Stf) => {\n    const { dataEngine } = stf;\n    for (const item of inputs) {\n      const stored = localStorage.getItem(storageKeys.AuthField(item));\n\n      if (stored) {\n        const parsed = JSON.parse(stored);\n        if (typeof parsed === typeof item.defaultValue) {\n          dataEngine.init(item.fieldName, parsed);\n          continue;\n        }\n      }\n\n      dataEngine.init(item.fieldName, item.defaultValue);\n    }\n\n    // reset\n    return () => {\n      for (const item of inputs) {\n        stf.dataEngine.delete(item.fieldName);\n      }\n    };\n  };\n\n  return { inputs, mapInputs, initAuthValues };\n}\n\nfunction Route({ route, ...props }: ComponentProps<'div'> & { route: string }) {\n  return (\n    <div\n      {...props}\n      className={cn(\n        'flex flex-row items-center gap-0.5 overflow-auto text-nowrap',\n        props.className,\n      )}\n    >\n      {route.split('/').map((part, index) => (\n        <Fragment key={index}>\n          {index > 0 && <span className=\"text-fd-muted-foreground\">/</span>}\n          {part.startsWith('{') && part.endsWith('}') ? (\n            <code className=\"bg-fd-primary/10 text-fd-primary\">{part}</code>\n          ) : (\n            <code className=\"text-fd-foreground\">{part}</code>\n          )}\n        </Fragment>\n      ))}\n    </div>\n  );\n}\n\nfunction DefaultResultDisplay({ data, reset }: { data: FetchResult; reset: () => void }) {\n  const t = useTranslations();\n  const statusInfo = useMemo(() => getStatusInfo(data.status, t), [data.status, t]);\n\n  return (\n    <div className=\"flex flex-col gap-3 mt-2 px-3 py-2 border-y bg-fd-secondary text-fd-secondary-foreground\">\n      <div className=\"flex justify-between items-center\">\n        <div className=\"inline-flex items-center gap-1.5 text-sm font-medium\">\n          <statusInfo.icon className={cn('size-4', statusInfo.color)} />\n          {statusInfo.description}\n        </div>\n        <button\n          type=\"button\"\n          className={cn(buttonVariants({ size: 'sm', variant: 'outline' }))}\n          onClick={() => reset()}\n        >\n          {t.close}\n        </button>\n      </div>\n      <p className=\"text-sm text-fd-muted-foreground\">{data.status}</p>\n      {data.data !== undefined && (\n        <ClientCodeBlock\n          lang={typeof data.data === 'string' && data.data.length > 50000 ? 'text' : data.type}\n          code={typeof data.data === 'string' ? data.data : JSON.stringify(data.data, null, 2)}\n        />\n      )}\n    </div>\n  );\n}\n\nfunction CollapsiblePanel({\n  title,\n  children,\n  ...props\n}: Omit<ComponentProps<'div'>, 'title'> & {\n  title: ReactNode;\n}) {\n  return (\n    <Collapsible {...props} className=\"border-b last:border-b-0\">\n      <CollapsibleTrigger className=\"group w-full flex items-center gap-2 p-3 text-sm font-medium\">\n        {title}\n        <ChevronDown className=\"ms-auto size-3.5 text-fd-muted-foreground group-data-[state=open]:rotate-180\" />\n      </CollapsibleTrigger>\n      <CollapsibleContent>\n        <div className=\"flex flex-col gap-3 p-3 pt-1\">{children}</div>\n      </CollapsibleContent>\n    </Collapsible>\n  );\n}\n\nexport const Custom = {\n  useController(\n    fieldName: FieldKey,\n    options?: {\n      defaultValue?: unknown;\n    },\n  ) {\n    const [value, setValue] = useFieldValue(fieldName, options);\n    return {\n      value,\n      setValue,\n    };\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/playground/client.tsx"],"sourcesContent":["'use client';\nimport {\n  type FC,\n  Fragment,\n  lazy,\n  type ReactNode,\n  useEffect,\n  useMemo,\n  useState,\n  type ComponentProps,\n  useRef,\n} from 'react';\nimport { useApiContext, useServerContext } from '@/ui/contexts/api';\nimport type { FetchResult } from '@/playground/fetcher';\nimport type { SecurityEntry } from '@/playground/index';\nimport { getStatusInfo } from './status-info';\nimport { joinURL, resolveRequestData, resolveServerUrl, withBase } from '@/utils/url';\nimport { MethodLabel } from '@/ui/components/method-label';\nimport { useQuery } from '@/utils/use-query';\nimport {\n  Collapsible,\n  CollapsibleContent,\n  CollapsibleTrigger,\n} from 'fumadocs-ui/components/ui/collapsible';\nimport { ChevronDown, LoaderCircle } from 'lucide-react';\nimport { encodeRequestData } from '@/requests/media/encode';\nimport { buttonVariants } from 'fumadocs-ui/components/ui/button';\nimport { cn } from '@/utils/cn';\nimport { SchemaProvider, SchemaScope, useResolvedSchema } from '@/playground/schema';\nimport {\n  Select,\n  SelectContent,\n  SelectItem,\n  SelectTrigger,\n  SelectValue,\n} from '@/ui/components/select';\nimport { labelVariants } from '@/ui/components/input';\nimport type { ParsedSchema } from '@/utils/schema';\nimport ServerSelect from './components/server-select';\nimport { useStorageKey } from '@/ui/client/storage-key';\nimport { useExampleRequests } from '@/ui/operation/usage-tabs/client';\nimport {\n  FieldKey,\n  Stf,\n  StfProvider,\n  useDataEngine,\n  useFieldValue,\n  useListener,\n  useStf,\n} from '@fumari/stf';\nimport { objectGet, objectSet, stringifyFieldKey } from '@fumari/stf/lib/utils';\nimport { FieldInput, FieldSet, JsonInput, ObjectInput } from './components/inputs';\nimport type { ParameterObject } from '@/types';\nimport { ClientCodeBlock } from '@/ui/components/codeblock';\nimport { useTranslations } from '@/ui/client/i18n';\n\nexport interface FormValues extends Record<string, unknown> {\n  path: Record<string, unknown>;\n  query: Record<string, unknown>;\n  header: Record<string, unknown>;\n  cookie: Record<string, unknown>;\n  body: unknown;\n}\n\nexport interface PlaygroundClientProps extends ComponentProps<'form'>, SchemaScope {\n  route: string;\n  method: string;\n  parameters?: ParameterObject[];\n  securities: SecurityEntry[][];\n  body?: {\n    schema: ParsedSchema;\n    mediaType: string;\n  };\n  /**\n   * Resolver for $ref schemas you've passed\n   */\n  references: Record<string, ParsedSchema>;\n  proxyUrl?: string;\n}\n\nexport interface PlaygroundClientOptions {\n  /**\n   * transform fields for auth-specific parameters (e.g. header)\n   */\n  transformAuthInputs?: (fields: AuthField[]) => AuthField[];\n\n  /**\n   * Request timeout in seconds (default: 10s)\n   */\n  requestTimeout?: number;\n\n  components?: Partial<{\n    ResultDisplay: FC<{ data: FetchResult }>;\n  }>;\n\n  /**\n   * render the parameter inputs of API endpoint.\n   *\n   * for updating values, use:\n   * - the `Custom.useController()` from `fumadocs-openapi/playground/client`.\n   *\n   * Recommended types packages: `json-schema-typed`, `openapi-types`.\n   */\n  renderParameterField?: (fieldName: FieldKey, param: ParameterObject) => ReactNode;\n\n  /**\n   * render the input for API endpoint body.\n   *\n   * @see renderParameterField for customisation tips\n   */\n  renderBodyField?: (\n    fieldName: 'body',\n    info: {\n      schema: ParsedSchema;\n      mediaType: string;\n    },\n  ) => ReactNode;\n}\n\nconst OauthDialog = lazy(() =>\n  import('./components/oauth-dialog').then((mod) => ({\n    default: mod.OauthDialog,\n  })),\n);\nconst OauthDialogTrigger = lazy(() =>\n  import('./components/oauth-dialog').then((mod) => ({\n    default: mod.OauthDialogTrigger,\n  })),\n);\n\nexport default function PlaygroundClient({\n  route,\n  method = 'GET',\n  securities,\n  parameters = [],\n  body,\n  references,\n  proxyUrl,\n  writeOnly,\n  readOnly,\n  ...rest\n}: PlaygroundClientProps) {\n  const t = useTranslations();\n  const { example: exampleId, examples, setExampleData } = useExampleRequests();\n  const storageKeys = useStorageKey();\n  const {\n    mediaAdapters,\n    client: {\n      playground: {\n        components: { ResultDisplay = DefaultResultDisplay } = {},\n        requestTimeout = 10,\n        transformAuthInputs,\n      } = {},\n    },\n  } = useApiContext();\n  const { serverRef } = useServerContext();\n  const [securityId, setSecurityId] = useState(() => {\n    const idx = securities.findIndex((s) => s.every((entry) => !entry.deprecated));\n    return idx === -1 ? 0 : idx;\n  });\n  const { inputs, mapInputs, initAuthValues } = useAuthInputs(\n    securities[securityId],\n    transformAuthInputs,\n  );\n\n  const defaultValues: FormValues = useMemo(() => {\n    const requestData = examples.find((example) => example.id === exampleId)?.data;\n\n    return {\n      path: requestData?.path ?? {},\n      query: requestData?.query ?? {},\n      header: requestData?.header ?? {},\n      body: requestData?.body ?? {},\n      cookie: requestData?.cookie ?? {},\n    };\n  }, [examples, exampleId]);\n\n  const stf = useStf({\n    // it is fine to modify `defaultValues` in place\n    // because we already try to persist the form values via `setExampleData`.\n    defaultValues,\n  });\n\n  const testQuery = useQuery(async (input: FormValues) => {\n    const targetServer = serverRef.current;\n    const fetcher = await import('./fetcher').then((mod) =>\n      mod.createBrowserFetcher(mediaAdapters, requestTimeout),\n    );\n    const encoded = encodeRequestData(\n      { ...mapInputs(input), method, bodyMediaType: body?.mediaType },\n      mediaAdapters,\n      parameters,\n    );\n    return fetcher.fetch(\n      joinURL(\n        withBase(\n          targetServer ? resolveServerUrl(targetServer.url, targetServer.variables) : '/',\n          window.location.origin,\n        ),\n        resolveRequestData(route, encoded),\n      ),\n      {\n        proxyUrl,\n        ...encoded,\n      },\n    );\n  });\n\n  const timerRef = useRef<number | null>(null);\n  useListener({\n    stf,\n    onUpdate() {\n      if (timerRef.current) window.clearTimeout(timerRef.current);\n      timerRef.current = window.setTimeout(\n        () => {\n          const values = stf.dataEngine.getData() as FormValues;\n          for (const item of inputs) {\n            const value = stf.dataEngine.get(item.fieldName);\n\n            if (value) {\n              localStorage.setItem(storageKeys.AuthField(item), JSON.stringify(value));\n            }\n          }\n\n          const data = {\n            ...mapInputs(values),\n            method,\n            bodyMediaType: body?.mediaType,\n          };\n          setExampleData(data, encodeRequestData(data, mediaAdapters, parameters));\n        },\n        timerRef.current ? 400 : 0,\n      );\n    },\n  });\n\n  useEffect(() => {\n    // same object reference = unchanged\n    if (stf.dataEngine.getData() === defaultValues) return;\n\n    stf.dataEngine.reset(defaultValues);\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- ignore other parts\n  }, [defaultValues]);\n\n  useEffect(() => {\n    return initAuthValues(stf);\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- ignore other parts\n  }, [defaultValues, inputs]);\n\n  return (\n    <StfProvider value={stf}>\n      <SchemaProvider references={references} writeOnly={writeOnly} readOnly={readOnly}>\n        <form\n          {...rest}\n          className={cn(\n            'not-prose flex flex-col rounded-xl border shadow-md overflow-hidden bg-fd-card text-fd-card-foreground',\n            rest.className,\n          )}\n          onSubmit={(e) => {\n            testQuery.start(mapInputs(stf.dataEngine.getData() as FormValues));\n            e.preventDefault();\n          }}\n        >\n          <ServerSelect className=\"border-b\" />\n          <div className=\"flex flex-row items-center gap-2 text-sm p-3 not-last:pb-0\">\n            <MethodLabel>{method}</MethodLabel>\n            <Route route={route} className=\"flex-1\" />\n            <button\n              type=\"submit\"\n              className={cn(buttonVariants({ color: 'primary', size: 'sm' }), 'w-14 py-1.5')}\n              disabled={testQuery.isLoading}\n            >\n              {testQuery.isLoading ? <LoaderCircle className=\"size-4 animate-spin\" /> : t.send}\n            </button>\n          </div>\n          {testQuery.data ? <ResultDisplay data={testQuery.data} reset={testQuery.reset} /> : null}\n\n          {securities.length > 0 && (\n            <SecurityTabs\n              securities={securities}\n              securityId={securityId}\n              setSecurityId={setSecurityId}\n            >\n              {inputs.map((input) => (\n                <Fragment key={stringifyFieldKey(input.fieldName)}>{input.children}</Fragment>\n              ))}\n            </SecurityTabs>\n          )}\n          <FormBody body={body} parameters={parameters} />\n        </form>\n      </SchemaProvider>\n    </StfProvider>\n  );\n}\n\nfunction SecurityTabs({\n  securities,\n  setSecurityId,\n  securityId,\n  children,\n}: {\n  securities: SecurityEntry[][];\n  securityId: number;\n  setSecurityId: (value: number) => void;\n  children: ReactNode;\n}) {\n  const [open, setOpen] = useState(false);\n  const engine = useDataEngine();\n  const t = useTranslations();\n\n  const result = (\n    <CollapsiblePanel title={t.authorization}>\n      <Select value={securityId.toString()} onValueChange={(v) => setSecurityId(Number(v))}>\n        <SelectTrigger>\n          <SelectValue />\n        </SelectTrigger>\n        <SelectContent>\n          {securities.map((security, i) => (\n            <SelectItem key={i} value={i.toString()}>\n              {security.map((item) => (\n                <div key={item.id} className=\"max-w-[600px]\">\n                  <p\n                    className={cn(\n                      'font-mono font-medium',\n                      item.deprecated && 'text-fd-muted-foreground line-through',\n                    )}\n                  >\n                    {item.id}\n                  </p>\n                  <p className=\"text-fd-muted-foreground whitespace-pre-wrap\">{item.description}</p>\n                </div>\n              ))}\n            </SelectItem>\n          ))}\n        </SelectContent>\n      </Select>\n      {children}\n    </CollapsiblePanel>\n  );\n\n  for (let i = 0; i < securities.length; i++) {\n    const security = securities[i];\n\n    for (const item of security) {\n      if (item.type === 'oauth2') {\n        return (\n          <OauthDialog\n            scheme={item}\n            scopes={item.scopes}\n            open={open}\n            setOpen={(v) => {\n              setOpen(v);\n              if (v) {\n                setSecurityId(i);\n              }\n            }}\n            setToken={(token) => engine.update(['header', 'Authorization'], token)}\n          >\n            {result}\n          </OauthDialog>\n        );\n      }\n    }\n  }\n\n  return result;\n}\n\nconst ParamTypes = ['path', 'header', 'cookie', 'query'] as const;\n\nfunction FormBody({ parameters = [], body }: Pick<PlaygroundClientProps, 'parameters' | 'body'>) {\n  const { renderParameterField, renderBodyField } = useApiContext().client.playground ?? {};\n  const t = useTranslations();\n  const panels = useMemo(() => {\n    return ParamTypes.map((type) => {\n      const items = parameters.filter((v) => v.in === type);\n      if (items.length === 0) return;\n\n      return (\n        <CollapsiblePanel\n          key={type}\n          title={\n            {\n              header: t.header,\n              cookie: t.cookies,\n              query: t.query,\n              path: t.path,\n            }[type]\n          }\n        >\n          {items.map((field) => {\n            const fieldName: FieldKey = [type, field.name!];\n            if (renderParameterField) {\n              return renderParameterField(fieldName, field);\n            }\n\n            const contentTypes = field.content && Object.keys(field.content);\n            const schema = (\n              field.content && contentTypes && contentTypes.length > 0\n                ? field.content[contentTypes[0]].schema\n                : field.schema\n            ) as ParsedSchema;\n\n            return (\n              <FieldSet\n                key={stringifyFieldKey(fieldName)}\n                name={field.name}\n                fieldName={fieldName}\n                field={schema}\n                isRequired={field.required}\n              />\n            );\n          })}\n        </CollapsiblePanel>\n      );\n    });\n  }, [parameters, renderParameterField, t]);\n\n  return (\n    <>\n      {panels}\n      {body && (\n        <CollapsiblePanel title={t.body}>\n          {renderBodyField ? renderBodyField('body', body) : <BodyInput field={body.schema} />}\n        </CollapsiblePanel>\n      )}\n    </>\n  );\n}\n\nfunction BodyInput({ field: _field }: { field: ParsedSchema }) {\n  const field = useResolvedSchema(_field);\n  const [isJson, setIsJson] = useState(false);\n  const t = useTranslations();\n\n  if (field.format === 'binary') return <FieldSet field={field} fieldName={['body']} isRequired />;\n\n  if (isJson)\n    return (\n      <>\n        <button\n          className={cn(\n            buttonVariants({\n              color: 'secondary',\n              size: 'sm',\n              className: 'w-fit font-mono p-2',\n            }),\n          )}\n          onClick={() => setIsJson(false)}\n          type=\"button\"\n        >\n          {t.closeJsonEditor}\n        </button>\n        <JsonInput fieldName={['body']} />\n      </>\n    );\n\n  return (\n    <FieldSet\n      field={field}\n      fieldName={['body']}\n      collapsible={false}\n      isRequired\n      name={\n        <button\n          type=\"button\"\n          className={cn(\n            buttonVariants({\n              color: 'secondary',\n              size: 'sm',\n              className: 'p-2',\n            }),\n          )}\n          onClick={() => setIsJson(true)}\n        >\n          {t.openJsonEditor}\n        </button>\n      }\n    />\n  );\n}\n\nexport interface AuthField {\n  fieldName: FieldKey;\n  defaultValue: unknown;\n\n  original?: SecurityEntry;\n  children: ReactNode;\n\n  mapOutput?: (values: unknown) => unknown;\n}\n\nfunction useAuthInputs(\n  securities?: SecurityEntry[],\n  transform?: (fields: AuthField[]) => AuthField[],\n) {\n  const storageKeys = useStorageKey();\n  const t = useTranslations();\n  const inputs = useMemo(() => {\n    const result: AuthField[] = [];\n    if (!securities) return result;\n\n    for (const security of securities) {\n      if (security.type === 'http' && security.scheme === 'basic') {\n        const fieldName: FieldKey = ['header', 'Authorization'];\n\n        result.push({\n          fieldName,\n          original: security,\n          defaultValue: {\n            username: '',\n            password: '',\n          },\n          mapOutput(out) {\n            if (out && typeof out === 'object') {\n              const obj = out as Record<string, unknown>;\n              return `Basic ${btoa(`${obj.username ?? ''}:${obj.password ?? ''}`)}`;\n            }\n\n            return out;\n          },\n          children: (\n            <ObjectInput\n              field={{\n                type: 'object',\n                properties: {\n                  username: {\n                    type: 'string',\n                  },\n                  password: {\n                    type: 'string',\n                  },\n                },\n              }}\n              fieldName={fieldName}\n            />\n          ),\n        });\n      } else if (security.type === 'oauth2') {\n        const fieldName: FieldKey = ['header', 'Authorization'];\n\n        result.push({\n          fieldName,\n          original: security,\n          defaultValue: 'Bearer ',\n          children: (\n            <fieldset className=\"flex flex-col gap-2\">\n              <label htmlFor={stringifyFieldKey(fieldName)} className={cn(labelVariants())}>\n                {t.accessToken}\n              </label>\n              <div className=\"flex gap-2\">\n                <FieldInput\n                  fieldName={fieldName}\n                  field={{\n                    type: 'string',\n                  }}\n                  className=\"flex-1\"\n                />\n\n                <OauthDialogTrigger\n                  type=\"button\"\n                  className={cn(\n                    buttonVariants({\n                      size: 'sm',\n                      color: 'secondary',\n                    }),\n                  )}\n                >\n                  {t.authorize}\n                </OauthDialogTrigger>\n              </div>\n            </fieldset>\n          ),\n        });\n      } else if (security.type === 'http') {\n        const fieldName: FieldKey = ['header', 'Authorization'];\n\n        result.push({\n          fieldName,\n          original: security,\n          defaultValue: 'Bearer ',\n          children: (\n            <FieldSet\n              name={`${t.authorization} (${t.header})`}\n              fieldName={fieldName}\n              field={{\n                type: 'string',\n              }}\n            />\n          ),\n        });\n      } else if (security.type === 'apiKey') {\n        const fieldName: FieldKey = [security.in!, security.name!];\n\n        result.push({\n          fieldName,\n          defaultValue: '',\n          original: security,\n          children: (\n            <FieldSet\n              fieldName={fieldName}\n              name={`${security.name} (${security.in})`}\n              field={{\n                type: 'string',\n              }}\n            />\n          ),\n        });\n      } else {\n        const fieldName: FieldKey = ['header', 'Authorization'];\n\n        result.push({\n          fieldName,\n          defaultValue: '',\n          original: security,\n          children: (\n            <>\n              <FieldSet\n                name={`${t.authorization} (${t.header})`}\n                fieldName={fieldName}\n                field={{\n                  type: 'string',\n                }}\n              />\n              <p className=\"text-fd-muted-foreground text-xs\">{t.openIdUnsupported}</p>\n            </>\n          ),\n        });\n      }\n    }\n\n    return transform ? transform(result) : result;\n  }, [securities, transform, t]);\n\n  const mapInputs = (values: FormValues) => {\n    const cloned = structuredClone(values);\n\n    for (const item of inputs) {\n      if (!item.mapOutput) continue;\n      objectSet(cloned, item.fieldName, item.mapOutput(objectGet(cloned, item.fieldName)));\n    }\n\n    return cloned;\n  };\n\n  const initAuthValues = (stf: Stf) => {\n    const { dataEngine } = stf;\n    for (const item of inputs) {\n      const stored = localStorage.getItem(storageKeys.AuthField(item));\n\n      if (stored) {\n        const parsed = JSON.parse(stored);\n        if (typeof parsed === typeof item.defaultValue) {\n          dataEngine.init(item.fieldName, parsed);\n          continue;\n        }\n      }\n\n      dataEngine.init(item.fieldName, item.defaultValue);\n    }\n\n    // reset\n    return () => {\n      for (const item of inputs) {\n        stf.dataEngine.delete(item.fieldName);\n      }\n    };\n  };\n\n  return { inputs, mapInputs, initAuthValues };\n}\n\nfunction Route({ route, ...props }: ComponentProps<'div'> & { route: string }) {\n  return (\n    <div\n      {...props}\n      className={cn(\n        'flex flex-row items-center gap-0.5 overflow-auto text-nowrap',\n        props.className,\n      )}\n    >\n      {route.split('/').map((part, index) => (\n        <Fragment key={index}>\n          {index > 0 && <span className=\"text-fd-muted-foreground\">/</span>}\n          {part.startsWith('{') && part.endsWith('}') ? (\n            <code className=\"bg-fd-primary/10 text-fd-primary\">{part}</code>\n          ) : (\n            <code className=\"text-fd-foreground\">{part}</code>\n          )}\n        </Fragment>\n      ))}\n    </div>\n  );\n}\n\nfunction DefaultResultDisplay({ data, reset }: { data: FetchResult; reset: () => void }) {\n  const t = useTranslations();\n  const statusInfo = useMemo(() => getStatusInfo(data.status, t), [data.status, t]);\n\n  return (\n    <div className=\"flex flex-col gap-3 mt-2 px-3 py-2 border-y bg-fd-secondary text-fd-secondary-foreground\">\n      <div className=\"flex justify-between items-center\">\n        <div className=\"inline-flex items-center gap-1.5 text-sm font-medium\">\n          <statusInfo.icon className={cn('size-4', statusInfo.color)} />\n          {statusInfo.description}\n        </div>\n        <button\n          type=\"button\"\n          className={cn(buttonVariants({ size: 'sm', variant: 'outline' }))}\n          onClick={() => reset()}\n        >\n          {t.close}\n        </button>\n      </div>\n      <p className=\"text-sm text-fd-muted-foreground\">{data.status}</p>\n      {data.data !== undefined && (\n        <ClientCodeBlock\n          lang={typeof data.data === 'string' && data.data.length > 50000 ? 'text' : data.type}\n          code={typeof data.data === 'string' ? data.data : JSON.stringify(data.data, null, 2)}\n        />\n      )}\n    </div>\n  );\n}\n\nfunction CollapsiblePanel({\n  title,\n  children,\n  ...props\n}: Omit<ComponentProps<'div'>, 'title'> & {\n  title: ReactNode;\n}) {\n  return (\n    <Collapsible {...props} className=\"border-b last:border-b-0\">\n      <CollapsibleTrigger className=\"group w-full flex items-center gap-2 p-3 text-sm font-medium\">\n        {title}\n        <ChevronDown className=\"ms-auto size-3.5 text-fd-muted-foreground group-data-[state=open]:rotate-180\" />\n      </CollapsibleTrigger>\n      <CollapsibleContent>\n        <div className=\"flex flex-col gap-3 p-3 pt-1\">{children}</div>\n      </CollapsibleContent>\n    </Collapsible>\n  );\n}\n\nexport const Custom = {\n  useController(\n    fieldName: FieldKey,\n    options?: {\n      defaultValue?: unknown;\n    },\n  ) {\n    const [value, setValue] = useFieldValue(fieldName, options);\n    return {\n      value,\n      setValue,\n    };\n  },\n};\n"],"mappings":"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"}

package/dist/playground/schema.d.ts

@@ -1,5 +1,4 @@
 import { ReactNode } from "react";
-import { Ajv2020 } from "ajv/dist/2020";
 import { FieldKey } from "@fumari/stf";
 
 //#region src/playground/schema.d.ts

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/playground/schema.tsx"],"mappings":";;;;;UAciB,WAAA;;;;EAIf,SAAA;;;;EAKA,QAAA;AAAA"}
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/playground/schema.tsx"],"mappings":";;;;UAciB,WAAA;EASP;;;EALR,SAAA;;;;EAKA,QAAA;AAAA"}

package/dist/playground/schema.js

@@ -2,7 +2,7 @@ import { mergeAllOf } from "../utils/merge-schema.js";
 import { schemaToString } from "../utils/schema-to-string.js";
 import { createContext, use, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
-import { Ajv2020 } from "ajv/dist/2020";
+import { Ajv2020 } from "ajv/dist/2020.js";
 import { useDataEngine, useFieldValue, useNamespace } from "@fumari/stf";
 import { stringifyFieldKey } from "@fumari/stf/lib/utils";
 import { sample } from "openapi-sampler";

package/dist/requests/generators/index.d.ts

@@ -46,7 +46,7 @@ interface InlineCodeUsageGenerator<T = unknown> {
    */
   serverContext?: T;
 }
-declare function createCodeUsageGeneratorRegistry(ihherit?: CodeUsageGeneratorRegistry): CodeUsageGeneratorRegistry;
+declare function createCodeUsageGeneratorRegistry(inherit?: CodeUsageGeneratorRegistry): CodeUsageGeneratorRegistry;
 type CodeUsageGeneratorFn<ServerContext = unknown> = (url: string, data: RequestData, context: {
   mediaAdapters: Record<string, MediaAdapter>;
   server: ServerContext;

package/dist/requests/generators/index.js

@@ -1,6 +1,6 @@
 //#region src/requests/generators/index.ts
-function createCodeUsageGeneratorRegistry(ihherit) {
-	const registry = new Map(ihherit?.map());
+function createCodeUsageGeneratorRegistry(inherit) {
+	const registry = new Map(inherit?.map());
 	return {
 		add(id, generator) {
 			registry.set(id, generator);

package/dist/requests/generators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/requests/generators/index.ts"],"sourcesContent":["import type { MediaAdapter } from '../media/adapter';\nimport type { RequestData } from '../types';\n\nexport interface CodeUsageGeneratorRegistry {\n  add: (id: string, generator: CodeUsageGenerator) => void;\n  get: (id: string) => CodeUsageGenerator | undefined;\n  addInline: (generator: InlineCodeUsageGenerator) => void;\n  /**\n   * @returns if the generator is removed\n   */\n  remove: (id: string) => boolean;\n  map: () => Map<string, CodeUsageGenerator>;\n}\n\n/**\n * Generate code example for given programming language\n */\nexport interface CodeUsageGenerator {\n  generate: CodeUsageGeneratorFn;\n  lang: string;\n  label?: string;\n\n  /**\n   * for inline generators passed from server, this stores info available for client (e.g. forwarded from \"use client\").\n   */\n  _client?: {\n    generate: string | CodeUsageGeneratorFn;\n    serverContext?: unknown;\n  };\n}\n\n/**\n * Generate code example for given programming language\n */\nexport interface InlineCodeUsageGenerator<T = unknown> {\n  id?: string;\n  lang: string;\n  label?: string;\n  /**\n   * either:\n   * - code\n   * - a function imported from a file with \"use client\" directive\n   * - false (disabled)\n   */\n  source?: string | CodeUsageGeneratorFn<T> | false;\n\n  /**\n   * Pass extra context to client-side source generator\n   */\n  serverContext?: T;\n}\n\nexport function createCodeUsageGeneratorRegistry(\n  ihherit?: CodeUsageGeneratorRegistry,\n): CodeUsageGeneratorRegistry {\n  const registry = new Map<string, CodeUsageGenerator>(ihherit?.map());\n\n  return {\n    add(id, generator) {\n      registry.set(id, generator);\n    },\n    get(id) {\n      return registry.get(id);\n    },\n    addInline(generator) {\n      const source = generator.source;\n      const id = generator.id ?? generator.lang;\n      if (!source) {\n        this.remove(id);\n        return;\n      }\n\n      registry.set(id, {\n        lang: generator.lang,\n        label: generator.label,\n        generate() {\n          return typeof source === 'string' ? source : '';\n        },\n        _client: {\n          generate: source,\n          serverContext: generator.serverContext,\n        },\n      });\n    },\n    remove(id) {\n      return registry.delete(id);\n    },\n    map() {\n      return registry;\n    },\n  };\n}\n\nexport type CodeUsageGeneratorFn<ServerContext = unknown> = (\n  url: string,\n  data: RequestData,\n  context: {\n    mediaAdapters: Record<string, MediaAdapter>;\n    server: ServerContext;\n  },\n) => string;\n"],"mappings":";AAoDA,SAAgB,iCACd,SAC4B;CAC5B,MAAM,WAAW,IAAI,IAAgC,SAAS,KAAK,CAAC;AAEpE,QAAO;EACL,IAAI,IAAI,WAAW;AACjB,YAAS,IAAI,IAAI,UAAU;;EAE7B,IAAI,IAAI;AACN,UAAO,SAAS,IAAI,GAAG;;EAEzB,UAAU,WAAW;GACnB,MAAM,SAAS,UAAU;GACzB,MAAM,KAAK,UAAU,MAAM,UAAU;AACrC,OAAI,CAAC,QAAQ;AACX,SAAK,OAAO,GAAG;AACf;;AAGF,YAAS,IAAI,IAAI;IACf,MAAM,UAAU;IAChB,OAAO,UAAU;IACjB,WAAW;AACT,YAAO,OAAO,WAAW,WAAW,SAAS;;IAE/C,SAAS;KACP,UAAU;KACV,eAAe,UAAU;KAC1B;IACF,CAAC;;EAEJ,OAAO,IAAI;AACT,UAAO,SAAS,OAAO,GAAG;;EAE5B,MAAM;AACJ,UAAO;;EAEV"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/requests/generators/index.ts"],"sourcesContent":["import type { MediaAdapter } from '../media/adapter';\nimport type { RequestData } from '../types';\n\nexport interface CodeUsageGeneratorRegistry {\n  add: (id: string, generator: CodeUsageGenerator) => void;\n  get: (id: string) => CodeUsageGenerator | undefined;\n  addInline: (generator: InlineCodeUsageGenerator) => void;\n  /**\n   * @returns if the generator is removed\n   */\n  remove: (id: string) => boolean;\n  map: () => Map<string, CodeUsageGenerator>;\n}\n\n/**\n * Generate code example for given programming language\n */\nexport interface CodeUsageGenerator {\n  generate: CodeUsageGeneratorFn;\n  lang: string;\n  label?: string;\n\n  /**\n   * for inline generators passed from server, this stores info available for client (e.g. forwarded from \"use client\").\n   */\n  _client?: {\n    generate: string | CodeUsageGeneratorFn;\n    serverContext?: unknown;\n  };\n}\n\n/**\n * Generate code example for given programming language\n */\nexport interface InlineCodeUsageGenerator<T = unknown> {\n  id?: string;\n  lang: string;\n  label?: string;\n  /**\n   * either:\n   * - code\n   * - a function imported from a file with \"use client\" directive\n   * - false (disabled)\n   */\n  source?: string | CodeUsageGeneratorFn<T> | false;\n\n  /**\n   * Pass extra context to client-side source generator\n   */\n  serverContext?: T;\n}\n\nexport function createCodeUsageGeneratorRegistry(\n  inherit?: CodeUsageGeneratorRegistry,\n): CodeUsageGeneratorRegistry {\n  const registry = new Map<string, CodeUsageGenerator>(inherit?.map());\n\n  return {\n    add(id, generator) {\n      registry.set(id, generator);\n    },\n    get(id) {\n      return registry.get(id);\n    },\n    addInline(generator) {\n      const source = generator.source;\n      const id = generator.id ?? generator.lang;\n      if (!source) {\n        this.remove(id);\n        return;\n      }\n\n      registry.set(id, {\n        lang: generator.lang,\n        label: generator.label,\n        generate() {\n          return typeof source === 'string' ? source : '';\n        },\n        _client: {\n          generate: source,\n          serverContext: generator.serverContext,\n        },\n      });\n    },\n    remove(id) {\n      return registry.delete(id);\n    },\n    map() {\n      return registry;\n    },\n  };\n}\n\nexport type CodeUsageGeneratorFn<ServerContext = unknown> = (\n  url: string,\n  data: RequestData,\n  context: {\n    mediaAdapters: Record<string, MediaAdapter>;\n    server: ServerContext;\n  },\n) => string;\n"],"mappings":";AAoDA,SAAgB,iCACd,SAC4B;CAC5B,MAAM,WAAW,IAAI,IAAgC,SAAS,KAAK,CAAC;AAEpE,QAAO;EACL,IAAI,IAAI,WAAW;AACjB,YAAS,IAAI,IAAI,UAAU;;EAE7B,IAAI,IAAI;AACN,UAAO,SAAS,IAAI,GAAG;;EAEzB,UAAU,WAAW;GACnB,MAAM,SAAS,UAAU;GACzB,MAAM,KAAK,UAAU,MAAM,UAAU;AACrC,OAAI,CAAC,QAAQ;AACX,SAAK,OAAO,GAAG;AACf;;AAGF,YAAS,IAAI,IAAI;IACf,MAAM,UAAU;IAChB,OAAO,UAAU;IACjB,WAAW;AACT,YAAO,OAAO,WAAW,WAAW,SAAS;;IAE/C,SAAS;KACP,UAAU;KACV,eAAe,UAAU;KAC1B;IACF,CAAC;;EAEJ,OAAO,IAAI;AACT,UAAO,SAAS,OAAO,GAAG;;EAE5B,MAAM;AACJ,UAAO;;EAEV"}

package/dist/requests/media/adapter.js

@@ -1,6 +1,6 @@
 import { escapeString, inputToString } from "../string-utils.js";
 import "./resolve-adapter.js";
-import js2xml from "xml-js/lib/js2xml";
+import js2xml from "xml-js/lib/js2xml.js";
 //#region src/requests/media/adapter.ts
 const defaultAdapters = {
 	"application/json": {

package/dist/requests/string-utils.js

@@ -1,4 +1,4 @@
-import js2xml from "xml-js/lib/js2xml";
+import js2xml from "xml-js/lib/js2xml.js";
 //#region src/requests/string-utils.ts
 /**
 * Convert input value to hardcoded string (with quotes)