fumadocs-openapi 9.1.12 → 9.2.0

package/dist/generate-file.d.ts

@@ -1,5 +1,6 @@
 import { type GenerateOptions, type GeneratePageOutput, type GenerateTagOutput } from './generate.js';
 import { type ProcessedDocument } from './utils/process-document.js';
+import type { OpenAPIServer } from './server/index.js';
 interface GenerateFileOutput {
     /**
      * The original schema file path/url from `input`
@@ -60,9 +61,9 @@ interface BaseName {
 }
 interface BaseConfig extends GenerateOptions {
     /**
-     * Schema files
+     * Schema files, or the OpenAPI server object
      */
-    input: string[] | string;
+    input: string[] | string | OpenAPIServer;
     /**
      * Output directory
      */

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

@@ -1 +1 @@
-{"version":3,"file":"generate-file.d.ts","sourceRoot":"","sources":["../src/generate-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,UAAU,kBAAkB;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,eAAgB,SAAQ,UAAU;IAC1C;;OAEG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAElB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EACD,CAAC,CACC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,KACpC,MAAM,CAAC,GACZ,QAAQ,CAAC;CACd;AAED,UAAU,SAAU,SAAQ,UAAU;IACpC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC;IAEX;;OAEG;IACH,IAAI,CAAC,EACD,CAAC,CACC,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,KACpC,MAAM,CAAC,GACZ,QAAQ,CAAC;CACd;AAED,UAAU,UAAW,SAAQ,UAAU;IACrC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EACD,CAAC,CACC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,KACpC,MAAM,CAAC,GACZ,QAAQ,CAAC;CACd;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,eAAe,CAAC;AAE9D,UAAU,QAAQ;IAChB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAED,UAAU,UAAW,SAAQ,eAAe;IAC1C;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BlE"}
+{"version":3,"file":"generate-file.d.ts","sourceRoot":"","sources":["../src/generate-file.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,UAAU,kBAAkB;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,eAAgB,SAAQ,UAAU;IAC1C;;OAEG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAElB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EACD,CAAC,CACC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,KACpC,MAAM,CAAC,GACZ,QAAQ,CAAC;CACd;AAED,UAAU,SAAU,SAAQ,UAAU;IACpC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC;IAEX;;OAEG;IACH,IAAI,CAAC,EACD,CAAC,CACC,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,KACpC,MAAM,CAAC,GACZ,QAAQ,CAAC;CACd;AAED,UAAU,UAAW,SAAQ,UAAU;IACrC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EACD,CAAC,CACC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,KACpC,MAAM,CAAC,GACZ,QAAQ,CAAC;CACd;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,eAAe,CAAC;AAE9D,UAAU,QAAQ;IAChB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAED,UAAU,UAAW,SAAQ,eAAe;IAC1C;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,aAAa,CAAC;IAEzC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqClE"}

package/dist/generate-file.js

@@ -1,32 +1,38 @@
 import { mkdir, writeFile } from 'node:fs/promises';
 import * as path from 'node:path';
-import { resolve } from 'node:path';
 import { glob } from 'tinyglobby';
 import { generateAll, generatePages, generateTags, } from './generate.js';
 import { processDocument, } from './utils/process-document.js';
 export async function generateFiles(options) {
-    const { input, cwd = process.cwd() } = options;
-    const urlInputs = [];
-    const fileInputs = [];
-    for (const v of typeof input === 'string' ? [input] : input) {
-        if (isUrl(v)) {
-            urlInputs.push(v);
-        }
-        else {
-            fileInputs.push(v);
+    const { cwd = process.cwd() } = options;
+    const input = typeof options.input === 'string' ? [options.input] : options.input;
+    let schemas = {};
+    if (Array.isArray(input)) {
+        const targets = [];
+        for (const item of input) {
+            if (isUrl(item)) {
+                targets.push(item);
+            }
+            else {
+                targets.push(...(await glob(item, { cwd, absolute: true })));
+            }
         }
+        await Promise.all(targets.map(async (item) => {
+            schemas[item] = await processDocument(item);
+        }));
+    }
+    else {
+        schemas = await input.getSchemas();
     }
-    const resolvedInputs = [
-        ...(await glob(fileInputs, { cwd, absolute: false })),
-        ...urlInputs,
-    ];
-    if (resolvedInputs.length === 0) {
-        throw new Error(`No input files found. Tried resolving: ${typeof input === 'string' ? input : input.join(', ')}`);
+    const resolvedSchemas = Object.entries(schemas);
+    if (resolvedSchemas.length === 0) {
+        throw new Error('No input files found.');
     }
-    await Promise.all(resolvedInputs.map((input) => generateFromDocument(input, options)));
+    await Promise.all(resolvedSchemas.map(([id, document]) => generateFromDocument(id, document, options)));
 }
-async function generateFromDocument(pathOrUrl, options) {
+async function generateFromDocument(schemaId, document, options) {
     const { output, cwd = process.cwd(), slugify = defaultSlugify } = options;
+    const outputDir = path.join(cwd, output);
     let nameFn;
     if (!options.name || typeof options.name !== 'function') {
         const { algorithm = 'v2' } = options.name ?? {};
@@ -36,9 +42,9 @@ async function generateFromDocument(pathOrUrl, options) {
                 return slugify(result.tag);
             }
             if (options.per === 'file') {
-                return isUrl(pathOrUrl)
+                return isUrl(schemaId)
                     ? 'index'
-                    : path.basename(pathOrUrl, path.extname(pathOrUrl));
+                    : path.basename(schemaId, path.extname(schemaId));
             }
             const result = output;
             if (result.type === 'operation') {
@@ -58,8 +64,6 @@ async function generateFromDocument(pathOrUrl, options) {
     else {
         nameFn = options.name;
     }
-    const document = await dereference(pathOrUrl, options);
-    const outputDir = path.join(cwd, output);
     async function write(file, content) {
         await mkdir(path.dirname(file), { recursive: true });
         await writeFile(file, content);
@@ -86,9 +90,9 @@ async function generateFromDocument(pathOrUrl, options) {
         return [`${file}.mdx`];
     }
     if (options.per === 'file') {
-        const result = await generateAll(pathOrUrl, document, options);
+        const result = await generateAll(schemaId, document, options);
         const filename = nameFn({
-            pathOrUrl,
+            pathOrUrl: schemaId,
             content: result,
         }, document.document);
         const outPath = path.join(outputDir, `${filename}.mdx`);
@@ -96,7 +100,7 @@ async function generateFromDocument(pathOrUrl, options) {
         console.log(`Generated: ${outPath}`);
     }
     else if (options.per === 'tag') {
-        const results = await generateTags(pathOrUrl, document, options);
+        const results = await generateTags(schemaId, document, options);
         for (const result of results) {
             const filename = nameFn(result, document.document);
             const outPath = path.join(outputDir, `${filename}.mdx`);
@@ -105,7 +109,7 @@ async function generateFromDocument(pathOrUrl, options) {
         }
     }
     else {
-        const results = await generatePages(pathOrUrl, document, options);
+        const results = await generatePages(schemaId, document, options);
         const mapping = new Map();
         for (const result of results) {
             for (const outputPath of getOutputPaths(options.groupBy, result)) {
@@ -145,12 +149,3 @@ function getOutputPathFromRoute(path) {
 function defaultSlugify(s) {
     return s.replace(/\s+/g, '-').toLowerCase();
 }
-async function dereference(pathOrDocument, options) {
-    return processDocument(
-    // resolve paths
-    typeof pathOrDocument === 'string' &&
-        !pathOrDocument.startsWith('http://') &&
-        !pathOrDocument.startsWith('https://')
-        ? resolve(options.cwd ?? process.cwd(), pathOrDocument)
-        : pathOrDocument);
-}

package/dist/generate.d.ts

@@ -1,6 +1,6 @@
 import { type DocumentContext } from './utils/generate-document.js';
 import type { OperationItem, WebhookItem } from './render/api-page.js';
-import type { DocumentInput, ProcessedDocument } from './utils/process-document.js';
+import type { ProcessedDocument } from './utils/process-document.js';
 export interface GenerateOptions {
     /**
      * Additional imports of your MDX components.
@@ -36,6 +36,7 @@ export interface GenerateOptions {
     /**
      * Inline the entire OpenAPI document into the MDX file.
      *
+     * @deprecated Use the new `input` API on `createOpenAPI()` instead.
      * @defaultValue false
      */
     inlineDocument?: boolean;
@@ -53,7 +54,7 @@ export type GeneratePageOutput = {
     item: WebhookItem;
     content: string;
 };
-export declare function generateAll(input: DocumentInput, processed: ProcessedDocument, options?: GenerateOptions): Promise<string>;
-export declare function generatePages(input: DocumentInput, processed: ProcessedDocument, options?: GenerateOptions): Promise<GeneratePageOutput[]>;
-export declare function generateTags(input: DocumentInput, processed: ProcessedDocument, options?: GenerateOptions): Promise<GenerateTagOutput[]>;
+export declare function generateAll(schemaId: string, processed: ProcessedDocument, options?: GenerateOptions): Promise<string>;
+export declare function generatePages(schemaId: string, processed: ProcessedDocument, options?: GenerateOptions): Promise<GeneratePageOutput[]>;
+export declare function generateTags(schemaId: string, processed: ProcessedDocument, options?: GenerateOptions): Promise<GenerateTagOutput[]>;
 //# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IAEJ;;;;OAIG;IACH,WAAW,CAAC,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,eAAe,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEvC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAsB,WAAW,CAC/B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiE/B;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwC9B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IAEJ;;;;OAIG;IACH,WAAW,CAAC,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,eAAe,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEvC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiE/B;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwC9B"}

package/dist/generate.js

@@ -1,10 +1,10 @@
 import { getAPIPageItems } from './build-routes.js';
 import { generateDocument, } from './utils/generate-document.js';
 import { idToTitle } from './utils/id-to-title.js';
-export async function generateAll(input, processed, options = {}) {
+export async function generateAll(schemaId, processed, options = {}) {
     const { document } = processed;
     const items = getAPIPageItems(document);
-    return generateDocument(input, processed, {
+    return generateDocument(schemaId, processed, {
         operations: items.operations,
         webhooks: items.webhooks,
         hasHead: true,
@@ -16,7 +16,7 @@ export async function generateAll(input, processed, options = {}) {
         type: 'file',
     });
 }
-export async function generatePages(input, processed, options = {}) {
+export async function generatePages(schemaId, processed, options = {}) {
     const { document } = processed;
     const items = getAPIPageItems(document);
     const result = [];
@@ -30,7 +30,7 @@ export async function generatePages(input, processed, options = {}) {
         result.push({
             type: 'operation',
             item,
-            content: generateDocument(input, processed, {
+            content: generateDocument(schemaId, processed, {
                 operations: [item],
                 hasHead: false,
             }, {
@@ -54,7 +54,7 @@ export async function generatePages(input, processed, options = {}) {
         result.push({
             type: 'webhook',
             item,
-            content: generateDocument(input, processed, {
+            content: generateDocument(schemaId, processed, {
                 webhooks: [item],
                 hasHead: false,
             }, {
@@ -68,7 +68,7 @@ export async function generatePages(input, processed, options = {}) {
     }
     return result;
 }
-export async function generateTags(input, processed, options = {}) {
+export async function generateTags(schemaId, processed, options = {}) {
     const { document } = processed;
     if (!document.tags)
         return [];
@@ -81,7 +81,7 @@ export async function generateTags(input, processed, options = {}) {
             : idToTitle(tag.name);
         return {
             tag: tag.name,
-            content: generateDocument(input, processed, {
+            content: generateDocument(schemaId, processed, {
                 operations,
                 webhooks,
                 hasHead: true,

package/dist/render/api-page.d.ts

@@ -1,21 +1,15 @@
 import type { RenderContext } from '../types.js';
-import { type Renderer } from '../render/renderer.js';
 import type { OpenAPIV3_1 } from 'openapi-types';
-import { type DocumentInput, type ProcessedDocument } from '../utils/process-document.js';
-type ApiPageContextProps = Pick<Partial<RenderContext>, 'shikiOptions' | 'generateTypeScriptSchema' | 'generateCodeSamples' | 'proxyUrl' | 'showResponseSchema' | 'disablePlayground' | 'mediaAdapters'>;
-export interface ApiPageProps extends ApiPageContextProps {
-    document: DocumentInput;
+import { type ProcessedDocument } from '../utils/process-document.js';
+import type { SharedOpenAPIOptions } from '../server/index.js';
+export interface ApiPageProps extends SharedOpenAPIOptions {
+    document: Promise<ProcessedDocument> | string | ProcessedDocument;
     hasHead: boolean;
-    renderer?: Partial<Renderer>;
     /**
      * An array of operations
      */
     operations?: OperationItem[];
     webhooks?: WebhookItem[];
-    /**
-     * By default, it is disabled on dev mode
-     */
-    disableCache?: boolean;
 }
 export interface WebhookItem {
     name: string;
@@ -26,8 +20,5 @@ export interface OperationItem {
     method: OpenAPIV3_1.HttpMethods;
 }
 export declare function APIPage(props: ApiPageProps): Promise<import("react/jsx-runtime").JSX.Element>;
-export declare function getContext(schema: ProcessedDocument, options?: ApiPageContextProps & {
-    renderer?: Partial<Renderer>;
-}): Promise<RenderContext>;
-export {};
+export declare function getContext(schema: ProcessedDocument, options?: SharedOpenAPIOptions): Promise<RenderContext>;
 //# sourceMappingURL=api-page.d.ts.map

package/dist/render/api-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-page.d.ts","sourceRoot":"","sources":["../../src/render/api-page.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAGlC,KAAK,mBAAmB,GAAG,IAAI,CAC7B,OAAO,CAAC,aAAa,CAAC,EACpB,cAAc,GACd,0BAA0B,GAC1B,qBAAqB,GACrB,UAAU,GACV,oBAAoB,GACpB,mBAAmB,GACnB,eAAe,CAClB,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IAEjB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAE7B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,oDAkEhD;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,mBAAmB,GAAG;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzB,GACL,OAAO,CAAC,aAAa,CAAC,CA0BxB"}
+{"version":3,"file":"api-page.d.ts","sourceRoot":"","sources":["../../src/render/api-page.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,MAAM,GAAG,iBAAiB,CAAC;IAClE,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAE7B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,oDAgEhD;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA0BxB"}

package/dist/render/api-page.js

@@ -6,8 +6,10 @@ import { createRenders } from '../render/renderer.js';
 import { processDocument, } from '../utils/process-document.js';
 import { defaultAdapters } from '../media/adapter.js';
 export async function APIPage(props) {
-    const { operations, hasHead = true, webhooks, disableCache = process.env.NODE_ENV === 'development', } = props;
-    const processed = await processDocument(props.document, disableCache);
+    const { operations, hasHead = true, webhooks } = props;
+    const processed = typeof props.document === 'string'
+        ? await processDocument(props.document)
+        : await props.document;
     const ctx = await getContext(processed, props);
     const { document } = processed;
     return (_jsxs(ctx.renderer.Root, { ctx: ctx, children: [operations?.map((item) => {

package/dist/server/create.d.ts

@@ -1,11 +1,72 @@
 import type { ApiPageProps } from '../render/api-page.js';
 import { createProxy } from '../server/proxy.js';
 import type { CodeSample } from '../render/operation/index.js';
-export type OpenAPIOptions = Omit<Partial<ApiPageProps>, 'document'>;
+import type { Renderer } from '../render/renderer.js';
+import type { NoReference } from '../utils/schema.js';
+import type { BuiltinTheme, CodeOptionsThemes, CodeToHastOptionsCommon } from 'shiki';
+import type { MediaAdapter } from '../media/adapter.js';
+import type { MethodInformation } from '../types.js';
+import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
+import { type ProcessedDocument } from '../utils/process-document.js';
+type Awaitable<T> = T | Promise<T>;
+/**
+ * schema id -> downloaded schema object
+ */
+type SchemaMap = Record<string, OpenAPIV3_1.Document | OpenAPIV3.Document>;
+type ProcessedSchemaMap = Record<string, ProcessedDocument>;
+export interface SharedOpenAPIOptions {
+    /**
+     * The url of proxy to avoid CORS issues
+     */
+    proxyUrl?: string;
+    renderer?: Partial<Renderer>;
+    /**
+     * Disable API Playground
+     *
+     * @defaultValue false
+     */
+    disablePlayground?: boolean;
+    /**
+     * Generate TypeScript definitions from response schema.
+     *
+     * Pass `false` to disable it.
+     *
+     * @param method - the operation object
+     * @param statusCode - status code
+     */
+    generateTypeScriptSchema?: ((method: NoReference<MethodInformation>, statusCode: string) => Awaitable<string>) | false;
+    /**
+     * Generate code samples for endpoint.
+     */
+    generateCodeSamples?: (method: MethodInformation) => Awaitable<CodeSample[]>;
+    shikiOptions?: Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BuiltinTheme>;
+    /**
+     * Show full response schema instead of only example response & Typescript definitions
+     *
+     * @default true
+     */
+    showResponseSchema?: boolean;
+    mediaAdapters?: Record<string, MediaAdapter>;
+}
+export interface OpenAPIOptions extends SharedOpenAPIOptions {
+    /**
+     * Schema files, can be:
+     * - URL
+     * - file path
+     * - a function returning records of downloaded schemas.
+     */
+    input?: string[] | (() => Promise<SchemaMap>);
+    /**
+     * By default, it is disabled on dev mode
+     */
+    disableCache?: boolean;
+}
 export interface OpenAPIServer {
     getAPIPageProps: (from: ApiPageProps) => ApiPageProps;
     createProxy: typeof createProxy;
+    getSchemas: () => Promise<ProcessedSchemaMap>;
 }
 export declare function createOpenAPI(options?: OpenAPIOptions): OpenAPIServer;
 export declare function createCodeSample<T>(options: CodeSample<T>): CodeSample;
+export {};
 //# sourceMappingURL=create.d.ts.map

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;AAErD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,YAAY,CAAC;IACtD,WAAW,EAAE,OAAO,WAAW,CAAC;CACjC;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAUzE;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,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,EAEL,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;;OAEG;IACH,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,CA8CzE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAEtE"}

package/dist/server/create.js

@@ -1,11 +1,36 @@
 import { createProxy } from '../server/proxy.js';
+import { processDocument, } from '../utils/process-document.js';
 export function createOpenAPI(options = {}) {
+    const { input = [], disableCache = process.env.NODE_ENV === 'development', ...shared } = options;
+    let schemas;
+    async function getSchemas() {
+        const out = {};
+        if (Array.isArray(input)) {
+            await Promise.all(input.map(async (item) => {
+                out[item] = await processDocument(item, disableCache);
+            }));
+        }
+        else {
+            await Promise.all(Object.entries(await input()).map(async ([k, v]) => {
+                out[k] = await processDocument(v, disableCache);
+            }));
+        }
+        return out;
+    }
     return {
         createProxy,
-        getAPIPageProps(props) {
+        async getSchemas() {
+            return (schemas ?? (schemas = getSchemas()));
+        },
+        getAPIPageProps({ document, ...props }) {
             return {
-                ...options,
+                ...shared,
                 ...props,
+                document: typeof document === 'string'
+                    ? this.getSchemas().then((map) => {
+                        return map[document] ?? processDocument(document, disableCache);
+                    })
+                    : document,
             };
         },
     };

package/dist/types.d.ts

@@ -1,11 +1,10 @@
 import type { OpenAPIV3_1 as V3_1 } from 'openapi-types';
 import type { default as Slugger } from 'github-slugger';
 import { type Renderer } from './render/renderer.js';
-import type { CodeSample } from './render/operation/index.js';
-import type { BuiltinTheme, CodeOptionsThemes, CodeToHastOptionsCommon } from 'shiki';
 import type { NoReference } from './utils/schema.js';
 import type { ProcessedDocument } from './utils/process-document.js';
 import type { MediaAdapter } from './media/adapter.js';
+import type { SharedOpenAPIOptions } from './server/index.js';
 export type Document = V3_1.Document;
 export type OperationObject = V3_1.OperationObject;
 export type ParameterObject = V3_1.ParameterObject;
@@ -20,48 +19,18 @@ export type ServerVariableObject = NoReference<V3_1.ServerVariableObject>;
 export type MethodInformation = NoReference<OperationObject> & {
     method: string;
 };
-type Awaitable<T> = T | Promise<T>;
 /**
  * Dereferenced value and its original `$ref` value
  */
 export type DereferenceMap = Map<unknown, string>;
-export interface RenderContext {
-    /**
-     * The url of proxy to avoid CORS issues
-     */
-    proxyUrl?: string;
+export interface RenderContext extends SharedOpenAPIOptions {
     renderer: Renderer;
-    /**
-     * Disable API Playground
-     */
-    disablePlayground?: boolean;
     servers: ServerObject[];
     slugger: Slugger;
     /**
      * dereferenced schema
      */
     schema: ProcessedDocument;
-    /**
-     * Generate TypeScript definitions from response schema.
-     *
-     * Pass `false` to disable it.
-     *
-     * @param method - the operation object
-     * @param statusCode - status code
-     */
-    generateTypeScriptSchema?: ((method: NoReference<MethodInformation>, statusCode: string) => Awaitable<string>) | false;
-    /**
-     * Generate code samples for endpoint.
-     */
-    generateCodeSamples?: (method: MethodInformation) => Awaitable<CodeSample[]>;
-    shikiOptions?: Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BuiltinTheme>;
-    /**
-     * Show full response schema instead of only example response & Typescript definitions
-     *
-     * @default true
-     */
-    showResponseSchema?: boolean;
     mediaAdapters: Record<string, MediaAdapter>;
 }
-export {};
 //# sourceMappingURL=types.d.ts.map

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,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,OAAO,CAAC;AACf,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;AAEpD,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,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;;;;;;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,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;;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"}

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

@@ -1,7 +1,7 @@
 import type { ApiPageProps } from '../render/api-page.js';
 import type { GenerateOptions } from '../generate.js';
 import type { TagObject } from '../types.js';
-import type { DocumentInput, ProcessedDocument } from '../utils/process-document.js';
+import type { ProcessedDocument } from '../utils/process-document.js';
 export type DocumentContext = {
     type: 'tag';
     tag: TagObject | undefined;
@@ -10,7 +10,7 @@ export type DocumentContext = {
 } | {
     type: 'file';
 };
-export declare function generateDocument(input: DocumentInput, processed: ProcessedDocument, pageProps: Omit<ApiPageProps, 'document'>, options: GenerateOptions & {
+export declare function generateDocument(schemaId: string, processed: ProcessedDocument, pageProps: Omit<ApiPageProps, 'document'>, options: GenerateOptions & {
     title: string;
     description?: string;
 }, context: DocumentContext): string;

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

@@ -1 +1 @@
-{"version":3,"file":"generate-document.d.ts","sourceRoot":"","sources":["../../src/utils/generate-document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAOlC,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,SAAS,GAAG,SAAS,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,WAAW,CAAC;CACnB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EACzC,OAAO,EAAE,eAAe,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,OAAO,EAAE,eAAe,GACvB,MAAM,CAkER"}
+{"version":3,"file":"generate-document.d.ts","sourceRoot":"","sources":["../../src/utils/generate-document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOlE,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,SAAS,GAAG,SAAS,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,WAAW,CAAC;CACnB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EACzC,OAAO,EAAE,eAAe,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,OAAO,EAAE,eAAe,GACvB,MAAM,CAkER"}

package/dist/utils/generate-document.js

@@ -1,13 +1,13 @@
 import { dump } from 'js-yaml';
 import Slugger from 'github-slugger';
 import { idToTitle } from '../utils/id-to-title.js';
-export function generateDocument(input, processed, pageProps, options, context) {
+export function generateDocument(schemaId, processed, pageProps, options, context) {
     const { frontmatter, includeDescription = false, addGeneratedComment = true, } = options;
     const out = [];
     const extend = frontmatter?.(options.title, options.description, context);
     const page = {
         ...pageProps,
-        document: options.inlineDocument ? processed.downloaded : input,
+        document: schemaId,
     };
     let meta;
     if (page.operations?.length === 1) {

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

@@ -1,7 +1,6 @@
 import type { DereferenceMap, Document } from '../types.js';
 import type { NoReference } from '../utils/schema.js';
 import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
-export type DocumentInput = string | OpenAPIV3_1.Document | OpenAPIV3.Document;
 export type ProcessedDocument = {
     document: NoReference<Document>;
     dereferenceMap: DereferenceMap;
@@ -10,5 +9,5 @@ export type ProcessedDocument = {
 /**
  * process & reference input document to a Fumadocs OpenAPI compatible format
  */
-export declare function processDocument(input: DocumentInput, disableCache?: boolean): Promise<ProcessedDocument>;
+export declare function processDocument(input: string | OpenAPIV3_1.Document | OpenAPIV3.Document, disableCache?: boolean): Promise<ProcessedDocument>;
 //# sourceMappingURL=process-document.d.ts.map

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,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,CA+B5B"}
+{"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;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,EACzD,YAAY,UAAQ,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA+B5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "9.1.12",
+  "version": "9.2.0",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -46,9 +46,9 @@
   ],
   "dependencies": {
     "@fumari/json-schema-to-typescript": "^1.1.3",
-    "@radix-ui/react-accordion": "^1.2.11",
-    "@radix-ui/react-dialog": "^1.1.14",
-    "@radix-ui/react-select": "^2.2.5",
+    "@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.3",
     "@scalar/openapi-parser": "0.18.3",
     "ajv": "^8.17.1",
@@ -64,18 +64,18 @@
     "shiki": "^3.9.2",
     "tinyglobby": "^0.2.14",
     "xml-js": "^1.6.11",
-    "fumadocs-ui": "15.6.10",
-    "fumadocs-core": "15.6.10"
+    "fumadocs-core": "15.6.12",
+    "fumadocs-ui": "15.6.12"
   },
   "devDependencies": {
     "@scalar/api-client-react": "^1.3.27",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "24.2.1",
+    "@types/node": "24.3.0",
     "@types/openapi-sampler": "^1.0.3",
     "@types/react": "^19.1.10",
     "json-schema-typed": "^8.0.1",
     "openapi-types": "^12.1.3",
-    "tailwindcss": "^4.1.11",
+    "tailwindcss": "^4.1.12",
     "tsc-alias": "^1.8.16",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"