fumadocs-openapi 10.5.0 → 10.6.1

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

@@ -1,6 +1,7 @@
 import { OpenAPIServer } from "./create.js";
 import { ApiPageProps } from "../ui/api-page.js";
 import { SchemaToPagesOptions } from "../utils/pages/preset-auto.js";
+import { ClientApiPageProps } from "../ui/create-client.js";
 import { ProcessedDocument } from "../utils/process-document.js";
 import { LoaderPlugin, MetaData, PageData, PageTreeTransformer, Source } from "fumadocs-core/source";
 import { StructuredData } from "fumadocs-core/mdx-plugins";
@@ -28,6 +29,7 @@ interface OpenAPIPageData extends PageData {
   getSchema: () => {
     id: string;
   } & ProcessedDocument;
+  getClientAPIPageProps: () => Promise<ClientApiPageProps>;
   structuredData: StructuredData;
   toc: TOCItemType[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"source-api.d.ts","names":[],"sources":["../../src/server/source-api.tsx"],"mappings":";;;;;;;;;;YAyBmB,QAAA;IAV+C;;;IAc9D,QAAA,GAAW,mBAAA;EAAA;AAAA;AAAA,UAIE,mBAAA;EACf,MAAA;EACA,OAAA;AAAA;AAFF;;;AAAA,iBAQgB,aAAA,CAAA,GAAiB,YAAA;AAAA,UAuCvB,eAAA,SAAwB,QAAA;EAChC,eAAA,QAAuB,YAAA;EACvB,SAAA;IAAmB,EAAA;EAAA,IAAe,iBAAA;EAClC,cAAA,EAAgB,cAAA;EAChB,GAAA,EAAK,WAAA;AAAA;AAAA,UAGG,WAAA;EACR,WAAA;AAAA;;;;iBAMoB,aAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA,GAAS,oBAAA;EACP,OAAA,WAjB8B;EAmB9B,IAAA,aAAiB,WAAA;AAAA,IAElB,OAAA,CACD,MAAA;EACE,QAAA,EAAU,QAAA;EACV,QAAA,EAAU,eAAA;AAAA;;;;iBA6HE,kBAAA,CAAA,GAAsB,mBAAA"}
+{"version":3,"file":"source-api.d.ts","names":[],"sources":["../../src/server/source-api.tsx"],"mappings":";;;;;;;;;;;YA2BmB,QAAA;IAJ0C;;;IAQzD,QAAA,GAAW,mBAAA;EAAA;AAAA;AAAA,UAIE,mBAAA;EACf,MAAA;EACA,OAAA;AAAA;AAFF;;;AAAA,iBAQgB,aAAA,CAAA,GAAiB,YAAA;AAAA,UAuCvB,eAAA,SAAwB,QAAA;EAChC,eAAA,QAAuB,YAAA;EACvB,SAAA;IAAmB,EAAA;EAAA,IAAe,iBAAA;EAClC,qBAAA,QAA6B,OAAA,CAAQ,kBAAA;EACrC,cAAA,EAAgB,cAAA;EAChB,GAAA,EAAK,WAAA;AAAA;AAAA,UAGG,WAAA;EACR,WAAA;AAAA;;;;iBAMoB,aAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA,GAAS,oBAAA;EACP,OAAA,WAlBsC;EAoBtC,IAAA,aAAiB,WAAA;AAAA,IAElB,OAAA,CACD,MAAA;EACE,QAAA,EAAU,QAAA;EACV,QAAA,EAAU,eAAA;AAAA;;;;iBAqIE,kBAAA,CAAA,GAAsB,mBAAA"}

package/dist/server/source-api.js

@@ -1,3 +1,4 @@
+import { toStaticData } from "../utils/pages/to-static-data.js";
 import { MethodLabel } from "../ui/components/method-label.js";
 import path from "node:path";
 import { PathUtils } from "fumadocs-core/source";
@@ -43,7 +44,6 @@ async function openapiSource(server, options = {}) {
 	const { baseDir = "", meta = false } = options;
 	const { createAutoPreset } = await import("../utils/pages/preset-auto.js");
 	const { fromServer } = await import("../utils/pages/builder.js");
-	const { toStaticData } = await import("../utils/pages/to-static-data.js");
 	const files = [];
 	const entries = await fromServer(server, createAutoPreset(options));
 	for (const [schemaId, list] of Object.entries(entries)) {
@@ -58,6 +58,15 @@ async function openapiSource(server, options = {}) {
 					getAPIPageProps() {
 						return props;
 					},
+					async getClientAPIPageProps() {
+						return {
+							payload: {
+								bundled: processed.bundled,
+								proxyUrl: server.options.proxyUrl
+							},
+							...props
+						};
+					},
 					getSchema() {
 						return {
 							id: schemaId,

package/dist/server/source-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-api.js","names":[],"sources":["../../src/server/source-api.tsx"],"sourcesContent":["import { MethodLabel } from '@/ui/components/method-label';\nimport {\n  PathUtils,\n  type LoaderPlugin,\n  type MetaData,\n  type PageData,\n  type PageTreeTransformer,\n  type Source,\n  type VirtualFile,\n} from 'fumadocs-core/source';\nimport type { OpenAPIServer } from '@/server/create';\nimport type { SchemaToPagesOptions } from '@/utils/pages/preset-auto';\nimport type { ApiPageProps } from '@/ui/api-page';\nimport type { StructuredData } from 'fumadocs-core/mdx-plugins';\nimport type { TOCItemType } from 'fumadocs-core/toc';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport type {\n  OperationOutput,\n  OutputEntry,\n  PageOutput,\n  WebhookOutput,\n} from '@/utils/pages/builder';\nimport path from 'node:path';\n\ndeclare module 'fumadocs-core/source' {\n  export interface PageData {\n    /**\n     * Added by Fumadocs OpenAPI\n     */\n    _openapi?: InternalOpenAPIMeta;\n  }\n}\n\nexport interface InternalOpenAPIMeta {\n  method?: string;\n  webhook?: boolean;\n}\n\n/**\n * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.\n */\nexport function openapiPlugin(): LoaderPlugin {\n  return {\n    name: 'fumadocs:openapi',\n    enforce: 'pre',\n    transformPageTree: {\n      file(node, filePath) {\n        if (!filePath) return node;\n        const file = this.storage.read(filePath);\n        if (!file || file.format !== 'page') return node;\n\n        const openApiData = file.data._openapi;\n        if (!openApiData || typeof openApiData !== 'object') return node;\n\n        if (openApiData.webhook) {\n          node.name = (\n            <>\n              {node.name}{' '}\n              <span className=\"ms-auto border border-current px-1 rounded-lg text-xs text-nowrap font-mono\">\n                Webhook\n              </span>\n            </>\n          );\n        } else if (openApiData.method) {\n          node.name = (\n            <>\n              {node.name}{' '}\n              <MethodLabel className=\"ms-auto text-xs text-nowrap\">\n                {openApiData.method}\n              </MethodLabel>\n            </>\n          );\n        }\n\n        return node;\n      },\n    },\n  };\n}\n\ninterface OpenAPIPageData extends PageData {\n  getAPIPageProps: () => ApiPageProps;\n  getSchema: () => { id: string } & ProcessedDocument;\n  structuredData: StructuredData;\n  toc: TOCItemType[];\n}\n\ninterface MetaOptions {\n  folderStyle?: 'folder' | 'separator';\n}\n\n/**\n * Generate virtual pages for Fumadocs Source API\n */\nexport async function openapiSource(\n  server: OpenAPIServer,\n  options: SchemaToPagesOptions & {\n    baseDir?: string;\n    /** Generate `meta.json` files */\n    meta?: boolean | MetaOptions;\n  } = {},\n): Promise<\n  Source<{\n    metaData: MetaData;\n    pageData: OpenAPIPageData;\n  }>\n> {\n  const { baseDir = '', meta = false } = options;\n  const { createAutoPreset } = await import('@/utils/pages/preset-auto');\n  const { fromServer } = await import('@/utils/pages/builder');\n  const { toStaticData } = await import('@/utils/pages/to-static-data');\n  const files: VirtualFile<{\n    pageData: OpenAPIPageData;\n    metaData: MetaData;\n  }>[] = [];\n\n  const entries = await fromServer(server, createAutoPreset(options));\n  for (const [schemaId, list] of Object.entries(entries)) {\n    const processed = await server.getSchema(schemaId);\n\n    function onEntry(entry: PageOutput | OperationOutput | WebhookOutput) {\n      const props = getProps(entry);\n\n      files.push({\n        type: 'page',\n        path: `${baseDir}/${entry.path}`,\n        data: {\n          ...entry.info,\n          getAPIPageProps() {\n            return props;\n          },\n          getSchema() {\n            return {\n              id: schemaId,\n              ...processed,\n            };\n          },\n          ...toStaticData(props, processed.dereferenced),\n          _openapi: {\n            method:\n              entry.type === 'operation' || entry.type === 'webhook'\n                ? entry.item.method\n                : undefined,\n            webhook: entry.type === 'webhook',\n          },\n        },\n      });\n    }\n\n    function onEntries(entries: OutputEntry[], parent?: OutputEntry) {\n      if (!meta) {\n        for (const entry of entries) {\n          if (entry.type === 'group') {\n            onEntries(entry.entries, entry);\n          } else {\n            onEntry(entry);\n          }\n        }\n\n        return;\n      }\n\n      const { folderStyle = 'folder' } = meta === true ? {} : meta;\n      const pages: string[] = [];\n\n      for (const entry of entries) {\n        const relativePath = PathUtils.slash(\n          parent ? path.relative(parent.path, entry.path) : entry.path,\n        );\n\n        if (entry.type === 'group') {\n          onEntries(entry.entries, entry);\n          if (folderStyle === 'folder') {\n            pages.push(relativePath);\n          } else {\n            pages.push(`---${entry.info.title}---`, `...${relativePath}`);\n          }\n        } else {\n          onEntry(entry);\n          pages.push(relativePath.slice(0, -path.extname(entry.path).length));\n        }\n      }\n\n      if (pages.length === 0) return;\n      files.push({\n        type: 'meta',\n        path: path.join(baseDir, parent?.path ?? '', 'meta.json'),\n        data: {\n          title: parent?.info.title,\n          description: parent?.info.description,\n          pages,\n        },\n      });\n    }\n\n    onEntries(list);\n  }\n\n  return {\n    files,\n  };\n}\n\nfunction getProps(entry: PageOutput | OperationOutput | WebhookOutput): ApiPageProps {\n  if (entry.type === 'operation')\n    return {\n      document: entry.schemaId,\n      operations: [entry.item],\n      showDescription: true,\n    };\n  if (entry.type === 'webhook')\n    return {\n      document: entry.schemaId,\n      webhooks: [entry.item],\n      showDescription: true,\n    };\n\n  return {\n    showTitle: true,\n    showDescription: true,\n    document: entry.schemaId,\n    operations: entry.operations,\n    webhooks: entry.webhooks,\n  };\n}\n\n/**\n * @deprecated use `openapiPlugin()`\n */\nexport function transformerOpenAPI(): PageTreeTransformer {\n  return openapiPlugin().transformPageTree!;\n}\n"],"mappings":"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"}
+{"version":3,"file":"source-api.js","names":[],"sources":["../../src/server/source-api.tsx"],"sourcesContent":["import { MethodLabel } from '@/ui/components/method-label';\nimport {\n  PathUtils,\n  type LoaderPlugin,\n  type MetaData,\n  type PageData,\n  type PageTreeTransformer,\n  type Source,\n  type VirtualFile,\n} from 'fumadocs-core/source';\nimport type { OpenAPIServer } from '@/server/create';\nimport type { SchemaToPagesOptions } from '@/utils/pages/preset-auto';\nimport type { ApiPageProps } from '@/ui/api-page';\nimport type { StructuredData } from 'fumadocs-core/mdx-plugins';\nimport type { TOCItemType } from 'fumadocs-core/toc';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport type {\n  OperationOutput,\n  OutputEntry,\n  PageOutput,\n  WebhookOutput,\n} from '@/utils/pages/builder';\nimport path from 'node:path';\nimport type { ClientApiPageProps } from '@/ui/create-client';\nimport { toStaticData } from '@/utils/pages/to-static-data';\n\ndeclare module 'fumadocs-core/source' {\n  export interface PageData {\n    /**\n     * Added by Fumadocs OpenAPI\n     */\n    _openapi?: InternalOpenAPIMeta;\n  }\n}\n\nexport interface InternalOpenAPIMeta {\n  method?: string;\n  webhook?: boolean;\n}\n\n/**\n * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.\n */\nexport function openapiPlugin(): LoaderPlugin {\n  return {\n    name: 'fumadocs:openapi',\n    enforce: 'pre',\n    transformPageTree: {\n      file(node, filePath) {\n        if (!filePath) return node;\n        const file = this.storage.read(filePath);\n        if (!file || file.format !== 'page') return node;\n\n        const openApiData = file.data._openapi;\n        if (!openApiData || typeof openApiData !== 'object') return node;\n\n        if (openApiData.webhook) {\n          node.name = (\n            <>\n              {node.name}{' '}\n              <span className=\"ms-auto border border-current px-1 rounded-lg text-xs text-nowrap font-mono\">\n                Webhook\n              </span>\n            </>\n          );\n        } else if (openApiData.method) {\n          node.name = (\n            <>\n              {node.name}{' '}\n              <MethodLabel className=\"ms-auto text-xs text-nowrap\">\n                {openApiData.method}\n              </MethodLabel>\n            </>\n          );\n        }\n\n        return node;\n      },\n    },\n  };\n}\n\ninterface OpenAPIPageData extends PageData {\n  getAPIPageProps: () => ApiPageProps;\n  getSchema: () => { id: string } & ProcessedDocument;\n  getClientAPIPageProps: () => Promise<ClientApiPageProps>;\n  structuredData: StructuredData;\n  toc: TOCItemType[];\n}\n\ninterface MetaOptions {\n  folderStyle?: 'folder' | 'separator';\n}\n\n/**\n * Generate virtual pages for Fumadocs Source API\n */\nexport async function openapiSource(\n  server: OpenAPIServer,\n  options: SchemaToPagesOptions & {\n    baseDir?: string;\n    /** Generate `meta.json` files */\n    meta?: boolean | MetaOptions;\n  } = {},\n): Promise<\n  Source<{\n    metaData: MetaData;\n    pageData: OpenAPIPageData;\n  }>\n> {\n  const { baseDir = '', meta = false } = options;\n  const { createAutoPreset } = await import('@/utils/pages/preset-auto');\n  const { fromServer } = await import('@/utils/pages/builder');\n  const files: VirtualFile<{\n    pageData: OpenAPIPageData;\n    metaData: MetaData;\n  }>[] = [];\n\n  const entries = await fromServer(server, createAutoPreset(options));\n  for (const [schemaId, list] of Object.entries(entries)) {\n    const processed = await server.getSchema(schemaId);\n\n    function onEntry(entry: PageOutput | OperationOutput | WebhookOutput) {\n      const props = getProps(entry);\n\n      files.push({\n        type: 'page',\n        path: `${baseDir}/${entry.path}`,\n        data: {\n          ...entry.info,\n          getAPIPageProps() {\n            return props;\n          },\n          async getClientAPIPageProps() {\n            return {\n              payload: {\n                bundled: processed.bundled,\n                proxyUrl: server.options.proxyUrl,\n              },\n              ...props,\n            };\n          },\n          getSchema() {\n            return {\n              id: schemaId,\n              ...processed,\n            };\n          },\n          ...toStaticData(props, processed.dereferenced),\n          _openapi: {\n            method:\n              entry.type === 'operation' || entry.type === 'webhook'\n                ? entry.item.method\n                : undefined,\n            webhook: entry.type === 'webhook',\n          },\n        },\n      });\n    }\n\n    function onEntries(entries: OutputEntry[], parent?: OutputEntry) {\n      if (!meta) {\n        for (const entry of entries) {\n          if (entry.type === 'group') {\n            onEntries(entry.entries, entry);\n          } else {\n            onEntry(entry);\n          }\n        }\n\n        return;\n      }\n\n      const { folderStyle = 'folder' } = meta === true ? {} : meta;\n      const pages: string[] = [];\n\n      for (const entry of entries) {\n        const relativePath = PathUtils.slash(\n          parent ? path.relative(parent.path, entry.path) : entry.path,\n        );\n\n        if (entry.type === 'group') {\n          onEntries(entry.entries, entry);\n          if (folderStyle === 'folder') {\n            pages.push(relativePath);\n          } else {\n            pages.push(`---${entry.info.title}---`, `...${relativePath}`);\n          }\n        } else {\n          onEntry(entry);\n          pages.push(relativePath.slice(0, -path.extname(entry.path).length));\n        }\n      }\n\n      if (pages.length === 0) return;\n      files.push({\n        type: 'meta',\n        path: path.join(baseDir, parent?.path ?? '', 'meta.json'),\n        data: {\n          title: parent?.info.title,\n          description: parent?.info.description,\n          pages,\n        },\n      });\n    }\n\n    onEntries(list);\n  }\n\n  return {\n    files,\n  };\n}\n\nfunction getProps(entry: PageOutput | OperationOutput | WebhookOutput): ApiPageProps {\n  if (entry.type === 'operation')\n    return {\n      document: entry.schemaId,\n      operations: [entry.item],\n      showDescription: true,\n    };\n  if (entry.type === 'webhook')\n    return {\n      document: entry.schemaId,\n      webhooks: [entry.item],\n      showDescription: true,\n    };\n\n  return {\n    showTitle: true,\n    showDescription: true,\n    document: entry.schemaId,\n    operations: entry.operations,\n    webhooks: entry.webhooks,\n  };\n}\n\n/**\n * @deprecated use `openapiPlugin()`\n */\nexport function transformerOpenAPI(): PageTreeTransformer {\n  return openapiPlugin().transformPageTree!;\n}\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -1,11 +1,10 @@
 import { OpenAPIV3, OpenAPIV3_2 } from "./_openapi/types.js";
-import { NoReference } from "./utils/schema.js";
+import { NoReference } from "./utils/schema/index.js";
 import { MediaAdapter } from "./requests/media/adapter.js";
 import { InlineCodeUsageGenerator } from "./requests/generators/index.js";
 import { OpenAPIOptions } from "./server/create.js";
 import { CreateAPIPageOptions } from "./ui/base.js";
 import { ProcessedDocument } from "./utils/process-document.js";
-import Slugger from "github-slugger";
 import { HTMLAttributes, ReactNode } from "react";
 
 //#region src/types.d.ts
@@ -32,8 +31,7 @@ type MethodInformation = NoReference<OperationObject> & {
   'x-exclusiveCodeSample'?: string;
 };
 type RequireKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
-interface RenderContext extends Pick<OpenAPIOptions, 'proxyUrl'>, Omit<RequireKeys<CreateAPIPageOptions, 'generateTypeScriptDefinitions' | 'renderMarkdown'>, 'renderCodeBlock' | 'renderHeading'> {
-  slugger: Slugger;
+interface RenderContext extends Pick<OpenAPIOptions, 'proxyUrl'>, Omit<RequireKeys<CreateAPIPageOptions, 'renderMarkdown' | 'generateTypeScriptDefinitions'>, 'renderCodeBlock' | 'renderHeading' | 'generateTypeScriptSchema'> {
   /**
    * dereferenced schema
    */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;KAUY,QAAA,GAAW,WAAA,CAAY,QAAA;AAAA,KACvB,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,oBAAA,GAAuB,WAAA,CAAY,oBAAA;AAAA,KACnC,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,SAAA,GAAY,WAAA,CAAY,SAAA;AAAA,KACxB,YAAA,GAAe,WAAA,CAAY,YAAA;AAAA,KAC3B,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,oBAAA,GAAuB,SAAA,CAAU,oBAAA;AAAA,KACjC,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,oBAAA,GAAuB,WAAA,CAAY,oBAAA;AAAA,KACnC,WAAA,GAAc,WAAA,CAAY,WAAA;AAAA,KAC1B,aAAA,GAAgB,WAAA,CAAY,aAAA;AAAA,KAC5B,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,iBAAA,GAAoB,WAAA,CAAY,iBAAA;AAAA,KAEhC,iBAAA,GAAoB,WAAA,CAAY,eAAA;EAC1C,MAAA;EACA,eAAA,GAAkB,wBAAA;EAClB,sBAAA;EACA,uBAAA;AAAA;AAAA,KAGG,WAAA,oBAA+B,CAAA,IAAK,IAAA,CAAK,CAAA,EAAG,CAAA,IAAK,QAAA,CAAS,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,UAEtD,aAAA,SAEb,IAAA,CAAK,cAAA,eACL,IAAA,CACE,WAAA,CAAY,oBAAA;EAGhB,OAAA,EAAS,OAAA;;;;EAKT,MAAA,EAAQ,iBAAA;EAER,aAAA,EAAe,MAAA,SAAe,YAAA;EAE9B,aAAA,GACE,KAAA,UACA,IAAA,WAAe,SAAA,EACf,KAAA,GAAQ,cAAA,CAAe,kBAAA;IAAwB,EAAA;EAAA,MAC5C,SAAA;EACL,eAAA,GAAkB,IAAA,UAAc,IAAA,aAAiB,SAAA;AAAA;AAAA,KAGvC,gBAAA,cAA8B,WAAA,IAAe,CAAA,mBAAoB,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,KACzE,SAAA,MAAe,CAAA,GAAI,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;KASY,QAAA,GAAW,WAAA,CAAY,QAAA;AAAA,KACvB,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,oBAAA,GAAuB,WAAA,CAAY,oBAAA;AAAA,KACnC,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,SAAA,GAAY,WAAA,CAAY,SAAA;AAAA,KACxB,YAAA,GAAe,WAAA,CAAY,YAAA;AAAA,KAC3B,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,oBAAA,GAAuB,SAAA,CAAU,oBAAA;AAAA,KACjC,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,oBAAA,GAAuB,WAAA,CAAY,oBAAA;AAAA,KACnC,WAAA,GAAc,WAAA,CAAY,WAAA;AAAA,KAC1B,aAAA,GAAgB,WAAA,CAAY,aAAA;AAAA,KAC5B,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,iBAAA,GAAoB,WAAA,CAAY,iBAAA;AAAA,KAEhC,iBAAA,GAAoB,WAAA,CAAY,eAAA;EAC1C,MAAA;EACA,eAAA,GAAkB,wBAAA;EAClB,sBAAA;EACA,uBAAA;AAAA;AAAA,KAGG,WAAA,oBAA+B,CAAA,IAAK,IAAA,CAAK,CAAA,EAAG,CAAA,IAAK,QAAA,CAAS,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,UAEtD,aAAA,SAEb,IAAA,CAAK,cAAA,eACL,IAAA,CACE,WAAA,CAAY,oBAAA;EA1BS;;;EAgCzB,MAAA,EAAQ,iBAAA;EAER,aAAA,EAAe,MAAA,SAAe,YAAA;EAE9B,aAAA,GACE,KAAA,UACA,IAAA,WAAe,SAAA,EACf,KAAA,GAAQ,cAAA,CAAe,kBAAA;IAAwB,EAAA;EAAA,MAC5C,SAAA;EACL,eAAA,GAAkB,IAAA,UAAc,IAAA,aAAiB,SAAA;AAAA;AAAA,KAGvC,gBAAA,cAA8B,WAAA,IAAe,CAAA,mBAAoB,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,KACzE,SAAA,MAAe,CAAA,GAAI,OAAA,CAAQ,CAAA"}

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

@@ -1,9 +1,7 @@
 import { HttpMethods } from "../types.js";
-import { ProcessedDocument } from "../utils/process-document.js";
-
 //#region src/ui/api-page.d.ts
 interface ApiPageProps {
-  document: Promise<ProcessedDocument> | string | ProcessedDocument;
+  document: string;
   showTitle?: boolean;
   showDescription?: boolean;
   /**

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

@@ -1 +1 @@
-{"version":3,"file":"api-page.d.ts","names":[],"sources":["../../src/ui/api-page.tsx"],"mappings":";;;;UAMiB,YAAA;EACf,QAAA,EAAU,OAAA,CAAQ,iBAAA,aAA8B,iBAAA;EAChD,SAAA;EACA,eAAA;;;;EAKA,UAAA,GAAa,aAAA;EAEb,QAAA,GAAW,WAAA;AAAA;AAAA,UAGI,WAAA;EAHO;;;EAOtB,IAAA;EACA,MAAA,EAAQ,WAAA;AAAA;AAAA,UAGO,aAAA;EAbf;;;EAiBA,IAAA;EAfsB;;AAGxB;EAgBE,MAAA,EAAQ,WAAA;AAAA"}
+{"version":3,"file":"api-page.d.ts","names":[],"sources":["../../src/ui/api-page.tsx"],"mappings":";;UAKiB,YAAA;EACf,QAAA;EACA,SAAA;EACA,eAAA;EAH2B;;;EAQ3B,UAAA,GAAa,aAAA;EAEb,QAAA,GAAW,WAAA;AAAA;AAAA,UAGI,WAAA;EALF;;;EASb,IAAA;EACA,MAAA,EAAQ,WAAA;AAAA;AAAA,UAGO,aAAA;;;;EAIf,IAAA;EAPQ;;;EAWR,MAAA,EAAQ,WAAA;AAAA"}

package/dist/ui/api-page.js

@@ -1,16 +1,16 @@
-import { createMethod } from "../utils/schema.js";
+import { createMethod } from "../utils/schema/index.js";
 import { ApiProviderLazy, ServerProviderLazy } from "./contexts/api.lazy.js";
 import { Operation } from "./operation/index.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/ui/api-page.tsx
-async function APIPage({ showTitle: hasHead = false, showDescription, operations, webhooks, ctx }) {
+function APIPage({ showTitle: hasHead = false, showDescription, operations, webhooks, ctx }) {
 	const { dereferenced } = ctx.schema;
 	let { renderPageLayout } = ctx.content ?? {};
 	renderPageLayout ??= (slots) => /* @__PURE__ */ jsxs("div", {
 		className: "flex flex-col gap-24 text-sm @container",
 		children: [slots.operations?.map((op) => op.children), slots.webhooks?.map((op) => op.children)]
 	});
-	const content = await renderPageLayout({
+	const content = renderPageLayout({
 		operations: operations?.map((item) => {
 			const pathItem = dereferenced.paths?.[item.path];
 			if (!pathItem) throw new Error(`[Fumadocs OpenAPI] Path not found in OpenAPI schema: ${item.path}`);
@@ -45,13 +45,11 @@ async function APIPage({ showTitle: hasHead = false, showDescription, operations
 			};
 		})
 	}, ctx);
-	let servers = ctx.schema.dereferenced.servers;
-	if (!servers || servers.length === 0) servers = [{ url: "/" }];
 	return /* @__PURE__ */ jsx(ApiProviderLazy, {
 		shikiOptions: ctx.shikiOptions,
 		client: ctx.client ?? {},
 		children: /* @__PURE__ */ jsx(ServerProviderLazy, {
-			servers,
+			servers: dereferenced.servers,
 			children: content
 		})
 	});

package/dist/ui/api-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-page.js","names":[],"sources":["../../src/ui/api-page.tsx"],"sourcesContent":["import { Operation } from '@/ui/operation';\nimport type { HttpMethods, RenderContext } from '@/types';\nimport { createMethod } from '@/utils/schema';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport { ApiProviderLazy, ServerProviderLazy } from './contexts/api.lazy';\n\nexport interface ApiPageProps {\n  document: Promise<ProcessedDocument> | string | ProcessedDocument;\n  showTitle?: boolean;\n  showDescription?: boolean;\n\n  /**\n   * An array of operations\n   */\n  operations?: OperationItem[];\n\n  webhooks?: WebhookItem[];\n}\n\nexport interface WebhookItem {\n  /**\n   * webhook name in `webhooks`\n   */\n  name: string;\n  method: HttpMethods;\n}\n\nexport interface OperationItem {\n  /**\n   * the path of operation in `paths`\n   */\n  path: string;\n  /**\n   * the HTTP method of operation\n   */\n  method: HttpMethods;\n}\n\nexport async function APIPage({\n  showTitle: hasHead = false,\n  showDescription,\n  operations,\n  webhooks,\n  ctx,\n}: Omit<ApiPageProps, 'document'> & {\n  ctx: RenderContext;\n}) {\n  const { dereferenced } = ctx.schema;\n  let { renderPageLayout } = ctx.content ?? {};\n  renderPageLayout ??= (slots) => (\n    <div className=\"flex flex-col gap-24 text-sm @container\">\n      {slots.operations?.map((op) => op.children)}\n      {slots.webhooks?.map((op) => op.children)}\n    </div>\n  );\n\n  const content = await renderPageLayout(\n    {\n      operations: operations?.map((item) => {\n        const pathItem = dereferenced.paths?.[item.path];\n        if (!pathItem)\n          throw new Error(`[Fumadocs OpenAPI] Path not found in OpenAPI schema: ${item.path}`);\n\n        const operation = pathItem[item.method];\n        if (!operation)\n          throw new Error(\n            `[Fumadocs OpenAPI] Method ${item.method} not found in operation: ${item.path}`,\n          );\n\n        const method = createMethod(item.method, pathItem, operation);\n\n        return {\n          item,\n          children: (\n            <Operation\n              key={`${item.path}:${item.method}`}\n              method={method}\n              path={item.path}\n              ctx={ctx}\n              showTitle={hasHead}\n              showDescription={showDescription}\n            />\n          ),\n        };\n      }),\n      webhooks: webhooks?.map((item) => {\n        const webhook = dereferenced.webhooks?.[item.name];\n        if (!webhook)\n          throw new Error(`[Fumadocs OpenAPI] Webhook not found in OpenAPI schema: ${item.name}`);\n\n        const hook = webhook[item.method];\n        if (!hook)\n          throw new Error(\n            `[Fumadocs OpenAPI] Method ${item.method} not found in webhook: ${item.name}`,\n          );\n\n        return {\n          item,\n          children: (\n            <Operation\n              type=\"webhook\"\n              key={`${item.name}:${item.method}`}\n              method={createMethod(item.method, webhook, hook)}\n              ctx={ctx}\n              path={`/${item.name}`}\n              showTitle={hasHead}\n              showDescription={showDescription}\n            />\n          ),\n        };\n      }),\n    },\n    ctx,\n  );\n  let servers = ctx.schema.dereferenced.servers;\n  if (!servers || servers.length === 0) servers = [{ url: '/' }];\n\n  return (\n    <ApiProviderLazy shikiOptions={ctx.shikiOptions} client={ctx.client ?? {}}>\n      <ServerProviderLazy servers={servers}>{content}</ServerProviderLazy>\n    </ApiProviderLazy>\n  );\n}\n"],"mappings":";;;;;AAsCA,eAAsB,QAAQ,EAC5B,WAAW,UAAU,OACrB,iBACA,YACA,UACA,OAGC;CACD,MAAM,EAAE,iBAAiB,IAAI;CAC7B,IAAI,EAAE,qBAAqB,IAAI,WAAW,EAAE;AAC5C,uBAAsB,UACpB,qBAAC,OAAD;EAAK,WAAU;YAAf,CACG,MAAM,YAAY,KAAK,OAAO,GAAG,SAAS,EAC1C,MAAM,UAAU,KAAK,OAAO,GAAG,SAAS,CACrC;;CAGR,MAAM,UAAU,MAAM,iBACpB;EACE,YAAY,YAAY,KAAK,SAAS;GACpC,MAAM,WAAW,aAAa,QAAQ,KAAK;AAC3C,OAAI,CAAC,SACH,OAAM,IAAI,MAAM,wDAAwD,KAAK,OAAO;GAEtF,MAAM,YAAY,SAAS,KAAK;AAChC,OAAI,CAAC,UACH,OAAM,IAAI,MACR,6BAA6B,KAAK,OAAO,2BAA2B,KAAK,OAC1E;AAIH,UAAO;IACL;IACA,UACE,oBAAC,WAAD;KAEE,QAPS,aAAa,KAAK,QAAQ,UAAU,UAAU;KAQvD,MAAM,KAAK;KACN;KACL,WAAW;KACM;KACjB,EANK,GAAG,KAAK,KAAK,GAAG,KAAK,SAM1B;IAEL;IACD;EACF,UAAU,UAAU,KAAK,SAAS;GAChC,MAAM,UAAU,aAAa,WAAW,KAAK;AAC7C,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,2DAA2D,KAAK,OAAO;GAEzF,MAAM,OAAO,QAAQ,KAAK;AAC1B,OAAI,CAAC,KACH,OAAM,IAAI,MACR,6BAA6B,KAAK,OAAO,yBAAyB,KAAK,OACxE;AAEH,UAAO;IACL;IACA,UACE,oBAAC,WAAD;KACE,MAAK;KAEL,QAAQ,aAAa,KAAK,QAAQ,SAAS,KAAK;KAC3C;KACL,MAAM,IAAI,KAAK;KACf,WAAW;KACM;KACjB,EANK,GAAG,KAAK,KAAK,GAAG,KAAK,SAM1B;IAEL;IACD;EACH,EACD,IACD;CACD,IAAI,UAAU,IAAI,OAAO,aAAa;AACtC,KAAI,CAAC,WAAW,QAAQ,WAAW,EAAG,WAAU,CAAC,EAAE,KAAK,KAAK,CAAC;AAE9D,QACE,oBAAC,iBAAD;EAAiB,cAAc,IAAI;EAAc,QAAQ,IAAI,UAAU,EAAE;YACvE,oBAAC,oBAAD;GAA6B;aAAU;GAA6B,CAAA;EACpD,CAAA"}
+{"version":3,"file":"api-page.js","names":[],"sources":["../../src/ui/api-page.tsx"],"sourcesContent":["import { Operation } from '@/ui/operation';\nimport type { HttpMethods, RenderContext, ServerObject } from '@/types';\nimport { createMethod } from '@/utils/schema';\nimport { ApiProviderLazy, ServerProviderLazy } from './contexts/api.lazy';\n\nexport interface ApiPageProps {\n  document: string;\n  showTitle?: boolean;\n  showDescription?: boolean;\n\n  /**\n   * An array of operations\n   */\n  operations?: OperationItem[];\n\n  webhooks?: WebhookItem[];\n}\n\nexport interface WebhookItem {\n  /**\n   * webhook name in `webhooks`\n   */\n  name: string;\n  method: HttpMethods;\n}\n\nexport interface OperationItem {\n  /**\n   * the path of operation in `paths`\n   */\n  path: string;\n  /**\n   * the HTTP method of operation\n   */\n  method: HttpMethods;\n}\n\nexport function APIPage({\n  showTitle: hasHead = false,\n  showDescription,\n  operations,\n  webhooks,\n  ctx,\n}: Omit<ApiPageProps, 'document'> & {\n  ctx: RenderContext;\n}) {\n  const { dereferenced } = ctx.schema;\n  let { renderPageLayout } = ctx.content ?? {};\n  renderPageLayout ??= (slots) => (\n    <div className=\"flex flex-col gap-24 text-sm @container\">\n      {slots.operations?.map((op) => op.children)}\n      {slots.webhooks?.map((op) => op.children)}\n    </div>\n  );\n\n  const content = renderPageLayout(\n    {\n      operations: operations?.map((item) => {\n        const pathItem = dereferenced.paths?.[item.path];\n        if (!pathItem)\n          throw new Error(`[Fumadocs OpenAPI] Path not found in OpenAPI schema: ${item.path}`);\n\n        const operation = pathItem[item.method];\n        if (!operation)\n          throw new Error(\n            `[Fumadocs OpenAPI] Method ${item.method} not found in operation: ${item.path}`,\n          );\n\n        const method = createMethod(item.method, pathItem, operation);\n\n        return {\n          item,\n          children: (\n            <Operation\n              key={`${item.path}:${item.method}`}\n              method={method}\n              path={item.path}\n              ctx={ctx}\n              showTitle={hasHead}\n              showDescription={showDescription}\n            />\n          ),\n        };\n      }),\n      webhooks: webhooks?.map((item) => {\n        const webhook = dereferenced.webhooks?.[item.name];\n        if (!webhook)\n          throw new Error(`[Fumadocs OpenAPI] Webhook not found in OpenAPI schema: ${item.name}`);\n\n        const hook = webhook[item.method];\n        if (!hook)\n          throw new Error(\n            `[Fumadocs OpenAPI] Method ${item.method} not found in webhook: ${item.name}`,\n          );\n\n        return {\n          item,\n          children: (\n            <Operation\n              type=\"webhook\"\n              key={`${item.name}:${item.method}`}\n              method={createMethod(item.method, webhook, hook)}\n              ctx={ctx}\n              path={`/${item.name}`}\n              showTitle={hasHead}\n              showDescription={showDescription}\n            />\n          ),\n        };\n      }),\n    },\n    ctx,\n  );\n\n  return (\n    <ApiProviderLazy shikiOptions={ctx.shikiOptions} client={ctx.client ?? {}}>\n      <ServerProviderLazy servers={dereferenced.servers as ServerObject[]}>\n        {content}\n      </ServerProviderLazy>\n    </ApiProviderLazy>\n  );\n}\n"],"mappings":";;;;;AAqCA,SAAgB,QAAQ,EACtB,WAAW,UAAU,OACrB,iBACA,YACA,UACA,OAGC;CACD,MAAM,EAAE,iBAAiB,IAAI;CAC7B,IAAI,EAAE,qBAAqB,IAAI,WAAW,EAAE;AAC5C,uBAAsB,UACpB,qBAAC,OAAD;EAAK,WAAU;YAAf,CACG,MAAM,YAAY,KAAK,OAAO,GAAG,SAAS,EAC1C,MAAM,UAAU,KAAK,OAAO,GAAG,SAAS,CACrC;;CAGR,MAAM,UAAU,iBACd;EACE,YAAY,YAAY,KAAK,SAAS;GACpC,MAAM,WAAW,aAAa,QAAQ,KAAK;AAC3C,OAAI,CAAC,SACH,OAAM,IAAI,MAAM,wDAAwD,KAAK,OAAO;GAEtF,MAAM,YAAY,SAAS,KAAK;AAChC,OAAI,CAAC,UACH,OAAM,IAAI,MACR,6BAA6B,KAAK,OAAO,2BAA2B,KAAK,OAC1E;AAIH,UAAO;IACL;IACA,UACE,oBAAC,WAAD;KAEE,QAPS,aAAa,KAAK,QAAQ,UAAU,UAAU;KAQvD,MAAM,KAAK;KACN;KACL,WAAW;KACM;KACjB,EANK,GAAG,KAAK,KAAK,GAAG,KAAK,SAM1B;IAEL;IACD;EACF,UAAU,UAAU,KAAK,SAAS;GAChC,MAAM,UAAU,aAAa,WAAW,KAAK;AAC7C,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,2DAA2D,KAAK,OAAO;GAEzF,MAAM,OAAO,QAAQ,KAAK;AAC1B,OAAI,CAAC,KACH,OAAM,IAAI,MACR,6BAA6B,KAAK,OAAO,yBAAyB,KAAK,OACxE;AAEH,UAAO;IACL;IACA,UACE,oBAAC,WAAD;KACE,MAAK;KAEL,QAAQ,aAAa,KAAK,QAAQ,SAAS,KAAK;KAC3C;KACL,MAAM,IAAI,KAAK;KACf,WAAW;KACM;KACjB,EANK,GAAG,KAAK,KAAK,GAAG,KAAK,SAM1B;IAEL;IACD;EACH,EACD,IACD;AAED,QACE,oBAAC,iBAAD;EAAiB,cAAc,IAAI;EAAc,QAAQ,IAAI,UAAU,EAAE;YACvE,oBAAC,oBAAD;GAAoB,SAAS,aAAa;aACvC;GACkB,CAAA;EACL,CAAA"}

package/dist/ui/base.d.ts

@@ -1,14 +1,15 @@
-import { NoReference } from "../utils/schema.js";
+import { NoReference } from "../utils/schema/index.js";
 import { MediaAdapter } from "../requests/media/adapter.js";
 import { CodeUsageGeneratorRegistry, InlineCodeUsageGenerator } from "../requests/generators/index.js";
 import { OpenAPIServer } from "../server/create.js";
 import { ApiPageProps, OperationItem, WebhookItem } from "./api-page.js";
-import { ExampleRequestItem } from "./operation/request-tabs.js";
+import { ExampleRequestItem } from "./operation/get-example-requests.js";
 import { APIPageClientOptions } from "./client/index.js";
 import { SchemaUIOptions } from "./schema/index.js";
 import { ResponseTab } from "./operation/response-tabs.js";
 import { ClientCodeBlockProvider } from "./components/codeblock.js";
 import { Awaitable, MethodInformation, RenderContext } from "../types.js";
+import { ProcessedDocument } from "../utils/process-document.js";
 import { FC, HTMLAttributes, ReactNode } from "react";
 import { ShikiFactory } from "fumadocs-core/highlight/shiki";
 import { JSONSchema } from "json-schema-typed";
@@ -41,7 +42,7 @@ interface CreateAPIPageOptions {
    *
    * Pass `false` to disable it.
    */
-  generateTypeScriptDefinitions?: (schema: JSONSchema, ctx: GenerateTypeScriptDefinitionsContext) => Awaitable<string | undefined>;
+  generateTypeScriptDefinitions?: ((schema: JSONSchema, ctx: GenerateTypeScriptDefinitionsContext) => Awaitable<string | undefined>) | false;
   /**
    * Generate example code usage for all endpoints.
    */
@@ -49,7 +50,7 @@ interface CreateAPIPageOptions {
   /**
    * Generate example code usage for each endpoint.
    */
-  generateCodeSamples?: (method: MethodInformation) => Awaitable<InlineCodeUsageGenerator[]>;
+  generateCodeSamples?: (method: MethodInformation) => InlineCodeUsageGenerator[];
   shiki: ShikiFactory;
   renderMarkdown?: (md: string) => ReactNode;
   shikiOptions: Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BundledTheme>;
@@ -67,20 +68,20 @@ interface CreateAPIPageOptions {
    * Customise page content
    */
   content?: {
-    renderResponseTabs?: (tabs: ResponseTab[], ctx: RenderContext) => Awaitable<ReactNode>;
+    renderResponseTabs?: (tabs: ResponseTab[], ctx: RenderContext) => ReactNode;
     renderRequestTabs?: (items: ExampleRequestItem[], ctx: RenderContext & {
       route: string;
       operation: NoReference<MethodInformation>;
-    }) => Awaitable<ReactNode>;
+    }) => ReactNode;
     renderAPIExampleLayout?: (slots: {
       selector: ReactNode;
       usageTabs: ReactNode;
       responseTabs: ReactNode;
-    }, ctx: RenderContext) => Awaitable<ReactNode>;
+    }, ctx: RenderContext) => ReactNode;
     /**
      * @param generators - codegens for API example usages
      */
-    renderAPIExampleUsageTabs?: (generators: CodeUsageGeneratorRegistry, ctx: RenderContext) => Awaitable<ReactNode>;
+    renderAPIExampleUsageTabs?: (generators: CodeUsageGeneratorRegistry, ctx: RenderContext) => ReactNode;
     /**
      * renderer of the entire page's layout (containing all operations & webhooks UI)
      */
@@ -93,7 +94,7 @@ interface CreateAPIPageOptions {
         item: WebhookItem;
         children: ReactNode;
       }[];
-    }, ctx: RenderContext) => Awaitable<ReactNode>;
+    }, ctx: RenderContext) => ReactNode;
     renderOperationLayout?: (slots: {
       header: ReactNode;
       description: ReactNode;
@@ -104,7 +105,7 @@ interface CreateAPIPageOptions {
       body: ReactNode;
       responses: ReactNode;
       callbacks: ReactNode;
-    }, ctx: RenderContext, method: NoReference<MethodInformation>) => Awaitable<ReactNode>;
+    }, ctx: RenderContext, method: NoReference<MethodInformation>) => ReactNode;
     renderWebhookLayout?: (slots: {
       header: ReactNode;
       description: ReactNode;
@@ -114,13 +115,13 @@ interface CreateAPIPageOptions {
       requests: ReactNode;
       responses: ReactNode;
       callbacks: ReactNode;
-    }) => Awaitable<ReactNode>;
+    }) => ReactNode;
   };
   /**
    * Info UI for JSON schemas
    */
   schemaUI?: {
-    render?: (options: SchemaUIOptions, ctx: RenderContext) => Awaitable<ReactNode>;
+    render?: (options: SchemaUIOptions, ctx: RenderContext) => ReactNode;
     /**
      * Show examples under the generated content of JSON schemas.
      *
@@ -145,14 +146,17 @@ interface CreateAPIPageOptions {
       ctx: RenderContext;
     }) => Awaitable<ReactNode>;
   };
-  renderHeading?: (props: HTMLAttributes<HTMLHeadingElement>, depth: number) => Awaitable<ReactNode>;
+  renderHeading?: (props: HTMLAttributes<HTMLHeadingElement>, depth: number) => ReactNode;
   renderCodeBlock?: (props: {
     lang: string;
     code: string;
-  }) => Awaitable<ReactNode>;
+  }) => ReactNode;
   client?: APIPageClientOptions;
 }
-declare function createAPIPage(server: OpenAPIServer, options: CreateAPIPageOptions): FC<ApiPageProps>;
+interface ServerApiPageProps extends Omit<ApiPageProps, 'document'> {
+  document: string | ProcessedDocument;
+}
+declare function createAPIPage(server: OpenAPIServer, options: CreateAPIPageOptions): FC<ServerApiPageProps>;
 //#endregion
-export { ClientCodeBlockProvider, CreateAPIPageOptions, GenerateTypeScriptDefinitionsContext, createAPIPage };
+export { ClientCodeBlockProvider, CreateAPIPageOptions, GenerateTypeScriptDefinitionsContext, ServerApiPageProps, createAPIPage };
 //# sourceMappingURL=base.d.ts.map

package/dist/ui/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/ui/base.tsx"],"mappings":";;;;;;;;;;;;;;;;;UA2BiB,oCAAA,SAA6C,aAAA;EAC5D,SAAA,EAAW,WAAA,CAAY,iBAAA;EACvB,QAAA;EACA,SAAA;EAHe;EAKf,gBAAA;IACE,UAAA;IACA,WAAA;EAAA;AAAA;AAAA,UAIa,oBAAA;EAX0D;;;;;;;;;EAqBzE,wBAAA,KAEM,MAAA,EAAQ,WAAA,CAAY,iBAAA,GACpB,UAAA,UACA,WAAA,UACA,GAAA,EAAK,aAAA,KACF,SAAA;EApBI;;AAIf;;;EAwBE,6BAAA,IACE,MAAA,EAAQ,UAAA,EACR,GAAA,EAAK,oCAAA,KACF,SAAA;EAfS;;;EAoBd,UAAA,GAAa,0BAAA;EANN;;;EAWP,mBAAA,IAAuB,MAAA,EAAQ,iBAAA,KAAsB,SAAA,CAAU,wBAAA;EAE/D,KAAA,EAAO,YAAA;EACP,cAAA,IAAkB,EAAA,aAAe,SAAA;EACjC,YAAA,EAAc,IAAA,CAAK,uBAAA,YAAmC,iBAAA,CAAkB,YAAA;EADvC;;;;;EAQjC,kBAAA;EAKgB;;;EAAhB,aAAA,GAAgB,MAAA,SAAe,YAAA;EAMqC;;;EADpE,OAAA;IACE,kBAAA,IAAsB,IAAA,EAAM,WAAA,IAAe,GAAA,EAAK,aAAA,KAAkB,SAAA,CAAU,SAAA;IAE5E,iBAAA,IACE,KAAA,EAAO,kBAAA,IACP,GAAA,EAAK,aAAA;MACH,KAAA;MACA,SAAA,EAAW,WAAA,CAAY,iBAAA;IAAA,MAEtB,SAAA,CAAU,SAAA;IAEf,sBAAA,IACE,KAAA;MACE,QAAA,EAAU,SAAA;MACV,SAAA,EAAW,SAAA;MACX,YAAA,EAAc,SAAA;IAAA,GAEhB,GAAA,EAAK,aAAA,KACF,SAAA,CAAU,SAAA;IAOR;;;IAFP,yBAAA,IACE,UAAA,EAAY,0BAAA,EACZ,GAAA,EAAK,aAAA,KACF,SAAA,CAAU,SAAA;IASC;;;IAJhB,gBAAA,IACE,KAAA;MACE,UAAA;QACE,IAAA,EAAM,aAAA;QACN,QAAA,EAAU,SAAA;MAAA;MAEZ,QAAA;QACE,IAAA,EAAM,WAAA;QACN,QAAA,EAAU,SAAA;MAAA;IAAA,GAGd,GAAA,EAAK,aAAA,KACF,SAAA,CAAU,SAAA;IAEf,qBAAA,IACE,KAAA;MACE,MAAA,EAAQ,SAAA;MACR,WAAA,EAAa,SAAA;MACb,UAAA,EAAY,SAAA;MACZ,aAAA,EAAe,SAAA;MAEf,WAAA,EAAa,SAAA;MACb,UAAA,EAAY,SAAA;MACZ,IAAA,EAAM,SAAA;MACN,SAAA,EAAW,SAAA;MACX,SAAA,EAAW,SAAA;IAAA,GAEb,GAAA,EAAK,aAAA,EACL,MAAA,EAAQ,WAAA,CAAY,iBAAA,MACjB,SAAA,CAAU,SAAA;IAEf,mBAAA,IAAuB,KAAA;MACrB,MAAA,EAAQ,SAAA;MACR,WAAA,EAAa,SAAA;MACb,WAAA,EAAa,SAAA;MACb,UAAA,EAAY,SAAA;MACZ,IAAA,EAAM,SAAA;MACN,QAAA,EAAU,SAAA;MACV,SAAA,EAAW,SAAA;MACX,SAAA,EAAW,SAAA;IAAA,MACP,SAAA,CAAU,SAAA;EAAA;EA+BT;;;EAzBT,QAAA;IACE,MAAA,IAAU,OAAA,EAAS,eAAA,EAAiB,GAAA,EAAK,aAAA,KAAkB,SAAA,CAAU,SAAA;IA+BxD;;;;;IAxBb,WAAA;EAAA;EArIF;;;EA2IA,UAAA;IAxIM;;;IA4IJ,OAAA;IAzIO;;;IA6IP,MAAA,IAAU,KAAA;MACR,IAAA;MACA,MAAA,EAAQ,iBAAA;MACR,GAAA,EAAK,aAAA;IAAA,MACD,SAAA,CAAU,SAAA;EAAA;EAGlB,aAAA,IACE,KAAA,EAAO,cAAA,CAAe,kBAAA,GACtB,KAAA,aACG,SAAA,CAAU,SAAA;EACf,eAAA,IAAmB,KAAA;IAAS,IAAA;IAAc,IAAA;EAAA,MAAmB,SAAA,CAAU,SAAA;EAEvE,MAAA,GAAS,oBAAA;AAAA;AAAA,iBAGK,aAAA,CACd,MAAA,EAAQ,aAAA,EACR,OAAA,EAAS,oBAAA,GACR,EAAA,CAAG,YAAA"}
+{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/ui/base.tsx"],"mappings":"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"}

package/dist/ui/base.js

@@ -13,6 +13,7 @@ import remarkRehype from "remark-rehype";
 import { toJsxRuntime } from "hast-util-to-jsx-runtime";
 import { CodeBlock, Pre } from "fumadocs-ui/components/codeblock";
 import { highlightHast } from "fumadocs-core/highlight/shiki";
+import { compile } from "@fumari/json-schema-ts";
 //#region src/ui/base.tsx
 function createAPIPage(server, options) {
 	let processor;
@@ -37,7 +38,7 @@ function createAPIPage(server, options) {
 	return async function APIPageWrapper({ document, ...props }) {
 		let processed;
 		if (typeof document === "string") processed = await server.getSchema(document);
-		else processed = await document;
+		else processed = document;
 		const slugger = new Slugger();
 		const ctx = {
 			schema: processed,
@@ -47,8 +48,7 @@ function createAPIPage(server, options) {
 				...defaultAdapters,
 				...options.mediaAdapters
 			},
-			slugger,
-			async renderHeading(depth, text, props) {
+			renderHeading(depth, text, props) {
 				const id = typeof text === "string" ? slugger.slug(text) : props?.id;
 				if (!id) throw new Error("missing 'id' for non-string children");
 				if (options.renderHeading) return options.renderHeading({
@@ -63,14 +63,23 @@ function createAPIPage(server, options) {
 					children: text
 				}, id);
 			},
-			generateTypeScriptDefinitions(schema, ctx) {
-				const { generateTypeScriptSchema, generateTypeScriptDefinitions } = options;
-				if (generateTypeScriptSchema && ctx._internal_legacy) {
+			generateTypeScriptDefinitions: options.generateTypeScriptDefinitions ?? ((schema, ctx) => {
+				if (options.generateTypeScriptSchema && ctx._internal_legacy) {
 					const { statusCode, contentType } = ctx._internal_legacy;
-					return generateTypeScriptSchema(ctx.operation, statusCode, contentType, ctx);
+					return options.generateTypeScriptSchema(ctx.operation, statusCode, contentType, ctx);
 				}
-				return generateTypeScriptDefinitions?.(schema, ctx);
-			},
+				if (typeof schema !== "object") return;
+				try {
+					return compile(schema, {
+						name: "Response",
+						readOnly: ctx.readOnly,
+						writeOnly: ctx.writeOnly,
+						getSchemaId: ctx.schema.getRawRef
+					});
+				} catch (e) {
+					console.warn("Failed to generate typescript schema:", e);
+				}
+			}),
 			async renderMarkdown(text) {
 				if (options.renderMarkdown) return options.renderMarkdown(text);
 				processor ??= createMarkdownProcessor();

package/dist/ui/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","names":[],"sources":["../../src/ui/base.tsx"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any -- rehype-react without types */\nimport Slugger from 'github-slugger';\nimport type { Awaitable, MethodInformation, RenderContext } from '@/types';\nimport type { NoReference } from '@/utils/schema';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport { defaultAdapters, MediaAdapter } from '@/requests/media/adapter';\nimport type { FC, HTMLAttributes, ReactNode } from 'react';\nimport type { OpenAPIServer } from '@/server';\nimport type { APIPageClientOptions } from './client';\nimport { Heading } from 'fumadocs-ui/components/heading';\nimport { createRehypeCode } from 'fumadocs-core/mdx-plugins/rehype-code.core';\nimport { remarkGfm } from 'fumadocs-core/mdx-plugins/remark-gfm';\nimport defaultMdxComponents from 'fumadocs-ui/mdx';\nimport { remark } from 'remark';\nimport remarkRehype from 'remark-rehype';\nimport { toJsxRuntime } from 'hast-util-to-jsx-runtime';\nimport * as JsxRuntime from 'react/jsx-runtime';\nimport { CodeBlock, Pre } from 'fumadocs-ui/components/codeblock';\nimport type { SchemaUIOptions } from './schema';\nimport type { ResponseTab } from './operation/response-tabs';\nimport type { ExampleRequestItem } from './operation/request-tabs';\nimport { APIPage, type ApiPageProps, type OperationItem, type WebhookItem } from './api-page';\nimport type { CodeUsageGeneratorRegistry, InlineCodeUsageGenerator } from '@/requests/generators';\nimport type { JSONSchema } from 'json-schema-typed';\nimport type { BundledTheme, CodeOptionsThemes, CodeToHastOptionsCommon } from 'shiki';\nimport { highlightHast, type ShikiFactory } from 'fumadocs-core/highlight/shiki';\n\nexport interface GenerateTypeScriptDefinitionsContext extends RenderContext {\n  operation: NoReference<MethodInformation>;\n  readOnly: boolean;\n  writeOnly: boolean;\n  /** @deprecated */\n  _internal_legacy?: {\n    statusCode: string;\n    contentType: string;\n  };\n}\n\nexport interface CreateAPIPageOptions {\n  /**\n   * Generate TypeScript definitions from response schema.\n   *\n   * Pass `false` to disable it.\n   *\n   * @param method - the operation object\n   * @param statusCode - status code\n   * @deprecated use `generateTypeScriptDefinitions` instead.\n   */\n  generateTypeScriptSchema?:\n    | ((\n        method: NoReference<MethodInformation>,\n        statusCode: string,\n        contentType: string,\n        ctx: RenderContext,\n      ) => Awaitable<string | undefined>)\n    | false;\n\n  /**\n   * Generate TypeScript definitions from JSON schema.\n   *\n   * Pass `false` to disable it.\n   */\n  generateTypeScriptDefinitions?: (\n    schema: JSONSchema,\n    ctx: GenerateTypeScriptDefinitionsContext,\n  ) => Awaitable<string | undefined>;\n\n  /**\n   * Generate example code usage for all endpoints.\n   */\n  codeUsages?: CodeUsageGeneratorRegistry;\n\n  /**\n   * Generate example code usage for each endpoint.\n   */\n  generateCodeSamples?: (method: MethodInformation) => Awaitable<InlineCodeUsageGenerator[]>;\n\n  shiki: ShikiFactory;\n  renderMarkdown?: (md: string) => ReactNode;\n  shikiOptions: Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BundledTheme>;\n\n  /**\n   * Show full response schema instead of only example response & Typescript definitions.\n   *\n   * @default true\n   */\n  showResponseSchema?: boolean;\n\n  /**\n   * Support other media types (for server-side generation).\n   */\n  mediaAdapters?: Record<string, MediaAdapter>;\n\n  /**\n   * Customise page content\n   */\n  content?: {\n    renderResponseTabs?: (tabs: ResponseTab[], ctx: RenderContext) => Awaitable<ReactNode>;\n\n    renderRequestTabs?: (\n      items: ExampleRequestItem[],\n      ctx: RenderContext & {\n        route: string;\n        operation: NoReference<MethodInformation>;\n      },\n    ) => Awaitable<ReactNode>;\n\n    renderAPIExampleLayout?: (\n      slots: {\n        selector: ReactNode;\n        usageTabs: ReactNode;\n        responseTabs: ReactNode;\n      },\n      ctx: RenderContext,\n    ) => Awaitable<ReactNode>;\n\n    /**\n     * @param generators - codegens for API example usages\n     */\n    renderAPIExampleUsageTabs?: (\n      generators: CodeUsageGeneratorRegistry,\n      ctx: RenderContext,\n    ) => Awaitable<ReactNode>;\n\n    /**\n     * renderer of the entire page's layout (containing all operations & webhooks UI)\n     */\n    renderPageLayout?: (\n      slots: {\n        operations?: {\n          item: OperationItem;\n          children: ReactNode;\n        }[];\n        webhooks?: {\n          item: WebhookItem;\n          children: ReactNode;\n        }[];\n      },\n      ctx: RenderContext,\n    ) => Awaitable<ReactNode>;\n\n    renderOperationLayout?: (\n      slots: {\n        header: ReactNode;\n        description: ReactNode;\n        apiExample: ReactNode;\n        apiPlayground: ReactNode;\n\n        authSchemes: ReactNode;\n        parameters: ReactNode;\n        body: ReactNode;\n        responses: ReactNode;\n        callbacks: ReactNode;\n      },\n      ctx: RenderContext,\n      method: NoReference<MethodInformation>,\n    ) => Awaitable<ReactNode>;\n\n    renderWebhookLayout?: (slots: {\n      header: ReactNode;\n      description: ReactNode;\n      authSchemes: ReactNode;\n      parameters: ReactNode;\n      body: ReactNode;\n      requests: ReactNode;\n      responses: ReactNode;\n      callbacks: ReactNode;\n    }) => Awaitable<ReactNode>;\n  };\n\n  /**\n   * Info UI for JSON schemas\n   */\n  schemaUI?: {\n    render?: (options: SchemaUIOptions, ctx: RenderContext) => Awaitable<ReactNode>;\n\n    /**\n     * Show examples under the generated content of JSON schemas.\n     *\n     * @defaultValue false\n     */\n    showExample?: boolean;\n  };\n\n  /**\n   * Customise API playground\n   */\n  playground?: {\n    /**\n     * @defaultValue true\n     */\n    enabled?: boolean;\n    /**\n     * replace the server-side renderer\n     */\n    render?: (props: {\n      path: string;\n      method: MethodInformation;\n      ctx: RenderContext;\n    }) => Awaitable<ReactNode>;\n  };\n\n  renderHeading?: (\n    props: HTMLAttributes<HTMLHeadingElement>,\n    depth: number,\n  ) => Awaitable<ReactNode>;\n  renderCodeBlock?: (props: { lang: string; code: string }) => Awaitable<ReactNode>;\n\n  client?: APIPageClientOptions;\n}\n\nexport function createAPIPage(\n  server: OpenAPIServer,\n  options: CreateAPIPageOptions,\n): FC<ApiPageProps> {\n  let processor: ReturnType<typeof createMarkdownProcessor>;\n\n  function createMarkdownProcessor() {\n    function rehypeReact(this: any) {\n      this.compiler = (tree: any, file: any) => {\n        return toJsxRuntime(tree, {\n          development: false,\n          filePath: file.path,\n          ...JsxRuntime,\n          components: defaultMdxComponents,\n        });\n      };\n    }\n\n    return remark()\n      .use(remarkGfm)\n      .use(remarkRehype)\n      .use(createRehypeCode(options.shiki), {\n        langs: [],\n        lazy: true,\n        defaultColor: false,\n        ...options.shikiOptions,\n      })\n      .use(rehypeReact);\n  }\n\n  return async function APIPageWrapper({ document, ...props }) {\n    let processed: ProcessedDocument;\n    if (typeof document === 'string') {\n      processed = await server.getSchema(document);\n    } else {\n      processed = await document;\n    }\n\n    const slugger = new Slugger();\n\n    const ctx: RenderContext = {\n      schema: processed,\n      proxyUrl: server.options.proxyUrl,\n      ...options,\n      mediaAdapters: {\n        ...defaultAdapters,\n        ...options.mediaAdapters,\n      },\n      slugger,\n      async renderHeading(depth, text, props) {\n        const id = typeof text === 'string' ? slugger.slug(text) : props?.id;\n        if (!id) throw new Error(\"missing 'id' for non-string children\");\n\n        if (options.renderHeading) {\n          return options.renderHeading({ id, children: text, ...props }, depth);\n        }\n\n        return (\n          <Heading id={id} key={id} as={`h${depth}` as `h1`} {...props}>\n            {text}\n          </Heading>\n        );\n      },\n      generateTypeScriptDefinitions(schema, ctx) {\n        const { generateTypeScriptSchema, generateTypeScriptDefinitions } = options;\n        if (generateTypeScriptSchema && ctx._internal_legacy) {\n          const { statusCode, contentType } = ctx._internal_legacy;\n          return generateTypeScriptSchema(ctx.operation, statusCode, contentType, ctx);\n        }\n\n        return generateTypeScriptDefinitions?.(schema, ctx);\n      },\n      async renderMarkdown(text) {\n        if (options.renderMarkdown) return options.renderMarkdown(text);\n        processor ??= createMarkdownProcessor();\n\n        const out = await processor.process({\n          value: text,\n        });\n\n        return out.result as ReactNode;\n      },\n      async renderCodeBlock(lang, code) {\n        if (options.renderCodeBlock) {\n          return options.renderCodeBlock({ lang, code });\n        }\n\n        const hast = await highlightHast(await options.shiki.getOrInit(), code, {\n          lang,\n          defaultColor: false,\n          ...options.shikiOptions,\n        });\n        const rendered = toJsxRuntime(hast, {\n          ...JsxRuntime,\n          components: {\n            pre: Pre,\n          },\n        });\n\n        return <CodeBlock className=\"my-0\">{rendered}</CodeBlock>;\n      },\n    };\n\n    return <APIPage {...props} ctx={ctx} />;\n  };\n}\n\nexport { ClientCodeBlockProvider } from './components/codeblock';\n"],"mappings":";;;;;;;;;;;;;;;;AAmNA,SAAgB,cACd,QACA,SACkB;CAClB,IAAI;CAEJ,SAAS,0BAA0B;EACjC,SAAS,cAAuB;AAC9B,QAAK,YAAY,MAAW,SAAc;AACxC,WAAO,aAAa,MAAM;KACxB,aAAa;KACb,UAAU,KAAK;KACf,GAAG;KACH,YAAY;KACb,CAAC;;;AAIN,SAAO,QAAQ,CACZ,IAAI,UAAU,CACd,IAAI,aAAa,CACjB,IAAI,iBAAiB,QAAQ,MAAM,EAAE;GACpC,OAAO,EAAE;GACT,MAAM;GACN,cAAc;GACd,GAAG,QAAQ;GACZ,CAAC,CACD,IAAI,YAAY;;AAGrB,QAAO,eAAe,eAAe,EAAE,UAAU,GAAG,SAAS;EAC3D,IAAI;AACJ,MAAI,OAAO,aAAa,SACtB,aAAY,MAAM,OAAO,UAAU,SAAS;MAE5C,aAAY,MAAM;EAGpB,MAAM,UAAU,IAAI,SAAS;EAE7B,MAAM,MAAqB;GACzB,QAAQ;GACR,UAAU,OAAO,QAAQ;GACzB,GAAG;GACH,eAAe;IACb,GAAG;IACH,GAAG,QAAQ;IACZ;GACD;GACA,MAAM,cAAc,OAAO,MAAM,OAAO;IACtC,MAAM,KAAK,OAAO,SAAS,WAAW,QAAQ,KAAK,KAAK,GAAG,OAAO;AAClE,QAAI,CAAC,GAAI,OAAM,IAAI,MAAM,uCAAuC;AAEhE,QAAI,QAAQ,cACV,QAAO,QAAQ,cAAc;KAAE;KAAI,UAAU;KAAM,GAAG;KAAO,EAAE,MAAM;AAGvE,WACE,oBAAC,SAAD;KAAa;KAAa,IAAI,IAAI;KAAiB,GAAI;eACpD;KACO,EAFY,GAEZ;;GAGd,8BAA8B,QAAQ,KAAK;IACzC,MAAM,EAAE,0BAA0B,kCAAkC;AACpE,QAAI,4BAA4B,IAAI,kBAAkB;KACpD,MAAM,EAAE,YAAY,gBAAgB,IAAI;AACxC,YAAO,yBAAyB,IAAI,WAAW,YAAY,aAAa,IAAI;;AAG9E,WAAO,gCAAgC,QAAQ,IAAI;;GAErD,MAAM,eAAe,MAAM;AACzB,QAAI,QAAQ,eAAgB,QAAO,QAAQ,eAAe,KAAK;AAC/D,kBAAc,yBAAyB;AAMvC,YAJY,MAAM,UAAU,QAAQ,EAClC,OAAO,MACR,CAAC,EAES;;GAEb,MAAM,gBAAgB,MAAM,MAAM;AAChC,QAAI,QAAQ,gBACV,QAAO,QAAQ,gBAAgB;KAAE;KAAM;KAAM,CAAC;AAehD,WAAO,oBAAC,WAAD;KAAW,WAAU;eAPX,aALJ,MAAM,cAAc,MAAM,QAAQ,MAAM,WAAW,EAAE,MAAM;MACtE;MACA,cAAc;MACd,GAAG,QAAQ;MACZ,CAAC,EACkC;MAClC,GAAG;MACH,YAAY,EACV,KAAK,KACN;MACF,CAAC;KAEuD,CAAA;;GAE5D;AAED,SAAO,oBAAC,SAAD;GAAS,GAAI;GAAY;GAAO,CAAA"}
+{"version":3,"file":"base.js","names":[],"sources":["../../src/ui/base.tsx"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any -- rehype-react without types */\nimport Slugger from 'github-slugger';\nimport type { Awaitable, MethodInformation, RenderContext } from '@/types';\nimport type { NoReference } from '@/utils/schema';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport { defaultAdapters, MediaAdapter } from '@/requests/media/adapter';\nimport type { FC, HTMLAttributes, ReactNode } from 'react';\nimport type { OpenAPIServer } from '@/server';\nimport type { APIPageClientOptions } from './client';\nimport { Heading } from 'fumadocs-ui/components/heading';\nimport { createRehypeCode } from 'fumadocs-core/mdx-plugins/rehype-code.core';\nimport { remarkGfm } from 'fumadocs-core/mdx-plugins/remark-gfm';\nimport defaultMdxComponents from 'fumadocs-ui/mdx';\nimport { remark } from 'remark';\nimport remarkRehype from 'remark-rehype';\nimport { toJsxRuntime } from 'hast-util-to-jsx-runtime';\nimport * as JsxRuntime from 'react/jsx-runtime';\nimport { CodeBlock, Pre } from 'fumadocs-ui/components/codeblock';\nimport type { SchemaUIOptions } from './schema';\nimport type { ResponseTab } from './operation/response-tabs';\nimport { APIPage, type ApiPageProps, type OperationItem, type WebhookItem } from './api-page';\nimport type { CodeUsageGeneratorRegistry, InlineCodeUsageGenerator } from '@/requests/generators';\nimport type { JSONSchema } from 'json-schema-typed';\nimport type { BundledTheme, CodeOptionsThemes, CodeToHastOptionsCommon } from 'shiki';\nimport { highlightHast, type ShikiFactory } from 'fumadocs-core/highlight/shiki';\nimport type { ExampleRequestItem } from './operation/get-example-requests';\nimport { compile } from '@fumari/json-schema-ts';\n\nexport interface GenerateTypeScriptDefinitionsContext extends RenderContext {\n  operation: NoReference<MethodInformation>;\n  readOnly: boolean;\n  writeOnly: boolean;\n  /** @deprecated */\n  _internal_legacy?: {\n    statusCode: string;\n    contentType: string;\n  };\n}\n\nexport interface CreateAPIPageOptions {\n  /**\n   * Generate TypeScript definitions from response schema.\n   *\n   * Pass `false` to disable it.\n   *\n   * @param method - the operation object\n   * @param statusCode - status code\n   * @deprecated use `generateTypeScriptDefinitions` instead.\n   */\n  generateTypeScriptSchema?:\n    | ((\n        method: NoReference<MethodInformation>,\n        statusCode: string,\n        contentType: string,\n        ctx: RenderContext,\n      ) => Awaitable<string | undefined>)\n    | false;\n\n  /**\n   * Generate TypeScript definitions from JSON schema.\n   *\n   * Pass `false` to disable it.\n   */\n  generateTypeScriptDefinitions?:\n    | ((\n        schema: JSONSchema,\n        ctx: GenerateTypeScriptDefinitionsContext,\n      ) => Awaitable<string | undefined>)\n    | false;\n\n  /**\n   * Generate example code usage for all endpoints.\n   */\n  codeUsages?: CodeUsageGeneratorRegistry;\n\n  /**\n   * Generate example code usage for each endpoint.\n   */\n  generateCodeSamples?: (method: MethodInformation) => InlineCodeUsageGenerator[];\n\n  shiki: ShikiFactory;\n  renderMarkdown?: (md: string) => ReactNode;\n  shikiOptions: Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BundledTheme>;\n\n  /**\n   * Show full response schema instead of only example response & Typescript definitions.\n   *\n   * @default true\n   */\n  showResponseSchema?: boolean;\n\n  /**\n   * Support other media types (for server-side generation).\n   */\n  mediaAdapters?: Record<string, MediaAdapter>;\n\n  /**\n   * Customise page content\n   */\n  content?: {\n    renderResponseTabs?: (tabs: ResponseTab[], ctx: RenderContext) => ReactNode;\n\n    renderRequestTabs?: (\n      items: ExampleRequestItem[],\n      ctx: RenderContext & {\n        route: string;\n        operation: NoReference<MethodInformation>;\n      },\n    ) => ReactNode;\n\n    renderAPIExampleLayout?: (\n      slots: {\n        selector: ReactNode;\n        usageTabs: ReactNode;\n        responseTabs: ReactNode;\n      },\n      ctx: RenderContext,\n    ) => ReactNode;\n\n    /**\n     * @param generators - codegens for API example usages\n     */\n    renderAPIExampleUsageTabs?: (\n      generators: CodeUsageGeneratorRegistry,\n      ctx: RenderContext,\n    ) => ReactNode;\n\n    /**\n     * renderer of the entire page's layout (containing all operations & webhooks UI)\n     */\n    renderPageLayout?: (\n      slots: {\n        operations?: {\n          item: OperationItem;\n          children: ReactNode;\n        }[];\n        webhooks?: {\n          item: WebhookItem;\n          children: ReactNode;\n        }[];\n      },\n      ctx: RenderContext,\n    ) => ReactNode;\n\n    renderOperationLayout?: (\n      slots: {\n        header: ReactNode;\n        description: ReactNode;\n        apiExample: ReactNode;\n        apiPlayground: ReactNode;\n\n        authSchemes: ReactNode;\n        parameters: ReactNode;\n        body: ReactNode;\n        responses: ReactNode;\n        callbacks: ReactNode;\n      },\n      ctx: RenderContext,\n      method: NoReference<MethodInformation>,\n    ) => ReactNode;\n\n    renderWebhookLayout?: (slots: {\n      header: ReactNode;\n      description: ReactNode;\n      authSchemes: ReactNode;\n      parameters: ReactNode;\n      body: ReactNode;\n      requests: ReactNode;\n      responses: ReactNode;\n      callbacks: ReactNode;\n    }) => ReactNode;\n  };\n\n  /**\n   * Info UI for JSON schemas\n   */\n  schemaUI?: {\n    render?: (options: SchemaUIOptions, ctx: RenderContext) => ReactNode;\n\n    /**\n     * Show examples under the generated content of JSON schemas.\n     *\n     * @defaultValue false\n     */\n    showExample?: boolean;\n  };\n\n  /**\n   * Customise API playground\n   */\n  playground?: {\n    /**\n     * @defaultValue true\n     */\n    enabled?: boolean;\n    /**\n     * replace the server-side renderer\n     */\n    render?: (props: {\n      path: string;\n      method: MethodInformation;\n      ctx: RenderContext;\n    }) => Awaitable<ReactNode>;\n  };\n\n  renderHeading?: (props: HTMLAttributes<HTMLHeadingElement>, depth: number) => ReactNode;\n  renderCodeBlock?: (props: { lang: string; code: string }) => ReactNode;\n\n  client?: APIPageClientOptions;\n}\n\nexport interface ServerApiPageProps extends Omit<ApiPageProps, 'document'> {\n  document: string | ProcessedDocument;\n}\n\nexport function createAPIPage(\n  server: OpenAPIServer,\n  options: CreateAPIPageOptions,\n): FC<ServerApiPageProps> {\n  let processor: ReturnType<typeof createMarkdownProcessor>;\n\n  function createMarkdownProcessor() {\n    function rehypeReact(this: any) {\n      this.compiler = (tree: any, file: any) => {\n        return toJsxRuntime(tree, {\n          development: false,\n          filePath: file.path,\n          ...JsxRuntime,\n          components: defaultMdxComponents,\n        });\n      };\n    }\n\n    return remark()\n      .use(remarkGfm)\n      .use(remarkRehype)\n      .use(createRehypeCode(options.shiki), {\n        langs: [],\n        lazy: true,\n        defaultColor: false,\n        ...options.shikiOptions,\n      })\n      .use(rehypeReact);\n  }\n\n  return async function APIPageWrapper({ document, ...props }) {\n    let processed: ProcessedDocument;\n    if (typeof document === 'string') {\n      processed = await server.getSchema(document);\n    } else {\n      processed = document;\n    }\n\n    const slugger = new Slugger();\n\n    const ctx: RenderContext = {\n      schema: processed,\n      proxyUrl: server.options.proxyUrl,\n      ...options,\n      mediaAdapters: {\n        ...defaultAdapters,\n        ...options.mediaAdapters,\n      },\n      renderHeading(depth, text, props) {\n        const id = typeof text === 'string' ? slugger.slug(text) : props?.id;\n        if (!id) throw new Error(\"missing 'id' for non-string children\");\n\n        if (options.renderHeading) {\n          return options.renderHeading({ id, children: text, ...props }, depth);\n        }\n\n        return (\n          <Heading id={id} key={id} as={`h${depth}` as `h1`} {...props}>\n            {text}\n          </Heading>\n        );\n      },\n      generateTypeScriptDefinitions:\n        options.generateTypeScriptDefinitions ??\n        ((schema, ctx) => {\n          if (options.generateTypeScriptSchema && ctx._internal_legacy) {\n            const { statusCode, contentType } = ctx._internal_legacy;\n            return options.generateTypeScriptSchema(ctx.operation, statusCode, contentType, ctx);\n          }\n\n          if (typeof schema !== 'object') return;\n          try {\n            return compile(schema, {\n              name: 'Response',\n              readOnly: ctx.readOnly,\n              writeOnly: ctx.writeOnly,\n              getSchemaId: ctx.schema.getRawRef,\n            });\n          } catch (e) {\n            console.warn('Failed to generate typescript schema:', e);\n          }\n        }),\n      async renderMarkdown(text) {\n        if (options.renderMarkdown) return options.renderMarkdown(text);\n        processor ??= createMarkdownProcessor();\n\n        const out = await processor.process({\n          value: text,\n        });\n\n        return out.result as ReactNode;\n      },\n      async renderCodeBlock(lang, code) {\n        if (options.renderCodeBlock) {\n          return options.renderCodeBlock({ lang, code });\n        }\n\n        const hast = await highlightHast(await options.shiki.getOrInit(), code, {\n          lang,\n          defaultColor: false,\n          ...options.shikiOptions,\n        });\n        const rendered = toJsxRuntime(hast, {\n          ...JsxRuntime,\n          components: {\n            pre: Pre,\n          },\n        });\n\n        return <CodeBlock className=\"my-0\">{rendered}</CodeBlock>;\n      },\n    };\n\n    return <APIPage {...props} ctx={ctx} />;\n  };\n}\n\nexport { ClientCodeBlockProvider } from './components/codeblock';\n"],"mappings":";;;;;;;;;;;;;;;;;AAuNA,SAAgB,cACd,QACA,SACwB;CACxB,IAAI;CAEJ,SAAS,0BAA0B;EACjC,SAAS,cAAuB;AAC9B,QAAK,YAAY,MAAW,SAAc;AACxC,WAAO,aAAa,MAAM;KACxB,aAAa;KACb,UAAU,KAAK;KACf,GAAG;KACH,YAAY;KACb,CAAC;;;AAIN,SAAO,QAAQ,CACZ,IAAI,UAAU,CACd,IAAI,aAAa,CACjB,IAAI,iBAAiB,QAAQ,MAAM,EAAE;GACpC,OAAO,EAAE;GACT,MAAM;GACN,cAAc;GACd,GAAG,QAAQ;GACZ,CAAC,CACD,IAAI,YAAY;;AAGrB,QAAO,eAAe,eAAe,EAAE,UAAU,GAAG,SAAS;EAC3D,IAAI;AACJ,MAAI,OAAO,aAAa,SACtB,aAAY,MAAM,OAAO,UAAU,SAAS;MAE5C,aAAY;EAGd,MAAM,UAAU,IAAI,SAAS;EAE7B,MAAM,MAAqB;GACzB,QAAQ;GACR,UAAU,OAAO,QAAQ;GACzB,GAAG;GACH,eAAe;IACb,GAAG;IACH,GAAG,QAAQ;IACZ;GACD,cAAc,OAAO,MAAM,OAAO;IAChC,MAAM,KAAK,OAAO,SAAS,WAAW,QAAQ,KAAK,KAAK,GAAG,OAAO;AAClE,QAAI,CAAC,GAAI,OAAM,IAAI,MAAM,uCAAuC;AAEhE,QAAI,QAAQ,cACV,QAAO,QAAQ,cAAc;KAAE;KAAI,UAAU;KAAM,GAAG;KAAO,EAAE,MAAM;AAGvE,WACE,oBAAC,SAAD;KAAa;KAAa,IAAI,IAAI;KAAiB,GAAI;eACpD;KACO,EAFY,GAEZ;;GAGd,+BACE,QAAQ,mCACN,QAAQ,QAAQ;AAChB,QAAI,QAAQ,4BAA4B,IAAI,kBAAkB;KAC5D,MAAM,EAAE,YAAY,gBAAgB,IAAI;AACxC,YAAO,QAAQ,yBAAyB,IAAI,WAAW,YAAY,aAAa,IAAI;;AAGtF,QAAI,OAAO,WAAW,SAAU;AAChC,QAAI;AACF,YAAO,QAAQ,QAAQ;MACrB,MAAM;MACN,UAAU,IAAI;MACd,WAAW,IAAI;MACf,aAAa,IAAI,OAAO;MACzB,CAAC;aACK,GAAG;AACV,aAAQ,KAAK,yCAAyC,EAAE;;;GAG9D,MAAM,eAAe,MAAM;AACzB,QAAI,QAAQ,eAAgB,QAAO,QAAQ,eAAe,KAAK;AAC/D,kBAAc,yBAAyB;AAMvC,YAJY,MAAM,UAAU,QAAQ,EAClC,OAAO,MACR,CAAC,EAES;;GAEb,MAAM,gBAAgB,MAAM,MAAM;AAChC,QAAI,QAAQ,gBACV,QAAO,QAAQ,gBAAgB;KAAE;KAAM;KAAM,CAAC;AAehD,WAAO,oBAAC,WAAD;KAAW,WAAU;eAPX,aALJ,MAAM,cAAc,MAAM,QAAQ,MAAM,WAAW,EAAE,MAAM;MACtE;MACA,cAAc;MACd,GAAG,QAAQ;MACZ,CAAC,EACkC;MAClC,GAAG;MACH,YAAY,EACV,KAAK,KACN;MACF,CAAC;KAEuD,CAAA;;GAE5D;AAED,SAAO,oBAAC,SAAD;GAAS,GAAI;GAAY;GAAO,CAAA"}

package/dist/ui/{full.client.js → client/full.js}

@@ -1,8 +1,8 @@
 "use client";
-import { ClientCodeBlockProvider } from "./components/codeblock.js";
+import { ClientCodeBlockProvider } from "../components/codeblock.js";
 import { jsx } from "react/jsx-runtime";
 import { defaultShikiFactory } from "fumadocs-core/highlight/shiki/full";
-//#region src/ui/full.client.tsx
+//#region src/ui/client/full.tsx
 function FullProvider({ children }) {
 	return /* @__PURE__ */ jsx(ClientCodeBlockProvider, {
 		factory: defaultShikiFactory,
@@ -12,4 +12,4 @@ function FullProvider({ children }) {
 //#endregion
 export { FullProvider };
 
-//# sourceMappingURL=full.client.js.map
+//# sourceMappingURL=full.js.map

package/dist/ui/client/full.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"full.js","names":[],"sources":["../../../src/ui/client/full.tsx"],"sourcesContent":["'use client';\nimport type { ReactNode } from 'react';\nimport { ClientCodeBlockProvider } from '../components/codeblock';\nimport { defaultShikiFactory } from 'fumadocs-core/highlight/shiki/full';\n\nexport function FullProvider({ children }: { children: ReactNode }) {\n  return (\n    <ClientCodeBlockProvider factory={defaultShikiFactory}>{children}</ClientCodeBlockProvider>\n  );\n}\n"],"mappings":";;;;;AAKA,SAAgB,aAAa,EAAE,YAAqC;AAClE,QACE,oBAAC,yBAAD;EAAyB,SAAS;EAAsB;EAAmC,CAAA"}

package/dist/ui/client/index.d.ts

@@ -1,7 +1,7 @@
 import { MediaAdapter } from "../../requests/media/adapter.js";
 import { CodeUsageGeneratorRegistry } from "../../requests/generators/index.js";
 import { PlaygroundClientOptions } from "../../playground/client.js";
-import { ExampleRequestItem } from "../operation/request-tabs.js";
+import { ExampleRequestItem } from "../operation/get-example-requests.js";
 import { FC } from "react";
 
 //#region src/ui/client/index.d.ts

package/dist/ui/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/ui/client/index.tsx"],"sourcesContent":["'use client';\nimport type { PlaygroundClientOptions } from '@/playground/client';\nimport type { MediaAdapter } from '@/requests/media/adapter';\nimport type { FC } from 'react';\nimport type { ExampleRequestItem } from '../operation/request-tabs';\nimport type { CodeUsageGeneratorRegistry } from '@/requests/generators';\n\nexport interface APIPageClientOptions {\n  playground?: PlaygroundClientOptions;\n  operation?: OperationClientOptions;\n\n  /**\n   * Set a prefix for `localStorage` keys.\n   *\n   * Useful when using multiple OpenAPI instances to prevent state conflicts.\n   *\n   * @defaultValue `fumadocs-openapi-`\n   */\n  storageKeyPrefix?: string;\n\n  /**\n   * Support other media types (for client-side serialization)\n   */\n  mediaAdapters?: Record<string, MediaAdapter>;\n\n  /**\n   * generate code usage examples\n   */\n  codeUsages?: CodeUsageGeneratorRegistry;\n}\n\nexport interface OperationClientOptions {\n  APIExampleSelector?: FC<{\n    items: ExampleRequestItem[];\n\n    value: string | undefined;\n    onValueChange: (id: string) => void;\n  }>;\n}\n\nexport function defineClientConfig(options: APIPageClientOptions = {}): APIPageClientOptions {\n  return options;\n}\n"],"mappings":";;AAwCA,SAAgB,mBAAmB,UAAgC,EAAE,EAAwB;AAC3F,QAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/ui/client/index.tsx"],"sourcesContent":["'use client';\nimport type { PlaygroundClientOptions } from '@/playground/client';\nimport type { MediaAdapter } from '@/requests/media/adapter';\nimport type { FC } from 'react';\nimport type { CodeUsageGeneratorRegistry } from '@/requests/generators';\nimport type { ExampleRequestItem } from '../operation/get-example-requests';\n\nexport interface APIPageClientOptions {\n  playground?: PlaygroundClientOptions;\n  operation?: OperationClientOptions;\n\n  /**\n   * Set a prefix for `localStorage` keys.\n   *\n   * Useful when using multiple OpenAPI instances to prevent state conflicts.\n   *\n   * @defaultValue `fumadocs-openapi-`\n   */\n  storageKeyPrefix?: string;\n\n  /**\n   * Support other media types (for client-side serialization)\n   */\n  mediaAdapters?: Record<string, MediaAdapter>;\n\n  /**\n   * generate code usage examples\n   */\n  codeUsages?: CodeUsageGeneratorRegistry;\n}\n\nexport interface OperationClientOptions {\n  APIExampleSelector?: FC<{\n    items: ExampleRequestItem[];\n\n    value: string | undefined;\n    onValueChange: (id: string) => void;\n  }>;\n}\n\nexport function defineClientConfig(options: APIPageClientOptions = {}): APIPageClientOptions {\n  return options;\n}\n"],"mappings":";;AAwCA,SAAgB,mBAAmB,UAAgC,EAAE,EAAwB;AAC3F,QAAO"}

package/dist/ui/client/storage-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-key.js","names":[],"sources":["../../../src/ui/client/storage-key.ts"],"sourcesContent":["import type { AuthField } from '@/playground/client';\nimport { useApiContext } from '../contexts/api';\nimport { useMemo } from 'react';\n\ntype KeyName = 'server-url' | `auth-${string}`;\n\nexport function useStorageKey() {\n  const { storageKeyPrefix } = useApiContext().client;\n\n  return useMemo(\n    () => ({\n      of: (name: KeyName) => getStorageKey(storageKeyPrefix, name),\n      AuthField: (field: AuthField) =>\n        getStorageKey(storageKeyPrefix, `auth-${field.original?.id ?? field.fieldName}`),\n    }),\n    [storageKeyPrefix],\n  );\n}\n\nexport function getStorageKey(prefix = 'fumadocs-openapi-', name: KeyName) {\n  return prefix + name;\n}\n"],"mappings":";;;AAMA,SAAgB,gBAAgB;CAC9B,MAAM,EAAE,qBAAqB,eAAe,CAAC;AAE7C,QAAO,eACE;EACL,KAAK,SAAkB,cAAc,kBAAkB,KAAK;EAC5D,YAAY,UACV,cAAc,kBAAkB,QAAQ,MAAM,UAAU,MAAM,MAAM,YAAY;EACnF,GACD,CAAC,iBAAiB,CACnB;;AAGH,SAAgB,cAAc,SAAS,qBAAqB,MAAe;AACzE,QAAO,SAAS"}
+{"version":3,"file":"storage-key.js","names":[],"sources":["../../../src/ui/client/storage-key.ts"],"sourcesContent":["import type { AuthField } from '@/playground/client';\nimport { useApiContext } from '../contexts/api';\nimport { useMemo } from 'react';\n\ntype KeyName = 'server-url' | `auth-${string}`;\n\nexport function useStorageKey() {\n  const { storageKeyPrefix } = useApiContext().client;\n\n  return useMemo(\n    () => ({\n      of: (name: KeyName) => getStorageKey(storageKeyPrefix, name),\n      AuthField: (field: AuthField) =>\n        getStorageKey(storageKeyPrefix, `auth-${field.original?.id ?? field.fieldName}`),\n    }),\n    [storageKeyPrefix],\n  );\n}\n\nfunction getStorageKey(prefix = 'fumadocs-openapi-', name: KeyName) {\n  return prefix + name;\n}\n"],"mappings":";;;AAMA,SAAgB,gBAAgB;CAC9B,MAAM,EAAE,qBAAqB,eAAe,CAAC;AAE7C,QAAO,eACE;EACL,KAAK,SAAkB,cAAc,kBAAkB,KAAK;EAC5D,YAAY,UACV,cAAc,kBAAkB,QAAQ,MAAM,UAAU,MAAM,MAAM,YAAY;EACnF,GACD,CAAC,iBAAiB,CACnB;;AAGH,SAAS,cAAc,SAAS,qBAAqB,MAAe;AAClE,QAAO,SAAS"}

package/dist/ui/components/codeblock.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { ShikiFactory } from "fumadocs-core/highlight/shiki";
 
 //#region src/ui/components/codeblock.d.ts
@@ -9,7 +9,7 @@ declare function ClientCodeBlockProvider({
 }: {
   factory: ShikiFactory;
   children: ReactNode;
-}): react_jsx_runtime0.JSX.Element;
+}): _$react_jsx_runtime0.JSX.Element;
 //#endregion
 export { ClientCodeBlockProvider };
 //# sourceMappingURL=codeblock.d.ts.map

package/dist/ui/components/codeblock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codeblock.d.ts","names":[],"sources":["../../../src/ui/components/codeblock.tsx"],"mappings":";;;;;iBAsBgB,uBAAA,CAAA;EACd,OAAA;EACA;AAAA;EAEA,OAAA,EAAS,YAAA;EACT,QAAA,EAAU,SAAA;AAAA,IACX,kBAAA,CAAA,GAAA,CAAA,OAAA"}
+{"version":3,"file":"codeblock.d.ts","names":[],"sources":["../../../src/ui/components/codeblock.tsx"],"mappings":";;;;;iBAsBgB,uBAAA,CAAA;EACd,OAAA;EACA;AAAA;EAEA,OAAA,EAAS,YAAA;EACT,QAAA,EAAU,SAAA;AAAA,IACX,oBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/ui/components/server-tab.js

@@ -0,0 +1,43 @@
+"use client";
+import { cn } from "../../utils/cn.js";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "./select.js";
+import { createContext, use, useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/ui/components/server-tab.tsx
+const Context = createContext(null);
+function SelectTabs({ defaultValue, children }) {
+	const [type, setType] = useState(defaultValue ?? null);
+	return /* @__PURE__ */ jsx(Context, {
+		value: useMemo(() => ({
+			type,
+			setType
+		}), [type]),
+		children
+	});
+}
+function SelectTab({ value, ...props }) {
+	if (value !== use(Context)?.type) return;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		children: props.children
+	});
+}
+function SelectTabTrigger({ items, className, ...props }) {
+	const { type, setType } = use(Context);
+	return /* @__PURE__ */ jsxs(Select, {
+		value: type ?? "",
+		onValueChange: setType,
+		children: [/* @__PURE__ */ jsx(SelectTrigger, {
+			className: cn("not-prose w-fit min-w-0 *:min-w-0", className),
+			...props,
+			children: /* @__PURE__ */ jsx(SelectValue, {})
+		}), /* @__PURE__ */ jsx(SelectContent, { children: items.map(({ label, value }) => /* @__PURE__ */ jsx(SelectItem, {
+			value,
+			children: label
+		}, value)) })]
+	});
+}
+//#endregion
+export { SelectTab, SelectTabTrigger, SelectTabs };
+
+//# sourceMappingURL=server-tab.js.map

package/dist/ui/components/server-tab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tab.js","names":[],"sources":["../../../src/ui/components/server-tab.tsx"],"sourcesContent":["'use client';\n\nimport { cn } from '@/utils/cn';\nimport { SelectTrigger, Select, SelectValue, SelectContent, SelectItem } from './select';\nimport { type ReactNode, useState, useMemo, type ComponentProps, createContext, use } from 'react';\n\nconst Context = createContext<{\n  type: string | null;\n  setType: (type: string) => void;\n} | null>(null);\n\nexport function SelectTabs({\n  defaultValue,\n  children,\n}: {\n  defaultValue?: string;\n  children: ReactNode;\n}) {\n  const [type, setType] = useState<string | null>(defaultValue ?? null);\n\n  return <Context value={useMemo(() => ({ type, setType }), [type])}>{children}</Context>;\n}\n\nexport function SelectTab({\n  value,\n  ...props\n}: ComponentProps<'div'> & {\n  value: string;\n}) {\n  const ctx = use(Context);\n  if (value !== ctx?.type) return;\n\n  return <div {...props}>{props.children}</div>;\n}\n\nexport function SelectTabTrigger({\n  items,\n  className,\n  ...props\n}: ComponentProps<typeof SelectTrigger> & {\n  items: {\n    label: ReactNode;\n    value: string;\n  }[];\n}) {\n  const { type, setType } = use(Context)!;\n\n  return (\n    <Select value={type ?? ''} onValueChange={setType}>\n      <SelectTrigger className={cn('not-prose w-fit min-w-0 *:min-w-0', className)} {...props}>\n        <SelectValue />\n      </SelectTrigger>\n      <SelectContent>\n        {items.map(({ label, value }) => (\n          <SelectItem key={value} value={value}>\n            {label}\n          </SelectItem>\n        ))}\n      </SelectContent>\n    </Select>\n  );\n}\n"],"mappings":";;;;;;AAMA,MAAM,UAAU,cAGN,KAAK;AAEf,SAAgB,WAAW,EACzB,cACA,YAIC;CACD,MAAM,CAAC,MAAM,WAAW,SAAwB,gBAAgB,KAAK;AAErE,QAAO,oBAAC,SAAD;EAAS,OAAO,eAAe;GAAE;GAAM;GAAS,GAAG,CAAC,KAAK,CAAC;EAAG;EAAmB,CAAA;;AAGzF,SAAgB,UAAU,EACxB,OACA,GAAG,SAGF;AAED,KAAI,UADQ,IAAI,QAAQ,EACL,KAAM;AAEzB,QAAO,oBAAC,OAAD;EAAK,GAAI;YAAQ,MAAM;EAAe,CAAA;;AAG/C,SAAgB,iBAAiB,EAC/B,OACA,WACA,GAAG,SAMF;CACD,MAAM,EAAE,MAAM,YAAY,IAAI,QAAQ;AAEtC,QACE,qBAAC,QAAD;EAAQ,OAAO,QAAQ;EAAI,eAAe;YAA1C,CACE,oBAAC,eAAD;GAAe,WAAW,GAAG,qCAAqC,UAAU;GAAE,GAAI;aAChF,oBAAC,aAAD,EAAe,CAAA;GACD,CAAA,EAChB,oBAAC,eAAD,EAAA,UACG,MAAM,KAAK,EAAE,OAAO,YACnB,oBAAC,YAAD;GAA+B;aAC5B;GACU,EAFI,MAEJ,CACb,EACY,CAAA,CACT"}