@kubb/oas 4.12.2 → 4.12.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/oas",
-  "version": "4.12.2",
+  "version": "4.12.4",
   "description": "OpenAPI Specification (OAS) utilities and helpers for Kubb, providing parsing, normalization, and manipulation of OpenAPI/Swagger schemas.",
   "keywords": [
     "openapi",
@@ -56,7 +56,7 @@
     }
   ],
   "dependencies": {
-    "@redocly/openapi-core": "^2.12.7",
+    "@redocly/openapi-core": "^2.13.0",
     "hotscript": "^1.0.13",
     "json-schema-to-ts": "^3.1.1",
     "jsonpointer": "^5.0.1",

package/src/Oas.ts

@@ -380,6 +380,36 @@ export class Oas<const TOAS = unknown> extends BaseOas {
         const property = pathParameters.content?.[contentType]?.schema ?? (pathParameters.schema as SchemaObject)
         const required = [...(schema.required || ([] as any)), pathParameters.required ? pathParameters.name : undefined].filter(Boolean)
 
+        // Handle explode=true with style=form for object with additionalProperties
+        // According to OpenAPI spec, when explode is true, object properties are flattened
+        const getDefaultStyle = (location: string): string => {
+          if (location === 'query') return 'form'
+          if (location === 'path') return 'simple'
+          return 'simple'
+        }
+        const style = pathParameters.style || getDefaultStyle(inKey)
+        const explode = pathParameters.explode !== undefined ? pathParameters.explode : style === 'form'
+
+        if (
+          inKey === 'query' &&
+          style === 'form' &&
+          explode === true &&
+          property?.type === 'object' &&
+          property?.additionalProperties &&
+          !property?.properties
+        ) {
+          // When explode is true for an object with only additionalProperties,
+          // flatten it to the root level by merging additionalProperties with existing schema.
+          // This preserves other query parameters while allowing dynamic key-value pairs.
+          return {
+            ...schema,
+            description: pathParameters.description || schema.description,
+            deprecated: schema.deprecated,
+            example: property.example || schema.example,
+            additionalProperties: property.additionalProperties,
+          }
+        }
+
         return {
           ...schema,
           description: schema.description,