fumadocs-openapi 10.7.1 → 10.8.1

package/css/generated/shared.css

@@ -193,7 +193,7 @@
 @source inline("current");
 @source inline("currentRef");
 @source inline("currentValue");
-@source inline("customisation");
+@source inline("customization");
 @source inline("cva");
 @source inline("dark");
 @source inline("dark:text-blue-400");

package/dist/_virtual/_rolldown/runtime.js

@@ -1,6 +1,6 @@
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
-var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __exportAll = (all, no_symbols) => {
 	let target = {};
 	for (var name in all) __defProp(target, name, {

package/dist/generate-file.d.ts

@@ -60,7 +60,9 @@ interface GenerateFilesConfig extends PagesToTextOptions {
   beforeWrite?: (this: BeforeWriteContext, files: OutputFile[]) => void | Promise<void>;
 }
 interface MetaOptions {
+  /** @deprecated use `folderStyle` instead */
   groupStyle?: 'folder' | 'separator';
+  folderStyle?: 'folder' | 'separator';
 }
 type Config = SchemaToPagesOptions & GenerateFilesConfig & {
   /**

package/dist/generate-file.js

@@ -65,14 +65,14 @@ async function generateFilesOnly(options) {
 }
 function generateMeta(context, options) {
 	const files = [];
-	const { groupStyle = "folder" } = options;
+	const folderStyle = options.folderStyle ?? options.groupStyle ?? "folder";
 	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);
+				if (folderStyle === "folder") pages.push(relativePath);
 				else pages.push(`---${entry.info.title}---`, `...${relativePath}`);
 			} else pages.push(relativePath.slice(0, -path$1.extname(entry.path).length));
 		}

package/dist/node_modules/.pnpm/{@scalar_helpers@0.4.3 → @scalar_helpers@0.5.2}/node_modules/@scalar/helpers/dist/general/create-limiter.js

@@ -1,5 +1,5 @@
 import { Queue } from "../queue/queue.js";
-//#region ../../node_modules/.pnpm/@scalar+helpers@0.4.3/node_modules/@scalar/helpers/dist/general/create-limiter.js
+//#region ../../node_modules/.pnpm/@scalar+helpers@0.5.2/node_modules/@scalar/helpers/dist/general/create-limiter.js
 /**
 * Creates a function that limits the number of concurrent executions of async functions.
 *

package/dist/node_modules/.pnpm/{@scalar_helpers@0.4.3 → @scalar_helpers@0.5.2}/node_modules/@scalar/helpers/dist/object/is-object.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+helpers@0.4.3/node_modules/@scalar/helpers/dist/object/is-object.js
+//#region ../../node_modules/.pnpm/@scalar+helpers@0.5.2/node_modules/@scalar/helpers/dist/object/is-object.js
 /**
 * Returns true if the provided value is a record object
 * (i.e. not null, not an array, and has an actual object as the prototype).
@@ -6,16 +6,17 @@
 * Differs from the previous isObject in that it returns false for Date,
 * RegExp, Error, Map, Set, WeakMap, WeakSet, Promise, and other non-plain objects.
 *
-* Examples:
-*   isObject({})                  // true
-*   isObject({ a: 1 })            // true
-*   isObject([])                  // false (Array)
-*   isObject(null)                // false
-*   isObject(123)                 // false
-*   isObject('string')            // false
-*   isObject(new Error('test'))   // false
-*   isObject(new Date())          // false
-*   isObject(Object.create(null)) // true
+* | Value | Result |
+* | :--- | :--- |
+* | `isObject({})` | `true` |
+* | `isObject({ a: 1 })` | `true` |
+* | `isObject([])` | `false` (Array) |
+* | `isObject(null)` | `false` |
+* | `isObject(123)` | `false` |
+* | `isObject('string')` | `false` |
+* | `isObject(new Error('test'))` | `false` |
+* | `isObject(new Date())` | `false` |
+* | `isObject(Object.create(null))` | `true` |
 */
 const isObject = (value) => {
 	if (value === null || typeof value !== "object") return false;

package/dist/node_modules/.pnpm/{@scalar_helpers@0.4.3 → @scalar_helpers@0.5.2}/node_modules/@scalar/helpers/dist/object/prevent-pollution.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+helpers@0.4.3/node_modules/@scalar/helpers/dist/object/prevent-pollution.js
+//#region ../../node_modules/.pnpm/@scalar+helpers@0.5.2/node_modules/@scalar/helpers/dist/object/prevent-pollution.js
 /**
 * Set of dangerous keys that can be used for prototype pollution attacks.
 * These keys should never be used as property names in dynamic object operations.

package/dist/node_modules/.pnpm/{@scalar_helpers@0.4.3 → @scalar_helpers@0.5.2}/node_modules/@scalar/helpers/dist/queue/queue.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+helpers@0.4.3/node_modules/@scalar/helpers/dist/queue/queue.js
+//#region ../../node_modules/.pnpm/@scalar+helpers@0.5.2/node_modules/@scalar/helpers/dist/queue/queue.js
 /**
 * Represents a node in a singly linked list structure, used internally by the Queue.
 *

package/dist/node_modules/.pnpm/{@scalar_helpers@0.4.3 → @scalar_helpers@0.5.2}/node_modules/@scalar/helpers/dist/string/generate-hash.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+helpers@0.4.3/node_modules/@scalar/helpers/dist/string/generate-hash.js
+//#region ../../node_modules/.pnpm/@scalar+helpers@0.5.2/node_modules/@scalar/helpers/dist/string/generate-hash.js
 /**
 * MurmurHash3 implementation
 *

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/bundle/bundle.js

@@ -1,4 +1,4 @@
-import { isObject } from "../../../../../../@scalar_helpers@0.4.3/node_modules/@scalar/helpers/dist/object/is-object.js";
+import { isObject } from "../../../../../../@scalar_helpers@0.5.2/node_modules/@scalar/helpers/dist/object/is-object.js";
 import { convertToLocalRef } from "../helpers/convert-to-local-ref.js";
 import { getId, getSchemas } from "../helpers/get-schemas.js";
 import { getValueByPath } from "../helpers/get-value-by-path.js";
@@ -10,7 +10,7 @@ import { setValueAtPath } from "../helpers/set-value-at-path.js";
 import { toRelativePath } from "../helpers/to-relative-path.js";
 import { escapeJsonPointer } from "../helpers/escape-json-pointer.js";
 import { getHash, uniqueValueGeneratorFactory } from "./value-generator.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/bundle/bundle.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/bundle.js
 /** Type guard to check if a value is an object with a $ref property */
 const hasRef = (value) => isObject(value) && "$ref" in value && typeof value["$ref"] === "string";
 /**
@@ -155,7 +155,18 @@ const resolveAndCopyReferences = (targetDocument, sourceDocument, referencePath,
 * These custom extensions help maintain the structure and traceability of bundled documents.
 */
 const extensions = {
+	/**
+	* Custom OpenAPI extension key used to store external references.
+	* This key will contain all bundled external documents.
+	* The x-ext key is used to maintain a clean separation between the main
+	* OpenAPI document and its bundled external references.
+	*/
 	externalDocuments: "x-ext",
+	/**
+	* Custom OpenAPI extension key used to maintain a mapping between
+	* hashed keys and their original URLs in x-ext.
+	* This mapping is essential for tracking the source of bundled references
+	*/
 	externalDocumentsMappings: "x-ext-urls"
 };
 /**

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/bundle/plugins/fetch-urls/index.js

@@ -1,7 +1,7 @@
 import { isHttpUrl } from "../../../helpers/is-http-url.js";
-import { createLimiter } from "../../../../../../../../@scalar_helpers@0.4.3/node_modules/@scalar/helpers/dist/general/create-limiter.js";
+import { createLimiter } from "../../../../../../../../@scalar_helpers@0.5.2/node_modules/@scalar/helpers/dist/general/create-limiter.js";
 import { normalize } from "../../../helpers/normalize.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/bundle/plugins/fetch-urls/index.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/plugins/fetch-urls/index.js
 /**
 * Safely checks for host from a URL
 * Needed because we cannot create a URL from a relative remote URL ex: examples/openapi.json

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/bundle/plugins/read-files/index.js

@@ -1,6 +1,6 @@
 import { isFilePath } from "../../../helpers/is-file-path.js";
 import { normalize } from "../../../helpers/normalize.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/bundle/plugins/read-files/index.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/plugins/read-files/index.js
 /**
 * Reads and normalizes data from a local file
 * @param path - The file path to read from

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/bundle/value-generator.js

@@ -1,5 +1,5 @@
-import { generateHash } from "../../../../../../@scalar_helpers@0.4.3/node_modules/@scalar/helpers/dist/string/generate-hash.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/bundle/value-generator.js
+import { generateHash } from "../../../../../../@scalar_helpers@0.5.2/node_modules/@scalar/helpers/dist/string/generate-hash.js";
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/value-generator.js
 /**
 * Generates a short hash from a string value using xxhash.
 *
@@ -75,7 +75,21 @@ async function generateUniqueValue(compress, value, compressedToValue, prevCompr
 */
 const uniqueValueGeneratorFactory = (compress, compressedToValue) => {
 	const valueToCompressed = Object.fromEntries(Object.entries(compressedToValue).map(([key, value]) => [value, key]));
-	return { generate: async (value) => {
+	return { 
+	/**
+	* Generates a unique compressed value for the given input string.
+	* First checks if a compressed value already exists in the cache.
+	* If not, generates a new unique compressed value and stores it in the cache.
+	*
+	* @param value - The original string value to compress
+	* @returns A Promise that resolves to the compressed string value
+	*
+	* @example
+	* const generator = uniqueValueGeneratorFactory(compress, {})
+	* const compressed = await generator.generate('example.com/schema.json')
+	* // Returns a unique compressed value like 'example'
+	*/
+generate: async (value) => {
 		const cache = valueToCompressed[value];
 		if (cache) return cache;
 		const generatedValue = await generateUniqueValue(compress, value, compressedToValue);

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/convert-to-local-ref.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/convert-to-local-ref.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/convert-to-local-ref.js
 /**
 * Translates a JSON Reference ($ref) to a local object path within the root schema.
 *

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/escape-json-pointer.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/escape-json-pointer.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/escape-json-pointer.js
 /**
 * Escapes a JSON pointer string.
 *

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/get-schemas.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/get-schemas.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/get-schemas.js
 /**
 * Retrieves the $id property from the input object if it exists and is a string.
 *

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/get-segments-from-path.js

@@ -1,5 +1,5 @@
 import { unescapeJsonPointer } from "./unescape-json-pointer.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/get-segments-from-path.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/get-segments-from-path.js
 /**
 * Translate `/paths/~1test` to `['paths', '/test']`
 */

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/get-value-by-path.js

@@ -1,5 +1,5 @@
 import { getId } from "./get-schemas.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/get-value-by-path.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/get-value-by-path.js
 /**
 * Traverses an object using an array of string segments (path keys) and returns
 * the value at the specified path along with its context (id if available).

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/is-file-path.js

@@ -1,7 +1,7 @@
 import { isHttpUrl } from "./is-http-url.js";
 import { isJsonObject } from "./is-json-object.js";
 import { isYaml } from "./is-yaml.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/is-file-path.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/is-file-path.js
 /**
 * Checks if a string represents a file path by ensuring it's not a remote URL,
 * YAML content, or JSON content.

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/is-http-url.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/is-http-url.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/is-http-url.js
 /**
 * Checks if a string is a remote URL (starts with http:// or https://)
 * @param value - The URL string to check

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/is-json-object.js

@@ -1,5 +1,5 @@
-import { isObject } from "../../../../../../@scalar_helpers@0.4.3/node_modules/@scalar/helpers/dist/object/is-object.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/is-json-object.js
+import { isObject } from "../../../../../../@scalar_helpers@0.5.2/node_modules/@scalar/helpers/dist/object/is-object.js";
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/is-json-object.js
 /**
 * Determines if a string represents a valid JSON object (i.e., a plain object, not an array, primitive, or null).
 * The function first checks if the string appears to start with an opening curly brace (ignoring leading whitespace),

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/is-yaml.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/is-yaml.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/is-yaml.js
 /**
 * Checks if a string appears to be YAML content.
 * This function uses a simple heuristic: it looks for a line that starts with an optional dash,

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/normalize.js

@@ -1,6 +1,6 @@
 import { parse } from "../../../../../../yaml@2.8.3/node_modules/yaml/browser/dist/public-api.js";
 import "../../../../../../yaml@2.8.3/node_modules/yaml/browser/index.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/normalize.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/normalize.js
 /**
 * Normalize a string (YAML, JSON, object) to a JavaScript datatype.
 */

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/resolve-reference-path.js

@@ -1,6 +1,6 @@
 import { isHttpUrl } from "./is-http-url.js";
 import { posix } from "../../../../../../pathe@2.0.3/node_modules/pathe/dist/index.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/resolve-reference-path.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/resolve-reference-path.js
 /**
 * Resolves a reference path by combining a base path with a relative path.
 * Handles both remote URLs and local file paths.

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/set-value-at-path.js

@@ -1,6 +1,6 @@
-import { preventPollution } from "../../../../../../@scalar_helpers@0.4.3/node_modules/@scalar/helpers/dist/object/prevent-pollution.js";
+import { preventPollution } from "../../../../../../@scalar_helpers@0.5.2/node_modules/@scalar/helpers/dist/object/prevent-pollution.js";
 import { getSegmentsFromPath } from "./get-segments-from-path.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/set-value-at-path.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/set-value-at-path.js
 /**
 * Sets a value at a specified path in an object, creating intermediate objects/arrays as needed.
 * This function traverses the object structure and creates any missing intermediate objects

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/to-relative-path.js

@@ -1,6 +1,6 @@
 import { isHttpUrl } from "./is-http-url.js";
 import { posix } from "../../../../../../pathe@2.0.3/node_modules/pathe/dist/index.js";
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/to-relative-path.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/to-relative-path.js
 /**
 * Converts an input path or URL to a relative path based on the provided base.
 * Handles both remote URLs and local file system paths.

package/dist/node_modules/.pnpm/{@scalar_json-magic@0.12.5 → @scalar_json-magic@0.12.8}/node_modules/@scalar/json-magic/dist/helpers/unescape-json-pointer.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.5/node_modules/@scalar/json-magic/dist/helpers/unescape-json-pointer.js
+//#region ../../node_modules/.pnpm/@scalar+json-magic@0.12.8/node_modules/@scalar/json-magic/dist/helpers/unescape-json-pointer.js
 /**
 * Unescape JSON pointer
 *

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.4 → @scalar_openapi-upgrader@0.2.6}/node_modules/@scalar/openapi-upgrader/dist/2.0-to-3.0/upgrade-from-two-to-three.js

@@ -1,5 +1,5 @@
 import { traverse } from "../helpers/traverse.js";
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.4/node_modules/@scalar/openapi-upgrader/dist/2.0-to-3.0/upgrade-from-two-to-three.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.6/node_modules/@scalar/openapi-upgrader/dist/2.0-to-3.0/upgrade-from-two-to-three.js
 const DEFAULT_MEDIA_TYPE = "application/json";
 /** Extracts and removes x-example and x-examples extensions from an object */
 function extractXExampleExtensions(obj) {

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.4 → @scalar_openapi-upgrader@0.2.6}/node_modules/@scalar/openapi-upgrader/dist/3.0-to-3.1/upgrade-from-three-to-three-one.js

@@ -1,5 +1,5 @@
 import { traverse } from "../helpers/traverse.js";
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.4/node_modules/@scalar/openapi-upgrader/dist/3.0-to-3.1/upgrade-from-three-to-three-one.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.6/node_modules/@scalar/openapi-upgrader/dist/3.0-to-3.1/upgrade-from-three-to-three-one.js
 const SCHEMA_SEGMENTS = new Set([
 	"properties",
 	"items",

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.4 → @scalar_openapi-upgrader@0.2.6}/node_modules/@scalar/openapi-upgrader/dist/3.1-to-3.2/upgrade-from-three-one-to-three-two.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.4/node_modules/@scalar/openapi-upgrader/dist/3.1-to-3.2/upgrade-from-three-one-to-three-two.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.6/node_modules/@scalar/openapi-upgrader/dist/3.1-to-3.2/upgrade-from-three-one-to-three-two.js
 /**
 * Recursively migrate XML object properties from 3.1 to 3.2 format
 */

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.4 → @scalar_openapi-upgrader@0.2.6}/node_modules/@scalar/openapi-upgrader/dist/helpers/traverse.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.4/node_modules/@scalar/openapi-upgrader/dist/helpers/traverse.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.6/node_modules/@scalar/openapi-upgrader/dist/helpers/traverse.js
 /**
 * Recursively traverses the content and applies the transform function to each node.
 */

package/dist/node_modules/.pnpm/{@scalar_openapi-upgrader@0.2.4 → @scalar_openapi-upgrader@0.2.6}/node_modules/@scalar/openapi-upgrader/dist/upgrade.js

@@ -1,7 +1,7 @@
 import { upgradeFromThreeOneToThreeTwo } from "./3.1-to-3.2/upgrade-from-three-one-to-three-two.js";
 import { upgradeFromTwoToThree } from "./2.0-to-3.0/upgrade-from-two-to-three.js";
 import { upgradeFromThreeToThreeOne } from "./3.0-to-3.1/upgrade-from-three-to-three-one.js";
-//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.4/node_modules/@scalar/openapi-upgrader/dist/upgrade.js
+//#region ../../node_modules/.pnpm/@scalar+openapi-upgrader@0.2.6/node_modules/@scalar/openapi-upgrader/dist/upgrade.js
 function upgrade(value, targetVersion) {
 	const openapi30 = upgradeFromTwoToThree(value);
 	if (targetVersion === "3.0") return openapi30;

package/dist/node_modules/.pnpm/yaml@2.8.3/node_modules/yaml/browser/dist/doc/anchors.js

@@ -39,6 +39,11 @@ function createNodeAnchors(doc, prefix) {
 			prevAnchors.add(anchor);
 			return anchor;
 		},
+		/**
+		* With circular references, the source node is only resolved after all
+		* of its child nodes are. This is why anchors are set only after all of
+		* the nodes have been created.
+		*/
 		setAnchors: () => {
 			for (const source of aliasObjects) {
 				const ref = sourceObjects.get(source);

package/dist/node_modules/.pnpm/yaml@2.8.3/node_modules/yaml/browser/dist/schema/yaml-1.1/binary.js

@@ -5,6 +5,14 @@ const binary = {
 	identify: (value) => value instanceof Uint8Array,
 	default: false,
 	tag: "tag:yaml.org,2002:binary",
+	/**
+	* Returns a Buffer in node and an Uint8Array in browsers
+	*
+	* To use the resulting buffer as an image, you'll want to do something like:
+	*
+	*   const blob = new Blob([buffer], { type: 'image/jpeg' })
+	*   document.querySelector('#photo').src = URL.createObjectURL(blob)
+	*/
 	resolve(src, onError) {
 		if (typeof atob === "function") {
 			const str = atob(src.replace(/[\n\r]/g, ""));

package/dist/playground/client.d.ts

@@ -55,7 +55,7 @@ interface PlaygroundClientOptions {
   /**
    * render the input for API endpoint body.
    *
-   * @see renderParameterField for customisation tips
+   * @see renderParameterField for customization tips
    */
   renderBodyField?: (fieldName: 'body', info: RequestBodyInfo) => ReactNode;
 }

package/dist/playground/components/inputs.js

@@ -1,7 +1,6 @@
 "use client";
 import { useTranslations } from "../../ui/client/i18n.js";
 import { cn } from "../../utils/cn.js";
-import { FormatFlags } from "../../utils/schema/to-string.js";
 import { anyFields, useFieldInfo, useResolvedSchema, useSchemaScope, useSchemaUtils } from "../schema.js";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../../ui/components/select.js";
 import { Input, labelVariants } from "../../ui/components/input.js";
@@ -283,7 +282,7 @@ function FieldSet({ field: _field, fieldName, toolbar, name, isRequired, depth =
 				children: union.map((item, i) => /* @__PURE__ */ jsx("option", {
 					value: i,
 					className: "bg-fd-popover text-fd-popover-foreground",
-					children: schemaToString(item, FormatFlags.UseAlias)
+					children: schemaToString(item, 1)
 				}, i))
 			}), toolbar] })
 		});

package/dist/ui/base.d.ts

@@ -71,7 +71,7 @@ interface CreateAPIPageOptions {
    */
   mediaAdapters?: Record<string, MediaAdapter>;
   /**
-   * Customise page content
+   * Customize page content
    */
   content?: {
     renderResponseTabs?: (tabs: ResponseTab[], ctx: RenderContext) => ReactNode;
@@ -133,7 +133,7 @@ interface CreateAPIPageOptions {
     showExample?: boolean;
   };
   /**
-   * Customise API playground
+   * Customize API playground
    */
   playground?: {
     /**

package/dist/ui/components/dialog.js

@@ -10,7 +10,6 @@ import * as DialogPrimitive from "@radix-ui/react-dialog";
 const Dialog = DialogPrimitive.Root;
 const DialogTrigger = DialogPrimitive.Trigger;
 const DialogPortal = DialogPrimitive.Portal;
-DialogPrimitive.Close;
 const DialogOverlay = React.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(DialogPrimitive.Overlay, {
 	ref,
 	className: cn("fixed inset-0 z-50 bg-black/30 backdrop-blur-sm data-[state=open]:animate-fd-fade-in data-[state=closed]:animate-fd-fade-out", className),

package/dist/ui/components/select.js

@@ -5,7 +5,6 @@ import { Check, ChevronDown, ChevronUp } from "lucide-react";
 import * as SelectPrimitive from "@radix-ui/react-select";
 //#region src/ui/components/select.tsx
 const Select = SelectPrimitive.Root;
-SelectPrimitive.Group;
 const SelectValue = SelectPrimitive.Value;
 const SelectTrigger = forwardRef(({ className, children, ...props }, ref) => /* @__PURE__ */ jsxs(SelectPrimitive.Trigger, {
 	ref,

package/dist/ui/schema/index.js

@@ -1,6 +1,6 @@
 import { I18nLabel } from "../client/i18n.js";
 import { mergeAllOf } from "../../utils/schema/merge.js";
-import { FormatFlags, schemaToString } from "../../utils/schema/to-string.js";
+import { schemaToString } from "../../utils/schema/to-string.js";
 import { useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/ui/schema/index.tsx
@@ -103,7 +103,7 @@ function generateSchemaUI(root, readOnly = false, writeOnly = false, ctx) {
 			description: schema.description ? ctx.renderMarkdown(schema.description) : void 0,
 			infoTags: generateInfoTags(schema),
 			typeName: schemaToString(schema, ctx.schema),
-			aliasName: schemaToString(schema, ctx.schema, FormatFlags.UseAlias),
+			aliasName: schemaToString(schema, ctx.schema, 1),
 			deprecated: schema.deprecated
 		};
 	}
@@ -180,7 +180,7 @@ function generateSchemaUI(root, readOnly = false, writeOnly = false, ctx) {
 				});
 				out.items.push({
 					$type: key,
-					name: refs[itemId]?.aliasName ?? schemaToString(item, ctx.schema, FormatFlags.UseAlias)
+					name: refs[itemId]?.aliasName ?? schemaToString(item, ctx.schema, 1)
 				});
 			}
 			return;

package/dist/utils/document/process.js

@@ -1,8 +1,8 @@
-import { bundle } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.5/node_modules/@scalar/json-magic/dist/bundle/bundle.js";
-import { upgrade } from "../../node_modules/.pnpm/@scalar_openapi-upgrader@0.2.4/node_modules/@scalar/openapi-upgrader/dist/upgrade.js";
-import { fetchUrls } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.5/node_modules/@scalar/json-magic/dist/bundle/plugins/fetch-urls/index.js";
-import { readFiles } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.5/node_modules/@scalar/json-magic/dist/bundle/plugins/read-files/index.js";
-import "../../node_modules/.pnpm/@scalar_json-magic@0.12.5/node_modules/@scalar/json-magic/dist/bundle/plugins/node.js";
+import { bundle } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/bundle.js";
+import { upgrade } from "../../node_modules/.pnpm/@scalar_openapi-upgrader@0.2.6/node_modules/@scalar/openapi-upgrader/dist/upgrade.js";
+import { fetchUrls } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/plugins/fetch-urls/index.js";
+import { readFiles } from "../../node_modules/.pnpm/@scalar_json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/plugins/read-files/index.js";
+import "../../node_modules/.pnpm/@scalar_json-magic@0.12.8/node_modules/@scalar/json-magic/dist/bundle/plugins/node.js";
 import { dereferenceDocument } from "./dereference.js";
 //#region src/utils/document/process.ts
 /**

package/dist/utils/pages/to-text.d.ts

@@ -9,7 +9,7 @@ interface PagesToTextOptions {
     from: string;
   }[];
   /**
-   * Customise frontmatter.
+   * Customize frontmatter.
    *
    * A `full: true` property will be added by default.
    */

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

@@ -1,10 +1,5 @@
 //#region src/utils/schema/to-string.ts
-let FormatFlags = /* @__PURE__ */ function(FormatFlags) {
-	FormatFlags[FormatFlags["None"] = 0] = "None";
-	FormatFlags[FormatFlags["UseAlias"] = 1] = "UseAlias";
-	return FormatFlags;
-}({});
-function schemaToString(value, _resolver, flags = FormatFlags.None) {
+function schemaToString(value, _resolver, flags = 0) {
 	const resolver = typeof _resolver === "function" ? _resolver : (schema) => {
 		const ref = _resolver && typeof schema === "object" ? _resolver.getRawRef(schema) : void 0;
 		return {
@@ -16,7 +11,7 @@ function schemaToString(value, _resolver, flags = FormatFlags.None) {
 		const members = /* @__PURE__ */ new Set();
 		let nullable = false;
 		for (const item of union) {
-			const result = run(item, flags | FormatFlags.UseAlias);
+			const result = run(item, flags | 1);
 			if (result === "null") nullable = true;
 			else if (result !== "unknown") members.add(result);
 		}
@@ -27,7 +22,7 @@ function schemaToString(value, _resolver, flags = FormatFlags.None) {
 		const { dereferenced: schema, raw } = resolver(input);
 		if (schema === true) return "any";
 		else if (schema === false) return "never";
-		if ((flags & FormatFlags.UseAlias) === FormatFlags.UseAlias) {
+		if ((flags & 1) === 1) {
 			if (schema.title) return schema.title;
 			if (typeof raw === "object" && raw.$ref) {
 				const ref = raw.$ref.split("/");
@@ -38,7 +33,7 @@ function schemaToString(value, _resolver, flags = FormatFlags.None) {
 			...schema,
 			type
 		})), " | ", flags);
-		if (schema.type === "array") return `array<${schema.items ? run(schema.items, flags | FormatFlags.UseAlias) : "unknown"}>`;
+		if (schema.type === "array") return `array<${schema.items ? run(schema.items, flags | 1) : "unknown"}>`;
 		const or = schema.oneOf ?? schema.anyOf;
 		if (schema.oneOf && schema.anyOf) return `(${union(schema.oneOf, " | ", flags)}) & (${union(schema.anyOf, " | ", flags)})`;
 		else if (or) return union(or, " | ", flags);
@@ -52,4 +47,4 @@ function schemaToString(value, _resolver, flags = FormatFlags.None) {
 	return run(value, flags);
 }
 //#endregion
-export { FormatFlags, schemaToString };
+export { schemaToString };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.7.1",
+  "version": "10.8.1",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -48,13 +48,13 @@
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-slot": "^1.2.4",
-    "ajv": "^8.18.0",
+    "ajv": "^8.20.0",
     "chokidar": "^5.0.0",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
     "hast-util-to-jsx-runtime": "^2.3.6",
     "js-yaml": "^4.1.1",
-    "lucide-react": "^1.8.0",
+    "lucide-react": "^1.11.0",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
     "shiki": "^4.0.2",
@@ -64,23 +64,23 @@
   },
   "devDependencies": {
     "@fastify/deepmerge": "^3.2.1",
-    "@scalar/api-client-react": "^2.0.1",
-    "@scalar/json-magic": "^0.12.5",
-    "@scalar/openapi-upgrader": "^0.2.4",
+    "@scalar/api-client-react": "2.0.1",
+    "@scalar/json-magic": "^0.12.8",
+    "@scalar/openapi-upgrader": "^0.2.6",
+    "@tailwindcss/oxide": "^4.2.4",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "25.6.0",
     "@types/react": "^19.2.14",
     "fast-content-type-parse": "^3.0.0",
     "json-schema-typed": "^8.0.2",
-    "tailwindcss": "^4.2.2",
-    "tsdown": "0.21.8",
-    "@fumadocs/tailwind": "0.0.5",
-    "fumadocs-core": "16.7.16",
-    "fumadocs-ui": "16.7.16",
+    "tailwindcss": "^4.2.4",
+    "tsdown": "0.21.10",
+    "fumadocs-core": "16.8.5",
+    "fumadocs-ui": "16.8.5",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
-    "@scalar/api-client-react": "2.x.x",
+    "@scalar/api-client-react": "2.0.1",
     "@types/react": "*",
     "fumadocs-core": "^16.7.15",
     "fumadocs-ui": "^16.7.15",
@@ -101,9 +101,9 @@
   },
   "inlinedDependencies": {
     "@fastify/deepmerge": "3.2.1",
-    "@scalar/helpers": "0.4.3",
-    "@scalar/json-magic": "0.12.5",
-    "@scalar/openapi-upgrader": "0.2.4",
+    "@scalar/helpers": "0.5.2",
+    "@scalar/json-magic": "0.12.8",
+    "@scalar/openapi-upgrader": "0.2.6",
     "fast-content-type-parse": "3.0.0",
     "pathe": "2.0.3",
     "yaml": "2.8.3"