fumadocs-openapi 8.1.12 → 9.0.0

package/dist/generate-file.d.ts

@@ -1,38 +1,73 @@
-import { type GenerateOptions } from './generate.js';
-export interface Config extends GenerateOptions {
+import { type GenerateOptions, type GeneratePageOutput, type GenerateTagOutput } from './generate.js';
+import { type ProcessedDocument } from './utils/process-document.js';
+interface GenerateFileOutput {
     /**
-     * Schema files
+     * The original schema file path/url from `input`
      */
-    input: string[] | string;
+    pathOrUrl: string;
+    content: string;
+}
+interface OperationConfig extends BaseConfig {
     /**
-     * Output directory
+     * Generate a page for each API endpoint/operation (default).
      */
-    output: string;
+    per?: 'operation';
     /**
-     * tag: Generate a page for each tag
-     * file: Generate a page for each schema
-     * operation: Generate a page for each API endpoint/operation
+     * Group output using folders (Only works on `operation` mode)
+     * - tag: `{tag}/{file}`
+     * - route: `{endpoint}/{method}` (it will ignore the `name` option)
+     * - none: `{file}` (default)
      *
-     * @defaultValue 'operation'
+     * @defaultValue 'none'
      */
-    per?: 'tag' | 'file' | 'operation';
+    groupBy?: 'tag' | 'route' | 'none';
     /**
      * Specify name for output file
      */
-    name?: (type: 'file' | 'tag', name: string) => string;
+    name?: ((output: GeneratePageOutput, document: ProcessedDocument['document']) => string) | BaseName;
+}
+interface TagConfig extends BaseConfig {
     /**
-     * Group output using folders (Only works on `operation` mode)
-     *
-     * @deprecated Use `groupBy` instead
-     * @defaultValue false
+     * Generate a page for each tag.
      */
-    groupByFolder?: boolean;
+    per: 'tag';
     /**
-     * Group output using folders (Only works on `operation` mode)
+     * Specify name for output file
+     */
+    name?: ((output: GenerateTagOutput, document: ProcessedDocument['document']) => string) | BaseName;
+}
+interface FileConfig extends BaseConfig {
+    /**
+     * Generate a page for each schema file.
+     */
+    per: 'file';
+    /**
+     * Specify name for output file
+     */
+    name?: ((output: GenerateFileOutput, document: ProcessedDocument['document']) => string) | BaseName;
+}
+export type Config = FileConfig | TagConfig | OperationConfig;
+interface BaseName {
+    /**
+     * The version of algorithm used to generate file paths.
      *
-     * @defaultValue 'none'
+     * v1: Fumadocs OpenAPI v8
+     * v2: Fumadocs OpenAPI v9
+     *
+     * @defaultValue v2
      */
-    groupBy?: 'tag' | 'route' | 'none';
+    algorithm?: 'v2' | 'v1';
+}
+interface BaseConfig extends GenerateOptions {
+    /**
+     * Schema files
+     */
+    input: string[] | string;
+    /**
+     * Output directory
+     */
+    output: string;
 }
 export declare function generateFiles(options: Config): Promise<void>;
+export {};
 //# sourceMappingURL=generate-file.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"generate-file.d.ts","sourceRoot":"","sources":["../src/generate-file.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,eAAe,EAIrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,MAAO,SAAQ,eAAe;IAC7C;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAEtD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;CACpC;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmJlE"}
+{"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;CAChB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BlE"}

package/dist/generate-file.js

@@ -1,9 +1,11 @@
 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, output, name: nameFn, per = 'operation', groupBy = 'none', cwd = process.cwd(), } = options;
+    const { input, cwd = process.cwd() } = options;
     const urlInputs = [];
     const fileInputs = [];
     for (const v of typeof input === 'string' ? [input] : input) {
@@ -21,91 +23,109 @@ export async function generateFiles(options) {
     if (resolvedInputs.length === 0) {
         throw new Error(`No input files found. Tried resolving: ${typeof input === 'string' ? input : input.join(', ')}`);
     }
-    function getOutputPaths(result) {
-        let file;
-        if (result.pathItem.summary) {
-            file = getFilename(result.pathItem.summary);
-        }
-        else if (result.type === 'operation') {
-            file = path.join(getOutputPathFromRoute(result.item.path), result.item.method.toLowerCase());
-        }
-        else {
-            file = getFilename(result.item.name);
+    await Promise.all(resolvedInputs.map((input) => generateFromDocument(input, options)));
+}
+async function generateFromDocument(pathOrUrl, options) {
+    const { output, cwd = process.cwd() } = options;
+    let nameFn;
+    if (!options.name || typeof options.name !== 'function') {
+        const { algorithm = 'v2' } = options.name ?? {};
+        nameFn = (output, document) => {
+            if (options.per === 'tag') {
+                const result = output;
+                return getFilename(result.tag);
+            }
+            if (options.per === 'file') {
+                return isUrl(pathOrUrl)
+                    ? 'index'
+                    : path.basename(pathOrUrl, path.extname(pathOrUrl));
+            }
+            const result = output;
+            if (result.type === 'operation') {
+                const operation = document.paths[result.item.path][result.item.method];
+                if (algorithm === 'v2' && operation.operationId) {
+                    return operation.operationId;
+                }
+                return path.join(getOutputPathFromRoute(result.item.path), result.item.method.toLowerCase());
+            }
+            const hook = document.webhooks[result.item.name][result.item.method];
+            if (algorithm === 'v2' && hook.operationId) {
+                return hook.operationId;
+            }
+            return getFilename(result.item.name);
+        };
+    }
+    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);
+    }
+    function getOutputPaths(groupBy = 'none', result) {
+        const file = nameFn(result, document.document);
+        if (groupBy === 'route') {
+            return [
+                path.join(result.type === 'operation' ? result.item.path : result.item.name, result.item.method) + '.mdx',
+            ];
         }
-        const outPaths = [];
         if (groupBy === 'tag') {
-            let tags = result.operation.tags;
+            let tags = result.type === 'operation'
+                ? document.document.paths[result.item.path][result.item.method]
+                    .tags
+                : document.document.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'];
             }
-            for (const tag of tags) {
-                outPaths.push(path.join(getFilename(tag), `${file}.mdx`));
-            }
+            return tags.map((tag) => path.join(getFilename(tag), `${file}.mdx`));
         }
-        else {
-            outPaths.push(`${file}.mdx`);
-        }
-        return outPaths;
+        return [`${file}.mdx`];
     }
-    const metaFiles = new Set();
-    async function writeMetafile(file, data) {
-        if (metaFiles.has(file))
-            return;
-        metaFiles.add(file);
-        await write(file, JSON.stringify(data, null, 2));
-        console.log(`Generated Meta: ${file}`);
+    if (options.per === 'file') {
+        const result = await generateAll(document, options);
+        const filename = nameFn({
+            pathOrUrl,
+            content: result,
+        }, document.document);
+        const outPath = path.join(outputDir, `${filename}.mdx`);
+        await write(outPath, result);
+        console.log(`Generated: ${outPath}`);
     }
-    async function generateFromDocument(pathOrUrl) {
-        const outputDir = path.join(cwd, output);
-        if (per === 'file') {
-            let filename = isUrl(pathOrUrl)
-                ? 'index'
-                : path.basename(pathOrUrl, path.extname(pathOrUrl));
-            if (nameFn)
-                filename = nameFn('file', filename);
+    else if (options.per === 'tag') {
+        const results = await generateTags(document, options);
+        for (const result of results) {
+            const filename = nameFn(result, document.document);
             const outPath = path.join(outputDir, `${filename}.mdx`);
-            const result = await generateAll(pathOrUrl, options);
-            await write(outPath, result);
+            await write(outPath, result.content);
             console.log(`Generated: ${outPath}`);
         }
-        if (per === 'operation') {
-            const results = await generatePages(pathOrUrl, options);
-            const mapping = new Map();
-            for (const result of results) {
-                const outputPaths = getOutputPaths(result);
-                for (const outputPath of outputPaths) {
-                    mapping.set(outputPath, result);
-                }
+    }
+    else {
+        const results = await generatePages(document, options);
+        const mapping = new Map();
+        for (const result of results) {
+            for (const outputPath of getOutputPaths(options.groupBy, result)) {
+                mapping.set(outputPath, result);
             }
-            for (const [key, output] of mapping.entries()) {
-                let outputPath = key;
+        }
+        for (const [key, output] of mapping.entries()) {
+            let outputPath = key;
+            // v1 will remove nested directories
+            if (typeof options.name === 'object' && options.name.algorithm === 'v1') {
                 const isSharedDir = Array.from(mapping.keys()).some((item) => item !== outputPath &&
                     path.dirname(item) === path.dirname(outputPath));
                 if (!isSharedDir && path.dirname(outputPath) !== '.') {
                     outputPath = path.join(path.dirname(outputPath) + '.mdx');
                 }
-                await write(path.join(outputDir, outputPath), output.content);
-                if (groupBy === 'route' && output.pathItem.summary) {
-                    await writeMetafile(path.join(outputDir, path.dirname(outputPath), 'meta.json'), {
-                        title: output.pathItem.summary,
-                    });
-                }
-                console.log(`Generated: ${outputPath}`);
-            }
-        }
-        if (per === 'tag') {
-            const results = await generateTags(pathOrUrl, options);
-            for (const result of results) {
-                let tagName = result.tag;
-                tagName = nameFn?.('tag', tagName) ?? getFilename(tagName);
-                const outPath = path.join(outputDir, `${tagName}.mdx`);
-                await write(outPath, result.content);
-                console.log(`Generated: ${outPath}`);
             }
+            await write(path.join(outputDir, outputPath), output.content);
+            console.log(`Generated: ${outputPath}`);
         }
     }
-    await Promise.all(resolvedInputs.map(generateFromDocument));
 }
 function isUrl(input) {
     return input.startsWith('https://') || input.startsWith('http://');
@@ -125,7 +145,12 @@ function getOutputPathFromRoute(path) {
 function getFilename(s) {
     return s.replace(/\s+/g, '-').toLowerCase();
 }
-async function write(file, content) {
-    await mkdir(path.dirname(file), { recursive: true });
-    await writeFile(file, content);
+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,8 +1,6 @@
 import { type DocumentContext } from './utils/generate-document.js';
-import type { OperationObject, PathItemObject } from './types.js';
-import type { NoReference } from './utils/schema.js';
 import type { OperationItem, WebhookItem } from './render/api-page.js';
-import { type DocumentInput } from './utils/process-document.js';
+import type { ProcessedDocument } from './utils/process-document.js';
 export interface GenerateOptions {
     /**
      * Additional imports of your MDX components.
@@ -42,18 +40,14 @@ export interface GenerateTagOutput {
 }
 export type GeneratePageOutput = {
     type: 'operation';
-    pathItem: NoReference<PathItemObject>;
-    operation: NoReference<OperationObject>;
     item: OperationItem;
     content: string;
 } | {
     type: 'webhook';
-    pathItem: NoReference<PathItemObject>;
-    operation: NoReference<OperationObject>;
     item: WebhookItem;
     content: string;
 };
-export declare function generateAll(pathOrDocument: DocumentInput, options?: GenerateOptions): Promise<string>;
-export declare function generatePages(pathOrDocument: DocumentInput, options?: GenerateOptions): Promise<GeneratePageOutput[]>;
-export declare function generateTags(pathOrDocument: DocumentInput, options?: GenerateOptions): Promise<GenerateTagOutput[]>;
+export declare function generateAll({ document, downloaded }: ProcessedDocument, options?: GenerateOptions): Promise<string>;
+export declare function generatePages({ document, downloaded }: ProcessedDocument, options?: GenerateOptions): Promise<GeneratePageOutput[]>;
+export declare function generateTags({ document, downloaded }: 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":"AAEA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,0BAA0B,CAAC;AAE/E,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;CACd;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,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACtC,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAExC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACtC,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAExC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAgBN,wBAAsB,WAAW,CAC/B,cAAc,EAAE,aAAa,EAC7B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,aAAa,CACjC,cAAc,EAAE,aAAa,EAC7B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiE/B;AAED,wBAAsB,YAAY,CAChC,cAAc,EAAE,aAAa,EAC7B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsC9B"}
+{"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;CACd;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,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB,EAC3C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAsB,aAAa,CACjC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB,EAC3C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA4D/B;AAED,wBAAsB,YAAY,CAChC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB,EAC3C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqC9B"}

package/dist/generate.js

@@ -1,19 +1,7 @@
-import { resolve } from 'node:path';
 import { getAPIPageItems } from './build-routes.js';
 import { generateDocument, } from './utils/generate-document.js';
 import { idToTitle } from './utils/id-to-title.js';
-import { processDocument } from './utils/process-document.js';
-async function dereference(pathOrDocument, options) {
-    return await processDocument(
-    // resolve paths
-    typeof pathOrDocument === 'string' &&
-        !pathOrDocument.startsWith('http://') &&
-        !pathOrDocument.startsWith('https://')
-        ? resolve(options.cwd ?? process.cwd(), pathOrDocument)
-        : pathOrDocument).then((res) => res.document);
-}
-export async function generateAll(pathOrDocument, options = {}) {
-    const document = await dereference(pathOrDocument, options);
+export async function generateAll({ document, downloaded }, options = {}) {
     const items = getAPIPageItems(document);
     return generateDocument({
         ...options,
@@ -24,15 +12,14 @@ export async function generateAll(pathOrDocument, options = {}) {
             operations: items.operations,
             webhooks: items.webhooks,
             hasHead: true,
-            document: pathOrDocument,
+            document: downloaded,
         },
         context: {
             type: 'file',
         },
     });
 }
-export async function generatePages(pathOrDocument, options = {}) {
-    const document = await dereference(pathOrDocument, options);
+export async function generatePages({ document, downloaded }, options = {}) {
     const items = getAPIPageItems(document);
     const result = [];
     for (const item of items.operations) {
@@ -44,15 +31,13 @@ export async function generatePages(pathOrDocument, options = {}) {
             continue;
         result.push({
             type: 'operation',
-            pathItem,
-            operation,
             item,
             content: generateDocument({
                 ...options,
                 page: {
                     operations: [item],
                     hasHead: false,
-                    document: pathOrDocument,
+                    document: downloaded,
                 },
                 dereferenced: document,
                 title: operation.summary ??
@@ -74,15 +59,13 @@ export async function generatePages(pathOrDocument, options = {}) {
             continue;
         result.push({
             type: 'webhook',
-            pathItem,
-            operation,
             item,
             content: generateDocument({
                 ...options,
                 page: {
                     webhooks: [item],
                     hasHead: false,
-                    document: pathOrDocument,
+                    document: downloaded,
                 },
                 dereferenced: document,
                 title: operation.summary ?? pathItem.summary ?? idToTitle(item.name),
@@ -95,8 +78,7 @@ export async function generatePages(pathOrDocument, options = {}) {
     }
     return result;
 }
-export async function generateTags(pathOrDocument, options = {}) {
-    const document = await dereference(pathOrDocument, options);
+export async function generateTags({ document, downloaded }, options = {}) {
     if (!document.tags)
         return [];
     const items = getAPIPageItems(document);
@@ -111,7 +93,7 @@ export async function generateTags(pathOrDocument, options = {}) {
             content: generateDocument({
                 ...options,
                 page: {
-                    document: pathOrDocument,
+                    document: downloaded,
                     operations,
                     webhooks,
                     hasHead: true,

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './generate.js';
 export * from './generate-file.js';
 export * from './types.js';
+export type { MediaAdapter } from './media/adapter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/playground/inputs.d.ts

@@ -1,24 +1,20 @@
-import { type HTMLAttributes, type ReactNode } from 'react';
+import { ComponentProps, type HTMLAttributes, type ReactNode } from 'react';
 import type { RequestSchema } from '../playground/index.js';
 export declare function ObjectInput({ field: _field, fieldName, ...props }: {
     field: Exclude<RequestSchema, boolean>;
     fieldName: string;
-} & HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
+} & ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element | undefined;
 export declare function JsonInput({ fieldName, children, }: {
     fieldName: string;
     children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function FieldInput({ field, fieldName, isRequired, ...props }: HTMLAttributes<HTMLElement> & {
-    field: Exclude<RequestSchema, boolean>;
-    isRequired?: boolean;
-    fieldName: string;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function FieldSet({ field: _field, fieldName, toolbar, name, isRequired, depth, ...props }: HTMLAttributes<HTMLElement> & {
+export declare function FieldSet({ field: _field, fieldName, toolbar, name, isRequired, depth, slotType, ...props }: HTMLAttributes<HTMLElement> & {
     isRequired?: boolean;
     name?: ReactNode;
     field: RequestSchema;
     fieldName: string;
     depth?: number;
+    slotType?: ReactNode;
     toolbar?: ReactNode;
 }): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=inputs.d.ts.map

package/dist/playground/inputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/playground/inputs.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAef,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA8CxD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EAAE,MAAM,EACb,SAAS,EACT,GAAG,KAAK,EACT,EAAE;IACD,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CAAC,cAAc,CAAC,2CAqCjC;AAED,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CA0BA;AAyFD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,UAAU,EACV,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,2CAmGA;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EACT,OAAO,EACP,IAAI,EACJ,UAAU,EACV,KAAS,EACT,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,kDA2HA"}
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/playground/inputs.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,KAAK,cAAc,EAEnB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAef,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAgDxD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EAAE,MAAM,EACb,SAAS,EACT,GAAG,KAAK,EACT,EAAE;IACD,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CAAC,KAAK,CAAC,uDAqCxB;AAED,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CA0BA;AAkLD,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EACT,OAAO,EACP,IAAI,EACJ,UAAU,EACV,KAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,kDA6KA"}