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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-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 ast from "@kubb/ast";
+import { t as __name } from "./rolldown-runtime-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-BqiNAWVS.js";
+import { ast } from "@kubb/ast";
 
 //#region ../../internals/utils/src/url.d.ts
 type URLObject = {
@@ -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,11 +1,10 @@
-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 "./rolldown-runtime-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-DWnhqUf2.js";
 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";
-import { composeMacros, operationDef, schemaDef, transform } from "@kubb/ast";
+import { ast, composeMacros, operationDef, schemaDef, transform } from "@kubb/ast";
 import { AsyncLocalStorage } from "node:async_hooks";
 import * as factory from "@kubb/ast/factory";
 import { collectUsedSchemaNames } from "@kubb/ast/utils";
@@ -590,12 +589,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 +607,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.64".split(".")[0] ?? "5";
 /**
 * Narrows a {@link Diagnostic} to the variant for `code`, or `null` when it does not match.
 *
@@ -662,22 +661,13 @@ const isPerformance = isKind("performance");
 */
 const isUpdate = isKind("update");
 /**
-* Glyph and accent color per severity, matching the miette/oxlint convention
-* (`×` error, `⚠` warning, `ℹ` advice).
+* Accent color per severity. The color tints the `[CODE]` tag (red error, yellow warning,
+* blue info).
 */
 const severityStyle = {
-	error: {
-		glyph: "×",
-		color: "red"
-	},
-	warning: {
-		glyph: "⚠",
-		color: "yellow"
-	},
-	info: {
-		glyph: "ℹ",
-		color: "blue"
-	}
+	error: { color: "red" },
+	warning: { color: "yellow" },
+	info: { color: "blue" }
 };
 /**
 * Explanation for every {@link diagnosticCode}. Use {@link Diagnostics.explain} to look one up
@@ -928,8 +918,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;
@@ -1000,35 +990,35 @@ var Diagnostics = class Diagnostics {
 		};
 	}
 	/**
-	* Renders a {@link Diagnostic} for terminal output as its parts: the colored severity `symbol`
-	* (the gutter glyph), the `plugin(CODE): message` `headline`, and the `details` lines (optional
-	* `at <pointer>`, `help:`, and `docs:`).
+	* Renders a {@link Diagnostic} for terminal output as its parts: the `headline`
+	* (`[CODE] plugin: message`, with the code in the severity color) and the indented `details`
+	* rows (`at:` pointer, `fix:` help, `see:` docs link).
 	*
-	* Hosts compose these to fit their gutter: a clack logger passes `symbol` as its own gutter and
-	* `[headline, ...details]` as the message, while plain text outputs use {@link Diagnostics.formatLines}.
+	* Hosts compose these to fit their gutter: a clack logger passes `[headline, ...details]` as the
+	* message with no gutter symbol, while plain text outputs use {@link Diagnostics.formatLines}.
 	*/
 	static format(diagnostic) {
 		const { code, severity, message } = diagnostic;
-		const { glyph, color } = severityStyle[severity];
+		const { color } = severityStyle[severity];
 		const problem = isProblem(diagnostic) ? diagnostic : void 0;
-		const rule = styleText(color, styleText("bold", problem?.plugin ? `${problem.plugin}(${code})` : code));
+		const tag = styleText(color, styleText("bold", `[${code}]`));
+		const headline = problem?.plugin ? `${tag} ${problem.plugin}: ${message}` : `${tag}: ${message}`;
 		const details = [];
-		if (problem?.location && "pointer" in problem.location) details.push(`  ${styleText("dim", "at")} ${styleText("cyan", problem.location.pointer)}`);
-		if (problem?.help) details.push(`  ${styleText("cyan", "help:")} ${problem.help}`);
-		if (code !== diagnosticCode.unknown) details.push(`  ${styleText("dim", "docs:")} ${styleText("cyan", Diagnostics.docsUrl(code))}`);
+		if (problem?.location && "pointer" in problem.location) details.push(`  ${styleText("dim", "at:")} ${styleText("cyan", problem.location.pointer)}`);
+		if (problem?.help) details.push(`  ${styleText("cyan", "fix:")} ${problem.help}`);
+		if (code !== diagnosticCode.unknown) details.push(`  ${styleText("dim", "see:")} ${styleText("cyan", Diagnostics.docsUrl(code))}`);
 		return {
-			symbol: styleText(color, styleText("bold", glyph)),
-			headline: `${rule}: ${message}`,
+			headline,
 			details
 		};
 	}
 	/**
-	* The self-contained block form of {@link Diagnostics.format}: `${symbol} ${headline}` followed by
-	* the detail lines. Used where there is no gutter to own the symbol (plain and file output).
+	* The self-contained block form of {@link Diagnostics.format}: the `headline` followed by the
+	* indented detail rows. Used where there is no gutter (plain and file output).
 	*/
 	static formatLines(diagnostic) {
-		const { symbol, headline, details } = Diagnostics.format(diagnostic);
-		return [`${symbol} ${headline}`, ...details];
+		const { headline, details } = Diagnostics.format(diagnostic);
+		return [headline, ...details];
 	}
 };
 //#endregion
@@ -1497,7 +1487,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 +1620,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 +1645,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 +1752,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 +1947,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 +2439,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 +2749,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",