fumadocs-openapi 10.3.13 → 10.3.14

package/css/generated/shared.css

@@ -19,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");
@@ -141,6 +142,7 @@
 @source inline("col-span-full");
 @source inline("collapsible");
 @source inline("color");
+@source inline("compile");
 @source inline("compiler");
 @source inline("components");
 @source inline("conditions");
@@ -158,6 +160,7 @@
 @source inline("cookies");
 @source inline("core");
 @source inline("could");
+@source inline("count");
 @source inline("createAutoPreset");
 @source inline("createContext");
 @source inline("createMethod");
@@ -165,7 +168,6 @@
 @source inline("css");
 @source inline("ctx");
 @source inline("current");
-@source inline("currentId");
 @source inline("currentRef");
 @source inline("currentValue");
 @source inline("customisation");
@@ -331,8 +333,8 @@
 @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");
@@ -397,6 +399,7 @@
 @source inline("interface");
 @source inline("internal_legacy");
 @source inline("intersection");
+@source inline("invalid");
 @source inline("is");
 @source inline("isDefined");
 @source inline("isDuplicated");
@@ -498,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");
@@ -581,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");
@@ -634,6 +637,7 @@
 @source inline("py-4");
 @source inline("query");
 @source inline("quiet");
+@source inline("r");
 @source inline("race");
 @source inline("range");
 @source inline("raw");
@@ -660,6 +664,7 @@
 @source inline("remark-rehype");
 @source inline("remarkGfm");
 @source inline("remarkRehype");
+@source inline("remove");
 @source inline("removeItem");
 @source inline("removeListener");
 @source inline("render");
@@ -835,6 +840,7 @@
 @source inline("tab");
 @source inline("tabs");
 @source inline("tag");
+@source inline("takenIds");
 @source inline("targetServer");
 @source inline("testQuery");
 @source inline("text");
@@ -902,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/ui/base.d.ts

@@ -15,6 +15,16 @@ import { ResolvedShikiConfig } from "fumadocs-core/highlight/config";
 import { JSONSchema } from "json-schema-typed";
 
 //#region src/ui/base.d.ts
+interface GenerateTypeScriptDefinitionsContext extends RenderContext {
+  operation: NoReference<MethodInformation>;
+  readOnly: boolean;
+  writeOnly: boolean;
+  /** @deprecated */
+  _internal_legacy?: {
+    statusCode: string;
+    contentType: string;
+  };
+}
 interface CreateAPIPageOptions {
   /**
    * Generate TypeScript definitions from response schema.
@@ -31,13 +41,7 @@ interface CreateAPIPageOptions {
    *
    * Pass `false` to disable it.
    */
-  generateTypeScriptDefinitions?: (schema: JSONSchema, ctx: RenderContext & {
-    operation: NoReference<MethodInformation>; /** @deprecated */
-    _internal_legacy?: {
-      statusCode: string;
-      contentType: string;
-    };
-  }) => Awaitable<string | undefined>;
+  generateTypeScriptDefinitions?: (schema: JSONSchema, ctx: GenerateTypeScriptDefinitionsContext) => Awaitable<string | undefined>;
   /**
    * Generate example code usage for endpoints.
    */
@@ -145,4 +149,4 @@ interface CreateAPIPageOptions {
 }
 declare function createAPIPage(server: OpenAPIServer, options: CreateAPIPageOptions): FC<ApiPageProps>;
 //#endregion
-export { CreateAPIPageOptions, createAPIPage };
+export { CreateAPIPageOptions, GenerateTypeScriptDefinitionsContext, createAPIPage };

package/dist/ui/full.js

@@ -1,5 +1,4 @@
 import { createAPIPage as createAPIPage$1 } from "./base.js";
-import { getTypescriptSchema } from "../utils/get-typescript-schema.js";
 import { ShikiConfigProvider } from "./full.client.js";
 import { jsx } from "react/jsx-runtime";
 import { configDefault } from "fumadocs-core/highlight";
@@ -7,12 +6,22 @@ import { configDefault } from "fumadocs-core/highlight";
 //#region src/ui/full.tsx
 function createAPIPage(server, options = {}) {
 	const APIPage = createAPIPage$1(server, {
-		...options,
 		shiki: configDefault,
-		generateTypeScriptDefinitions(schema, ctx) {
+		async generateTypeScriptDefinitions(schema, ctx) {
 			if (typeof schema !== "object") return;
-			return getTypescriptSchema(schema, ctx);
-		}
+			const { compile } = await import("@fumari/json-schema-ts");
+			try {
+				return compile(schema, {
+					name: "Response",
+					readOnly: ctx.readOnly,
+					writeOnly: ctx.writeOnly,
+					getSchemaId: ctx.schema.getRawRef
+				});
+			} catch (e) {
+				console.warn("Failed to generate typescript schema:", e);
+			}
+		},
+		...options
 	});
 	return function APIPageFull(props) {
 		return /* @__PURE__ */ jsx(ShikiConfigProvider, { children: /* @__PURE__ */ jsx(APIPage, { ...props }) });

package/dist/ui/operation/index.js

@@ -63,6 +63,8 @@ async function Operation({ type = "operation", path, method, ctx, showTitle, sho
 					if (!isMediaTypeSupported(type, ctx.mediaAdapters)) throw new Error(`Media type ${type} is not supported (in ${path})`);
 					const ts = content.schema ? await ctx.generateTypeScriptDefinitions(content.schema, {
 						operation: method,
+						readOnly: false,
+						writeOnly: true,
 						...ctx
 					}) : void 0;
 					return /* @__PURE__ */ jsxs(SelectTab, {
@@ -328,6 +330,8 @@ async function ResponseAccordion({ status, operation, ctx }) {
 			}), contentTypes.map(async ([type, resType]) => {
 				const schema = resType.schema;
 				const ts = schema ? await ctx.generateTypeScriptDefinitions(schema, {
+					readOnly: true,
+					writeOnly: false,
 					operation,
 					_internal_legacy: {
 						statusCode: status,

package/dist/ui/schema/client.js

@@ -46,7 +46,7 @@ function SchemaUIProperty({ name, $type, variant = "default", overrides, objectS
 			}, item.$type)) }), schema.items.map((item) => /* @__PURE__ */ jsx(TabsContent, {
 				value: item.$type,
 				forceMount: void 0,
-				className: "py-0",
+				className: "pt-2 pb-0",
 				children: /* @__PURE__ */ jsx(SchemaUIProperty, {
 					...item,
 					variant: "expand"

package/dist/utils/merge-schema.js

@@ -4,16 +4,19 @@ import { deepEqual } from "./deep-equal.js";
 /**
 * Merge `allOf` object schema
 */
-function mergeAllOf(schema) {
+function mergeAllOf(schema, options = {}) {
+	if (typeof schema === "boolean") return schema;
+	const { dereference } = options;
+	if (dereference && "$ref" in schema && typeof schema.$ref === "string") schema = dereference(schema) ?? schema;
 	if (typeof schema === "boolean" || !schema.allOf) return schema;
 	const { allOf, ...rest } = schema;
 	let result = rest;
-	for (const item of allOf) result = intersection(result, item);
+	for (const item of allOf) result = intersection(result, item, options);
 	return result;
 }
-function intersection(a, b) {
-	a = mergeAllOf(a);
-	b = mergeAllOf(b);
+function intersection(a, b, options) {
+	a = mergeAllOf(a, options);
+	b = mergeAllOf(b, options);
 	if (typeof a === "boolean" && typeof b === "boolean") return a && b;
 	if (typeof a === "boolean") return a;
 	if (typeof b === "boolean") return b;
@@ -98,7 +101,7 @@ function intersection(a, b) {
 					const bProp = value[prop];
 					if (aProp === void 0) out[prop] = bProp;
 					else if (bProp === void 0) out[prop] = aProp;
-					else out[prop] = intersection(aProp, bProp);
+					else out[prop] = intersection(aProp, bProp, options);
 				}
 				result[key] = out;
 				break;
@@ -108,7 +111,7 @@ function intersection(a, b) {
 			case "items": {
 				const value = b[key];
 				if (value === void 0) break;
-				result[key] = result[key] === void 0 ? value : intersection(result[key], value);
+				result[key] = result[key] === void 0 ? value : intersection(result[key], value, options);
 				break;
 			}
 			case "not": {

package/dist/utils/process-document.d.ts

@@ -7,7 +7,6 @@ interface ProcessedDocument {
    * dereferenced document
    */
   dereferenced: NoReference<Document>;
-  _internal_idToSchema: () => Map<string, object>;
   /**
    * Get raw object from dereferenced object
    */

package/dist/utils/process-document.js

@@ -1,14 +1,15 @@
-import { dereference } from "@scalar/openapi-parser";
+import { require_dereference_json_schema } from "../node_modules/.pnpm/dereference-json-schema@0.2.1/node_modules/dereference-json-schema/index.js";
 import { bundle } from "@scalar/json-magic/bundle";
 import { upgrade } from "@scalar/openapi-upgrader";
 import { fetchUrls, readFiles } from "@scalar/json-magic/bundle/plugins/node";
 
 //#region src/utils/process-document.ts
+var import_dereference_json_schema = require_dereference_json_schema();
 /**
 * process & reference input document to a Fumadocs OpenAPI compatible format
 */
 async function processDocument(input) {
-	const document = await bundle(input, {
+	const bundled = await bundle(input, {
 		plugins: [fetchUrls(), readFiles()],
 		treeShake: true,
 		hooks: { onResolveError(node) {
@@ -21,24 +22,43 @@ async function processDocument(input) {
 	* Dereferenced value and its original `$ref` value
 	*/
 	const dereferenceMap = /* @__PURE__ */ new WeakMap();
-	const serializable = /* @__PURE__ */ new Map();
 	return {
-		dereferenced: dereference(document, {
-			throwOnError: true,
-			onDereference({ schema, ref }) {
-				serializable.set(ref, schema);
-				dereferenceMap.set(schema, ref);
-			}
-		}).schema,
+		dereferenced: dereferenceSync(bundled, (ref, schema) => {
+			dereferenceMap.set(schema, ref);
+		}),
 		getRawRef(obj) {
 			return dereferenceMap.get(obj);
 		},
-		_internal_idToSchema() {
-			return serializable;
-		},
-		bundled: document
+		bundled
 	};
 }
+/**
+* Resolves all $ref pointers in a schema and returns a new schema without any $ref pointers.
+*/
+function dereferenceSync(schema, onDereference) {
+	if (typeof schema === "boolean") return schema;
+	const visitedNodes = /* @__PURE__ */ new Set();
+	const cloned = structuredClone(schema);
+	function resolve(current, path) {
+		if (typeof current === "object" && current !== null) {
+			if (visitedNodes.has(current)) return current;
+			visitedNodes.add(current);
+			if (Array.isArray(current)) for (let index = 0; index < current.length; index++) current[index] = resolve(current[index], `${path}/${index}`);
+			else {
+				if ("$ref" in current && typeof current["$ref"] === "string") {
+					const ref = current["$ref"];
+					const out = (0, import_dereference_json_schema.resolveRefSync)(cloned, ref);
+					onDereference(ref, out);
+					return out;
+				}
+				const obj = current;
+				for (const key in current) obj[key] = resolve(obj[key], `${path}/${key}`);
+			}
+		}
+		return current;
+	}
+	return resolve(cloned, "#");
+}
 
 //#endregion
 export { processDocument };

package/dist/utils/schema-to-string.js

@@ -6,7 +6,7 @@ let FormatFlags = /* @__PURE__ */ function(FormatFlags) {
 }({});
 function schemaToString(value, _resolver, flags = FormatFlags.None) {
 	const resolver = typeof _resolver === "function" ? _resolver : (schema) => {
-		const ref = _resolver?.getRawRef(schema);
+		const ref = _resolver && typeof schema === "object" ? _resolver.getRawRef(schema) : void 0;
 		return {
 			dereferenced: schema,
 			raw: ref ? { $ref: ref } : void 0
@@ -30,8 +30,10 @@ function schemaToString(value, _resolver, flags = FormatFlags.None) {
 		else if (schema === false) return "never";
 		if ((flags & FormatFlags.UseAlias) === FormatFlags.UseAlias) {
 			if (schema.title) return schema.title;
-			const ref = resolved.raw?.$ref?.split("/");
-			if (ref && ref.length > 0) return ref[ref.length - 1];
+			if (typeof resolved.raw === "object" && resolved.raw.$ref) {
+				const ref = resolved.raw.$ref.split("/");
+				if (ref.length > 0) return ref[ref.length - 1];
+			}
 		}
 		if (Array.isArray(schema.type)) return union(schema.type.map((type) => ({
 			...schema,

package/dist/utils/schema.d.ts

@@ -6,9 +6,9 @@ type NoReference<T> = T extends (infer I)[] ? NoReference<I>[] : T extends Refer
 type NoReferenceJSONSchema<T> = T extends (infer I)[] ? NoReference<I>[] : T extends {
   $ref?: string;
 } ? Omit<T, '$ref'> : T;
-type ParsedSchema = JSONSchema & {
+type ParsedSchema = (JSONSchema & {
   'x-playground-lazy'?: boolean;
-};
+}) | boolean;
 type ResolvedSchema = NoReferenceJSONSchema<ParsedSchema>;
 //#endregion
 export { NoReference, ParsedSchema, ResolvedSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.3.13",
+  "version": "10.3.14",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -42,14 +42,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@fumari/json-schema-to-typescript": "^2.0.0",
+    "@fumari/json-schema-ts": "^0.0.2",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-slot": "^1.2.4",
     "@scalar/json-magic": "^0.11.5",
-    "@scalar/openapi-parser": "0.24.14",
-    "@scalar/openapi-upgrader": "^0.1.8",
+    "@scalar/openapi-upgrader": "^0.1.9",
     "ajv": "^8.18.0",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
@@ -63,21 +62,22 @@
     "remark-rehype": "^11.1.2",
     "tailwind-merge": "^3.5.0",
     "xml-js": "^1.6.11",
-    "@fumari/stf": "1.0.2"
+    "@fumari/stf": "1.0.3"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^1.3.101",
+    "@scalar/api-client-react": "^1.3.104",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "25.3.1",
+    "@types/node": "25.3.3",
     "@types/openapi-sampler": "^1.0.3",
     "@types/react": "^19.2.14",
+    "dereference-json-schema": "^0.2.1",
     "json-schema-typed": "^8.0.2",
     "tailwindcss": "^4.2.1",
     "tsdown": "0.20.3",
-    "@fumadocs/tailwind": "0.0.2",
+    "@fumadocs/tailwind": "0.0.3",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "16.6.7",
-    "fumadocs-ui": "16.6.7",
+    "fumadocs-core": "16.6.8",
+    "fumadocs-ui": "16.6.8",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {

package/dist/utils/get-typescript-schema.js

@@ -1,21 +0,0 @@
-//#region src/utils/get-typescript-schema.ts
-async function getTypescriptSchema(schema, ctx) {
-	const { compile } = await import("@fumari/json-schema-to-typescript");
-	try {
-		const input = structuredClone({
-			schema,
-			idToSchema: ctx.schema._internal_idToSchema()
-		});
-		const schemaToId = /* @__PURE__ */ new WeakMap();
-		for (const [k, v] of input.idToSchema) schemaToId.set(v, k);
-		return await compile(input.schema, "Response", {
-			enableConstEnums: false,
-			schemaToId
-		});
-	} catch (e) {
-		console.warn("Failed to generate typescript schema:", e);
-	}
-}
-
-//#endregion
-export { getTypescriptSchema };