@orval/core 7.7.0 → 7.9.0

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import * as openapi3_ts_oas30 from 'openapi3-ts/oas30';
 import { InfoObject, OperationObject, OpenAPIObject, ResponsesObject, ReferenceObject, RequestBodyObject, ParameterObject, SchemaObject, ComponentsObject, SchemasObject, PathItemObject, ResponseObject, ExampleObject } from 'openapi3-ts/oas30';
 import swagger2openapi from 'swagger2openapi';
 import { TypeDocOptions } from 'typedoc';
+import { SchemaObject as SchemaObject$1 } from 'openapi3-ts/dist/model/openapi30';
 import { ValueIteratee } from 'lodash';
 import { ServerObject } from 'openapi3-ts/oas31';
 import { CompareOperator } from 'compare-versions';
@@ -72,7 +73,7 @@ type NormalizedOverrideOutput = {
     mock?: OverrideMockOptions;
     contentType?: OverrideOutputContentType;
     header: false | ((info: InfoObject) => string[] | string);
-    formData: boolean | NormalizedMutator;
+    formData: NormalizedFormDataType<NormalizedMutator>;
     formUrlEncoded: boolean | NormalizedMutator;
     paramsSerializer?: NormalizedMutator;
     paramsSerializerOptions?: NormalizedParamsSerializerOptions;
@@ -105,7 +106,7 @@ type NormalizedOverrideOutput = {
     useDeprecatedOperations?: boolean;
     useBigInt?: boolean;
     useNamedParameters?: boolean;
-    useNativeEnums?: boolean;
+    enumGenerationType: EnumGeneration;
     suppressReadonlyModifier?: boolean;
 };
 type NormalizedMutator = {
@@ -129,7 +130,7 @@ type NormalizedOperationOptions = {
     zod?: NormalizedZodOptions;
     operationName?: (operation: OperationObject, route: string, verb: Verbs) => string;
     fetch?: FetchOptions;
-    formData?: boolean | NormalizedMutator;
+    formData?: NormalizedFormDataType<NormalizedMutator>;
     formUrlEncoded?: boolean | NormalizedMutator;
     paramsSerializer?: NormalizedMutator;
     requestOptions?: object | boolean;
@@ -169,6 +170,12 @@ declare const NamingConvention: {
     readonly KEBAB_CASE: "kebab-case";
 };
 type NamingConvention = (typeof NamingConvention)[keyof typeof NamingConvention];
+declare const EnumGeneration: {
+    readonly CONST: "const";
+    readonly ENUM: "enum";
+    readonly UNION: "union";
+};
+type EnumGeneration = (typeof EnumGeneration)[keyof typeof EnumGeneration];
 type OutputOptions = {
     workspace?: string;
     target?: string;
@@ -223,6 +230,7 @@ declare const OutputClient: {
     readonly ZOD: "zod";
     readonly HONO: "hono";
     readonly FETCH: "fetch";
+    readonly MCP: "mcp";
 };
 type OutputClient = (typeof OutputClient)[keyof typeof OutputClient];
 declare const OutputHttpClient: {
@@ -295,6 +303,28 @@ type Mutator = string | MutatorObject;
 type ParamsSerializerOptions = {
     qs?: Record<string, any>;
 };
+declare const FormDataArrayHandling: {
+    readonly SERIALIZE: "serialize";
+    readonly EXPLODE: "explode";
+    readonly SERIALIZE_WITH_BRACKETS: "serialize-with-brackets";
+};
+type FormDataArrayHandling = (typeof FormDataArrayHandling)[keyof typeof FormDataArrayHandling];
+type NormalizedFormDataType<TMutator> = {
+    disabled: true;
+    mutator?: never;
+    arrayHandling: FormDataArrayHandling;
+} | {
+    disabled: false;
+    mutator?: TMutator;
+    arrayHandling: FormDataArrayHandling;
+};
+type FormDataType<TMutator> = {
+    mutator: TMutator;
+    arrayHandling?: FormDataArrayHandling;
+} | {
+    mutator?: TMutator;
+    arrayHandling: FormDataArrayHandling;
+};
 type OverrideOutput = {
     title?: (title: string) => string;
     transformer?: OutputTransformer;
@@ -308,7 +338,7 @@ type OverrideOutput = {
     mock?: OverrideMockOptions;
     contentType?: OverrideOutputContentType;
     header?: boolean | ((info: InfoObject) => string[] | string);
-    formData?: boolean | Mutator;
+    formData?: boolean | Mutator | FormDataType<Mutator>;
     formUrlEncoded?: boolean | Mutator;
     paramsSerializer?: Mutator;
     paramsSerializerOptions?: ParamsSerializerOptions;
@@ -340,7 +370,11 @@ type OverrideOutput = {
     useDeprecatedOperations?: boolean;
     useBigInt?: boolean;
     useNamedParameters?: boolean;
+    /**
+     * @deprecated use 'enumGenerationType="enum"' instead
+     */
     useNativeEnums?: boolean;
+    enumGenerationType?: EnumGeneration;
     suppressReadonlyModifier?: boolean;
 };
 type OverrideOutputContentType = {
@@ -353,6 +387,11 @@ type NormalizedHonoOptions = {
     validator: boolean | 'hono';
     validatorOutputPath: string;
 };
+type ZodDateTimeOptions = {
+    offset?: boolean;
+    local?: boolean;
+    precision?: number;
+};
 type ZodOptions = {
     strict?: {
         param?: boolean;
@@ -382,6 +421,7 @@ type ZodOptions = {
         body?: Mutator;
         response?: Mutator;
     };
+    dateTimeOptions?: ZodDateTimeOptions;
     generateEachHttpStatus?: boolean;
 };
 type ZodCoerceType = 'string' | 'number' | 'boolean' | 'bigint' | 'date';
@@ -415,6 +455,7 @@ type NormalizedZodOptions = {
         response?: NormalizedMutator;
     };
     generateEachHttpStatus: boolean;
+    dateTimeOptions: ZodDateTimeOptions;
 };
 type HonoOptions = {
     handlers?: string;
@@ -490,7 +531,7 @@ type OperationOptions = {
     zod?: ZodOptions;
     operationName?: (operation: OperationObject, route: string, verb: Verbs) => string;
     fetch?: FetchOptions;
-    formData?: boolean | Mutator;
+    formData?: boolean | Mutator | FormDataType<Mutator>;
     formUrlEncoded?: boolean | Mutator;
     paramsSerializer?: Mutator;
     requestOptions?: object | boolean;
@@ -1089,7 +1130,8 @@ declare const combineSchemas: ({ name, schema, separator, context, nullable, }:
 
 declare const resolveDiscriminators: (schemas: SchemasObject, context: ContextSpecs) => SchemasObject;
 
-declare const getEnum: (value: string, enumName: string, names?: string[], useNativeEnums?: boolean) => string;
+declare const getEnumNames: (schemaObject: SchemaObject$1 | undefined) => any;
+declare const getEnum: (value: string, enumName: string, names: string[] | undefined, enumGenerationType: EnumGeneration) => string;
 declare const getEnumImplementation: (value: string, names?: string[]) => string;
 
 declare const getKey: (key: string) => string;
@@ -1473,4 +1515,4 @@ declare const generateTarget: (builder: WriteSpecsBuilder, options: NormalizedOu
 
 declare const generateTargetForTags: (builder: WriteSpecsBuilder, options: NormalizedOutputOptions) => Record<string, GeneratorTarget>;
 
-export { type AngularOptions, BODY_TYPE_NAME, type BaseUrlFromConstant, type BaseUrlFromSpec, type ClientBuilder, type ClientDependenciesBuilder, type ClientExtraFilesBuilder, type ClientFileBuilder, type ClientFooterBuilder, type ClientGeneratorsBuilder, type ClientHeaderBuilder, type ClientMockBuilder, type ClientMockGeneratorBuilder, type ClientMockGeneratorImplementation, type ClientTitleBuilder, type Config, type ConfigExternal, type ConfigFn, type ContextSpecs, type FetchOptions, type GenerateMockImports, type GeneratorApiBuilder, type GeneratorApiOperations, type GeneratorApiResponse, type GeneratorClient, type GeneratorClientExtra, type GeneratorClientFooter, type GeneratorClientHeader, type GeneratorClientImports, type GeneratorClientTitle, type GeneratorClients, type GeneratorDependency, type GeneratorImport, type GeneratorMutator, type GeneratorMutatorParsingInfo, type GeneratorOperation, type GeneratorOperations, type GeneratorOptions, type GeneratorSchema, type GeneratorTarget, type GeneratorTargetFull, type GeneratorVerbOptions, type GeneratorVerbsOptions, type GetterBody, type GetterParam, type GetterParameters, type GetterParams, type GetterProp, GetterPropType, type GetterProps, type GetterQueryParam, type GetterResponse, type GlobalMockOptions, type GlobalOptions, type HonoOptions, type Hook, type HookCommand, type HookFunction, type HookOption, type HooksOptions, type ImportOpenApi, type InputFiltersOption, type InputOptions, type InputTransformerFn, type LogLevel, LogLevels, type LogOptions, type LogType, type Logger, type LoggerOptions, type MockData, type MockDataArray, type MockDataArrayFn, type MockDataObject, type MockDataObjectFn, type MockOptions, type MockProperties, type MockPropertiesObject, type MockPropertiesObjectFn, type Mutator, type MutatorObject, NamingConvention, type NormalizedConfig, type NormalizedHonoOptions, type NormalizedHookCommand, type NormalizedHookOptions, type NormalizedInputOptions, type NormalizedMutator, type NormalizedOperationOptions, type NormalizedOptions, type NormalizedOutputOptions, type NormalizedOverrideOutput, type NormalizedParamsSerializerOptions, type NormalizedQueryOptions, type NormalizedZodOptions, type OperationOptions, type Options, type OptionsExport, type OptionsFn, OutputClient, type OutputClientFunc, type OutputDocsOptions, OutputHttpClient, OutputMockType, OutputMode, type OutputOptions, type OverrideInput, type OverrideMockOptions, type OverrideOutput, type OverrideOutputContentType, type PackageJson, type ParamsSerializerOptions, PropertySortOrder, type QueryOptions, RefComponentSuffix, type RefInfo, type ResReqTypesValue, type ResolverValue, type ScalarValue, SchemaType, type SchemaWithConst, type SwaggerParserOptions, type SwrOptions, TEMPLATE_TAG_REGEX, type TsConfigTarget, type Tsconfig, URL_REGEX, VERBS_WITH_BODY, Verbs, type WriteModeProps, type WriteSpecsBuilder, type ZodCoerceType, type ZodOptions, _filteredVerbs, addDependency, asyncReduce, camel, combineSchemas, compareVersions, conventionName, count, createDebugger, createLogger, createSuccessMessage, dynamicImport, escape, generalJSTypes, generalJSTypesWithArray, generateAxiosOptions, generateBodyMutatorConfig, generateBodyOptions, generateComponentDefinition, generateDependencyImports, generateFormDataAndUrlEncodedFunction, generateImports, generateModelInline, generateModelsInline, generateMutator, generateMutatorConfig, generateMutatorImports, generateMutatorRequestOptions, generateOptions, generateParameterDefinition, generateQueryParamsAxiosConfig, generateSchemasDefinition, generateTarget, generateTargetForTags, generateVerbImports, generateVerbsOptions, getArray, getBody, getEnum, getEnumImplementation, getExtension, getFileInfo, getFullRoute, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getRoute, getRouteAsArray, getScalar, ibmOpenapiValidator, ibmOpenapiValidatorErrors, ibmOpenapiValidatorWarnings, isBoolean, isDirectory, isFunction, isModule, isNull, isNumber, isNumeric, isObject, isReference, isRootKey, isSchema, isString, isSyntheticDefaultImportsAllow, isUndefined, isUrl, isVerb, jsDoc, jsStringEscape, kebab, loadFile, log, logError, mergeDeep, mismatchArgsMessage, openApiConverter, pascal, removeFiles, resolveDiscriminators, resolveExampleRefs, resolveObject, resolveRef, resolveValue, sanitize, snake, sortByPriority, startMessage, stringify, toObjectString, path as upath, upper, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };
+export { type AngularOptions, BODY_TYPE_NAME, type BaseUrlFromConstant, type BaseUrlFromSpec, type ClientBuilder, type ClientDependenciesBuilder, type ClientExtraFilesBuilder, type ClientFileBuilder, type ClientFooterBuilder, type ClientGeneratorsBuilder, type ClientHeaderBuilder, type ClientMockBuilder, type ClientMockGeneratorBuilder, type ClientMockGeneratorImplementation, type ClientTitleBuilder, type Config, type ConfigExternal, type ConfigFn, type ContextSpecs, EnumGeneration, type FetchOptions, FormDataArrayHandling, type FormDataType, type GenerateMockImports, type GeneratorApiBuilder, type GeneratorApiOperations, type GeneratorApiResponse, type GeneratorClient, type GeneratorClientExtra, type GeneratorClientFooter, type GeneratorClientHeader, type GeneratorClientImports, type GeneratorClientTitle, type GeneratorClients, type GeneratorDependency, type GeneratorImport, type GeneratorMutator, type GeneratorMutatorParsingInfo, type GeneratorOperation, type GeneratorOperations, type GeneratorOptions, type GeneratorSchema, type GeneratorTarget, type GeneratorTargetFull, type GeneratorVerbOptions, type GeneratorVerbsOptions, type GetterBody, type GetterParam, type GetterParameters, type GetterParams, type GetterProp, GetterPropType, type GetterProps, type GetterQueryParam, type GetterResponse, type GlobalMockOptions, type GlobalOptions, type HonoOptions, type Hook, type HookCommand, type HookFunction, type HookOption, type HooksOptions, type ImportOpenApi, type InputFiltersOption, type InputOptions, type InputTransformerFn, type LogLevel, LogLevels, type LogOptions, type LogType, type Logger, type LoggerOptions, type MockData, type MockDataArray, type MockDataArrayFn, type MockDataObject, type MockDataObjectFn, type MockOptions, type MockProperties, type MockPropertiesObject, type MockPropertiesObjectFn, type Mutator, type MutatorObject, NamingConvention, type NormalizedConfig, type NormalizedFormDataType, type NormalizedHonoOptions, type NormalizedHookCommand, type NormalizedHookOptions, type NormalizedInputOptions, type NormalizedMutator, type NormalizedOperationOptions, type NormalizedOptions, type NormalizedOutputOptions, type NormalizedOverrideOutput, type NormalizedParamsSerializerOptions, type NormalizedQueryOptions, type NormalizedZodOptions, type OperationOptions, type Options, type OptionsExport, type OptionsFn, OutputClient, type OutputClientFunc, type OutputDocsOptions, OutputHttpClient, OutputMockType, OutputMode, type OutputOptions, type OverrideInput, type OverrideMockOptions, type OverrideOutput, type OverrideOutputContentType, type PackageJson, type ParamsSerializerOptions, PropertySortOrder, type QueryOptions, RefComponentSuffix, type RefInfo, type ResReqTypesValue, type ResolverValue, type ScalarValue, SchemaType, type SchemaWithConst, type SwaggerParserOptions, type SwrOptions, TEMPLATE_TAG_REGEX, type TsConfigTarget, type Tsconfig, URL_REGEX, VERBS_WITH_BODY, Verbs, type WriteModeProps, type WriteSpecsBuilder, type ZodCoerceType, type ZodDateTimeOptions, type ZodOptions, _filteredVerbs, addDependency, asyncReduce, camel, combineSchemas, compareVersions, conventionName, count, createDebugger, createLogger, createSuccessMessage, dynamicImport, escape, generalJSTypes, generalJSTypesWithArray, generateAxiosOptions, generateBodyMutatorConfig, generateBodyOptions, generateComponentDefinition, generateDependencyImports, generateFormDataAndUrlEncodedFunction, generateImports, generateModelInline, generateModelsInline, generateMutator, generateMutatorConfig, generateMutatorImports, generateMutatorRequestOptions, generateOptions, generateParameterDefinition, generateQueryParamsAxiosConfig, generateSchemasDefinition, generateTarget, generateTargetForTags, generateVerbImports, generateVerbsOptions, getArray, getBody, getEnum, getEnumImplementation, getEnumNames, getExtension, getFileInfo, getFullRoute, getIsBodyVerb, getKey, getMockFileExtensionByTypeName, getNumberWord, getObject, getOperationId, getOrvalGeneratedTypes, getParameters, getParams, getParamsInPath, getProps, getQueryParams, getRefInfo, getResReqTypes, getResponse, getRoute, getRouteAsArray, getScalar, ibmOpenapiValidator, ibmOpenapiValidatorErrors, ibmOpenapiValidatorWarnings, isBoolean, isDirectory, isFunction, isModule, isNull, isNumber, isNumeric, isObject, isReference, isRootKey, isSchema, isString, isSyntheticDefaultImportsAllow, isUndefined, isUrl, isVerb, jsDoc, jsStringEscape, kebab, loadFile, log, logError, mergeDeep, mismatchArgsMessage, openApiConverter, pascal, removeFiles, resolveDiscriminators, resolveExampleRefs, resolveObject, resolveRef, resolveValue, sanitize, snake, sortByPriority, startMessage, stringify, toObjectString, path as upath, upper, writeModelInline, writeModelsInline, writeSchema, writeSchemas, writeSingleMode, writeSplitMode, writeSplitTagsMode, writeTagsMode };

package/dist/index.js

@@ -4682,7 +4682,7 @@ var require_lodash = __commonJS({
         function isArrayLikeObject(value) {
           return isObjectLike(value) && isArrayLike(value);
         }
-        function isBoolean2(value) {
+        function isBoolean3(value) {
           return value === true || value === false || isObjectLike(value) && baseGetTag(value) == boolTag;
         }
         var isBuffer = nativeIsBuffer || stubFalse;
@@ -5819,7 +5819,7 @@ var require_lodash = __commonJS({
         lodash.isArrayBuffer = isArrayBuffer;
         lodash.isArrayLike = isArrayLike;
         lodash.isArrayLikeObject = isArrayLikeObject;
-        lodash.isBoolean = isBoolean2;
+        lodash.isBoolean = isBoolean3;
         lodash.isBuffer = isBuffer;
         lodash.isDate = isDate;
         lodash.isElement = isElement;
@@ -9475,14 +9475,14 @@ var require_bool = __commonJS({
     function constructYamlBoolean(data) {
       return data === "true" || data === "True" || data === "TRUE";
     }
-    function isBoolean2(object) {
+    function isBoolean3(object) {
       return "[object Boolean]" === Object.prototype.toString.call(object);
     }
     module2.exports = new type_1.Type("tag:yaml.org,2002:bool", {
       kind: "scalar",
       resolve: resolveYamlBoolean,
       construct: constructYamlBoolean,
-      predicate: isBoolean2,
+      predicate: isBoolean3,
       represent: {
         lowercase: function(object) {
           return object ? "true" : "false";
@@ -31107,7 +31107,7 @@ var require_index_node_cjs = __commonJS({
        * @returns {string}
        */
       static get version() {
-        return "1.3.9";
+        return "1.4.0";
       }
       /**
        * @returns {string}
@@ -31890,6 +31890,7 @@ var require_index_node_cjs = __commonJS({
       // see [Order of operations](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence)
       binary_ops: {
         "||": 1,
+        "??": 1,
         "&&": 2,
         "|": 3,
         "^": 4,
@@ -31909,10 +31910,11 @@ var require_index_node_cjs = __commonJS({
         "-": 9,
         "*": 10,
         "/": 10,
-        "%": 10
+        "%": 10,
+        "**": 11
       },
       // sets specific binary_ops as right-associative
-      right_associative: /* @__PURE__ */ new Set(),
+      right_associative: /* @__PURE__ */ new Set(["**"]),
       // Additional valid identifier chars, apart from a-z, A-Z and 0-9 (except on the starting char)
       additional_identifier_chars: /* @__PURE__ */ new Set(["$", "_"]),
       // Literals
@@ -32028,7 +32030,7 @@ var require_index_node_cjs = __commonJS({
     var MINUS_CODE = 45;
     var plugin = {
       name: "assignment",
-      assignmentOperators: /* @__PURE__ */ new Set(["=", "*=", "**=", "/=", "%=", "+=", "-=", "<<=", ">>=", ">>>=", "&=", "^=", "|="]),
+      assignmentOperators: /* @__PURE__ */ new Set(["=", "*=", "**=", "/=", "%=", "+=", "-=", "<<=", ">>=", ">>>=", "&=", "^=", "|=", "||=", "&&=", "??="]),
       updateOperators: [PLUS_CODE, MINUS_CODE],
       assignmentPrecedence: 0.9,
       init(jsep2) {
@@ -32090,6 +32092,7 @@ var require_index_node_cjs = __commonJS({
     jsep.addUnaryOp("typeof");
     jsep.addLiteral("null", null);
     jsep.addLiteral("undefined", void 0);
+    var BLOCKED_PROTO_PROPERTIES = /* @__PURE__ */ new Set(["constructor", "__proto__", "__defineGetter__", "__defineSetter__"]);
     var SafeEval = {
       /**
        * @param {jsep.Expression} ast
@@ -32168,7 +32171,7 @@ var require_index_node_cjs = __commonJS({
         return SafeEval.evalAst(ast.alternate, subs);
       },
       evalIdentifier(ast, subs) {
-        if (ast.name in subs) {
+        if (Object.hasOwn(subs, ast.name)) {
           return subs[ast.name];
         }
         throw ReferenceError(`${ast.name} is not defined`);
@@ -32177,22 +32180,22 @@ var require_index_node_cjs = __commonJS({
         return ast.value;
       },
       evalMemberExpression(ast, subs) {
-        if (ast.property.type === "Identifier" && ast.property.name === "constructor" || ast.object.type === "Identifier" && ast.object.name === "constructor") {
-          throw new Error("'constructor' property is disabled");
-        }
-        const prop = ast.computed ? SafeEval.evalAst(ast.property) : ast.property.name;
+        const prop = String(
+          // NOTE: `String(value)` throws error when
+          // value has overwritten the toString method to return non-string
+          // i.e. `value = {toString: () => []}`
+          ast.computed ? SafeEval.evalAst(ast.property) : ast.property.name
+          // `object.property` property is Identifier
+        );
         const obj = SafeEval.evalAst(ast.object, subs);
+        if (obj === void 0 || obj === null) {
+          throw TypeError(`Cannot read properties of ${obj} (reading '${prop}')`);
+        }
+        if (!Object.hasOwn(obj, prop) && BLOCKED_PROTO_PROPERTIES.has(prop)) {
+          throw TypeError(`Cannot read properties of ${obj} (reading '${prop}')`);
+        }
         const result = obj[prop];
         if (typeof result === "function") {
-          if (obj === Function && prop === "bind") {
-            throw new Error("Function.prototype.bind is disabled");
-          }
-          if (obj === Function && (prop === "call" || prop === "apply")) {
-            throw new Error("Function.prototype.call and Function.prototype.apply are disabled");
-          }
-          if (result === Function) {
-            return result;
-          }
           return result.bind(obj);
         }
         return result;
@@ -32214,9 +32217,6 @@ var require_index_node_cjs = __commonJS({
       evalCallExpression(ast, subs) {
         const args = ast.arguments.map((arg) => SafeEval.evalAst(arg, subs));
         const func = SafeEval.evalAst(ast.callee, subs);
-        if (func === Function) {
-          throw new Error("Function constructor is disabled");
-        }
         return func(...args);
       },
       evalAssignmentExpression(ast, subs) {
@@ -32224,9 +32224,6 @@ var require_index_node_cjs = __commonJS({
           throw SyntaxError("Invalid left-hand side in assignment");
         }
         const id = ast.left.name;
-        if (id === "__proto__") {
-          throw new Error("Assignment to __proto__ is disabled");
-        }
         const value = SafeEval.evalAst(ast.right, subs);
         subs[id] = value;
         return subs[id];
@@ -32246,9 +32243,7 @@ var require_index_node_cjs = __commonJS({
        * @returns {EvaluatedResult} Result of evaluated code
        */
       runInNewContext(context) {
-        const keyMap = {
-          ...context
-        };
+        const keyMap = Object.assign(/* @__PURE__ */ Object.create(null), context);
         return SafeEval.evalAst(this.ast, keyMap);
       }
     };
@@ -45732,7 +45727,7 @@ var require_object_inspect = __commonJS({
       if (isBigInt(obj)) {
         return markBoxed(inspect(bigIntValueOf.call(obj)));
       }
-      if (isBoolean2(obj)) {
+      if (isBoolean3(obj)) {
         return markBoxed(booleanValueOf.call(obj));
       }
       if (isString3(obj)) {
@@ -45786,7 +45781,7 @@ var require_object_inspect = __commonJS({
     function isNumber2(obj) {
       return toStr(obj) === "[object Number]" && (!toStringTag2 || !(typeof obj === "object" && toStringTag2 in obj));
     }
-    function isBoolean2(obj) {
+    function isBoolean3(obj) {
       return toStr(obj) === "[object Boolean]" && (!toStringTag2 || !(typeof obj === "object" && toStringTag2 in obj));
     }
     function isSymbol(obj) {
@@ -48117,6 +48112,8 @@ var require_dist10 = __commonJS({
 var src_exports = {};
 __export(src_exports, {
   BODY_TYPE_NAME: () => BODY_TYPE_NAME,
+  EnumGeneration: () => EnumGeneration,
+  FormDataArrayHandling: () => FormDataArrayHandling,
   GetterPropType: () => GetterPropType,
   LogLevels: () => LogLevels,
   NamingConvention: () => NamingConvention,
@@ -48171,6 +48168,7 @@ __export(src_exports, {
   getBody: () => getBody,
   getEnum: () => getEnum,
   getEnumImplementation: () => getEnumImplementation,
+  getEnumNames: () => getEnumNames,
   getExtension: () => getExtension,
   getFileInfo: () => getFileInfo,
   getFullRoute: () => getFullRoute,
@@ -48257,6 +48255,11 @@ var NamingConvention = {
   SNAKE_CASE: "snake_case",
   KEBAB_CASE: "kebab-case"
 };
+var EnumGeneration = {
+  CONST: "const",
+  ENUM: "enum",
+  UNION: "union"
+};
 var OutputClient = {
   ANGULAR: "angular",
   AXIOS: "axios",
@@ -48267,7 +48270,8 @@ var OutputClient = {
   SWR: "swr",
   ZOD: "zod",
   HONO: "hono",
-  FETCH: "fetch"
+  FETCH: "fetch",
+  MCP: "mcp"
 };
 var OutputHttpClient = {
   AXIOS: "axios",
@@ -48282,6 +48286,11 @@ var OutputMode = {
 var OutputMockType = {
   MSW: "msw"
 };
+var FormDataArrayHandling = {
+  SERIALIZE: "serialize",
+  EXPLODE: "explode",
+  SERIALIZE_WITH_BRACKETS: "serialize-with-brackets"
+};
 var Verbs = {
   POST: "post",
   PUT: "put",
@@ -49419,9 +49428,17 @@ var ibmOpenapiValidator = async (specs, validation) => {
 var getIsBodyVerb = (verb) => VERBS_WITH_BODY.includes(verb);
 
 // src/getters/enum.ts
-var getEnum = (value, enumName, names, useNativeEnums) => {
-  const enumValue = useNativeEnums ? getNativeEnum(value, enumName, names) : getTypeConstEnum(value, enumName, names);
-  return enumValue;
+var getEnumNames = (schemaObject) => {
+  return schemaObject?.["x-enumNames"] || schemaObject?.["x-enumnames"] || schemaObject?.["x-enum-varnames"];
+};
+var getEnum = (value, enumName, names, enumGenerationType) => {
+  if (enumGenerationType === EnumGeneration.CONST)
+    return getTypeConstEnum(value, enumName, names);
+  if (enumGenerationType === EnumGeneration.ENUM)
+    return getNativeEnum(value, enumName, names);
+  if (enumGenerationType === EnumGeneration.UNION)
+    return getUnion(value, enumName);
+  throw new Error(`Invalid enumGenerationType: ${enumGenerationType}`);
 };
 var getTypeConstEnum = (value, enumName, names) => {
   let enumValue = `export type ${enumName} = typeof ${enumName}[keyof typeof ${enumName}]`;
@@ -49506,6 +49523,9 @@ var toNumberKey = (value) => {
   }
   return `NUMBER_${value}`;
 };
+var getUnion = (value, enumName) => {
+  return `export type ${enumName} = ${value};`;
+};
 
 // src/getters/ref.ts
 var RefComponentSuffix = {
@@ -49746,11 +49766,11 @@ var resolveObjectOriginal = ({
     const enumValue = getEnum(
       resolvedValue.value,
       propName,
-      resolvedValue.originalSchema?.["x-enumNames"],
-      context.output.override.useNativeEnums
+      getEnumNames(resolvedValue.originalSchema),
+      context.output.override.enumGenerationType
     );
     return {
-      value: context.output.override.useNativeEnums ? `(keyof typeof ${propName})` : propName,
+      value: propName,
       imports: [{ name: propName }],
       schemas: [
         ...resolvedValue.schemas,
@@ -50136,7 +50156,9 @@ var resolveSchemaPropertiesToFormData = ({
   variableName,
   propName,
   context,
-  isRequestBodyOptional
+  isRequestBodyOptional,
+  keyPrefix = "",
+  depth = 0
 }) => {
   const formDataValues = Object.entries(schema.properties ?? {}).reduce(
     (acc, [key, value]) => {
@@ -50147,28 +50169,64 @@ var resolveSchemaPropertiesToFormData = ({
       const valueKey = `${propName}${formattedKeyPrefix}${formattedKey}`;
       const nonOptionalValueKey = `${propName}${formattedKey}`;
       if (property.type === "object") {
-        formDataValue = `${variableName}.append('${key}', JSON.stringify(${nonOptionalValueKey}));
+        if (context.output.override.formData.arrayHandling === FormDataArrayHandling.EXPLODE) {
+          formDataValue = resolveSchemaPropertiesToFormData({
+            schema: property,
+            variableName,
+            propName: nonOptionalValueKey,
+            context,
+            isRequestBodyOptional,
+            keyPrefix: `${keyPrefix}${key}.`,
+            depth: depth + 1
+          });
+        } else {
+          formDataValue = `${variableName}.append(\`${keyPrefix}${key}\`, JSON.stringify(${nonOptionalValueKey}));
 `;
+        }
       } else if (property.type === "array") {
         let valueStr = "value";
+        let hasNonPrimitiveChild = false;
         if (property.items) {
           const { schema: itemSchema } = resolveRef(
             property.items,
             context
           );
           if (itemSchema.type === "object" || itemSchema.type === "array") {
-            valueStr = "JSON.stringify(value)";
+            if (context.output.override.formData.arrayHandling === FormDataArrayHandling.EXPLODE) {
+              hasNonPrimitiveChild = true;
+              const resolvedValue = resolveSchemaPropertiesToFormData({
+                schema: itemSchema,
+                variableName,
+                propName: "value",
+                context,
+                isRequestBodyOptional,
+                keyPrefix: `${keyPrefix}${key}[\${index${depth > 0 ? depth : ""}}].`,
+                depth: depth + 1
+              });
+              formDataValue = `${valueKey}.forEach((value, index${depth > 0 ? depth : ""}) => {
+    ${resolvedValue}});
+`;
+            } else {
+              valueStr = "JSON.stringify(value)";
+            }
           } else if (itemSchema.type === "number" || itemSchema.type?.includes("number") || itemSchema.type === "integer" || itemSchema.type?.includes("integer") || itemSchema.type === "boolean" || itemSchema.type?.includes("boolean")) {
             valueStr = "value.toString()";
           }
         }
-        formDataValue = `${valueKey}.forEach(value => ${variableName}.append('${key}', ${valueStr}));
+        if (context.output.override.formData.arrayHandling === FormDataArrayHandling.EXPLODE) {
+          if (!hasNonPrimitiveChild) {
+            formDataValue = `${valueKey}.forEach((value, index${depth > 0 ? depth : ""}) => ${variableName}.append(\`${keyPrefix}${key}[\${index${depth > 0 ? depth : ""}}]\`, ${valueStr}));
+`;
+          }
+        } else {
+          formDataValue = `${valueKey}.forEach(value => ${variableName}.append(\`${keyPrefix}${key}${context.output.override.formData.arrayHandling === FormDataArrayHandling.SERIALIZE_WITH_BRACKETS ? "[]" : ""}\`, ${valueStr}));
 `;
+        }
       } else if (property.type === "number" || property.type?.includes("number") || property.type === "integer" || property.type?.includes("integer") || property.type === "boolean" || property.type?.includes("boolean")) {
-        formDataValue = `${variableName}.append('${key}', ${nonOptionalValueKey}.toString())
+        formDataValue = `${variableName}.append(\`${keyPrefix}${key}\`, ${nonOptionalValueKey}.toString())
 `;
       } else {
-        formDataValue = `${variableName}.append('${key}', ${nonOptionalValueKey})
+        formDataValue = `${variableName}.append(\`${keyPrefix}${key}\`, ${nonOptionalValueKey})
 `;
       }
       let existSubSchemaNullable = false;
@@ -50180,7 +50238,7 @@ var resolveSchemaPropertiesToFormData = ({
         if (subSchemas?.some((subSchema) => {
           return ["number", "integer", "boolean"].includes(subSchema.type);
         })) {
-          formDataValue = `${variableName}.append('${key}', ${nonOptionalValueKey}.toString())
+          formDataValue = `${variableName}.append(\`${key}\`, ${nonOptionalValueKey}.toString())
 `;
         }
         if (subSchemas?.some((subSchema) => {
@@ -50369,7 +50427,7 @@ var getObject = ({
         acc.hasReadonlyProps ||= isReadOnly || false;
         acc.imports.push(...resolvedValue.imports);
         acc.value += `
-  ${doc ? `${doc}  ` : ""}${isReadOnly && !context.output.override.suppressReadonlyModifier ? "readonly " : ""}${getKey(key)}${isRequired ? "" : "?"}: ${resolvedValue.isEnum && context.output.override.useNativeEnums ? `(keyof typeof ${resolvedValue.value})` : resolvedValue.value};`;
+  ${doc ? `${doc}  ` : ""}${isReadOnly && !context.output.override.suppressReadonlyModifier ? "readonly " : ""}${getKey(key)}${isRequired ? "" : "?"}: ${resolvedValue.value};`;
         acc.schemas.push(...resolvedValue.schemas);
         if (arr.length - 1 === index3) {
           if (item.additionalProperties) {
@@ -50622,7 +50680,16 @@ var combineValues = ({
     return `${resolvedData.values.join(` | `)}${resolvedValue ? ` | ${resolvedValue.value}` : ""}`;
   }
   if (separator2 === "allOf") {
-    const joined = `${resolvedData.values.join(` & `)}${resolvedValue ? ` & ${resolvedValue.value}` : ""}`;
+    let resolvedDataValue = resolvedData.values.join(` & `);
+    if (resolvedData.originalSchema.length > 0 && resolvedValue) {
+      const discriminatedPropertySchemas = resolvedData.originalSchema.filter(
+        (s2) => s2?.discriminator && resolvedValue.value.includes(` ${s2.discriminator.propertyName}:`)
+      );
+      if (discriminatedPropertySchemas.length > 0) {
+        resolvedDataValue = `Omit<${resolvedDataValue}, '${discriminatedPropertySchemas.map((s2) => s2.discriminator?.propertyName).join("' | '")}'>`;
+      }
+    }
+    const joined = `${resolvedDataValue}${resolvedValue ? ` & ${resolvedValue.value}` : ""}`;
     const overrideRequiredProperties = resolvedData.requiredProperties.filter(
       (prop) => !resolvedData.originalSchema.some(
         (schema) => schema && schema.properties?.[prop] && schema.required?.includes(prop)
@@ -50789,7 +50856,7 @@ var getCombineEnumValue = ({
     if (isRef[i3]) {
       return `...${e3},`;
     }
-    const names = originalSchema[i3]?.["x-enumNames"];
+    const names = getEnumNames(originalSchema[i3]);
     return getEnumImplementation(e3, names);
   }).join("");
   return `{${enums}} as const`;
@@ -51072,8 +51139,8 @@ var getQueryParamsTypes = (queryParams, operationName, context) => {
       const enumValue = getEnum(
         resolvedValue.value,
         enumName,
-        resolvedValue.originalSchema?.["x-enumNames"],
-        context.output.override.useNativeEnums
+        getEnumNames(resolvedValue.originalSchema),
+        context.output.override.enumGenerationType
       );
       return {
         definition: `${doc}${key}${!required || schema.default ? "?" : ""}: ${enumName};`,
@@ -51363,15 +51430,17 @@ var generateMutatorImports = ({
     acc += "\n";
     if (implementation && (mutator.hasErrorType || mutator.bodyTypeName)) {
       let errorImportName = "";
-      if (mutator.hasErrorType && implementation.includes(mutator.errorTypeName) && !acc.includes(mutator.errorTypeName)) {
-        errorImportName = mutator.default ? `ErrorType as ${mutator.errorTypeName}` : mutator.errorTypeName;
+      const targetErrorImportName = mutator.default ? `ErrorType as ${mutator.errorTypeName}` : mutator.errorTypeName;
+      if (mutator.hasErrorType && implementation.includes(mutator.errorTypeName) && !acc.includes(`{ ${targetErrorImportName} `)) {
+        errorImportName = targetErrorImportName;
       }
       let bodyImportName = "";
-      if (mutator.bodyTypeName && implementation.includes(mutator.bodyTypeName) && !acc.includes(mutator.bodyTypeName)) {
-        bodyImportName = mutator.default ? `BodyType as ${mutator.bodyTypeName}` : mutator.bodyTypeName;
+      const targetBodyImportName = mutator.default ? `BodyType as ${mutator.bodyTypeName}` : mutator.bodyTypeName;
+      if (mutator.bodyTypeName && implementation.includes(mutator.bodyTypeName) && !acc.includes(` ${targetBodyImportName} }`)) {
+        bodyImportName = targetBodyImportName;
       }
       if (bodyImportName || errorImportName) {
-        acc += `import type { ${errorImportName}${errorImportName && bodyImportName ? ", " : ""}${bodyImportName} } from '${path2}';`;
+        acc += `import type { ${errorImportName}${errorImportName && bodyImportName ? " , " : ""}${bodyImportName} } from '${path2}';`;
         acc += "\n";
       }
     }
@@ -52111,8 +52180,8 @@ var generateSchemasDefinition = (schemas = {}, context, suffix, filters) => {
         output += getEnum(
           resolvedValue.value,
           schemaName,
-          resolvedValue.originalSchema?.["x-enumNames"],
-          context.output.override.useNativeEnums
+          getEnumNames(resolvedValue.originalSchema),
+          context.output.override.enumGenerationType
         );
       } else if (schemaName === resolvedValue.value && resolvedValue.isRef) {
         const { schema: referredSchema } = resolveRef(schema, context);
@@ -52189,8 +52258,7 @@ var generateVerbOptions = async ({
     overrideOperation
   );
   const overrideOperationName = overrideOperation?.operationName || output.override?.operationName;
-  const overriddenOperationName = overrideOperationName ? overrideOperationName(operation, route, verb) : camel(operationId);
-  const operationName = sanitize(overriddenOperationName, { es5keyword: true });
+  const operationName = overrideOperationName ? overrideOperationName(operation, route, verb) : sanitize(camel(operationId), { es5keyword: true });
   const response = getResponse({
     responses,
     operationName,
@@ -52240,10 +52308,10 @@ var generateVerbOptions = async ({
     workspace: context.workspace,
     tsconfig: context.output.tsconfig
   });
-  const formData = (isString2(override?.formData) || isObject(override?.formData)) && body.formData ? await generateMutator({
+  const formData = !override.formData.disabled && body.formData ? await generateMutator({
     output: output.target,
     name: operationName,
-    mutator: override.formData,
+    mutator: override.formData.mutator,
     workspace: context.workspace,
     tsconfig: context.output.tsconfig
   }) : void 0;
@@ -53232,6 +53300,8 @@ var writeTagsMode = async ({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BODY_TYPE_NAME,
+  EnumGeneration,
+  FormDataArrayHandling,
   GetterPropType,
   LogLevels,
   NamingConvention,
@@ -53286,6 +53356,7 @@ var writeTagsMode = async ({
   getBody,
   getEnum,
   getEnumImplementation,
+  getEnumNames,
   getExtension,
   getFileInfo,
   getFullRoute,