fumadocs-openapi 9.3.7 → 9.3.9

package/dist/generate-file.d.ts

@@ -29,7 +29,7 @@ interface OperationConfig extends BaseConfig {
     /**
      * Specify name for output file
      */
-    name?: ((output: GeneratePageOutput, document: ProcessedDocument['document']) => string) | BaseName;
+    name?: ((output: GeneratePageOutput, document: ProcessedDocument['dereferenced']) => string) | BaseName;
 }
 interface TagConfig extends BaseConfig {
     /**
@@ -39,7 +39,7 @@ interface TagConfig extends BaseConfig {
     /**
      * Specify name for output file
      */
-    name?: ((output: GenerateTagOutput, document: ProcessedDocument['document']) => string) | BaseName;
+    name?: ((output: GenerateTagOutput, document: ProcessedDocument['dereferenced']) => string) | BaseName;
 }
 interface FileConfig extends BaseConfig {
     /**
@@ -49,7 +49,7 @@ interface FileConfig extends BaseConfig {
     /**
      * Specify name for output file
      */
-    name?: ((output: GenerateFileOutput, document: ProcessedDocument['document']) => string) | BaseName;
+    name?: ((output: GenerateFileOutput, document: ProcessedDocument['dereferenced']) => string) | BaseName;
 }
 export type Config = FileConfig | TagConfig | OperationConfig;
 interface BaseName {

package/dist/generate-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-file.d.ts","sourceRoot":"","sources":["../src/generate-file.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generate-file.d.ts","sourceRoot":"","sources":["../src/generate-file.ts"],"names":[],"mappings":"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"}

package/dist/generate-file.js

@@ -66,7 +66,7 @@ export async function generateFilesOnly(options) {
 }
 function generateFromDocument(schemaId, processed, options) {
     const files = [];
-    const { document } = processed;
+    const { dereferenced } = processed;
     const { output, cwd = process.cwd(), slugify = defaultSlugify } = options;
     const outputDir = path.join(cwd, output);
     let nameFn;
@@ -83,11 +83,11 @@ function generateFromDocument(schemaId, processed, options) {
                 path.join(getOutputPathFromRoute(result.type === 'operation' ? result.item.path : result.item.name), `${result.item.method.toLowerCase()}.mdx`),
             ];
         }
-        const file = nameFn(result, document);
+        const file = nameFn(result, dereferenced);
         if (groupBy === 'tag') {
             let tags = result.type === 'operation'
-                ? document.paths[result.item.path][result.item.method].tags
-                : document.webhooks[result.item.name][result.item.method].tags;
+                ? dereferenced.paths[result.item.path][result.item.method].tags
+                : dereferenced.webhooks[result.item.name][result.item.method].tags;
             if (!tags || tags.length === 0) {
                 console.warn('When `groupBy` is set to `tag`, make sure a `tags` is defined for every operation schema.');
                 tags = ['unknown'];
@@ -101,7 +101,7 @@ function generateFromDocument(schemaId, processed, options) {
         const filename = nameFn({
             pathOrUrl: schemaId,
             content: result,
-        }, document);
+        }, dereferenced);
         files.push({
             path: path.join(outputDir, `${filename}.mdx`),
             content: result,
@@ -111,7 +111,7 @@ function generateFromDocument(schemaId, processed, options) {
     if (options.per === 'tag') {
         const results = generateTags(schemaId, processed, options);
         for (const result of results) {
-            const filename = nameFn(result, document);
+            const filename = nameFn(result, dereferenced);
             files.push({
                 path: path.join(outputDir, `${filename}.mdx`),
                 content: result.content,

package/dist/generate.js

@@ -4,26 +4,26 @@ import { dump } from 'js-yaml';
 import Slugger from 'github-slugger';
 import { removeUndefined } from './utils/remove-undefined.js';
 export function generateAll(schemaId, processed, options = {}) {
-    const { document } = processed;
-    const items = getAPIPageItems(document);
+    const { dereferenced } = processed;
+    const items = getAPIPageItems(dereferenced);
     return generatePage(schemaId, processed, {
         operations: items.operations,
         webhooks: items.webhooks,
         hasHead: true,
     }, {
         ...options,
-        title: document.info.title,
-        description: document.info.description,
+        title: dereferenced.info.title,
+        description: dereferenced.info.description,
     }, {
         type: 'file',
     });
 }
 export function generatePages(schemaId, processed, options = {}) {
-    const { document } = processed;
-    const items = getAPIPageItems(document);
+    const { dereferenced } = processed;
+    const items = getAPIPageItems(dereferenced);
     const result = [];
     for (const item of items.operations) {
-        const pathItem = document.paths?.[item.path];
+        const pathItem = dereferenced.paths?.[item.path];
         if (!pathItem)
             continue;
         const operation = pathItem[item.method];
@@ -47,7 +47,7 @@ export function generatePages(schemaId, processed, options = {}) {
         });
     }
     for (const item of items.webhooks) {
-        const pathItem = document.webhooks?.[item.name];
+        const pathItem = dereferenced.webhooks?.[item.name];
         if (!pathItem)
             continue;
         const operation = pathItem[item.method];
@@ -71,11 +71,11 @@ export function generatePages(schemaId, processed, options = {}) {
     return result;
 }
 export function generateTags(schemaId, processed, options = {}) {
-    const { document } = processed;
-    if (!document.tags)
+    const { dereferenced } = processed;
+    if (!dereferenced.tags)
         return [];
-    const items = getAPIPageItems(document);
-    return document.tags.map((tag) => {
+    const items = getAPIPageItems(dereferenced);
+    return dereferenced.tags.map((tag) => {
         const webhooks = items.webhooks.filter((v) => v.tags && v.tags.includes(tag.name));
         const operations = items.operations.filter((v) => v.tags && v.tags.includes(tag.name));
         const displayName = tag && 'x-displayName' in tag && typeof tag['x-displayName'] === 'string'
@@ -135,7 +135,7 @@ function generatePage(schemaId, processed, pageProps, options, context) {
             route: operation.path,
         };
     }
-    const data = generateStaticData(processed.document, page);
+    const data = generateStaticData(processed.dereferenced, page);
     const content = [];
     if (options.description && includeDescription)
         content.push(options.description);

package/dist/playground/client.js

@@ -315,8 +315,7 @@ function renderCustomField(fieldName, info, field, key) {
         render: (props) => field.render({ ...props, info }), name: fieldName }, key));
 }
 function Route({ route, ...props }) {
-    const segments = route.split('/').filter((part) => part.length > 0);
-    return (_jsx("div", { ...props, className: cn('flex flex-row items-center gap-0.5 overflow-auto text-nowrap', props.className), children: segments.map((part, index) => (_jsxs(Fragment, { children: [_jsx("span", { className: "text-fd-muted-foreground", children: "/" }), part.startsWith('{') && part.endsWith('}') ? (_jsx("code", { className: "bg-fd-primary/10 text-fd-primary", children: part })) : (_jsx("code", { className: "text-fd-foreground", children: part }))] }, index))) }));
+    return (_jsx("div", { ...props, className: cn('flex flex-row items-center gap-0.5 overflow-auto text-nowrap', props.className), children: route.split('/').map((part, index) => (_jsxs(Fragment, { children: [index > 0 && _jsx("span", { className: "text-fd-muted-foreground", children: "/" }), part.startsWith('{') && part.endsWith('}') ? (_jsx("code", { className: "bg-fd-primary/10 text-fd-primary", children: part })) : (_jsx("code", { className: "text-fd-foreground", children: part }))] }, index))) }));
 }
 function DefaultResultDisplay({ data }) {
     const statusInfo = useMemo(() => getStatusInfo(data.status), [data.status]);

package/dist/playground/index.js

@@ -67,15 +67,15 @@ function writeReferences(schema, ctx, stack = new WeakMap()) {
     }
     return output;
 }
-function parseSecurities(method, { schema: { document } }) {
+function parseSecurities(method, { schema: { dereferenced } }) {
     const result = [];
-    const security = method.security ?? document.security ?? [];
+    const security = method.security ?? dereferenced.security ?? [];
     if (security.length === 0)
         return result;
     for (const map of security) {
         const list = [];
         for (const [key, scopes] of Object.entries(map)) {
-            const scheme = document.components?.securitySchemes?.[key];
+            const scheme = dereferenced.components?.securitySchemes?.[key];
             if (!scheme)
                 continue;
             list.push({

package/dist/render/api-page.js

@@ -11,9 +11,9 @@ export async function APIPage(props) {
         ? await processDocumentCached(props.document)
         : await props.document;
     const ctx = await getContext(processed, props);
-    const { document } = processed;
+    const { dereferenced } = processed;
     return (_jsxs(ctx.renderer.Root, { ctx: ctx, children: [operations?.map((item) => {
-                const pathItem = document.paths?.[item.path];
+                const pathItem = dereferenced.paths?.[item.path];
                 if (!pathItem)
                     throw new Error(`[Fumadocs OpenAPI] Path not found in OpenAPI schema: ${item.path}`);
                 const operation = pathItem[item.method];
@@ -22,7 +22,7 @@ export async function APIPage(props) {
                 const method = createMethod(item.method, pathItem, operation);
                 return (_jsx(Operation, { method: method, path: item.path, ctx: ctx, hasHead: hasHead }, `${item.path}:${item.method}`));
             }), webhooks?.map((item) => {
-                const webhook = document.webhooks?.[item.name];
+                const webhook = dereferenced.webhooks?.[item.name];
                 if (!webhook)
                     throw new Error(`[Fumadocs OpenAPI] Webhook not found in OpenAPI schema: ${item.name}`);
                 const hook = webhook[item.method];
@@ -33,7 +33,7 @@ export async function APIPage(props) {
             })] }));
 }
 export async function getContext(schema, options = {}) {
-    const document = schema.document;
+    const document = schema.dereferenced;
     const servers = document.servers && document.servers.length > 0
         ? document.servers
         : [{ url: '/' }];

package/dist/render/operation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/operation/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAEV,iBAAiB,EACjB,aAAa,EAEd,MAAM,SAAS,CAAC;AAcjB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAY1D,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,CAAC;CACnB;AASD,wBAAgB,SAAS,CAAC,EACxB,IAAkB,EAClB,IAAI,EACJ,MAAM,EACN,GAAG,EACH,OAAO,EACP,YAAgB,GACjB,EAAE;IACD,IAAI,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,aAAa,CAAC;IAEnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,YAAY,CAgNf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/operation/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAEV,iBAAiB,EACjB,aAAa,EAEd,MAAM,SAAS,CAAC;AAcjB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAY1D,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,CAAC;CACnB;AASD,wBAAgB,SAAS,CAAC,EACxB,IAAkB,EAClB,IAAI,EACJ,MAAM,EACN,GAAG,EACH,OAAO,EACP,YAAgB,GACjB,EAAE;IACD,IAAI,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,aAAa,CAAC;IAEnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,YAAY,CAiNf"}

package/dist/render/operation/index.js

@@ -19,6 +19,7 @@ const ParamTypes = {
     cookie: 'Cookie Parameters',
 };
 export function Operation({ type = 'operation', path, method, ctx, hasHead, headingLevel = 2, }) {
+    const { schema: { dereferenced }, } = ctx;
     const body = method.requestBody;
     let headNode = null;
     let bodyNode = null;
@@ -55,11 +56,9 @@ export function Operation({ type = 'operation', path, method, ctx, hasHead, head
                                 (param.schema?.deprecated ?? false),
                         }, required: param.required, readOnly: method.method === 'GET', writeOnly: method.method !== 'GET', ctx: ctx }, param.name))) })] }, type));
     });
-    const securities = (method.security ??
-        ctx.schema.document.security ??
-        []).filter((v) => Object.keys(v).length > 0);
+    const securities = (method.security ?? dereferenced.security ?? []).filter((v) => Object.keys(v).length > 0);
     if (type === 'operation' && securities.length > 0) {
-        const securitySchemes = ctx.schema.document.components?.securitySchemes;
+        const securitySchemes = dereferenced.components?.securitySchemes;
         const names = securities.map((security) => Object.keys(security).join(' & '));
         authNode = (_jsxs(SelectTabs, { defaultValue: names[0], children: [_jsxs("div", { className: "flex items-end justify-between gap-2", children: [heading(headingLevel, 'Authorization', ctx), _jsx(SelectTabTrigger, { items: names, className: "mb-4" })] }), securities.map((security, i) => (_jsx(SelectTab, { value: names[i], children: Object.entries(security).map(([key, scopes]) => {
                         const scheme = securitySchemes?.[key];
@@ -83,7 +82,7 @@ export function Operation({ type = 'operation', path, method, ctx, hasHead, head
 }
 async function ResponseAccordion({ status, operation, ctx, }) {
     const response = operation.responses[status];
-    const { generateTypeScriptSchema, schema: { dereferenceMap }, } = ctx;
+    const { generateTypeScriptSchema } = ctx;
     const contentTypes = response.content
         ? Object.entries(response.content)
         : null;
@@ -94,7 +93,7 @@ async function ResponseAccordion({ status, operation, ctx, }) {
                             ts = await generateTypeScriptSchema(operation, status);
                         }
                         else if (generateTypeScriptSchema === undefined && schema) {
-                            ts = await getTypescriptSchema(schema, dereferenceMap);
+                            ts = await getTypescriptSchema(ctx.schema);
                         }
                         return (_jsxs(SelectTab, { value: type, className: "my-2", children: [ts && _jsx(CopyResponseTypeScript, { code: ts }), schema && (_jsx("div", { className: "border px-3 py-2 rounded-lg overflow-auto max-h-[400px]", children: _jsx(Schema, { name: "response", schema: schema, as: "body", readOnly: true, ctx: ctx }) }))] }, type));
                     })] })] }));

package/dist/render/schema.js

@@ -165,7 +165,9 @@ function schemaStack(renderContext, parent) {
     function getId(schema) {
         if (typeof schema !== 'object')
             return;
-        return schema.title ?? renderContext.schema.dereferenceMap.get(schema);
+        if (schema.title)
+            return schema.title;
+        return renderContext.schema.getRawRef(schema);
     }
     return {
         history: parent ? [...parent.history] : [],

package/dist/scalar/index.js

@@ -2,5 +2,5 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { lazy } from 'react';
 const Client = lazy(() => import('./client.js'));
 export function APIPlayground({ path, method, ctx, }) {
-    return (_jsx(Client, { method: method.method, path: path, spec: ctx.schema.downloaded }));
+    return (_jsx(Client, { method: method.method, path: path, spec: ctx.schema.bundled }));
 }

package/dist/server/create.d.ts

@@ -3,7 +3,7 @@ import { createProxy } from '../server/proxy.js';
 import type { CodeSample } from '../render/operation/index.js';
 import type { Renderer } from '../render/renderer.js';
 import type { NoReference } from '../utils/schema.js';
-import type { BuiltinTheme, CodeOptionsThemes, CodeToHastOptionsCommon } from 'shiki';
+import type { HighlightOptionsCommon, HighlightOptionsThemes } from 'fumadocs-core/highlight';
 import type { MediaAdapter } from '../media/adapter.js';
 import type { MethodInformation } from '../types.js';
 import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
@@ -39,7 +39,7 @@ export interface SharedOpenAPIOptions {
      * Generate code samples for endpoint.
      */
     generateCodeSamples?: (method: MethodInformation) => Awaitable<CodeSample[]>;
-    shikiOptions?: Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BuiltinTheme>;
+    shikiOptions?: Omit<HighlightOptionsCommon, 'lang' | 'components'> & HighlightOptionsThemes;
     /**
      * Show full response schema instead of only example response & Typescript definitions
      *

package/dist/server/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/server/create.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACnC;;GAEG;AACH,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC3E,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE7B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;;OAOG;IACH,wBAAwB,CAAC,EACrB,CAAC,CACC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,EACtC,UAAU,EAAE,MAAM,KACf,SAAS,CAAC,MAAM,CAAC,CAAC,GACvB,KAAK,CAAC;IAEV;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7E,YAAY,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,CAAC,GAClD,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAElC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAE9C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,YAAY,CAAC;IACtD,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,UAAU,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/C;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CA4CzE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAEtE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/server/create.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACnC;;GAEG;AACH,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC3E,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE7B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;;OAOG;IACH,wBAAwB,CAAC,EACrB,CAAC,CACC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,EACtC,UAAU,EAAE,MAAM,KACf,SAAS,CAAC,MAAM,CAAC,CAAC,GACvB,KAAK,CAAC;IAEV;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7E,YAAY,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,YAAY,CAAC,GAChE,sBAAsB,CAAC;IAEzB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAE9C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,YAAY,CAAC;IACtD,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,UAAU,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/C;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CA4CzE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAEtE"}

package/dist/types.d.ts

@@ -19,10 +19,6 @@ export type ServerVariableObject = NoReference<V3_1.ServerVariableObject>;
 export type MethodInformation = NoReference<OperationObject> & {
     method: string;
 };
-/**
- * Dereferenced value and its original `$ref` value
- */
-export type DereferenceMap = Map<unknown, string>;
 export interface RenderContext extends SharedOpenAPIOptions {
     renderer: Renderer;
     servers: ServerObject[];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,yBAAyB,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;AACjD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;AACvC,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAE1E,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,yBAAyB,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;AACjD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;AACvC,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAE1E,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C"}

package/dist/utils/get-typescript-schema.d.ts

@@ -1,3 +1,3 @@
-import type { DereferenceMap } from '../types.js';
-export declare function getTypescriptSchema(schema: object, dereferenceMap: DereferenceMap): Promise<string | undefined>;
+import type { ProcessedDocument } from '../utils/process-document.js';
+export declare function getTypescriptSchema(processed: ProcessedDocument): Promise<string | undefined>;
 //# sourceMappingURL=get-typescript-schema.d.ts.map

package/dist/utils/get-typescript-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-typescript-schema.d.ts","sourceRoot":"","sources":["../../src/utils/get-typescript-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAa7B"}
+{"version":3,"file":"get-typescript-schema.d.ts","sourceRoot":"","sources":["../../src/utils/get-typescript-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B"}

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

@@ -1,10 +1,9 @@
 import { compile } from '@fumari/json-schema-to-typescript';
-export async function getTypescriptSchema(schema, dereferenceMap) {
+export async function getTypescriptSchema(processed) {
     try {
-        const cloned = structuredClone({ schema, dereferenceMap });
-        return await compile(cloned.schema, 'Response', {
+        const cloned = structuredClone(processed.bundled);
+        return await compile(cloned, 'Response', {
             $refOptions: false,
-            schemaToId: cloned.dereferenceMap,
             bannerComment: '',
             additionalProperties: false,
             enableConstEnums: false,

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

@@ -1,10 +1,16 @@
-import type { DereferenceMap, Document } from '../types.js';
+import type { Document } from '../types.js';
 import type { NoReference } from '../utils/schema.js';
 import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
 export type ProcessedDocument = {
-    document: NoReference<Document>;
-    dereferenceMap: DereferenceMap;
-    downloaded: Document;
+    /**
+     * dereferenced document
+     */
+    dereferenced: NoReference<Document>;
+    /**
+     * Get raw object from dereference object
+     */
+    getRawRef: (obj: object) => string | undefined;
+    bundled: Document;
 };
 export declare function processDocumentCached(input: string | OpenAPIV3_1.Document | OpenAPIV3.Document): Promise<ProcessedDocument>;
 /**

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;AAI5D,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,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GACxD,OAAO,CAAC,iBAAiB,CAAC,CAS5B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GACxD,OAAO,CAAC,iBAAiB,CAAC,CAoB5B"}
+{"version":3,"file":"process-document.d.ts","sourceRoot":"","sources":["../../src/utils/process-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5D,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,YAAY,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEpC;;OAEG;IACH,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAE/C,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAIF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GACxD,OAAO,CAAC,iBAAiB,CAAC,CAS5B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GACxD,OAAO,CAAC,iBAAiB,CAAC,CA+B5B"}

package/dist/utils/process-document.js

@@ -1,5 +1,6 @@
-import { bundle, dereference, upgrade } from '@scalar/openapi-parser';
-import { fetchUrls, readFiles } from '@scalar/openapi-parser/plugins';
+import { dereference, upgrade } from '@scalar/openapi-parser';
+import { bundle } from '@scalar/json-magic/bundle';
+import { fetchUrls, readFiles } from '@scalar/json-magic/bundle/plugins/node';
 const cache = new Map();
 export async function processDocumentCached(input) {
     if (typeof input !== 'string')
@@ -15,21 +16,30 @@ export async function processDocumentCached(input) {
  * process & reference input document to a Fumadocs OpenAPI compatible format
  */
 export async function processDocument(input) {
-    const dereferenceMap = new Map();
-    let document = await bundle(input, {
+    const document = await bundle(input, {
         plugins: [fetchUrls(), readFiles()],
-        treeShake: false,
-    });
-    // upgrade
-    document = upgrade(document).specification;
-    const { schema: dereferenced } = await dereference(document, {
-        onDereference({ ref, schema }) {
-            dereferenceMap.set(schema, ref);
+        treeShake: true,
+        urlMap: true,
+        hooks: {
+            onResolveError(node) {
+                throw new Error(`Failed to resolve ${node.$ref}`);
+            },
         },
-    });
+    }).then((v) => upgrade(v).specification);
+    /**
+     * Dereferenced value and its original `$ref` value
+     */
+    const dereferenceMap = new WeakMap();
     return {
-        document: dereferenced,
-        dereferenceMap,
-        downloaded: document,
+        dereferenced: (await dereference(document, {
+            throwOnError: true,
+            onDereference({ schema, ref }) {
+                dereferenceMap.set(schema, ref);
+            },
+        })).schema,
+        getRawRef(obj) {
+            return dereferenceMap.get(obj);
+        },
+        bundled: document,
     };
 }

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

@@ -21,9 +21,9 @@ export function schemaToString(value, ctx) {
             return 'never';
         if (schema.title)
             return schema.title;
-        const referenceName = ctx?.dereferenceMap.get(schema);
-        if (referenceName)
-            return referenceName.split('/').at(-1);
+        const rawRef = ctx?.getRawRef(schema);
+        if (rawRef)
+            return rawRef.split('/').at(-1);
         if (Array.isArray(schema.type)) {
             const members = new Set();
             const types = schema.type;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "9.3.7",
+  "version": "9.3.9",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -50,7 +50,8 @@
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-slot": "^1.2.3",
-    "@scalar/openapi-parser": "0.18.3",
+    "@scalar/json-magic": "^0.4.2",
+    "@scalar/openapi-parser": "0.20.5",
     "ajv": "^8.17.1",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
@@ -62,18 +63,17 @@
     "react-hook-form": "^7.62.0",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
-    "shiki": "^3.12.2",
-    "tinyglobby": "^0.2.14",
+    "tinyglobby": "^0.2.15",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "15.7.10",
-    "fumadocs-ui": "15.7.10"
+    "fumadocs-core": "15.7.12",
+    "fumadocs-ui": "15.7.12"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^1.3.31",
+    "@scalar/api-client-react": "^1.3.37",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "24.3.1",
+    "@types/node": "24.3.3",
     "@types/openapi-sampler": "^1.0.3",
-    "@types/react": "^19.1.12",
+    "@types/react": "^19.1.13",
     "json-schema-typed": "^8.0.1",
     "openapi-types": "^12.1.3",
     "tailwindcss": "^4.1.13",