fumadocs-openapi 9.7.2 → 10.0.0

package/dist/requests/media/adapter.d.ts

@@ -25,12 +25,6 @@ export type MediaContext = JavaContext | GoContext | JavaScriptContext | CSharpC
     lang: string;
 });
 export interface MediaAdapter {
-    /**
-     * the same adapter that's passed from a client component.
-     *
-     * It is needed for client-side serialization of values.
-     */
-    client?: MediaAdapter;
     /**
      * encode data into specified media type for `fetch()`.
      *

package/dist/requests/media/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/requests/media/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAI9E,UAAU,WAAW;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,UAAU,SAAU,SAAQ,WAAW;IACrC,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,UAAU,iBAAkB,SAAQ,WAAW;IAC7C,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED,UAAU,WAAY,SAAQ,WAAW;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,UAAU,aAAc,SAAQ,WAAW;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,aAAa,GACb,CAAC,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;OAIG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,QAAQ,CAAC;IAE9C;;;;;;;;OAQG;IACH,eAAe,EAAE,CACf,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,EACvB,GAAG,EAAE,YAAY,KACd,MAAM,GAAG,SAAS,CAAC;CACzB;AAED,eAAO,MAAM,eAAe;;;kBAjBH,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;YAgLN,QAAQ;;;CAOM,CAAC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/requests/media/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAI9E,UAAU,WAAW;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,UAAU,SAAU,SAAQ,WAAW;IACrC,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,UAAU,iBAAkB,SAAQ,WAAW;IAC7C,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED,UAAU,WAAY,SAAQ,WAAW;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,UAAU,aAAc,SAAQ,WAAW;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,aAAa,GACb,CAAC,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,QAAQ,CAAC;IAE9C;;;;;;;;OAQG;IACH,eAAe,EAAE,CACf,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,EACvB,GAAG,EAAE,YAAY,KACd,MAAM,GAAG,SAAS,CAAC;CACzB;AAED,eAAO,MAAM,eAAe;;;kBAjBH,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;;;kBAYd,OAAO;;;;;kBAZA,OAAO;YAgLN,QAAQ;;;CAOM,CAAC"}

package/dist/scalar/index.d.ts

@@ -1,7 +1,12 @@
 import type { MethodInformation, RenderContext } from '../types.js';
+import type { CreateAPIPageOptions } from '../ui/index.js';
 export declare function APIPlayground({ path, method, ctx, }: {
     path: string;
     method: MethodInformation;
     ctx: RenderContext;
 }): import("react/jsx-runtime").JSX.Element;
+/**
+ * Enable Scalar for API playgrounds by wrapping your options inside.
+ */
+export declare function withScalar(options?: CreateAPIPageOptions): CreateAPIPageOptions;
 //# sourceMappingURL=index.d.ts.map

package/dist/scalar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scalar/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKhE,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,MAAM,EACN,GAAG,GACJ,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,aAAa,CAAC;CACpB,2CAIA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scalar/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,MAAM,CAAC;AAKjD,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,MAAM,EACN,GAAG,GACJ,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,aAAa,CAAC;CACpB,2CAIA;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE,oBAAyB,GACjC,oBAAoB,CAUtB"}

package/dist/scalar/index.js

@@ -4,3 +4,17 @@ const Client = lazy(() => import('./client.js'));
 export function APIPlayground({ path, method, ctx, }) {
     return (_jsx(Client, { method: method.method, path: path, spec: ctx.schema.bundled }));
 }
+/**
+ * Enable Scalar for API playgrounds by wrapping your options inside.
+ */
+export function withScalar(options = {}) {
+    return {
+        ...options,
+        playground: {
+            ...options.playground,
+            render(props) {
+                return _jsx(APIPlayground, { ...props });
+            },
+        },
+    };
+}

package/dist/server/create.d.ts

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

package/dist/server/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/server/create.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACnC;;GAEG;AACH,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC3E,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE7B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;;OAOG;IACH,wBAAwB,CAAC,EACrB,CAAC,CACC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,EACtC,UAAU,EAAE,MAAM,KACf,SAAS,CAAC,MAAM,CAAC,CAAC,GACvB,KAAK,CAAC;IAEV;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7E,YAAY,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,YAAY,CAAC,GAChE,sBAAsB,CAAC;IAEzB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE7C;;OAEG;IACH,OAAO,CAAC,EAAE;QACR;;;;WAIG;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAE9C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,YAAY,CAAC;IACtD,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,UAAU,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/C;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CA4CzE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAEtE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/server/create.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;GAEG;AACH,KAAK,SAAS,GAAG,MAAM,CACrB,MAAM,EACN,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CACnD,CAAC;AACF,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAE1D,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,UAAU,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAiCzE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACtC,kBAAkB,CAQpB"}

package/dist/server/create.js

@@ -1,7 +1,7 @@
 import { createProxy } from '../server/proxy.js';
-import { processDocument, processDocumentCached, } from '../utils/process-document.js';
+import { processDocument, } from '../utils/process-document.js';
 export function createOpenAPI(options = {}) {
-    const { input = [], disableCache = false, ...shared } = options;
+    const { input = [], disableCache = false } = options;
     let schemas;
     async function getSchemas() {
         const out = {};
@@ -18,25 +18,16 @@ export function createOpenAPI(options = {}) {
         return out;
     }
     return {
+        options,
         createProxy,
         async getSchemas() {
             if (disableCache)
                 return getSchemas();
             return (schemas ?? (schemas = getSchemas()));
         },
-        getAPIPageProps({ document, ...props }) {
-            return {
-                ...shared,
-                ...props,
-                document: typeof document === 'string'
-                    ? this.getSchemas().then((map) => {
-                        return map[document] ?? processDocumentCached(document);
-                    })
-                    : document,
-            };
-        },
     };
 }
 export function createCodeSample(options) {
-    return options;
+    const { lang = 'unknown', id = lang, ...rest } = options;
+    return { id, lang, ...rest };
 }

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

@@ -1,7 +1,7 @@
 import type { LoaderPlugin, MetaData, PageData, PageTreeTransformer, Source } from 'fumadocs-core/source';
 import type { OpenAPIServer } from '../server/create.js';
 import type { SchemaToPagesOptions } from '../utils/pages/preset-auto.js';
-import type { ApiPageProps } from '../render/api-page.js';
+import type { ApiPageProps } from '../ui/api-page.js';
 declare module 'fumadocs-core/source' {
     interface PageData {
         /**

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,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"}
+{"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,eAAe,CAAC;AAElD,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

@@ -43,7 +43,7 @@ export async function openapiSource(from, options = {}) {
             path: `${baseDir}/${entry.path}`,
             data: {
                 ...entry.info,
-                getAPIPageProps: () => toBody(from, entry),
+                getAPIPageProps: () => toBody(entry),
                 _openapi: {
                     method: entry.type === 'operation' || entry.type === 'webhook'
                         ? entry.item.method

package/dist/types.d.ts

@@ -1,10 +1,12 @@
 import type { OpenAPIV3_1 as V3_1 } from 'openapi-types';
 import type { default as Slugger } from 'github-slugger';
-import { type Renderer } from './render/renderer.js';
 import type { NoReference } from './utils/schema.js';
 import type { ProcessedDocument } from './utils/process-document.js';
 import type { MediaAdapter } from './requests/media/adapter.js';
-import type { SharedOpenAPIOptions } from './server/index.js';
+import type { OpenAPIOptions } from './server/index.js';
+import type { CreateAPIPageOptions } from './ui/api-page.js';
+import type { CodeUsageGenerator } from './ui/operation/example-panel/index.js';
+import type { ReactNode } from 'react';
 export type Document = V3_1.Document;
 export type OperationObject = V3_1.OperationObject;
 export type ParameterObject = V3_1.ParameterObject;
@@ -15,11 +17,14 @@ export type TagObject = V3_1.TagObject;
 export type ServerObject = V3_1.ServerObject;
 export type CallbackObject = V3_1.CallbackObject;
 export type ServerVariableObject = V3_1.ServerVariableObject;
+export type ResponseObject = V3_1.ResponseObject;
 export type MethodInformation = NoReference<OperationObject> & {
     method: string;
+    'x-codeSamples'?: Omit<CodeUsageGenerator, 'id'>[];
+    'x-selectedCodeSample'?: string;
+    'x-exclusiveCodeSample'?: string;
 };
-export interface RenderContext extends SharedOpenAPIOptions {
-    renderer: Renderer;
+export interface RenderContext extends Pick<OpenAPIOptions, 'proxyUrl'>, CreateAPIPageOptions {
     servers: NoReference<ServerObject>[];
     slugger: Slugger;
     /**
@@ -27,5 +32,8 @@ export interface RenderContext extends SharedOpenAPIOptions {
      */
     schema: ProcessedDocument;
     mediaAdapters: Record<string, MediaAdapter>;
+    renderHeading: (depth: number, text: string) => ReactNode;
+    renderMarkdown: (text: string) => ReactNode;
+    renderCodeBlock: (lang: string, code: string) => ReactNode;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,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"}
+{"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,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,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,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;AAC7D,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,EAAE,CAAC;IACnD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,aACf,SAAQ,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,EACtC,oBAAoB;IACtB,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;IAE5C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;IAC1D,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;CAC5D"}

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

@@ -0,0 +1,145 @@
+import type { MethodInformation, RenderContext } from '../types.js';
+import { type NoReference, type ResolvedSchema } from '../utils/schema.js';
+import type { OpenAPIV3_1 } from 'openapi-types';
+import type { ProcessedDocument } from '../utils/process-document.js';
+import { MediaAdapter } from '../requests/media/adapter.js';
+import type { FC, ReactNode } from 'react';
+import { type HighlightOptionsCommon, type HighlightOptionsThemes } from 'fumadocs-core/highlight';
+import type { OpenAPIServer } from '../server/index.js';
+import type { APIPageClientOptions } from './client/index.js';
+import type { CodeUsageGenerator, ResponseTab } from './operation/example-panel/index.js';
+import type { SchemaUIProps } from './schema/client.js';
+type Awaitable<T> = T | Promise<T>;
+export interface CreateAPIPageOptions {
+    /**
+     * Generate TypeScript definitions from response schema.
+     *
+     * Pass `false` to disable it.
+     *
+     * @param method - the operation object
+     * @param statusCode - status code
+     */
+    generateTypeScriptSchema?: ((method: NoReference<MethodInformation>, statusCode: string) => Awaitable<string>) | false;
+    /**
+     * Generate example code usage for endpoints.
+     */
+    generateCodeSamples?: (method: MethodInformation) => Awaitable<CodeUsageGenerator[]>;
+    shikiOptions?: Omit<HighlightOptionsCommon, 'lang' | 'components'> & HighlightOptionsThemes;
+    /**
+     * Show full response schema instead of only example response & Typescript definitions.
+     *
+     * @default true
+     */
+    showResponseSchema?: boolean;
+    /**
+     * Support other media types (for server-side generation).
+     */
+    mediaAdapters?: Record<string, MediaAdapter>;
+    /**
+     * Customise page content
+     */
+    content?: {
+        renderResponseTabs?: (tabs: ResponseTab[], ctx: RenderContext) => Awaitable<ReactNode>;
+        renderAPIExampleLayout?: (slots: {
+            selector: ReactNode;
+            usageTabs: ReactNode;
+            responseTabs: ReactNode;
+        }, ctx: RenderContext) => Awaitable<ReactNode>;
+        /**
+         * @param generators - codegens for API example usages
+         */
+        renderAPIExampleUsageTabs?: (generators: CodeUsageGenerator<unknown>[], ctx: RenderContext) => Awaitable<ReactNode>;
+        /**
+         * renderer of the entire page's layout (containing all operations & webhooks UI)
+         */
+        renderPageLayout?: (slots: {
+            operations?: {
+                item: OperationItem;
+                children: ReactNode;
+            }[];
+            webhooks?: {
+                item: WebhookItem;
+                children: ReactNode;
+            }[];
+        }, ctx: RenderContext) => Awaitable<ReactNode>;
+        renderOperationLayout?: (slots: {
+            header: ReactNode;
+            apiExample: ReactNode;
+            apiPlayground: ReactNode;
+            authSchemes: ReactNode;
+            paremeters: ReactNode;
+            body: ReactNode;
+            responses: ReactNode;
+            callbacks: ReactNode;
+        }, ctx: RenderContext, method: MethodInformation) => Awaitable<ReactNode>;
+        renderWebhookLayout?: (slots: {
+            header: ReactNode;
+            authSchemes: ReactNode;
+            paremeters: ReactNode;
+            body: ReactNode;
+            responses: ReactNode;
+            callbacks: ReactNode;
+        }) => Awaitable<ReactNode>;
+    };
+    /**
+     * Info UI for JSON schemas
+     */
+    schemaUI?: {
+        render?: (options: Omit<SchemaUIProps, 'generated'> & {
+            root: ResolvedSchema;
+        }, ctx: RenderContext) => Awaitable<ReactNode>;
+        /**
+         * Show examples under the generated content of JSON schemas.
+         *
+         * @defaultValue false
+         */
+        showExample?: boolean;
+    };
+    /**
+     * Customise API playground
+     */
+    playground?: {
+        /**
+         * @defaultValue true
+         */
+        enabled?: boolean;
+        /**
+         * replace the server-side renderer
+         */
+        render?: (props: {
+            path: string;
+            method: MethodInformation;
+            ctx: RenderContext;
+        }) => Awaitable<ReactNode>;
+    };
+    client?: APIPageClientOptions;
+}
+export interface ApiPageProps {
+    document: Promise<ProcessedDocument> | string | ProcessedDocument;
+    hasHead?: boolean;
+    /**
+     * An array of operations
+     */
+    operations?: OperationItem[];
+    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 createAPIPage(server: OpenAPIServer, options?: CreateAPIPageOptions): FC<ApiPageProps>;
+export {};
+//# sourceMappingURL=api-page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-page.d.ts","sourceRoot":"","sources":["../../src/ui/api-page.tsx"],"names":[],"mappings":"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"}

package/dist/ui/api-page.js

@@ -0,0 +1,120 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/* eslint-disable @typescript-eslint/no-explicit-any -- rehype-react without types */
+import Slugger from 'github-slugger';
+import { Operation } from '../ui/operation/index.js';
+import { createMethod, } from '../utils/schema.js';
+import { defaultAdapters } from '../requests/media/adapter.js';
+import { highlight, } from 'fumadocs-core/highlight';
+import { ApiProviderLazy } from './contexts/api.lazy.js';
+import { Heading } from 'fumadocs-ui/components/heading';
+import { rehypeCode, } from 'fumadocs-core/mdx-plugins/rehype-code';
+import { remarkGfm } from 'fumadocs-core/mdx-plugins/remark-gfm';
+import defaultMdxComponents from 'fumadocs-ui/mdx';
+import { remark } from 'remark';
+import remarkRehype from 'remark-rehype';
+import { toJsxRuntime } from 'hast-util-to-jsx-runtime';
+import * as JsxRuntime from 'react/jsx-runtime';
+import { CodeBlock, Pre } from 'fumadocs-ui/components/codeblock';
+export function createAPIPage(server, options = {}) {
+    let processor;
+    function createMarkdownProcessor() {
+        function rehypeReact() {
+            this.compiler = (tree, file) => {
+                return toJsxRuntime(tree, {
+                    development: false,
+                    filePath: file.path,
+                    ...JsxRuntime,
+                    components: defaultMdxComponents,
+                });
+            };
+        }
+        return remark()
+            .use(remarkGfm)
+            .use(remarkRehype)
+            .use(rehypeCode, {
+            langs: [],
+            lazy: true,
+        })
+            .use(rehypeReact);
+    }
+    return async function APIPageWrapper({ document, ...props }) {
+        let processed;
+        if (typeof document === 'string') {
+            processed = (await server.getSchemas())[document];
+        }
+        else {
+            processed = await document;
+        }
+        const { dereferenced } = processed;
+        const servers = dereferenced.servers && dereferenced.servers.length > 0
+            ? dereferenced.servers
+            : [{ url: '/' }];
+        const slugger = new Slugger();
+        const ctx = {
+            schema: processed,
+            proxyUrl: server.options.proxyUrl,
+            ...options,
+            servers,
+            mediaAdapters: {
+                ...defaultAdapters,
+                ...options.mediaAdapters,
+            },
+            slugger,
+            renderHeading(depth, text) {
+                const id = slugger.slug(text);
+                return (_jsx(Heading, { id: id, as: `h${depth}`, children: text }, id));
+            },
+            async renderMarkdown(text) {
+                processor ?? (processor = createMarkdownProcessor());
+                const out = await processor.process({
+                    value: text,
+                });
+                return out.result;
+            },
+            async renderCodeBlock(lang, code) {
+                const rendered = await highlight(code, {
+                    lang,
+                    ...options.shikiOptions,
+                    components: {
+                        pre: (props) => _jsx(Pre, { ...props }),
+                    },
+                });
+                return _jsx(CodeBlock, { className: "my-0", children: rendered });
+            },
+        };
+        return _jsx(APIPage, { ...props, ctx: ctx });
+    };
+}
+async function APIPage({ hasHead = false, operations, webhooks, ctx, }) {
+    const { dereferenced } = ctx.schema;
+    let { renderPageLayout } = ctx.content ?? {};
+    renderPageLayout ?? (renderPageLayout = (slots) => (_jsxs("div", { className: "flex flex-col gap-24 text-sm", children: [slots.operations?.map((op) => op.children), slots.webhooks?.map((op) => op.children)] })));
+    const content = await 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}`);
+            const operation = pathItem[item.method];
+            if (!operation)
+                throw new Error(`[Fumadocs OpenAPI] Method ${item.method} not found in operation: ${item.path}`);
+            const method = createMethod(item.method, pathItem, operation);
+            return {
+                item,
+                children: (_jsx(Operation, { method: method, path: item.path, ctx: ctx, hasHead: hasHead }, `${item.path}:${item.method}`)),
+            };
+        }),
+        webhooks: webhooks?.map((item) => {
+            const webhook = dereferenced.webhooks?.[item.name];
+            if (!webhook)
+                throw new Error(`[Fumadocs OpenAPI] Webhook not found in OpenAPI schema: ${item.name}`);
+            const hook = webhook[item.method];
+            if (!hook)
+                throw new Error(`[Fumadocs OpenAPI] Method ${item.method} not found in webhook: ${item.name}`);
+            return {
+                item,
+                children: (_jsx(Operation, { type: "webhook", method: createMethod(item.method, webhook, hook), ctx: ctx, path: `/${item.name}`, hasHead: hasHead }, `${item.name}:${item.method}`)),
+            };
+        }),
+    }, ctx);
+    return (_jsx(ApiProviderLazy, { servers: ctx.servers, shikiOptions: ctx.shikiOptions, client: ctx.client ?? {}, children: content }));
+}

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

@@ -0,0 +1,29 @@
+import type { PlaygroundClientOptions } from '../../playground/client.js';
+import type { MediaAdapter } from '../../requests/media/adapter.js';
+import type { APIExampleItem } from '../operation/example-panel/index.js';
+import type { FC } from 'react';
+export interface APIPageClientOptions {
+    playground?: PlaygroundClientOptions;
+    operation?: OperationClientOptions;
+    /**
+     * Set a prefix for `localStorage` keys.
+     *
+     * Useful when using multiple OpenAPI instances to prevent state conflicts.
+     *
+     * @defaultValue `fumadocs-openapi-`
+     */
+    storageKeyPrefix?: string;
+    /**
+     * Support other media types (for client-side serialization)
+     */
+    mediaAdapters?: Record<string, MediaAdapter>;
+}
+export interface OperationClientOptions {
+    APIExampleSelector?: FC<{
+        items: APIExampleItem[];
+        value: string | undefined;
+        onValueChange: (id: string) => void;
+    }>;
+}
+export declare function defineClientConfig(options?: APIPageClientOptions): APIPageClientOptions;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/client/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,SAAS,CAAC,EAAE,sBAAsB,CAAC;IAEnC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,kBAAkB,CAAC,EAAE,EAAE,CAAC;QACtB,KAAK,EAAE,cAAc,EAAE,CAAC;QAExB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;KACrC,CAAC,CAAC;CACJ;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,oBAAyB,GACjC,oBAAoB,CAEtB"}

package/dist/ui/client/index.js

@@ -0,0 +1,4 @@
+'use client';
+export function defineClientConfig(options = {}) {
+    return options;
+}

package/dist/ui/client/storage-key.d.ts

@@ -0,0 +1,9 @@
+import type { AuthField } from '../../playground/client.js';
+type KeyName = 'server-url' | `auth-${string}`;
+export declare function useStorageKey(): {
+    of: (name: KeyName) => string;
+    AuthField: (field: AuthField) => string;
+};
+export declare function getStorageKey(prefix: string | undefined, name: KeyName): string;
+export {};
+//# sourceMappingURL=storage-key.d.ts.map

package/dist/ui/client/storage-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-key.d.ts","sourceRoot":"","sources":["../../../src/ui/client/storage-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,KAAK,OAAO,GAAG,YAAY,GAAG,QAAQ,MAAM,EAAE,CAAC;AAE/C,wBAAgB,aAAa;eAKZ,OAAO;uBACC,SAAS;EAQjC;AAED,wBAAgB,aAAa,CAAC,MAAM,oBAAsB,EAAE,IAAI,EAAE,OAAO,UAExE"}

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

@@ -0,0 +1,12 @@
+import { useApiContext } from '../contexts/api.js';
+import { useMemo } from 'react';
+export function useStorageKey() {
+    const { storageKeyPrefix } = useApiContext().client;
+    return useMemo(() => ({
+        of: (name) => getStorageKey(storageKeyPrefix, name),
+        AuthField: (field) => getStorageKey(storageKeyPrefix, `auth-${field.original?.id ?? field.fieldName}`),
+    }), [storageKeyPrefix]);
+}
+export function getStorageKey(prefix = 'fumadocs-openapi-', name) {
+    return prefix + name;
+}

package/dist/ui/components/method-label.d.ts

@@ -1,7 +1,7 @@
 import { type VariantProps } from 'class-variance-authority';
 import type { HTMLAttributes } from 'react';
 export declare const badgeVariants: (props?: ({
-    color?: "red" | "green" | "yellow" | "blue" | "orange" | null | undefined;
+    color?: "green" | "yellow" | "red" | "blue" | "orange" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export declare function Badge({ className, color, ...props }: Omit<HTMLAttributes<HTMLSpanElement>, 'color'> & VariantProps<typeof badgeVariants>): import("react/jsx-runtime").JSX.Element;
 export declare function MethodLabel({ children, ...props }: Omit<HTMLAttributes<HTMLSpanElement>, 'children'> & {