@kubb/plugin-ts 4.29.1 → 4.31.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-ts",
-  "version": "4.29.1",
+  "version": "4.31.1",
   "description": "TypeScript code generation plugin for Kubb, transforming OpenAPI schemas into TypeScript interfaces, types, and utility functions.",
   "keywords": [
     "typescript",
@@ -56,7 +56,8 @@
     "src",
     "dist",
     "!/**/**.test.**",
-    "!/**/__tests__/**"
+    "!/**/__tests__/**",
+    "!/**/__snapshots__/**"
   ],
   "size-limit": [
     {
@@ -66,16 +67,16 @@
     }
   ],
   "dependencies": {
-    "@kubb/fabric-core": "0.13.1",
-    "@kubb/react-fabric": "0.13.1",
+    "@kubb/fabric-core": "0.13.3",
+    "@kubb/react-fabric": "0.13.3",
     "remeda": "^2.33.6",
     "typescript": "5.9.3",
-    "@kubb/core": "4.29.1",
-    "@kubb/oas": "4.29.1",
-    "@kubb/plugin-oas": "4.29.1"
+    "@kubb/core": "4.31.1",
+    "@kubb/oas": "4.31.1",
+    "@kubb/plugin-oas": "4.31.1"
   },
   "peerDependencies": {
-    "@kubb/react-fabric": "0.13.0",
+    "@kubb/react-fabric": "0.13.3",
     "typescript": ">=5.9.0"
   },
   "engines": {

package/dist/types-BX_NNqoT.d.ts

@@ -1,171 +0,0 @@
-import { Oas, contentType } from "@kubb/oas";
-import { Exclude, Include, Override, ResolvePathOptions } from "@kubb/plugin-oas";
-import { Group, Output, PluginFactoryOptions, ResolveNameParams } from "@kubb/core";
-import { Generator } from "@kubb/plugin-oas/generators";
-import ts from "typescript";
-
-//#region \0rolldown/runtime.js
-//#endregion
-//#region src/types.d.ts
-type Options = {
-  /**
-   * Specify the export location for the files and define the behavior of the output
-   * @default { path: 'types', barrelType: 'named' }
-   */
-  output?: Output<Oas>;
-  /**
-   * Define which contentType should be used.
-   * By default, uses the first valid JSON media type.
-   */
-  contentType?: contentType;
-  /**
-   * Group the clients based on the provided name.
-   */
-  group?: Group;
-  /**
-   * Array containing exclude parameters to exclude/skip tags/operations/methods/paths.
-   */
-  exclude?: Array<Exclude>;
-  /**
-   * Array containing include parameters to include tags/operations/methods/paths.
-   */
-  include?: Array<Include>;
-  /**
-   * Array containing override parameters to override `options` based on tags/operations/methods/paths.
-   */
-  override?: Array<Override<ResolvedOptions>>;
-  /**
-   * Choose to use enum, asConst, asPascalConst, constEnum, literal, or inlineLiteral for enums.
-   * - 'enum' generates TypeScript enum declarations.
-   * - 'asConst' generates const objects with camelCase names and as const assertion.
-   * - 'asPascalConst' generates const objects with PascalCase names and as const assertion.
-   * - 'constEnum' generates TypeScript const enum declarations.
-   * - 'literal' generates literal union types.
-   * - 'inlineLiteral' inline enum values directly into the type (default in v5).
-   * @default 'asConst'
-   * @note In Kubb v5, 'inlineLiteral' becomes the default.
-   */
-  enumType?: 'enum' | 'asConst' | 'asPascalConst' | 'constEnum' | 'literal' | 'inlineLiteral';
-  /**
-   * Choose the casing for enum key names.
-   * - 'screamingSnakeCase' generates keys in SCREAMING_SNAKE_CASE format.
-   * - 'snakeCase' generates keys in snake_case format.
-   * - 'pascalCase' generates keys in PascalCase format.
-   * - 'camelCase' generates keys in camelCase format.
-   * - 'none' uses the enum value as-is without transformation.
-   * @default 'none'
-   */
-  enumKeyCasing?: 'screamingSnakeCase' | 'snakeCase' | 'pascalCase' | 'camelCase' | 'none';
-  /**
-   * Switch between type or interface for creating TypeScript types.
-   * - 'type' generates type alias declarations.
-   * - 'interface' generates interface declarations.
-   * @default 'type'
-   */
-  syntaxType?: 'type' | 'interface';
-  /**
-   * Set a suffix for the generated enums.
-   * @default 'enum'
-   */
-  enumSuffix?: string;
-  /**
-   * Choose to use date or datetime as JavaScript Date instead of string.
-   * - 'string' represents dates as string values.
-   * - 'date' represents dates as JavaScript Date objects.
-   * @default 'string'
-   */
-  dateType?: 'string' | 'date';
-  /**
-   * Choose to use `number` or `bigint` for integer fields with `int64` format.
-   * - 'number' uses the TypeScript `number` type (matches JSON.parse() runtime behavior).
-   * - 'bigint' uses the TypeScript `bigint` type (accurate for values exceeding Number.MAX_SAFE_INTEGER).
-   * @note in v5 of Kubb 'bigint' will become the default to better align with OpenAPI's int64 specification.
-   * @default 'number'
-   */
-  integerType?: 'number' | 'bigint';
-  /**
-   * Which type to use when the Swagger/OpenAPI file is not providing more information.
-   * - 'any' allows any value.
-   * - 'unknown' requires type narrowing before use.
-   * - 'void' represents no value.
-   * @default 'any'
-   */
-  unknownType?: 'any' | 'unknown' | 'void';
-  /**
-   * Which type to use for empty schema values.
-   * - 'any' allows any value.
-   * - 'unknown' requires type narrowing before use.
-   * - 'void' represents no value.
-   * @default `unknownType`
-   */
-  emptySchemaType?: 'any' | 'unknown' | 'void';
-  /**
-   * Choose what to use as mode for an optional value.
-   * - 'questionToken' marks the property as optional with ? (e.g., type?: string).
-   * - 'undefined' adds undefined to the type union (e.g., type: string | undefined).
-   * - 'questionTokenAndUndefined' combines both approaches (e.g., type?: string | undefined).
-   * @default 'questionToken'
-   */
-  optionalType?: 'questionToken' | 'undefined' | 'questionTokenAndUndefined';
-  /**
-   * Choose between Array<string> or string[] for array types.
-   * - 'generic' generates Array<Type> syntax.
-   * - 'array' generates Type[] syntax.
-   * @default 'array'
-   */
-  arrayType?: 'generic' | 'array';
-  transformers?: {
-    /**
-     * Customize the names based on the type that is provided by the plugin.
-     */
-    name?: (name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string;
-  };
-  /**
-   * @example
-   * Use https://ts-ast-viewer.com to generate factory code(see createPropertySignature)
-   * category: factory.createPropertySignature(
-   *   undefined,
-   *   factory.createIdentifier("category"),
-   *   factory.createToken(ts.SyntaxKind.QuestionToken),
-   *   factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword)
-   * )
-   */
-  mapper?: Record<string, ts.PropertySignature>;
-  /**
-   * How to style your params, by default no casing is applied
-   * - 'camelcase' uses camelCase for pathParams, queryParams and headerParams property names
-   * @default undefined
-   * @note response types (data/body) are NOT affected by this option
-   */
-  paramsCasing?: 'camelcase';
-  /**
-   * Define some generators next to the ts generators
-   */
-  generators?: Array<Generator<PluginTs>>;
-  /**
-   * Unstable naming for v5
-   */
-  UNSTABLE_NAMING?: true;
-};
-type ResolvedOptions = {
-  output: Output<Oas>;
-  group: Options['group'];
-  override: NonNullable<Options['override']>;
-  enumType: NonNullable<Options['enumType']>;
-  enumKeyCasing: NonNullable<Options['enumKeyCasing']>;
-  enumSuffix: NonNullable<Options['enumSuffix']>;
-  dateType: NonNullable<Options['dateType']>;
-  integerType: NonNullable<Options['integerType']>;
-  unknownType: NonNullable<Options['unknownType']>;
-  emptySchemaType: NonNullable<Options['emptySchemaType']>;
-  optionalType: NonNullable<Options['optionalType']>;
-  arrayType: NonNullable<Options['arrayType']>;
-  transformers: NonNullable<Options['transformers']>;
-  syntaxType: NonNullable<Options['syntaxType']>;
-  mapper: Record<string, any>;
-  paramsCasing: Options['paramsCasing'];
-};
-type PluginTs = PluginFactoryOptions<'plugin-ts', Options, ResolvedOptions, never, ResolvePathOptions>;
-//#endregion
-export { PluginTs as n, __name as r, Options as t };
-//# sourceMappingURL=types-BX_NNqoT.d.ts.map

package/src/generators/__snapshots__/ACHDetailsResponse.ts

@@ -1,19 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-export type ACHDetailsResponse = {
-  /**
-   * @type string
-   */
-  type: paymentDetailsTypeResponse
-  /**
-   * @type string
-   */
-  routing_number: string
-  /**
-   * @type string
-   */
-  account_number: string
-}

package/src/generators/__snapshots__/bodyTest.ts

@@ -1,11 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-export type bodyTest = {
-  /**
-   * @type string
-   */
-  file: Blob
-}

package/src/generators/__snapshots__/bodyUploadFileApiAssetsPost.ts

@@ -1,14 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * Body_upload_file_api_assets_post
- */
-export type bodyUploadFileApiAssetsPost = {
-  /**
-   * @type string, binary
-   */
-  file: Blob
-}

package/src/generators/__snapshots__/catDogDiscriminator.ts

@@ -1,18 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * CatDog
- */
-export type catDog =
-  | (cat & {
-      type: 'Cat'
-    })
-  | (dog & {
-      type: 'Dog'
-    })
-  | (dog & {
-      type: 'Bulldog'
-    })

package/src/generators/__snapshots__/catDogDiscriminatorWithoutMapping.ts

@@ -1,15 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * CatDogWithoutMapping
- */
-export type catDogWithoutMapping =
-  | (cat & {
-      type: 'Cat'
-    })
-  | (dog & {
-      type: 'Dog'
-    })

package/src/generators/__snapshots__/catTypeAsConst.ts

@@ -1,22 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * Cat
- */
-export type cat = {
-  /**
-   * @type string, uuid
-   */
-  id: string
-  /**
-   * @type string
-   */
-  type: 'Cat'
-  /**
-   * @type boolean | undefined
-   */
-  meow?: boolean
-}

package/src/generators/__snapshots__/createPet.ts

@@ -1,47 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * @description Null response
- */
-export type CreatePets201 = error & {
-  /**
-   * @type object | undefined
-   */
-  name?: errorCode
-  /**
-   * @type string
-   */
-  message: string
-}
-
-/**
- * @description Accepted response
- */
-export type CreatePets202 = unknown
-
-/**
- * @description unexpected error
- */
-export type CreatePetsError = error
-
-export type CreatePetsMutationRequest = {
-  /**
-   * @type string
-   */
-  name: string
-  /**
-   * @type string
-   */
-  tag: string
-}
-
-export type CreatePetsMutationResponse = createPets201 | createPets202
-
-export type CreatePetsMutation = {
-  Response: createPets201 | createPets202
-  Request: createPetsMutationRequest
-  Errors: any
-}

package/src/generators/__snapshots__/createPetWithEmptySchemaTypeUnknown.ts

@@ -1,47 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * @description Null response
- */
-export type CreatePets201 = error & {
-  /**
-   * @type object | undefined
-   */
-  name?: errorCode
-  /**
-   * @type string
-   */
-  message: string
-}
-
-/**
- * @description Accepted response
- */
-export type CreatePets202 = unknown
-
-/**
- * @description unexpected error
- */
-export type CreatePetsError = error
-
-export type CreatePetsMutationRequest = {
-  /**
-   * @type string
-   */
-  name: string
-  /**
-   * @type string
-   */
-  tag: string
-}
-
-export type CreatePetsMutationResponse = createPets201 | createPets202
-
-export type CreatePetsMutation = {
-  Response: createPets201 | createPets202
-  Request: createPetsMutationRequest
-  Errors: any
-}

package/src/generators/__snapshots__/createPetWithEmptySchemaTypeVoid.ts

@@ -1,47 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * @description Null response
- */
-export type CreatePets201 = error & {
-  /**
-   * @type object | undefined
-   */
-  name?: errorCode
-  /**
-   * @type string
-   */
-  message: string
-}
-
-/**
- * @description Accepted response
- */
-export type CreatePets202 = void
-
-/**
- * @description unexpected error
- */
-export type CreatePetsError = error
-
-export type CreatePetsMutationRequest = {
-  /**
-   * @type string
-   */
-  name: string
-  /**
-   * @type string
-   */
-  tag: string
-}
-
-export type CreatePetsMutationResponse = createPets201 | createPets202
-
-export type CreatePetsMutation = {
-  Response: createPets201 | createPets202
-  Request: createPetsMutationRequest
-  Errors: any
-}

package/src/generators/__snapshots__/createPetWithUnknownTypeUnknown.ts

@@ -1,47 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * @description Null response
- */
-export type CreatePets201 = error & {
-  /**
-   * @type object | undefined
-   */
-  name?: errorCode
-  /**
-   * @type string
-   */
-  message: string
-}
-
-/**
- * @description Accepted response
- */
-export type CreatePets202 = unknown
-
-/**
- * @description unexpected error
- */
-export type CreatePetsError = error
-
-export type CreatePetsMutationRequest = {
-  /**
-   * @type string
-   */
-  name: string
-  /**
-   * @type string
-   */
-  tag: string
-}
-
-export type CreatePetsMutationResponse = createPets201 | createPets202
-
-export type CreatePetsMutation = {
-  Response: createPets201 | createPets202
-  Request: createPetsMutationRequest
-  Errors: any
-}

package/src/generators/__snapshots__/createPetWithUnknownTypeVoid.ts

@@ -1,47 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * @description Null response
- */
-export type CreatePets201 = error & {
-  /**
-   * @type object | undefined
-   */
-  name?: errorCode
-  /**
-   * @type string
-   */
-  message: string
-}
-
-/**
- * @description Accepted response
- */
-export type CreatePets202 = unknown
-
-/**
- * @description unexpected error
- */
-export type CreatePetsError = error
-
-export type CreatePetsMutationRequest = {
-  /**
-   * @type string
-   */
-  name: string
-  /**
-   * @type string
-   */
-  tag: string
-}
-
-export type CreatePetsMutationResponse = createPets201 | createPets202
-
-export type CreatePetsMutation = {
-  Response: createPets201 | createPets202
-  Request: createPetsMutationRequest
-  Errors: any
-}

package/src/generators/__snapshots__/deletePet.ts

@@ -1,11 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-export type DeletePetsPetidMutationResponse = any
-
-export type DeletePetsPetidMutation = {
-  Response: any
-  Errors: any
-}

package/src/generators/__snapshots__/discriminatorInheritVehicle.ts

@@ -1,17 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-export const vehicleTypeEnum = {
-  car: 'car',
-} as const
-
-export type VehicleTypeEnumKey = (typeof vehicleTypeEnum)[keyof typeof vehicleTypeEnum]
-
-export type vehicle = car & {
-  /**
-   * @type string
-   */
-  type: VehicleTypeEnumKey
-}

package/src/generators/__snapshots__/discriminatorStrictVehicle.ts

@@ -1,11 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-export type vehicle = car & {
-  /**
-   * @type string
-   */
-  type: 'car'
-}

package/src/generators/__snapshots__/dogTypeAsConst.ts

@@ -1,22 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-/**
- * Dog
- */
-export type dog = {
-  /**
-   * @type string, uuid
-   */
-  id: string
-  /**
-   * @type string
-   */
-  type: 'Dog'
-  /**
-   * @type number | undefined
-   */
-  bark?: number
-}

package/src/generators/__snapshots__/enumAllOf.ts

@@ -1,18 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-export const enumAllOfReasonEnum = {
-  created_at: 'created_at',
-  description: 'description',
-} as const
-
-export type EnumAllOfReasonEnumKey = (typeof enumAllOfReasonEnum)[keyof typeof enumAllOfReasonEnum]
-
-export type enumAllOf = {
-  /**
-   * @type string | undefined
-   */
-  reason?: EnumAllOfReasonEnumKey
-}

package/src/generators/__snapshots__/enumArray.ts

@@ -1,8 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-export type EnumArrayEnum = 'NW' | 'NE' | 'SW' | 'SE'
-
-export type enumArray = EnumArrayEnum[]

package/src/generators/__snapshots__/enumArray20.ts

@@ -1,20 +0,0 @@
-/**
- * Generated by Kubb (https://kubb.dev/).
- * Do not edit manually.
- */
-
-export const enumArrayIdentifierEnum = {
-  NW: 'NW',
-  NE: 'NE',
-  SW: 'SW',
-  SE: 'SE',
-} as const
-
-export type EnumArrayIdentifierEnumKey = (typeof enumArrayIdentifierEnum)[keyof typeof enumArrayIdentifierEnum]
-
-export type enumArray = {
-  /**
-   * @type array | undefined
-   */
-  identifier?: [number, string, EnumArrayIdentifierEnumKey, ...unknown[]]
-}