fumadocs-openapi 10.3.12 → 10.3.14

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");
@@ -18,6 +19,7 @@
 @source inline("@default");
 @source inline("@defaultValue");
 @source inline("@deprecated");
+@source inline("@fumari/json-schema-ts");
 @source inline("@fumari/stf");
 @source inline("@md:grid-cols-2");
 @source inline("@param");
@@ -134,10 +136,13 @@
 @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");
 @source inline("color");
+@source inline("compile");
 @source inline("compiler");
 @source inline("components");
 @source inline("conditions");
@@ -145,6 +150,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");
@@ -153,6 +160,7 @@
 @source inline("cookies");
 @source inline("core");
 @source inline("could");
+@source inline("count");
 @source inline("createAutoPreset");
 @source inline("createContext");
 @source inline("createMethod");
@@ -160,7 +168,6 @@
 @source inline("css");
 @source inline("ctx");
 @source inline("current");
-@source inline("currentId");
 @source inline("currentRef");
 @source inline("currentValue");
 @source inline("customisation");
@@ -182,6 +189,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 +198,6 @@
 @source inline("defaultExampleId");
 @source inline("defaultItem");
 @source inline("defaultMdxComponents");
-@source inline("defaultSamples");
 @source inline("defaultValue");
 @source inline("defaultValues");
 @source inline("deferredValue");
@@ -265,6 +272,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,16 +323,18 @@
 @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");
 @source inline("generators");
 @source inline("getAPIPageProps");
 @source inline("getSchema");
+@source inline("getSchemaId");
 @source inline("getStatusInfo");
-@source inline("getTypescriptSchema");
 @source inline("ghost");
 @source inline("github-slugger");
 @source inline("given");
@@ -338,6 +348,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 +374,6 @@
 @source inline("icon-xs");
 @source inline("id");
 @source inline("idToTitle");
-@source inline("ids");
 @source inline("idx");
 @source inline("if");
 @source inline("ignore");
@@ -387,7 +397,9 @@
 @source inline("instead");
 @source inline("integer");
 @source inline("interface");
+@source inline("internal_legacy");
 @source inline("intersection");
+@source inline("invalid");
 @source inline("is");
 @source inline("isDefined");
 @source inline("isDuplicated");
@@ -438,6 +450,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 +481,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");
@@ -487,7 +501,6 @@
 @source inline("new");
 @source inline("newKey");
 @source inline("next-themes");
-@source inline("nextId");
 @source inline("no-cache");
 @source inline("node");
 @source inline("not");
@@ -499,6 +512,7 @@
 @source inline("oauth2");
 @source inline("obj");
 @source inline("object");
+@source inline("objectSearchOverrides");
 @source inline("of");
 @source inline("off");
 @source inline("omit");
@@ -506,6 +520,7 @@
 @source inline("onClick");
 @source inline("onCopy");
 @source inline("onKeyDown");
+@source inline("onOpenAutoFocus");
 @source inline("onOpenChange");
 @source inline("onSubmit");
 @source inline("onValueChange");
@@ -536,7 +551,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");
@@ -569,6 +583,7 @@
 @source inline("paths");
 @source inline("pattern");
 @source inline("patternProperties");
+@source inline("pb-0");
 @source inline("pb-2");
 @source inline("pe-2");
 @source inline("peer-disabled:cursor-not-allowed");
@@ -589,7 +604,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");
@@ -620,9 +637,11 @@
 @source inline("py-4");
 @source inline("query");
 @source inline("quiet");
+@source inline("r");
 @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,15 +652,19 @@
 @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");
 @source inline("remarkGfm");
 @source inline("remarkRehype");
+@source inline("remove");
 @source inline("removeItem");
 @source inline("removeListener");
 @source inline("render");
@@ -662,6 +685,7 @@
 @source inline("renderer");
 @source inline("replace");
 @source inline("represents");
+@source inline("request");
 @source inline("requestBody");
 @source inline("requestData");
 @source inline("requestTimeout");
@@ -695,7 +719,6 @@
 @source inline("same");
 @source inline("sample");
 @source inline("sampleKey");
-@source inline("samples");
 @source inline("satisfies");
 @source inline("schema");
 @source inline("schemaPropKeys");
@@ -728,6 +751,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");
@@ -816,6 +840,7 @@
 @source inline("tab");
 @source inline("tabs");
 @source inline("tag");
+@source inline("takenIds");
 @source inline("targetServer");
 @source inline("testQuery");
 @source inline("text");
@@ -865,6 +890,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");
@@ -882,6 +908,7 @@
 @source inline("typeVariants");
 @source inline("typeof");
 @source inline("types");
+@source inline("typescript");
 @source inline("unchanged");
 @source inline("undefined");
 @source inline("under");

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,5 @@
+//#region \0rolldown/runtime.js
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+
+//#endregion
+export { __commonJSMin };

package/dist/node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/dereference.js

@@ -0,0 +1,42 @@
+import { __commonJSMin } from "../../../../../_virtual/_rolldown/runtime.js";
+import { require_klona } from "./klona.js";
+import { require_resolveRef } from "./resolveRef.js";
+
+//#region ../../node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/dereference.js
+var require_dereference = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	Object.defineProperty(exports, "dereferenceSync", {
+		enumerable: true,
+		get: function() {
+			return dereferenceSync;
+		}
+	});
+	var _klona = require_klona();
+	var _resolveRef = require_resolveRef();
+	var cache = /* @__PURE__ */ new Map();
+	var dereferenceSync = function(schema) {
+		if (cache.has(schema)) return cache.get(schema);
+		var visitedNodes = /* @__PURE__ */ new Set();
+		var cloned = (0, _klona.klona)(schema);
+		var resolve = function(current, path) {
+			if (typeof current === "object" && current !== null) {
+				if (visitedNodes.has(current)) return current;
+				visitedNodes.add(current);
+				if (Array.isArray(current)) for (var index = 0; index < current.length; index++) current[index] = resolve(current[index], "".concat(path, "/").concat(index));
+				else {
+					if ("$ref" in current && typeof current["$ref"] === "string") return (0, _resolveRef.resolveRefSync)(cloned, current["$ref"]);
+					for (var key in current) current[key] = resolve(current[key], "".concat(path, "/").concat(key));
+				}
+			}
+			return current;
+		};
+		var result = resolve(cloned, "#");
+		cache.set(schema, result);
+		return result;
+	};
+}));
+
+//#endregion
+export default require_dereference();
+
+export { require_dereference };

package/dist/node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/index.js

@@ -0,0 +1,28 @@
+import { __commonJSMin } from "../../../../../_virtual/_rolldown/runtime.js";
+import { require_types } from "./types.js";
+import { require_resolveRef } from "./resolveRef.js";
+import { require_dereference } from "./dereference.js";
+
+//#region ../../node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/index.js
+var require_dereference_json_schema = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	_exportStar(require_types(), exports);
+	_exportStar(require_dereference(), exports);
+	_exportStar(require_resolveRef(), exports);
+	function _exportStar(from, to) {
+		Object.keys(from).forEach(function(k) {
+			if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) Object.defineProperty(to, k, {
+				enumerable: true,
+				get: function() {
+					return from[k];
+				}
+			});
+		});
+		return from;
+	}
+}));
+
+//#endregion
+export default require_dereference_json_schema();
+
+export { require_dereference_json_schema };

package/dist/node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/klona.js

@@ -0,0 +1,41 @@
+import { __commonJSMin } from "../../../../../_virtual/_rolldown/runtime.js";
+
+//#region ../../node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/klona.js
+/**
+* klona/json - MIT License
+*
+* https://github.com/lukeed/klona/blob/master/license
+*/ var require_klona = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	Object.defineProperty(exports, "klona", {
+		enumerable: true,
+		get: function() {
+			return klona;
+		}
+	});
+	function klona(val) {
+		var index, out, tmp;
+		if (Array.isArray(val)) {
+			out = Array(index = val.length);
+			while (index--) out[index] = (tmp = val[index]) && typeof tmp === "object" ? klona(tmp) : tmp;
+			return out;
+		}
+		if (Object.prototype.toString.call(val) === "[object Object]") {
+			out = {};
+			for (index in val) if (index === "__proto__") Object.defineProperty(out, index, {
+				value: klona(val[index]),
+				configurable: true,
+				enumerable: true,
+				writable: true
+			});
+			else out[index] = (tmp = val[index]) && typeof tmp === "object" ? klona(tmp) : tmp;
+			return out;
+		}
+		return val;
+	}
+}));
+
+//#endregion
+export default require_klona();
+
+export { require_klona };

package/dist/node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/resolveRef.js

@@ -0,0 +1,45 @@
+import { __commonJSMin } from "../../../../../_virtual/_rolldown/runtime.js";
+
+//#region ../../node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/resolveRef.js
+var require_resolveRef = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	Object.defineProperty(exports, "resolveRefSync", {
+		enumerable: true,
+		get: function() {
+			return resolveRefSync;
+		}
+	});
+	var cache = /* @__PURE__ */ new Map();
+	var resolveRefSync = function(schema, ref) {
+		if (!cache.has(schema)) cache.set(schema, /* @__PURE__ */ new Map());
+		var schemaCache = cache.get(schema);
+		if (schemaCache.has(ref)) return schemaCache.get(ref);
+		var path = ref.split("/").slice(1);
+		var current = schema;
+		var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = void 0;
+		try {
+			for (var _iterator = path[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+				var segment = _step.value;
+				if (!current || typeof current !== "object") current = null;
+				var _current_segment;
+				current = (_current_segment = current[segment]) !== null && _current_segment !== void 0 ? _current_segment : null;
+			}
+		} catch (err) {
+			_didIteratorError = true;
+			_iteratorError = err;
+		} finally {
+			try {
+				if (!_iteratorNormalCompletion && _iterator.return != null) _iterator.return();
+			} finally {
+				if (_didIteratorError) throw _iteratorError;
+			}
+		}
+		schemaCache.set(ref, current);
+		return current;
+	};
+}));
+
+//#endregion
+export default require_resolveRef();
+
+export { require_resolveRef };

package/dist/node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/types.js

@@ -0,0 +1,11 @@
+import { __commonJSMin } from "../../../../../_virtual/_rolldown/runtime.js";
+
+//#region ../../node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/types.js
+var require_types = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+}));
+
+//#endregion
+export default require_types();
+
+export { require_types };

package/dist/playground/index.js

@@ -9,13 +9,20 @@ async function APIPlayground({ path, method, ctx }) {
 		method,
 		ctx
 	});
-	let currentId = 0;
 	const bodyContent = method.requestBody?.content;
 	const mediaType = bodyContent ? getPreferredType(bodyContent) : void 0;
+	const takenIds = /* @__PURE__ */ new Map();
 	const context = {
 		references: {},
-		nextId() {
-			return String(currentId++);
+		id(schema) {
+			let name = "r";
+			if (schema) {
+				const ref = ctx.schema.getRawRef(schema)?.split("/");
+				if (ref && ref.length > 0) name = ref[ref.length - 1];
+			}
+			const count = takenIds.get(name) ?? 0;
+			takenIds.set(name, count + 1);
+			return count === 0 ? name : `${name}${count}`;
 		},
 		registered: /* @__PURE__ */ new WeakMap()
 	};
@@ -38,7 +45,7 @@ function writeReferences(schema, ctx, stack = /* @__PURE__ */ new WeakMap()) {
 	if (typeof schema !== "object" || !schema) return schema;
 	if (stack.has(schema)) {
 		const out = stack.get(schema);
-		const id = ctx.nextId();
+		const id = ctx.id(schema);
 		ctx.references[id] = out;
 		return { $ref: `#/${id}` };
 	}

package/dist/playground/schema.js

@@ -24,9 +24,8 @@ function SchemaProvider({ references, readOnly, writeOnly, children }) {
 	const ajv = useMemo(() => new Ajv2020({
 		strict: false,
 		validateSchema: false,
-		validateFormats: false,
-		schemas: references
-	}), [references]);
+		validateFormats: false
+	}), []);
 	return /* @__PURE__ */ jsx(SchemaContext.Provider, {
 		value: useMemo(() => ({
 			references,
@@ -53,7 +52,7 @@ function useSchemaScope() {
 * @param depth - The depth to avoid duplicated field name with same schema (e.g. nested `oneOf`).
 */
 function useFieldInfo(fieldName, schema, depth = 0) {
-	const { ajv } = use(SchemaContext);
+	const { ajv, references } = use(SchemaContext);
 	const engine = useDataEngine();
 	const { generateDefault } = useSchemaUtils();
 	const [info, setInfo] = useFieldValue([], { stf: useNamespace({
@@ -64,7 +63,10 @@ function useFieldInfo(fieldName, schema, depth = 0) {
 			const union = getUnion(schema);
 			if (union) {
 				const [members, field] = union;
-				out.oneOf = members.findIndex((item) => ajv.validate(item, value));
+				out.oneOf = members.findIndex((item) => ajv.validate(typeof item === "object" ? {
+					...item,
+					...references
+				} : item, value));
 				if (out.oneOf === -1) out.oneOf = 0;
 				out.unionField = field;
 			}
@@ -73,12 +75,15 @@ function useFieldInfo(fieldName, schema, depth = 0) {
 				out.selectedType = types.find((type) => {
 					return ajv.validate({
 						...schema,
+						...references,
 						type
 					}, value);
 				}) ?? types[0];
 			}
 			if (schema.allOf) {
-				const merged = mergeAllOf(schema);
+				const merged = mergeAllOf(schema, { dereference(schema) {
+					return dereference(schema, references);
+				} });
 				if (typeof merged !== "boolean") out.intersection = { merged };
 			}
 			return out;
@@ -97,7 +102,8 @@ function useFieldInfo(fieldName, schema, depth = 0) {
 			if (updated.unionField) valueSchema = schema[updated.unionField][updated.oneOf];
 			else if (updated.selectedType) valueSchema = {
 				...schema,
-				type: updated.selectedType
+				type: updated.selectedType,
+				examples: void 0
 			};
 			engine.update(fieldName, generateDefault(valueSchema));
 		}
@@ -105,15 +111,6 @@ function useFieldInfo(fieldName, schema, depth = 0) {
 }
 function useSchemaUtils() {
 	const { references } = use(SchemaContext);
-	function resolve(schema) {
-		if (typeof schema === "boolean") return anyFields;
-		let ref = schema.$ref;
-		if (ref) {
-			if (ref.startsWith("#/")) ref = ref.slice(2);
-			if (ref in references) return fallbackAny(references[ref]);
-		}
-		return schema;
-	}
 	return {
 		generateDefault(schema) {
 			return sample(schema, {
@@ -122,15 +119,26 @@ function useSchemaUtils() {
 				quiet: true
 			}, references);
 		},
-		resolve,
+		resolve(schema) {
+			return fallbackAny(dereference(schema, references));
+		},
 		schemaToString(value, flags) {
 			return schemaToString(value, (s) => ({
-				dereferenced: resolve(s),
+				dereferenced: dereference(s, references),
 				raw: s
 			}), flags);
 		}
 	};
 }
+function dereference(schema, references) {
+	if (typeof schema === "boolean") return schema;
+	let ref = schema.$ref;
+	if (ref) {
+		if (ref.startsWith("#/")) ref = ref.slice(2);
+		if (ref in references) return references[ref];
+	}
+	return schema;
+}
 function fallbackAny(schema) {
 	return typeof schema === "boolean" ? anyFields : schema;
 }

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