@kubb/core 5.0.0-alpha.39 → 5.0.0-alpha.40

package/dist/index.cjs

@@ -585,7 +585,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version = "5.0.0-alpha.39";
+var version = "5.0.0-alpha.40";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { $ as FileManager, A as PluginParameter, B as ResolverFileParams, C as Output, D as PluginFactoryOptions, E as PluginContext, F as ResolveOptionsContext, G as UserPlugin, H as SchemaHook, I as ResolvePathOptions, J as Kubb, K as UserPluginWithLifeCycle, L as ResolvePathParams, M as PossibleConfig, N as ResolveBannerContext, O as PluginLifecycle, P as ResolveNameParams, Q as PluginDriver, R as Resolver, S as OperationsHook, T as Plugin, U as UserGroup, V as ResolverPathParams, W as UserLogger, X as BuildOutput, Y as KubbHooks, Z as createKubb, _ as KubbPluginSetupContext, a as CLIOptions, at as Generator, b as LoggerOptions, c as DevtoolsOptions, ct as createStorage, d as Group, dt as createRenderer, et as HookStylePlugin, f as Include, ft as logLevel, g as KubbBuildStartContext, h as KubbBuildEndContext, i as BarrelType, it as defineParser, j as PluginWithLifeCycle, k as PluginLifecycleHooks, l as Exclude, lt as Renderer, m as InputPath, n as AdapterFactoryOptions, nt as definePlugin, o as CompatibilityPreset, ot as defineGenerator, p as InputData, pt as AsyncEventEmitter, q as FileMetaBase, r as AdapterSource, rt as Parser, s as Config, st as Storage, t as Adapter, tt as PluginHooks, u as GeneratorContext, ut as RendererFactory, v as Logger, w as Override, x as OperationHook, y as LoggerContext, z as ResolverContext } from "./types-DUc5lEUp.js";
+import { $ as KubbHooks, A as PluginParameter, B as ResolverFileParams, C as Output, D as PluginFactoryOptions, E as PluginContext, F as ResolveOptionsContext, G as UserLogger, H as SchemaHook, I as ResolvePathOptions, J as FileMetaBase, K as UserPlugin, L as ResolvePathParams, M as PossibleConfig, N as ResolveBannerContext, O as PluginLifecycle, P as ResolveNameParams, Q as Kubb, R as Resolver, S as OperationsHook, T as Plugin, U as UserConfig, V as ResolverPathParams, W as UserGroup, X as PluginHooks, Y as HookStylePlugin, Z as definePlugin, _ as KubbPluginSetupContext, a as CLIOptions, at as defineParser, b as LoggerOptions, c as DevtoolsOptions, ct as Storage, d as Group, dt as RendererFactory, et as BuildOutput, f as Include, ft as createRenderer, g as KubbBuildStartContext, h as KubbBuildEndContext, i as BarrelType, it as Parser, j as PluginWithLifeCycle, k as PluginLifecycleHooks, l as Exclude, lt as createStorage, m as InputPath, mt as AsyncEventEmitter, n as AdapterFactoryOptions, nt as PluginDriver, o as CompatibilityPreset, ot as Generator, p as InputData, pt as logLevel, q as UserPluginWithLifeCycle, r as AdapterSource, rt as FileManager, s as Config, st as defineGenerator, t as Adapter, tt as createKubb, u as GeneratorContext, ut as Renderer, v as Logger, w as Override, x as OperationHook, y as LoggerContext, z as ResolverContext } from "./types-PLXOrxov.js";
 import * as ast from "@kubb/ast";
 import { FileNode, InputNode, Node } from "@kubb/ast";
 
@@ -350,5 +350,5 @@ declare const memoryStorage: (options?: Record<string, never> | undefined) => St
  */
 declare function isInputPath(config: Config | undefined): config is Config<InputPath>;
 //#endregion
-export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BarrelType, BuildOutput, CLIOptions, CompatibilityPreset, Config, DevtoolsOptions, Exclude, FileManager, FileMetaBase, FileProcessor, Generator, GeneratorContext, Group, HookStylePlugin, Include, InputData, InputPath, Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbHooks, KubbPluginSetupContext, Logger, LoggerContext, LoggerOptions, OperationHook, OperationsHook, Output, Override, Parser, Plugin, PluginContext, PluginDriver, PluginFactoryOptions, PluginHooks, PluginLifecycle, PluginLifecycleHooks, PluginParameter, PluginWithLifeCycle, PossibleConfig, Renderer, RendererFactory, ResolveBannerContext, ResolveNameParams, ResolveOptionsContext, ResolvePathOptions, ResolvePathParams, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, SchemaHook, Storage, URLPath, UserGroup, UserLogger, UserPlugin, UserPluginWithLifeCycle, ast, createAdapter, createKubb, createRenderer, createStorage, defineGenerator, defineLogger, defineParser, definePlugin, defineResolver, fsStorage, isInputPath, logLevel, memoryStorage };
+export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BarrelType, BuildOutput, CLIOptions, CompatibilityPreset, Config, DevtoolsOptions, Exclude, FileManager, FileMetaBase, FileProcessor, Generator, GeneratorContext, Group, HookStylePlugin, Include, InputData, InputPath, Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbHooks, KubbPluginSetupContext, Logger, LoggerContext, LoggerOptions, OperationHook, OperationsHook, Output, Override, Parser, Plugin, PluginContext, PluginDriver, PluginFactoryOptions, PluginHooks, PluginLifecycle, PluginLifecycleHooks, PluginParameter, PluginWithLifeCycle, PossibleConfig, Renderer, RendererFactory, ResolveBannerContext, ResolveNameParams, ResolveOptionsContext, ResolvePathOptions, ResolvePathParams, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, SchemaHook, Storage, URLPath, UserConfig, UserGroup, UserLogger, UserPlugin, UserPluginWithLifeCycle, ast, createAdapter, createKubb, createRenderer, createStorage, defineGenerator, defineLogger, defineParser, definePlugin, defineResolver, fsStorage, isInputPath, logLevel, memoryStorage };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -584,7 +584,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "5.0.0-alpha.39";
+var version$1 = "5.0.0-alpha.40";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**

package/dist/mocks.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { D as PluginFactoryOptions, Q as PluginDriver, T as Plugin, at as Generator, n as AdapterFactoryOptions, s as Config, t as Adapter } from "./types-DUc5lEUp.js";
+import { D as PluginFactoryOptions, T as Plugin, n as AdapterFactoryOptions, nt as PluginDriver, ot as Generator, s as Config, t as Adapter } from "./types-PLXOrxov.js";
 import { OperationNode, SchemaNode, Visitor } from "@kubb/ast";
 
 //#region src/mocks.d.ts

package/dist/{types-DUc5lEUp.d.ts → types-PLXOrxov.d.ts}

@@ -348,81 +348,6 @@ type Parser<TMeta extends object = any> = {
  */
 declare function defineParser<TMeta extends object = any>(parser: Parser<TMeta>): Parser<TMeta>;
 //#endregion
-//#region src/definePlugin.d.ts
-/**
- * Base hook handlers for all events except `kubb:plugin:setup`.
- * These handlers have identical signatures regardless of the plugin's
- * `PluginFactoryOptions` generic — they are split out so that the
- * interface below only needs to override the one event that depends on
- * the plugin type.
- */
-type PluginHooksBase = { [K in Exclude<keyof KubbHooks, 'kubb:plugin:setup'>]?: (...args: KubbHooks[K]) => void | Promise<void> };
-/**
- * Plugin hook handlers.
- *
- * `kubb:plugin:setup` is typed with the plugin's own `PluginFactoryOptions` so
- * `ctx.setResolver`, `ctx.setOptions`, `ctx.options` etc. use the correct types.
- *
- * Uses interface + method shorthand for `kubb:plugin:setup`
- * checking, allowing `PluginHooks<PluginTs>` to be assignable to `PluginHooks`.
- *
- * @template TFactory - The plugin's `PluginFactoryOptions` type.
- */
-interface PluginHooks<TFactory extends PluginFactoryOptions = PluginFactoryOptions> extends PluginHooksBase {
-  'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>;
-}
-/**
- * A hook-style plugin object produced by `definePlugin`.
- * Instead of flat lifecycle methods, it groups all handlers under a `hooks:` property
- * (matching Astro's integration naming convention).
- *
- * @template TFactory - The plugin's `PluginFactoryOptions` type.
- */
-type HookStylePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {
-  /**
-   * Unique name for the plugin, following the same naming convention as `createPlugin`.
-   */
-  name: string;
-  /**
-   * Plugins that must be registered before this plugin executes.
-   * An error is thrown at startup when any listed dependency is missing.
-   */
-  dependencies?: Array<string>;
-  /**
-   * The options passed by the user when calling the plugin factory.
-   */
-  options?: TFactory['options'];
-  /**
-   * Lifecycle event handlers for this plugin.
-   * Any event from the global `KubbHooks` map can be subscribed to here.
-   */
-  hooks: PluginHooks<TFactory>;
-};
-/**
- * Creates a plugin factory using the new hook-style (`hooks:`) API.
- *
- * The returned factory is called with optional options and produces a `HookStylePlugin`
- * that coexists with plugins created via the legacy `createPlugin` API in the same
- * `kubb.config.ts`.
- *
- * Lifecycle handlers are registered on the `PluginDriver`'s `AsyncEventEmitter`, enabling
- * both the plugin's own handlers and external tooling (CLI, devtools) to observe every event.
- *
- * @example
- * ```ts
- * // With PluginFactoryOptions (recommended for real plugins)
- * export const pluginTs = definePlugin<PluginTs>((options) => ({
- *   name: 'plugin-ts',
- *   hooks: {
- *     'kubb:plugin:setup'(ctx) {
- *       ctx.setResolver(resolverTs)  // typed as Partial<ResolverTs>
- *     },
- *   },
- * }))
- * ```
- */
-declare function definePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions>(factory: (options: TFactory['options']) => HookStylePlugin<TFactory>): (options?: TFactory['options']) => HookStylePlugin<TFactory>;
-//#endregion
 //#region src/FileManager.d.ts
 /**
  * In-memory file store for generated files.
@@ -1047,6 +972,81 @@ declare global {
   }
 }
 //#endregion
+//#region src/definePlugin.d.ts
+/**
+ * Base hook handlers for all events except `kubb:plugin:setup`.
+ * These handlers have identical signatures regardless of the plugin's
+ * `PluginFactoryOptions` generic — they are split out so that the
+ * interface below only needs to override the one event that depends on
+ * the plugin type.
+ */
+type PluginHooksBase = { [K in Exclude<keyof KubbHooks, 'kubb:plugin:setup'>]?: (...args: KubbHooks[K]) => void | Promise<void> };
+/**
+ * Plugin hook handlers.
+ *
+ * `kubb:plugin:setup` is typed with the plugin's own `PluginFactoryOptions` so
+ * `ctx.setResolver`, `ctx.setOptions`, `ctx.options` etc. use the correct types.
+ *
+ * Uses interface + method shorthand for `kubb:plugin:setup`
+ * checking, allowing `PluginHooks<PluginTs>` to be assignable to `PluginHooks`.
+ *
+ * @template TFactory - The plugin's `PluginFactoryOptions` type.
+ */
+interface PluginHooks<TFactory extends PluginFactoryOptions = PluginFactoryOptions> extends PluginHooksBase {
+  'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>;
+}
+/**
+ * A hook-style plugin object produced by `definePlugin`.
+ * Instead of flat lifecycle methods, it groups all handlers under a `hooks:` property
+ * (matching Astro's integration naming convention).
+ *
+ * @template TFactory - The plugin's `PluginFactoryOptions` type.
+ */
+type HookStylePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {
+  /**
+   * Unique name for the plugin, following the same naming convention as `createPlugin`.
+   */
+  name: string;
+  /**
+   * Plugins that must be registered before this plugin executes.
+   * An error is thrown at startup when any listed dependency is missing.
+   */
+  dependencies?: Array<string>;
+  /**
+   * The options passed by the user when calling the plugin factory.
+   */
+  options?: TFactory['options'];
+  /**
+   * Lifecycle event handlers for this plugin.
+   * Any event from the global `KubbHooks` map can be subscribed to here.
+   */
+  hooks: PluginHooks<TFactory>;
+};
+/**
+ * Creates a plugin factory using the new hook-style (`hooks:`) API.
+ *
+ * The returned factory is called with optional options and produces a `HookStylePlugin`
+ * that coexists with plugins created via the legacy `createPlugin` API in the same
+ * `kubb.config.ts`.
+ *
+ * Lifecycle handlers are registered on the `PluginDriver`'s `AsyncEventEmitter`, enabling
+ * both the plugin's own handlers and external tooling (CLI, devtools) to observe every event.
+ *
+ * @example
+ * ```ts
+ * // With PluginFactoryOptions (recommended for real plugins)
+ * export const pluginTs = definePlugin<PluginTs>((options) => ({
+ *   name: 'plugin-ts',
+ *   hooks: {
+ *     'kubb:plugin:setup'(ctx) {
+ *       ctx.setResolver(resolverTs)  // typed as Partial<ResolverTs>
+ *     },
+ *   },
+ * }))
+ * ```
+ */
+declare function definePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions>(factory: (options: TFactory['options']) => HookStylePlugin<TFactory>): (options?: TFactory['options']) => HookStylePlugin<TFactory>;
+//#endregion
 //#region src/utils/getBarrelFiles.d.ts
 type FileMetaBase = {
   pluginName?: string;
@@ -1502,6 +1502,33 @@ type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> =
  * @deprecated
  */
 type UserPluginWithLifeCycle<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = UserPlugin<TOptions> & PluginLifecycle<TOptions>;
+/**
+ * Partial version of {@link Config} intended for user-facing config entry points.
+ *
+ * Fields that have sensible defaults (`root`, `plugins`, `parsers`, `adapter`) are optional.
+ */
+type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter'> & {
+  /**
+   * The project root directory, which can be either an absolute path or a path relative to the location of your `kubb.config.ts` file.
+   * @default process.cwd()
+   */
+  root?: string;
+  /**
+   * An array of parsers used to convert generated files to strings.
+   * Each parser handles specific file extensions (e.g. `.ts`, `.tsx`).
+   *
+   * A catch-all fallback parser is always appended last for any unhandled extension.
+   */
+  parsers?: Array<Parser>;
+  /**
+   * Adapter that converts the input file into a `@kubb/ast` `InputNode`.
+   */
+  adapter?: Adapter;
+  /**
+   * User-facing plugins can be either legacy createPlugin instances or hook-style plugins.
+   */
+  plugins?: Array<Omit<UserPlugin, 'inject'> | HookStylePlugin>;
+};
 /**
  * Handler for a single schema node. Used by the `schema` hook on a plugin.
  */
@@ -2120,5 +2147,5 @@ type CLIOptions = {
  */
 type PossibleConfig<TCliOptions = undefined> = PossiblePromise<Config | Config[]> | ((...args: [TCliOptions] extends [undefined] ? [] : [TCliOptions]) => PossiblePromise<Config | Config[]>);
 //#endregion
-export { FileManager as $, PluginParameter as A, ResolverFileParams as B, Output as C, PluginFactoryOptions as D, PluginContext as E, ResolveOptionsContext as F, UserPlugin as G, SchemaHook as H, ResolvePathOptions as I, Kubb$1 as J, UserPluginWithLifeCycle as K, ResolvePathParams as L, PossibleConfig as M, ResolveBannerContext as N, PluginLifecycle as O, ResolveNameParams as P, PluginDriver as Q, Resolver as R, OperationsHook as S, Plugin as T, UserGroup as U, ResolverPathParams as V, UserLogger as W, BuildOutput as X, KubbHooks as Y, createKubb as Z, KubbPluginSetupContext as _, CLIOptions as a, Generator as at, LoggerOptions as b, DevtoolsOptions as c, createStorage as ct, Group as d, createRenderer as dt, HookStylePlugin as et, Include as f, logLevel as ft, KubbBuildStartContext as g, KubbBuildEndContext as h, BarrelType as i, defineParser as it, PluginWithLifeCycle as j, PluginLifecycleHooks as k, Exclude$1 as l, Renderer as lt, InputPath as m, AdapterFactoryOptions as n, definePlugin as nt, CompatibilityPreset as o, defineGenerator as ot, InputData as p, AsyncEventEmitter as pt, FileMetaBase as q, AdapterSource as r, Parser as rt, Config as s, Storage as st, Adapter as t, PluginHooks as tt, GeneratorContext as u, RendererFactory as ut, Logger as v, Override as w, OperationHook as x, LoggerContext as y, ResolverContext as z };
-//# sourceMappingURL=types-DUc5lEUp.d.ts.map
+export { KubbHooks as $, PluginParameter as A, ResolverFileParams as B, Output as C, PluginFactoryOptions as D, PluginContext as E, ResolveOptionsContext as F, UserLogger as G, SchemaHook as H, ResolvePathOptions as I, FileMetaBase as J, UserPlugin as K, ResolvePathParams as L, PossibleConfig as M, ResolveBannerContext as N, PluginLifecycle as O, ResolveNameParams as P, Kubb$1 as Q, Resolver as R, OperationsHook as S, Plugin as T, UserConfig as U, ResolverPathParams as V, UserGroup as W, PluginHooks as X, HookStylePlugin as Y, definePlugin as Z, KubbPluginSetupContext as _, CLIOptions as a, defineParser as at, LoggerOptions as b, DevtoolsOptions as c, Storage as ct, Group as d, RendererFactory as dt, BuildOutput as et, Include as f, createRenderer as ft, KubbBuildStartContext as g, KubbBuildEndContext as h, BarrelType as i, Parser as it, PluginWithLifeCycle as j, PluginLifecycleHooks as k, Exclude$1 as l, createStorage as lt, InputPath as m, AsyncEventEmitter as mt, AdapterFactoryOptions as n, PluginDriver as nt, CompatibilityPreset as o, Generator as ot, InputData as p, logLevel as pt, UserPluginWithLifeCycle as q, AdapterSource as r, FileManager as rt, Config as s, defineGenerator as st, Adapter as t, createKubb as tt, GeneratorContext as u, Renderer as ut, Logger as v, Override as w, OperationHook as x, LoggerContext as y, ResolverContext as z };
+//# sourceMappingURL=types-PLXOrxov.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-alpha.39",
+  "version": "5.0.0-alpha.40",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",
@@ -68,8 +68,8 @@
     "remeda": "^2.33.7",
     "semver": "^7.7.4",
     "tinyexec": "^1.1.1",
-    "@kubb/ast": "5.0.0-alpha.39",
-    "@kubb/renderer-jsx": "5.0.0-alpha.39"
+    "@kubb/ast": "5.0.0-alpha.40",
+    "@kubb/renderer-jsx": "5.0.0-alpha.40"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",
@@ -77,7 +77,7 @@
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-alpha.39"
+    "@kubb/renderer-jsx": "5.0.0-alpha.40"
   },
   "engines": {
     "node": ">=22"

package/src/types.ts

@@ -5,6 +5,7 @@ import type { RendererFactory } from './createRenderer.ts'
 import type { Storage } from './createStorage.ts'
 import type { Generator } from './defineGenerator.ts'
 import type { Parser } from './defineParser.ts'
+import type { HookStylePlugin } from './definePlugin.ts'
 import type { KubbHooks } from './Kubb.ts'
 import type { PluginDriver } from './PluginDriver.ts'
 
@@ -473,6 +474,34 @@ export type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOpti
  */
 export type UserPluginWithLifeCycle<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = UserPlugin<TOptions> & PluginLifecycle<TOptions>
 
+/**
+ * Partial version of {@link Config} intended for user-facing config entry points.
+ *
+ * Fields that have sensible defaults (`root`, `plugins`, `parsers`, `adapter`) are optional.
+ */
+export type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter'> & {
+  /**
+   * The project root directory, which can be either an absolute path or a path relative to the location of your `kubb.config.ts` file.
+   * @default process.cwd()
+   */
+  root?: string
+  /**
+   * An array of parsers used to convert generated files to strings.
+   * Each parser handles specific file extensions (e.g. `.ts`, `.tsx`).
+   *
+   * A catch-all fallback parser is always appended last for any unhandled extension.
+   */
+  parsers?: Array<Parser>
+  /**
+   * Adapter that converts the input file into a `@kubb/ast` `InputNode`.
+   */
+  adapter?: Adapter
+  /**
+   * User-facing plugins can be either legacy createPlugin instances or hook-style plugins.
+   */
+  plugins?: Array<Omit<UserPlugin, 'inject'> | HookStylePlugin>
+}
+
 /**
  * Handler for a single schema node. Used by the `schema` hook on a plugin.
  */