fumadocs-openapi 8.1.12 → 9.0.1

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

@@ -1 +1 @@
-{"version":3,"file":"process-document.d.ts","sourceRoot":"","sources":["../../src/utils/process-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,QAAQ,CAAC;CACtB,CAAC;AAIF;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,YAAY,UAAQ,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA8B5B"}
+{"version":3,"file":"process-document.d.ts","sourceRoot":"","sources":["../../src/utils/process-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,QAAQ,CAAC;CACtB,CAAC;AAIF;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,YAAY,UAAQ,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAoC5B"}

package/dist/utils/process-document.js

@@ -5,14 +5,17 @@ const cache = new Map();
 /**
  * process & reference input document to a Fumadocs OpenAPI compatible format
  */
-export async function processDocument(document, disableCache = false) {
-    const cached = !disableCache && typeof document === 'string' ? cache.get(document) : null;
+export async function processDocument(input, disableCache = false) {
+    const cached = !disableCache && typeof input === 'string' ? cache.get(input) : null;
     if (cached)
         return cached;
     const dereferenceMap = new Map();
-    const loaded = await load(document, {
+    const loaded = await load(input, {
         plugins: [readFiles(), fetchUrls()],
     });
+    if (loaded.errors && loaded.errors.length > 0) {
+        throw new Error(loaded.errors.map((err) => `${err.code}: ${err.message}`).join('\n'));
+    }
     // upgrade
     loaded.specification = upgrade(loaded.specification).specification;
     const { schema: dereferenced } = await dereference(loaded.filesystem, {
@@ -25,8 +28,8 @@ export async function processDocument(document, disableCache = false) {
         dereferenceMap,
         downloaded: loaded.specification,
     };
-    if (!disableCache && typeof document === 'string') {
-        cache.set(document, processed);
+    if (!disableCache && typeof input === 'string') {
+        cache.set(input, processed);
     }
     return processed;
 }

package/dist/utils/schema-to-string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-to-string.d.ts","sourceRoot":"","sources":["../../src/utils/schema-to-string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,UAAO,GAAG,MAAM,CAuE5E"}
+{"version":3,"file":"schema-to-string.d.ts","sourceRoot":"","sources":["../../src/utils/schema-to-string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,UAAO,GAAG,MAAM,CA0D5E"}

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

@@ -17,6 +17,7 @@ export function schemaToString(schema, isRoot = true) {
             ...schema,
             type,
         }, false))
+            .filter((v) => v !== 'unknown' && v !== 'null')
             .join(' | ');
     }
     if (schema.type === 'array')
@@ -24,39 +25,25 @@ export function schemaToString(schema, isRoot = true) {
     if (schema.oneOf) {
         return schema.oneOf
             .map((one) => schemaToString(one, false))
-            .filter((v) => v !== 'unknown')
+            .filter((v) => v !== 'unknown' && v !== 'null')
             .join(' | ');
     }
-    if (schema.allOf) {
-        return schema.allOf
+    const combinedOf = schema.anyOf ?? schema.allOf;
+    if (combinedOf) {
+        return combinedOf
             .map((one) => schemaToString(one, false))
-            .filter((v) => v !== 'unknown')
+            .filter((v) => v !== 'unknown' && v !== 'null')
             .join(' & ');
     }
     if (schema.not)
         return `not ${schemaToString(schema.not, false)}`;
-    if (schema.anyOf) {
-        const union = schema.anyOf
-            .map((one) => schemaToString(one, false))
-            .filter((v) => v !== 'unknown');
-        if (union.length > 1) {
-            return `Any properties in ${union.join(',')}`;
-        }
-        else if (union.length === 1) {
-            return union[0];
-        }
-    }
     if (schema.type === 'string' && schema.format === 'binary')
         return 'file';
     if (schema.type && Array.isArray(schema.type)) {
-        const nonNullTypes = schema.type.filter((v) => v !== 'null');
-        if (nonNullTypes.length > 0)
-            return nonNullTypes.join(' | ');
+        return schema.type.filter((v) => v !== 'null').join(' | ');
     }
-    else if (schema.type && schema.type !== 'null') {
+    if (schema.type) {
         return schema.type;
     }
-    if (typeof schema.type === 'string')
-        return schema.type;
     return 'unknown';
 }

package/dist/utils/schema.d.ts

@@ -9,6 +9,6 @@ type NoReferenceJSONSchema<T> = T extends (infer I)[] ? NoReference<I>[] : T ext
 export type ParsedSchema = JSONSchema;
 export type ResolvedSchema = NoReferenceJSONSchema<ParsedSchema>;
 export declare function getPreferredType<B extends Record<string, unknown>>(body: B): keyof B | undefined;
-export declare function isNullable(schema: ParsedSchema, includeOneOf?: boolean): boolean;
+export declare function isNullable(schema: ParsedSchema): boolean;
 export {};
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC9C,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,eAAe,GACvB,OAAO,CAAC,CAAC,EAAE,eAAe,CAAC,GAC3B,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GACD,CAAC,CAAC;AAEV,KAAK,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACjD,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GACf,CAAC,CAAC;AAER,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AACtC,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;AAEjE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,IAAI,EAAE,CAAC,GACN,MAAM,CAAC,GAAG,SAAS,CAIrB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,UAAO,GAAG,OAAO,CAU7E"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC9C,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,eAAe,GACvB,OAAO,CAAC,CAAC,EAAE,eAAe,CAAC,GAC3B,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GACD,CAAC,CAAC;AAEV,KAAK,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACjD,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GACf,CAAC,CAAC;AAER,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AACtC,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;AAEjE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,IAAI,EAAE,CAAC,GACN,MAAM,CAAC,GAAG,SAAS,CAIrB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAQxD"}

package/dist/utils/schema.js

@@ -3,16 +3,13 @@ export function getPreferredType(body) {
         return 'application/json';
     return Object.keys(body)[0];
 }
-export function isNullable(schema, includeOneOf = true) {
+export function isNullable(schema) {
     if (typeof schema === 'boolean')
         return false;
     if (Array.isArray(schema.type) && schema.type.includes('null'))
         return true;
-    if (includeOneOf && (schema.anyOf || schema.oneOf)) {
-        if (schema.anyOf?.some((item) => isNullable(item)))
-            return true;
-        if (schema.oneOf?.some((item) => isNullable(item)))
-            return true;
-    }
-    return false;
+    const combined = schema.anyOf ?? schema.oneOf ?? schema.allOf;
+    if (combined && combined.some(isNullable))
+        return true;
+    return schema.type === 'null';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "8.1.12",
+  "version": "9.0.1",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -46,10 +46,10 @@
   ],
   "dependencies": {
     "@fumari/json-schema-to-typescript": "^1.1.3",
-    "@radix-ui/react-dialog": "^1.1.13",
-    "@radix-ui/react-select": "^2.2.4",
-    "@radix-ui/react-slot": "^1.2.2",
-    "@scalar/openapi-parser": "0.10.17",
+    "@radix-ui/react-dialog": "^1.1.14",
+    "@radix-ui/react-select": "^2.2.5",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@scalar/openapi-parser": "0.11.1",
     "ajv": "^8.17.1",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
@@ -63,22 +63,22 @@
     "shiki": "^3.4.2",
     "tinyglobby": "^0.2.13",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "15.3.4",
-    "fumadocs-ui": "15.3.4"
+    "fumadocs-core": "15.4.0",
+    "fumadocs-ui": "15.4.0"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^1.2.34",
+    "@scalar/api-client-react": "^1.3.3",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "22.15.19",
+    "@types/node": "22.15.21",
     "@types/openapi-sampler": "^1.0.3",
-    "@types/react": "^19.1.4",
+    "@types/react": "^19.1.5",
     "json-schema-typed": "^8.0.1",
     "next": "15.3.2",
     "openapi-types": "^12.1.3",
     "tailwindcss": "^4.1.7",
     "tsc-alias": "^1.8.16",
-    "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0"
+    "tsconfig": "0.0.0",
+    "eslint-config-custom": "0.0.0"
   },
   "peerDependencies": {
     "@scalar/api-client-react": "*",