@kubb/core 5.0.0-beta.100 → 5.0.0-beta.102

package/dist/mocks.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { A as Generator, F as Parser, N as KubbDriver, Rt as Adapter, W as NormalizedPlugin, X as PluginFactoryOptions, r as Config, zt as AdapterFactoryOptions } from "./types-DM7-MGjZ.js";
+import { Bt as Adapter, F as KubbDriver, K as NormalizedPlugin, L as Parser, M as Generator, Q as PluginFactoryOptions, Vt as AdapterFactoryOptions, r as Config } from "./types-B14Ba9P7.js";
 import { FileNode, InputMeta, Macro, OperationNode, SchemaNode } from "@kubb/ast";
 //#region src/mocks.d.ts
 /**

package/dist/{types-DM7-MGjZ.d.ts → types-B14Ba9P7.d.ts}

@@ -1788,15 +1788,13 @@ declare class KubbDriver {
    */
   setupHooks(): Promise<void>;
   /**
-   * Registers a generator for the given plugin on the shared hook emitter.
+   * Appends a generator to its owning plugin so the generate loop can call it directly.
    *
-   * The generator's `schema`, `operation`, and `operations` methods are registered as
-   * listeners on `kubb:generate:schema`, `kubb:generate:operation`, and `kubb:generate:operations`
-   * respectively. Each listener is scoped to the owning plugin via a `ctx.plugin.name` check
-   * so that generators from different plugins do not cross-fire.
-   *
-   * The renderer comes from `generator.renderer`. Set `generator.renderer = null` (or leave it
-   * unset) to opt out of rendering.
+   * The generator's `schema`, `operation`, and `operations` methods run per node during the AST
+   * walk in `#runGenerators`, and their result is routed through `dispatch`. Because a generator is
+   * bound to a plugin, generators from different plugins never cross-fire without a name check. The
+   * renderer comes from `generator.renderer`; set it to `null` (or leave it unset) to opt out of
+   * rendering.
    *
    * Call this method inside `addGenerator()` (in `kubb:plugin:setup`) to wire up a generator.
    */
@@ -1805,7 +1803,7 @@ declare class KubbDriver {
    * Returns `true` when at least one generator was registered for the given plugin
    * via `addGenerator()` in `kubb:plugin:setup`.
    *
-   * Used by the build loop to decide whether to walk the AST and emit generator hooks
+   * Used by the build loop to decide whether to walk the AST and run the generators
    * for a plugin.
    */
   hasHookGenerators(pluginName: string): boolean;
@@ -1843,16 +1841,14 @@ declare class KubbDriver {
   dispose(): void;
   [Symbol.dispose](): void;
   /**
-   * Merges `partial` with the plugin's default resolver and stores the result.
-   * Also mirrors it onto `plugin.resolver` so callers using `getPlugin(name).resolver`
-   * get the up-to-date resolver without going through `getResolver()`.
+   * Merges `partial` onto a fresh default resolver and stores the result on `plugin.resolver`,
+   * which is the single source `getResolver` and `getPlugin(name).resolver` both read.
    */
   setPluginResolver(pluginName: string, partial: ResolverPatch | Resolver): void;
   /**
-   * Returns the resolver for the given plugin.
-   *
-   * Resolution order: resolver set via `setPluginResolver` → lazily created default
-   * resolver (identity name, no path transforms).
+   * Returns the resolver for the given plugin. It reads `plugin.resolver` (seeded with the default
+   * at registration and replaced by `setPluginResolver`), falling back to a fresh default for a
+   * name that is not a registered plugin.
    */
   getResolver<TName extends PluginName>(pluginName: TName): ResolvePluginOptions<TName>['resolver'];
   getContext<TOptions extends PluginFactoryOptions>(plugin: NormalizedPlugin<TOptions>): Omit<GeneratorContext<TOptions>, 'options'>;
@@ -2061,6 +2057,37 @@ declare function defineGenerator<TOptions extends PluginFactoryOptions = PluginF
 type CreateKubbOptions = {
   hooks?: Hookable<KubbHooks>;
 };
+/**
+ * Host hooks for a single {@link Kubb.generate} call. All optional. Progress narration rides the
+ * `kubb:*` lifecycle hooks on `.hooks`, so hosts subscribe there rather than pass a callback.
+ */
+type GenerateOptions = {
+  /**
+   * Format, lint, and run `postGenerate` over the generated output after an error-free build, and
+   * return the diagnostics they emitted. CLI-only.
+   */
+  processOutput?: (context: {
+    config: Config;
+    outputPath: string;
+  }) => Promise<Array<Diagnostic>>;
+};
+/**
+ * What a {@link Kubb.generate} call produced, for the host to map onto its own result shape.
+ */
+type GenerateResult = {
+  /**
+   * `true` when the build and every output pass completed without an error-level diagnostic.
+   */
+  success: boolean;
+  /**
+   * All files generated during the build.
+   */
+  files: Array<FileNode>;
+  /**
+   * Build diagnostics plus any collected from the output passes.
+   */
+  diagnostics: Array<Diagnostic>;
+};
 /**
  * Kubb code-generation instance bound to a single config entry. Resolves the user
  * config in the constructor, so `config` is available right away, and shares `hooks`,
@@ -2100,6 +2127,19 @@ declare class Kubb$1 {
    * plugin errors, so callers stay in control of how failures surface.
    */
   safeBuild(): Promise<BuildOutput>;
+  /**
+   * Run one build and its output passes end to end, emitting the surrounding `kubb:generation:*`
+   * hooks. Never throws on a build error: the outcome comes back in {@link GenerateResult} so the
+   * host decides how failures surface. Telemetry and progress narration stay with the host, which
+   * reads the result and subscribes to the `kubb:*` hooks.
+   *
+   * @example
+   * ```ts
+   * const result = await createKubb(config, { hooks }).generate()
+   * if (!result.success) process.exitCode = 1
+   * ```
+   */
+  generate(options?: GenerateOptions): Promise<GenerateResult>;
   dispose(): void;
   [Symbol.dispose](): void;
 }
@@ -2483,6 +2523,8 @@ interface KubbHooks {
   'kubb:lifecycle:end': [];
   'kubb:generation:start': [ctx: KubbGenerationStartContext];
   'kubb:generation:end': [ctx: KubbGenerationEndContext];
+  'kubb:setup:start': [];
+  'kubb:setup:end': [];
   'kubb:format:start': [];
   'kubb:format:end': [];
   'kubb:lint:start': [];
@@ -2834,5 +2876,5 @@ type BuildOutput = {
   storage: Storage;
 };
 //#endregion
-export { definePlugin as $, Generator as A, DiagnosticSeverity as At, Include as B, AdapterSource as Bt, KubbWarnContext as C, UserReporter as Ct, CreateKubbOptions as D, DiagnosticDoc as Dt, UserConfig as E, Diagnostic as Et, Parser as F, SerializedDiagnostic as Ft, Output as G, KubbPluginSetupContext as H, defineParser as I, UpdateDiagnostic as It, Override as J, OutputMode as K, Exclude$1 as L, Hookable as Lt, defineGenerator as M, PerformanceDiagnostic as Mt, KubbDriver as N, ProblemCode as Nt, Kubb$1 as O, DiagnosticKind as Ot, FileManagerHooks as P, ProblemDiagnostic as Pt, ResolvePluginOptions as Q, Filter as R, Adapter as Rt, KubbSuccessContext as S, ReporterName as St, PostGenerateCommand as T, logLevel as Tt, KubbPluginStartContext as U, KubbPluginEndContext as V, createAdapter as Vt, NormalizedPlugin as W, PluginFactoryOptions as X, Plugin as Y, PluginName as Z, KubbHookStartContext as _, Storage as _t, KubbBuildEndContext as a, ResolveOptionsContext as at, KubbLifecycleStartContext as b, Reporter as bt, KubbErrorContext as c, ResolverDefault as ct, KubbFilesProcessingStartContext as d, ResolverFilePathParams as dt, BannerMeta as et, KubbFilesProcessingUpdateContext as f, ResolverPatch as ft, KubbHookLineContext as g, createRenderer as gt, KubbHookEndContext as h, RendererFactory as ht, Input as i, ResolveImportsOptions as it, GeneratorContext as j, Diagnostics as jt, createKubb as k, DiagnosticLocation as kt, KubbFileProcessingUpdate as l, ResolverFile as lt, KubbGenerationStartContext as m, Renderer as mt, CLIOptions as n, ResolveBannerFile as nt, KubbBuildStartContext as o, ResolvePathOptions as ot, KubbGenerationEndContext as p, ResolverPathParams as pt, OutputOptions as q, Config as r, ResolveFileOptions as rt, KubbDiagnosticContext as s, Resolver as st, BuildOutput as t, ResolveBannerContext as tt, KubbFilesProcessingEndContext as u, ResolverFileParams as ut, KubbHooks as v, createStorage as vt, PossibleConfig as w, createReporter as wt, KubbPluginsEndContext as x, ReporterContext as xt, KubbInfoContext as y, GenerationResult as yt, Group as z, AdapterFactoryOptions as zt };
-//# sourceMappingURL=types-DM7-MGjZ.d.ts.map
+export { PluginName as $, Kubb$1 as A, DiagnosticKind as At, Filter as B, Adapter as Bt, KubbWarnContext as C, ReporterContext as Ct, CreateKubbOptions as D, logLevel as Dt, UserConfig as E, createReporter as Et, KubbDriver as F, ProblemCode as Ft, KubbPluginStartContext as G, Include as H, AdapterSource as Ht, FileManagerHooks as I, ProblemDiagnostic as It, OutputMode as J, NormalizedPlugin as K, Parser as L, SerializedDiagnostic as Lt, Generator as M, DiagnosticSeverity as Mt, GeneratorContext as N, Diagnostics as Nt, GenerateOptions as O, Diagnostic as Ot, defineGenerator as P, PerformanceDiagnostic as Pt, PluginFactoryOptions as Q, defineParser as R, UpdateDiagnostic as Rt, KubbSuccessContext as S, Reporter as St, PostGenerateCommand as T, UserReporter as Tt, KubbPluginEndContext as U, createAdapter as Ut, Group as V, AdapterFactoryOptions as Vt, KubbPluginSetupContext as W, Override as X, OutputOptions as Y, Plugin as Z, KubbHookStartContext as _, RendererFactory as _t, KubbBuildEndContext as a, ResolveFileOptions as at, KubbLifecycleStartContext as b, createStorage as bt, KubbErrorContext as c, ResolvePathOptions as ct, KubbFilesProcessingStartContext as d, ResolverFile as dt, ResolvePluginOptions as et, KubbFilesProcessingUpdateContext as f, ResolverFileParams as ft, KubbHookLineContext as g, Renderer as gt, KubbHookEndContext as h, ResolverPathParams as ht, Input as i, ResolveBannerFile as it, createKubb as j, DiagnosticLocation as jt, GenerateResult as k, DiagnosticDoc as kt, KubbFileProcessingUpdate as l, Resolver as lt, KubbGenerationStartContext as m, ResolverPatch as mt, CLIOptions as n, BannerMeta as nt, KubbBuildStartContext as o, ResolveImportsOptions as ot, KubbGenerationEndContext as p, ResolverFilePathParams as pt, Output as q, Config as r, ResolveBannerContext as rt, KubbDiagnosticContext as s, ResolveOptionsContext as st, BuildOutput as t, definePlugin as tt, KubbFilesProcessingEndContext as u, ResolverDefault as ut, KubbHooks as v, createRenderer as vt, PossibleConfig as w, ReporterName as wt, KubbPluginsEndContext as x, GenerationResult as xt, KubbInfoContext as y, Storage as yt, Exclude$1 as z, Hookable as zt };
+//# sourceMappingURL=types-B14Ba9P7.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-beta.100",
+  "version": "5.0.0-beta.102",
   "description": "Core engine for Kubb. Provides the plugin driver, file manager and build orchestration used by every Kubb plugin.",
   "keywords": [
     "code-generator",
@@ -55,7 +55,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/ast": "5.0.0-beta.100"
+    "@kubb/ast": "5.0.0-beta.102"
   },
   "devDependencies": {
     "@internals/utils": "0.0.0"