@kubb/plugin-zod 0.0.0-canary-20251209191624 → 0.0.0-canary-20251217084347

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

@@ -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-BIZhZG2K.d.ts.map

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

@@ -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-BNjvGwN4.d.cts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-zod",
-  "version": "0.0.0-canary-20251209191624",
+  "version": "0.0.0-canary-20251217084347",
   "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": "0.0.0-canary-20251209191624",
-    "@kubb/oas": "0.0.0-canary-20251209191624",
-    "@kubb/plugin-oas": "0.0.0-canary-20251209191624",
-    "@kubb/plugin-ts": "0.0.0-canary-20251209191624"
+    "@kubb/core": "0.0.0-canary-20251217084347",
+    "@kubb/oas": "0.0.0-canary-20251217084347",
+    "@kubb/plugin-oas": "0.0.0-canary-20251217084347",
+    "@kubb/plugin-ts": "0.0.0-canary-20251217084347"
   },
   "devDependencies": {
     "@asteasolutions/zod-to-openapi": "^8.2.0",
     "@hono/zod-openapi": "0.19.2",
     "zod": "^3.25.76",
-    "@kubb/plugin-oas": "0.0.0-canary-20251209191624"
+    "@kubb/plugin-oas": "0.0.0-canary-20251217084347"
   },
   "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,
     })