fumadocs-openapi 10.3.12 → 10.3.13

package/css/generated/shared.css

@@ -7,6 +7,7 @@
 @source inline("-mode");
 @source inline("-ms-2");
 @source inline("-mt-px");
+@source inline("-mx-2");
 @source inline("-translate-x-1/2");
 @source inline("-translate-y-1/2");
 @source inline("@4xl:flex-row");
@@ -134,6 +135,8 @@
 @source inline("cloned");
 @source inline("cn");
 @source inline("code");
+@source inline("codeUsages");
+@source inline("codegen");
 @source inline("codegens");
 @source inline("col-span-full");
 @source inline("collapsible");
@@ -145,6 +148,8 @@
 @source inline("configDefault");
 @source inline("configuration");
 @source inline("const");
+@source inline("container");
+@source inline("containerRef");
 @source inline("content");
 @source inline("contentType");
 @source inline("contentTypes");
@@ -182,6 +187,7 @@
 @source inline("data-[state=open]:rounded-b-none");
 @source inline("data-[state=open]:text-fd-accent-foreground");
 @source inline("data-collapsible");
+@source inline("data-object-search-input");
 @source inline("data-placeholder:text-fd-muted-foreground");
 @source inline("dataEngine");
 @source inline("declare");
@@ -190,7 +196,6 @@
 @source inline("defaultExampleId");
 @source inline("defaultItem");
 @source inline("defaultMdxComponents");
-@source inline("defaultSamples");
 @source inline("defaultValue");
 @source inline("defaultValues");
 @source inline("deferredValue");
@@ -265,6 +270,7 @@
 @source inline("first");
 @source inline("first:border-t-0");
 @source inline("first:rounded-tr-xl");
+@source inline("firstItemRef");
 @source inline("fixed");
 @source inline("flex");
 @source inline("flex-1");
@@ -315,8 +321,10 @@
 @source inline("gap-6");
 @source inline("gap-x-6");
 @source inline("gap-y-4");
+@source inline("gen");
 @source inline("generate");
 @source inline("generateDefault");
+@source inline("generateTypeScriptDefinitions");
 @source inline("generated");
 @source inline("generated/defined");
 @source inline("generator");
@@ -338,6 +346,7 @@
 @source inline("group-focus-visible/accordion:text-fd-primary");
 @source inline("group/accordion");
 @source inline("groupId");
+@source inline("h-8");
 @source inline("h-9");
 @source inline("h-[240px]");
 @source inline("h-px");
@@ -363,7 +372,6 @@
 @source inline("icon-xs");
 @source inline("id");
 @source inline("idToTitle");
-@source inline("ids");
 @source inline("idx");
 @source inline("if");
 @source inline("ignore");
@@ -387,6 +395,7 @@
 @source inline("instead");
 @source inline("integer");
 @source inline("interface");
+@source inline("internal_legacy");
 @source inline("intersection");
 @source inline("is");
 @source inline("isDefined");
@@ -438,6 +447,7 @@
 @source inline("lucide-react");
 @source inline("map");
 @source inline("mapInputs");
+@source inline("matching");
 @source inline("max");
 @source inline("max-age");
 @source inline("max-h-[460px]");
@@ -468,6 +478,7 @@
 @source inline("ms-auto");
 @source inline("mt-10");
 @source inline("mt-2");
+@source inline("mt-4");
 @source inline("multipart/form-data");
 @source inline("multiple");
 @source inline("must");
@@ -499,6 +510,7 @@
 @source inline("oauth2");
 @source inline("obj");
 @source inline("object");
+@source inline("objectSearchOverrides");
 @source inline("of");
 @source inline("off");
 @source inline("omit");
@@ -506,6 +518,7 @@
 @source inline("onClick");
 @source inline("onCopy");
 @source inline("onKeyDown");
+@source inline("onOpenAutoFocus");
 @source inline("onOpenChange");
 @source inline("onSubmit");
 @source inline("onValueChange");
@@ -536,7 +549,6 @@
 @source inline("overflow-hidden");
 @source inline("overrides");
 @source inline("overview");
-@source inline("p-0");
 @source inline("p-1");
 @source inline("p-1.5");
 @source inline("p-2");
@@ -589,7 +601,9 @@
 @source inline("prefix");
 @source inline("preprocessed");
 @source inline("prev");
+@source inline("prevProperties");
 @source inline("prevent");
+@source inline("preventScroll");
 @source inline("primary");
 @source inline("primitive");
 @source inline("processed");
@@ -623,6 +637,7 @@
 @source inline("race");
 @source inline("range");
 @source inline("raw");
+@source inline("rawSearch");
 @source inline("react");
 @source inline("react-hook-form");
 @source inline("react-hooks/exhaustive-deps");
@@ -633,10 +648,13 @@
 @source inline("red");
 @source inline("redirect_uri");
 @source inline("ref");
+@source inline("refCallback");
 @source inline("reference");
 @source inline("references");
 @source inline("refs");
+@source inline("registerDefault");
 @source inline("registered");
+@source inline("registry");
 @source inline("rehype-react");
 @source inline("remark");
 @source inline("remark-rehype");
@@ -662,6 +680,7 @@
 @source inline("renderer");
 @source inline("replace");
 @source inline("represents");
+@source inline("request");
 @source inline("requestBody");
 @source inline("requestData");
 @source inline("requestTimeout");
@@ -695,7 +714,6 @@
 @source inline("same");
 @source inline("sample");
 @source inline("sampleKey");
-@source inline("samples");
 @source inline("satisfies");
 @source inline("schema");
 @source inline("schemaPropKeys");
@@ -728,6 +746,7 @@
 @source inline("server-side");
 @source inline("server-to-server");
 @source inline("server-url");
+@source inline("serverContext");
 @source inline("serverRef");
 @source inline("serverSchema");
 @source inline("servers");
@@ -865,6 +884,7 @@
 @source inline("toolbar");
 @source inline("top-0");
 @source inline("top-1/2");
+@source inline("top-10");
 @source inline("top-2");
 @source inline("tracking-tight");
 @source inline("transform");

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

@@ -0,0 +1,6 @@
+import { CodeUsageGeneratorRegistry } from "./index.js";
+
+//#region src/requests/generators/all.d.ts
+declare function registerDefault(registry: CodeUsageGeneratorRegistry): void;
+//#endregion
+export { registerDefault };

package/dist/requests/generators/all.js

@@ -0,0 +1,19 @@
+import { csharp } from "./csharp.js";
+import { curl } from "./curl.js";
+import { go } from "./go.js";
+import { java } from "./java.js";
+import { javascript } from "./javascript.js";
+import { python } from "./python.js";
+
+//#region src/requests/generators/all.ts
+function registerDefault(registry) {
+	registry.add("curl", curl);
+	registry.add("js", javascript);
+	registry.add("go", go);
+	registry.add("python", python);
+	registry.add("java", java);
+	registry.add("csharp", csharp);
+}
+
+//#endregion
+export { registerDefault };

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

@@ -0,0 +1,6 @@
+import { CodeUsageGenerator } from "./index.js";
+
+//#region src/requests/generators/csharp.d.ts
+declare const csharp: CodeUsageGenerator;
+//#endregion
+export { csharp };

package/dist/requests/generators/csharp.js

@@ -1,41 +1,43 @@
-'use client';
-
 import { resolveMediaAdapter } from "../media/resolve-adapter.js";
 import "../media/adapter.js";
 
 //#region src/requests/generators/csharp.ts
-const generator = (url, data, { mediaAdapters }) => {
-	const s = [];
-	const imports = new Set([
-		"System",
-		"System.Net.Http",
-		"System.Text"
-	]);
-	const headers = { ...data.header };
-	let body;
-	if (data.body && data.bodyMediaType) body = resolveMediaAdapter(data.bodyMediaType, mediaAdapters)?.generateExample(data, {
-		lang: "csharp",
-		addImport(from) {
-			imports.add(from);
+const csharp = {
+	label: "C#",
+	lang: "csharp",
+	generate(url, data, { mediaAdapters }) {
+		const s = [];
+		const imports = new Set([
+			"System",
+			"System.Net.Http",
+			"System.Text"
+		]);
+		const headers = { ...data.header };
+		let body;
+		if (data.body && data.bodyMediaType) body = resolveMediaAdapter(data.bodyMediaType, mediaAdapters)?.generateExample(data, {
+			lang: "csharp",
+			addImport(from) {
+				imports.add(from);
+			}
+		});
+		for (const specifier of imports) s.push(`using ${specifier};`);
+		s.push("");
+		if (body) s.push(body, "");
+		s.push("var client = new HttpClient();");
+		const headerLines = [];
+		function addHeader(key, value) {
+			headerLines.push(`client.DefaultRequestHeaders.Add("${key}", ${JSON.stringify(value)});`);
 		}
-	});
-	for (const specifier of imports) s.push(`using ${specifier};`);
-	s.push("");
-	if (body) s.push(body, "");
-	s.push("var client = new HttpClient();");
-	const headerLines = [];
-	function addHeader(key, value) {
-		headerLines.push(`client.DefaultRequestHeaders.Add("${key}", ${JSON.stringify(value)});`);
+		for (const k in headers) addHeader(k, headers[k].value);
+		if (Object.keys(data.cookie).length > 0) addHeader("cookie", Object.entries(data.cookie).map(([key, param]) => `${key}=${param.value}`).join("; "));
+		s.push(...headerLines);
+		const method = data.method[0].toUpperCase() + data.method.slice(1).toLowerCase() + "Async";
+		if (body) s.push(`var response = await client.${method}("${url}", body);`);
+		else s.push(`var response = await client.${method}("${url}");`);
+		s.push("var responseBody = await response.Content.ReadAsStringAsync();");
+		return s.join("\n");
 	}
-	for (const k in headers) addHeader(k, headers[k].value);
-	if (Object.keys(data.cookie).length > 0) addHeader("cookie", Object.entries(data.cookie).map(([key, param]) => `${key}=${param.value}`).join("; "));
-	s.push(...headerLines);
-	const method = data.method[0].toUpperCase() + data.method.slice(1).toLowerCase() + "Async";
-	if (body) s.push(`var response = await client.${method}("${url}", body);`);
-	else s.push(`var response = await client.${method}("${url}");`);
-	s.push("var responseBody = await response.Content.ReadAsStringAsync();");
-	return s.join("\n");
 };
 
 //#endregion
-export { generator };
+export { csharp };

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

@@ -0,0 +1,6 @@
+import { CodeUsageGenerator } from "./index.js";
+
+//#region src/requests/generators/curl.d.ts
+declare const curl: CodeUsageGenerator;
+//#endregion
+export { curl };

package/dist/requests/generators/curl.js

@@ -1,29 +1,31 @@
-'use client';
-
 import { escapeString, ident, inputToString } from "../string-utils.js";
 
 //#region src/requests/generators/curl.ts
-const generator = (url, data) => {
-	const s = [];
-	s.push(`curl -X ${data.method} "${url}"`);
-	for (const header in data.header) {
-		const value = `${header}: ${data.header[header].value}`;
-		s.push(`-H "${value}"`);
-	}
-	for (const k in data.cookie) {
-		const param = data.cookie[k];
-		s.push(`--cookie ${JSON.stringify(`${k}=${param.value}`)}`);
-	}
-	if (data.body && data.bodyMediaType === "multipart/form-data") {
-		if (typeof data.body !== "object") throw new Error("[CURL] request body must be an object.");
-		for (const [key, value] of Object.entries(data.body)) s.push(`-F ${key}=${JSON.stringify(inputToString(value))}`);
-	} else if (data.body && data.bodyMediaType) {
-		const escaped = escapeString(inputToString(data.body, data.bodyMediaType), "'");
-		s.push(`-H "Content-Type: ${data.bodyMediaType}"`);
-		s.push(`-d ${escaped}`);
+const curl = {
+	label: "cURL",
+	lang: "bash",
+	generate(url, data) {
+		const s = [];
+		s.push(`curl -X ${data.method} "${url}"`);
+		for (const header in data.header) {
+			const value = `${header}: ${data.header[header].value}`;
+			s.push(`-H "${value}"`);
+		}
+		for (const k in data.cookie) {
+			const param = data.cookie[k];
+			s.push(`--cookie ${JSON.stringify(`${k}=${param.value}`)}`);
+		}
+		if (data.body && data.bodyMediaType === "multipart/form-data") {
+			if (typeof data.body !== "object") throw new Error("[CURL] request body must be an object.");
+			for (const [key, value] of Object.entries(data.body)) s.push(`-F ${key}=${JSON.stringify(inputToString(value))}`);
+		} else if (data.body && data.bodyMediaType) {
+			const escaped = escapeString(inputToString(data.body, data.bodyMediaType), "'");
+			s.push(`-H "Content-Type: ${data.bodyMediaType}"`);
+			s.push(`-d ${escaped}`);
+		}
+		return s.flatMap((v, i) => ident(v, i > 0 ? 1 : 0)).join(" \\\n");
 	}
-	return s.flatMap((v, i) => ident(v, i > 0 ? 1 : 0)).join(" \\\n");
 };
 
 //#endregion
-export { generator };
+export { curl };

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

@@ -0,0 +1,6 @@
+import { CodeUsageGenerator } from "./index.js";
+
+//#region src/requests/generators/go.d.ts
+declare const go: CodeUsageGenerator;
+//#endregion
+export { go };

package/dist/requests/generators/go.js

@@ -1,34 +1,35 @@
-'use client';
-
 import { ident } from "../string-utils.js";
 import { resolveMediaAdapter } from "../media/resolve-adapter.js";
 import "../media/adapter.js";
 
 //#region src/requests/generators/go.ts
-const generator = (url, data, { mediaAdapters }) => {
-	const imports = [
-		"fmt",
-		"net/http",
-		"io/ioutil"
-	];
-	const headers = /* @__PURE__ */ new Map();
-	const variables = /* @__PURE__ */ new Map();
-	variables.set("url", JSON.stringify(url));
-	for (const header in data.header) headers.set(header, JSON.stringify(data.header[header].value));
-	const cookies = Object.entries(data.cookie);
-	if (cookies.length > 0) headers.set("Cookie", JSON.stringify(cookies.map(([k, param]) => `${k}=${param.value}`).join("; ")));
-	let body;
-	if (data.body && data.bodyMediaType) {
-		const adapter = resolveMediaAdapter(data.bodyMediaType, mediaAdapters);
-		headers.set("Content-Type", `"${data.bodyMediaType}"`);
-		body = adapter?.generateExample(data, {
-			lang: "go",
-			addImport(from) {
-				imports.push(from);
-			}
-		});
-	}
-	return `package main
+const go = {
+	label: "Go",
+	lang: "go",
+	generate(url, data, { mediaAdapters }) {
+		const imports = [
+			"fmt",
+			"net/http",
+			"io/ioutil"
+		];
+		const headers = /* @__PURE__ */ new Map();
+		const variables = /* @__PURE__ */ new Map();
+		variables.set("url", JSON.stringify(url));
+		for (const header in data.header) headers.set(header, JSON.stringify(data.header[header].value));
+		const cookies = Object.entries(data.cookie);
+		if (cookies.length > 0) headers.set("Cookie", JSON.stringify(cookies.map(([k, param]) => `${k}=${param.value}`).join("; ")));
+		let body;
+		if (data.body && data.bodyMediaType) {
+			const adapter = resolveMediaAdapter(data.bodyMediaType, mediaAdapters);
+			headers.set("Content-Type", `"${data.bodyMediaType}"`);
+			body = adapter?.generateExample(data, {
+				lang: "go",
+				addImport(from) {
+					imports.push(from);
+				}
+			});
+		}
+		return `package main
 
 import (
 ${ident(imports.map((v) => `"${v}"`).join("\n"))}
@@ -46,7 +47,8 @@ ${ident(Array.from(headers.entries()).map(([key, value]) => `req.Header.Add("${k
   fmt.Println(res)
   fmt.Println(string(body))
 }`;
+	}
 };
 
 //#endregion
-export { generator };
+export { go };

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

@@ -0,0 +1,55 @@
+import { MediaAdapter } from "../media/adapter.js";
+import { RequestData } from "../types.js";
+
+//#region src/requests/generators/index.d.ts
+interface CodeUsageGeneratorRegistry {
+  add: (id: string, generator: CodeUsageGenerator) => void;
+  get: (id: string) => CodeUsageGenerator | undefined;
+  addInline: (generator: InlineCodeUsageGenerator) => void;
+  /**
+   * @returns if the generator is removed
+   */
+  remove: (id: string) => boolean;
+  map: () => Map<string, CodeUsageGenerator>;
+}
+/**
+ * Generate code example for given programming language
+ */
+interface CodeUsageGenerator {
+  generate: CodeUsageGeneratorFn;
+  lang: string;
+  label?: string;
+  /**
+   * for inline generators passed from server, this stores info available for client (e.g. forwarded from "use client").
+   */
+  _client?: {
+    generate: string | CodeUsageGeneratorFn;
+    serverContext?: unknown;
+  };
+}
+/**
+ * Generate code example for given programming language
+ */
+interface InlineCodeUsageGenerator<T = unknown> {
+  id?: string;
+  lang: string;
+  label?: string;
+  /**
+   * either:
+   * - code
+   * - a function imported from a file with "use client" directive
+   * - false (disabled)
+   */
+  source?: string | CodeUsageGeneratorFn<T> | false;
+  /**
+   * Pass extra context to client-side source generator
+   */
+  serverContext?: T;
+}
+declare function createCodeUsageGeneratorRegistry(ihherit?: CodeUsageGeneratorRegistry): CodeUsageGeneratorRegistry;
+type CodeUsageGeneratorFn<ServerContext = unknown> = (url: string, data: RequestData, context: {
+  mediaAdapters: Record<string, MediaAdapter>;
+  server: ServerContext;
+}) => string;
+//#endregion
+export { CodeUsageGenerator, CodeUsageGeneratorFn, CodeUsageGeneratorRegistry, InlineCodeUsageGenerator, createCodeUsageGeneratorRegistry };

package/dist/requests/generators/index.js

@@ -1,49 +1,40 @@
-import { generator } from "./curl.js";
-import { generator as generator$1 } from "./javascript.js";
-import { generator as generator$2 } from "./go.js";
-import { generator as generator$3 } from "./python.js";
-import { generator as generator$4 } from "./java.js";
-import { generator as generator$5 } from "./csharp.js";
-
 //#region src/requests/generators/index.ts
-const defaultSamples = [
-	{
-		id: "curl",
-		label: "cURL",
-		source: generator,
-		lang: "bash"
-	},
-	{
-		id: "js",
-		label: "JavaScript",
-		source: generator$1,
-		lang: "js"
-	},
-	{
-		id: "go",
-		label: "Go",
-		source: generator$2,
-		lang: "go"
-	},
-	{
-		id: "python",
-		label: "Python",
-		source: generator$3,
-		lang: "python"
-	},
-	{
-		id: "java",
-		label: "Java",
-		source: generator$4,
-		lang: "java"
-	},
-	{
-		id: "csharp",
-		label: "C#",
-		source: generator$5,
-		lang: "csharp"
-	}
-];
+function createCodeUsageGeneratorRegistry(ihherit) {
+	const registry = new Map(ihherit?.map());
+	return {
+		add(id, generator) {
+			registry.set(id, generator);
+		},
+		get(id) {
+			return registry.get(id);
+		},
+		addInline(generator) {
+			const source = generator.source;
+			const id = generator.id ?? generator.lang;
+			if (!source) {
+				this.remove(id);
+				return;
+			}
+			registry.set(id, {
+				lang: generator.lang,
+				label: generator.label,
+				generate() {
+					return typeof source === "string" ? source : "";
+				},
+				_client: {
+					generate: source,
+					serverContext: generator.serverContext
+				}
+			});
+		},
+		remove(id) {
+			return registry.delete(id);
+		},
+		map() {
+			return registry;
+		}
+	};
+}
 
 //#endregion
-export { defaultSamples };
+export { createCodeUsageGeneratorRegistry };

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

@@ -0,0 +1,6 @@
+import { CodeUsageGenerator } from "./index.js";
+
+//#region src/requests/generators/java.d.ts
+declare const java: CodeUsageGenerator;
+//#endregion
+export { java };