@kubb/core 5.0.0-beta.62 → 5.0.0-beta.63

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk-C0LytTxp.js";
-import { $ as KubbPluginSetupContext, A as KubbHookStartContext, At as Adapter, B as ParsedFile, C as KubbFilesProcessingEndContext, Ct as GenerationResult, D as KubbGenerationStartContext, Dt as UserReporter, E as KubbGenerationEndContext, Et as ReporterName, F as KubbSuccessContext, G as Generator, H as createKubb, I as KubbWarnContext, J as KubbDriver, K as GeneratorContext, L as PossibleConfig, M as KubbInfoContext, Mt as AdapterSource, N as KubbLifecycleStartContext, Nt as createAdapter, O as KubbHookEndContext, Ot as createReporter, P as KubbPluginsEndContext, Pt as AsyncEventEmitter, Q as KubbPluginEndContext, R as UserConfig, S as KubbFileProcessingUpdate, St as createStorage, T as KubbFilesProcessingUpdateContext, Tt as ReporterContext, U as Parser, V as Kubb, W as defineParser, X as Group, Y as Exclude, Z as Include, _ as InputPath, _t as defineResolver, a as DiagnosticLocation, at as Override, b as KubbDiagnosticContext, bt as createRenderer, c as PerformanceDiagnostic, ct as definePlugin, d as SerializedDiagnostic, dt as ResolveBannerFile, et as KubbPluginStartContext, f as UpdateDiagnostic, ft as ResolveOptionsContext, g as InputData, gt as ResolverPathParams, h as Config, ht as ResolverFileParams, i as DiagnosticKind, it as OutputOptions, j as KubbHooks, jt as AdapterFactoryOptions, k as KubbHookLineContext, kt as logLevel, l as ProblemCode, lt as BannerMeta, m as CLIOptions, mt as ResolverContext, n as DiagnosticByCode, nt as Output, o as DiagnosticSeverity, ot as Plugin, p as BuildOutput, pt as Resolver, q as defineGenerator, r as DiagnosticDoc, rt as OutputMode, s as Diagnostics, st as PluginFactoryOptions, t as Diagnostic, tt as NormalizedPlugin, u as ProblemDiagnostic, ut as ResolveBannerContext, v as KubbBuildEndContext, vt as Renderer, w as KubbFilesProcessingStartContext, wt as Reporter, x as KubbErrorContext, xt as Storage, y as KubbBuildStartContext, yt as RendererFactory, z as FileProcessorHooks } from "./diagnostics-D0G07LHG.js";
+import { $ as KubbPluginSetupContext, A as KubbHookStartContext, At as Adapter, B as ParsedFile, C as KubbFilesProcessingEndContext, Ct as GenerationResult, D as KubbGenerationStartContext, Dt as UserReporter, E as KubbGenerationEndContext, Et as ReporterName, F as KubbSuccessContext, G as Generator, H as createKubb, I as KubbWarnContext, J as KubbDriver, K as GeneratorContext, L as PossibleConfig, M as KubbInfoContext, Mt as AdapterSource, N as KubbLifecycleStartContext, Nt as createAdapter, O as KubbHookEndContext, Ot as createReporter, P as KubbPluginsEndContext, Pt as AsyncEventEmitter, Q as KubbPluginEndContext, R as UserConfig, S as KubbFileProcessingUpdate, St as createStorage, T as KubbFilesProcessingUpdateContext, Tt as ReporterContext, U as Parser, V as Kubb, W as defineParser, X as Group, Y as Exclude, Z as Include, _ as InputPath, _t as defineResolver, a as DiagnosticLocation, at as Override, b as KubbDiagnosticContext, bt as createRenderer, c as PerformanceDiagnostic, ct as definePlugin, d as SerializedDiagnostic, dt as ResolveBannerFile, et as KubbPluginStartContext, f as UpdateDiagnostic, ft as ResolveOptionsContext, g as InputData, gt as ResolverPathParams, h as Config, ht as ResolverFileParams, i as DiagnosticKind, it as OutputOptions, j as KubbHooks, jt as AdapterFactoryOptions, k as KubbHookLineContext, kt as logLevel, l as ProblemCode, lt as BannerMeta, m as CLIOptions, mt as ResolverContext, n as DiagnosticByCode, nt as Output, o as DiagnosticSeverity, ot as Plugin, p as BuildOutput, pt as Resolver, q as defineGenerator, r as DiagnosticDoc, rt as OutputMode, s as Diagnostics, st as PluginFactoryOptions, t as Diagnostic, tt as NormalizedPlugin, u as ProblemDiagnostic, ut as ResolveBannerContext, v as KubbBuildEndContext, vt as Renderer, w as KubbFilesProcessingStartContext, wt as Reporter, x as KubbErrorContext, xt as Storage, y as KubbBuildStartContext, yt as RendererFactory, z as FileProcessorHooks } from "./diagnostics-IjkPEgAO.js";
 import * as ast from "@kubb/ast";
 
 //#region ../../internals/utils/src/url.d.ts
@@ -113,12 +113,11 @@ declare const cliReporter: Reporter;
  * The `file` reporter. Writes a config's {@link Report} to `.kubb/kubb-<name>-<timestamp>.log` as a
  * plain-text document: a `# <name> — <timestamp>` header, a `## Summary` with the same counts the
  * cli and json reporters expose, a `## Problems` section in the miette block format, and a
- * `## Timings` section. Selected with `--reporter file` (or `reporters: ['file']`), replacing the
- * old `--debug` flag.
+ * `## Timings` section. Selected with `--reporter file` (or `reporters: ['file']`).
  *
- * @note Unlike the streaming logger it replaced, it captures the collected diagnostics once a
- * config finishes, not the live `kubb:info`/`kubb:plugin` event stream. Color is stripped so the
- * file stays plain text even when the run is attached to a TTY.
+ * @note It captures the collected diagnostics once a config finishes, not the live
+ * `kubb:info`/`kubb:plugin` event stream. Color is stripped so the file stays plain text even when
+ * the run is attached to a TTY.
  */
 declare const fileReporter: Reporter;
 //#endregion

package/dist/index.js

@@ -1,7 +1,7 @@
 import "./chunk-C0LytTxp.js";
 import { a as createStorage, c as camelCase, d as BuildError, f as getErrorMessage, i as FileManager, l as pascalCase, n as _usingCtx, o as OPERATION_FILTER_TYPES, r as FileProcessor, s as diagnosticCode, t as memoryStorage, u as AsyncEventEmitter } from "./memoryStorage-CWFzAz4o.js";
-import { hash } from "node:crypto";
 import { stripVTControlCharacters, styleText } from "node:util";
+import { hash } from "node:crypto";
 import { access, glob, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import path, { dirname, join, relative, resolve } from "node:path";
 import * as ast from "@kubb/ast";
@@ -590,12 +590,12 @@ var Url = class Url {
 *   options,
 *   document: null,
 *   async parse(_source) {
-*     // Convert `source` (path or inline data) into an InputNode.
+*     // Convert the source (path or inline data) into an InputNode.
 *     return ast.factory.createInput()
 *   },
 *   getImports: () => [],
 *   async validate() {
-*     // Throw or call ctx.error here when the spec is invalid.
+*     // Throw here when the spec is invalid.
 *   },
 * }))
 * ```
@@ -608,7 +608,7 @@ function createAdapter(build) {
 /**
 * Docs major version, derived from the package version so the link tracks the published major.
 */
-const docsMajor = "5.0.0-beta.62".split(".")[0] ?? "5";
+const docsMajor = "5.0.0-beta.63".split(".")[0] ?? "5";
 /**
 * Narrows a {@link Diagnostic} to the variant for `code`, or `null` when it does not match.
 *
@@ -928,8 +928,8 @@ var Diagnostics = class Diagnostics {
 		return [...names];
 	}
 	/**
-	* Counts `problem` diagnostics by severity for the run summary. `timing`
-	* diagnostics are ignored.
+	* Counts `problem` diagnostics by severity for the run summary. `performance` and
+	* `update` diagnostics are ignored.
 	*/
 	static count(diagnostics) {
 		let errors = 0;
@@ -1497,7 +1497,7 @@ function defineResolver(build) {
 * leaves the tree untouched, so callers can detect a no-op by identity.
 *
 * Registration order matches the order setup hooks fire, which the driver has already sorted by
-* `enforce` and dependency edges. The registry preserves that order; macro `enforce` only reorders
+* `enforce` and dependency edges. The registry preserves that order. Macro `enforce` only reorders
 * within a single plugin's list.
 */
 var Transform = class {
@@ -1630,6 +1630,12 @@ var KubbDriver = class {
 		this.hooks.on(event, handler);
 		this.#listeners.push([event, handler]);
 	}
+	/**
+	* Normalizes every configured plugin, orders them, and registers their lifecycle handlers.
+	* A plugin that another lists as a dependency runs first, then `enforce: 'pre'` before
+	* `'post'`. When the config has an adapter, the adapter source is resolved from the input
+	* so `run` can parse it later.
+	*/
 	async setup() {
 		const normalized = this.config.plugins.map((rawPlugin) => this.#normalizePlugin(rawPlugin));
 		const dependenciesByName = new Map(normalized.map((plugin) => [plugin.name, new Set(plugin.dependencies ?? [])]));
@@ -1649,8 +1655,9 @@ var KubbDriver = class {
 		return this.options.hooks;
 	}
 	/**
-	* Creates an `NormalizedPlugin` from a hook-style plugin and registers
-	* its lifecycle handlers on the `AsyncEventEmitter`.
+	* Builds a `NormalizedPlugin` from a hook-style plugin, filling in default
+	* options and copying `apply` when present. Registering its lifecycle handlers
+	* on the `AsyncEventEmitter` is done separately by `#registerPlugin`.
 	*/
 	#normalizePlugin(plugin) {
 		const normalized = {
@@ -1755,7 +1762,7 @@ var KubbDriver = class {
 	* Emits the `kubb:plugin:setup` event so that all registered hook-style plugin listeners
 	* can configure generators, resolvers, macros and renderers before `buildStart` runs.
 	*
-	* Call this once from `safeBuild` before the plugin execution loop begins.
+	* Called once from `run` before the plugin execution loop begins.
 	*/
 	async emitSetupHooks() {
 		const noop = () => {};
@@ -1950,8 +1957,8 @@ var KubbDriver = class {
 	* That ordering is what drives the CLI's `Plugins N/M` counter. Without it the bar would
 	* sit at the initial value until the very end of the run.
 	*
-	* When `entries` is empty or `this.inputNode` is `null`, every entry still gets a
-	* `kubb:plugin:end` so post-plugin listeners (the barrel writer and friends) complete.
+	* When `this.inputNode` is `null`, every entry still gets a `kubb:plugin:end` so
+	* post-plugin listeners (the barrel writer and friends) complete.
 	*/
 	async #runGenerators(entries, flushPending) {
 		const diagnostics = [];
@@ -2442,9 +2449,8 @@ function resolveConfig(userConfig) {
 * config in the constructor, so `config` is available right away, and shares `hooks`,
 * `storage`, and `driver` across the `setup → build` lifecycle.
 *
-* `createKubb` takes a plain, serializable config object (the shape `defineConfig`
-* produces), not a fluent builder. Config stays plain data so it can be cache
-* fingerprinted and validated against the shipped JSON schema.
+* `createKubb` takes a plain config object (the shape `defineConfig` produces),
+* not a fluent builder.
 *
 * Attach event listeners to `.hooks` before calling `setup()` or `build()`.
 *
@@ -2753,12 +2759,11 @@ function buildTimingSection(report) {
 * The `file` reporter. Writes a config's {@link Report} to `.kubb/kubb-<name>-<timestamp>.log` as a
 * plain-text document: a `# <name> — <timestamp>` header, a `## Summary` with the same counts the
 * cli and json reporters expose, a `## Problems` section in the miette block format, and a
-* `## Timings` section. Selected with `--reporter file` (or `reporters: ['file']`), replacing the
-* old `--debug` flag.
+* `## Timings` section. Selected with `--reporter file` (or `reporters: ['file']`).
 *
-* @note Unlike the streaming logger it replaced, it captures the collected diagnostics once a
-* config finishes, not the live `kubb:info`/`kubb:plugin` event stream. Color is stripped so the
-* file stays plain text even when the run is attached to a TTY.
+* @note It captures the collected diagnostics once a config finishes, not the live
+* `kubb:info`/`kubb:plugin` event stream. Color is stripped so the file stays plain text even when
+* the run is attached to a TTY.
 */
 const fileReporter = createReporter({
 	name: "file",