fumadocs-openapi 9.6.4 → 9.7.0

package/dist/generate-file.d.ts

@@ -1,7 +1,7 @@
 import { type PagesToTextOptions } from './utils/pages/to-text.js';
 import { type ProcessedDocument } from './utils/process-document.js';
 import type { OpenAPIServer } from './server/index.js';
-import { type SchemaToPagesOptions } from './utils/schema-to-pages.js';
+import { type SchemaToPagesOptions } from './utils/pages/preset-auto.js';
 export interface OutputFile {
     path: string;
     content: string;

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,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"}
+{"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,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAInC,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,CA+DvB"}

package/dist/generate-file.js

@@ -5,7 +5,9 @@ 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';
+import { createAutoPreset, } from './utils/pages/preset-auto.js';
+import { isUrl } from './utils/url.js';
+import { fromSchema } from './utils/pages/builder.js';
 export async function generateFiles(options) {
     const files = await generateFilesOnly(options);
     const { output, cwd = process.cwd() } = options;
@@ -52,8 +54,9 @@ export async function generateFilesOnly(options) {
     if (entries.length === 0) {
         throw new Error('No input files found.');
     }
+    const preset = createAutoPreset(options);
     for (const [id, schema] of entries) {
-        const result = schemaToPages(id, schema, options).map((page) => ({
+        const result = fromSchema(id, schema, preset).map((page) => ({
             path: page.path,
             content: toText(page, schema, options),
         }));

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from './generate-file.js';
-export * from './types.js';
 export type { MediaAdapter } from './requests/media/adapter.js';
+export type * from './types.js';
+export type * from './utils/pages/builder.js';
+export type * from './utils/pages/preset-auto.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,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,mBAAmB,SAAS,CAAC;AAC7B,mBAAmB,uBAAuB,CAAC;AAC3C,mBAAmB,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,2 +1 @@
 export * from './generate-file.js';
-export * from './types.js';

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

@@ -12,11 +12,20 @@ export interface ApiPageProps extends SharedOpenAPIOptions {
     webhooks?: WebhookItem[];
 }
 export interface WebhookItem {
+    /**
+     * webhook name in `webhooks`
+     */
     name: string;
     method: OpenAPIV3_1.HttpMethods;
 }
 export interface OperationItem {
+    /**
+     * the path of operation in `paths`
+     */
     path: string;
+    /**
+     * the HTTP method of operation
+     */
     method: OpenAPIV3_1.HttpMethods;
 }
 export declare function APIPage(props: ApiPageProps): Promise<import("react/jsx-runtime").JSX.Element>;

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;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"}
+{"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;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,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/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;AAajB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAYxD,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;AAiBjB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAYxD,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,11 +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 { createMethod, methodKeys, } 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/index.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';
 import { getTypescriptSchema } from '../../utils/get-typescript-schema.js';

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

@@ -1,8 +1,7 @@
-import type * as PageTree from 'fumadocs-core/page-tree';
-import { LoaderPlugin, MetaData, PageData, PageFile, PageTreeTransformer, Source } from 'fumadocs-core/source';
+import type { LoaderPlugin, MetaData, PageData, 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';
+import type { SchemaToPagesOptions } from '../utils/pages/preset-auto.js';
+import type { ApiPageProps } from '../render/api-page.js';
 declare module 'fumadocs-core/source' {
     interface PageData {
         /**
@@ -29,12 +28,6 @@ export declare function openapiSource(from: OpenAPIServer, options?: SchemaToPag
     metaData: MetaData;
     pageData: OpenAPIPageData;
 }>>;
-/**
- * Source API Integration, add this to page tree builder options.
- *
- * @deprecated use `openapiPlugin()`
- */
-export declare const attachFile: (node: PageTree.Item, file: PageFile | undefined) => PageTree.Item;
 /**
  * @deprecated use `openapiPlugin()`
  */

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,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"}
+{"version":3,"file":"source-api.d.ts","sourceRoot":"","sources":["../../src/server/source-api.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,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,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,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,CA+BA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,CAExD"}

package/dist/server/source-api.js

@@ -32,10 +32,11 @@ export function openapiPlugin() {
  */
 export async function openapiSource(from, options = {}) {
     const { baseDir = '' } = options;
-    const { serverToPages } = await import('../utils/schema-to-pages.js');
+    const { createAutoPreset } = await import('../utils/pages/preset-auto.js');
+    const { fromServer } = await import('../utils/pages/builder.js');
     const { toBody } = await import('../utils/pages/to-body.js');
     const files = [];
-    const entries = await serverToPages(from, options);
+    const entries = await fromServer(from, createAutoPreset(options));
     for (const entry of Object.values(entries).flat()) {
         files.push({
             type: 'page',
@@ -55,28 +56,6 @@ export async function openapiSource(from, options = {}) {
         files,
     };
 }
-/**
- * Source API Integration, add this to page tree builder options.
- *
- * @deprecated use `openapiPlugin()`
- */
-export const attachFile = (node, file) => {
-    if (!file)
-        return node;
-    let data = file.data;
-    // backward compatible with older versions with `_openapi` is located in `data.data`
-    if ('data' in data && data.data && typeof data === 'object')
-        data = data.data;
-    let method;
-    if ('_openapi' in data && typeof data._openapi === 'object') {
-        const meta = data._openapi;
-        method = meta.method;
-    }
-    if (method) {
-        node.name = (_jsxs(_Fragment, { children: [node.name, ' ', _jsx(MethodLabel, { className: "ms-auto text-xs text-nowrap", children: method })] }));
-    }
-    return node;
-};
 /**
  * @deprecated use `openapiPlugin()`
  */

package/dist/types.d.ts

@@ -8,20 +8,19 @@ 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;
-export type SecurityRequirementObject = V3_1.SecurityRequirementObject;
 export type SecuritySchemeObject = V3_1.SecuritySchemeObject;
 export type ReferenceObject = V3_1.ReferenceObject;
 export type PathItemObject = V3_1.PathItemObject;
 export type TagObject = V3_1.TagObject;
-export type ServerObject = NoReference<V3_1.ServerObject>;
-export type CallbackObject = NoReference<V3_1.CallbackObject>;
-export type ServerVariableObject = NoReference<V3_1.ServerVariableObject>;
+export type ServerObject = V3_1.ServerObject;
+export type CallbackObject = V3_1.CallbackObject;
+export type ServerVariableObject = V3_1.ServerVariableObject;
 export type MethodInformation = NoReference<OperationObject> & {
     method: string;
 };
 export interface RenderContext extends SharedOpenAPIOptions {
     renderer: Renderer;
-    servers: ServerObject[];
+    servers: NoReference<ServerObject>[];
     slugger: Slugger;
     /**
      * dereferenced schema

package/dist/types.d.ts.map

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

package/dist/ui/contexts/api.d.ts

@@ -1,6 +1,7 @@
 import { type ReactNode } from 'react';
 import type { RenderContext, ServerObject } from '../../types.js';
 import { type MediaAdapter } from '../../requests/media/adapter.js';
+import type { NoReference } from '../../utils/schema.js';
 export interface ApiProviderProps extends Omit<ApiContextType, 'mediaAdapters'> {
     /**
      * Base URL for API requests
@@ -14,7 +15,7 @@ export interface SelectedServer {
     variables: Record<string, string>;
 }
 interface ApiContextType {
-    servers: ServerObject[];
+    servers: NoReference<ServerObject>[];
     shikiOptions: RenderContext['shikiOptions'];
     mediaAdapters: Record<string, MediaAdapter>;
 }

package/dist/ui/contexts/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/ui/contexts/api.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE9E,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;IAC7C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAC7D;AAKD,wBAAgB,aAAa,IAAI,cAAc,CAK9C;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAKzD;AAED,wBAAgB,WAAW,CAAC,EAC1B,cAAc,EACd,QAAQ,EACR,OAAO,EACP,aAAa,EACb,YAAY,GACb,EAAE,gBAAgB,2CA2ElB"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/ui/contexts/api.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;IAC7C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;IACrC,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAC7D;AAKD,wBAAgB,aAAa,IAAI,cAAc,CAK9C;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAKzD;AAED,wBAAgB,WAAW,CAAC,EAC1B,cAAc,EACd,QAAQ,EACR,OAAO,EACP,aAAa,EACb,YAAY,GACb,EAAE,gBAAgB,2CA2ElB"}

package/dist/ui/server-select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-select.d.ts","sourceRoot":"","sources":["../../src/ui/server-select.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,OAAO,CAAC;AAejE,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,cAAc,CAAC,uDAwDzE"}
+{"version":3,"file":"server-select.d.ts","sourceRoot":"","sources":["../../src/ui/server-select.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,OAAO,CAAC;AAgBjE,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,cAAc,CAAC,uDAwDzE"}

package/dist/utils/pages/builder.d.ts

@@ -0,0 +1,87 @@
+import type { ProcessedDocument } from '../../utils/process-document.js';
+import type { OpenAPIServer } from '../../server/index.js';
+import type { OperationItem, WebhookItem } from '../../render/api-page.js';
+import type { OperationObject, PathItemObject, TagObject } from '../../types.js';
+import { type NoReference } from '../../utils/schema.js';
+interface BaseEntry {
+    path: string;
+    schemaId: string;
+    info: {
+        title: string;
+        description?: string;
+    };
+}
+export interface OperationOutput extends BaseEntry {
+    type: 'operation';
+    item: OperationItem;
+}
+export interface WebhookOutput extends BaseEntry {
+    type: 'webhook';
+    item: WebhookItem;
+}
+export interface TagOutput extends BaseEntry {
+    type: 'tag';
+    tag: string;
+    rawTag: TagObject;
+    operations: OperationItem[];
+    webhooks: WebhookItem[];
+}
+export interface OutputGroup extends BaseEntry {
+    type: 'group';
+    operations: OperationItem[];
+    webhooks: WebhookItem[];
+}
+export type OutputEntry = TagOutput | OperationOutput | WebhookOutput | OutputGroup;
+export interface PagesBuilderConfig {
+    toPages: (builder: PagesBuilder) => void;
+}
+export interface PagesBuilder {
+    /**
+     * the input ID in OpenAPI server
+     */
+    id: string;
+    document: ProcessedDocument;
+    /**
+     * add output entry.
+     *
+     * When the `path` property is unspecified, it will generate one.
+     */
+    create: (entry: OutputEntry) => void;
+    /**
+     * get file path from operation path, useful for generating output paths.
+     */
+    routePathToFilePath: (path: string) => string;
+    /**
+     * Extract useful info for rendering
+     */
+    extract: () => ExtractedInfo;
+    fromExtractedWebhook: (item: WebhookItem) => {
+        get displayName(): string;
+        pathItem: NoReference<PathItemObject>;
+        operation: NoReference<OperationObject>;
+    } | undefined;
+    fromExtractedOperation: (item: OperationItem) => {
+        get displayName(): string;
+        pathItem: NoReference<PathItemObject>;
+        operation: NoReference<OperationObject>;
+    } | undefined;
+    fromTag: (tag: TagObject) => {
+        get displayName(): string;
+    };
+    fromTagName: (tag: string) => {
+        info: TagObject;
+        get displayName(): string;
+    } | undefined;
+}
+interface ExtractedInfo {
+    webhooks: (WebhookItem & {
+        tags?: string[];
+    })[];
+    operations: (OperationItem & {
+        tags?: string[];
+    })[];
+}
+export declare function fromServer(server: OpenAPIServer, config: PagesBuilderConfig): Promise<Record<string, OutputEntry[]>>;
+export declare function fromSchema(schemaId: string, processed: ProcessedDocument, config: PagesBuilderConfig): OutputEntry[];
+export {};
+//# sourceMappingURL=builder.d.ts.map

package/dist/utils/pages/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/utils/pages/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAEV,eAAe,EACf,cAAc,EACd,SAAS,EACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAIxB,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,eAAe,GACf,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAErC;;OAEG;IACH,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAE9C;;OAEG;IACH,OAAO,EAAE,MAAM,aAAa,CAAC;IAC7B,oBAAoB,EAAE,CAAC,IAAI,EAAE,WAAW,KACpC;QACE,IAAI,WAAW,IAAI,MAAM,CAAC;QAC1B,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;QACtC,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;KACzC,GACD,SAAS,CAAC;IACd,sBAAsB,EAAE,CAAC,IAAI,EAAE,aAAa,KACxC;QACE,IAAI,WAAW,IAAI,MAAM,CAAC;QAC1B,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;QACtC,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;KACzC,GACD,SAAS,CAAC;IACd,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK;QAC3B,IAAI,WAAW,IAAI,MAAM,CAAC;KAC3B,CAAC;IACF,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KACrB;QACE,IAAI,EAAE,SAAS,CAAC;QAChB,IAAI,WAAW,IAAI,MAAM,CAAC;KAC3B,GACD,SAAS,CAAC;CACf;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,CAAC,WAAW,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EAAE,CAAC;IAChD,UAAU,EAAE,CAAC,aAAa,GAAG;QAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,EAAE,CAAC;CACN;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAcxC;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,kBAAkB,GACzB,WAAW,EAAE,CA2Ef"}

package/dist/utils/pages/builder.js

@@ -0,0 +1,122 @@
+import { getTagDisplayName, methodKeys, } from '../../utils/schema.js';
+import { idToTitle } from '../../utils/id-to-title.js';
+export async function fromServer(server, config) {
+    const schemas = await server.getSchemas();
+    const generated = {};
+    const entries = Object.entries(schemas);
+    if (entries.length === 0) {
+        throw new Error('No input files found.');
+    }
+    for (const [id, schema] of entries) {
+        generated[id] = fromSchema(id, schema, config);
+    }
+    return generated;
+}
+export function fromSchema(schemaId, processed, config) {
+    const files = [];
+    const { toPages } = config;
+    const { dereferenced } = processed;
+    toPages({
+        id: schemaId,
+        document: processed,
+        create(entry) {
+            files.push(entry);
+        },
+        extract: () => extractInfo(dereferenced),
+        routePathToFilePath(path) {
+            return path
+                .toLowerCase()
+                .replaceAll('.', '-')
+                .split('/')
+                .flatMap((v) => {
+                if (v.startsWith('{') && v.endsWith('}'))
+                    return v.slice(1, -1);
+                if (v.length === 0)
+                    return [];
+                return v;
+            })
+                .join('/');
+        },
+        fromExtractedWebhook(item) {
+            const pathItem = dereferenced.webhooks?.[item.name];
+            if (!pathItem)
+                return;
+            const operation = pathItem?.[item.method];
+            if (!operation)
+                return;
+            return {
+                pathItem,
+                operation,
+                get displayName() {
+                    return operation.summary ?? pathItem.summary ?? idToTitle(item.name);
+                },
+            };
+        },
+        fromExtractedOperation(item) {
+            const pathItem = dereferenced.paths?.[item.path];
+            if (!pathItem)
+                return;
+            const operation = pathItem?.[item.method];
+            if (!operation)
+                return;
+            return {
+                pathItem,
+                operation,
+                get displayName() {
+                    return (operation.summary ??
+                        pathItem.summary ??
+                        (operation.operationId
+                            ? idToTitle(operation.operationId)
+                            : item.path));
+                },
+            };
+        },
+        fromTag(tag) {
+            return {
+                get displayName() {
+                    return getTagDisplayName(tag);
+                },
+            };
+        },
+        fromTagName(name) {
+            const tag = dereferenced.tags?.find((item) => item.name === name);
+            if (!tag)
+                return;
+            return {
+                info: tag,
+                ...this.fromTag(tag),
+            };
+        },
+    });
+    return files;
+}
+function extractInfo(document) {
+    const result = { webhooks: [], operations: [] };
+    for (const [path, pathItem] of Object.entries(document.paths ?? {})) {
+        if (!pathItem)
+            continue;
+        for (const methodKey of methodKeys) {
+            if (!pathItem[methodKey])
+                continue;
+            result.operations.push({
+                method: methodKey,
+                path,
+                tags: pathItem[methodKey]?.tags,
+            });
+        }
+    }
+    for (const [name, pathItem] of Object.entries(document.webhooks ?? {})) {
+        if (!pathItem)
+            continue;
+        for (const methodKey of methodKeys) {
+            if (!pathItem[methodKey])
+                continue;
+            result.webhooks.push({
+                method: methodKey,
+                name,
+                tags: pathItem[methodKey]?.tags,
+            });
+        }
+    }
+    return result;
+}

package/dist/utils/pages/preset-auto.d.ts

@@ -0,0 +1,68 @@
+import type { ProcessedDocument } from '../../utils/process-document.js';
+import type { OperationOutput, OutputGroup, PagesBuilder, PagesBuilderConfig, TagOutput, WebhookOutput } from '../../utils/pages/builder.js';
+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)
+     * - a function that aligns group name (folder path) to each entry
+     *
+     * @defaultValue 'none'
+     */
+    groupBy?: 'tag' | 'route' | 'none' | ((entry: OperationOutput | WebhookOutput) => string);
+    /**
+     * Specify name for output file
+     */
+    name?: NameFn<OperationOutput | WebhookOutput> | NameFnOptions;
+}
+interface TagConfig extends BaseConfig {
+    /**
+     * Generate a page for each tag.
+     */
+    per: 'tag';
+    /**
+     * Specify name for output file
+     */
+    name?: NameFn<TagOutput> | NameFnOptions;
+}
+interface SchemaConfig extends BaseConfig {
+    /**
+     * Generate a page for each schema file.
+     */
+    per: 'file';
+    /**
+     * Specify name for output file
+     */
+    name?: NameFn<OutputGroup> | NameFnOptions;
+}
+export type SchemaToPagesOptions = SchemaConfig | TagConfig | OperationConfig | ({
+    per: 'custom';
+} & PagesBuilderConfig);
+type NameFn<Entry> = (this: PagesBuilder, output: Entry, document: ProcessedDocument['dereferenced']) => string;
+interface NameFnOptions {
+    /**
+     * The version of algorithm used to generate file paths.
+     *
+     * v1: Fumadocs OpenAPI v8
+     * v2: Fumadocs OpenAPI v9
+     *
+     * @defaultValue v2
+     */
+    algorithm?: 'v2' | 'v1';
+}
+interface BaseConfig {
+    /**
+     * Custom function to convert names into file names.
+     *
+     * By default, it only escapes whitespaces and upper case (English) characters
+     */
+    slugify?: (name: string) => string;
+}
+export declare function createAutoPreset(options: SchemaToPagesOptions): PagesBuilderConfig;
+export {};
+//# sourceMappingURL=preset-auto.d.ts.map

package/dist/utils/pages/preset-auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-auto.d.ts","sourceRoot":"","sources":["../../../src/utils/pages/preset-auto.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EACV,eAAe,EAEf,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,aAAa,EACd,MAAM,uBAAuB,CAAC;AAG/B,UAAU,eAAgB,SAAQ,UAAU;IAC1C;;OAEG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAElB;;;;;;;;OAQG;IACH,OAAO,CAAC,EACJ,KAAK,GACL,OAAO,GACP,MAAM,GACN,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,KAAK,MAAM,CAAC,CAAC;IAEzD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,eAAe,GAAG,aAAa,CAAC,GAAG,aAAa,CAAC;CAChE;AAED,UAAU,SAAU,SAAQ,UAAU;IACpC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC;IAEX;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC;CAC1C;AAED,UAAU,YAAa,SAAQ,UAAU;IACvC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC;CAC5C;AAED,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,SAAS,GACT,eAAe,GACf,CAAC;IACC,GAAG,EAAE,QAAQ,CAAC;CACf,GAAG,kBAAkB,CAAC,CAAC;AAE5B,KAAK,MAAM,CAAC,KAAK,IAAI,CACnB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,iBAAiB,CAAC,cAAc,CAAC,KACxC,MAAM,CAAC;AAEZ,UAAU,aAAa;IACrB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAED,UAAU,UAAU;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAyLpB"}

package/dist/utils/pages/preset-auto.js

@@ -0,0 +1,138 @@
+import * as path from 'node:path';
+import { isUrl } from '../../utils/url.js';
+export function createAutoPreset(options) {
+    if (options.per === 'custom')
+        return options;
+    const { slugify = (s) => {
+        return s.replace(/\s+/g, '-').toLowerCase();
+    }, } = options;
+    let nameFn;
+    if (typeof options.name === 'function') {
+        nameFn = options.name;
+    }
+    else {
+        const { algorithm = 'v2' } = options.name ?? {};
+        nameFn = function (result, document) {
+            if (result.type === 'tag') {
+                return slugify(result.tag);
+            }
+            if (result.type === 'group') {
+                const schemaId = result.schemaId;
+                return isUrl(schemaId)
+                    ? 'index'
+                    : path.basename(schemaId, path.extname(schemaId));
+            }
+            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(this.routePathToFilePath(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 groupOutput(builder, entry) {
+        const { dereferenced } = builder.document;
+        const { groupBy = 'none' } = options;
+        if (groupBy === 'route') {
+            return [
+                path.join(builder.routePathToFilePath(entry.type === 'operation' ? entry.item.path : entry.item.name), `${entry.item.method.toLowerCase()}.mdx`),
+            ];
+        }
+        const file = nameFn.call(builder, entry, dereferenced);
+        if (groupBy === 'tag') {
+            let tags = entry.type === 'operation'
+                ? dereferenced.paths[entry.item.path][entry.item.method].tags
+                : dereferenced.webhooks[entry.item.name][entry.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`));
+        }
+        if (typeof groupBy === 'function') {
+            return [path.join(slugify(groupBy(entry)), `${file}.mdx`)];
+        }
+        return [`${file}.mdx`];
+    }
+    return {
+        toPages(builder) {
+            const { dereferenced } = builder.document;
+            const items = builder.extract();
+            if (options.per === 'file') {
+                const entry = {
+                    type: 'group',
+                    schemaId: builder.id,
+                    path: '',
+                    info: {
+                        title: dereferenced.info.title,
+                        description: dereferenced.info.description,
+                    },
+                    ...items,
+                };
+                entry.path = nameFn.call(builder, entry, dereferenced) + '.mdx';
+                builder.create(entry);
+                return;
+            }
+            if (options.per === 'tag') {
+                const tags = dereferenced.tags ?? [];
+                for (const tag of tags) {
+                    const { displayName } = builder.fromTag(tag);
+                    const entry = {
+                        type: 'tag',
+                        path: '',
+                        schemaId: builder.id,
+                        info: {
+                            title: displayName,
+                            description: tag.description,
+                        },
+                        webhooks: items.webhooks.filter((webhook) => webhook.tags?.includes(tag.name)),
+                        operations: items.operations.filter((op) => op.tags?.includes(tag.name)),
+                        tag: tag.name,
+                        rawTag: tag,
+                    };
+                    entry.path = nameFn.call(builder, entry, dereferenced) + '.mdx';
+                    builder.create(entry);
+                }
+                return;
+            }
+            for (const op of items.operations) {
+                const { pathItem, operation, displayName } = builder.fromExtractedOperation(op);
+                const entry = {
+                    type: 'operation',
+                    schemaId: builder.id,
+                    item: op,
+                    path: '',
+                    info: {
+                        title: displayName,
+                        description: operation.description ?? pathItem.description,
+                    },
+                };
+                for (const outputPath of groupOutput(builder, entry)) {
+                    builder.create({ ...entry, path: outputPath });
+                }
+            }
+            for (const webhook of items.webhooks) {
+                const { pathItem, operation, displayName } = builder.fromExtractedWebhook(webhook);
+                const entry = {
+                    type: 'webhook',
+                    schemaId: builder.id,
+                    info: {
+                        title: displayName,
+                        description: operation.description ?? pathItem.description,
+                    },
+                    item: webhook,
+                    path: '',
+                };
+                for (const outputPath of groupOutput(builder, entry)) {
+                    builder.create({ ...entry, path: outputPath });
+                }
+            }
+        },
+    };
+}

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

@@ -1,5 +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';
+import type { OutputEntry } from '../../utils/pages/builder.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

@@ -1 +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"}
+{"version":3,"file":"to-body.d.ts","sourceRoot":"","sources":["../../../src/utils/pages/to-body.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wBAAgB,MAAM,CACpB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,WAAW,GACjB,YAAY,CAoBd"}

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

@@ -1,6 +1,6 @@
 import type { ProcessedDocument } from '../../utils/process-document.js';
 import type { TagObject } from '../../types.js';
-import type { OutputEntry } from '../../utils/schema-to-pages.js';
+import type { OutputEntry } from '../../utils/pages/builder.js';
 export interface PagesToTextOptions {
     /**
      * Additional imports of your MDX components.

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

@@ -1 +1 @@
-{"version":3,"file":"to-text.d.ts","sourceRoot":"","sources":["../../../src/utils/pages/to-text.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,SAAS,CAAC;AAKnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC;;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;CACxC;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,kBAAuB,UAuEjC;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CA+BR;AAOD,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"}
+{"version":3,"file":"to-text.d.ts","sourceRoot":"","sources":["../../../src/utils/pages/to-text.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,SAAS,CAAC;AAKnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC;;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;CACxC;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,kBAAuB,UAuEjC;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CA+BR;AAOD,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"}

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

@@ -14,7 +14,7 @@ export function toText(entry, processed, options = {}) {
             }, {
                 type: 'operation',
             });
-        case 'schema':
+        case 'group':
             return generatePage(entry.schemaId, processed, {
                 operations: entry.operations,
                 webhooks: entry.webhooks,

package/dist/utils/schema.d.ts

@@ -1,5 +1,6 @@
 import type { JSONSchema } from 'json-schema-typed/draft-2020-12';
 import type { MethodInformation, OperationObject, PathItemObject, ReferenceObject, TagObject } from '../types.js';
+export declare const methodKeys: readonly ["get", "post", "patch", "delete", "head", "put"];
 export type NoReference<T> = T extends (infer I)[] ? NoReference<I>[] : T extends ReferenceObject ? Exclude<T, ReferenceObject> : T extends object ? {
     [K in keyof T]: NoReference<T[K]>;
 } : T;

package/dist/utils/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC9C,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,eAAe,GACvB,OAAO,CAAC,CAAC,EAAE,eAAe,CAAC,GAC3B,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GACD,CAAC,CAAC;AAEV,KAAK,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACjD,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GACf,CAAC,CAAC;AAER,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AACtC,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;AAEjE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,IAAI,EAAE,CAAC,GACN,MAAM,CAAC,GAAG,SAAS,CAIrB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,CAAC,cAAc,CAAC,EACjC,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC,GACtC,iBAAiB,CAQnB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,UAAU,4DAOb,CAAC;AAEX,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC9C,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,eAAe,GACvB,OAAO,CAAC,CAAC,EAAE,eAAe,CAAC,GAC3B,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GACD,CAAC,CAAC;AAEV,KAAK,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACjD,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GACf,CAAC,CAAC;AAER,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AACtC,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;AAEjE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,IAAI,EAAE,CAAC,GACN,MAAM,CAAC,GAAG,SAAS,CAIrB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,CAAC,cAAc,CAAC,EACjC,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC,GACtC,iBAAiB,CAQnB"}

package/dist/utils/schema.js

@@ -1,4 +1,12 @@
 import { idToTitle } from '../utils/id-to-title.js';
+export const methodKeys = [
+    'get',
+    'post',
+    'patch',
+    'delete',
+    'head',
+    'put',
+];
 export function getPreferredType(body) {
     if ('application/json' in body)
         return 'application/json';

package/dist/utils/url.d.ts

@@ -1,4 +1,5 @@
 import type { RequestData } from '../requests/types.js';
+export declare function isUrl(schemaId: string): boolean;
 export declare function joinURL(base: string, pathname: string): string;
 /**
  * @param url - URL (can be relative)

package/dist/utils/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAMR;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,WAAW,GAC3B,MAAM,CAoCR"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAMR;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,WAAW,GAC3B,MAAM,CAoCR"}

package/dist/utils/url.js

@@ -1,3 +1,6 @@
+export function isUrl(schemaId) {
+    return schemaId.startsWith('https://') || schemaId.startsWith('http://');
+}
 export function joinURL(base, pathname) {
     if (pathname.startsWith('/'))
         pathname = pathname.slice(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "9.6.4",
+  "version": "9.7.0",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -65,8 +65,8 @@
     "remark-rehype": "^11.1.2",
     "tinyglobby": "^0.2.15",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "16.0.3",
-    "fumadocs-ui": "16.0.3"
+    "fumadocs-core": "16.0.4",
+    "fumadocs-ui": "16.0.4"
   },
   "devDependencies": {
     "@scalar/api-client-react": "^1.3.46",
@@ -78,8 +78,8 @@
     "openapi-types": "^12.1.3",
     "tailwindcss": "^4.1.15",
     "tsc-alias": "^1.8.16",
-    "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0"
+    "tsconfig": "0.0.0",
+    "eslint-config-custom": "0.0.0"
   },
   "peerDependencies": {
     "@scalar/api-client-react": "*",

package/dist/build-routes.d.ts

@@ -1,15 +0,0 @@
-import { type Document } from './types.js';
-import type { NoReference } from './utils/schema.js';
-import type { OperationItem, WebhookItem } from './render/api-page.js';
-export declare const methodKeys: readonly ["get", "post", "patch", "delete", "head", "put"];
-type Result = {
-    webhooks: (WebhookItem & {
-        tags?: string[];
-    })[];
-    operations: (OperationItem & {
-        tags?: string[];
-    })[];
-};
-export declare function getAPIPageItems(document: NoReference<Document>): Result;
-export {};
-//# sourceMappingURL=build-routes.d.ts.map

package/dist/build-routes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-routes.d.ts","sourceRoot":"","sources":["../src/build-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGpE,eAAO,MAAM,UAAU,4DAOb,CAAC;AAEX,KAAK,MAAM,GAAG;IACZ,QAAQ,EAAE,CAAC,WAAW,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EAAE,CAAC;IAChD,UAAU,EAAE,CAAC,aAAa,GAAG;QAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,EAAE,CAAC;CACN,CAAC;AAEF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAgCvE"}

package/dist/build-routes.js

@@ -1,38 +0,0 @@
-export const methodKeys = [
-    'get',
-    'post',
-    'patch',
-    'delete',
-    'head',
-    'put',
-];
-export function getAPIPageItems(document) {
-    const result = { webhooks: [], operations: [] };
-    for (const [path, pathItem] of Object.entries(document.paths ?? {})) {
-        if (!pathItem)
-            continue;
-        for (const methodKey of methodKeys) {
-            if (!pathItem[methodKey])
-                continue;
-            result.operations.push({
-                method: methodKey,
-                path,
-                tags: pathItem[methodKey]?.tags,
-            });
-        }
-    }
-    for (const [name, pathItem] of Object.entries(document.webhooks ?? {})) {
-        if (!pathItem)
-            continue;
-        for (const methodKey of methodKeys) {
-            if (!pathItem[methodKey])
-                continue;
-            result.webhooks.push({
-                method: methodKey,
-                name,
-                tags: pathItem[methodKey]?.tags,
-            });
-        }
-    }
-    return result;
-}

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

@@ -1,97 +0,0 @@
-import { type ProcessedDocument } from '../utils/process-document.js';
-import type { OpenAPIServer } from '../server/index.js';
-import type { OperationItem, WebhookItem } from '../render/api-page.js';
-import type { TagObject } from '../types.js';
-interface BaseEntry {
-    path: string;
-    schemaId: string;
-    info: {
-        title: string;
-        description?: string;
-    };
-}
-export interface OutputOperationEntry extends BaseEntry {
-    type: 'operation';
-    item: OperationItem;
-}
-export interface OutputWebhookEntry extends BaseEntry {
-    type: 'webhook';
-    item: WebhookItem;
-}
-export interface OutputTagEntry extends BaseEntry {
-    type: 'tag';
-    tag: string;
-    rawTag: TagObject;
-    operations: OperationItem[];
-    webhooks: WebhookItem[];
-}
-export interface OutputSchemaEntry extends BaseEntry {
-    type: 'schema';
-    operations: OperationItem[];
-    webhooks: WebhookItem[];
-}
-export type OutputEntry = OutputTagEntry | OutputOperationEntry | OutputWebhookEntry | OutputSchemaEntry;
-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?: NameFn<OutputOperationEntry | OutputWebhookEntry>;
-}
-interface TagConfig extends BaseConfig {
-    /**
-     * Generate a page for each tag.
-     */
-    per: 'tag';
-    /**
-     * Specify name for output file
-     */
-    name?: NameFn<OutputTagEntry>;
-}
-interface SchemaConfig extends BaseConfig {
-    /**
-     * Generate a page for each schema file.
-     */
-    per: 'file';
-    /**
-     * Specify name for output file
-     */
-    name?: NameFn<OutputSchemaEntry>;
-}
-export type SchemaToPagesOptions = SchemaConfig | TagConfig | OperationConfig;
-type NameFn<Entry> = ((output: Entry, document: ProcessedDocument['dereferenced']) => string) | {
-    /**
-     * The version of algorithm used to generate file paths.
-     *
-     * v1: Fumadocs OpenAPI v8
-     * v2: Fumadocs OpenAPI v9
-     *
-     * @defaultValue v2
-     */
-    algorithm?: 'v2' | 'v1';
-};
-interface BaseConfig {
-    /**
-     * Custom function to convert names into file names.
-     *
-     * By default, it only escapes whitespaces and upper case (English) characters
-     */
-    slugify?: (name: string) => string;
-}
-export declare function serverToPages(server: OpenAPIServer, options: SchemaToPagesOptions): Promise<Record<string, OutputEntry[]>>;
-export declare function schemaToPages(schemaId: string, processed: ProcessedDocument, options: SchemaToPagesOptions): OutputEntry[];
-export declare function isUrl(schemaId: string): boolean;
-export {};
-//# sourceMappingURL=schema-to-pages.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"schema-to-pages.d.ts","sourceRoot":"","sources":["../../src/utils/schema-to-pages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,CAAC;AAEtB,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,EAAE,MAAM,CAAC,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;CAC1D;AAED,UAAU,SAAU,SAAQ,UAAU;IACpC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC;IAEX;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;CAC/B;AAED,UAAU,YAAa,SAAQ,UAAU;IACvC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,SAAS,GAAG,eAAe,CAAC;AAE9E,KAAK,MAAM,CAAC,KAAK,IACb,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,MAAM,CAAC,GACxE;IACE;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB,CAAC;AAEN,UAAU,UAAU;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAcxC;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,oBAAoB,GAC5B,WAAW,EAAE,CAoJf;AA2CD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE/C"}

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

@@ -1,167 +0,0 @@
-import * as path from 'node:path';
-import { idToTitle } from '../utils/id-to-title.js';
-import { getAPIPageItems } from '../build-routes.js';
-import { getTagDisplayName } from '../utils/schema.js';
-export async function serverToPages(server, options) {
-    const schemas = await server.getSchemas();
-    const generated = {};
-    const entries = Object.entries(schemas);
-    if (entries.length === 0) {
-        throw new Error('No input files found.');
-    }
-    for (const [id, schema] of entries) {
-        generated[id] = schemaToPages(id, schema, options);
-    }
-    return generated;
-}
-export function schemaToPages(schemaId, processed, options) {
-    const files = [];
-    const { dereferenced } = processed;
-    const { slugify = defaultSlugify } = options;
-    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', entry) {
-        if (groupBy === 'route') {
-            return [
-                path.join(getOutputPathFromRoute(entry.type === 'operation' ? entry.item.path : entry.item.name), `${entry.item.method.toLowerCase()}.mdx`),
-            ];
-        }
-        const file = nameFn(entry, dereferenced);
-        if (groupBy === 'tag') {
-            let tags = entry.type === 'operation'
-                ? dereferenced.paths[entry.item.path][entry.item.method].tags
-                : dereferenced.webhooks[entry.item.name][entry.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 items = getAPIPageItems(dereferenced);
-        const entry = {
-            type: 'schema',
-            schemaId,
-            path: '',
-            info: {
-                title: dereferenced.info.title,
-                description: dereferenced.info.description,
-            },
-            ...items,
-        };
-        entry.path = nameFn(entry, dereferenced) + '.mdx';
-        files.push(entry);
-        return files;
-    }
-    if (options.per === 'tag') {
-        const items = getAPIPageItems(dereferenced);
-        const tags = dereferenced.tags ?? [];
-        for (const tag of tags) {
-            const entry = {
-                type: 'tag',
-                path: '',
-                schemaId,
-                info: {
-                    title: getTagDisplayName(tag),
-                    description: tag.description,
-                },
-                webhooks: items.webhooks.filter((webhook) => webhook.tags?.includes(tag.name)),
-                operations: items.operations.filter((op) => op.tags?.includes(tag.name)),
-                tag: tag.name,
-                rawTag: tag,
-            };
-            entry.path = nameFn(entry, dereferenced) + '.mdx';
-            files.push(entry);
-        }
-        return files;
-    }
-    const results = getAPIPageItems(dereferenced);
-    for (const op of results.operations) {
-        const pathItem = dereferenced.paths[op.path];
-        const operation = pathItem[op.method];
-        const entry = {
-            type: 'operation',
-            schemaId,
-            item: op,
-            path: '',
-            info: {
-                title: operation.summary ??
-                    pathItem.summary ??
-                    idToTitle(operation.operationId ?? 'unknown'),
-                description: operation.description ?? pathItem.description,
-            },
-        };
-        for (const outputPath of getOutputPaths(options.groupBy, entry)) {
-            files.push({ ...entry, path: outputPath });
-        }
-    }
-    for (const webhook of results.webhooks) {
-        const pathItem = dereferenced.webhooks[webhook.name];
-        const operation = pathItem[webhook.method];
-        const entry = {
-            type: 'webhook',
-            schemaId,
-            info: {
-                title: operation.summary ?? pathItem.summary ?? idToTitle(webhook.name),
-                description: operation.description ?? pathItem.description,
-            },
-            item: webhook,
-            path: '',
-        };
-        for (const outputPath of getOutputPaths(options.groupBy, entry)) {
-            files.push({ ...entry, path: outputPath });
-        }
-    }
-    return files;
-}
-function defaultNameFn(schemaId, result, document, options, algorithm = 'v2') {
-    const { slugify = defaultSlugify } = options;
-    if (result.type === 'tag') {
-        return slugify(result.tag);
-    }
-    if (result.type === 'schema') {
-        return isUrl(schemaId)
-            ? 'index'
-            : path.basename(schemaId, path.extname(schemaId));
-    }
-    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);
-}
-export function isUrl(schemaId) {
-    return schemaId.startsWith('https://') || schemaId.startsWith('http://');
-}
-function getOutputPathFromRoute(path) {
-    return path
-        .toLowerCase()
-        .replaceAll('.', '-')
-        .split('/')
-        .flatMap((v) => {
-        if (v.startsWith('{') && v.endsWith('}'))
-            return v.slice(1, -1);
-        if (v.length === 0)
-            return [];
-        return v;
-    })
-        .join('/');
-}
-function defaultSlugify(s) {
-    return s.replace(/\s+/g, '-').toLowerCase();
-}