fumadocs-openapi 9.4.0 → 9.5.0

package/dist/generate-file.d.ts

@@ -1,67 +1,23 @@
-import { type GenerateOptions, type GeneratePageOutput, type GenerateTagOutput } from './generate.js';
+import { type PagesToTextOptions } from './utils/pages/to-text.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`
-     */
-    pathOrUrl: string;
-    content: string;
-}
+import { type SchemaToPagesOptions } from './utils/schema-to-pages.js';
 export interface OutputFile {
     path: string;
     content: string;
 }
-interface OperationConfig extends BaseConfig {
-    /**
-     * Generate a page for each API endpoint/operation (default).
-     */
-    per?: '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 'none'
-     */
-    groupBy?: 'tag' | 'route' | 'none';
-    /**
-     * Specify name for output file
-     */
-    name?: ((output: GeneratePageOutput, document: ProcessedDocument['dereferenced']) => string) | BaseName;
-}
-interface TagConfig extends BaseConfig {
-    /**
-     * Generate a page for each tag.
-     */
-    per: 'tag';
-    /**
-     * Specify name for output file
-     */
-    name?: ((output: GenerateTagOutput, document: ProcessedDocument['dereferenced']) => string) | BaseName;
-}
-interface FileConfig extends BaseConfig {
-    /**
-     * Generate a page for each schema file.
-     */
-    per: 'file';
+interface IndexConfig {
+    items: IndexItem[] | ((ctx: HookContext) => IndexItem[]);
     /**
-     * Specify name for output file
+     * Generate URLs for cards
      */
-    name?: ((output: GenerateFileOutput, document: ProcessedDocument['dereferenced']) => string) | BaseName;
-}
-export type Config = FileConfig | TagConfig | OperationConfig;
-interface BaseName {
-    /**
-     * The version of algorithm used to generate file paths.
-     *
-     * v1: Fumadocs OpenAPI v8
-     * v2: Fumadocs OpenAPI v9
-     *
-     * @defaultValue v2
-     */
-    algorithm?: 'v2' | 'v1';
+    url: ((filePath: string) => string) | {
+        baseUrl: string;
+        /**
+         * Base content directory
+         */
+        contentDir: string;
+    };
 }
 interface IndexItem {
     path: string;
@@ -74,12 +30,8 @@ interface IndexItem {
      */
     only?: (string | OutputFile)[];
 }
-interface HookContext {
-    files: OutputFile[];
-    readonly generated: Record<string, OutputFile[]>;
-    readonly documents: Record<string, ProcessedDocument>;
-}
-interface BaseConfig extends GenerateOptions {
+interface GenerateFilesConfig extends PagesToTextOptions {
+    cwd?: string;
     /**
      * Schema files, or the OpenAPI server object
      */
@@ -88,34 +40,22 @@ interface BaseConfig extends GenerateOptions {
      * Output directory
      */
     output: string;
-    /**
-     * Custom function to convert names into file names.
-     *
-     * By default, it only escapes whitespaces and upper case (English) characters
-     */
-    slugify?: (name: string) => string;
     /**
      * Generate index files with cards linking to generated pages.
      */
-    index?: {
-        items: IndexItem[] | ((ctx: HookContext) => IndexItem[]);
-        /**
-         * Generate URLs for cards
-         */
-        url: ((filePath: string) => string) | {
-            baseUrl: string;
-            /**
-             * Base content directory
-             */
-            contentDir: string;
-        };
-    };
+    index?: IndexConfig;
     /**
      * Can add/change/remove output files before writing to file system
      **/
     beforeWrite?: (this: HookContext, files: OutputFile[]) => void | Promise<void>;
 }
+export type Config = SchemaToPagesOptions & GenerateFilesConfig;
+interface HookContext {
+    files: OutputFile[];
+    readonly generated: Record<string, OutputFile[]>;
+    readonly documents: Record<string, ProcessedDocument>;
+}
 export declare function generateFiles(options: Config): Promise<void>;
-export declare function generateFilesOnly(options: Config): Promise<OutputFile[]>;
+export declare function generateFilesOnly(options: SchemaToPagesOptions & Omit<GenerateFilesConfig, 'output'>): Promise<OutputFile[]>;
 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":"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"}
+{"version":3,"file":"generate-file.d.ts","sourceRoot":"","sources":["../src/generate-file.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC,CAAC;IAEzD;;OAEG;IACH,GAAG,EACC,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,GAC9B;QACE,OAAO,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACP;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC;CAChC;AAED,UAAU,mBAAoB,SAAQ,kBAAkB;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,aAAa,CAAC;IAEzC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;QAEI;IACJ,WAAW,CAAC,EAAE,CACZ,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,UAAU,EAAE,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,MAAM,MAAM,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;AAEhE,UAAU,WAAW;IACnB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACvD;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAclE;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAClE,OAAO,CAAC,UAAU,EAAE,CAAC,CAkEvB"}

package/dist/generate-file.js

@@ -1,16 +1,20 @@
 import { mkdir, writeFile } from 'node:fs/promises';
 import * as path from 'node:path';
 import { glob } from 'tinyglobby';
-import { generateAll, generateDocument, generatePages, generateTags, } from './generate.js';
+import { generateDocument, toText, } from './utils/pages/to-text.js';
 import { processDocumentCached, } from './utils/process-document.js';
 import { createGetUrl, getSlugs } from 'fumadocs-core/source';
 import matter from 'gray-matter';
+import { isUrl, schemaToPages, } from './utils/schema-to-pages.js';
 export async function generateFiles(options) {
     const files = await generateFilesOnly(options);
+    const { output, cwd = process.cwd() } = options;
+    const baseDir = path.join(cwd, output);
     await Promise.all(files.map(async (file) => {
-        await mkdir(path.dirname(file.path), { recursive: true });
-        await writeFile(file.path, file.content);
-        console.log(`Generated: ${file.path}`);
+        const filePath = path.join(baseDir, file.path);
+        await mkdir(path.dirname(filePath), { recursive: true });
+        await writeFile(filePath, file.content);
+        console.log(`Generated: ${filePath}`);
     }));
 }
 export async function generateFilesOnly(options) {
@@ -49,7 +53,10 @@ export async function generateFilesOnly(options) {
         throw new Error('No input files found.');
     }
     for (const [id, schema] of entries) {
-        const result = generateFromDocument(id, schema, options);
+        const result = schemaToPages(id, schema, options).map((page) => ({
+            path: page.path,
+            content: toText(page, schema, options),
+        }));
         files.push(...result);
         generated[id] = result;
     }
@@ -59,140 +66,17 @@ export async function generateFilesOnly(options) {
         documents: schemas,
     };
     if (options.index) {
-        writeIndexFiles(context, options);
+        writeIndexFiles(context, options.index, options);
     }
     await beforeWrite?.call(context, context.files);
     return context.files;
 }
-function generateFromDocument(schemaId, processed, options) {
-    const files = [];
-    const { dereferenced } = processed;
-    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 = options.name?.algorithm;
-        nameFn = (out, doc) => defaultNameFn(schemaId, out, doc, options, algorithm);
-    }
-    else {
-        nameFn = options.name;
-    }
-    function getOutputPaths(groupBy = 'none', result) {
-        if (groupBy === 'route') {
-            return [
-                path.join(getOutputPathFromRoute(result.type === 'operation' ? result.item.path : result.item.name), `${result.item.method.toLowerCase()}.mdx`),
-            ];
-        }
-        const file = nameFn(result, dereferenced);
-        if (groupBy === 'tag') {
-            let tags = result.type === 'operation'
-                ? 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'];
-            }
-            return tags.map((tag) => path.join(slugify(tag), `${file}.mdx`));
-        }
-        return [`${file}.mdx`];
-    }
-    if (options.per === 'file') {
-        const result = generateAll(schemaId, processed, options);
-        const filename = nameFn({
-            pathOrUrl: schemaId,
-            content: result,
-        }, dereferenced);
-        files.push({
-            path: path.join(outputDir, `${filename}.mdx`),
-            content: result,
-        });
-        return files;
-    }
-    if (options.per === 'tag') {
-        const results = generateTags(schemaId, processed, options);
-        for (const result of results) {
-            const filename = nameFn(result, dereferenced);
-            files.push({
-                path: path.join(outputDir, `${filename}.mdx`),
-                content: result.content,
-            });
-        }
-        return files;
-    }
-    const results = generatePages(schemaId, processed, 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;
-        // 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');
-            }
-        }
-        files.push({
-            path: path.join(outputDir, outputPath),
-            content: output.content,
-        });
-    }
-    return files;
-}
-function defaultNameFn(schemaId, output, document, options, algorithm = 'v2') {
-    const { slugify = defaultSlugify } = options;
-    if (options.per === 'tag') {
-        const result = output;
-        return slugify(result.tag);
-    }
-    if (options.per === 'file') {
-        return isUrl(schemaId)
-            ? 'index'
-            : path.basename(schemaId, path.extname(schemaId));
-    }
-    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 slugify(result.item.name);
-}
-function isUrl(input) {
-    return input.startsWith('https://') || input.startsWith('http://');
-}
-function getOutputPathFromRoute(path) {
-    return (path
-        .toLowerCase()
-        .replaceAll('.', '-')
-        .split('/')
-        .map((v) => {
-        if (v.startsWith('{') && v.endsWith('}'))
-            return v.slice(1, -1);
-        return v;
-    })
-        .join('/') ?? '');
-}
-function writeIndexFiles(context, options) {
-    const { index, output, cwd = process.cwd() } = options;
-    if (!index)
-        return;
-    const { items, url } = index;
+function writeIndexFiles(context, options, generateOptions) {
+    const { items, url } = options;
     let urlFn;
     if (typeof url === 'object') {
         const getUrl = createGetUrl(url.baseUrl);
-        const contentDir = path.resolve(cwd, url.contentDir);
-        urlFn = (file) => getUrl(getSlugs(path.relative(contentDir, file)));
+        urlFn = (file) => getUrl(getSlugs(path.relative(url.contentDir, file)));
     }
     else {
         urlFn = url;
@@ -231,17 +115,12 @@ function writeIndexFiles(context, options) {
         return generateDocument({
             title: index.title ?? 'Overview',
             description: index.description,
-        }, content.join('\n'), options);
+        }, content.join('\n'), generateOptions);
     }
-    const outputDir = path.join(cwd, output);
     for (const item of typeof items === 'function' ? items(context) : items) {
-        const outPath = path.join(outputDir, path.extname(item.path).length === 0 ? `${item.path}.mdx` : item.path);
         context.files.push({
-            path: outPath,
+            path: path.extname(item.path).length === 0 ? `${item.path}.mdx` : item.path,
             content: fileContent(item),
         });
     }
 }
-function defaultSlugify(s) {
-    return s.replace(/\s+/g, '-').toLowerCase();
-}

package/dist/playground/client.js

@@ -299,14 +299,14 @@ function useAuthInputs(securities) {
         }
         return result;
     }, [securities]);
-    const mapInputs = useEffectEvent((values) => {
+    const mapInputs = (values) => {
         for (const item of inputs) {
             if (!item.mapOutput)
                 continue;
             values = manipulateValues(values, item.fieldName, item.mapOutput, true);
         }
         return values;
-    });
+    };
     return { inputs, mapInputs };
 }
 function renderCustomField(fieldName, info, field, key) {

package/dist/render/api-page.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Slugger from 'github-slugger';
 import { Operation } from '../render/operation/index.js';
-import { createMethod } from '../server/create-method.js';
+import { createMethod } from '../utils/schema.js';
 import { createRenders } from '../render/renderer.js';
 import { processDocumentCached, } from '../utils/process-document.js';
 import { defaultAdapters } from '../media/adapter.js';

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,CAiNf"}
+{"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;AAajB,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

@@ -1,10 +1,10 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { Fragment } from 'react';
+import { createMethod } from '../../utils/schema.js';
 import { idToTitle } from '../../utils/id-to-title.js';
 import { Markdown } from '../markdown.js';
 import { heading } from '../heading.js';
 import { Schema } from '../schema.js';
-import { createMethod } from '../../server/create-method.js';
 import { methodKeys } from '../../build-routes.js';
 import { APIExample, APIExampleProvider, getAPIExamples, } from '../../render/operation/api-example.js';
 import { MethodLabel } from '../../ui/components/method-label.js';

package/dist/server/source-api.d.ts

@@ -1,9 +1,34 @@
 import type * as PageTree from 'fumadocs-core/page-tree';
-import type { LoaderPlugin, PageFile, PageTreeTransformer } from 'fumadocs-core/source';
+import { LoaderPlugin, MetaData, PageData, PageFile, PageTreeTransformer, Source } from 'fumadocs-core/source';
+import type { OpenAPIServer } from '../server/create.js';
+import type { SchemaToPagesOptions } from '../utils/schema-to-pages.js';
+import { ApiPageProps } from '../render/api-page.js';
+declare module 'fumadocs-core/source' {
+    interface PageData {
+        /**
+         * Added by Fumadocs OpenAPI
+         */
+        _openapi?: {
+            method?: string;
+        };
+    }
+}
 /**
  * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
  */
 export declare function openapiPlugin(): LoaderPlugin;
+interface OpenAPIPageData extends PageData {
+    getAPIPageProps: () => ApiPageProps;
+}
+/**
+ * Generate virtual pages for Fumadocs Source API
+ */
+export declare function openapiSource(from: OpenAPIServer, options?: SchemaToPagesOptions & {
+    baseDir?: string;
+}): Promise<Source<{
+    metaData: MetaData;
+    pageData: OpenAPIPageData;
+}>>;
 /**
  * Source API Integration, add this to page tree builder options.
  *
@@ -14,4 +39,5 @@ export declare const attachFile: (node: PageTree.Item, file: PageFile | undefine
  * @deprecated use `openapiPlugin()`
  */
 export declare function transformerOpenAPI(): PageTreeTransformer;
+export {};
 //# sourceMappingURL=source-api.d.ts.map

package/dist/server/source-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-api.d.ts","sourceRoot":"","sources":["../../src/server/source-api.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAkC5C;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,QAAQ,CAAC,IAAI,EACnB,MAAM,QAAQ,GAAG,SAAS,KACzB,QAAQ,CAAC,IA4BX,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,CAExD"}
+{"version":3,"file":"source-api.d.ts","sourceRoot":"","sources":["../../src/server/source-api.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,MAAM,EAEP,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAiB,QAAQ;QACvB;;WAEG;QACH,QAAQ,CAAC,EAAE;YACT,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH;CACF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAgC5C;AAED,UAAU,eAAgB,SAAQ,QAAQ;IACxC,eAAe,EAAE,MAAM,YAAY,CAAC;CACrC;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,oBAAoB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,OAAO,CACR,MAAM,CAAC;IACL,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC,CACH,CA8BA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,QAAQ,CAAC,IAAI,EACnB,MAAM,QAAQ,GAAG,SAAS,KACzB,QAAQ,CAAC,IA4BX,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,CAExD"}

package/dist/server/source-api.js

@@ -5,6 +5,8 @@ import { MethodLabel } from '../ui/components/method-label.js';
  */
 export function openapiPlugin() {
     return {
+        name: 'fumadocs:openapi',
+        enforce: 'pre',
         transformPageTree: {
             file(node, filePath) {
                 if (!filePath)
@@ -15,8 +17,7 @@ export function openapiPlugin() {
                 const data = file.data;
                 let method;
                 if ('_openapi' in data && typeof data._openapi === 'object') {
-                    const meta = data._openapi;
-                    method = meta.method;
+                    method = data._openapi.method;
                 }
                 if (method) {
                     node.name = (_jsxs(_Fragment, { children: [node.name, ' ', _jsx(MethodLabel, { className: "ms-auto text-xs text-nowrap", children: method })] }));
@@ -26,6 +27,34 @@ export function openapiPlugin() {
         },
     };
 }
+/**
+ * Generate virtual pages for Fumadocs Source API
+ */
+export async function openapiSource(from, options = {}) {
+    const { baseDir = '' } = options;
+    const { serverToPages } = await import('../utils/schema-to-pages.js');
+    const { toBody } = await import('../utils/pages/to-body.js');
+    const files = [];
+    const entries = await serverToPages(from, options);
+    for (const entry of Object.values(entries).flat()) {
+        files.push({
+            type: 'page',
+            path: `${baseDir}/${entry.path}`,
+            data: {
+                ...entry.info,
+                getAPIPageProps: () => toBody(from, entry),
+                _openapi: {
+                    method: entry.type === 'operation' || entry.type === 'webhook'
+                        ? entry.item.method
+                        : undefined,
+                },
+            },
+        });
+    }
+    return {
+        files,
+    };
+}
 /**
  * Source API Integration, add this to page tree builder options.
  *

package/dist/ui/contexts/code-example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-example.d.ts","sourceRoot":"","sources":["../../../src/ui/contexts/code-example.tsx"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAetD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqBtE,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,WAAW,CAAC;KACtB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CA6DA;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,kDA6C7C;AAED,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE,YAAY,2CAoB1D;AAgBD,wBAAgB,qBAAqB,mBAOpC;AAED,wBAAgB,qBAAqB;oBA/KnB,cAAc,WAAW,WAAW,KAAK,IAAI;EAkL9D"}
+{"version":3,"file":"code-example.d.ts","sourceRoot":"","sources":["../../../src/ui/contexts/code-example.tsx"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AActD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmBtE,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,WAAW,CAAC;KACtB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CA6DA;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,kDA2C7C;AAED,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE,YAAY,2CAoB1D;AAgBD,wBAAgB,qBAAqB,mBAIpC;AAED,wBAAgB,qBAAqB;oBA1KnB,cAAc,WAAW,WAAW,KAAK,IAAI;EA6K9D"}

package/dist/ui/contexts/code-example.js

@@ -4,61 +4,58 @@ import { createContext, useContext, useEffect, useMemo, useRef, useState, } from
 import { useApiContext, useServerSelectContext } from '../../ui/contexts/api.js';
 import { DynamicCodeBlock } from 'fumadocs-ui/components/dynamic-codeblock';
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '../../ui/components/select.js';
-import { useEffectEvent } from 'fumadocs-core/utils/use-effect-event';
 import { joinURL, resolveRequestData, resolveServerUrl, withBase, } from '../../utils/url.js';
 const CodeExampleContext = createContext(null);
 export function CodeExampleProvider({ route, examples, initialKey, children, }) {
     const [key, setKey] = useState(initialKey ?? examples[0].key);
     const listeners = useRef([]);
-    const setData = useEffectEvent((data, encoded) => {
-        for (const example of examples) {
-            if (example.key === key) {
-                // persistent changes
-                example.data = data;
-                example.encoded = encoded;
-                break;
-            }
-        }
-        for (const listener of listeners.current) {
-            listener(data, encoded);
-        }
-    });
-    const updateKey = useEffectEvent((newKey) => {
-        const example = examples.find((example) => example.key === newKey);
-        if (!example)
-            return;
-        setKey(newKey);
-        for (const listener of listeners.current) {
-            listener(example.data, example.encoded);
-        }
-    });
-    const addListener = useEffectEvent((listener) => {
-        // initial call to listeners to ensure their data is the latest
-        // this is necessary to avoid race conditions between `useEffect()`
-        const example = examples.find((example) => example.key === key);
-        listener(example.data, example.encoded);
-        listeners.current.push(listener);
-    });
-    const removeListener = useEffectEvent((listener) => {
-        listeners.current = listeners.current.filter((item) => item !== listener);
-    });
+    const examplesRef = useRef(examples);
+    examplesRef.current = examples;
     return (_jsx(CodeExampleContext, { value: useMemo(() => ({
             key,
             route,
-            setKey: updateKey,
-            examples,
-            setData,
-            removeListener,
-            addListener,
-        }), [addListener, examples, key, removeListener, route, setData, updateKey]), children: children }));
+            setKey: (newKey) => {
+                const example = examplesRef.current.find((example) => example.key === newKey);
+                if (!example)
+                    return;
+                setKey(newKey);
+                for (const listener of listeners.current) {
+                    listener(example.data, example.encoded);
+                }
+            },
+            getExample: (key) => {
+                return examplesRef.current.find((example) => example.key === key);
+            },
+            setData: (data, encoded) => {
+                for (const example of examplesRef.current) {
+                    if (example.key === key) {
+                        // persistent changes
+                        example.data = data;
+                        example.encoded = encoded;
+                        break;
+                    }
+                }
+                for (const listener of listeners.current) {
+                    listener(data, encoded);
+                }
+            },
+            removeListener: (listener) => {
+                listeners.current = listeners.current.filter((item) => item !== listener);
+            },
+            addListener: (listener) => {
+                // initial call to listeners to ensure their data is the latest
+                // this is necessary to avoid race conditions between `useEffect()`
+                const example = examplesRef.current.find((example) => example.key === key);
+                listener(example.data, example.encoded);
+                listeners.current.push(listener);
+            },
+        }), [key, route]), children: children }));
 }
 export function CodeExample(sample) {
     const { shikiOptions, mediaAdapters } = useApiContext();
-    const { examples, key, route, addListener, removeListener } = useContext(CodeExampleContext);
+    const { getExample, key, route, addListener, removeListener } = useContext(CodeExampleContext);
     const { server } = useServerSelectContext();
-    const [data, setData] = useState(() => {
-        return examples.find((example) => example.key === key).encoded;
-    });
+    const [data, setData] = useState(() => getExample(key).encoded);
     useEffect(() => {
         const listener = (_, encoded) => setData(encoded);
         addListener(listener);
@@ -91,8 +88,8 @@ function SelectDisplay({ item, ...props }) {
     return (_jsxs("div", { ...props, children: [_jsx("span", { className: "font-medium text-sm", children: item.title }), _jsx("span", { className: "text-fd-muted-foreground", children: item.description })] }));
 }
 export function useRequestInitialData() {
-    const { examples, key } = useContext(CodeExampleContext);
-    return useMemo(() => examples.find((example) => example.key === key).data, [examples, key]);
+    const { getExample, key } = useContext(CodeExampleContext);
+    return getExample(key).data;
 }
 export function useRequestDataUpdater() {
     const { setData } = useContext(CodeExampleContext);

package/dist/utils/pages/to-body.d.ts

@@ -0,0 +1,5 @@
+import type { OutputEntry } from '../../utils/schema-to-pages.js';
+import type { ApiPageProps } from '../../render/api-page.js';
+import type { OpenAPIServer } from '../../server/index.js';
+export declare function toBody(server: OpenAPIServer, entry: OutputEntry): ApiPageProps;
+//# sourceMappingURL=to-body.d.ts.map

package/dist/utils/pages/to-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-body.d.ts","sourceRoot":"","sources":["../../../src/utils/pages/to-body.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,MAAM,CACpB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,WAAW,GACjB,YAAY,CAoBd"}

package/dist/utils/pages/to-body.js

@@ -0,0 +1,20 @@
+export function toBody(server, entry) {
+    if (entry.type === 'operation')
+        return server.getAPIPageProps({
+            hasHead: false,
+            document: entry.schemaId,
+            operations: [entry.item],
+        });
+    if (entry.type === 'webhook')
+        return server.getAPIPageProps({
+            hasHead: false,
+            document: entry.schemaId,
+            webhooks: [entry.item],
+        });
+    return server.getAPIPageProps({
+        hasHead: true,
+        document: entry.schemaId,
+        operations: entry.operations,
+        webhooks: entry.webhooks,
+    });
+}