fumadocs-openapi 6.0.1 → 6.0.3

package/dist/utils/generate-document.d.ts

@@ -0,0 +1,20 @@
+import type { ApiPageProps } from '../server/api-page.js';
+import type { GenerateOptions } from '../generate.js';
+import type { Document, TagObject } from '../types.js';
+import type { NoReference } from '../utils/schema.js';
+export type DocumentContext = {
+    type: 'tag';
+    tag: TagObject | undefined;
+} | {
+    type: 'operation';
+} | {
+    type: 'file';
+};
+export declare function generateDocument(options: GenerateOptions & {
+    dereferenced: NoReference<Document>;
+    page: ApiPageProps;
+    title: string;
+    description?: string;
+    context: DocumentContext;
+}): string;
+//# sourceMappingURL=generate-document.d.ts.map

package/dist/utils/generate-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-document.d.ts","sourceRoot":"","sources":["../../src/utils/generate-document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAOlD,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,SAAS,GAAG,SAAS,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,WAAW,CAAC;CACnB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,GAAG;IACzB,YAAY,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;CAC1B,GACA,MAAM,CAkDR"}

package/dist/utils/generate-document.js

@@ -0,0 +1,82 @@
+import { dump } from 'js-yaml';
+import Slugger from 'github-slugger';
+import { idToTitle } from '../utils/id-to-title.js';
+export function generateDocument(options) {
+    const { frontmatter, includeDescription = false } = options;
+    const out = [];
+    const extend = frontmatter?.(options.title, options.description, options.context);
+    let meta;
+    if (options.page.operations?.length === 1) {
+        const operation = options.page.operations[0];
+        meta = {
+            method: operation.method.toUpperCase(),
+            route: operation.path,
+        };
+    }
+    const data = generateStaticData(options.dereferenced, options.page);
+    const banner = dump({
+        title: options.title,
+        description: options.description,
+        full: true,
+        ...extend,
+        _openapi: {
+            ...meta,
+            ...data,
+            ...extend?._openapi,
+        },
+    }).trim();
+    if (banner.length > 0)
+        out.push(`---\n${banner}\n---`);
+    const imports = options.imports
+        ?.map((item) => `import { ${item.names.join(', ')} } from ${JSON.stringify(item.from)};`)
+        .join('\n');
+    if (imports) {
+        out.push(imports);
+    }
+    if (options.description && includeDescription)
+        out.push(options.description);
+    out.push(pageContent(options.page));
+    return out.join('\n\n');
+}
+function generateStaticData(dereferenced, props) {
+    const slugger = new Slugger();
+    const toc = [];
+    const structuredData = { headings: [], contents: [] };
+    for (const item of props.operations ?? []) {
+        const operation = dereferenced.paths?.[item.path]?.[item.method];
+        if (!operation)
+            continue;
+        if (props.hasHead && operation.operationId) {
+            const title = operation.summary ??
+                (operation.operationId ? idToTitle(operation.operationId) : item.path);
+            const id = slugger.slug(title);
+            toc.push({
+                depth: 2,
+                title,
+                url: `#${id}`,
+            });
+            structuredData.headings.push({
+                content: title,
+                id,
+            });
+        }
+        if (operation.description)
+            structuredData.contents.push({
+                content: operation.description,
+                heading: structuredData.headings.at(-1)?.id,
+            });
+    }
+    return { toc, structuredData };
+}
+function pageContent(props) {
+    // filter extra properties in props
+    const operations = (props.operations ?? []).map((item) => ({
+        path: item.path,
+        method: item.method,
+    }));
+    const webhooks = (props.webhooks ?? []).map((item) => ({
+        name: item.name,
+        method: item.method,
+    }));
+    return `<APIPage document={${JSON.stringify(props.document)}} operations={${JSON.stringify(operations)}} webhooks={${JSON.stringify(webhooks)}} hasHead={${JSON.stringify(props.hasHead)}} />`;
+}

package/dist/utils/generate-sample.d.ts

@@ -0,0 +1,33 @@
+import type { MethodInformation, RenderContext } from '../types.js';
+import { type ParsedSchema } from '../utils/schema.js';
+/**
+ * Sample info of endpoint
+ */
+export interface EndpointSample {
+    /**
+     * Request URL, including path and query parameters
+     */
+    url: string;
+    method: string;
+    body?: {
+        schema: ParsedSchema;
+        mediaType: string;
+        sample: unknown;
+    };
+    responses: Record<string, ResponseSample>;
+    parameters: ParameterSample[];
+}
+interface ResponseSample {
+    mediaType: string;
+    sample: unknown;
+    schema: ParsedSchema;
+}
+interface ParameterSample {
+    name: string;
+    in: string;
+    schema: ParsedSchema;
+    sample: unknown;
+}
+export declare function generateSample(path: string, method: MethodInformation, { baseUrl, schema: { document } }: RenderContext): EndpointSample;
+export {};
+//# sourceMappingURL=generate-sample.d.ts.map

package/dist/utils/generate-sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-sample.d.ts","sourceRoot":"","sources":["../../src/utils/generate-sample.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AAGxB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,YAAY,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,EACzB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,GAC/C,cAAc,CA2GhB"}

package/dist/utils/generate-sample.js

@@ -0,0 +1,97 @@
+import { sample } from 'openapi-sampler';
+import { getPreferredType, } from '../utils/schema.js';
+import { getSecurities, getSecurityPrefix } from '../utils/get-security.js';
+export function generateSample(path, method, { baseUrl, schema: { document } }) {
+    const params = [];
+    const responses = {};
+    for (const param of method.parameters ?? []) {
+        if (param.schema) {
+            params.push({
+                name: param.name,
+                in: param.in,
+                schema: param.schema,
+                sample: param.example ?? sample(param.schema),
+            });
+        }
+        else if (param.content) {
+            const key = getPreferredType(param.content);
+            const content = key ? param.content[key] : undefined;
+            if (!key || !content)
+                throw new Error(`Cannot find parameter schema for ${param.name} in ${path} ${method.method}`);
+            params.push({
+                name: param.name,
+                in: param.in,
+                schema: content.schema ?? {},
+                sample: content.example ?? param.example ?? sample(content.schema),
+            });
+        }
+    }
+    const requirements = method.security ?? document.security;
+    if (requirements && requirements.length > 0) {
+        for (const security of getSecurities(requirements[0], document)) {
+            const prefix = getSecurityPrefix(security);
+            params.push({
+                name: security.type === 'apiKey' ? security.name : 'Authorization',
+                schema: {
+                    type: 'string',
+                },
+                sample: prefix ? `${prefix} <token>` : '<token>',
+                in: 'header',
+            });
+        }
+    }
+    let bodyOutput;
+    if (method.requestBody) {
+        const body = method.requestBody.content;
+        const type = getPreferredType(body);
+        if (!type)
+            throw new Error(`Cannot find body schema for ${path} ${method.method}: missing media type`);
+        const schema = (type ? body[type].schema : undefined) ?? {};
+        bodyOutput = {
+            schema,
+            mediaType: type,
+            sample: body[type].example ?? generateBody(method.method, schema),
+        };
+    }
+    for (const [code, response] of Object.entries(method.responses ?? {})) {
+        const content = response.content;
+        if (!content)
+            continue;
+        const mediaType = getPreferredType(content);
+        if (!mediaType)
+            continue;
+        const responseSchema = content[mediaType].schema;
+        if (!responseSchema)
+            continue;
+        responses[code] = {
+            mediaType,
+            sample: content[mediaType].example ??
+                generateBody(method.method, responseSchema),
+            schema: responseSchema,
+        };
+    }
+    let pathWithParameters = path;
+    const queryParams = new URLSearchParams();
+    for (const param of params) {
+        const value = generateBody(method.method, param.schema);
+        if (param.in === 'query')
+            queryParams.append(param.name, String(value));
+        if (param.in === 'path')
+            pathWithParameters = pathWithParameters.replace(`{${param.name}}`, String(value));
+    }
+    if (queryParams.size > 0)
+        pathWithParameters = `${pathWithParameters}?${queryParams.toString()}`;
+    return {
+        url: new URL(`${baseUrl}${pathWithParameters}`).toString(),
+        body: bodyOutput,
+        responses,
+        method: method.method,
+        parameters: params,
+    };
+}
+function generateBody(method, schema) {
+    return sample(schema, {
+        skipReadOnly: method !== 'GET',
+        skipWriteOnly: method === 'GET',
+    });
+}

package/dist/utils/get-security.d.ts

@@ -0,0 +1,8 @@
+import type { Document, SecurityRequirementObject, SecuritySchemeObject } from '../types.js';
+import { type NoReference } from '../utils/schema.js';
+export type Security = SecuritySchemeObject & {
+    scopes: string[];
+};
+export declare function getSecurities(requirement: NoReference<SecurityRequirementObject>, document: NoReference<Document>): Security[];
+export declare function getSecurityPrefix(security: Security): string | undefined;
+//# sourceMappingURL=get-security.d.ts.map

package/dist/utils/get-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-security.d.ts","sourceRoot":"","sources":["../../src/utils/get-security.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,oBAAoB,GAAG;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAgB,aAAa,CAC3B,WAAW,EAAE,WAAW,CAAC,yBAAyB,CAAC,EACnD,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,GAC9B,QAAQ,EAAE,CAeZ;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAQxE"}

package/dist/utils/get-security.js

@@ -0,0 +1,23 @@
+export function getSecurities(requirement, document) {
+    const results = [];
+    const schemas = document.components?.securitySchemes ?? {};
+    for (const [key, scopes] of Object.entries(requirement)) {
+        if (!(key in schemas))
+            return [];
+        const schema = schemas[key];
+        results.push({
+            ...schema,
+            scopes,
+        });
+    }
+    return results;
+}
+export function getSecurityPrefix(security) {
+    if (security.type === 'http')
+        return {
+            basic: 'Basic',
+            bearer: 'Bearer',
+        }[security.scheme];
+    if (security.type === 'oauth2')
+        return 'Bearer';
+}

package/dist/utils/get-typescript-schema.d.ts

@@ -0,0 +1,4 @@
+import type { EndpointSample } from '../utils/generate-sample.js';
+import { DereferenceMap } from '../types.js';
+export declare function getTypescriptSchema(endpoint: EndpointSample, code: string, dereferenceMap: DereferenceMap): Promise<string | undefined>;
+//# sourceMappingURL=get-typescript-schema.d.ts.map

package/dist/utils/get-typescript-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-typescript-schema.d.ts","sourceRoot":"","sources":["../../src/utils/get-typescript-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB7B"}

package/dist/utils/get-typescript-schema.js

@@ -0,0 +1,18 @@
+import { compile } from '@fumari/json-schema-to-typescript';
+export async function getTypescriptSchema(endpoint, code, dereferenceMap) {
+    if (code in endpoint.responses) {
+        return compile(
+        // re-running on the same schema results in error
+        // because it uses `defineProperty` to define internal references
+        // we clone the schema to fix this problem
+        // @ts-expect-error any types
+        endpoint.responses[code].schema, 'Response', {
+            $refOptions: false,
+            schemaToId: dereferenceMap,
+            bannerComment: '',
+            additionalProperties: false,
+            format: true,
+            enableConstEnums: false,
+        });
+    }
+}

package/dist/utils/id-to-title.d.ts

@@ -0,0 +1,2 @@
+export declare function idToTitle(id: string): string;
+//# sourceMappingURL=id-to-title.d.ts.map

package/dist/utils/id-to-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-to-title.d.ts","sourceRoot":"","sources":["../../src/utils/id-to-title.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAa5C"}

package/dist/utils/id-to-title.js

@@ -0,0 +1,17 @@
+export function idToTitle(id) {
+    let result = [];
+    for (const c of id) {
+        if (result.length === 0)
+            result.push(c.toLocaleUpperCase());
+        // ignore the other parts surrounded with '.', like 'migrations.dev' -> 'dev'
+        else if (c === '.')
+            result = [];
+        else if (/^[A-Z]$/.test(c) && result.at(-1) !== ' ')
+            result.push(' ', c);
+        else if (c === '-')
+            result.push(' ');
+        else
+            result.push(c);
+    }
+    return result.join('');
+}

package/dist/utils/input-to-string.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Convert input value to hardcoded string (with quotes)
+ */
+export declare function inputToString(value: unknown, mediaType?: string, multiLine?: 'single-quote' | 'backtick' | 'none'): string;
+//# sourceMappingURL=input-to-string.d.ts.map

package/dist/utils/input-to-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-to-string.d.ts","sourceRoot":"","sources":["../../src/utils/input-to-string.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,SAAS,SAAqB,EAC9B,SAAS,GAAE,cAAc,GAAG,UAAU,GAAG,MAAe,GACvD,MAAM,CAqBR"}

package/dist/utils/input-to-string.js

@@ -0,0 +1,21 @@
+import { js2xml } from 'xml-js';
+/**
+ * Convert input value to hardcoded string (with quotes)
+ */
+export function inputToString(value, mediaType = 'application/json', multiLine = 'none') {
+    const getStr = (v) => {
+        if (multiLine === 'none')
+            return JSON.stringify(v);
+        const delimit = multiLine === 'backtick' ? `\`` : `'`;
+        return `${delimit}${v.replaceAll(delimit, `\\${delimit}`)}${delimit}`;
+    };
+    if (typeof value === 'string')
+        return getStr(value);
+    if (mediaType === 'application/json' || mediaType === 'multipart/form-data') {
+        return getStr(JSON.stringify(value, null, 2));
+    }
+    if (mediaType === 'application/xml') {
+        return getStr(js2xml(value, { compact: true, spaces: 2 }));
+    }
+    throw new Error(`Unsupported media type: ${mediaType}`);
+}

package/dist/utils/process-document.d.ts

@@ -0,0 +1,14 @@
+import type { DereferenceMap, Document } from '../types.js';
+import type { NoReference } from '../utils/schema.js';
+import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
+export type DocumentInput = string | OpenAPIV3_1.Document | OpenAPIV3.Document;
+export type ProcessedDocument = {
+    document: NoReference<Document>;
+    dereferenceMap: DereferenceMap;
+    downloaded: Document;
+};
+/**
+ * process & reference input document to a Fumadocs OpenAPI compatible format
+ */
+export declare function processDocument(document: DocumentInput, disableCache?: boolean): Promise<ProcessedDocument>;
+//# sourceMappingURL=process-document.d.ts.map

package/dist/utils/process-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-document.d.ts","sourceRoot":"","sources":["../../src/utils/process-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,QAAQ,CAAC;CACtB,CAAC;AAIF;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,YAAY,UAAQ,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA8B5B"}

package/dist/utils/process-document.js

@@ -0,0 +1,32 @@
+import { load, dereference, upgrade } from '@scalar/openapi-parser';
+import { fetchUrls } from '@scalar/openapi-parser/plugins/fetch-urls';
+import { readFiles } from '@scalar/openapi-parser/plugins/read-files';
+const cache = new Map();
+/**
+ * process & reference input document to a Fumadocs OpenAPI compatible format
+ */
+export async function processDocument(document, disableCache = false) {
+    const cached = !disableCache && typeof document === 'string' ? cache.get(document) : null;
+    if (cached)
+        return cached;
+    const dereferenceMap = new Map();
+    const loaded = await load(document, {
+        plugins: [readFiles(), fetchUrls()],
+    });
+    // upgrade
+    loaded.specification = upgrade(loaded.specification).specification;
+    const { schema: dereferenced } = await dereference(loaded.filesystem, {
+        onDereference({ ref, schema }) {
+            dereferenceMap.set(schema, ref);
+        },
+    });
+    const processed = {
+        document: dereferenced,
+        dereferenceMap,
+        downloaded: loaded.specification,
+    };
+    if (!disableCache && typeof document === 'string') {
+        cache.set(document, processed);
+    }
+    return processed;
+}

package/dist/utils/schema.d.ts

@@ -0,0 +1,9 @@
+import type { ReferenceObject } from '../types.js';
+import type { OpenAPIV3_1 } from 'openapi-types';
+export type NoReference<T> = T extends (infer I)[] ? NoReference<I>[] : T extends ReferenceObject ? Exclude<T, ReferenceObject> : T extends object ? {
+    [K in keyof T]: NoReference<T[K]>;
+} : T;
+export type ParsedSchema = OpenAPIV3_1.SchemaObject;
+export declare function getPreferredType<B extends Record<string, unknown>>(body: B): keyof B | undefined;
+export declare function isNullable(schema: NoReference<ParsedSchema>, includeOneOf?: boolean): boolean;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC9C,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,eAAe,GACvB,OAAO,CAAC,CAAC,EAAE,eAAe,CAAC,GAC3B,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GACD,CAAC,CAAC;AAEV,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,IAAI,EAAE,CAAC,GACN,MAAM,CAAC,GAAG,SAAS,CAIrB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,EACjC,YAAY,UAAO,GAClB,OAAO,CAQT"}

package/dist/utils/schema.js

@@ -0,0 +1,16 @@
+export function getPreferredType(body) {
+    if ('application/json' in body)
+        return 'application/json';
+    return Object.keys(body)[0];
+}
+export function isNullable(schema, includeOneOf = true) {
+    if (Array.isArray(schema.type) && schema.type.includes('null'))
+        return true;
+    if (includeOneOf && (schema.anyOf || schema.oneOf)) {
+        if (schema.anyOf?.some((item) => isNullable(item)))
+            return true;
+        if (schema.oneOf?.some((item) => isNullable(item)))
+            return true;
+    }
+    return false;
+}

package/dist/utils/server-url.d.ts

@@ -0,0 +1,2 @@
+export declare function getUrl(url: string, variables: Record<string, string>): string;
+//# sourceMappingURL=server-url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-url.d.ts","sourceRoot":"","sources":["../../src/utils/server-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQ7E"}

package/dist/utils/server-url.js

@@ -0,0 +1,7 @@
+export function getUrl(url, variables) {
+    let out = url;
+    for (const [key, value] of Object.entries(variables)) {
+        out = out.replaceAll(`{${key}}`, value);
+    }
+    return out;
+}

package/dist/utils/use-query.d.ts

@@ -0,0 +1,6 @@
+export declare function useQuery<I, T>(fn: (input: I) => Promise<T>): {
+    start: (input: I) => void;
+    data?: T;
+    isLoading: boolean;
+};
+//# sourceMappingURL=use-query.d.ts.map

package/dist/utils/use-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-query.d.ts","sourceRoot":"","sources":["../../src/utils/use-query.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3B;IACD,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;CACpB,CAyBA"}

package/dist/utils/use-query.js

@@ -0,0 +1,22 @@
+import { useMemo, useState } from 'react';
+export function useQuery(fn) {
+    const [loading, setLoading] = useState(false);
+    const [data, setData] = useState();
+    return useMemo(() => ({
+        isLoading: loading,
+        data,
+        start(input) {
+            setLoading(true);
+            void fn(input)
+                .then((res) => {
+                setData(res);
+            })
+                .catch(() => {
+                setData(undefined);
+            })
+                .finally(() => {
+                setLoading(false);
+            });
+        },
+    }), [data, fn, loading]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "6.0.1",
+  "version": "6.0.3",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -45,6 +45,7 @@
     "github-slugger": "^2.0.0",
     "hast-util-to-jsx-runtime": "^2.3.2",
     "js-yaml": "^4.1.0",
+    "lucide-react": "^0.474.0",
     "next-themes": "^0.4.4",
     "openapi-sampler": "^1.6.1",
     "react-hook-form": "^7.54.2",
@@ -52,8 +53,8 @@
     "remark-rehype": "^11.1.1",
     "shiki": "^2.2.0",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "15.0.0",
-    "fumadocs-ui": "15.0.0"
+    "fumadocs-core": "15.0.2",
+    "fumadocs-ui": "15.0.2"
   },
   "devDependencies": {
     "@scalar/api-client-react": "^1.1.22",
@@ -61,11 +62,10 @@
     "@types/node": "22.13.0",
     "@types/openapi-sampler": "^1.0.3",
     "@types/react": "^19.0.8",
-    "bunchee": "^6.3.2",
-    "lucide-react": "^0.474.0",
     "next": "15.1.6",
     "openapi-types": "^12.1.3",
-    "tailwindcss": "^4.0.2",
+    "tailwindcss": "^4.0.3",
+    "tsc-alias": "^1.8.10",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"
   },
@@ -84,9 +84,9 @@
     "access": "public"
   },
   "scripts": {
-    "build": "bunchee",
+    "build": "tsc --project tsconfig.build.json && tsc-alias -p tsconfig.build.json",
     "clean": "rimraf dist",
-    "dev": "bunchee --watch",
+    "dev": "concurrently \"tsc -w --project tsconfig.build.json\" \"tsc-alias -w -p tsconfig.build.json\"",
     "lint": "eslint .",
     "types:check": "tsc --noEmit"
   }

package/dist/scalar/client-client-BXAjVueF.js

@@ -1,93 +0,0 @@
-'use client';
-import { jsx, jsxs } from 'react/jsx-runtime';
-import { cn } from 'fumadocs-ui/components/api';
-import { buttonVariants } from 'fumadocs-ui/components/ui/button';
-import { ApiClientModalProvider, useApiClientModal } from '@scalar/api-client-react';
-import { cva } from 'class-variance-authority';
-import { useTheme } from 'next-themes';
-import { useState, useEffect } from 'react';
-
-const variants = cva('font-mono font-medium', {
-    variants: {
-        color: {
-            green: 'text-green-600 dark:text-green-400',
-            yellow: 'text-yellow-600 dark:text-yellow-400',
-            red: 'text-red-600 dark:text-red-400',
-            blue: 'text-blue-600 dark:text-blue-400',
-            orange: 'text-orange-600 dark:text-orange-400'
-        }
-    }
-});
-function getBadgeColor(method) {
-    switch(method.toUpperCase()){
-        case 'PUT':
-            return 'yellow';
-        case 'PATCH':
-            return 'orange';
-        case 'POST':
-            return 'blue';
-        case 'DELETE':
-            return 'red';
-        default:
-            return 'green';
-    }
-}
-function MethodLabel({ children, ...props }) {
-    return /*#__PURE__*/ jsx("span", {
-        ...props,
-        className: cn(variants({
-            color: getBadgeColor(children)
-        }), props.className),
-        children: children.toUpperCase()
-    });
-}
-
-function ScalarPlayground({ path, method, spec }) {
-    const { resolvedTheme } = useTheme();
-    const [mounted, setMounted] = useState(false);
-    useEffect(()=>{
-        setMounted(true);
-    }, []);
-    return /*#__PURE__*/ jsxs("div", {
-        className: cn('flex flex-row items-center gap-2.5 p-3 rounded-xl border bg-fd-card text-fd-card-foreground not-prose', mounted ? `${resolvedTheme}-mode` : null),
-        children: [
-            /*#__PURE__*/ jsx(MethodLabel, {
-                className: "text-xs",
-                children: method
-            }),
-            /*#__PURE__*/ jsx("code", {
-                className: "flex-1 overflow-auto text-nowrap text-[13px] text-fd-muted-foreground",
-                children: path
-            }),
-            /*#__PURE__*/ jsx(ApiClientModalProvider, {
-                configuration: {
-                    themeId: 'moon',
-                    spec: {
-                        content: spec
-                    }
-                },
-                children: /*#__PURE__*/ jsx(Trigger, {
-                    path: path,
-                    method: method
-                })
-            })
-        ]
-    });
-}
-function Trigger({ path, method }) {
-    const client = useApiClientModal();
-    return /*#__PURE__*/ jsx("button", {
-        type: "submit",
-        className: cn(buttonVariants({
-            color: 'primary',
-            size: 'sm'
-        }), 'px-3 py-1.5'),
-        onClick: ()=>client?.open({
-                path,
-                method: method
-            }),
-        children: "Test"
-    });
-}
-
-export { ScalarPlayground as default };