@kubb/plugin-zod 4.11.1 → 4.11.3

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as UserPluginWithLifeCycle, n as PluginZod, t as Options } from "./types-BJRQY0iM.js";
+import { a as UserPluginWithLifeCycle, n as PluginZod, t as Options } from "./types-BIZhZG2K.js";
 
 //#region src/plugin.d.ts
 declare const pluginZodName = "plugin-zod";

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as operationsGenerator, t as zodGenerator } from "./generators-DKQPsBns.js";
+import { n as operationsGenerator, t as zodGenerator } from "./generators-Df7mE4WQ.js";
 import path from "node:path";
 import { PackageManager, definePlugin, getBarrelFiles, getMode } from "@kubb/core";
 import { camelCase, pascalCase } from "@kubb/core/transformers";
@@ -79,6 +79,7 @@ const pluginZod = definePlugin((options) => {
 				fabric: this.fabric,
 				oas,
 				pluginManager: this.pluginManager,
+				logger: this.logger,
 				plugin: this.plugin,
 				contentType,
 				include: void 0,
@@ -91,6 +92,7 @@ const pluginZod = definePlugin((options) => {
 				fabric: this.fabric,
 				oas,
 				pluginManager: this.pluginManager,
+				logger: this.logger,
 				plugin: this.plugin,
 				contentType,
 				exclude,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["options","groupName: Group['name']","transformers"],"sources":["../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { definePlugin, type Group, getBarrelFiles, getMode, PackageManager } from '@kubb/core'\nimport { camelCase, pascalCase } from '@kubb/core/transformers'\nimport { resolveModuleSource } from '@kubb/core/utils'\nimport { OperationGenerator, pluginOasName, SchemaGenerator } from '@kubb/plugin-oas'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { operationsGenerator } from './generators'\nimport { zodGenerator } from './generators/zodGenerator.tsx'\nimport type { PluginZod } from './types.ts'\n\nexport const pluginZodName = 'plugin-zod' satisfies PluginZod['name']\n\nexport const pluginZod = definePlugin<PluginZod>((options) => {\n  const {\n    output = { path: 'zod', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    transformers = {},\n    dateType = 'string',\n    unknownType = 'any',\n    emptySchemaType = unknownType,\n    typed = false,\n    mapper = {},\n    operations = false,\n    mini = false,\n    version = mini ? '4' : new PackageManager().isValidSync('zod', '>=4') ? '4' : '3',\n    importPath = mini ? 'zod/mini' : version === '4' ? 'zod/v4' : 'zod',\n    coercion = false,\n    inferred = false,\n    generators = [zodGenerator, operations ? operationsGenerator : undefined].filter(Boolean),\n    wrapOutput = undefined,\n    contentType,\n  } = options\n\n  const usedEnumNames = {}\n\n  return {\n    name: pluginZodName,\n    options: {\n      output,\n      transformers,\n      include,\n      exclude,\n      override,\n      typed,\n      dateType,\n      unknownType,\n      emptySchemaType,\n      mapper,\n      importPath,\n      coercion,\n      operations,\n      inferred,\n      group,\n      wrapOutput,\n      version,\n      mini,\n      usedEnumNames,\n    },\n    pre: [pluginOasName, typed ? pluginTsName : undefined].filter(Boolean),\n    resolvePath(baseName, pathMode, options) {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = pathMode ?? getMode(path.resolve(root, output.path))\n\n      if (mode === 'single') {\n        /**\n         * when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend\n         * Other plugins then need to call addOrAppend instead of just add from the fileManager class\n         */\n        return path.resolve(root, output.path)\n      }\n\n      if (group && (options?.group?.path || options?.group?.tag)) {\n        const groupName: Group['name'] = group?.name\n          ? group.name\n          : (ctx) => {\n              if (group?.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            }\n\n        return path.resolve(\n          root,\n          output.path,\n          groupName({\n            group: group.type === 'path' ? options.group.path! : options.group.tag!,\n          }),\n          baseName,\n        )\n      }\n\n      return path.resolve(root, output.path, baseName)\n    },\n    resolveName(name, type) {\n      let resolvedName = camelCase(name, {\n        suffix: type ? 'schema' : undefined,\n        isFile: type === 'file',\n      })\n\n      if (type === 'type') {\n        resolvedName = pascalCase(resolvedName)\n      }\n\n      if (type) {\n        return transformers?.name?.(resolvedName, type) || resolvedName\n      }\n\n      return resolvedName\n    },\n    async install() {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = getMode(path.resolve(root, output.path))\n      const oas = await this.getOas()\n\n      if (this.plugin.options.typed && this.plugin.options.version === '3') {\n        // pre add bundled\n        await this.addFile({\n          baseName: 'ToZod.ts',\n          path: path.resolve(root, '.kubb/ToZod.ts'),\n          sources: [\n            {\n              name: 'ToZod',\n              value: resolveModuleSource('@kubb/plugin-zod/templates/ToZod').source,\n            },\n          ],\n        })\n      }\n\n      const schemaGenerator = new SchemaGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        pluginManager: this.pluginManager,\n        plugin: this.plugin,\n        contentType,\n        include: undefined,\n        override,\n        mode,\n        output: output.path,\n      })\n\n      const schemaFiles = await schemaGenerator.build(...generators)\n      await this.upsertFile(...schemaFiles)\n\n      const operationGenerator = new OperationGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        pluginManager: this.pluginManager,\n        plugin: this.plugin,\n        contentType,\n        exclude,\n        include,\n        override,\n        mode,\n      })\n\n      const operationFiles = await operationGenerator.build(...generators)\n      await this.upsertFile(...operationFiles)\n\n      const barrelFiles = await getBarrelFiles(this.fabric.files, {\n        type: output.barrelType ?? 'named',\n        root,\n        output,\n        meta: {\n          pluginKey: this.plugin.key,\n        },\n        logger: this.logger,\n      })\n\n      await this.upsertFile(...barrelFiles)\n    },\n  }\n})\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["options","groupName: Group['name']","transformers"],"sources":["../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { definePlugin, type Group, getBarrelFiles, getMode, PackageManager } from '@kubb/core'\nimport { camelCase, pascalCase } from '@kubb/core/transformers'\nimport { resolveModuleSource } from '@kubb/core/utils'\nimport { OperationGenerator, pluginOasName, SchemaGenerator } from '@kubb/plugin-oas'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { operationsGenerator } from './generators'\nimport { zodGenerator } from './generators/zodGenerator.tsx'\nimport type { PluginZod } from './types.ts'\n\nexport const pluginZodName = 'plugin-zod' satisfies PluginZod['name']\n\nexport const pluginZod = definePlugin<PluginZod>((options) => {\n  const {\n    output = { path: 'zod', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    transformers = {},\n    dateType = 'string',\n    unknownType = 'any',\n    emptySchemaType = unknownType,\n    typed = false,\n    mapper = {},\n    operations = false,\n    mini = false,\n    version = mini ? '4' : new PackageManager().isValidSync('zod', '>=4') ? '4' : '3',\n    importPath = mini ? 'zod/mini' : version === '4' ? 'zod/v4' : 'zod',\n    coercion = false,\n    inferred = false,\n    generators = [zodGenerator, operations ? operationsGenerator : undefined].filter(Boolean),\n    wrapOutput = undefined,\n    contentType,\n  } = options\n\n  const usedEnumNames = {}\n\n  return {\n    name: pluginZodName,\n    options: {\n      output,\n      transformers,\n      include,\n      exclude,\n      override,\n      typed,\n      dateType,\n      unknownType,\n      emptySchemaType,\n      mapper,\n      importPath,\n      coercion,\n      operations,\n      inferred,\n      group,\n      wrapOutput,\n      version,\n      mini,\n      usedEnumNames,\n    },\n    pre: [pluginOasName, typed ? pluginTsName : undefined].filter(Boolean),\n    resolvePath(baseName, pathMode, options) {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = pathMode ?? getMode(path.resolve(root, output.path))\n\n      if (mode === 'single') {\n        /**\n         * when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend\n         * Other plugins then need to call addOrAppend instead of just add from the fileManager class\n         */\n        return path.resolve(root, output.path)\n      }\n\n      if (group && (options?.group?.path || options?.group?.tag)) {\n        const groupName: Group['name'] = group?.name\n          ? group.name\n          : (ctx) => {\n              if (group?.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            }\n\n        return path.resolve(\n          root,\n          output.path,\n          groupName({\n            group: group.type === 'path' ? options.group.path! : options.group.tag!,\n          }),\n          baseName,\n        )\n      }\n\n      return path.resolve(root, output.path, baseName)\n    },\n    resolveName(name, type) {\n      let resolvedName = camelCase(name, {\n        suffix: type ? 'schema' : undefined,\n        isFile: type === 'file',\n      })\n\n      if (type === 'type') {\n        resolvedName = pascalCase(resolvedName)\n      }\n\n      if (type) {\n        return transformers?.name?.(resolvedName, type) || resolvedName\n      }\n\n      return resolvedName\n    },\n    async install() {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = getMode(path.resolve(root, output.path))\n      const oas = await this.getOas()\n\n      if (this.plugin.options.typed && this.plugin.options.version === '3') {\n        // pre add bundled\n        await this.addFile({\n          baseName: 'ToZod.ts',\n          path: path.resolve(root, '.kubb/ToZod.ts'),\n          sources: [\n            {\n              name: 'ToZod',\n              value: resolveModuleSource('@kubb/plugin-zod/templates/ToZod').source,\n            },\n          ],\n        })\n      }\n\n      const schemaGenerator = new SchemaGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        pluginManager: this.pluginManager,\n        logger: this.logger,\n        plugin: this.plugin,\n        contentType,\n        include: undefined,\n        override,\n        mode,\n        output: output.path,\n      })\n\n      const schemaFiles = await schemaGenerator.build(...generators)\n      await this.upsertFile(...schemaFiles)\n\n      const operationGenerator = new OperationGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        pluginManager: this.pluginManager,\n        logger: this.logger,\n        plugin: this.plugin,\n        contentType,\n        exclude,\n        include,\n        override,\n        mode,\n      })\n\n      const operationFiles = await operationGenerator.build(...generators)\n      await this.upsertFile(...operationFiles)\n\n      const barrelFiles = await getBarrelFiles(this.fabric.files, {\n        type: output.barrelType ?? 'named',\n        root,\n        output,\n        meta: {\n          pluginKey: this.plugin.key,\n        },\n        logger: this.logger,\n      })\n\n      await this.upsertFile(...barrelFiles)\n    },\n  }\n})\n"],"mappings":"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"}

package/dist/{types-DL8vhJwK.d.cts → types-BIZhZG2K.d.ts}

@@ -1,3 +1,4 @@
+import { Fabric } from "@kubb/react-fabric";
 import * as OasTypes from "oas/types";
 import { HttpMethods as HttpMethod, OASDocument, SchemaObject, User } from "oas/types";
 import { Operation, Operation as Operation$1 } from "oas/operation";
@@ -5,7 +6,6 @@ import { OpenAPIV3 } from "openapi-types";
 import * as oas_normalize_lib_types0 from "oas-normalize/lib/types";
 import BaseOas from "oas";
 import { KubbFile } from "@kubb/fabric-core/types";
-import { Fabric } from "@kubb/react-fabric";
 import { ConsolaInstance, LogLevel } from "consola";
 import { KubbNode } from "@kubb/react-fabric/types";
 
@@ -73,13 +73,35 @@ type DebugEvent = {
   date: Date;
   logs: string[];
   fileName?: string;
+  /**
+   * Category of the debug log, used for GitHub Actions grouping
+   * - 'setup': Initial configuration and environment setup
+   * - 'plugin': Plugin installation and execution
+   * - 'hook': Plugin hook execution details
+   * - 'schema': Schema parsing and generation
+   * - 'file': File operations (read/write/generate)
+   * - 'error': Error details and stack traces
+   * - undefined: Generic logs (always inline)
+   */
+  category?: 'setup' | 'plugin' | 'hook' | 'schema' | 'file' | 'error';
+  /**
+   * Plugin name for grouping plugin-specific logs together
+   */
+  pluginName?: string;
+  /**
+   * Indicates if this is the start or end of a plugin's execution
+   * - 'start': Start of plugin execution group
+   * - 'end': End of plugin execution group
+   */
+  pluginGroupMarker?: 'start' | 'end';
 };
 type Events$1 = {
   start: [message: string];
   success: [message: string];
-  error: [message: string, cause: Error];
+  error: [message: string, error: Error];
   warning: [message: string];
   debug: [DebugEvent];
+  verbose: [DebugEvent];
   info: [message: string];
   progress_start: [{
     id: string;
@@ -103,7 +125,7 @@ type Logger = {
   consola?: ConsolaInstance;
   on: EventEmitter<Events$1>['on'];
   emit: EventEmitter<Events$1>['emit'];
-  writeLogs: () => Promise<string[]>;
+  writeLogs: () => Promise<void>;
 };
 //#endregion
 //#region ../core/src/utils/types.d.ts
@@ -414,14 +436,35 @@ type Group = {
 //#region ../core/src/PluginManager.d.ts
 type RequiredPluginLifecycle = Required<PluginLifecycle>;
 type Strategy = 'hookFirst' | 'hookForPlugin' | 'hookParallel' | 'hookSeq';
-type Executer<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
-  message: string;
+type ExecutingMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  strategy: Strategy;
+  hookName: H;
+  plugin: Plugin;
+  parameters?: unknown[] | undefined;
+  output?: unknown;
+};
+type ExecutedMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  duration: number;
   strategy: Strategy;
   hookName: H;
   plugin: Plugin;
   parameters?: unknown[] | undefined;
   output?: unknown;
 };
+type ErrorMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  hookName: H;
+  duration: number;
+  strategy: Strategy;
+  parameters?: unknown[] | undefined;
+  plugin: Plugin;
+};
+type ProgressStartMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  hookName: H;
+  plugins: Array<Plugin>;
+};
+type ProgressStopMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  hookName: H;
+};
 type ParseResult<H extends PluginLifecycleHooks> = RequiredPluginLifecycle[H];
 type SafeParseResult<H extends PluginLifecycleHooks, Result = ReturnType<ParseResult<H>>> = {
   result: Result;
@@ -436,9 +479,11 @@ type Options$1 = {
   concurrency?: number;
 };
 type Events = {
-  executing: [executer: Executer];
-  executed: [executer: Executer];
-  error: [error: Error];
+  progress_start: [meta: ProgressStartMeta];
+  progress_stop: [meta: ProgressStopMeta];
+  executing: [meta: ExecutingMeta];
+  executed: [meta: ExecutedMeta];
+  error: [error: Error, meta: ErrorMeta];
 };
 type GetFileProps<TOptions = object> = {
   name: string;
@@ -451,8 +496,6 @@ declare class PluginManager {
   #private;
   readonly events: EventEmitter<Events>;
   readonly config: Config;
-  readonly executed: Array<Executer>;
-  readonly logger: Logger;
   readonly options: Options$1;
   constructor(config: Config, options: Options$1);
   getContext<TOptions extends PluginFactoryOptions>(plugin: Plugin<TOptions>): PluginContext<TOptions> & Record<string, any>;
@@ -478,13 +521,11 @@ declare class PluginManager {
   hookForPlugin<H extends PluginLifecycleHooks>({
     pluginKey,
     hookName,
-    parameters,
-    message
+    parameters
   }: {
     pluginKey: Plugin['key'];
     hookName: H;
     parameters: PluginParameter<H>;
-    message: string;
   }): Promise<Array<ReturnType<ParseResult<H>> | null>>;
   /**
    * Run a specific hookName for plugin x.
@@ -492,13 +533,11 @@ declare class PluginManager {
   hookForPluginSync<H extends PluginLifecycleHooks>({
     pluginKey,
     hookName,
-    parameters,
-    message
+    parameters
   }: {
     pluginKey: Plugin['key'];
     hookName: H;
     parameters: PluginParameter<H>;
-    message: string;
   }): Array<ReturnType<ParseResult<H>>> | null;
   /**
    * First non-null result stops and will return it's value.
@@ -506,13 +545,11 @@ declare class PluginManager {
   hookFirst<H extends PluginLifecycleHooks>({
     hookName,
     parameters,
-    skipped,
-    message
+    skipped
   }: {
     hookName: H;
     parameters: PluginParameter<H>;
     skipped?: ReadonlySet<Plugin> | null;
-    message: string;
   }): Promise<SafeParseResult<H>>;
   /**
    * First non-null result stops and will return it's value.
@@ -520,37 +557,31 @@ declare class PluginManager {
   hookFirstSync<H extends PluginLifecycleHooks>({
     hookName,
     parameters,
-    skipped,
-    message
+    skipped
   }: {
     hookName: H;
     parameters: PluginParameter<H>;
     skipped?: ReadonlySet<Plugin> | null;
-    message: string;
   }): SafeParseResult<H>;
   /**
    * Run all plugins in parallel(order will be based on `this.plugin` and if `pre` or `post` is set).
    */
   hookParallel<H extends PluginLifecycleHooks, TOuput = void>({
     hookName,
-    parameters,
-    message
+    parameters
   }: {
     hookName: H;
     parameters?: Parameters<RequiredPluginLifecycle[H]> | undefined;
-    message: string;
   }): Promise<Awaited<TOuput>[]>;
   /**
    * Chains plugins
    */
   hookSeq<H extends PluginLifecycleHooks>({
     hookName,
-    parameters,
-    message
+    parameters
   }: {
     hookName: H;
     parameters?: PluginParameter<H>;
-    message: string;
   }): Promise<void>;
   getPluginByKey(pluginKey: Plugin['key']): Plugin | undefined;
   getPluginsByKey(hookName: keyof PluginWithLifeCycle, pluginKey: Plugin['key']): Plugin[];
@@ -880,6 +911,7 @@ type Context$1<TOptions, TPluginOptions extends PluginFactoryOptions> = {
   fabric: Fabric;
   oas: Oas;
   pluginManager: PluginManager;
+  logger?: Logger;
   /**
    * Current plugin
    */
@@ -984,6 +1016,7 @@ type Context<TOptions, TPluginOptions extends PluginFactoryOptions> = {
   override: Array<Override<TOptions>> | undefined;
   contentType: contentType | undefined;
   pluginManager: PluginManager;
+  logger?: Logger;
   /**
    * Current plugin
    */
@@ -1140,4 +1173,4 @@ type ResolvedOptions = {
 type PluginZod = PluginFactoryOptions<'plugin-zod', Options, ResolvedOptions, never, ResolvePathOptions>;
 //#endregion
 export { UserPluginWithLifeCycle as a, Schema as i, PluginZod as n, Operation$1 as o, ReactGenerator as r, SchemaObject$1 as s, Options as t };
-//# sourceMappingURL=types-DL8vhJwK.d.cts.map
+//# sourceMappingURL=types-BIZhZG2K.d.ts.map

package/dist/{types-BJRQY0iM.d.ts → types-BNjvGwN4.d.cts}

@@ -1,4 +1,3 @@
-import { Fabric } from "@kubb/react-fabric";
 import * as OasTypes from "oas/types";
 import { HttpMethods as HttpMethod, OASDocument, SchemaObject, User } from "oas/types";
 import { Operation, Operation as Operation$1 } from "oas/operation";
@@ -6,6 +5,7 @@ import { OpenAPIV3 } from "openapi-types";
 import * as oas_normalize_lib_types0 from "oas-normalize/lib/types";
 import BaseOas from "oas";
 import { KubbFile } from "@kubb/fabric-core/types";
+import { Fabric } from "@kubb/react-fabric";
 import { ConsolaInstance, LogLevel } from "consola";
 import { KubbNode } from "@kubb/react-fabric/types";
 
@@ -73,13 +73,35 @@ type DebugEvent = {
   date: Date;
   logs: string[];
   fileName?: string;
+  /**
+   * Category of the debug log, used for GitHub Actions grouping
+   * - 'setup': Initial configuration and environment setup
+   * - 'plugin': Plugin installation and execution
+   * - 'hook': Plugin hook execution details
+   * - 'schema': Schema parsing and generation
+   * - 'file': File operations (read/write/generate)
+   * - 'error': Error details and stack traces
+   * - undefined: Generic logs (always inline)
+   */
+  category?: 'setup' | 'plugin' | 'hook' | 'schema' | 'file' | 'error';
+  /**
+   * Plugin name for grouping plugin-specific logs together
+   */
+  pluginName?: string;
+  /**
+   * Indicates if this is the start or end of a plugin's execution
+   * - 'start': Start of plugin execution group
+   * - 'end': End of plugin execution group
+   */
+  pluginGroupMarker?: 'start' | 'end';
 };
 type Events$1 = {
   start: [message: string];
   success: [message: string];
-  error: [message: string, cause: Error];
+  error: [message: string, error: Error];
   warning: [message: string];
   debug: [DebugEvent];
+  verbose: [DebugEvent];
   info: [message: string];
   progress_start: [{
     id: string;
@@ -103,7 +125,7 @@ type Logger = {
   consola?: ConsolaInstance;
   on: EventEmitter<Events$1>['on'];
   emit: EventEmitter<Events$1>['emit'];
-  writeLogs: () => Promise<string[]>;
+  writeLogs: () => Promise<void>;
 };
 //#endregion
 //#region ../core/src/utils/types.d.ts
@@ -414,14 +436,35 @@ type Group = {
 //#region ../core/src/PluginManager.d.ts
 type RequiredPluginLifecycle = Required<PluginLifecycle>;
 type Strategy = 'hookFirst' | 'hookForPlugin' | 'hookParallel' | 'hookSeq';
-type Executer<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
-  message: string;
+type ExecutingMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  strategy: Strategy;
+  hookName: H;
+  plugin: Plugin;
+  parameters?: unknown[] | undefined;
+  output?: unknown;
+};
+type ExecutedMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  duration: number;
   strategy: Strategy;
   hookName: H;
   plugin: Plugin;
   parameters?: unknown[] | undefined;
   output?: unknown;
 };
+type ErrorMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  hookName: H;
+  duration: number;
+  strategy: Strategy;
+  parameters?: unknown[] | undefined;
+  plugin: Plugin;
+};
+type ProgressStartMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  hookName: H;
+  plugins: Array<Plugin>;
+};
+type ProgressStopMeta<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
+  hookName: H;
+};
 type ParseResult<H extends PluginLifecycleHooks> = RequiredPluginLifecycle[H];
 type SafeParseResult<H extends PluginLifecycleHooks, Result = ReturnType<ParseResult<H>>> = {
   result: Result;
@@ -436,9 +479,11 @@ type Options$1 = {
   concurrency?: number;
 };
 type Events = {
-  executing: [executer: Executer];
-  executed: [executer: Executer];
-  error: [error: Error];
+  progress_start: [meta: ProgressStartMeta];
+  progress_stop: [meta: ProgressStopMeta];
+  executing: [meta: ExecutingMeta];
+  executed: [meta: ExecutedMeta];
+  error: [error: Error, meta: ErrorMeta];
 };
 type GetFileProps<TOptions = object> = {
   name: string;
@@ -451,8 +496,6 @@ declare class PluginManager {
   #private;
   readonly events: EventEmitter<Events>;
   readonly config: Config;
-  readonly executed: Array<Executer>;
-  readonly logger: Logger;
   readonly options: Options$1;
   constructor(config: Config, options: Options$1);
   getContext<TOptions extends PluginFactoryOptions>(plugin: Plugin<TOptions>): PluginContext<TOptions> & Record<string, any>;
@@ -478,13 +521,11 @@ declare class PluginManager {
   hookForPlugin<H extends PluginLifecycleHooks>({
     pluginKey,
     hookName,
-    parameters,
-    message
+    parameters
   }: {
     pluginKey: Plugin['key'];
     hookName: H;
     parameters: PluginParameter<H>;
-    message: string;
   }): Promise<Array<ReturnType<ParseResult<H>> | null>>;
   /**
    * Run a specific hookName for plugin x.
@@ -492,13 +533,11 @@ declare class PluginManager {
   hookForPluginSync<H extends PluginLifecycleHooks>({
     pluginKey,
     hookName,
-    parameters,
-    message
+    parameters
   }: {
     pluginKey: Plugin['key'];
     hookName: H;
     parameters: PluginParameter<H>;
-    message: string;
   }): Array<ReturnType<ParseResult<H>>> | null;
   /**
    * First non-null result stops and will return it's value.
@@ -506,13 +545,11 @@ declare class PluginManager {
   hookFirst<H extends PluginLifecycleHooks>({
     hookName,
     parameters,
-    skipped,
-    message
+    skipped
   }: {
     hookName: H;
     parameters: PluginParameter<H>;
     skipped?: ReadonlySet<Plugin> | null;
-    message: string;
   }): Promise<SafeParseResult<H>>;
   /**
    * First non-null result stops and will return it's value.
@@ -520,37 +557,31 @@ declare class PluginManager {
   hookFirstSync<H extends PluginLifecycleHooks>({
     hookName,
     parameters,
-    skipped,
-    message
+    skipped
   }: {
     hookName: H;
     parameters: PluginParameter<H>;
     skipped?: ReadonlySet<Plugin> | null;
-    message: string;
   }): SafeParseResult<H>;
   /**
    * Run all plugins in parallel(order will be based on `this.plugin` and if `pre` or `post` is set).
    */
   hookParallel<H extends PluginLifecycleHooks, TOuput = void>({
     hookName,
-    parameters,
-    message
+    parameters
   }: {
     hookName: H;
     parameters?: Parameters<RequiredPluginLifecycle[H]> | undefined;
-    message: string;
   }): Promise<Awaited<TOuput>[]>;
   /**
    * Chains plugins
    */
   hookSeq<H extends PluginLifecycleHooks>({
     hookName,
-    parameters,
-    message
+    parameters
   }: {
     hookName: H;
     parameters?: PluginParameter<H>;
-    message: string;
   }): Promise<void>;
   getPluginByKey(pluginKey: Plugin['key']): Plugin | undefined;
   getPluginsByKey(hookName: keyof PluginWithLifeCycle, pluginKey: Plugin['key']): Plugin[];
@@ -880,6 +911,7 @@ type Context$1<TOptions, TPluginOptions extends PluginFactoryOptions> = {
   fabric: Fabric;
   oas: Oas;
   pluginManager: PluginManager;
+  logger?: Logger;
   /**
    * Current plugin
    */
@@ -984,6 +1016,7 @@ type Context<TOptions, TPluginOptions extends PluginFactoryOptions> = {
   override: Array<Override<TOptions>> | undefined;
   contentType: contentType | undefined;
   pluginManager: PluginManager;
+  logger?: Logger;
   /**
    * Current plugin
    */
@@ -1140,4 +1173,4 @@ type ResolvedOptions = {
 type PluginZod = PluginFactoryOptions<'plugin-zod', Options, ResolvedOptions, never, ResolvePathOptions>;
 //#endregion
 export { UserPluginWithLifeCycle as a, Schema as i, PluginZod as n, Operation$1 as o, ReactGenerator as r, SchemaObject$1 as s, Options as t };
-//# sourceMappingURL=types-BJRQY0iM.d.ts.map
+//# sourceMappingURL=types-BNjvGwN4.d.cts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-zod",
-  "version": "4.11.1",
+  "version": "4.11.3",
   "description": "Zod schema generator plugin for Kubb, creating type-safe validation schemas from OpenAPI specifications for runtime data validation.",
   "keywords": [
     "zod",
@@ -69,16 +69,16 @@
   ],
   "dependencies": {
     "@kubb/react-fabric": "0.5.4",
-    "@kubb/core": "4.11.1",
-    "@kubb/oas": "4.11.1",
-    "@kubb/plugin-oas": "4.11.1",
-    "@kubb/plugin-ts": "4.11.1"
+    "@kubb/core": "4.11.3",
+    "@kubb/oas": "4.11.3",
+    "@kubb/plugin-oas": "4.11.3",
+    "@kubb/plugin-ts": "4.11.3"
   },
   "devDependencies": {
     "@asteasolutions/zod-to-openapi": "^8.2.0",
     "@hono/zod-openapi": "0.19.2",
     "zod": "^3.25.76",
-    "@kubb/plugin-oas": "4.11.1"
+    "@kubb/plugin-oas": "4.11.3"
   },
   "engines": {
     "node": ">=20"

package/src/generators/zodGenerator.tsx

@@ -31,6 +31,7 @@ export const zodGenerator = createReactGenerator<PluginZod>({
       oas,
       plugin,
       pluginManager,
+      logger: generator.context.logger,
       mode,
       override: options.override,
     })

package/src/parser.ts

@@ -303,11 +303,20 @@ const zodKeywordMapper = {
     }
     return '.optional()'
   },
-  matches: (value = '', coercion?: boolean, mini?: boolean) => {
+  matches: (value = '', coercion?: boolean, mini?: boolean, min?: number, max?: number) => {
     if (mini) {
-      return `z.string().check(z.regex(${value}))`
+      const checks = buildLengthChecks(min, max)
+      checks.push(`z.regex(${value})`)
+      return `z.string().check(${checks.join(', ')})`
     }
-    return coercion ? `z.coerce.string().regex(${value})` : `z.string().regex(${value})`
+    return [
+      coercion ? 'z.coerce.string()' : 'z.string()',
+      min !== undefined ? `.min(${min})` : undefined,
+      max !== undefined ? `.max(${max})` : undefined,
+      `.regex(${value})`,
+    ]
+      .filter(Boolean)
+      .join('')
   },
   email: (coercion?: boolean, version: '3' | '4' = '3', min?: number, max?: number, mini?: boolean) => {
     if (mini) {
@@ -739,8 +748,11 @@ export const parse = createParser<string, ParserOptions>({
         return undefined // strip matches
       }
 
+      const minSchema = findSchemaKeyword(siblings, 'min')
+      const maxSchema = findSchemaKeyword(siblings, 'max')
+
       if (current.args) {
-        return zodKeywordMapper.matches(transformers.toRegExpString(current.args, null), shouldCoerce(options.coercion, 'strings'), options.mini)
+        return zodKeywordMapper.matches(transformers.toRegExpString(current.args, null), shouldCoerce(options.coercion, 'strings'), options.mini, minSchema?.args, maxSchema?.args)
       }
       return undefined
     },

package/src/plugin.ts

@@ -133,6 +133,7 @@ export const pluginZod = definePlugin<PluginZod>((options) => {
         fabric: this.fabric,
         oas,
         pluginManager: this.pluginManager,
+        logger: this.logger,
         plugin: this.plugin,
         contentType,
         include: undefined,
@@ -148,6 +149,7 @@ export const pluginZod = definePlugin<PluginZod>((options) => {
         fabric: this.fabric,
         oas,
         pluginManager: this.pluginManager,
+        logger: this.logger,
         plugin: this.plugin,
         contentType,
         exclude,