fumadocs-openapi 9.1.0 → 9.1.2

package/dist/playground/client.js

@@ -142,43 +142,48 @@ function SecurityTabs({ securities, setSecurityId, securityId, children, }) {
     }
     return result;
 }
-const paramNames = ['Headers', 'Cookies', 'Query', 'Path'];
-const paramTypes = ['header', 'cookie', 'query', 'path'];
+const ParamTypes = ['path', 'header', 'cookie', 'query'];
 function FormBody({ parameters = [], fields = {}, body, }) {
-    const params = useMemo(() => {
-        return paramTypes.map((param) => parameters.filter((v) => v.in === param));
-    }, [parameters]);
-    return (_jsxs(_Fragment, { children: [params.map((param, i) => {
-                if (param.length === 0)
-                    return;
-                const name = paramNames[i];
-                const type = paramTypes[i];
-                return (_jsx(CollapsiblePanel, { title: name, children: param.map((field) => {
-                        const fieldName = `${type}.${field.name}`;
-                        const schema = (field.content
-                            ? field.content[Object.keys(field.content)[0]].schema
-                            : field.schema);
-                        if (fields?.parameter) {
-                            return renderCustomField(fieldName, schema, fields.parameter, field.name);
-                        }
-                        return (_jsx(FieldSet, { name: field.name, fieldName: fieldName, field: schema }, fieldName));
-                    }) }, name));
-            }), body && (_jsx(CollapsiblePanel, { title: "Body", children: fields.body ? (renderCustomField('body', body.schema, fields.body)) : (_jsx(BodyInput, { field: body.schema })) }))] }));
+    const panels = useMemo(() => {
+        return ParamTypes.map((type) => {
+            const items = parameters.filter((v) => v.in === type);
+            if (items.length === 0)
+                return;
+            return (_jsx(CollapsiblePanel, { title: {
+                    header: 'Header',
+                    cookie: 'Cookies',
+                    query: 'Query',
+                    path: 'Path',
+                }[type], children: items.map((field) => {
+                    const fieldName = `${type}.${field.name}`;
+                    const schema = (field.content
+                        ? field.content[Object.keys(field.content)[0]].schema
+                        : field.schema);
+                    if (fields?.parameter) {
+                        return renderCustomField(fieldName, schema, fields.parameter, field.name);
+                    }
+                    return (_jsx(FieldSet, { name: field.name, fieldName: fieldName, field: schema }, fieldName));
+                }) }, type));
+        });
+    }, [fields.parameter, parameters]);
+    return (_jsxs(_Fragment, { children: [panels, body && (_jsx(CollapsiblePanel, { title: "Body", children: fields.body ? (renderCustomField('body', body.schema, fields.body)) : (_jsx(BodyInput, { field: body.schema })) }))] }));
 }
 function BodyInput({ field: _field }) {
     const field = useResolvedSchema(_field);
     const [isJson, setIsJson] = useState(false);
     if (field.format === 'binary')
         return _jsx(FieldSet, { field: field, fieldName: "body" });
-    return (_jsx(_Fragment, { children: isJson ? (_jsxs(_Fragment, { children: [_jsx("button", { className: cn(buttonVariants({
+    if (isJson)
+        return (_jsxs(_Fragment, { children: [_jsx("button", { className: cn(buttonVariants({
                         color: 'secondary',
                         size: 'sm',
                         className: 'w-fit font-mono p-2',
-                    })), onClick: () => setIsJson(false), type: "button", children: "Close JSON Editor" }), _jsx(JsonInput, { fieldName: "body" })] })) : (_jsx(FieldSet, { field: field, fieldName: "body", collapsible: false, name: _jsx("button", { className: cn(buttonVariants({
-                    color: 'secondary',
-                    size: 'sm',
-                    className: 'p-2',
-                })), onClick: () => setIsJson(true), type: "button", children: "Open JSON Editor" }) })) }));
+                    })), onClick: () => setIsJson(false), type: "button", children: "Close JSON Editor" }), _jsx(JsonInput, { fieldName: "body" })] }));
+    return (_jsx(FieldSet, { field: field, fieldName: "body", collapsible: false, name: _jsx("button", { type: "button", className: cn(buttonVariants({
+                color: 'secondary',
+                size: 'sm',
+                className: 'p-2',
+            })), onClick: () => setIsJson(true), children: "Open JSON Editor" }) }));
 }
 /**
  * manipulate values without mutating the original object

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playground/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,oBAAoB,EACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG;IAC1D,MAAM,EAAE,YAAY,CAAC;IACrB,EAAE,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAQzC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,aAAa,CAAC;IAEnB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B;AAED,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG;IACjD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,wBAAsB,aAAa,CAAC,EAClC,IAAI,EACJ,MAAM,EACN,GAAG,EACH,MAAM,GACP,EAAE,kBAAkB,oDAwCpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playground/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,oBAAoB,EACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG;IAC1D,MAAM,EAAE,YAAY,CAAC;IACrB,EAAE,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAQzC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,aAAa,CAAC;IAEnB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B;AAED,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG;IACjD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,wBAAsB,aAAa,CAAC,EAClC,IAAI,EACJ,MAAM,EACN,GAAG,EACH,MAAM,GACP,EAAE,kBAAkB,oDAkCpB"}

package/dist/playground/index.js

@@ -16,10 +16,7 @@ export async function APIPlayground({ path, method, ctx, client, }) {
         securities: parseSecurities(method, ctx),
         method: method.method,
         route: path,
-        parameters: method.parameters?.map((v) => ({
-            ...v,
-            schema: writeReferences((v.schema ?? true), context),
-        })),
+        parameters: method.parameters,
         body: bodyContent && mediaType
             ? {
                 schema: writeReferences(bodyContent[mediaType].schema, context),

package/dist/playground/inputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/playground/inputs.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAef,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAkDxD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EAAE,MAAM,EACb,SAAS,EACT,GAAG,KAAK,EACT,EAAE;IACD,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CAAC,KAAK,CAAC,uDAwCxB;AAED,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,2CA8B7D;AA6FD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,UAAU,EACV,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,uDA6FA;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EACT,OAAO,EACP,IAAI,EACJ,UAAU,EACV,KAAS,EACT,QAAQ,EACR,WAAkB,EAClB,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,kDA2KA"}
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/playground/inputs.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAef,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAkDxD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EAAE,MAAM,EACb,SAAS,EACT,GAAG,KAAK,EACT,EAAE;IACD,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CAAC,KAAK,CAAC,uDAwCxB;AAED,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,2CA8B7D;AA6FD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,UAAU,EACV,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,uDA6FA;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EACT,OAAO,EACP,IAAI,EACJ,UAAU,EACV,KAAS,EACT,QAAQ,EACR,WAAkB,EAClB,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,kDA4KA"}

package/dist/playground/inputs.js

@@ -85,7 +85,7 @@ function DynamicProperties({ fieldName, filterKey = () => true, getType = () =>
                             setProperties((p) => p.filter((prop) => prop !== item));
                             control.unregister(`${fieldName}.${item}`);
                         }, children: _jsx(Trash2, {}) }) }, item));
-            }), _jsxs("div", { className: "flex gap-2", children: [_jsx(Input, { value: nextName, placeholder: "Enter Property Name", onChange: (e) => setNextName(e.target.value), onKeyDown: (e) => {
+            }), _jsxs("div", { className: "flex gap-2 col-span-full", children: [_jsx(Input, { value: nextName, placeholder: "Enter Property Name", onChange: (e) => setNextName(e.target.value), onKeyDown: (e) => {
                             if (e.key === 'Enter') {
                                 onAppend();
                                 e.preventDefault();
@@ -119,13 +119,14 @@ export function FieldSet({ field: _field, fieldName, toolbar, name, isRequired,
     const { info, updateInfo } = useFieldInfo(fieldName, field, depth);
     if (_field === false)
         return null;
-    if (field.oneOf) {
-        const showSelect = field.oneOf.length > 1;
-        return (_jsx(FieldSet, { ...props, name: name, fieldName: fieldName, isRequired: isRequired, field: field.oneOf[info.oneOf], depth: depth + 1, slotType: showSelect ? false : slotType, toolbar: _jsxs(_Fragment, { children: [showSelect && (_jsx("select", { className: "text-xs font-mono", value: info.oneOf, onChange: (e) => {
+    if (info.unionField) {
+        const union = field[info.unionField];
+        const showSelect = union.length > 1;
+        return (_jsx(FieldSet, { ...props, name: name, fieldName: fieldName, isRequired: isRequired, field: union[info.oneOf], depth: depth + 1, slotType: showSelect ? false : slotType, toolbar: _jsxs(_Fragment, { children: [showSelect && (_jsx("select", { className: "text-xs font-mono", value: info.oneOf, onChange: (e) => {
                             updateInfo({
                                 oneOf: Number(e.target.value),
                             });
-                        }, children: field.oneOf.map((item, i) => (_jsx("option", { value: i, children: schemaToString(item) }, i))) })), toolbar] }) }));
+                        }, children: union.map((item, i) => (_jsx("option", { value: i, children: schemaToString(item) }, i))) })), toolbar] }) }));
     }
     if (Array.isArray(field.type)) {
         const showSelect = field.type.length > 1;

package/dist/playground/schema.d.ts

@@ -6,9 +6,14 @@ interface SchemaContextType {
     fieldInfoMap: Map<string, FieldInfo>;
     ajv: Ajv2020;
 }
+type UnionField = 'anyOf' | 'allOf' | 'oneOf';
 export interface FieldInfo {
     selectedType?: string;
     oneOf: number;
+    /**
+     * The actual field that represents union members.
+     */
+    unionField?: UnionField;
 }
 export declare const anyFields: {
     type: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/playground/schema.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAiB,SAAS,EAAiC,MAAM,OAAO,CAAC;AAKhF,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrC,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,eAAO,MAAM,SAAS;;;;CAIG,CAAC;AAE1B,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,YAAY,EACZ,QAAQ,GACT,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAsB1D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,EACvC,KAAK,EAAE,MAAM,GACZ;IACD,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;CACjD,CAiEA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAQjC;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAEjC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/playground/schema.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAiB,SAAS,EAAiC,MAAM,OAAO,CAAC;AAMhF,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrC,GAAG,EAAE,OAAO,CAAC;CACd;AAED,KAAK,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAGD,eAAO,MAAM,SAAS;;;;CAIG,CAAC;AAE1B,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,YAAY,EACZ,QAAQ,GACT,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAsB1D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,EACvC,KAAK,EAAE,MAAM,GACZ;IACD,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;CACjD,CA8FA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAQjC;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAEjC"}

package/dist/playground/schema.js

@@ -28,50 +28,79 @@ export function SchemaProvider({ references, fieldInfoMap, children, }) {
  */
 export function useFieldInfo(fieldName, schema, depth) {
     const { fieldInfoMap, ajv } = useContext(SchemaContext);
-    const [_, trigger] = useState(0);
     const form = useFormContext();
     const keyName = `${fieldName}:${depth}`;
     const value = form.getValues(fieldName);
-    const info = fieldInfoMap.get(keyName) ?? {
-        oneOf: -1,
-    };
-    // update info if needed
-    if (!info.selectedType && Array.isArray(schema.type)) {
-        info.selectedType =
-            schema.type.find((type) => ajv.validate({
-                ...schema,
-                type,
-            }, value)) ?? schema.type[0];
-    }
-    if (info.oneOf === -1 && schema.oneOf) {
-        info.oneOf = schema.oneOf.findIndex((item) => {
-            return ajv.validate(item, value);
+    const [info, setInfo] = useState(() => {
+        return fieldInfoMap.get(keyName) ?? init();
+    });
+    fieldInfoMap.set(keyName, info);
+    /**
+     * We automatically merge `allOf` | `anyOf` if all members are objects, but it's also possible for them to behave same as a union (`oneOf`).
+     */
+    function isUnion(anyOrAllOf) {
+        return anyOrAllOf.every((item) => {
+            if (typeof item === 'boolean')
+                return true;
+            const u = item.anyOf || item.allOf;
+            return item.type !== 'object' && (!u || isUnion(u));
         });
-        if (info.oneOf === -1)
-            info.oneOf = 0;
     }
-    fieldInfoMap.set(keyName, info);
+    function getUnion() {
+        if (schema.anyOf && isUnion(schema.anyOf)) {
+            return [schema.anyOf, 'anyOf'];
+        }
+        if (schema.allOf && isUnion(schema.allOf)) {
+            return [schema.allOf, 'allOf'];
+        }
+        if (schema.oneOf)
+            return [schema.oneOf, 'oneOf'];
+    }
+    function init() {
+        const union = getUnion();
+        if (union) {
+            const [members, field] = union;
+            let oneOf = members.findIndex((item) => ajv.validate(item, value));
+            if (oneOf === -1)
+                oneOf = 0;
+            return {
+                oneOf,
+                unionField: field,
+            };
+        }
+        if (Array.isArray(schema.type)) {
+            const types = schema.type;
+            return {
+                selectedType: types.find((type) => {
+                    schema.type = type;
+                    const match = ajv.validate(schema, value);
+                    schema.type = types;
+                    return match;
+                }) ?? types[0],
+                oneOf: -1,
+            };
+        }
+        return { oneOf: -1 };
+    }
     return {
         info,
         updateInfo: useEffectEvent((value) => {
-            const prev = fieldInfoMap.get(keyName);
-            if (!prev)
-                return;
             const updated = {
-                ...prev,
+                ...info,
                 ...value,
             };
-            if (updated.oneOf === prev.oneOf &&
-                updated.selectedType === prev.selectedType)
+            if (updated.oneOf === info.oneOf &&
+                updated.selectedType === info.selectedType)
                 return;
-            fieldInfoMap.set(keyName, updated);
-            form.setValue(fieldName, getDefaultValue(schema.oneOf && updated.oneOf !== -1
-                ? schema.oneOf[updated.oneOf]
-                : {
-                    ...schema,
-                    type: value.selectedType ?? schema.type,
-                }));
-            trigger((prev) => prev + 1);
+            setInfo(updated);
+            let valueSchema = schema;
+            if (updated.unionField) {
+                valueSchema = schema[updated.unionField][updated.oneOf];
+            }
+            else if (updated.selectedType) {
+                valueSchema = { ...schema, type: updated.selectedType };
+            }
+            form.setValue(fieldName, getDefaultValue(valueSchema));
         }),
     };
 }

package/dist/render/operation/index.js

@@ -87,7 +87,7 @@ async function ResponseAccordion({ status, operation, ctx, }) {
     const contentTypes = response.content
         ? Object.entries(response.content)
         : null;
-    return (_jsxs(SelectTabs, { defaultValue: contentTypes?.[0][0], children: [_jsxs(AccordionHeader, { children: [_jsx(AccordionTrigger, { className: "font-mono", children: status }), contentTypes && (_jsx(SelectTabTrigger, { items: contentTypes.map((v) => v[0]) }))] }), _jsxs(AccordionContent, { children: [response.description && (_jsx("div", { className: "prose-no-margin", children: _jsx(Markdown, { text: response.description }) })), contentTypes?.map(async ([type, resType]) => {
+    return (_jsxs(SelectTabs, { defaultValue: contentTypes?.[0][0], children: [_jsxs(AccordionHeader, { children: [_jsx(AccordionTrigger, { className: "font-mono", children: status }), contentTypes && (_jsx(SelectTabTrigger, { items: contentTypes.map((v) => v[0]) }))] }), _jsxs(AccordionContent, { className: "ps-4.5", children: [response.description && (_jsx("div", { className: "prose-no-margin", children: _jsx(Markdown, { text: response.description }) })), contentTypes?.map(async ([type, resType]) => {
                         const schema = resType.schema;
                         let ts;
                         if (generateTypeScriptSchema) {
@@ -96,7 +96,7 @@ async function ResponseAccordion({ status, operation, ctx, }) {
                         else if (generateTypeScriptSchema === undefined && schema) {
                             ts = await getTypescriptSchema(schema, dereferenceMap);
                         }
-                        return (_jsxs(SelectTab, { value: type, className: "mt-2", children: [ts && _jsx(CopyResponseTypeScript, { code: ts }), schema && (_jsx("div", { className: "border px-3 rounded-lg my-2 overflow-auto max-h-[400px]", children: _jsx(Schema, { name: "response", schema: schema, as: "body", readOnly: true, ctx: ctx }) }))] }, type));
+                        return (_jsxs(SelectTab, { value: type, className: "my-2", children: [ts && _jsx(CopyResponseTypeScript, { code: ts }), schema && (_jsx("div", { className: "border px-3 py-2 rounded-lg overflow-auto max-h-[400px]", children: _jsx(Schema, { name: "response", schema: schema, as: "body", readOnly: true, ctx: ctx }) }))] }, type));
                     })] })] }));
 }
 function WebhookCallback({ callback, ctx, headingLevel, }) {

package/dist/ui/components/accordion.js

@@ -10,7 +10,7 @@ export function AccordionItem(props) {
     return (_jsx(Primitive.Item, { ...props, className: cn('scroll-m-20', props.className), children: props.children }));
 }
 export function AccordionContent(props) {
-    return (_jsx(Primitive.Content, { ...props, className: cn('overflow-hidden px-1 data-[state=closed]:animate-fd-accordion-up data-[state=open]:animate-fd-accordion-down', props.className), children: props.children }));
+    return (_jsx(Primitive.Content, { ...props, className: cn('overflow-hidden data-[state=closed]:animate-fd-accordion-up data-[state=open]:animate-fd-accordion-down', props.className), children: props.children }));
 }
 export function AccordionHeader(props) {
     return (_jsx(Primitive.Header, { ...props, className: cn('not-prose flex py-2 text-fd-foreground font-medium', props.className), children: props.children }));

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

@@ -1 +1 @@
-{"version":3,"file":"schema-to-string.d.ts","sourceRoot":"","sources":["../../src/utils/schema-to-string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,GAAG,CAAC,EAAE,iBAAiB,GACtB,MAAM,CA8DR"}
+{"version":3,"file":"schema-to-string.d.ts","sourceRoot":"","sources":["../../src/utils/schema-to-string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,GAAG,CAAC,EAAE,iBAAiB,GACtB,MAAM,CAmER"}

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

@@ -1,47 +1,52 @@
 export function schemaToString(value, ctx) {
-    function run(schema, isRoot) {
+    function union(union, sep) {
+        const members = new Set();
+        let nullable = false;
+        for (const item of union) {
+            const result = run(item);
+            if (result === 'null') {
+                nullable = true;
+            }
+            else if (result !== 'unknown') {
+                members.add(result);
+            }
+        }
+        const result = Array.from(members).join(sep);
+        return nullable ? `${result} | null` : result;
+    }
+    function run(schema) {
         if (schema === true)
             return 'any';
         else if (schema === false)
             return 'never';
-        if (isNullable(schema) && isRoot) {
-            const type = run(schema, false);
-            // null if schema only contains `nullable`
-            return type === 'unknown' ? 'null' : `${type} | null`;
-        }
         if (schema.title)
             return schema.title;
         const referenceName = ctx?.dereferenceMap.get(schema);
         if (referenceName)
             return referenceName.split('/').at(-1);
         if (Array.isArray(schema.type)) {
-            return schema.type
-                .map((type, _, originalType) => {
+            const members = new Set();
+            const types = schema.type;
+            for (const type of types) {
                 schema.type = type;
-                const str = run(schema, false);
-                schema.type = originalType;
-                return str;
-            })
-                .filter((v) => v !== 'unknown' && v !== 'null')
-                .join(' | ');
+                const str = run(schema);
+                schema.type = types;
+                if (str !== 'unknown')
+                    members.add(str);
+            }
+            return Array.from(members).join(' | ');
         }
         if (schema.type === 'array')
-            return `array<${schema.items ? run(schema.items, true) : 'unknown'}>`;
+            return `array<${schema.items ? run(schema.items) : 'unknown'}>`;
         if (schema.oneOf) {
-            return schema.oneOf
-                .map((one) => run(one, false))
-                .filter((v) => v !== 'unknown' && v !== 'null')
-                .join(' | ');
+            return union(schema.oneOf, ' | ');
         }
         const combinedOf = schema.anyOf ?? schema.allOf;
         if (combinedOf) {
-            return combinedOf
-                .map((one) => run(one, false))
-                .filter((v) => v !== 'unknown' && v !== 'null')
-                .join(' & ');
+            return union(combinedOf, ' & ');
         }
         if (schema.not)
-            return `not ${run(schema.not, false)}`;
+            return `not ${run(schema.not)}`;
         if (schema.type === 'string' && schema.format === 'binary')
             return 'file';
         if (schema.type && Array.isArray(schema.type)) {
@@ -52,15 +57,5 @@ export function schemaToString(value, ctx) {
         }
         return 'unknown';
     }
-    return run(value, true);
-}
-function isNullable(schema) {
-    if (typeof schema === 'boolean')
-        return false;
-    if (Array.isArray(schema.type) && schema.type.includes('null'))
-        return true;
-    const combined = schema.anyOf ?? schema.oneOf ?? schema.allOf;
-    if (combined && combined.some(isNullable))
-        return true;
-    return schema.type === 'null';
+    return run(value);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "9.1.0",
+  "version": "9.1.2",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -50,7 +50,7 @@
     "@radix-ui/react-dialog": "^1.1.14",
     "@radix-ui/react-select": "^2.2.5",
     "@radix-ui/react-slot": "^1.2.3",
-    "@scalar/openapi-parser": "0.18.0",
+    "@scalar/openapi-parser": "0.18.1",
     "ajv": "^8.17.1",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
@@ -58,23 +58,23 @@
     "js-yaml": "^4.1.0",
     "next-themes": "^0.4.6",
     "openapi-sampler": "^1.6.1",
-    "react-hook-form": "^7.59.0",
+    "react-hook-form": "^7.60.0",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
     "shiki": "^3.7.0",
     "tinyglobby": "^0.2.14",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "15.6.2",
-    "fumadocs-ui": "15.6.2"
+    "fumadocs-core": "15.6.3",
+    "fumadocs-ui": "15.6.3"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^1.3.18",
+    "@scalar/api-client-react": "^1.3.21",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "24.0.7",
+    "@types/node": "24.0.13",
     "@types/openapi-sampler": "^1.0.3",
     "@types/react": "^19.1.8",
     "json-schema-typed": "^8.0.1",
-    "next": "15.3.4",
+    "next": "15.3.5",
     "openapi-types": "^12.1.3",
     "tailwindcss": "^4.1.11",
     "tsc-alias": "^1.8.16",