@orval/core 7.8.0 → 7.10.0

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;
@@ -6594,6 +6594,7 @@ function createScanner(text, ignoreTrivia) {
       return token = 14;
     }
     switch (code) {
+      // tokens: []{}:,
       case 123:
         pos++;
         return token = 1;
@@ -6612,10 +6613,12 @@ function createScanner(text, ignoreTrivia) {
       case 44:
         pos++;
         return token = 5;
+      // strings
       case 34:
         pos++;
         value = scanString();
         return token = 10;
+      // comments
       case 47:
         var start = pos - 1;
         if (text.charCodeAt(pos + 1) === 47) {
@@ -6659,12 +6662,16 @@ function createScanner(text, ignoreTrivia) {
         value += String.fromCharCode(code);
         pos++;
         return token = 16;
+      // numbers
       case 45:
         value += String.fromCharCode(code);
         pos++;
         if (pos === len || !isDigit(text.charCodeAt(pos))) {
           return token = 16;
         }
+      // found a minus, followed by a number so
+      // we fall through to proceed with scanning
+      // numbers
       case 48:
       case 49:
       case 50:
@@ -6677,6 +6684,7 @@ function createScanner(text, ignoreTrivia) {
       case 57:
         value += scanNumber();
         return token = 11;
+      // literals and unknown symbols
       default:
         while (pos < len && isUnknownContentCharacter(code)) {
           pos++;
@@ -9475,14 +9483,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";
@@ -24963,6 +24971,7 @@ var require_immer_cjs_development = __commonJS({
               switch (type) {
                 case 2:
                   return base2.set(key, value);
+                /* istanbul ignore next */
                 case 3:
                   die(16);
                 default:
@@ -27628,6 +27637,7 @@ var require_URI = __commonJS({
         switch (getType(value)) {
           case "Undefined":
             return name in data;
+          // data[name] !== undefined;
           case "Boolean":
             var _booly = Boolean(isArray(data[name]) ? data[name].length : data[name]);
             return value === _booly;
@@ -27649,6 +27659,7 @@ var require_URI = __commonJS({
             return arrayContains(data[name], value);
           case "Number":
             value = String(value);
+          /* falls through */
           case "String":
             if (!isArray(data[name])) {
               return data[name] === value;
@@ -27942,6 +27953,7 @@ var require_URI = __commonJS({
             return relative;
           case "absolute":
             return !relative;
+          // hostname identification
           case "domain":
           case "name":
             return name;
@@ -31107,7 +31119,7 @@ var require_index_node_cjs = __commonJS({
        * @returns {string}
        */
       static get version() {
-        return "1.3.9";
+        return "1.4.0";
       }
       /**
        * @returns {string}
@@ -31890,6 +31902,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 +31922,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 +32042,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 +32104,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 +32183,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 +32192,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 +32229,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 +32236,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 +32255,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);
       }
     };
@@ -32551,6 +32558,7 @@ var require_index_node_cjs = __commonJS({
               addType = true;
             }
             break;
+          /* c8 ignore next 2 */
           default:
             throw new TypeError("Unknown value type " + valueType);
         }
@@ -41727,6 +41735,7 @@ var require_minimatch = __commonJS({
           continue;
         }
         switch (c2) {
+          /* istanbul ignore next */
           case "/": {
             return false;
           }
@@ -41734,6 +41743,8 @@ var require_minimatch = __commonJS({
             clearStateChar();
             escaping = true;
             continue;
+          // the various stateChar values
+          // for the "extglob" stuff.
           case "?":
           case "*":
           case "+":
@@ -41794,6 +41805,7 @@ var require_minimatch = __commonJS({
             clearStateChar();
             re2 += "|";
             continue;
+          // these are mostly the same in regexp and glob
           case "[":
             clearStateChar();
             if (inClass) {
@@ -44307,7 +44319,7 @@ var require_get_intrinsic = __commonJS({
             if (!allowMissing) {
               throw new $TypeError("base intrinsic for " + name + " exists, but the property is not available.");
             }
-            return void 0;
+            return void undefined2;
           }
           if ($gOPD && i3 + 1 >= parts.length) {
             var desc = $gOPD(value, part);
@@ -45732,7 +45744,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 +45798,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) {
@@ -48114,9 +48126,11 @@ var require_dist10 = __commonJS({
 });
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   BODY_TYPE_NAME: () => BODY_TYPE_NAME,
+  EnumGeneration: () => EnumGeneration,
+  FormDataArrayHandling: () => FormDataArrayHandling,
   GetterPropType: () => GetterPropType,
   LogLevels: () => LogLevels,
   NamingConvention: () => NamingConvention,
@@ -48170,6 +48184,7 @@ __export(src_exports, {
   getArray: () => getArray,
   getBody: () => getBody,
   getEnum: () => getEnum,
+  getEnumDescriptions: () => getEnumDescriptions,
   getEnumImplementation: () => getEnumImplementation,
   getEnumNames: () => getEnumNames,
   getExtension: () => getExtension,
@@ -48215,6 +48230,7 @@ __export(src_exports, {
   jsDoc: () => jsDoc,
   jsStringEscape: () => jsStringEscape,
   kebab: () => kebab,
+  keyValuePairsToJsDoc: () => keyValuePairsToJsDoc,
   loadFile: () => loadFile,
   log: () => log,
   logError: () => logError,
@@ -48245,7 +48261,7 @@ __export(src_exports, {
   writeSplitTagsMode: () => writeSplitTagsMode,
   writeTagsMode: () => writeTagsMode
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/types.ts
 var PropertySortOrder = {
@@ -48258,6 +48274,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",
@@ -48268,7 +48289,8 @@ var OutputClient = {
   SWR: "swr",
   ZOD: "zod",
   HONO: "hono",
-  FETCH: "fetch"
+  FETCH: "fetch",
+  MCP: "mcp"
 };
 var OutputHttpClient = {
   AXIOS: "axios",
@@ -48283,6 +48305,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",
@@ -49063,21 +49090,28 @@ var compareVersions = (firstVersion, secondVersions, operator = ">=") => {
 var search = "\\*/";
 var replacement = "*\\/";
 var regex = new RegExp(search, "g");
-function jsDoc({
-  description,
-  deprecated,
-  summary,
-  minLength,
-  maxLength,
-  minimum,
-  maximum,
-  exclusiveMinimum,
-  exclusiveMaximum,
-  minItems,
-  maxItems,
-  nullable,
-  pattern
-}, tryOneLine = false) {
+function jsDoc(schema, tryOneLine = false, context) {
+  if (context?.output?.override?.jsDoc) {
+    const { filter: filter2 } = context.output.override.jsDoc;
+    if (filter2) {
+      return keyValuePairsToJsDoc(filter2(schema));
+    }
+  }
+  const {
+    description,
+    deprecated,
+    summary,
+    minLength,
+    maxLength,
+    minimum,
+    maximum,
+    exclusiveMinimum,
+    exclusiveMaximum,
+    minItems,
+    maxItems,
+    nullable,
+    pattern
+  } = schema;
   const lines = (Array.isArray(description) ? description.filter((d2) => !d2.includes("eslint-disable")) : [description || ""]).map((line) => line.replace(regex, replacement));
   const count2 = [
     description,
@@ -49149,6 +49183,16 @@ ${tryOneLine ? "  " : ""} *`;
   doc += "*/\n";
   return doc;
 }
+function keyValuePairsToJsDoc(keyValues) {
+  if (!keyValues.length) return "";
+  let doc = "/**\n";
+  keyValues.forEach(({ key, value }) => {
+    doc += ` * @${key} ${value}
+`;
+  });
+  doc += " */\n";
+  return doc;
+}
 
 // src/utils/dynamic-import.ts
 var import_url = require("url");
@@ -49365,6 +49409,7 @@ var jsStringEscape = (input) => input.replace(/["'\\\n\r\u2028\u2029]/g, (charac
     case "'":
     case "\\":
       return "\\" + character;
+    // Four possible LineTerminator characters need to be escaped:
     case "\n":
       return "\\n";
     case "\r":
@@ -49423,33 +49468,42 @@ var getIsBodyVerb = (verb) => VERBS_WITH_BODY.includes(verb);
 var getEnumNames = (schemaObject) => {
   return schemaObject?.["x-enumNames"] || schemaObject?.["x-enumnames"] || schemaObject?.["x-enum-varnames"];
 };
-var getEnum = (value, enumName, names, useNativeEnums) => {
-  const enumValue = useNativeEnums ? getNativeEnum(value, enumName, names) : getTypeConstEnum(value, enumName, names);
-  return enumValue;
+var getEnumDescriptions = (schemaObject) => {
+  return schemaObject?.["x-enumDescriptions"] || schemaObject?.["x-enumdescriptions"] || schemaObject?.["x-enum-descriptions"];
+};
+var getEnum = (value, enumName, names, enumGenerationType, descriptions) => {
+  if (enumGenerationType === EnumGeneration.CONST)
+    return getTypeConstEnum(value, enumName, names, descriptions);
+  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) => {
+var getTypeConstEnum = (value, enumName, names, descriptions) => {
   let enumValue = `export type ${enumName} = typeof ${enumName}[keyof typeof ${enumName}]`;
   if (value.endsWith(" | null")) {
     value = value.replace(" | null", "");
     enumValue += " | null";
   }
   enumValue += ";\n";
-  const implementation = getEnumImplementation(value, names);
-  enumValue += `
-
-`;
+  const implementation = getEnumImplementation(value, names, descriptions);
+  enumValue += "\n\n";
   enumValue += "// eslint-disable-next-line @typescript-eslint/no-redeclare\n";
   enumValue += `export const ${enumName} = {
 ${implementation}} as const;
 `;
   return enumValue;
 };
-var getEnumImplementation = (value, names) => {
+var getEnumImplementation = (value, names, descriptions) => {
   if (value === "") return "";
   return [...new Set(value.split(" | "))].reduce((acc, val, index3) => {
     const name = names?.[index3];
+    const description = descriptions?.[index3];
+    const comment = description ? `  /** ${description} */
+` : "";
     if (name) {
-      return acc + `  ${import_esutils2.keyword.isIdentifierNameES5(name) ? name : `'${name}'`}: ${val},
+      return acc + comment + `  ${import_esutils2.keyword.isIdentifierNameES5(name) ? name : `'${name}'`}: ${val},
 `;
     }
     let key = val.startsWith("'") ? val.slice(1, -1) : val;
@@ -49465,7 +49519,7 @@ var getEnumImplementation = (value, names) => {
         special: true
       });
     }
-    return acc + `  ${import_esutils2.keyword.isIdentifierNameES5(key) ? key : `'${key}'`}: ${val},
+    return acc + comment + `  ${import_esutils2.keyword.isIdentifierNameES5(key) ? key : `'${key}'`}: ${val},
 `;
   }, "");
 };
@@ -49510,6 +49564,9 @@ var toNumberKey = (value) => {
   }
   return `NUMBER_${value}`;
 };
+var getUnion = (value, enumName) => {
+  return `export type ${enumName} = ${value};`;
+};
 
 // src/getters/ref.ts
 var RefComponentSuffix = {
@@ -49751,7 +49808,8 @@ var resolveObjectOriginal = ({
       resolvedValue.value,
       propName,
       getEnumNames(resolvedValue.originalSchema),
-      context.output.override.useNativeEnums
+      context.output.override.enumGenerationType,
+      getEnumDescriptions(resolvedValue.originalSchema)
     );
     return {
       value: propName,
@@ -50140,39 +50198,80 @@ var resolveSchemaPropertiesToFormData = ({
   variableName,
   propName,
   context,
-  isRequestBodyOptional
+  isRequestBodyOptional,
+  keyPrefix = "",
+  depth = 0
 }) => {
   const formDataValues = Object.entries(schema.properties ?? {}).reduce(
     (acc, [key, value]) => {
       const { schema: property } = resolveRef(value, context);
+      if (property.readOnly) {
+        return acc;
+      }
       let formDataValue = "";
       const formattedKeyPrefix = !isRequestBodyOptional ? "" : !import_esutils3.keyword.isIdentifierNameES5(key) ? "?." : "?";
       const formattedKey = !import_esutils3.keyword.isIdentifierNameES5(key) ? `['${key}']` : `.${key}`;
       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;
@@ -50184,7 +50283,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 +50468,7 @@ var getObject = ({
         if (!index3) {
           acc.value += "{";
         }
-        const doc = jsDoc(schema, true);
+        const doc = jsDoc(schema, true, context);
         acc.hasReadonlyProps ||= isReadOnly || false;
         acc.imports.push(...resolvedValue.imports);
         acc.value += `
@@ -50803,7 +50902,8 @@ var getCombineEnumValue = ({
       return `...${e3},`;
     }
     const names = getEnumNames(originalSchema[i3]);
-    return getEnumImplementation(e3, names);
+    const descriptions = getEnumDescriptions(originalSchema[i3]);
+    return getEnumImplementation(e3, names, descriptions);
   }).join("");
   return `{${enums}} as const`;
 };
@@ -50990,10 +51090,10 @@ var getProps = ({
   };
   const queryParamsProp = {
     name: "params",
-    definition: `params${queryParams?.isOptional ? "?" : ""}: ${queryParams?.schema.name}`,
-    implementation: `params${queryParams?.isOptional ? "?" : ""}: ${queryParams?.schema.name}`,
+    definition: `params${queryParams?.isOptional || context.output.allParamsOptional ? "?" : ""}: ${queryParams?.schema.name}`,
+    implementation: `params${queryParams?.isOptional || context.output.allParamsOptional ? "?" : ""}: ${queryParams?.schema.name}`,
     default: false,
-    required: !isUndefined(queryParams?.isOptional) ? !queryParams?.isOptional : false,
+    required: !isUndefined(queryParams?.isOptional) ? !queryParams?.isOptional && !context.output.allParamsOptional : !context.output.allParamsOptional,
     type: GetterPropType.QUERY_PARAM
   };
   const headersProp = {
@@ -51071,7 +51171,14 @@ var getQueryParamsTypes = (queryParams, operationName, context) => {
       name: queryName
     });
     const key = getKey(name);
-    const doc = jsDoc(parameter);
+    const doc = jsDoc(
+      {
+        description: parameter.description,
+        ...schema
+      },
+      void 0,
+      context
+    );
     if (parameterImports.length) {
       return {
         definition: `${doc}${key}${!required || schema.default ? "?" : ""}: ${parameterImports[0].name};`,
@@ -51086,7 +51193,8 @@ var getQueryParamsTypes = (queryParams, operationName, context) => {
         resolvedValue.value,
         enumName,
         getEnumNames(resolvedValue.originalSchema),
-        context.output.override.useNativeEnums
+        context.output.override.enumGenerationType,
+        getEnumDescriptions(resolvedValue.originalSchema)
       );
       return {
         definition: `${doc}${key}${!required || schema.default ? "?" : ""}: ${enumName};`,
@@ -52052,7 +52160,7 @@ var generateInterface = ({
   }
   if (scalar.type === "object" && !context?.output.override?.useTypeOverInterfaces) {
     if (scalar.type === "object" && schema.properties && Object.values(schema.properties).length > 0 && Object.values(schema.properties).every((item) => "const" in item)) {
-      const mappedScalarValue = scalar.value.replaceAll(";", ",");
+      const mappedScalarValue = scalar.value.replaceAll(";", ",").replaceAll("?:", ":");
       model += `export const ${name}Value = ${mappedScalarValue} as const;
 export type ${name} = typeof ${name}Value;
 `;
@@ -52127,7 +52235,8 @@ var generateSchemasDefinition = (schemas = {}, context, suffix, filters) => {
           resolvedValue.value,
           schemaName,
           getEnumNames(resolvedValue.originalSchema),
-          context.output.override.useNativeEnums
+          context.output.override.enumGenerationType,
+          getEnumDescriptions(resolvedValue.originalSchema)
         );
       } else if (schemaName === resolvedValue.value && resolvedValue.isRef) {
         const { schema: referredSchema } = resolveRef(schema, context);
@@ -52204,8 +52313,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,
@@ -52255,10 +52363,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;
@@ -53247,6 +53355,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,
@@ -53300,6 +53410,7 @@ var writeTagsMode = async ({
   getArray,
   getBody,
   getEnum,
+  getEnumDescriptions,
   getEnumImplementation,
   getEnumNames,
   getExtension,
@@ -53345,6 +53456,7 @@ var writeTagsMode = async ({
   jsDoc,
   jsStringEscape,
   kebab,
+  keyValuePairsToJsDoc,
   loadFile,
   log,
   logError,