@kubb/plugin-client 4.18.4 → 4.19.0

package/dist/components.d.cts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-DlpkT3g-.cjs";
-import { i as OperationSchemas, n as PluginClient, o as Operation } from "./types-Chp-emXk.cjs";
+import { i as OperationSchemas, n as PluginClient, o as Operation } from "./types-9E2xtAWa.cjs";
 import { FunctionParams } from "@kubb/react-fabric";
 import { KubbNode } from "@kubb/react-fabric/types";
 

package/dist/components.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import { i as OperationSchemas, n as PluginClient, o as Operation } from "./types-aqsuGVmg.js";
+import { i as OperationSchemas, n as PluginClient, o as Operation } from "./types-CEoiGmcV.js";
 import { FunctionParams } from "@kubb/react-fabric";
 import { KubbNode } from "@kubb/react-fabric/types";
 

package/dist/generators.d.cts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-DlpkT3g-.cjs";
-import { n as PluginClient, r as ReactGenerator } from "./types-Chp-emXk.cjs";
+import { n as PluginClient, r as ReactGenerator } from "./types-9E2xtAWa.cjs";
 
 //#region src/generators/classClientGenerator.d.ts
 declare const classClientGenerator: ReactGenerator<PluginClient>;

package/dist/generators.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import { n as PluginClient, r as ReactGenerator } from "./types-aqsuGVmg.js";
+import { n as PluginClient, r as ReactGenerator } from "./types-CEoiGmcV.js";
 
 //#region src/generators/classClientGenerator.d.ts
 declare const classClientGenerator: ReactGenerator<PluginClient>;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-DlpkT3g-.cjs";
-import { a as UserPluginWithLifeCycle, n as PluginClient, t as Options } from "./types-Chp-emXk.cjs";
+import { a as UserPluginWithLifeCycle, n as PluginClient, t as Options } from "./types-9E2xtAWa.cjs";
 
 //#region src/plugin.d.ts
 declare const pluginClientName = "plugin-client";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-iVr_oF3V.js";
-import { a as UserPluginWithLifeCycle, n as PluginClient, t as Options } from "./types-aqsuGVmg.js";
+import { a as UserPluginWithLifeCycle, n as PluginClient, t as Options } from "./types-CEoiGmcV.js";
 
 //#region src/plugin.d.ts
 declare const pluginClientName = "plugin-client";

package/dist/{types-Chp-emXk.d.cts → types-9E2xtAWa.d.cts}

@@ -19,16 +19,21 @@ type Operation$1 = Operation;
 type DiscriminatorObject$1 = DiscriminatorObject;
 //#endregion
 //#region ../oas/src/Oas.d.ts
-type Options$2 = {
+type OasOptions = {
   contentType?: contentType;
   discriminator?: 'strict' | 'inherit';
+  /**
+   * Resolve name collisions when schemas from different components share the same name (case-insensitive).
+   * @default false
+   */
+  collisionDetection?: boolean;
 };
 declare class Oas extends BaseOas {
   #private;
   document: Document;
   constructor(document: Document);
-  setOptions(options: Options$2): void;
-  get options(): Options$2;
+  setOptions(options: OasOptions): void;
+  get options(): OasOptions;
   get<T = unknown>($ref: string): T | null;
   getKey($ref: string): string | undefined;
   set($ref: string, value: unknown): false | undefined;
@@ -37,8 +42,20 @@ declare class Oas extends BaseOas {
   getResponseSchema(operation: Operation$1, statusCode: string | number): SchemaObject$1;
   getRequestSchema(operation: Operation$1): SchemaObject$1 | undefined;
   getParametersSchema(operation: Operation$1, inKey: 'path' | 'query' | 'header'): SchemaObject$1 | null;
-  valdiate(): Promise<oas_normalize_lib_types0.ValidationResult>;
+  validate(): Promise<oas_normalize_lib_types0.ValidationResult>;
   flattenSchema(schema: SchemaObject$1 | null): SchemaObject$1 | null;
+  /**
+   * Get schemas from OpenAPI components (schemas, responses, requestBodies).
+   * Returns schemas in dependency order along with name mapping for collision resolution.
+   */
+  getSchemas(options?: {
+    contentType?: contentType;
+    includes?: Array<'schemas' | 'responses' | 'requestBodies'>;
+    collisionDetection?: boolean;
+  }): {
+    schemas: Record<string, SchemaObject$1>;
+    nameMapping: Map<string, string>;
+  };
 }
 //#endregion
 //#region ../core/src/BaseGenerator.d.ts
@@ -339,7 +356,7 @@ type Config<TInput = Input> = {
   input: TInput;
   output: {
     /**
-     * The path where all generated files will be exported.
+     * The path where all generated files receives exported.
      * This can be an absolute path or a path relative to the specified root option.
      */
     path: string;
@@ -354,41 +371,39 @@ type Config<TInput = Input> = {
     write?: boolean;
     /**
      * Specifies the formatting tool to be used.
-     * @default prettier
-     *
-     * Possible values:
-     * - 'auto': Automatically detects and uses biome or prettier (in that order of preference).
-     * - 'prettier': Uses Prettier for code formatting.
-     * - 'biome': Uses Biome for code formatting.
-     *
+     * - 'auto' automatically detects and uses biome or prettier (in that order of preference).
+     * - 'prettier' uses Prettier for code formatting.
+     * - 'biome' uses Biome for code formatting.
+     * - 'oxfmt' uses Oxfmt for code formatting.
+     * - false disables code formatting.
+     * @default 'prettier'
      */
     format?: 'auto' | 'prettier' | 'biome' | 'oxfmt' | false;
     /**
      * Specifies the linter that should be used to analyze the code.
-     * The accepted values indicate different linting tools.
-     *
-     * Possible values:
-     * - 'auto': Automatically detects and uses biome, oxlint, or eslint (in that order of preference).
-     * - 'eslint': Represents the use of ESLint, a widely used JavaScript linter.
-     * - 'biome': Represents the Biome linter, a modern tool for code scanning.
-     * - 'oxlint': Represents the Oxlint tool for linting purposes.
-     *
+     * - 'auto' automatically detects and uses biome, oxlint, or eslint (in that order of preference).
+     * - 'eslint' uses ESLint for linting.
+     * - 'biome' uses Biome for linting.
+     * - 'oxlint' uses Oxlint for linting.
+     * - false disables linting.
+     * @default 'auto'
      */
     lint?: 'auto' | 'eslint' | 'biome' | 'oxlint' | false;
     /**
-     * Override the extension to the generated imports and exports, by default each plugin will add an extension
+     * Overrides the extension for generated imports and exports. By default, each plugin adds an extension.
      * @default { '.ts': '.ts'}
      */
     extension?: Record<KubbFile.Extname, KubbFile.Extname | ''>;
     /**
-     * Specify how `index.ts` files should be created. You can also disable the generation of barrel files here. While each plugin has its own `barrelType` option, this setting controls the creation of the root barrel file, such as` src/gen/index.ts`.
+     * Configures how `index.ts` files are created, including disabling barrel file generation. Each plugin has its own `barrelType` option; this setting controls the root barrel file (e.g., `src/gen/index.ts`).
      * @default 'named'
      */
     barrelType?: Exclude<BarrelType, 'propagate'> | false;
     /**
-     * Add a default banner to the beginning of every generated file. This makes it clear that the file was generated by Kubb.
-     * - 'simple': will only add banner with link to Kubb
-     * - 'full': will add source, title, description and the OpenAPI version used
+     * Adds a default banner to the start of every generated file indicating it was generated by Kubb.
+     * - 'simple' adds banner with link to Kubb.
+     * - 'full' adds source, title, description, and OpenAPI version.
+     * - false disables banner generation.
      * @default 'simple'
      */
     defaultBanner?: 'simple' | 'full' | false;
@@ -401,17 +416,17 @@ type Config<TInput = Input> = {
     override?: boolean;
   };
   /**
-   * An array of Kubb plugins that will be used in the generation.
+   * An array of Kubb plugins that used in the generation.
    * Each plugin may include additional configurable options(defined in the plugin itself).
-   * If a plugin depends on another plugin, an error will be returned if the required dependency is missing. See pre for more details.
+   * If a plugin depends on another plugin, an error is returned if the required dependency is missing. See pre for more details.
    */
   plugins?: Array<Plugin>;
   /**
-   * Hooks that will be called when a specific action is triggered in Kubb.
+   * Hooks triggered when a specific action occurs in Kubb.
    */
   hooks?: {
     /**
-     * Hook that will be triggered at the end of all executions.
+     * Hook that triggers at the end of all executions.
      * Useful for running Prettier or ESLint to format/lint your code.
      */
     done?: string | Array<string>;
@@ -440,7 +455,7 @@ TContext = any,
 TResolvePathOptions extends object = object> = {
   name: TName;
   /**
-   * Same behaviour like what has been done with `QueryKey` in `@tanstack/react-query`
+   * Same behavior like what has been done with `QueryKey` in `@tanstack/react-query`
    */
   key: PluginKey<TName | string>;
   options: TOptions;
@@ -461,12 +476,12 @@ type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> =
    */
   options: TOptions['resolvedOptions'];
   /**
-   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin will be executed after these plugins.
+   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin is executed after these plugins.
    * Can be used to validate dependent plugins.
    */
   pre?: Array<string>;
   /**
-   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin will be executed before these plugins.
+   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin is executed before these plugins.
    */
   post?: Array<string>;
   inject?: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => TOptions['context'];
@@ -484,12 +499,12 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
    */
   key: TOptions['key'];
   /**
-   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin will be executed after these plugins.
+   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin is executed after these plugins.
    * Can be used to validate dependent plugins.
    */
   pre?: Array<string>;
   /**
-   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin will be executed before these plugins.
+   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin is executed before these plugins.
    */
   post?: Array<string>;
   /**
@@ -539,10 +554,12 @@ type ResolveNameParams = {
   name: string;
   pluginKey?: Plugin['key'];
   /**
-   * `file` will be used to customize the name of the created file(use of camelCase)
-   * `function` can be used to customize the exported functions(use of camelCase)
-   * `type` is a special type for TypeScript(use of PascalCase)
-   * `const` can be used for variables(use of camelCase)
+   * Specifies the type of entity being named.
+   * - 'file' customizes the name of the created file (uses camelCase).
+   * - 'function' customizes the exported function names (uses camelCase).
+   * - 'type' customizes TypeScript types (uses PascalCase).
+   * - 'const' customizes variable names (uses camelCase).
+   * @default undefined
    */
   type?: 'file' | 'function' | 'type' | 'const';
 };
@@ -597,11 +614,14 @@ type GroupContext = {
 };
 type Group = {
   /**
-   * Define a type where to group the files on
+   * Defines the type where to group the files.
+   * - 'tag' groups files by OpenAPI tags.
+   * - 'path' groups files by OpenAPI paths.
+   * @default undefined
    */
   type: 'tag' | 'path';
   /**
-   * Return the name of a group based on the group name, this will be used for the file and name generation
+   * Return the name of a group based on the group name, this used for the file and name generation
    */
   name?: (context: GroupContext) => string;
 };
@@ -673,7 +693,7 @@ declare class PluginManager {
     parameters: PluginParameter<H>;
   }): Array<ReturnType<ParseResult<H>>> | null;
   /**
-   * First non-null result stops and will return it's value.
+   * Returns the first non-null result.
    */
   hookFirst<H extends PluginLifecycleHooks>({
     hookName,
@@ -685,7 +705,7 @@ declare class PluginManager {
     skipped?: ReadonlySet<Plugin> | null;
   }): Promise<SafeParseResult<H>>;
   /**
-   * First non-null result stops and will return it's value.
+   * Returns the first non-null result.
    */
   hookFirstSync<H extends PluginLifecycleHooks>({
     hookName,
@@ -697,15 +717,15 @@ declare class PluginManager {
     skipped?: ReadonlySet<Plugin> | null;
   }): SafeParseResult<H>;
   /**
-   * Run all plugins in parallel(order will be based on `this.plugin` and if `pre` or `post` is set).
+   * Runs all plugins in parallel based on `this.plugin` order and `pre`/`post` settings.
    */
-  hookParallel<H extends PluginLifecycleHooks, TOuput = void>({
+  hookParallel<H extends PluginLifecycleHooks, TOutput = void>({
     hookName,
     parameters
   }: {
     hookName: H;
     parameters?: Parameters<RequiredPluginLifecycle[H]> | undefined;
-  }): Promise<Awaited<TOuput>[]>;
+  }): Promise<Awaited<TOutput>[]>;
   /**
    * Chains plugins
    */
@@ -974,8 +994,8 @@ 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;
     };
@@ -1107,7 +1127,7 @@ 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
      */
@@ -1186,7 +1206,7 @@ type Options = {
   output?: Output<Oas>;
   /**
    * Define which contentType should be used.
-   * By default, the first JSON valid mediaType will be used
+   * By default, the first JSON valid mediaType is used
    */
   contentType?: contentType;
   /**
@@ -1211,16 +1231,17 @@ type Options = {
    */
   operations?: boolean;
   /**
-   * Export urls that are used by operation x
-   * `export` will make them part of your barrel file
-   * false will not make them exportable
+   * Export urls that are used by operation x.
+   * - 'export' makes them part of your barrel file.
+   * - false does not make them exportable.
+   * @default false
    * @example getGetPetByIdUrl
    */
   urlType?: 'export' | false;
   /**
-   * Path to the client import path that will be used to do the API calls.
-   * It will be used as `import client from '${client.importPath}'`.
-   * It allows both relative and absolute path but be aware that we will not change the path.
+   * Client import path for API calls.
+   * Used as `import client from '${client.importPath}'`.
+   * Accepts relative and absolute paths; path changes are not performed.
    */
   importPath?: string;
   /**
@@ -1228,49 +1249,50 @@ type Options = {
    */
   baseURL?: string;
   /**
-   * ReturnType that will be used when calling the client.
-   * - 'data' will return ResponseConfig[data].
-   * - 'full' will return ResponseConfig.
+   * ReturnType that is used when calling the client.
+   * - 'data' returns ResponseConfig[data].
+   * - 'full' returns ResponseConfig.
    * @default 'data'
    */
   dataReturnType?: 'data' | 'full';
   /**
    * How to style your params, by default no casing is applied
-   * - 'camelcase' will use camelcase for the params names
+   * - 'camelcase' uses camelcase for the params names
    */
   paramsCasing?: 'camelcase';
   /**
-   * How to pass your params
-   * - 'object' will return the params and pathParams as an object.
-   * - 'inline' will return the params as comma separated params.
+   * How to pass your params.
+   * - 'object' returns the params and pathParams as an object.
+   * - 'inline' returns the params as comma separated params.
    * @default 'inline'
    */
   paramsType?: 'object' | 'inline';
   /**
    * How to pass your pathParams.
-   * - 'object' will return the pathParams as an object.
-   * - 'inline' will return the pathParams as comma separated params.
+   * - 'object' returns the pathParams as an object.
+   * - 'inline' returns the pathParams as comma separated params.
    * @default 'inline'
    */
   pathParamsType?: 'object' | 'inline';
   /**
-   * Which parser can be used before returning the data
-   * - 'zod' will use `@kubb/plugin-zod` to parse the data.
+   * Which parser can be used before returning the data.
+   * - 'client' returns the data as-is from the client.
+   * - 'zod' uses @kubb/plugin-zod to parse the data.
    * @default 'client'
    */
   parser?: 'client' | 'zod';
   /**
-   * Which client should be used to do the HTTP calls
-   * - 'axios' will use `@kubb/plugin-client/templates/axios` to fetch data.
-   * - 'fetch' will use `@kubb/plugin-client/templates/fetch` to fetch data.
+   * Which client should be used to do the HTTP calls.
+   * - 'axios' uses axios client for HTTP requests.
+   * - 'fetch' uses native fetch API for HTTP requests.
    * @default 'axios'
    */
   client?: 'axios' | 'fetch';
   /**
-   * How to generate the client code
-   * - 'function' will generate standalone functions for each operation.
-   * - 'class' will generate a class with methods for each operation.
-   * - 'staticClass' will generate a class with static methods for each operation.
+   * How to generate the client code.
+   * - 'function' generates standalone functions for each operation.
+   * - 'class' generates a class with methods for each operation.
+   * - 'staticClass' generates a class with static methods for each operation.
    * @default 'function'
    */
   clientType?: 'function' | 'class' | 'staticClass';
@@ -1278,7 +1300,7 @@ type Options = {
    * Bundle the selected client into the generated `.kubb` directory.
    * When disabled the generated clients will import the shared runtime from `@kubb/plugin-client/clients/*`.
    * @default false
-   * In version 5 of Kubb this will be by default true
+   * In version 5 of Kubb this is by default true
    */
   bundle?: boolean;
   transformers?: {
@@ -1310,4 +1332,4 @@ type ResolvedOptions = {
 type PluginClient = PluginFactoryOptions<'plugin-client', Options, ResolvedOptions, never, ResolvePathOptions>;
 //#endregion
 export { UserPluginWithLifeCycle as a, OperationSchemas as i, PluginClient as n, Operation$1 as o, ReactGenerator as r, Options as t };
-//# sourceMappingURL=types-Chp-emXk.d.cts.map
+//# sourceMappingURL=types-9E2xtAWa.d.cts.map

package/dist/{types-aqsuGVmg.d.ts → types-CEoiGmcV.d.ts}

@@ -19,16 +19,21 @@ type Operation$1 = Operation;
 type DiscriminatorObject$1 = DiscriminatorObject;
 //#endregion
 //#region ../oas/src/Oas.d.ts
-type Options$2 = {
+type OasOptions = {
   contentType?: contentType;
   discriminator?: 'strict' | 'inherit';
+  /**
+   * Resolve name collisions when schemas from different components share the same name (case-insensitive).
+   * @default false
+   */
+  collisionDetection?: boolean;
 };
 declare class Oas extends BaseOas {
   #private;
   document: Document;
   constructor(document: Document);
-  setOptions(options: Options$2): void;
-  get options(): Options$2;
+  setOptions(options: OasOptions): void;
+  get options(): OasOptions;
   get<T = unknown>($ref: string): T | null;
   getKey($ref: string): string | undefined;
   set($ref: string, value: unknown): false | undefined;
@@ -37,8 +42,20 @@ declare class Oas extends BaseOas {
   getResponseSchema(operation: Operation$1, statusCode: string | number): SchemaObject$1;
   getRequestSchema(operation: Operation$1): SchemaObject$1 | undefined;
   getParametersSchema(operation: Operation$1, inKey: 'path' | 'query' | 'header'): SchemaObject$1 | null;
-  valdiate(): Promise<oas_normalize_lib_types0.ValidationResult>;
+  validate(): Promise<oas_normalize_lib_types0.ValidationResult>;
   flattenSchema(schema: SchemaObject$1 | null): SchemaObject$1 | null;
+  /**
+   * Get schemas from OpenAPI components (schemas, responses, requestBodies).
+   * Returns schemas in dependency order along with name mapping for collision resolution.
+   */
+  getSchemas(options?: {
+    contentType?: contentType;
+    includes?: Array<'schemas' | 'responses' | 'requestBodies'>;
+    collisionDetection?: boolean;
+  }): {
+    schemas: Record<string, SchemaObject$1>;
+    nameMapping: Map<string, string>;
+  };
 }
 //#endregion
 //#region ../core/src/BaseGenerator.d.ts
@@ -339,7 +356,7 @@ type Config<TInput = Input> = {
   input: TInput;
   output: {
     /**
-     * The path where all generated files will be exported.
+     * The path where all generated files receives exported.
      * This can be an absolute path or a path relative to the specified root option.
      */
     path: string;
@@ -354,41 +371,39 @@ type Config<TInput = Input> = {
     write?: boolean;
     /**
      * Specifies the formatting tool to be used.
-     * @default prettier
-     *
-     * Possible values:
-     * - 'auto': Automatically detects and uses biome or prettier (in that order of preference).
-     * - 'prettier': Uses Prettier for code formatting.
-     * - 'biome': Uses Biome for code formatting.
-     *
+     * - 'auto' automatically detects and uses biome or prettier (in that order of preference).
+     * - 'prettier' uses Prettier for code formatting.
+     * - 'biome' uses Biome for code formatting.
+     * - 'oxfmt' uses Oxfmt for code formatting.
+     * - false disables code formatting.
+     * @default 'prettier'
      */
     format?: 'auto' | 'prettier' | 'biome' | 'oxfmt' | false;
     /**
      * Specifies the linter that should be used to analyze the code.
-     * The accepted values indicate different linting tools.
-     *
-     * Possible values:
-     * - 'auto': Automatically detects and uses biome, oxlint, or eslint (in that order of preference).
-     * - 'eslint': Represents the use of ESLint, a widely used JavaScript linter.
-     * - 'biome': Represents the Biome linter, a modern tool for code scanning.
-     * - 'oxlint': Represents the Oxlint tool for linting purposes.
-     *
+     * - 'auto' automatically detects and uses biome, oxlint, or eslint (in that order of preference).
+     * - 'eslint' uses ESLint for linting.
+     * - 'biome' uses Biome for linting.
+     * - 'oxlint' uses Oxlint for linting.
+     * - false disables linting.
+     * @default 'auto'
      */
     lint?: 'auto' | 'eslint' | 'biome' | 'oxlint' | false;
     /**
-     * Override the extension to the generated imports and exports, by default each plugin will add an extension
+     * Overrides the extension for generated imports and exports. By default, each plugin adds an extension.
      * @default { '.ts': '.ts'}
      */
     extension?: Record<KubbFile.Extname, KubbFile.Extname | ''>;
     /**
-     * Specify how `index.ts` files should be created. You can also disable the generation of barrel files here. While each plugin has its own `barrelType` option, this setting controls the creation of the root barrel file, such as` src/gen/index.ts`.
+     * Configures how `index.ts` files are created, including disabling barrel file generation. Each plugin has its own `barrelType` option; this setting controls the root barrel file (e.g., `src/gen/index.ts`).
      * @default 'named'
      */
     barrelType?: Exclude<BarrelType, 'propagate'> | false;
     /**
-     * Add a default banner to the beginning of every generated file. This makes it clear that the file was generated by Kubb.
-     * - 'simple': will only add banner with link to Kubb
-     * - 'full': will add source, title, description and the OpenAPI version used
+     * Adds a default banner to the start of every generated file indicating it was generated by Kubb.
+     * - 'simple' adds banner with link to Kubb.
+     * - 'full' adds source, title, description, and OpenAPI version.
+     * - false disables banner generation.
      * @default 'simple'
      */
     defaultBanner?: 'simple' | 'full' | false;
@@ -401,17 +416,17 @@ type Config<TInput = Input> = {
     override?: boolean;
   };
   /**
-   * An array of Kubb plugins that will be used in the generation.
+   * An array of Kubb plugins that used in the generation.
    * Each plugin may include additional configurable options(defined in the plugin itself).
-   * If a plugin depends on another plugin, an error will be returned if the required dependency is missing. See pre for more details.
+   * If a plugin depends on another plugin, an error is returned if the required dependency is missing. See pre for more details.
    */
   plugins?: Array<Plugin>;
   /**
-   * Hooks that will be called when a specific action is triggered in Kubb.
+   * Hooks triggered when a specific action occurs in Kubb.
    */
   hooks?: {
     /**
-     * Hook that will be triggered at the end of all executions.
+     * Hook that triggers at the end of all executions.
      * Useful for running Prettier or ESLint to format/lint your code.
      */
     done?: string | Array<string>;
@@ -440,7 +455,7 @@ TContext = any,
 TResolvePathOptions extends object = object> = {
   name: TName;
   /**
-   * Same behaviour like what has been done with `QueryKey` in `@tanstack/react-query`
+   * Same behavior like what has been done with `QueryKey` in `@tanstack/react-query`
    */
   key: PluginKey<TName | string>;
   options: TOptions;
@@ -461,12 +476,12 @@ type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> =
    */
   options: TOptions['resolvedOptions'];
   /**
-   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin will be executed after these plugins.
+   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin is executed after these plugins.
    * Can be used to validate dependent plugins.
    */
   pre?: Array<string>;
   /**
-   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin will be executed before these plugins.
+   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin is executed before these plugins.
    */
   post?: Array<string>;
   inject?: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => TOptions['context'];
@@ -484,12 +499,12 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
    */
   key: TOptions['key'];
   /**
-   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin will be executed after these plugins.
+   * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin is executed after these plugins.
    * Can be used to validate dependent plugins.
    */
   pre?: Array<string>;
   /**
-   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin will be executed before these plugins.
+   * Specifies the succeeding plugins for the current plugin. You can pass an array of succeeding plugin names, and the current plugin is executed before these plugins.
    */
   post?: Array<string>;
   /**
@@ -539,10 +554,12 @@ type ResolveNameParams = {
   name: string;
   pluginKey?: Plugin['key'];
   /**
-   * `file` will be used to customize the name of the created file(use of camelCase)
-   * `function` can be used to customize the exported functions(use of camelCase)
-   * `type` is a special type for TypeScript(use of PascalCase)
-   * `const` can be used for variables(use of camelCase)
+   * Specifies the type of entity being named.
+   * - 'file' customizes the name of the created file (uses camelCase).
+   * - 'function' customizes the exported function names (uses camelCase).
+   * - 'type' customizes TypeScript types (uses PascalCase).
+   * - 'const' customizes variable names (uses camelCase).
+   * @default undefined
    */
   type?: 'file' | 'function' | 'type' | 'const';
 };
@@ -597,11 +614,14 @@ type GroupContext = {
 };
 type Group = {
   /**
-   * Define a type where to group the files on
+   * Defines the type where to group the files.
+   * - 'tag' groups files by OpenAPI tags.
+   * - 'path' groups files by OpenAPI paths.
+   * @default undefined
    */
   type: 'tag' | 'path';
   /**
-   * Return the name of a group based on the group name, this will be used for the file and name generation
+   * Return the name of a group based on the group name, this used for the file and name generation
    */
   name?: (context: GroupContext) => string;
 };
@@ -673,7 +693,7 @@ declare class PluginManager {
     parameters: PluginParameter<H>;
   }): Array<ReturnType<ParseResult<H>>> | null;
   /**
-   * First non-null result stops and will return it's value.
+   * Returns the first non-null result.
    */
   hookFirst<H extends PluginLifecycleHooks>({
     hookName,
@@ -685,7 +705,7 @@ declare class PluginManager {
     skipped?: ReadonlySet<Plugin> | null;
   }): Promise<SafeParseResult<H>>;
   /**
-   * First non-null result stops and will return it's value.
+   * Returns the first non-null result.
    */
   hookFirstSync<H extends PluginLifecycleHooks>({
     hookName,
@@ -697,15 +717,15 @@ declare class PluginManager {
     skipped?: ReadonlySet<Plugin> | null;
   }): SafeParseResult<H>;
   /**
-   * Run all plugins in parallel(order will be based on `this.plugin` and if `pre` or `post` is set).
+   * Runs all plugins in parallel based on `this.plugin` order and `pre`/`post` settings.
    */
-  hookParallel<H extends PluginLifecycleHooks, TOuput = void>({
+  hookParallel<H extends PluginLifecycleHooks, TOutput = void>({
     hookName,
     parameters
   }: {
     hookName: H;
     parameters?: Parameters<RequiredPluginLifecycle[H]> | undefined;
-  }): Promise<Awaited<TOuput>[]>;
+  }): Promise<Awaited<TOutput>[]>;
   /**
    * Chains plugins
    */
@@ -974,8 +994,8 @@ 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;
     };
@@ -1107,7 +1127,7 @@ 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
      */
@@ -1186,7 +1206,7 @@ type Options = {
   output?: Output<Oas>;
   /**
    * Define which contentType should be used.
-   * By default, the first JSON valid mediaType will be used
+   * By default, the first JSON valid mediaType is used
    */
   contentType?: contentType;
   /**
@@ -1211,16 +1231,17 @@ type Options = {
    */
   operations?: boolean;
   /**
-   * Export urls that are used by operation x
-   * `export` will make them part of your barrel file
-   * false will not make them exportable
+   * Export urls that are used by operation x.
+   * - 'export' makes them part of your barrel file.
+   * - false does not make them exportable.
+   * @default false
    * @example getGetPetByIdUrl
    */
   urlType?: 'export' | false;
   /**
-   * Path to the client import path that will be used to do the API calls.
-   * It will be used as `import client from '${client.importPath}'`.
-   * It allows both relative and absolute path but be aware that we will not change the path.
+   * Client import path for API calls.
+   * Used as `import client from '${client.importPath}'`.
+   * Accepts relative and absolute paths; path changes are not performed.
    */
   importPath?: string;
   /**
@@ -1228,49 +1249,50 @@ type Options = {
    */
   baseURL?: string;
   /**
-   * ReturnType that will be used when calling the client.
-   * - 'data' will return ResponseConfig[data].
-   * - 'full' will return ResponseConfig.
+   * ReturnType that is used when calling the client.
+   * - 'data' returns ResponseConfig[data].
+   * - 'full' returns ResponseConfig.
    * @default 'data'
    */
   dataReturnType?: 'data' | 'full';
   /**
    * How to style your params, by default no casing is applied
-   * - 'camelcase' will use camelcase for the params names
+   * - 'camelcase' uses camelcase for the params names
    */
   paramsCasing?: 'camelcase';
   /**
-   * How to pass your params
-   * - 'object' will return the params and pathParams as an object.
-   * - 'inline' will return the params as comma separated params.
+   * How to pass your params.
+   * - 'object' returns the params and pathParams as an object.
+   * - 'inline' returns the params as comma separated params.
    * @default 'inline'
    */
   paramsType?: 'object' | 'inline';
   /**
    * How to pass your pathParams.
-   * - 'object' will return the pathParams as an object.
-   * - 'inline' will return the pathParams as comma separated params.
+   * - 'object' returns the pathParams as an object.
+   * - 'inline' returns the pathParams as comma separated params.
    * @default 'inline'
    */
   pathParamsType?: 'object' | 'inline';
   /**
-   * Which parser can be used before returning the data
-   * - 'zod' will use `@kubb/plugin-zod` to parse the data.
+   * Which parser can be used before returning the data.
+   * - 'client' returns the data as-is from the client.
+   * - 'zod' uses @kubb/plugin-zod to parse the data.
    * @default 'client'
    */
   parser?: 'client' | 'zod';
   /**
-   * Which client should be used to do the HTTP calls
-   * - 'axios' will use `@kubb/plugin-client/templates/axios` to fetch data.
-   * - 'fetch' will use `@kubb/plugin-client/templates/fetch` to fetch data.
+   * Which client should be used to do the HTTP calls.
+   * - 'axios' uses axios client for HTTP requests.
+   * - 'fetch' uses native fetch API for HTTP requests.
    * @default 'axios'
    */
   client?: 'axios' | 'fetch';
   /**
-   * How to generate the client code
-   * - 'function' will generate standalone functions for each operation.
-   * - 'class' will generate a class with methods for each operation.
-   * - 'staticClass' will generate a class with static methods for each operation.
+   * How to generate the client code.
+   * - 'function' generates standalone functions for each operation.
+   * - 'class' generates a class with methods for each operation.
+   * - 'staticClass' generates a class with static methods for each operation.
    * @default 'function'
    */
   clientType?: 'function' | 'class' | 'staticClass';
@@ -1278,7 +1300,7 @@ type Options = {
    * Bundle the selected client into the generated `.kubb` directory.
    * When disabled the generated clients will import the shared runtime from `@kubb/plugin-client/clients/*`.
    * @default false
-   * In version 5 of Kubb this will be by default true
+   * In version 5 of Kubb this is by default true
    */
   bundle?: boolean;
   transformers?: {
@@ -1310,4 +1332,4 @@ type ResolvedOptions = {
 type PluginClient = PluginFactoryOptions<'plugin-client', Options, ResolvedOptions, never, ResolvePathOptions>;
 //#endregion
 export { UserPluginWithLifeCycle as a, OperationSchemas as i, PluginClient as n, Operation$1 as o, ReactGenerator as r, Options as t };
-//# sourceMappingURL=types-aqsuGVmg.d.ts.map
+//# sourceMappingURL=types-CEoiGmcV.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-client",
-  "version": "4.18.4",
+  "version": "4.19.0",
   "description": "API client generator plugin for Kubb, creating type-safe HTTP clients (Axios, Fetch) from OpenAPI specifications for making API requests.",
   "keywords": [
     "api-client",
@@ -87,14 +87,14 @@
   ],
   "dependencies": {
     "@kubb/react-fabric": "0.12.4",
-    "@kubb/core": "4.18.4",
-    "@kubb/oas": "4.18.4",
-    "@kubb/plugin-oas": "4.18.4",
-    "@kubb/plugin-ts": "4.18.4",
-    "@kubb/plugin-zod": "4.18.4"
+    "@kubb/core": "4.19.0",
+    "@kubb/oas": "4.19.0",
+    "@kubb/plugin-oas": "4.19.0",
+    "@kubb/plugin-ts": "4.19.0",
+    "@kubb/plugin-zod": "4.19.0"
   },
   "devDependencies": {
-    "axios": "^1.13.2"
+    "axios": "^1.13.3"
   },
   "peerDependencies": {
     "@kubb/react-fabric": "0.12.4",

package/src/types.ts

@@ -12,7 +12,7 @@ export type Options = {
   output?: Output<Oas>
   /**
    * Define which contentType should be used.
-   * By default, the first JSON valid mediaType will be used
+   * By default, the first JSON valid mediaType is used
    */
   contentType?: contentType
   /**
@@ -37,16 +37,17 @@ export type Options = {
    */
   operations?: boolean
   /**
-   * Export urls that are used by operation x
-   * `export` will make them part of your barrel file
-   * false will not make them exportable
+   * Export urls that are used by operation x.
+   * - 'export' makes them part of your barrel file.
+   * - false does not make them exportable.
+   * @default false
    * @example getGetPetByIdUrl
    */
   urlType?: 'export' | false
   /**
-   * Path to the client import path that will be used to do the API calls.
-   * It will be used as `import client from '${client.importPath}'`.
-   * It allows both relative and absolute path but be aware that we will not change the path.
+   * Client import path for API calls.
+   * Used as `import client from '${client.importPath}'`.
+   * Accepts relative and absolute paths; path changes are not performed.
    */
   importPath?: string
   /**
@@ -54,49 +55,50 @@ export type Options = {
    */
   baseURL?: string
   /**
-   * ReturnType that will be used when calling the client.
-   * - 'data' will return ResponseConfig[data].
-   * - 'full' will return ResponseConfig.
+   * ReturnType that is used when calling the client.
+   * - 'data' returns ResponseConfig[data].
+   * - 'full' returns ResponseConfig.
    * @default 'data'
    */
   dataReturnType?: 'data' | 'full'
   /**
    * How to style your params, by default no casing is applied
-   * - 'camelcase' will use camelcase for the params names
+   * - 'camelcase' uses camelcase for the params names
    */
   paramsCasing?: 'camelcase'
   /**
-   * How to pass your params
-   * - 'object' will return the params and pathParams as an object.
-   * - 'inline' will return the params as comma separated params.
+   * How to pass your params.
+   * - 'object' returns the params and pathParams as an object.
+   * - 'inline' returns the params as comma separated params.
    * @default 'inline'
    */
   paramsType?: 'object' | 'inline'
   /**
    * How to pass your pathParams.
-   * - 'object' will return the pathParams as an object.
-   * - 'inline' will return the pathParams as comma separated params.
+   * - 'object' returns the pathParams as an object.
+   * - 'inline' returns the pathParams as comma separated params.
    * @default 'inline'
    */
   pathParamsType?: 'object' | 'inline'
   /**
-   * Which parser can be used before returning the data
-   * - 'zod' will use `@kubb/plugin-zod` to parse the data.
+   * Which parser can be used before returning the data.
+   * - 'client' returns the data as-is from the client.
+   * - 'zod' uses @kubb/plugin-zod to parse the data.
    * @default 'client'
    */
   parser?: 'client' | 'zod'
   /**
-   * Which client should be used to do the HTTP calls
-   * - 'axios' will use `@kubb/plugin-client/templates/axios` to fetch data.
-   * - 'fetch' will use `@kubb/plugin-client/templates/fetch` to fetch data.
+   * Which client should be used to do the HTTP calls.
+   * - 'axios' uses axios client for HTTP requests.
+   * - 'fetch' uses native fetch API for HTTP requests.
    * @default 'axios'
    */
   client?: 'axios' | 'fetch'
   /**
-   * How to generate the client code
-   * - 'function' will generate standalone functions for each operation.
-   * - 'class' will generate a class with methods for each operation.
-   * - 'staticClass' will generate a class with static methods for each operation.
+   * How to generate the client code.
+   * - 'function' generates standalone functions for each operation.
+   * - 'class' generates a class with methods for each operation.
+   * - 'staticClass' generates a class with static methods for each operation.
    * @default 'function'
    */
   clientType?: 'function' | 'class' | 'staticClass'
@@ -104,7 +106,7 @@ export type Options = {
    * Bundle the selected client into the generated `.kubb` directory.
    * When disabled the generated clients will import the shared runtime from `@kubb/plugin-client/clients/*`.
    * @default false
-   * In version 5 of Kubb this will be by default true
+   * In version 5 of Kubb this is by default true
    */
   bundle?: boolean
   transformers?: {