@kubb/plugin-oas 4.18.4 → 4.19.0

package/dist/utils.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-C1_xRkKa.cjs');
-const require_getSchemas = require('./getSchemas-D3YweIFO.cjs');
+const require_getSchemaFactory = require('./getSchemaFactory-CBp1me72.cjs');
 const require_getFooter = require('./getFooter-BvLkEWpc.cjs');
 let _kubb_core_transformers = require("@kubb/core/transformers");
 _kubb_core_transformers = require_chunk.__toESM(_kubb_core_transformers);
@@ -51,13 +51,36 @@ function getPathParams(operationSchema, options = {}) {
 	}, {});
 }
 
+//#endregion
+//#region src/utils/getSchemas.ts
+/**
+* Collect schemas from OpenAPI components (schemas, responses, requestBodies)
+* and return them in dependency order along with name mapping for collision resolution.
+*
+* This function is a wrapper around the oas.getSchemas() method for backward compatibility.
+* New code should use oas.getSchemas() directly.
+*
+* @deprecated Use oas.getSchemas() instead
+*/
+function getSchemas({ oas, contentType, includes = [
+	"schemas",
+	"requestBodies",
+	"responses"
+], collisionDetection }) {
+	return oas.getSchemas({
+		contentType,
+		includes,
+		collisionDetection
+	});
+}
+
 //#endregion
 exports.getBanner = require_getFooter.getBanner;
 exports.getComments = getComments;
 exports.getFooter = require_getFooter.getFooter;
 exports.getPathParams = getPathParams;
-exports.getSchemaFactory = require_getSchemas.getSchemaFactory;
-exports.getSchemas = require_getSchemas.getSchemas;
+exports.getSchemaFactory = require_getSchemaFactory.getSchemaFactory;
+exports.getSchemas = getSchemas;
 Object.defineProperty(exports, 'isOptional', {
   enumerable: true,
   get: function () {

package/dist/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":["URLPath","transformers"],"sources":["../src/utils/getComments.ts","../src/utils/getParams.ts"],"sourcesContent":["import transformers from '@kubb/core/transformers'\nimport { URLPath } from '@kubb/core/utils'\n\nimport type { Operation } from '@kubb/oas'\n\nexport function getComments(operation: Operation): string[] {\n  return [\n    operation.getDescription() && `@description ${operation.getDescription()}`,\n    operation.getSummary() && `@summary ${operation.getSummary()}`,\n    operation.path && `{@link ${new URLPath(operation.path).URL}}`,\n    operation.isDeprecated() && '@deprecated',\n  ]\n    .filter(Boolean)\n    .map((text) => transformers.trim(text))\n    .filter(Boolean)\n}\n","import { camelCase, isValidVarName } from '@kubb/core/transformers'\nimport type { FunctionParamsAST } from '@kubb/core/utils'\nimport type { OasTypes } from '@kubb/oas'\nimport type { Params } from '@kubb/react-fabric/types'\nimport type { OperationSchema } from '../types.ts'\n/**\n *\n * @deprecated\n * TODO move to operationManager hook\n */\nexport function getASTParams(\n  operationSchema: OperationSchema | undefined,\n  {\n    typed = false,\n    override,\n  }: {\n    typed?: boolean\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n): FunctionParamsAST[] {\n  if (!operationSchema || !operationSchema.schema.properties || !operationSchema.name) {\n    return []\n  }\n\n  const requiredFields = Array.isArray(operationSchema.schema.required) ? operationSchema.schema.required : []\n\n  return Object.entries(operationSchema.schema.properties).map(([name]: [string, OasTypes.SchemaObject]) => {\n    const data: FunctionParamsAST = {\n      name,\n      enabled: !!name,\n      required: requiredFields.includes(name),\n      type: typed ? `${operationSchema.name}[\"${name}\"]` : undefined,\n    }\n\n    return override ? override(data) : data\n  })\n}\n\nexport function getPathParams(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n) {\n  return getASTParams(operationSchema, options).reduce((acc, curr) => {\n    if (curr.name && curr.enabled) {\n      let name = isValidVarName(curr.name) ? curr.name : camelCase(curr.name)\n\n      if (options.casing === 'camelcase') {\n        name = camelCase(name)\n      }\n\n      acc[name] = {\n        default: curr.default,\n        type: curr.type,\n        optional: !curr.required,\n      }\n    }\n\n    return acc\n  }, {} as Params)\n}\n"],"mappings":";;;;;;;;;AAKA,SAAgB,YAAY,WAAgC;AAC1D,QAAO;EACL,UAAU,gBAAgB,IAAI,gBAAgB,UAAU,gBAAgB;EACxE,UAAU,YAAY,IAAI,YAAY,UAAU,YAAY;EAC5D,UAAU,QAAQ,UAAU,IAAIA,yBAAQ,UAAU,KAAK,CAAC,IAAI;EAC5D,UAAU,cAAc,IAAI;EAC7B,CACE,OAAO,QAAQ,CACf,KAAK,SAASC,gCAAa,KAAK,KAAK,CAAC,CACtC,OAAO,QAAQ;;;;;;;;;;ACJpB,SAAgB,aACd,iBACA,EACE,QAAQ,OACR,aAIE,EAAE,EACe;AACrB,KAAI,CAAC,mBAAmB,CAAC,gBAAgB,OAAO,cAAc,CAAC,gBAAgB,KAC7E,QAAO,EAAE;CAGX,MAAM,iBAAiB,MAAM,QAAQ,gBAAgB,OAAO,SAAS,GAAG,gBAAgB,OAAO,WAAW,EAAE;AAE5G,QAAO,OAAO,QAAQ,gBAAgB,OAAO,WAAW,CAAC,KAAK,CAAC,UAA2C;EACxG,MAAM,OAA0B;GAC9B;GACA,SAAS,CAAC,CAAC;GACX,UAAU,eAAe,SAAS,KAAK;GACvC,MAAM,QAAQ,GAAG,gBAAgB,KAAK,IAAI,KAAK,MAAM;GACtD;AAED,SAAO,WAAW,SAAS,KAAK,GAAG;GACnC;;AAGJ,SAAgB,cACd,iBACA,UAII,EAAE,EACN;AACA,QAAO,aAAa,iBAAiB,QAAQ,CAAC,QAAQ,KAAK,SAAS;AAClE,MAAI,KAAK,QAAQ,KAAK,SAAS;GAC7B,IAAI,mDAAsB,KAAK,KAAK,GAAG,KAAK,8CAAiB,KAAK,KAAK;AAEvE,OAAI,QAAQ,WAAW,YACrB,+CAAiB,KAAK;AAGxB,OAAI,QAAQ;IACV,SAAS,KAAK;IACd,MAAM,KAAK;IACX,UAAU,CAAC,KAAK;IACjB;;AAGH,SAAO;IACN,EAAE,CAAW"}
+{"version":3,"file":"utils.cjs","names":["URLPath","transformers"],"sources":["../src/utils/getComments.ts","../src/utils/getParams.ts","../src/utils/getSchemas.ts"],"sourcesContent":["import transformers from '@kubb/core/transformers'\nimport { URLPath } from '@kubb/core/utils'\n\nimport type { Operation } from '@kubb/oas'\n\nexport function getComments(operation: Operation): string[] {\n  return [\n    operation.getDescription() && `@description ${operation.getDescription()}`,\n    operation.getSummary() && `@summary ${operation.getSummary()}`,\n    operation.path && `{@link ${new URLPath(operation.path).URL}}`,\n    operation.isDeprecated() && '@deprecated',\n  ]\n    .filter(Boolean)\n    .map((text) => transformers.trim(text))\n    .filter(Boolean)\n}\n","import { camelCase, isValidVarName } from '@kubb/core/transformers'\nimport type { FunctionParamsAST } from '@kubb/core/utils'\nimport type { OasTypes } from '@kubb/oas'\nimport type { Params } from '@kubb/react-fabric/types'\nimport type { OperationSchema } from '../types.ts'\n/**\n *\n * @deprecated\n * TODO move to operationManager hook\n */\nexport function getASTParams(\n  operationSchema: OperationSchema | undefined,\n  {\n    typed = false,\n    override,\n  }: {\n    typed?: boolean\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n): FunctionParamsAST[] {\n  if (!operationSchema || !operationSchema.schema.properties || !operationSchema.name) {\n    return []\n  }\n\n  const requiredFields = Array.isArray(operationSchema.schema.required) ? operationSchema.schema.required : []\n\n  return Object.entries(operationSchema.schema.properties).map(([name]: [string, OasTypes.SchemaObject]) => {\n    const data: FunctionParamsAST = {\n      name,\n      enabled: !!name,\n      required: requiredFields.includes(name),\n      type: typed ? `${operationSchema.name}[\"${name}\"]` : undefined,\n    }\n\n    return override ? override(data) : data\n  })\n}\n\nexport function getPathParams(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n) {\n  return getASTParams(operationSchema, options).reduce((acc, curr) => {\n    if (curr.name && curr.enabled) {\n      let name = isValidVarName(curr.name) ? curr.name : camelCase(curr.name)\n\n      if (options.casing === 'camelcase') {\n        name = camelCase(name)\n      }\n\n      acc[name] = {\n        default: curr.default,\n        type: curr.type,\n        optional: !curr.required,\n      }\n    }\n\n    return acc\n  }, {} as Params)\n}\n","import type { contentType, Oas, OasTypes } from '@kubb/oas'\n\nexport type GetSchemasResult = {\n  schemas: Record<string, OasTypes.SchemaObject>\n  /**\n   * Mapping from original component name to resolved name after collision handling\n   * e.g., { 'Order': 'OrderSchema', 'variant': 'variant2' }\n   */\n  nameMapping: Map<string, string>\n}\n\ntype Mode = 'schemas' | 'responses' | 'requestBodies'\n\ntype GetSchemasProps = {\n  oas: Oas\n  contentType?: contentType\n  includes?: Mode[]\n  /**\n   * Whether to resolve name collisions with suffixes.\n   * If not provided, uses oas.options.collisionDetection\n   * @default false (from oas.options or fallback)\n   */\n  collisionDetection?: boolean\n}\n\n/**\n * Collect schemas from OpenAPI components (schemas, responses, requestBodies)\n * and return them in dependency order along with name mapping for collision resolution.\n *\n * This function is a wrapper around the oas.getSchemas() method for backward compatibility.\n * New code should use oas.getSchemas() directly.\n *\n * @deprecated Use oas.getSchemas() instead\n */\nexport function getSchemas({ oas, contentType, includes = ['schemas', 'requestBodies', 'responses'], collisionDetection }: GetSchemasProps): GetSchemasResult {\n  return oas.getSchemas({\n    contentType,\n    includes,\n    collisionDetection,\n  })\n}\n"],"mappings":";;;;;;;;;AAKA,SAAgB,YAAY,WAAgC;AAC1D,QAAO;EACL,UAAU,gBAAgB,IAAI,gBAAgB,UAAU,gBAAgB;EACxE,UAAU,YAAY,IAAI,YAAY,UAAU,YAAY;EAC5D,UAAU,QAAQ,UAAU,IAAIA,yBAAQ,UAAU,KAAK,CAAC,IAAI;EAC5D,UAAU,cAAc,IAAI;EAC7B,CACE,OAAO,QAAQ,CACf,KAAK,SAASC,gCAAa,KAAK,KAAK,CAAC,CACtC,OAAO,QAAQ;;;;;;;;;;ACJpB,SAAgB,aACd,iBACA,EACE,QAAQ,OACR,aAIE,EAAE,EACe;AACrB,KAAI,CAAC,mBAAmB,CAAC,gBAAgB,OAAO,cAAc,CAAC,gBAAgB,KAC7E,QAAO,EAAE;CAGX,MAAM,iBAAiB,MAAM,QAAQ,gBAAgB,OAAO,SAAS,GAAG,gBAAgB,OAAO,WAAW,EAAE;AAE5G,QAAO,OAAO,QAAQ,gBAAgB,OAAO,WAAW,CAAC,KAAK,CAAC,UAA2C;EACxG,MAAM,OAA0B;GAC9B;GACA,SAAS,CAAC,CAAC;GACX,UAAU,eAAe,SAAS,KAAK;GACvC,MAAM,QAAQ,GAAG,gBAAgB,KAAK,IAAI,KAAK,MAAM;GACtD;AAED,SAAO,WAAW,SAAS,KAAK,GAAG;GACnC;;AAGJ,SAAgB,cACd,iBACA,UAII,EAAE,EACN;AACA,QAAO,aAAa,iBAAiB,QAAQ,CAAC,QAAQ,KAAK,SAAS;AAClE,MAAI,KAAK,QAAQ,KAAK,SAAS;GAC7B,IAAI,mDAAsB,KAAK,KAAK,GAAG,KAAK,8CAAiB,KAAK,KAAK;AAEvE,OAAI,QAAQ,WAAW,YACrB,+CAAiB,KAAK;AAGxB,OAAI,QAAQ;IACV,SAAS,KAAK;IACd,MAAM,KAAK;IACX,UAAU,CAAC,KAAK;IACjB;;AAGH,SAAO;IACN,EAAE,CAAW;;;;;;;;;;;;;;AC5BlB,SAAgB,WAAW,EAAE,KAAK,aAAa,WAAW;CAAC;CAAW;CAAiB;CAAY,EAAE,sBAAyD;AAC5J,QAAO,IAAI,WAAW;EACpB;EACA;EACA;EACD,CAAC"}

package/dist/utils.d.cts

@@ -1,5 +1,5 @@
-import { A as __name, S as Output, _ as contentType, b as Config, f as OasTypes, g as SchemaObject, h as Operation, l as isOptional, m as OpenAPIV3_1, p as OpenAPIV3, u as Oas } from "./SchemaMapper-CIs2VKvf.cjs";
-import { h as OperationSchema, w as FunctionParamsAST } from "./createGenerator-Cj-sXgmn.cjs";
+import { A as __name, S as Output, _ as contentType, b as Config, f as OasTypes, g as SchemaObject, h as Operation, l as isOptional, m as OpenAPIV3_1, p as OpenAPIV3, u as Oas } from "./SchemaMapper-DmB5NyNo.cjs";
+import { h as OperationSchema, w as FunctionParamsAST } from "./createGenerator-BF26dp_h.cjs";
 import { Params } from "@kubb/react-fabric/types";
 
 //#region src/utils/getBanner.d.ts
@@ -61,21 +61,41 @@ type SchemaResult<TWithRef extends boolean = false> = {
 declare function getSchemaFactory<TWithRef extends boolean = false>(oas: Oas): (schema: SchemaObject | null) => SchemaResult<TWithRef>;
 //#endregion
 //#region src/utils/getSchemas.d.ts
+type GetSchemasResult = {
+  schemas: Record<string, OasTypes.SchemaObject>;
+  /**
+   * Mapping from original component name to resolved name after collision handling
+   * e.g., { 'Order': 'OrderSchema', 'variant': 'variant2' }
+   */
+  nameMapping: Map<string, string>;
+};
 type Mode = 'schemas' | 'responses' | 'requestBodies';
 type GetSchemasProps = {
   oas: Oas;
   contentType?: contentType;
   includes?: Mode[];
+  /**
+   * Whether to resolve name collisions with suffixes.
+   * If not provided, uses oas.options.collisionDetection
+   * @default false (from oas.options or fallback)
+   */
+  collisionDetection?: boolean;
 };
 /**
  * Collect schemas from OpenAPI components (schemas, responses, requestBodies)
- * and return them in dependency order.
+ * and return them in dependency order along with name mapping for collision resolution.
+ *
+ * This function is a wrapper around the oas.getSchemas() method for backward compatibility.
+ * New code should use oas.getSchemas() directly.
+ *
+ * @deprecated Use oas.getSchemas() instead
  */
 declare function getSchemas({
   oas,
   contentType,
-  includes
-}: GetSchemasProps): Record<string, OasTypes.SchemaObject>;
+  includes,
+  collisionDetection
+}: GetSchemasProps): GetSchemasResult;
 //#endregion
 export { getBanner, getComments, getFooter, getPathParams, getSchemaFactory, getSchemas, isOptional };
 //# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.ts

@@ -1,6 +1,6 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import { S as Output, _ as contentType, b as Config, f as OasTypes, g as SchemaObject, h as Operation, l as isOptional, m as OpenAPIV3_1, p as OpenAPIV3, u as Oas } from "./SchemaMapper-BBUBpcx-.js";
-import { h as OperationSchema, w as FunctionParamsAST } from "./createGenerator-CZi_gpit.js";
+import { S as Output, _ as contentType, b as Config, f as OasTypes, g as SchemaObject, h as Operation, l as isOptional, m as OpenAPIV3_1, p as OpenAPIV3, u as Oas } from "./SchemaMapper-DI2vHHE0.js";
+import { h as OperationSchema, w as FunctionParamsAST } from "./createGenerator-DhGg_jH6.js";
 import { Params } from "@kubb/react-fabric/types";
 
 //#region src/utils/getBanner.d.ts
@@ -62,21 +62,41 @@ type SchemaResult<TWithRef extends boolean = false> = {
 declare function getSchemaFactory<TWithRef extends boolean = false>(oas: Oas): (schema: SchemaObject | null) => SchemaResult<TWithRef>;
 //#endregion
 //#region src/utils/getSchemas.d.ts
+type GetSchemasResult = {
+  schemas: Record<string, OasTypes.SchemaObject>;
+  /**
+   * Mapping from original component name to resolved name after collision handling
+   * e.g., { 'Order': 'OrderSchema', 'variant': 'variant2' }
+   */
+  nameMapping: Map<string, string>;
+};
 type Mode = 'schemas' | 'responses' | 'requestBodies';
 type GetSchemasProps = {
   oas: Oas;
   contentType?: contentType;
   includes?: Mode[];
+  /**
+   * Whether to resolve name collisions with suffixes.
+   * If not provided, uses oas.options.collisionDetection
+   * @default false (from oas.options or fallback)
+   */
+  collisionDetection?: boolean;
 };
 /**
  * Collect schemas from OpenAPI components (schemas, responses, requestBodies)
- * and return them in dependency order.
+ * and return them in dependency order along with name mapping for collision resolution.
+ *
+ * This function is a wrapper around the oas.getSchemas() method for backward compatibility.
+ * New code should use oas.getSchemas() directly.
+ *
+ * @deprecated Use oas.getSchemas() instead
  */
 declare function getSchemas({
   oas,
   contentType,
-  includes
-}: GetSchemasProps): Record<string, OasTypes.SchemaObject>;
+  includes,
+  collisionDetection
+}: GetSchemasProps): GetSchemasResult;
 //#endregion
 export { getBanner, getComments, getFooter, getPathParams, getSchemaFactory, getSchemas, isOptional };
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import { n as getSchemaFactory, t as getSchemas } from "./getSchemas-BUXPwm-5.js";
+import { t as getSchemaFactory } from "./getSchemaFactory-DsoVRgxV.js";
 import { n as getBanner, t as getFooter } from "./getFooter-PYWvz29J.js";
 import transformers, { camelCase, isValidVarName } from "@kubb/core/transformers";
 import { URLPath } from "@kubb/core/utils";
@@ -50,6 +50,29 @@ function getPathParams(operationSchema, options = {}) {
 	}, {});
 }
 
+//#endregion
+//#region src/utils/getSchemas.ts
+/**
+* Collect schemas from OpenAPI components (schemas, responses, requestBodies)
+* and return them in dependency order along with name mapping for collision resolution.
+*
+* This function is a wrapper around the oas.getSchemas() method for backward compatibility.
+* New code should use oas.getSchemas() directly.
+*
+* @deprecated Use oas.getSchemas() instead
+*/
+function getSchemas({ oas, contentType, includes = [
+	"schemas",
+	"requestBodies",
+	"responses"
+], collisionDetection }) {
+	return oas.getSchemas({
+		contentType,
+		includes,
+		collisionDetection
+	});
+}
+
 //#endregion
 export { getBanner, getComments, getFooter, getPathParams, getSchemaFactory, getSchemas, isOptional };
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../src/utils/getComments.ts","../src/utils/getParams.ts"],"sourcesContent":["import transformers from '@kubb/core/transformers'\nimport { URLPath } from '@kubb/core/utils'\n\nimport type { Operation } from '@kubb/oas'\n\nexport function getComments(operation: Operation): string[] {\n  return [\n    operation.getDescription() && `@description ${operation.getDescription()}`,\n    operation.getSummary() && `@summary ${operation.getSummary()}`,\n    operation.path && `{@link ${new URLPath(operation.path).URL}}`,\n    operation.isDeprecated() && '@deprecated',\n  ]\n    .filter(Boolean)\n    .map((text) => transformers.trim(text))\n    .filter(Boolean)\n}\n","import { camelCase, isValidVarName } from '@kubb/core/transformers'\nimport type { FunctionParamsAST } from '@kubb/core/utils'\nimport type { OasTypes } from '@kubb/oas'\nimport type { Params } from '@kubb/react-fabric/types'\nimport type { OperationSchema } from '../types.ts'\n/**\n *\n * @deprecated\n * TODO move to operationManager hook\n */\nexport function getASTParams(\n  operationSchema: OperationSchema | undefined,\n  {\n    typed = false,\n    override,\n  }: {\n    typed?: boolean\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n): FunctionParamsAST[] {\n  if (!operationSchema || !operationSchema.schema.properties || !operationSchema.name) {\n    return []\n  }\n\n  const requiredFields = Array.isArray(operationSchema.schema.required) ? operationSchema.schema.required : []\n\n  return Object.entries(operationSchema.schema.properties).map(([name]: [string, OasTypes.SchemaObject]) => {\n    const data: FunctionParamsAST = {\n      name,\n      enabled: !!name,\n      required: requiredFields.includes(name),\n      type: typed ? `${operationSchema.name}[\"${name}\"]` : undefined,\n    }\n\n    return override ? override(data) : data\n  })\n}\n\nexport function getPathParams(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n) {\n  return getASTParams(operationSchema, options).reduce((acc, curr) => {\n    if (curr.name && curr.enabled) {\n      let name = isValidVarName(curr.name) ? curr.name : camelCase(curr.name)\n\n      if (options.casing === 'camelcase') {\n        name = camelCase(name)\n      }\n\n      acc[name] = {\n        default: curr.default,\n        type: curr.type,\n        optional: !curr.required,\n      }\n    }\n\n    return acc\n  }, {} as Params)\n}\n"],"mappings":";;;;;;;;AAKA,SAAgB,YAAY,WAAgC;AAC1D,QAAO;EACL,UAAU,gBAAgB,IAAI,gBAAgB,UAAU,gBAAgB;EACxE,UAAU,YAAY,IAAI,YAAY,UAAU,YAAY;EAC5D,UAAU,QAAQ,UAAU,IAAI,QAAQ,UAAU,KAAK,CAAC,IAAI;EAC5D,UAAU,cAAc,IAAI;EAC7B,CACE,OAAO,QAAQ,CACf,KAAK,SAAS,aAAa,KAAK,KAAK,CAAC,CACtC,OAAO,QAAQ;;;;;;;;;;ACJpB,SAAgB,aACd,iBACA,EACE,QAAQ,OACR,aAIE,EAAE,EACe;AACrB,KAAI,CAAC,mBAAmB,CAAC,gBAAgB,OAAO,cAAc,CAAC,gBAAgB,KAC7E,QAAO,EAAE;CAGX,MAAM,iBAAiB,MAAM,QAAQ,gBAAgB,OAAO,SAAS,GAAG,gBAAgB,OAAO,WAAW,EAAE;AAE5G,QAAO,OAAO,QAAQ,gBAAgB,OAAO,WAAW,CAAC,KAAK,CAAC,UAA2C;EACxG,MAAM,OAA0B;GAC9B;GACA,SAAS,CAAC,CAAC;GACX,UAAU,eAAe,SAAS,KAAK;GACvC,MAAM,QAAQ,GAAG,gBAAgB,KAAK,IAAI,KAAK,MAAM;GACtD;AAED,SAAO,WAAW,SAAS,KAAK,GAAG;GACnC;;AAGJ,SAAgB,cACd,iBACA,UAII,EAAE,EACN;AACA,QAAO,aAAa,iBAAiB,QAAQ,CAAC,QAAQ,KAAK,SAAS;AAClE,MAAI,KAAK,QAAQ,KAAK,SAAS;GAC7B,IAAI,OAAO,eAAe,KAAK,KAAK,GAAG,KAAK,OAAO,UAAU,KAAK,KAAK;AAEvE,OAAI,QAAQ,WAAW,YACrB,QAAO,UAAU,KAAK;AAGxB,OAAI,QAAQ;IACV,SAAS,KAAK;IACd,MAAM,KAAK;IACX,UAAU,CAAC,KAAK;IACjB;;AAGH,SAAO;IACN,EAAE,CAAW"}
+{"version":3,"file":"utils.js","names":[],"sources":["../src/utils/getComments.ts","../src/utils/getParams.ts","../src/utils/getSchemas.ts"],"sourcesContent":["import transformers from '@kubb/core/transformers'\nimport { URLPath } from '@kubb/core/utils'\n\nimport type { Operation } from '@kubb/oas'\n\nexport function getComments(operation: Operation): string[] {\n  return [\n    operation.getDescription() && `@description ${operation.getDescription()}`,\n    operation.getSummary() && `@summary ${operation.getSummary()}`,\n    operation.path && `{@link ${new URLPath(operation.path).URL}}`,\n    operation.isDeprecated() && '@deprecated',\n  ]\n    .filter(Boolean)\n    .map((text) => transformers.trim(text))\n    .filter(Boolean)\n}\n","import { camelCase, isValidVarName } from '@kubb/core/transformers'\nimport type { FunctionParamsAST } from '@kubb/core/utils'\nimport type { OasTypes } from '@kubb/oas'\nimport type { Params } from '@kubb/react-fabric/types'\nimport type { OperationSchema } from '../types.ts'\n/**\n *\n * @deprecated\n * TODO move to operationManager hook\n */\nexport function getASTParams(\n  operationSchema: OperationSchema | undefined,\n  {\n    typed = false,\n    override,\n  }: {\n    typed?: boolean\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n): FunctionParamsAST[] {\n  if (!operationSchema || !operationSchema.schema.properties || !operationSchema.name) {\n    return []\n  }\n\n  const requiredFields = Array.isArray(operationSchema.schema.required) ? operationSchema.schema.required : []\n\n  return Object.entries(operationSchema.schema.properties).map(([name]: [string, OasTypes.SchemaObject]) => {\n    const data: FunctionParamsAST = {\n      name,\n      enabled: !!name,\n      required: requiredFields.includes(name),\n      type: typed ? `${operationSchema.name}[\"${name}\"]` : undefined,\n    }\n\n    return override ? override(data) : data\n  })\n}\n\nexport function getPathParams(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n) {\n  return getASTParams(operationSchema, options).reduce((acc, curr) => {\n    if (curr.name && curr.enabled) {\n      let name = isValidVarName(curr.name) ? curr.name : camelCase(curr.name)\n\n      if (options.casing === 'camelcase') {\n        name = camelCase(name)\n      }\n\n      acc[name] = {\n        default: curr.default,\n        type: curr.type,\n        optional: !curr.required,\n      }\n    }\n\n    return acc\n  }, {} as Params)\n}\n","import type { contentType, Oas, OasTypes } from '@kubb/oas'\n\nexport type GetSchemasResult = {\n  schemas: Record<string, OasTypes.SchemaObject>\n  /**\n   * Mapping from original component name to resolved name after collision handling\n   * e.g., { 'Order': 'OrderSchema', 'variant': 'variant2' }\n   */\n  nameMapping: Map<string, string>\n}\n\ntype Mode = 'schemas' | 'responses' | 'requestBodies'\n\ntype GetSchemasProps = {\n  oas: Oas\n  contentType?: contentType\n  includes?: Mode[]\n  /**\n   * Whether to resolve name collisions with suffixes.\n   * If not provided, uses oas.options.collisionDetection\n   * @default false (from oas.options or fallback)\n   */\n  collisionDetection?: boolean\n}\n\n/**\n * Collect schemas from OpenAPI components (schemas, responses, requestBodies)\n * and return them in dependency order along with name mapping for collision resolution.\n *\n * This function is a wrapper around the oas.getSchemas() method for backward compatibility.\n * New code should use oas.getSchemas() directly.\n *\n * @deprecated Use oas.getSchemas() instead\n */\nexport function getSchemas({ oas, contentType, includes = ['schemas', 'requestBodies', 'responses'], collisionDetection }: GetSchemasProps): GetSchemasResult {\n  return oas.getSchemas({\n    contentType,\n    includes,\n    collisionDetection,\n  })\n}\n"],"mappings":";;;;;;;;AAKA,SAAgB,YAAY,WAAgC;AAC1D,QAAO;EACL,UAAU,gBAAgB,IAAI,gBAAgB,UAAU,gBAAgB;EACxE,UAAU,YAAY,IAAI,YAAY,UAAU,YAAY;EAC5D,UAAU,QAAQ,UAAU,IAAI,QAAQ,UAAU,KAAK,CAAC,IAAI;EAC5D,UAAU,cAAc,IAAI;EAC7B,CACE,OAAO,QAAQ,CACf,KAAK,SAAS,aAAa,KAAK,KAAK,CAAC,CACtC,OAAO,QAAQ;;;;;;;;;;ACJpB,SAAgB,aACd,iBACA,EACE,QAAQ,OACR,aAIE,EAAE,EACe;AACrB,KAAI,CAAC,mBAAmB,CAAC,gBAAgB,OAAO,cAAc,CAAC,gBAAgB,KAC7E,QAAO,EAAE;CAGX,MAAM,iBAAiB,MAAM,QAAQ,gBAAgB,OAAO,SAAS,GAAG,gBAAgB,OAAO,WAAW,EAAE;AAE5G,QAAO,OAAO,QAAQ,gBAAgB,OAAO,WAAW,CAAC,KAAK,CAAC,UAA2C;EACxG,MAAM,OAA0B;GAC9B;GACA,SAAS,CAAC,CAAC;GACX,UAAU,eAAe,SAAS,KAAK;GACvC,MAAM,QAAQ,GAAG,gBAAgB,KAAK,IAAI,KAAK,MAAM;GACtD;AAED,SAAO,WAAW,SAAS,KAAK,GAAG;GACnC;;AAGJ,SAAgB,cACd,iBACA,UAII,EAAE,EACN;AACA,QAAO,aAAa,iBAAiB,QAAQ,CAAC,QAAQ,KAAK,SAAS;AAClE,MAAI,KAAK,QAAQ,KAAK,SAAS;GAC7B,IAAI,OAAO,eAAe,KAAK,KAAK,GAAG,KAAK,OAAO,UAAU,KAAK,KAAK;AAEvE,OAAI,QAAQ,WAAW,YACrB,QAAO,UAAU,KAAK;AAGxB,OAAI,QAAQ;IACV,SAAS,KAAK;IACd,MAAM,KAAK;IACX,UAAU,CAAC,KAAK;IACjB;;AAGH,SAAO;IACN,EAAE,CAAW;;;;;;;;;;;;;;AC5BlB,SAAgB,WAAW,EAAE,KAAK,aAAa,WAAW;CAAC;CAAW;CAAiB;CAAY,EAAE,sBAAyD;AAC5J,QAAO,IAAI,WAAW;EACpB;EACA;EACA;EACD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-oas",
-  "version": "4.18.4",
+  "version": "4.19.0",
   "description": "OpenAPI Specification (OAS) plugin for Kubb, providing core functionality for parsing and processing OpenAPI/Swagger schemas for code generation.",
   "keywords": [
     "openapi",
@@ -82,8 +82,8 @@
     "@kubb/react-fabric": "0.12.4",
     "p-limit": "^7.2.0",
     "remeda": "^2.33.4",
-    "@kubb/core": "4.18.4",
-    "@kubb/oas": "4.18.4"
+    "@kubb/core": "4.19.0",
+    "@kubb/oas": "4.19.0"
   },
   "peerDependencies": {
     "@kubb/react-fabric": "0.12.4"

package/src/SchemaGenerator.ts

@@ -3,7 +3,7 @@ import { BaseGenerator, type FileMetaBase } from '@kubb/core'
 import transformers, { pascalCase } from '@kubb/core/transformers'
 import { type AsyncEventEmitter, getUniqueName } from '@kubb/core/utils'
 import type { KubbFile } from '@kubb/fabric-core/types'
-import type { contentType, Oas, OpenAPIV3, SchemaObject } from '@kubb/oas'
+import type { contentType, Oas, OasTypes, OpenAPIV3, SchemaObject } from '@kubb/oas'
 import { isDiscriminator, isNullable, isReference } from '@kubb/oas'
 import type { Fabric } from '@kubb/react-fabric'
 import pLimit from 'p-limit'
@@ -12,7 +12,6 @@ import type { Generator } from './generators/types.ts'
 import { isKeyword, type Schema, type SchemaKeywordMapper, schemaKeywords } from './SchemaMapper.ts'
 import type { OperationSchema, Override, Refs } from './types.ts'
 import { getSchemaFactory } from './utils/getSchemaFactory.ts'
-import { getSchemas } from './utils/getSchemas.ts'
 import { buildSchema } from './utils.tsx'
 
 export type GetSchemaGeneratorOptions<T extends SchemaGenerator<any, any, any>> = T extends SchemaGenerator<infer Options, any, any> ? Options : never
@@ -50,7 +49,7 @@ export type SchemaGeneratorOptions = {
      */
     name?: (name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string
     /**
-     * Receive schema and name(propertName) and return FakerMeta array
+     * Receive schema and name(propertyName) and return FakerMeta array
      * TODO TODO add docs
      * @beta
      */
@@ -74,13 +73,31 @@ export class SchemaGenerator<
   // Collect the types of all referenced schemas, so we can export them later
   refs: Refs = {}
 
-  // Keep track of already used type aliases
-  #usedAliasNames: Record<string, number> = {}
+  // Map from original component paths to resolved schema names (after collision resolution)
+  // e.g., { '#/components/schemas/Order': 'OrderSchema', '#/components/responses/Product': 'ProductResponse' }
+  #schemaNameMapping: Map<string, string> = new Map()
+
+  // Flag to track if nameMapping has been initialized
+  #nameMappingInitialized = false
 
   // Cache for parsed schemas to avoid redundant parsing
   // Using WeakMap for automatic garbage collection when schemas are no longer referenced
   #parseCache: Map<string, Schema[]> = new Map()
 
+  /**
+   * Ensure the name mapping is initialized (lazy initialization)
+   */
+  #ensureNameMapping() {
+    if (this.#nameMappingInitialized) {
+      return
+    }
+
+    const { oas, contentType, include } = this.context
+    const { nameMapping } = oas.getSchemas({ contentType, includes: include })
+    this.#schemaNameMapping = nameMapping
+    this.#nameMappingInitialized = true
+  }
+
   /**
    * Creates a type node from a given schema.
    * Delegates to getBaseTypeFromSchema internally and
@@ -333,7 +350,7 @@ export class SchemaGenerator<
         const propertySchema = properties[propertyName] as SchemaObject
 
         const isRequired = Array.isArray(required) ? required?.includes(propertyName) : !!required
-        const nullable = propertySchema.nullable ?? propertySchema['x-nullable'] ?? false
+        const nullable = isNullable(propertySchema)
 
         validationFunctions.push(...this.parse({ schema: propertySchema, name: propertyName, parentName: name }))
 
@@ -453,15 +470,21 @@ export class SchemaGenerator<
       ]
     }
 
-    const originalName = getUniqueName($ref.replace(/.+\//, ''), this.#usedAliasNames)
+    // Ensure name mapping is initialized before resolving names
+    this.#ensureNameMapping()
+
+    const originalName = $ref.replace(/.+\//, '')
+    // Use the full $ref path to look up the collision-resolved name
+    const resolvedName = this.#schemaNameMapping.get($ref) || originalName
+
     const propertyName = this.context.pluginManager.resolveName({
-      name: originalName,
+      name: resolvedName,
       pluginKey: this.context.plugin.key,
       type: 'function',
     })
 
     const fileName = this.context.pluginManager.resolveName({
-      name: originalName,
+      name: resolvedName,
       pluginKey: this.context.plugin.key,
       type: 'file',
     })
@@ -473,7 +496,7 @@ export class SchemaGenerator<
 
     this.refs[$ref] = {
       propertyName,
-      originalName,
+      originalName: resolvedName,
       path: file.path,
     }
 
@@ -498,7 +521,7 @@ export class SchemaGenerator<
     }
 
     // If the discriminator property is an extension property (starts with x-),
-    // it's metadata and not an actual schema property, so we can't add constraints for it.
+    // its metadata and not an actual schema property, so we can't add constraints for it.
     // In this case, return the union as-is without adding discriminator constraints.
     if (discriminator.propertyName.startsWith('x-')) {
       return schema
@@ -698,11 +721,6 @@ export class SchemaGenerator<
     if (schemaObject.type && Array.isArray(schemaObject.type)) {
       // OPENAPI v3.1.0: https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0
       const items = schemaObject.type.filter((value) => value !== 'null') as Array<OpenAPIV3.NonArraySchemaObjectType>
-      const hasNull = (schemaObject.type as string[]).includes('null')
-
-      if (hasNull && !nullable) {
-        baseItems.push({ keyword: schemaKeywords.nullable })
-      }
 
       if (items.length > 1) {
         const parsedItems = [
@@ -768,7 +786,7 @@ export class SchemaGenerator<
         keyword: schemaKeywords.union,
         args: (schemaObject.oneOf || schemaObject.anyOf)!
           .map((item) => {
-            // first item, this will be ref
+            // first item, this is ref
             return item && this.parse({ schema: item as SchemaObject, name, parentName })[0]
           })
           .filter(Boolean),
@@ -1036,7 +1054,7 @@ export class SchemaGenerator<
     }
 
     if (version === '3.1' && 'const' in schemaObject) {
-      // const keyword takes precendence over the actual type.
+      // const keyword takes precedence over the actual type.
 
       if (schemaObject['const'] === null) {
         return [{ keyword: schemaKeywords.null }]
@@ -1193,7 +1211,7 @@ export class SchemaGenerator<
     if (schemaObject.properties || schemaObject.additionalProperties || 'patternProperties' in schemaObject) {
       if (isDiscriminator(schemaObject)) {
         // override schema to set type to be based on discriminator mapping, use of enum to convert type string to type 'mapping1' | 'mapping2'
-        const schemaObjectOverriden = Object.keys(schemaObject.properties || {}).reduce((acc, propertyName) => {
+        const schemaObjectOverridden = Object.keys(schemaObject.properties || {}).reduce((acc, propertyName) => {
           if (acc.properties?.[propertyName] && propertyName === schemaObject.discriminator.propertyName) {
             return {
               ...acc,
@@ -1210,7 +1228,7 @@ export class SchemaGenerator<
           return acc
         }, schemaObject || {}) as SchemaObject
 
-        return [...this.#parseProperties(name, schemaObjectOverriden), ...baseItems]
+        return [...this.#parseProperties(name, schemaObjectOverridden), ...baseItems]
       }
 
       return [...this.#parseProperties(name, schemaObject), ...baseItems]
@@ -1249,13 +1267,29 @@ export class SchemaGenerator<
 
   async build(...generators: Array<Generator<TPluginOptions>>): Promise<Array<KubbFile.File<TFileMeta>>> {
     const { oas, contentType, include } = this.context
-    const schemas = getSchemas({ oas, contentType, includes: include })
-    const schemaEntries = Object.entries(schemas)
 
-    this.context.events?.emit('debug', {
-      date: new Date(),
-      logs: [`Building ${schemaEntries.length} schemas`, `  • Content Type: ${contentType || 'application/json'}`, `  • Generators: ${generators.length}`],
-    })
+    // Initialize the name mapping if not already done
+    if (!this.#nameMappingInitialized) {
+      const { schemas, nameMapping } = oas.getSchemas({ contentType, includes: include })
+      this.#schemaNameMapping = nameMapping
+      this.#nameMappingInitialized = true
+      const schemaEntries = Object.entries(schemas)
+
+      this.context.events?.emit('debug', {
+        date: new Date(),
+        logs: [`Building ${schemaEntries.length} schemas`, `  • Content Type: ${contentType || 'application/json'}`, `  • Generators: ${generators.length}`],
+      })
+
+      // Continue with build using the schemas
+      return this.#doBuild(schemas, generators)
+    }
+    // If already initialized, just get the schemas (without mapping)
+    const { schemas } = oas.getSchemas({ contentType, includes: include })
+    return this.#doBuild(schemas, generators)
+  }
+
+  async #doBuild(schemas: Record<string, OasTypes.SchemaObject>, generators: Array<Generator<TPluginOptions>>): Promise<Array<KubbFile.File<TFileMeta>>> {
+    const schemaEntries = Object.entries(schemas)
 
     // Increased parallelism for better performance
     // - generatorLimit increased from 1 to 3 to allow parallel generator processing

package/src/SchemaMapper.ts

@@ -61,8 +61,8 @@ export type SchemaKeywordMapper = {
        */
       path: KubbFile.Path
       /**
-       * When true `File.Import` will be used.
-       * When false a reference will be used inside the current file.
+       * When true `File.Import` is used.
+       * When false a reference is used inside the current file.
        */
       isImportable: boolean
     }
@@ -168,7 +168,7 @@ export type SchemaTree = {
   current: Schema
   siblings: Schema[]
   /**
-   * this will be equal to the key of a property(object)
+   * this is equal to the key of a property(object)
    */
   name?: string
 }

package/src/hooks/useOperationManager.ts

@@ -60,7 +60,7 @@ type UseOperationManagerResult = {
 }
 
 /**
- * `useOperationManager` will return some helper functions that can be used to get the operation file, get the operation name.
+ * `useOperationManager` returns helper functions to get the operation file and operation name.
  */
 export function useOperationManager<TPluginOptions extends PluginFactoryOptions = PluginFactoryOptions>(
   generator: Omit<OperationGenerator<TPluginOptions>, 'build'>,

package/src/hooks/useSchemaManager.ts

@@ -31,7 +31,7 @@ type UseSchemaManagerResult = {
 }
 
 /**
- * `useSchemaManager` will return some helper functions that can be used to get the schema file, get the schema name.
+ * `useSchemaManager` returns helper functions to get the schema file and schema name.
  */
 export function useSchemaManager(): UseSchemaManagerResult {
   const plugin = usePlugin()

package/src/plugin.ts

@@ -23,6 +23,7 @@ export const pluginOas = definePlugin<PluginOas>((options) => {
     contentType,
     oasClass,
     discriminator = 'strict',
+    collisionDetection = false,
   } = options
 
   const getOas = async ({ validate, config, events }: { validate: boolean; config: Config; events: AsyncEventEmitter<KubbEvents> }): Promise<Oas> => {
@@ -32,11 +33,12 @@ export const pluginOas = definePlugin<PluginOas>((options) => {
     oas.setOptions({
       contentType,
       discriminator,
+      collisionDetection,
     })
 
     try {
       if (validate) {
-        await oas.valdiate()
+        await oas.validate()
       }
     } catch (er) {
       const caughtError = er as Error

package/src/types.ts

@@ -46,35 +46,55 @@ export type Options = {
   /**
    * Which server to use from the array of `servers.url[serverIndex]`
    * @example
-   * - `0` will return `http://petstore.swagger.io/api`
-   * - `1` will return `http://localhost:3000`
+   * - `0` returns `http://petstore.swagger.io/api`
+   * - `1` returns `http://localhost:3000`
    */
   serverIndex?: number
   /**
    * Define which contentType should be used.
-   * By default, the first JSON valid mediaType will be used
+   * By default, uses the first valid JSON media type.
    */
   contentType?: contentType
   /**
    * Defines how the discriminator value should be interpreted during processing.
-   *
+   * - 'strict' uses the oneOf schemas as defined, without modification.
+   * - 'inherit' replaces the oneOf schema with the schema referenced by discriminator.mapping[key].
    * @default 'strict'
-   *
-   * @example
-   * - `inherit`: Replaces the `oneOf` schema with the schema referenced by `discriminator.mapping[key]`.
-   * - `strict`: Uses the `oneOf` schemas as defined, without modification.
-   *
    * @see https://github.com/kubb-labs/kubb/issues/1736
    */
   discriminator?: 'strict' | 'inherit'
   /**
-   * Override some behaviour of the Oas class instance, see '@kubb/oas'
+   * Override some behavior of the Oas class instance, see '@kubb/oas'
    */
   oasClass?: typeof Oas
   /**
    * Define some generators next to the JSON generation
    */
   generators?: Array<Generator<PluginOas>>
+  /**
+   * Resolve name collisions when schemas from different components share the same name (case-insensitive).
+   *
+   * When enabled, Kubb automatically detects and resolves collisions using intelligent suffixes:
+   * - Cross-component collisions: Adds semantic suffixes based on the component type (Schema/Response/Request)
+   * - Same-component collisions: Adds numeric suffixes (2, 3, ...) for case-insensitive duplicates
+   *
+   * When disabled (legacy behavior), collisions may result in duplicate files or overwrite issues.
+   *
+   * **Cross-component collision example:**
+   * If you have "Order" in both schemas and requestBodies:
+   * - With `collisionDetection: true`: Generates `OrderSchema.ts`, `OrderRequest.ts`
+   * - With `collisionDetection: false`: May generate duplicate `Order.ts` files
+   *
+   * **Same-component collision example:**
+   * If you have "Variant" and "variant" in schemas:
+   * - With `collisionDetection: true`: Generates `Variant.ts`, `Variant2.ts`
+   * - With `collisionDetection: false`: May overwrite or create duplicates
+   *
+   * @default false
+   * @see https://github.com/kubb-labs/kubb/issues/1999
+   * @note this will be the default in Kubb v5
+   */
+  collisionDetection?: boolean
 }
 
 /**