fumadocs-openapi 5.8.1 → 5.9.0

package/dist/index.js

@@ -1,8 +1,9 @@
 import { resolve, join, parse, dirname } from 'node:path';
 import { dump } from 'js-yaml';
 import Slugger from 'github-slugger';
-import Parser from '@apidevtools/json-schema-ref-parser';
-import { upgrade } from '@scalar/openapi-parser';
+import { load, upgrade, dereference as dereference$1 } from '@scalar/openapi-parser';
+import { fetchUrls } from '@scalar/openapi-parser/plugins/fetch-urls';
+import { readFiles } from '@scalar/openapi-parser/plugins/read-files';
 import { mkdir, writeFile } from 'node:fs/promises';
 import fg from 'fast-glob';
 
@@ -141,17 +142,18 @@ const cache = new Map();
  */ async function processDocument(document, disableCache = false) {
     const cached = !disableCache && typeof document === 'string' ? cache.get(document) : null;
     if (cached) return cached;
-    let bundled = await Parser.bundle(document, {
-        mutateInputSchema: false
-    });
-    bundled = upgrade(bundled).specification;
     const dereferenceMap = new Map();
-    const dereferenced = await Parser.dereference(bundled, {
-        mutateInputSchema: true,
-        dereference: {
-            onDereference ($ref, schema) {
-                dereferenceMap.set(schema, $ref);
-            }
+    const loaded = await load(document, {
+        plugins: [
+            readFiles(),
+            fetchUrls()
+        ]
+    });
+    // upgrade
+    loaded.specification = upgrade(loaded.specification).specification;
+    const { schema: dereferenced } = await dereference$1(loaded.filesystem, {
+        onDereference ({ ref, schema }) {
+            dereferenceMap.set(schema, ref);
         }
     });
     const processed = {

package/dist/server/index.js

@@ -14,8 +14,9 @@ import { Accordions, Accordion } from 'fumadocs-ui/components/accordion';
 import * as Base from 'fumadocs-ui/components/codeblock';
 import { highlight } from 'fumadocs-core/server';
 import { Root, API, APIInfo, APIExample as APIExample$1, Property, ObjectCollapsible, APIPlayground } from '../ui/index.js';
-import Parser from '@apidevtools/json-schema-ref-parser';
-import { upgrade } from '@scalar/openapi-parser';
+import { load, upgrade, dereference } from '@scalar/openapi-parser';
+import { fetchUrls } from '@scalar/openapi-parser/plugins/fetch-urls';
+import { readFiles } from '@scalar/openapi-parser/plugins/read-files';
 import { cva } from 'class-variance-authority';
 
 function getPreferredType(body) {
@@ -384,7 +385,7 @@ function toSchema(schema, required, ctx) {
         const additional = schema.additionalProperties;
         let additionalProperties;
         if (additional && typeof additional === 'object') {
-            if (!additional.type && !additional.anyOf && !additional.allOf && !additional.oneOf) {
+            if ((!additional.type || additional.type.length === 0) && !additional.anyOf && !additional.allOf && !additional.oneOf) {
                 additionalProperties = true;
             } else {
                 additionalProperties = getIdFromSchema(additional, false, ctx);
@@ -436,12 +437,11 @@ function toSchema(schema, required, ctx) {
                     items: 'items' in schema && schema.items ? toSchema(schema.items, false, ctx) : toSchema({}, required, ctx),
                     isRequired: required
                 };
-            } else if (type !== 'null' && type !== 'object') {
-                items[type] = {
-                    type: type === 'integer' ? 'number' : type,
-                    isRequired: required,
-                    defaultValue: schema.example ?? schema.default ?? ''
-                };
+            } else {
+                items[type] = toSchema({
+                    ...schema,
+                    type
+                }, true, ctx);
             }
         }
         return {
@@ -487,7 +487,6 @@ async function Markdown({ text }) {
         jsx: jsx,
         jsxs: jsxs,
         Fragment,
-        // @ts-expect-error -- safe to use
         components: defaultMdxComponents
     });
 }
@@ -1194,17 +1193,18 @@ const cache = new Map();
  */ async function processDocument(document, disableCache = false) {
     const cached = !disableCache && typeof document === 'string' ? cache.get(document) : null;
     if (cached) return cached;
-    let bundled = await Parser.bundle(document, {
-        mutateInputSchema: false
-    });
-    bundled = upgrade(bundled).specification;
     const dereferenceMap = new Map();
-    const dereferenced = await Parser.dereference(bundled, {
-        mutateInputSchema: true,
-        dereference: {
-            onDereference ($ref, schema) {
-                dereferenceMap.set(schema, $ref);
-            }
+    const loaded = await load(document, {
+        plugins: [
+            readFiles(),
+            fetchUrls()
+        ]
+    });
+    // upgrade
+    loaded.specification = upgrade(loaded.specification).specification;
+    const { schema: dereferenced } = await dereference(loaded.filesystem, {
+        onDereference ({ ref, schema }) {
+            dereferenceMap.set(schema, ref);
         }
     });
     const processed = {

package/dist/ui/{client-client-DKhozk64.js → client-client-DopF7PSu.js}

@@ -6,7 +6,7 @@ import dynamic from 'next/dynamic';
 import { useOnChange } from 'fumadocs-core/utils/use-on-change';
 
 /**
- * @license lucide-react v0.465.0 - ISC
+ * @license lucide-react v0.468.0 - ISC
  *
  * This source code is licensed under the ISC license.
  * See the LICENSE file in the root directory of this source tree.
@@ -16,7 +16,7 @@ const mergeClasses = (...classes)=>classes.filter((className, index, array)=>{
     }).join(" ").trim();
 
 /**
- * @license lucide-react v0.465.0 - ISC
+ * @license lucide-react v0.468.0 - ISC
  *
  * This source code is licensed under the ISC license.
  * See the LICENSE file in the root directory of this source tree.
@@ -253,7 +253,7 @@ function useSchemaContext() {
     return ctx;
 }
 
-const APIPlayground = dynamic(()=>import('./playground-client-VAkG3TMb.js').then((mod)=>mod.APIPlayground));
+const APIPlayground = dynamic(()=>import('./playground-client-HUgWUI95.js').then((mod)=>mod.APIPlayground));
 function Root({ children, baseUrl, className, shikiOptions, ...props }) {
     return /*#__PURE__*/ jsx("div", {
         className: cn('flex flex-col gap-24 text-sm text-fd-muted-foreground', className),

package/dist/ui/index.js

@@ -3,8 +3,8 @@ import { cn } from 'fumadocs-ui/components/api';
 import { Fragment } from 'react';
 import { Accordions, Accordion } from 'fumadocs-ui/components/accordion';
 import { cva } from 'class-variance-authority';
-import { f as CopyRouteButton, B as BaseUrlSelect } from './client-client-DKhozk64.js';
-export { A as APIPlayground, R as Root, u as useSchemaContext } from './client-client-DKhozk64.js';
+import { f as CopyRouteButton, B as BaseUrlSelect } from './client-client-DopF7PSu.js';
+export { A as APIPlayground, R as Root, u as useSchemaContext } from './client-client-DopF7PSu.js';
 
 const badgeVariants = cva('rounded-xl border px-1.5 py-1 text-xs font-medium leading-[12px]', {
     variants: {

package/dist/ui/{playground-client-VAkG3TMb.js → playground-client-HUgWUI95.js}

@@ -5,7 +5,7 @@ import { forwardRef, useId, createContext, useContext, useState, useCallback, us
 import { FormProvider, Controller, useFormContext, useFieldArray, useForm, useWatch } from 'react-hook-form';
 import { Accordions, Accordion } from 'fumadocs-ui/components/accordion';
 import { cn, buttonVariants } from 'fumadocs-ui/components/api';
-import { C as CircleCheck, a as CircleX, b as ChevronDown, c as ChevronUp, d as Check, u as useSchemaContext, T as Trash2, P as Plus, e as useApiContext, S as SchemaContext } from './client-client-DKhozk64.js';
+import { C as CircleCheck, a as CircleX, b as ChevronDown, c as ChevronUp, d as Check, u as useSchemaContext, T as Trash2, P as Plus, e as useApiContext, S as SchemaContext } from './client-client-DopF7PSu.js';
 import { Slot } from '@radix-ui/react-slot';
 import { cva } from 'class-variance-authority';
 import { useOnChange } from 'fumadocs-core/utils/use-on-change';
@@ -248,7 +248,11 @@ function getDefaultValue(item, references) {
         ]));
     if (item.type === 'array') return [];
     if (item.type === 'null') return null;
-    if (item.type === 'switcher') return getDefaultValue(resolve(Object.values(item.items)[0], references), references);
+    if (item.type === 'switcher') {
+        const first = Object.values(item.items).at(0);
+        if (!first) return '';
+        return getDefaultValue(resolve(first, references), references);
+    }
     if (item.type === 'file') return undefined;
     return String(item.defaultValue);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "5.8.1",
+  "version": "5.9.0",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -31,40 +31,40 @@
     "dist"
   ],
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^11.7.2",
     "@fumari/json-schema-to-typescript": "^1.1.2",
-    "@radix-ui/react-select": "^2.1.2",
-    "@radix-ui/react-slot": "^1.1.0",
-    "@scalar/openapi-parser": "^0.8.10",
+    "@radix-ui/react-select": "^2.1.3",
+    "@radix-ui/react-slot": "^1.1.1",
+    "@scalar/openapi-parser": "0.10.0",
+    "ajv-draft-04": "^1.0.0",
     "class-variance-authority": "^0.7.1",
     "fast-glob": "^3.3.1",
     "github-slugger": "^2.0.0",
     "hast-util-to-jsx-runtime": "^2.3.2",
     "js-yaml": "^4.1.0",
     "openapi-sampler": "^1.6.1",
-    "react-hook-form": "^7.53.2",
+    "react-hook-form": "^7.54.1",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.1",
-    "shiki": "^1.24.0",
-    "fumadocs-core": "14.5.6",
-    "fumadocs-ui": "14.5.6"
+    "shiki": "^1.24.2",
+    "fumadocs-ui": "14.6.1",
+    "fumadocs-core": "14.6.1"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "22.10.1",
+    "@types/node": "22.10.2",
     "@types/openapi-sampler": "^1.0.3",
-    "@types/react": "^18.3.12",
-    "bunchee": "^6.0.0",
-    "lucide-react": "^0.465.0",
-    "next": "15.0.3",
+    "@types/react": "^19.0.1",
+    "bunchee": "^6.0.3",
+    "lucide-react": "^0.468.0",
+    "next": "15.1.0",
     "openapi-types": "^12.1.3",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "next": "14.x.x || 15.x.x",
-    "react": ">= 18",
-    "react-dom": ">= 18"
+    "react": "18.x.x || 19.x.x",
+    "react-dom": "18.x.x || 19.x.x"
   },
   "publishConfig": {
     "access": "public"