fumadocs-openapi 6.3.0 → 7.0.0-beta.0

package/dist/requests/curl.d.ts

@@ -1,3 +1,3 @@
-import { type EndpointSample } from '../utils/generate-sample.js';
-export declare function getSampleRequest(endpoint: EndpointSample, sampleKey: string): string;
+import { type RequestData } from '../requests/_shared.js';
+export declare function getSampleRequest(url: string, data: RequestData): string;
 //# sourceMappingURL=curl.d.ts.map

package/dist/requests/curl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"curl.d.ts","sourceRoot":"","sources":["../../src/requests/curl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAChB,MAAM,CA0CR"}
+{"version":3,"file":"curl.d.ts","sourceRoot":"","sources":["../../src/requests/curl.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAqCvE"}

package/dist/requests/curl.js

@@ -1,28 +1,27 @@
+'use client';
 import { inputToString } from '../utils/input-to-string.js';
-export function getSampleRequest(endpoint, sampleKey) {
+import { getUrl } from '../requests/_shared.js';
+export function getSampleRequest(url, data) {
     const s = [];
-    s.push(`curl -X ${endpoint.method} "${endpoint.url}"`);
-    for (const param of endpoint.parameters) {
-        if (param.in === 'header') {
-            const header = `${param.name}: ${param.sample}`;
-            s.push(`-H "${header}"`);
-        }
-        if (param.in === 'cookie') {
-            const cookie = JSON.stringify(`${param.name}=${param.sample}`);
-            s.push(`--cookie ${cookie}`);
-        }
+    s.push(`curl -X ${data.method} "${getUrl(url, data)}"`);
+    for (const header in data.header) {
+        const value = `${header}: ${data.header[header]}`;
+        s.push(`-H "${value}"`);
+    }
+    for (const cookie in data.cookie) {
+        const value = JSON.stringify(`${cookie}=${data.cookie[cookie]}`);
+        s.push(`--cookie ${value}`);
     }
-    if (endpoint.body?.mediaType === 'multipart/form-data') {
-        const sample = endpoint.body.samples[sampleKey]?.value;
-        if (sample && typeof sample === 'object') {
-            for (const [key, value] of Object.entries(sample)) {
+    if (data.bodyMediaType === 'multipart/form-data') {
+        if (data.body && typeof data.body === 'object') {
+            for (const [key, value] of Object.entries(data.body)) {
                 s.push(`-F ${key}=${inputToString(value)}`);
             }
         }
     }
-    else if (endpoint.body) {
-        s.push(`-H "Content-Type: ${endpoint.body.mediaType}"`);
-        s.push(`-d ${inputToString(endpoint.body.samples[sampleKey]?.value ?? '', endpoint.body.mediaType, 'single-quote')}`);
+    else if (data.body) {
+        s.push(`-H "Content-Type: ${data.bodyMediaType}"`);
+        s.push(`-d ${inputToString(data.body, data.bodyMediaType, 'single-quote')}`);
     }
     return s
         .flatMap((v, i) => v

package/dist/requests/go.d.ts

@@ -1,3 +1,3 @@
-import { type EndpointSample } from '../utils/generate-sample.js';
-export declare function getSampleRequest(endpoint: EndpointSample, sampleKey: string): string;
+import { type RequestData } from '../requests/_shared.js';
+export declare function getSampleRequest(url: string, data: RequestData): string;
 //# sourceMappingURL=go.d.ts.map

package/dist/requests/go.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"go.d.ts","sourceRoot":"","sources":["../../src/requests/go.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAChB,MAAM,CA4ER"}
+{"version":3,"file":"go.d.ts","sourceRoot":"","sources":["../../src/requests/go.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAwEvE"}

package/dist/requests/go.js

@@ -1,32 +1,33 @@
+'use client';
 import { inputToString } from '../utils/input-to-string.js';
-export function getSampleRequest(endpoint, sampleKey) {
+import { getUrl } from '../requests/_shared.js';
+export function getSampleRequest(url, data) {
     const imports = ['fmt', 'net/http', 'io/ioutil'];
     const headers = new Map();
     const variables = new Map();
+    variables.set('url', JSON.stringify(getUrl(url, data)));
     // additional lines before initializing request
     const additional = [];
-    for (const p of endpoint.parameters) {
-        if (p.in === 'header')
-            headers.set(p.name, JSON.stringify(p.sample));
+    for (const header in data.header) {
+        headers.set(header, JSON.stringify(data.header[header]));
     }
-    const cookies = endpoint.parameters.filter((p) => p.in === 'cookie');
-    variables.set('url', JSON.stringify(endpoint.url));
+    const cookies = Object.keys(data.cookie);
     if (cookies.length > 0)
-        headers.set('Cookie', JSON.stringify(cookies.map((p) => `${p.name}=${p.sample}`).join('; ')));
-    if (endpoint.body) {
-        headers.set('Content-Type', `"${endpoint.body.mediaType}"`);
-        if (endpoint.body.mediaType === 'multipart/form-data' &&
-            typeof endpoint.body.samples[sampleKey]?.value === 'object') {
+        headers.set('Cookie', JSON.stringify(cookies.map((p) => `${p}=${data.cookie[p]}`).join('; ')));
+    if (data.body) {
+        headers.set('Content-Type', `"${data.bodyMediaType}"`);
+        if (data.bodyMediaType === 'multipart/form-data' &&
+            typeof data.body === 'object') {
             imports.push('mime/multipart', 'bytes');
             variables.set('payload', `new(bytes.Buffer)`);
             variables.set('mp', 'multipart.NewWriter(payload)');
-            for (const [key, value] of Object.entries(endpoint.body.samples[sampleKey]?.value ?? {})) {
+            for (const [key, value] of Object.entries(data.body)) {
                 additional.push(`mp.WriteField("${key}", ${inputToString(value, undefined, 'backtick')})`);
             }
         }
         else {
             imports.push('strings');
-            variables.set('payload', `strings.NewReader(${inputToString(endpoint.body.samples[sampleKey]?.value ?? '', endpoint.body.mediaType, 'backtick').replaceAll('\n', '\n  ')})`);
+            variables.set('payload', `strings.NewReader(${inputToString(data.body, data.bodyMediaType, 'backtick').replaceAll('\n', '\n  ')})`);
         }
     }
     return `package main
@@ -40,7 +41,7 @@ ${Array.from(variables.entries())
         .map(([k, v]) => `  ${k} := ${v}`)
         .join('\n')}
   ${additional.join('\n  ')}
-  req, _ := http.NewRequest("${endpoint.method}", url, ${variables.has('payload') ? 'payload' : 'nil'})
+  req, _ := http.NewRequest("${data.method}", url, ${variables.has('payload') ? 'payload' : 'nil'})
   ${Array.from(headers.entries())
         .map(([key, value]) => `req.Header.Add("${key}", ${value})`)
         .join('\n  ')}

package/dist/requests/index.d.ts

@@ -0,0 +1,3 @@
+import type { CodeSample } from '../render/operation/index.js';
+export declare const defaultSamples: CodeSample[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/requests/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMrD,eAAO,MAAM,cAAc,EAAE,UAAU,EAqBtC,CAAC"}

package/dist/requests/index.js

@@ -0,0 +1,26 @@
+import * as CURL from '../requests/curl.js';
+import * as JS from '../requests/javascript.js';
+import * as Go from '../requests/go.js';
+import * as Python from '../requests/python.js';
+export const defaultSamples = [
+    {
+        label: 'cURL',
+        source: CURL.getSampleRequest,
+        lang: 'bash',
+    },
+    {
+        label: 'JavaScript',
+        source: JS.getSampleRequest,
+        lang: 'js',
+    },
+    {
+        label: 'Go',
+        source: Go.getSampleRequest,
+        lang: 'go',
+    },
+    {
+        label: 'Python',
+        source: Python.getSampleRequest,
+        lang: 'python',
+    },
+];

package/dist/requests/javascript.d.ts

@@ -1,3 +1,3 @@
-import { type EndpointSample } from '../utils/generate-sample.js';
-export declare function getSampleRequest(endpoint: EndpointSample, sampleKey: string): string;
+import { type RequestData } from '../requests/_shared.js';
+export declare function getSampleRequest(url: string, data: RequestData): string;
 //# sourceMappingURL=javascript.d.ts.map

package/dist/requests/javascript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"javascript.d.ts","sourceRoot":"","sources":["../../src/requests/javascript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAChB,MAAM,CA8ER"}
+{"version":3,"file":"javascript.d.ts","sourceRoot":"","sources":["../../src/requests/javascript.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAmDvE"}

package/dist/requests/javascript.js

@@ -1,49 +1,42 @@
+'use client';
 import { inputToString } from '../utils/input-to-string.js';
-export function getSampleRequest(endpoint, sampleKey) {
+import { getUrl } from '../requests/_shared.js';
+export function getSampleRequest(url, data) {
     const s = [];
     const options = new Map();
-    const headers = new Map();
-    const cookies = new Map();
-    for (const param of endpoint.parameters) {
-        if (param.in === 'header') {
-            headers.set(param.name, param.sample);
-        }
-        if (param.in === 'cookie') {
-            cookies.set(param.name, param.sample);
-        }
-    }
-    if (cookies.size > 0) {
-        headers.set('cookie', Array.from(cookies.entries())
+    const headers = { ...data.header };
+    if (Object.keys(data.cookie).length > 0) {
+        headers['cookie'] = Object.entries(data.cookie)
             .map(([key, value]) => `${key}=${value}`)
-            .join('; '));
+            .join('; ');
     }
-    if (headers.size > 0) {
-        options.set('headers', JSON.stringify(Object.fromEntries(headers.entries()), null, 2).replaceAll('\n', '\n  '));
+    if (Object.keys(headers).length > 0) {
+        options.set('headers', JSON.stringify(headers, null, 2).replaceAll('\n', '\n  '));
     }
-    if (endpoint.body?.mediaType === 'multipart/form-data' &&
-        typeof endpoint.body.samples[sampleKey]?.value === 'object' &&
-        endpoint.body.samples[sampleKey]?.value) {
+    if (data.bodyMediaType === 'multipart/form-data' &&
+        typeof data.body === 'object' &&
+        data.body) {
         s.push(`const formData = new FormData();`);
-        for (const [key, value] of Object.entries(endpoint.body.samples[sampleKey]?.value))
+        for (const [key, value] of Object.entries(data.body))
             s.push(`formData.set(${key}, ${inputToString(value)})`);
         options.set('body', 'formData');
     }
-    else if (endpoint.body) {
+    else if (data.body) {
         let code;
-        if (endpoint.body.mediaType === 'application/json') {
+        if (data.bodyMediaType === 'application/json') {
             code =
-                typeof endpoint.body.samples[sampleKey]?.value === 'string'
-                    ? inputToString(endpoint.body.samples[sampleKey]?.value, endpoint.body.mediaType, 'backtick')
-                    : `JSON.stringify(${JSON.stringify(endpoint.body.samples[sampleKey]?.value, null, 2)})`;
+                typeof data.body === 'string'
+                    ? inputToString(data.body, data.bodyMediaType, 'backtick')
+                    : `JSON.stringify(${JSON.stringify(data.body, null, 2)})`;
         }
         else {
-            code = inputToString(endpoint.body.samples[sampleKey]?.value ?? '', endpoint.body.mediaType, 'backtick');
+            code = inputToString(data.body, data.bodyMediaType, 'backtick');
         }
         options.set('body', code.replaceAll('\n', '\n  '));
     }
     const optionsStr = Array.from(options.entries())
         .map(([k, v]) => `  ${k}: ${v}`)
         .join(',\n');
-    s.push(`fetch(${JSON.stringify(endpoint.url)}, {\n${optionsStr}\n});`);
+    s.push(`fetch(${JSON.stringify(getUrl(url, data))}, {\n${optionsStr}\n});`);
     return s.join('\n\n');
 }

package/dist/requests/python.d.ts

@@ -1,3 +1,3 @@
-import { type EndpointSample } from '../utils/generate-sample.js';
-export declare function getSampleRequest(endpoint: EndpointSample, sampleKey: string): string;
+import { type RequestData } from '../requests/_shared.js';
+export declare function getSampleRequest(url: string, data: RequestData): string;
 //# sourceMappingURL=python.d.ts.map

package/dist/requests/python.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../src/requests/python.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAChB,MAAM,CA4ER"}
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../src/requests/python.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CA8CvE"}

package/dist/requests/python.js

@@ -1,41 +1,37 @@
+'use client';
 import { inputToString } from '../utils/input-to-string.js';
-export function getSampleRequest(endpoint, sampleKey) {
-    const headers = new Map();
-    const cookies = new Map();
+import { getUrl } from '../requests/_shared.js';
+export function getSampleRequest(url, data) {
     const variables = new Map();
-    for (const param of endpoint.parameters) {
-        if (param.in === 'header')
-            headers.set(param.name, param.sample);
-        if (param.in === 'cookie')
-            cookies.set(param.name, param.sample);
-    }
-    if (endpoint.body) {
-        switch (endpoint.body.mediaType) {
+    const headers = { ...data.header };
+    if (data.body) {
+        switch (data.bodyMediaType) {
             case 'application/json':
-                variables.set('json', JSON.stringify(endpoint.body.samples[sampleKey]?.value ?? {}, null, 2));
+                variables.set('json', JSON.stringify(data.body, null, 2));
                 break;
             case 'multipart/form-data':
-                headers.set('Content-Type', endpoint.body.mediaType);
-                variables.set('data', JSON.stringify(endpoint.body.samples[sampleKey]?.value ?? {}, null, 2));
+                headers['Content-Type'] = data.bodyMediaType;
+                variables.set('data', JSON.stringify(data.body, null, 2));
                 break;
             default:
-                headers.set('Content-Type', endpoint.body.mediaType);
-                variables.set('data', inputToString(endpoint.body.samples[sampleKey]?.value ?? '', endpoint.body.mediaType, 'python'));
+                if (data.bodyMediaType)
+                    headers['Content-Type'] = data.bodyMediaType;
+                variables.set('data', inputToString(data.body, data.bodyMediaType, 'python'));
         }
     }
-    if (headers.size > 0) {
-        variables.set('headers', JSON.stringify(Object.fromEntries(headers.entries()), null, 2));
+    if (Object.keys(headers).length > 0) {
+        variables.set('headers', JSON.stringify(headers, null, 2));
     }
-    if (cookies.size > 0) {
-        variables.set('cookies', JSON.stringify(Object.fromEntries(cookies.entries()), null, 2));
+    if (Object.keys(data.cookie).length > 0) {
+        variables.set('cookies', JSON.stringify(data.cookie, null, 2));
     }
     return `import requests
 
-url = ${JSON.stringify(endpoint.url)}
+url = ${JSON.stringify(getUrl(url, data))}
 ${Array.from(variables.entries())
         .map(([k, v]) => `${k} = ${v}`)
         .join('\n')}
-response = requests.request("${endpoint.method}", url${variables.size > 0
+response = requests.request("${data.method}", url${variables.size > 0
         ? `, ${Array.from(variables.keys())
             .map((k) => `${k}=${k}`)
             .join(', ')}`

package/dist/server/api-page.js

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

package/dist/types.d.ts

@@ -1,8 +1,7 @@
 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 { EndpointSample } from './utils/generate-sample.js';
-import type { CodeSample } from './render/operation.js';
+import type { CodeSample } from './render/operation/index.js';
 import type { BuiltinTheme, CodeOptionsThemes, CodeToHastOptionsCommon } from 'shiki';
 import type { NoReference } from './utils/schema.js';
 import type { ProcessedDocument } from './utils/process-document.js';
@@ -46,14 +45,14 @@ export interface RenderContext {
      *
      * Pass `false` to disable it.
      *
-     * @param endpoint - the API endpoint
-     * @param code - status code
+     * @param method - the operation object
+     * @param statusCode - status code
      */
-    generateTypeScriptSchema?: ((endpoint: EndpointSample, code: string) => Awaitable<string>) | false;
+    generateTypeScriptSchema?: ((method: NoReference<MethodInformation>, statusCode: string) => Awaitable<string>) | false;
     /**
      * Generate code samples for endpoint.
      */
-    generateCodeSamples?: (endpoint: EndpointSample) => Awaitable<CodeSample[]>;
+    generateCodeSamples?: (method: NoReference<MethodInformation>) => Awaitable<CodeSample[]>;
     shikiOptions?: Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BuiltinTheme>;
     /**
      * Show full response schema instead of only example response & Typescript definitions

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,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,yBAAyB,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;AACjD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;AACvC,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAE9D,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;;;;;;OAOG;IACH,wBAAwB,CAAC,EACrB,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC,GAC/D,KAAK,CAAC;IAEV;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IAE5E,YAAY,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,CAAC,GAClD,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAElC;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}
+{"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,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,yBAAyB,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;AACjD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;AACvC,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAE9D,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;;;;;;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,CACpB,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,KACnC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7B,YAAY,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,CAAC,GAClD,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAElC;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/dist/ui/client.d.ts

@@ -1,3 +1,2 @@
-export declare const Samples: import("react").ComponentType<import("../render/renderer.js").SamplesProps>;
-export declare const Sample: import("react").ComponentType<import("../render/renderer.js").SampleProps>;
+export { ClientLazy as APIPlayground } from '../playground/client.lazy.js';
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ui/client.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,0EAEnB,CAAC;AAEF,eAAO,MAAM,MAAM,yEAElB,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ui/client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,IAAI,aAAa,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/ui/client.js

@@ -1,4 +1,2 @@
 'use client';
-import dynamic from 'next/dynamic';
-export const Samples = dynamic(() => import('./sample-select.js').then((mod) => mod.Samples));
-export const Sample = dynamic(() => import('./sample-select.js').then((mod) => mod.Sample));
+export { ClientLazy as APIPlayground } from '../playground/client.lazy.js';

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'> & {

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

@@ -1,4 +1,4 @@
-import { type ReactNode, type RefObject } from 'react';
+import { type ReactNode } from 'react';
 import type { RenderContext, ServerObject } from '../../types.js';
 export interface ApiProviderProps {
     /**
@@ -9,13 +9,11 @@ export interface ApiProviderProps {
     shikiOptions: RenderContext['shikiOptions'];
     children?: ReactNode;
 }
-interface SelectedServer {
+export interface SelectedServer {
     url: string;
     variables: Record<string, string>;
 }
-interface ApiContextType extends Omit<ApiProviderProps, 'children' | 'defaultBaseUrl'> {
-    serverRef: RefObject<SelectedServer | null>;
-}
+type ApiContextType = Omit<ApiProviderProps, 'children' | 'defaultBaseUrl'>;
 interface ServerSelectType {
     server: SelectedServer | null;
     setServer: (value: string) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/ui/contexts/api.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAE5C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,UAAU,cACR,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,gBAAgB,CAAC;IAC7D,SAAS,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC7C;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAC7D;AAOD,wBAAgB,aAAa,IAAI,cAAc,CAK9C;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAKzD;AAED,wBAAgB,WAAW,CAAC,EAC1B,cAAc,EACd,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,gBAAgB,2CA0ElB"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/ui/contexts/api.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAE5C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,KAAK,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,gBAAgB,CAAC,CAAC;AAE5E,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAC7D;AAOD,wBAAgB,aAAa,IAAI,cAAc,CAK9C;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAKzD;AAED,wBAAgB,WAAW,CAAC,EAC1B,cAAc,EACd,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,gBAAgB,2CA+DlB"}

package/dist/ui/contexts/api.js

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { createContext, useContext, useEffect, useMemo, useState, } from 'react';
 const ApiContext = createContext(undefined);
 const ServerSelectContext = createContext(undefined);
 export function useApiContext() {
@@ -27,8 +27,6 @@ export function ApiProvider({ defaultBaseUrl, children, ...props }) {
             }
             : null;
     });
-    const serverRef = useRef(server);
-    serverRef.current = server;
     useEffect(() => {
         const cached = localStorage.getItem('apiBaseUrl');
         if (!cached)
@@ -43,10 +41,7 @@ export function ApiProvider({ defaultBaseUrl, children, ...props }) {
             // ignore
         }
     }, []);
-    return (_jsx(ApiContext.Provider, { value: useMemo(() => ({
-            ...props,
-            serverRef,
-        }), [props]), children: _jsx(ServerSelectContext.Provider, { value: useMemo(() => ({
+    return (_jsx(ApiContext.Provider, { value: props, children: _jsx(ServerSelectContext.Provider, { value: useMemo(() => ({
                 server,
                 setServerVariables(variables) {
                     setServer((prev) => {

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

@@ -0,0 +1,25 @@
+import type { CodeSample } from '../../render/operation/index.js';
+import type { SamplesProps } from '../../render/renderer.js';
+import type { RequestData } from '../../requests/_shared.js';
+export declare function CodeExampleProvider({ route, examples, initialKey, children, }: {
+    route: string;
+    examples: {
+        key: string;
+        data: RequestData;
+    }[];
+    initialKey?: string;
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function CodeExample(props: CodeSample): import("react/jsx-runtime").JSX.Element | null;
+export declare function CodeExampleSelector({ items }: SamplesProps): import("react/jsx-runtime").JSX.Element;
+export declare function useRequestData(): {
+    /**
+     * initial request data
+     */
+    data: RequestData;
+    /**
+     * Save changes to request data, it won't trigger re-render on the component itself, which makes it safe to call in an effect with `data` as dep
+     */
+    saveData: (data: RequestData) => void;
+};
+//# sourceMappingURL=code-example.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-example.d.ts","sourceRoot":"","sources":["../../../src/ui/contexts/code-example.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAUtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqBtD,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,WAAW,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,2CAqDA;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,kDAsC5C;AAED,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE,YAAY,2CAoB1D;AAgBD,wBAAgB,cAAc;IAaxB;;OAEG;;IAEH;;OAEG;qBAZgC,WAAW;EAiBnD"}

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

@@ -0,0 +1,104 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { useApiContext, useServerSelectContext } from '../../ui/contexts/api.js';
+import { DynamicCodeBlock } from 'fumadocs-ui/components/dynamic-codeblock';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '../../ui/components/select.js';
+import { useEffectEvent } from 'fumadocs-core/utils/use-effect-event';
+import { getUrl } from '../../utils/server-url.js';
+import { defaultSamples } from '../../requests/index.js';
+const CodeExampleContext = createContext(null);
+export function CodeExampleProvider({ route, examples, initialKey, children, }) {
+    const [key, setKey] = useState(initialKey ?? examples[0].key);
+    const listeners = useRef([]);
+    const setData = useEffectEvent((newData) => {
+        for (const example of examples) {
+            if (example.key === key) {
+                // persistent changes
+                example.data = newData;
+            }
+        }
+        for (const listener of listeners.current) {
+            listener(newData);
+        }
+    });
+    const updateKey = useEffectEvent((newKey) => {
+        const data = examples.find((example) => example.key === newKey)?.data;
+        if (!data)
+            return;
+        setKey(newKey);
+        for (const listener of listeners.current) {
+            listener(data);
+        }
+    });
+    const addListener = useEffectEvent((listener) => {
+        listeners.current.push(listener);
+    });
+    const removeListener = useEffectEvent((listener) => {
+        listeners.current = listeners.current.filter((item) => item !== listener);
+    });
+    return (_jsx(CodeExampleContext, { value: useMemo(() => ({
+            key,
+            route,
+            setKey: updateKey,
+            examples,
+            setData,
+            removeListener,
+            addListener,
+        }), [addListener, examples, key, removeListener, route, setData, updateKey]), children: children }));
+}
+export function CodeExample(props) {
+    const { shikiOptions } = useApiContext();
+    const { examples, key, route, addListener, removeListener } = useContext(CodeExampleContext);
+    const { server } = useServerSelectContext();
+    const [data, setData] = useState(() => {
+        return examples.find((example) => example.key === key).data;
+    });
+    const sample = useMemo(() => {
+        if (props.source)
+            return props;
+        return defaultSamples.find((item) => item.label === props.label);
+    }, [props]);
+    useEffect(() => {
+        const listener = setData;
+        addListener(listener);
+        return () => {
+            removeListener(listener);
+        };
+    }, [addListener, removeListener]);
+    const code = useMemo(() => {
+        if (!sample?.source)
+            return;
+        if (typeof sample.source === 'string')
+            return sample.source;
+        return sample.source(`${server ? getUrl(server.url, server.variables) : '/'}${route}`, data);
+    }, [sample, server, route, data]);
+    if (!code || !sample)
+        return null;
+    return (_jsx(DynamicCodeBlock, { lang: sample.lang, code: code, options: shikiOptions }));
+}
+export function CodeExampleSelector({ items }) {
+    const { key, setKey } = useContext(CodeExampleContext);
+    const item = items.find((item) => item.value === key);
+    return (_jsxs(Select, { value: key, onValueChange: setKey, children: [_jsx(SelectTrigger, { className: "not-prose mb-2", children: _jsx(SelectValue, { asChild: true, children: item ? _jsx(SelectDisplay, { item: item }) : null }) }), _jsx(SelectContent, { children: items.map((item) => (_jsx(SelectItem, { value: item.value, children: _jsx(SelectDisplay, { item: item }) }, item.value))) })] }));
+}
+function SelectDisplay({ item, ...props }) {
+    return (_jsxs("div", { ...props, children: [_jsx("span", { className: "font-medium text-sm", children: item.title }), _jsx("span", { className: "text-fd-muted-foreground", children: item.description })] }));
+}
+export function useRequestData() {
+    const { examples, key, setData } = useContext(CodeExampleContext);
+    const data = useMemo(() => examples.find((example) => example.key === key).data, [examples, key]);
+    const saveData = useEffectEvent((data) => {
+        setData(data);
+    });
+    return useMemo(() => ({
+        /**
+         * initial request data
+         */
+        data,
+        /**
+         * Save changes to request data, it won't trigger re-render on the component itself, which makes it safe to call in an effect with `data` as dep
+         */
+        saveData,
+    }), [data, saveData]);
+}

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

@@ -0,0 +1,12 @@
+export declare const CodeExampleProvider: import("react").ComponentType<{
+    route: string;
+    examples: {
+        key: string;
+        data: import("../../requests/_shared.js").RequestData;
+    }[];
+    initialKey?: string;
+    children: React.ReactNode;
+}>;
+export declare const CodeExample: import("react").ComponentType<import("../../render/operation/index.js").CodeSample>;
+export declare const CodeExampleSelector: import("react").ComponentType<import("../../render/renderer.js").SamplesProps>;
+//# sourceMappingURL=code-example.lazy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-example.lazy.d.ts","sourceRoot":"","sources":["../../../src/ui/contexts/code-example.lazy.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB;;;;;;;cASi4B,MAAO,SAAS;EAPh7B,CAAC;AACF,eAAO,MAAM,WAAW,4EAEvB,CAAC;AACF,eAAO,MAAM,mBAAmB,6EAE/B,CAAC"}