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

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-B-UZnFqP.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";
 
 //#region ../../internals/utils/src/url.d.ts

package/dist/index.js

@@ -5,7 +5,7 @@ import { stripVTControlCharacters, styleText } from "node:util";
 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 { operationDef, schemaDef, transform } from "@kubb/ast";
+import { 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";
@@ -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.60".split(".")[0] ?? "5";
+const docsMajor = "5.0.0-beta.62".split(".")[0] ?? "5";
 /**
 * Narrows a {@link Diagnostic} to the variant for `code`, or `null` when it does not match.
 *
@@ -1489,45 +1489,55 @@ function defineResolver(build) {
 //#endregion
 //#region src/Transform.ts
 /**
-* Holds one `Visitor` per plugin, keyed by plugin name. Each plugin's transformer runs in
-* isolation on the original adapter node. `applyTo` is a lookup, not a chain, so plugin A's
-* visitor never sees plugin B's output. When no transformer is registered, `applyTo` returns
-* the original node reference, and the `@kubb/ast` `transform` primitive does the same when
-* its visitor leaves the tree untouched. Callers can compare by identity to detect a no-op.
-*
-* Registration order matches the order setup hooks fire, which the driver has already sorted
-* by `enforce` and dependency edges. The registry does not re-order anything.
+* Holds an ordered list of macros per plugin, keyed by plugin name. Each plugin's macros run in
+* isolation on the original adapter node and are composed into a single `Visitor` that the
+* `@kubb/ast` `transform` primitive applies. `applyTo` is a per-plugin lookup, not a cross-plugin
+* chain, so plugin A's macros never see plugin B's output. When a plugin has no macros, `applyTo`
+* returns the original node reference, and `transform` does the same when the composed visitor
+* 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
+* within a single plugin's list.
 */
 var Transform = class {
-	#visitors = /* @__PURE__ */ new Map();
+	#macros = /* @__PURE__ */ new Map();
+	#composed = /* @__PURE__ */ new Map();
 	#memo = /* @__PURE__ */ new Map();
 	/**
-	* Number of plugins with a registered transformer.
+	* Number of plugins with at least one registered macro.
 	*/
 	get size() {
-		return this.#visitors.size;
+		return this.#macros.size;
 	}
 	/**
-	* Records `visitor` as the transformer for `pluginName`. A second call for the same plugin
-	* replaces the first.
+	* Appends `macro` to the plugin's list, after any macros already registered.
 	*/
-	register(pluginName, visitor) {
-		this.#visitors.set(pluginName, visitor);
-		this.#memo.delete(pluginName);
+	add(pluginName, macro) {
+		const list = this.#macros.get(pluginName);
+		if (list) list.push(macro);
+		else this.#macros.set(pluginName, [macro]);
+		this.#invalidate(pluginName);
+	}
+	/**
+	* Replaces the plugin's macro list with `macros`.
+	*/
+	set(pluginName, macros) {
+		this.#macros.set(pluginName, [...macros]);
+		this.#invalidate(pluginName);
 	}
 	/**
-	* Looks up the transformer for `pluginName`. The generator context uses this so plugins can
-	* read their own visitor through `ctx.transformer`.
+	* Looks up the composed visitor for `pluginName`, or `undefined` when the plugin has no macros.
 	*/
 	get(pluginName) {
-		return this.#visitors.get(pluginName);
+		return this.#visitorFor(pluginName);
 	}
 	/**
-	* Runs the plugin's transformer on `node`. Returns the original node reference when the
-	* plugin has no transformer, so callers can compare by identity to detect a no-op.
+	* Runs the plugin's macros on `node`. Returns the original node reference when the plugin has no
+	* macros, so callers can compare by identity to detect a no-op.
 	*/
 	applyTo(pluginName, node) {
-		const visitor = this.#visitors.get(pluginName);
+		const visitor = this.#visitorFor(pluginName);
 		if (!visitor) return node;
 		let memo = this.#memo.get(pluginName);
 		if (!memo) {
@@ -1541,13 +1551,28 @@ var Transform = class {
 		return result;
 	}
 	/**
-	* Clears every registration. Called from the driver's `dispose()` so visitors do not leak
-	* across builds.
+	* Clears every registration. Called from the driver's `dispose()` so macros do not leak across
+	* builds.
 	*/
 	dispose() {
-		this.#visitors.clear();
+		this.#macros.clear();
+		this.#composed.clear();
 		this.#memo.clear();
 	}
+	#invalidate(pluginName) {
+		this.#composed.delete(pluginName);
+		this.#memo.delete(pluginName);
+	}
+	#visitorFor(pluginName) {
+		const macros = this.#macros.get(pluginName);
+		if (!macros || macros.length === 0) return void 0;
+		let composed = this.#composed.get(pluginName);
+		if (!composed) {
+			composed = composeMacros(macros);
+			this.#composed.set(pluginName, composed);
+		}
+		return composed;
+	}
 };
 //#endregion
 //#region src/KubbDriver.ts
@@ -1588,7 +1613,7 @@ var KubbDriver = class {
 	*/
 	#listeners = [];
 	/**
-	* Transform registry. Plugins populate it during `kubb:plugin:setup` via `setTransformer`,
+	* Transform registry. Plugins populate it during `kubb:plugin:setup` via `addMacro`/`setMacros`,
 	* and `#runGenerators` reads it once per `(plugin, node)` pair through `applyTo`.
 	*/
 	#transforms = new Transform();
@@ -1671,7 +1696,7 @@ var KubbDriver = class {
 	* Registers a hook-style plugin's lifecycle handlers on the shared `AsyncEventEmitter`.
 	*
 	* The `kubb:plugin:setup` listener wraps the global context in a plugin-specific one so
-	* `addGenerator`, `setResolver`, and `setTransformer` target the right `normalizedPlugin`.
+	* `addGenerator`, `setResolver`, and `setMacros` target the right `normalizedPlugin`.
 	* Every other `KubbHooks` event registers as a pass-through listener that external tooling
 	* can observe via `hooks.on(...)`.
 	*
@@ -1691,8 +1716,11 @@ var KubbDriver = class {
 					setResolver: (resolver) => {
 						this.setPluginResolver(plugin.name, resolver);
 					},
-					setTransformer: (visitor) => {
-						this.#transforms.register(plugin.name, visitor);
+					addMacro: (macro) => {
+						this.#transforms.add(plugin.name, macro);
+					},
+					setMacros: (macros) => {
+						this.#transforms.set(plugin.name, macros);
 					},
 					setOptions: (opts) => {
 						plugin.options = {
@@ -1725,7 +1753,7 @@ var KubbDriver = class {
 	}
 	/**
 	* Emits the `kubb:plugin:setup` event so that all registered hook-style plugin listeners
-	* can configure generators, resolvers, transformers and renderers before `buildStart` runs.
+	* can configure generators, resolvers, macros and renderers before `buildStart` runs.
 	*
 	* Call this once from `safeBuild` before the plugin execution loop begins.
 	*/
@@ -1736,7 +1764,8 @@ var KubbDriver = class {
 			options: {},
 			addGenerator: noop,
 			setResolver: noop,
-			setTransformer: noop,
+			addMacro: noop,
+			setMacros: noop,
 			setOptions: noop,
 			injectFile: noop,
 			updateConfig: noop
@@ -1756,39 +1785,21 @@ var KubbDriver = class {
 	* Call this method inside `addGenerator()` (in `kubb:plugin:setup`) to wire up a generator.
 	*/
 	registerGenerator(pluginName, generator) {
-		if (generator.schema) {
-			const schemaHandler = async (node, ctx) => {
+		const register = (event, method) => {
+			if (!method) return;
+			const handler = async (node, ctx) => {
 				if (ctx.plugin.name !== pluginName) return;
-				const result = await generator.schema(node, ctx);
+				const result = await method(node, ctx);
 				await this.dispatch({
 					result,
 					renderer: generator.renderer
 				});
 			};
-			this.#trackListener("kubb:generate:schema", schemaHandler);
-		}
-		if (generator.operation) {
-			const operationHandler = async (node, ctx) => {
-				if (ctx.plugin.name !== pluginName) return;
-				const result = await generator.operation(node, ctx);
-				await this.dispatch({
-					result,
-					renderer: generator.renderer
-				});
-			};
-			this.#trackListener("kubb:generate:operation", operationHandler);
-		}
-		if (generator.operations) {
-			const operationsHandler = async (nodes, ctx) => {
-				if (ctx.plugin.name !== pluginName) return;
-				const result = await generator.operations(nodes, ctx);
-				await this.dispatch({
-					result,
-					renderer: generator.renderer
-				});
-			};
-			this.#trackListener("kubb:generate:operations", operationsHandler);
-		}
+			this.#trackListener(event, handler);
+		};
+		register("kubb:generate:schema", generator.schema);
+		register("kubb:generate:operation", generator.operation);
+		register("kubb:generate:operations", generator.operations);
 		this.#eventGeneratorPlugins.add(pluginName);
 	}
 	/**
@@ -1928,7 +1939,7 @@ var KubbDriver = class {
 	}
 	/**
 	* Streams schemas and operations through every plugin's generators. Each node is run
-	* through the plugin's transformer (from `this.#transforms`) before the generator sees it,
+	* through the plugin's macros (from `this.#transforms`) before the generator sees it,
 	* so plugins stay isolated and the hot path stays per-node. Schemas run before operations
 	* because the two passes share `flushPending` and the FileProcessor's event emitter.
 	* A failing plugin contributes an error diagnostic so the rest of the build continues.
@@ -2232,9 +2243,6 @@ var KubbDriver = class {
 			get resolver() {
 				return driver.getResolver(plugin.name);
 			},
-			get transformer() {
-				return driver.#transforms.get(plugin.name);
-			},
 			warn(message) {
 				report({
 					code: Diagnostics.code.pluginWarning,