@kubb/plugin-ts 5.5.0-canary.20261111T122006 → 5.5.1

package/docs/guides/customization.md

@@ -43,9 +43,9 @@ pluginTs({
 })
 ```
 
-Handlers that return TypeScript compiler nodes still work when your project installs `@kubb/parser-ts`, plus `typescript` 5 or 6 or `@typescript/typescript6` next to TypeScript 7. All are optional peer dependencies. If `@kubb/parser-ts` is missing, the build stops with an error that tells you to install it. That form is deprecated and is removed in the next major.
+The example maps `date` fields to `Date` and `int32` integers to `bigint`. The separate `bigint` handler controls `int64` fields, which already use `bigint` by default. A `date-time` field uses the `datetime` handler.
 
-This maps `date` fields to `Date` and `int32` integers to `bigint`. The separate `bigint` handler controls `int64` fields, which already use `bigint` by default. A `date-time` field uses the `datetime` handler.
+Handlers that return TypeScript compiler nodes are deprecated and are removed in the next major. They still work when your project installs `@kubb/parser-ts`, plus `typescript` 5 or 6 or `@typescript/typescript6` next to TypeScript 7. All are optional peer dependencies. If `@kubb/parser-ts` is missing, the build stops with an error that tells you to install it.
 
 ## Remove descriptions
 
@@ -53,9 +53,9 @@ Clear schema descriptions with a [macro](https://kubb.dev/docs/5.x/reference/plu
 
 ```typescript [kubb.config.ts]
 import { pluginTs } from '@kubb/plugin-ts'
-import { ast } from 'kubb/kit'
+import { defineMacro } from 'kubb/kit'
 
-const dropDescriptions = ast.defineMacro({
+const dropDescriptions = defineMacro({
   name: 'drop-descriptions',
   schema(node) {
     return 'description' in node && node.description
@@ -67,4 +67,4 @@ const dropDescriptions = ast.defineMacro({
 pluginTs({ macros: [dropDescriptions] })
 ```
 
-The generated types omit description JSDoc. The OpenAPI document stays unchanged. The same macro works with `pluginZod`.
+The generated types omit description JSDoc. The OpenAPI document stays unchanged. The same macro works with `pluginZod`, with [one exception](https://kubb.dev/extensions/kubb-labs/plugin-zod/guides/customization#remove-descriptions).

package/docs/options.md

@@ -63,7 +63,7 @@ Emits a named union type with no runtime value.
 :::
 
 :::field{name="'inlineLiteral'"}
-Emits the same union as `'literal'` but inlines it at each usage site instead of naming it.
+Emits the same union as `'literal'` and inlines it at each usage site for an enum declared on a property. A component enum that a `$ref` points to keeps its named type.
 :::
 
 ::
@@ -118,7 +118,7 @@ Names the const `PetStatus`, matching the schema name.
 
 #### enum.typeSuffix
 
-Suffix on the companion type alias when `type` is `'asConst'`. It never changes the const object name. Set it to `''` to drop the suffix, which with `constCasing: 'pascalCase'` merges the const and the type under one name, `PetStatus`.
+Suffix on the companion type alias when `type` is `'asConst'`. The suffix never changes the const object name. Set it to `''` to drop the suffix, which with `constCasing: 'pascalCase'` merges the const and the type under one name, `PetStatus`.
 
 |          |          |
 | -------- | -------- |
@@ -236,7 +236,7 @@ Uses `tags: Array<string>`, which reads better for complex elements like `Array<
 
 ### operations
 
-Whether each operation gets its own types file (`AddPetOptions`, `AddPetResponses`, `AddPetStatus200`, `AddPetPath`).
+Whether each operation gets its own types file (`AddPetOptions`, `AddPetResponses`, `AddPetStatus200`, `AddPetPath`). A response that declares `headers` also gets a type for them, such as `ListPetsStatus200Headers`. Cookie parameters get a type such as `ListPetsCookies`.
 
 |          |                        |
 | -------- | ---------------------- |
@@ -251,7 +251,7 @@ Emits one file per operation with its aliases and aggregates, for example `expor
 :::
 
 :::field{name="'inline'"}
-Emits only the schema types. Clients, query hooks, MSW handlers, Faker mocks, Cypress requests, and MCP handlers reference those directly and print the rest inline, for example `Options<{ body: Order; path?: never; query?: never; headers?: never }>` and `mutationOptions<Order, ResponseErrorConfig<unknown>, …>`. An enum declared inside an operation becomes a literal union such as `'available' | 'pending' | 'sold'`. Kubb moves each operation type into the files that use it, so this needs a Kubb version with inline sources.
+Emits only the schema types. Clients, query hooks, MSW handlers, Faker mocks, Cypress requests, and MCP handlers reference those directly and print the rest inline, for example `Options<{ body: Order; path?: never; query?: never; headers?: never }>` and `mutationOptions<Order, ResponseErrorConfig<unknown>, …>`. An enum declared inside an operation becomes a literal union such as `'available' | 'pending' | 'sold'`. Kubb moves each operation type into the files that use it, so `'inline'` needs a Kubb version with inline sources.
 :::
 
 ::
@@ -275,9 +275,11 @@ type ResolverTsPatch = {
     path?(node: OperationNode, param: ParameterNode): string     // → 'GetPetByIdPath'
     query?(node: OperationNode, param: ParameterNode): string    // → 'FindPetsByStatusQuery'
     headers?(node: OperationNode, param: ParameterNode): string  // → 'DeletePetHeaders'
+    cookies?(node: OperationNode, param: ParameterNode): string  // → 'GetCookiesCookies'
   }
   response?: {
     status?(node: OperationNode, statusCode: StatusCode): string // → 'ListPetsStatus200'
+    headers?(node: OperationNode, statusCode: StatusCode): string // → 'ListPetsStatus200Headers'
     options?(node: OperationNode): string                        // → 'ListPetsOptions'
     responses?(node: OperationNode): string                      // → 'ListPetsResponses'
     response?(node: OperationNode): string                       // → 'ListPetsResponse'
@@ -293,7 +295,7 @@ type ResolverTsPatch = {
 
 ### printer
 
-Replaces the node handler for a schema type such as `'integer'` or `'date'` with one that builds its TypeScript AST node. Use `this.transform` to recurse into nested nodes and `this.options` to read printer options. The [printer guide](https://kubb.dev/docs/5.x/how-to/printers) covers the handler context and how overrides compose with macros.
+Replaces the handler for a schema type such as `'integer'` or `'date'`. Each handler returns the TypeScript type as a string. Inside a handler, `this.transform(node)` returns the printed type of a nested node and `this.options` holds the printer options. A handler that returns a TypeScript compiler node is deprecated. The [printer guide](https://kubb.dev/docs/5.x/how-to/printers) covers the handler context and how overrides compose with macros.
 
 |          |                              |
 | -------- | ---------------------------- |

package/kubb-extension.json

@@ -18,7 +18,7 @@
     }
   ],
   "compatibility": {
-    "kubb": ">=5.16.0",
+    "kubb": ">=5.18.4",
     "node": ">=22.22"
   },
   "options": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-ts",
-  "version": "5.5.0-canary.20261111T122006",
+  "version": "5.5.1",
   "description": "Generate TypeScript types, interfaces, and enums with Kubb. The base plugin other Kubb plugins build on for type safety.",
   "keywords": [
     "code-generation",
@@ -67,18 +67,18 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/kit": "^5.18.2",
-    "@kubb/renderer-jsx": "^5.18.2",
+    "@kubb/kit": "^5.18.8",
+    "@kubb/renderer-jsx": "^5.18.8",
     "yuku-codegen": "^0.19.0"
   },
   "devDependencies": {
-    "@internals/shared": "0.1.0-canary.20261111T122006",
-    "@internals/utils": "0.1.0-canary.20261111T122006",
-    "@kubb/parser-ts": "^5.18.2",
+    "@internals/shared": "0.0.0",
+    "@internals/utils": "0.0.0",
+    "@kubb/parser-ts": "^5.18.8",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {
-    "@kubb/parser-ts": "^5.18.2",
+    "@kubb/parser-ts": "^5.18.8",
     "@typescript/typescript6": "^6.0.2",
     "typescript": ">=5.0.0"
   },