@kubb/cli 5.0.0-beta.84 → 5.0.0-beta.86

package/dist/{run-D8TRnpBB.js → run-BxMfDivH.js}

@@ -1,126 +1,17 @@
 import "./rolldown-runtime-C0LytTxp.js";
+import { a as WATCHER_IGNORED_PATHS, i as UPDATE_CHECK_TIMEOUT_MS, n as KUBB_NPM_PACKAGE_URL, o as canUseTTY, t as Telemetry } from "./Telemetry-Cuzoes9Y.js";
 import { n as toCause, r as toError } from "./errors-Dc_d7BfX.js";
-import { a as canUseTTY, i as WATCHER_IGNORED_PATHS, n as KUBB_NPM_PACKAGE_URL, t as Telemetry } from "./Telemetry-ugO-B77y.js";
-import { i as linters, n as detectTool, r as formatters } from "./tools-D0UogMU3.js";
-import { t as version } from "./package-DKwwXnAz.js";
+import { t as version } from "./package-D24TC3pS.js";
+import { i as linters, n as detectTool, r as formatters } from "./tools-B23ltmWP.js";
 import { styleText } from "node:util";
-import { EventEmitter } from "node:events";
-import { hash } from "node:crypto";
+import process$1 from "node:process";
 import { existsSync } from "node:fs";
 import path, { basename, dirname, relative, resolve } from "node:path";
-import process$1 from "node:process";
 import * as clack from "@clack/prompts";
-import { Diagnostics, cliReporter, createKubb, logLevel } from "@kubb/core";
+import { Diagnostics, Hookable, cliReporter, createKubb, logLevel } from "@kubb/core";
 import { createJiti } from "jiti";
 import { NonZeroExitError, x } from "tinyexec";
 import { loadConfig } from "unconfig";
-//#region ../../internals/utils/src/asyncEventEmitter.ts
-/**
-* Typed `EventEmitter` that awaits all async listeners before resolving.
-* Wraps Node's `EventEmitter` with full TypeScript event-map inference.
-*
-* @example
-* ```ts
-* const emitter = new AsyncEventEmitter<{ build: [name: string] }>()
-* emitter.on('build', async (name) => { console.log(name) })
-* await emitter.emit('build', 'petstore') // all listeners awaited
-* ```
-*/
-var AsyncEventEmitter = class {
-	/**
-	* Maximum number of listeners per event before Node emits a memory-leak warning.
-	* @default 10
-	*/
-	constructor(maxListener = 10) {
-		this.#emitter.setMaxListeners(maxListener);
-	}
-	#emitter = new EventEmitter();
-	/**
-	* Emits `eventName` and awaits all registered listeners sequentially.
-	* Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.
-	*
-	* @example
-	* ```ts
-	* await emitter.emit('build', 'petstore')
-	* ```
-	*/
-	emit(eventName, ...eventArgs) {
-		const listeners = this.#emitter.listeners(eventName);
-		if (listeners.length === 0) return;
-		return this.#emitAll(eventName, listeners, eventArgs);
-	}
-	async #emitAll(eventName, listeners, eventArgs) {
-		for (const listener of listeners) try {
-			await listener(...eventArgs);
-		} catch (err) {
-			let serializedArgs;
-			try {
-				serializedArgs = JSON.stringify(eventArgs);
-			} catch {
-				serializedArgs = String(eventArgs);
-			}
-			throw new Error(`Error in async listener for "${eventName}" with eventArgs ${serializedArgs}`, { cause: toError(err) });
-		}
-	}
-	/**
-	* Registers a persistent listener for `eventName`.
-	*
-	* @example
-	* ```ts
-	* emitter.on('build', async (name) => { console.log(name) })
-	* ```
-	*/
-	on(eventName, handler) {
-		this.#emitter.on(eventName, handler);
-	}
-	/**
-	* Removes a previously registered listener.
-	*
-	* @example
-	* ```ts
-	* emitter.off('build', handler)
-	* ```
-	*/
-	off(eventName, handler) {
-		this.#emitter.off(eventName, handler);
-	}
-	/**
-	* Returns the number of listeners registered for `eventName`.
-	*
-	* @example
-	* ```ts
-	* emitter.on('build', handler)
-	* emitter.listenerCount('build') // 1
-	* ```
-	*/
-	listenerCount(eventName) {
-		return this.#emitter.listenerCount(eventName);
-	}
-	/**
-	* Raises or lowers the per-event listener ceiling before Node warns about a memory leak.
-	* Set this above the expected listener count when many listeners attach by design.
-	*
-	* @example
-	* ```ts
-	* emitter.setMaxListeners(40)
-	* ```
-	*/
-	setMaxListeners(max) {
-		this.#emitter.setMaxListeners(max);
-	}
-	/**
-	* Removes all listeners from every event channel.
-	*
-	* @example
-	* ```ts
-	* emitter.removeAll()
-	* ```
-	*/
-	removeAll() {
-		this.#emitter.removeAllListeners();
-	}
-};
-//#endregion
 //#region ../../internals/utils/src/time.ts
 /**
 * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.
@@ -265,6 +156,43 @@ function formatMsWithColor(ms) {
 	return styleText("red", formatted);
 }
 //#endregion
+//#region ../../internals/utils/src/promise.ts
+/**
+* Wraps `run` so invocations never overlap: a trigger that lands while a run is in flight
+* marks it dirty and runs once more after it finishes, no matter how many triggers arrived.
+* Useful for event-driven reruns (a file watcher, a queue drain) where bursts should
+* coalesce into a single trailing run.
+*
+* @example
+* ```ts
+* const rebuild = createSerialRunner({
+*   run: () => build(),
+*   onError: (error) => log.error(error.message),
+* })
+* watcher.on('change', () => void rebuild())
+* ```
+*/
+function createSerialRunner({ run, onError }) {
+	let running = false;
+	let dirty = false;
+	return async () => {
+		if (running) {
+			dirty = true;
+			return;
+		}
+		running = true;
+		do {
+			dirty = false;
+			try {
+				await run();
+			} catch (error) {
+				onError(toError(error));
+			}
+		} while (dirty);
+		running = false;
+	};
+}
+//#endregion
 //#region src/loggers/defineLogger.ts
 /**
 * Type-safe helper for authoring a {@link Logger}.
@@ -274,7 +202,7 @@ function formatMsWithColor(ms) {
 * export const myLogger = defineLogger({
 *   name: 'my-logger',
 *   install(context) {
-*     context.on('kubb:info', ({ message }) => console.log('ℹ', message))
+*     context.hook('kubb:info', ({ message }) => console.log('ℹ', message))
 *   },
 * })
 * ```
@@ -326,8 +254,8 @@ const clackLogger = defineLogger({
 		function getMessage(message) {
 			return formatMessage(message, logLevel$5);
 		}
-		function onStep(event, message) {
-			context.on(event, () => {
+		function onStep(hook, message) {
+			context.hook(hook, () => {
 				if (logLevel$5 <= logLevel.silent) return;
 				clack.log.step(getMessage(message));
 			});
@@ -337,7 +265,7 @@ const clackLogger = defineLogger({
 			state.spinner.stop(text);
 			state.isSpinning = false;
 		}
-		context.on("kubb:info", ({ message, info = "" }) => {
+		context.hook("kubb:info", ({ message, info = "" }) => {
 			if (logLevel$5 <= logLevel.silent) return;
 			const text = getMessage([
 				styleText("blue", "ℹ"),
@@ -350,7 +278,7 @@ const clackLogger = defineLogger({
 			}
 			clack.log.info(text);
 		});
-		context.on("kubb:success", ({ message, info = "" }) => {
+		context.hook("kubb:success", ({ message, info = "" }) => {
 			if (logLevel$5 <= logLevel.silent) return;
 			const text = getMessage([
 				styleText("blue", "✓"),
@@ -363,7 +291,7 @@ const clackLogger = defineLogger({
 			}
 			clack.log.success(text);
 		});
-		context.on("kubb:warn", ({ message, info }) => {
+		context.hook("kubb:warn", ({ message, info }) => {
 			if (logLevel$5 < logLevel.warn) return;
 			const text = getMessage([
 				styleText("yellow", "⚠"),
@@ -372,25 +300,23 @@ const clackLogger = defineLogger({
 			].filter(Boolean).join(" "));
 			clack.log.warn(text);
 		});
-		context.on("kubb:error", ({ error }) => {
-			const caused = toCause(error);
+		context.hook("kubb:error", ({ error }) => {
 			const text = [styleText("red", "✗"), error.message].join(" ");
 			if (state.isSpinning) {
 				stopSpinner(getMessage(text));
 				return;
 			}
 			clack.log.error(getMessage(text));
-			if (logLevel$5 >= logLevel.verbose && error.stack) {
-				const frames = error.stack.split("\n").slice(1, 4);
-				for (const frame of frames) clack.log.message(getMessage(styleText("dim", frame.trim())));
-				if (caused?.stack) {
-					clack.log.message(styleText("dim", `└─ caused by ${caused.message}`));
-					const frames = caused.stack.split("\n").slice(1, 4);
-					for (const frame of frames) clack.log.message(getMessage(`    ${styleText("dim", frame.trim())}`));
+			const frames = logLevel$5 >= logLevel.verbose ? formatErrorFrames(error) : null;
+			if (frames) {
+				for (const frame of frames.frames) clack.log.message(getMessage(styleText("dim", frame)));
+				if (frames.cause) {
+					clack.log.message(styleText("dim", frames.cause.header));
+					for (const frame of frames.cause.frames) clack.log.message(getMessage(`    ${styleText("dim", frame)}`));
 				}
 			}
 		});
-		context.on("kubb:diagnostic", ({ diagnostic }) => {
+		context.hook("kubb:diagnostic", ({ diagnostic }) => {
 			if (logLevel$5 <= logLevel.silent && diagnostic.severity !== "error") return;
 			stopSpinner();
 			stopActiveProgress();
@@ -412,7 +338,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 				secondarySymbol: ""
 			});
 		});
-		context.on("kubb:lifecycle:start", async ({ version }) => {
+		context.hook("kubb:lifecycle:start", async ({ version }) => {
 			console.log(`\n${getIntro({
 				title: "The meta framework for code generation",
 				description: "Ready to start",
@@ -421,14 +347,14 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 			})}\n`);
 			reset();
 		});
-		context.on("kubb:generation:start", ({ config }) => {
+		context.hook("kubb:generation:start", ({ config }) => {
 			reset();
 			state.totalPlugins = config.plugins?.length ?? 0;
 			if (logLevel$5 <= logLevel.silent) return;
 			const text = getMessage(["Generation started", config.name ? `for ${styleText("dim", config.name)}` : void 0].filter(Boolean).join(" "));
 			clack.intro(text);
 		});
-		context.on("kubb:plugin:start", ({ plugin }) => {
+		context.hook("kubb:plugin:start", ({ plugin }) => {
 			if (logLevel$5 <= logLevel.silent) return;
 			stopSpinner();
 			state.runningPlugins.add(plugin.name);
@@ -446,7 +372,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 			progressBar.advance(state.completedPlugins + state.failedPlugins, pluginProgressText());
 			state.activeProgress.set("plugins", { progressBar });
 		});
-		context.on("kubb:plugin:end", ({ plugin, success }) => {
+		context.hook("kubb:plugin:end", ({ plugin, success }) => {
 			stopSpinner();
 			const active = state.activeProgress.get("plugins");
 			if (!active || logLevel$5 === logLevel.silent) return;
@@ -459,7 +385,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 				showProgressStep();
 			}
 		});
-		context.on("kubb:files:processing:start", ({ files }) => {
+		context.hook("kubb:files:processing:start", ({ files }) => {
 			if (logLevel$5 <= logLevel.silent) return;
 			stopSpinner();
 			state.totalFiles = files.length;
@@ -470,11 +396,11 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 				max: files.length,
 				size: 30
 			});
-			context.emit("kubb:info", { message: text });
+			context.callHook("kubb:info", { message: text });
 			progressBar.start(getMessage(text));
 			state.activeProgress.set("files", { progressBar });
 		});
-		context.on("kubb:files:processing:update", ({ files }) => {
+		context.hook("kubb:files:processing:update", ({ files }) => {
 			if (logLevel$5 <= logLevel.silent) return;
 			stopSpinner();
 			const active = state.activeProgress.get("files");
@@ -483,7 +409,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 				if (active) active.progressBar.advance(void 0, `Writing ${relative(config.root, file.path)}`);
 			}
 		});
-		context.on("kubb:files:processing:end", () => {
+		context.hook("kubb:files:processing:end", () => {
 			if (logLevel$5 <= logLevel.silent) return;
 			stopSpinner();
 			const text = getMessage("Files written successfully");
@@ -493,7 +419,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 			state.activeProgress.delete("files");
 			showProgressStep();
 		});
-		context.on("kubb:generation:end", ({ config }) => {
+		context.hook("kubb:generation:end", ({ config }) => {
 			stopSpinner();
 			const text = getMessage(config.name ? `Generation completed for ${styleText("dim", config.name)}` : "Generation completed");
 			clack.outro(text);
@@ -501,7 +427,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 		onStep("kubb:format:start", "Formatting");
 		onStep("kubb:lint:start", "Linting");
 		onStep("kubb:hooks:start", "Running hooks");
-		context.on("kubb:hook:start", ({ id, command, args }) => {
+		context.hook("kubb:hook:start", ({ id, command, args }) => {
 			if (logLevel$5 <= logLevel.silent || !id) return;
 			stopSpinner();
 			const title = getMessage(`Running ${styleText("dim", formatCommandWithArgs(command, args))}`);
@@ -511,10 +437,10 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 				hrStart: process$1.hrtime()
 			});
 		});
-		if (logLevel$5 > logLevel.silent) context.on("kubb:hook:line", ({ id, line }) => {
+		if (logLevel$5 > logLevel.silent) context.hook("kubb:hook:line", ({ id, line }) => {
 			state.activeHookLogs.get(id)?.taskLog.message(styleText("dim", line));
 		});
-		context.on("kubb:hook:end", ({ id, command, args, success, error, stdout, stderr }) => {
+		context.hook("kubb:hook:end", ({ id, command, args, success, error, stdout, stderr }) => {
 			if (!id) return;
 			if (logLevel$5 <= logLevel.silent) {
 				if (!success) {
@@ -534,7 +460,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 				active.taskLog.error(getMessage(`${styleText("dim", commandWithArgs)} failed${reason}`), { showLog: true });
 			}
 		});
-		context.on("kubb:lifecycle:end", () => {
+		context.hook("kubb:lifecycle:end", () => {
 			reset();
 		});
 	}
@@ -552,13 +478,13 @@ const plainLogger = defineLogger({
 		function getMessage(message) {
 			return formatMessage(message, logLevel$4);
 		}
-		function onStep(event, message) {
-			context.on(event, () => {
+		function onStep(hook, message) {
+			context.hook(hook, () => {
 				if (logLevel$4 <= logLevel.silent) return;
 				console.log(getMessage(message));
 			});
 		}
-		context.on("kubb:info", ({ message, info }) => {
+		context.hook("kubb:info", ({ message, info }) => {
 			if (logLevel$4 <= logLevel.silent) return;
 			const text = getMessage([
 				"ℹ",
@@ -567,7 +493,7 @@ const plainLogger = defineLogger({
 			].join(" "));
 			console.log(text);
 		});
-		context.on("kubb:success", ({ message, info = "" }) => {
+		context.hook("kubb:success", ({ message, info = "" }) => {
 			if (logLevel$4 <= logLevel.silent) return;
 			const text = getMessage([
 				"✓",
@@ -576,7 +502,7 @@ const plainLogger = defineLogger({
 			].filter(Boolean).join(" "));
 			console.log(text);
 		});
-		context.on("kubb:warn", ({ message, info }) => {
+		context.hook("kubb:warn", ({ message, info }) => {
 			if (logLevel$4 < logLevel.warn) return;
 			const text = getMessage([
 				"⚠",
@@ -585,57 +511,55 @@ const plainLogger = defineLogger({
 			].filter(Boolean).join(" "));
 			console.log(text);
 		});
-		context.on("kubb:error", ({ error }) => {
-			const caused = toCause(error);
+		context.hook("kubb:error", ({ error }) => {
 			const text = getMessage(["✗", error.message].join(" "));
 			console.log(text);
-			if (logLevel$4 >= logLevel.verbose && error.stack) {
-				const frames = error.stack.split("\n").slice(1, 4);
-				for (const frame of frames) console.log(getMessage(frame.trim()));
-				if (caused?.stack) {
-					console.log(`└─ caused by ${caused.message}`);
-					const frames = caused.stack.split("\n").slice(1, 4);
-					for (const frame of frames) console.log(getMessage(`    ${frame.trim()}`));
+			const frames = logLevel$4 >= logLevel.verbose ? formatErrorFrames(error) : null;
+			if (frames) {
+				for (const frame of frames.frames) console.log(getMessage(frame));
+				if (frames.cause) {
+					console.log(frames.cause.header);
+					for (const frame of frames.cause.frames) console.log(getMessage(`    ${frame}`));
 				}
 			}
 		});
-		context.on("kubb:diagnostic", ({ diagnostic }) => {
+		context.hook("kubb:diagnostic", ({ diagnostic }) => {
 			if (logLevel$4 <= logLevel.silent && diagnostic.severity !== "error") return;
 			console.log(getMessage(Diagnostics.formatLines(diagnostic).join("\n")));
 		});
-		context.on("kubb:lifecycle:start", ({ version }) => {
+		context.hook("kubb:lifecycle:start", ({ version }) => {
 			console.log(`Kubb CLI v${version}`);
 		});
-		context.on("kubb:generation:start", () => {
+		context.hook("kubb:generation:start", () => {
 			const text = getMessage("Generation started");
 			console.log(text);
 		});
-		context.on("kubb:plugin:start", ({ plugin }) => {
+		context.hook("kubb:plugin:start", ({ plugin }) => {
 			if (logLevel$4 <= logLevel.silent) return;
 			const text = getMessage(`Generating ${plugin.name}`);
 			console.log(text);
 		});
-		context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
+		context.hook("kubb:plugin:end", ({ plugin, duration, success }) => {
 			if (logLevel$4 <= logLevel.silent) return;
 			const durationStr = formatMs(duration);
 			const text = getMessage(success ? `${plugin.name} completed in ${durationStr}` : `${plugin.name} failed in ${durationStr}`);
 			console.log(text);
 		});
-		context.on("kubb:files:processing:start", ({ files }) => {
+		context.hook("kubb:files:processing:start", ({ files }) => {
 			if (logLevel$4 <= logLevel.silent) return;
 			const text = getMessage(`Writing ${files.length} files`);
 			console.log(text);
 		});
-		context.on("kubb:files:processing:update", ({ files }) => {
+		context.hook("kubb:files:processing:update", ({ files }) => {
 			if (logLevel$4 <= logLevel.silent) return;
 			for (const { file, config } of files) console.log(getMessage(`Writing ${relative(config.root, file.path)}`));
 		});
-		context.on("kubb:files:processing:end", () => {
+		context.hook("kubb:files:processing:end", () => {
 			if (logLevel$4 <= logLevel.silent) return;
 			const text = getMessage("Files written successfully");
 			console.log(text);
 		});
-		context.on("kubb:generation:end", ({ config }) => {
+		context.hook("kubb:generation:end", ({ config }) => {
 			const text = getMessage(config.name ? `Generation completed for ${config.name}` : "Generation completed");
 			console.log(text);
 		});
@@ -645,13 +569,13 @@ const plainLogger = defineLogger({
 		onStep("kubb:lint:end", "Lint completed");
 		onStep("kubb:hooks:start", "Hooks started");
 		onStep("kubb:hooks:end", "Hooks completed");
-		context.on("kubb:hook:start", ({ id, command, args }) => {
+		context.hook("kubb:hook:start", ({ id, command, args }) => {
 			if (logLevel$4 <= logLevel.silent) return;
 			if (id) hookTimer.start(id);
 			const commandWithArgs = formatCommandWithArgs(command, args);
 			console.log(getMessage(`Hook ${commandWithArgs} started`));
 		});
-		context.on("kubb:hook:end", ({ id, command, args, success, error, stdout, stderr }) => {
+		context.hook("kubb:hook:end", ({ id, command, args, success, error, stdout, stderr }) => {
 			if (logLevel$4 <= logLevel.silent) return;
 			const ms = id ? hookTimer.end(id) : void 0;
 			const durationStr = ms !== void 0 ? ` in ${formatMs(ms)}` : "";
@@ -682,6 +606,22 @@ function formatMessage(message, logLevel$3) {
 	return message;
 }
 /**
+* First stack frames for verbose error output, including an optional `cause` chain.
+*/
+function formatErrorFrames(error) {
+	if (!error.stack) return null;
+	const frames = error.stack.split("\n").slice(1, 4).map((frame) => frame.trim());
+	const caused = toCause(error);
+	if (!caused?.stack) return { frames };
+	return {
+		frames,
+		cause: {
+			header: `└─ caused by ${caused.message}`,
+			frames: caused.stack.split("\n").slice(1, 4).map((frame) => frame.trim())
+		}
+	};
+}
+/**
 * Build the progress summary line shown by the clack logger.
 * Returns null when there is nothing to display.
 */
@@ -742,9 +682,6 @@ function createHookTimer() {
 			if (!hrStart) return;
 			starts.delete(id);
 			return getElapsedMs(hrStart);
-		},
-		clear() {
-			starts.clear();
 		}
 	};
 }
@@ -757,20 +694,12 @@ function createHookTimer() {
 function formatCommandWithArgs(command, args) {
 	return args?.length ? `${command} ${args.join(" ")}` : command;
 }
-function detectLogger() {
-	if (canUseTTY()) return "clack";
-	return "plain";
-}
-const logMapper = {
-	clack: clackLogger,
-	plain: plainLogger
-};
 /**
-* Bridges a {@link Reporter} onto the run's event emitter: calls `report` with each config's
+* Bridges a {@link Reporter} onto the run's hook emitter: calls `report` with each config's
 * {@link GenerationResult} on `kubb:generation:end`. The reporter never touches the emitter.
 */
 function installReporter(context, reporter, ctx) {
-	context.on("kubb:generation:end", async ({ config, diagnostics = [], filesCreated = 0, status = "success", hrStart = process$1.hrtime() }) => {
+	context.hook("kubb:generation:end", async ({ config, diagnostics = [], filesCreated = 0, status = "success", hrStart = process$1.hrtime() }) => {
 		await reporter.report({
 			config,
 			diagnostics,
@@ -779,7 +708,7 @@ function installReporter(context, reporter, ctx) {
 			hrStart
 		}, ctx);
 	});
-	if (reporter.drain) context.on("kubb:lifecycle:end", () => reporter.drain?.(ctx));
+	if (reporter.drain) context.hook("kubb:lifecycle:end", () => reporter.drain?.(ctx));
 }
 /**
 * Installs the live logger (the TUI view) and the given reporters (the output). The reporters are
@@ -798,10 +727,7 @@ async function setupReporters(context, { logLevel, reporters }) {
 	for (const reporter of reporters) {
 		if (reporter.name === "cli") {
 			if (hasJson) continue;
-			const type = detectLogger();
-			const logger = logMapper[type];
-			if (!logger) throw new Error(`Unknown adapter type: ${type}`);
-			await logger.install(context, { logLevel });
+			await (canUseTTY() ? clackLogger : plainLogger).install(context, { logLevel });
 		}
 		installReporter(context, reporter, ctx);
 	}
@@ -912,6 +838,34 @@ async function getConfigs({ configPath, input, watch, logLevel }) {
 		}))
 	};
 }
+let hookSequence = 0;
+/**
+* Returns a process-unique id that correlates a hook's `kubb:hook:start` and `kubb:hook:end`
+* emissions, which loggers use to key their per-hook state.
+*/
+function createHookId() {
+	hookSequence += 1;
+	return `hook-${hookSequence}`;
+}
+/**
+* Returns `true` when `latest` is a newer semver version than `current`. Compares each numeric
+* part, so `5.10.0` beats `5.9.0` where a plain string comparison would not. Prerelease
+* suffixes are ignored, and a malformed version never reports an update.
+*
+* @example Double-digit minor
+* `isNewerVersion('5.9.0', '5.10.0') // true`
+*
+* @example String comparison would get this wrong the other way
+* `isNewerVersion('5.10.0', '5.9.0') // false`
+*/
+function isNewerVersion(current, latest) {
+	const release = (value) => value.split("-")[0] ?? "";
+	const isNumeric = (value) => /^\d+(\.\d+)*$/.test(value);
+	const currentRelease = release(current);
+	const latestRelease = release(latest);
+	if (!isNumeric(currentRelease) || !isNumeric(latestRelease)) return false;
+	return currentRelease.localeCompare(latestRelease, void 0, { numeric: true }) < 0;
+}
 /**
 * Tokenizes a shell command string, respecting single and double quotes.
 *
@@ -925,65 +879,74 @@ function tokenize(command) {
 	return (command.match(/[^\s"']+|"([^"]*)"|'([^']*)'/g) ?? []).map((token) => token.replace(/^["']|["']$/g, ""));
 }
 /**
-* Runs the `done` hooks defined in a Kubb config in sequence.
+* Runs the `done` hooks defined in a Kubb config in sequence and returns each hook's outcome,
+* so the caller can turn failures into diagnostics.
 */
 async function executeHooks({ configHooks, hooks }) {
 	const commands = Array.isArray(configHooks.done) ? configHooks.done : [configHooks.done].filter(Boolean);
+	const results = [];
 	for (const command of commands) {
 		const [cmd, ...args] = tokenize(command);
 		if (!cmd) continue;
-		const hookId = hash("sha256", command, "hex");
+		const hookId = createHookId();
 		const commandWithArgs = [cmd, ...args].join(" ");
-		await hooks.emit("kubb:hook:start", {
+		await hooks.callHook("kubb:hook:start", {
 			id: hookId,
 			command: cmd,
 			args
 		});
-		await runHook({
+		results.push(await runHook({
 			id: hookId,
 			command: cmd,
 			args,
 			commandWithArgs,
 			hooks
-		});
+		}));
 	}
+	return results;
 }
 /**
-* Spawns a hook command and reports its outcome through `kubb:hook:end`.
-* A non-zero exit signals failure via `kubb:hook:end` rather than throwing, so the caller can turn
+* Spawns a hook command and returns its outcome, mirroring it through `kubb:hook:end` for the
+* loggers. A non-zero exit returns `success: false` rather than throwing, so the caller can turn
 * it into a diagnostic. Other spawn errors do the same. Output is streamed through `kubb:hook:line`
 * only while a listener is attached.
 */
 async function runHook({ id, command, args, commandWithArgs, hooks }) {
-	const emitEnd = (success, error, output) => hooks.emit("kubb:hook:end", {
-		command,
-		args,
-		id,
-		success,
-		error,
-		...output
-	});
+	const emitEnd = async (result) => {
+		await hooks.callHook("kubb:hook:end", {
+			command,
+			args,
+			id,
+			...result
+		});
+		return result;
+	};
 	const stream = hooks.listenerCount("kubb:hook:line") > 0;
 	try {
 		const proc = x(command, [...args ?? []], {
 			nodeOptions: { detached: process$1.platform !== "win32" },
 			throwOnError: true
 		});
-		if (stream) for await (const line of proc) await hooks.emit("kubb:hook:line", {
+		if (stream) for await (const line of proc) await hooks.callHook("kubb:hook:line", {
 			id,
 			line
 		});
 		await proc;
-		await hooks.emit("kubb:success", { message: `${styleText("dim", commandWithArgs)} successfully executed` });
-		await emitEnd(true, null);
+		await hooks.callHook("kubb:success", { message: `${styleText("dim", commandWithArgs)} successfully executed` });
+		return emitEnd({
+			success: true,
+			error: null
+		});
 	} catch (err) {
-		if (!(err instanceof NonZeroExitError)) {
-			await emitEnd(false, toError(err));
-			return;
-		}
+		if (!(err instanceof NonZeroExitError)) return emitEnd({
+			success: false,
+			error: toError(err)
+		});
 		const stderr = err.output?.stderr ?? "";
 		const stdout = err.output?.stdout ?? "";
-		await emitEnd(false, /* @__PURE__ */ new Error(`Hook execute failed: ${commandWithArgs}`), {
+		return emitEnd({
+			success: false,
+			error: /* @__PURE__ */ new Error(`Hook execute failed: ${commandWithArgs}`),
 			stdout,
 			stderr
 		});
@@ -991,7 +954,9 @@ async function runHook({ id, command, args, commandWithArgs, hooks }) {
 }
 /**
 * Starts a file watcher on the given paths and calls `cb` on any change.
-* Ignores `.git` and `node_modules` directories.
+* Ignores `.git` and `node_modules` directories. Event bursts (an editor save emits several)
+* are debounced into one build, and builds never overlap: changes during a build queue exactly
+* one rebuild.
 */
 async function startWatcher(path, cb, log = {
 	info: console.log,
@@ -1000,7 +965,8 @@ async function startWatcher(path, cb, log = {
 	const { watch } = await import("chokidar");
 	const watcher = watch(path, {
 		ignorePermissionErrors: true,
-		ignored: WATCHER_IGNORED_PATHS
+		ignored: WATCHER_IGNORED_PATHS,
+		ignoreInitial: true
 	});
 	process$1.once("SIGINT", () => {
 		watcher.close();
@@ -1008,78 +974,70 @@ async function startWatcher(path, cb, log = {
 	process$1.once("SIGTERM", () => {
 		watcher.close();
 	});
-	watcher.on("all", async (type, file) => {
+	const runBuild = createSerialRunner({
+		run: () => cb(path),
+		onError: () => log.error(styleText("red", "Watcher failed"))
+	});
+	let debounceTimer = null;
+	watcher.on("all", (type, file) => {
 		log.info(styleText("yellow", styleText("bold", `Change detected: ${type} ${file}`)));
-		try {
-			await cb(path);
-		} catch (_e) {
-			log.error(styleText("red", "Watcher failed"));
-		}
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(() => {
+			debounceTimer = null;
+			runBuild();
+		}, 100);
 	});
 }
 //#endregion
 //#region src/runners/generate/run.ts
 /**
-* Registers a one-shot `kubb:hook:end` listener for `hookId` before the caller emits `kubb:hook:start`,
-* so a synchronous emitter cannot fire end before the listener is attached.
+* Runs one formatter or linter pass over the output directory. Returns the failure instead of
+* throwing, so the caller can turn it into a coded diagnostic. Failures never render here:
+* the caller emits them through `Diagnostics.emit`, like every other diagnostic.
 */
-function waitForHookEnd(hooks, hookId, onSuccess, fallbackErrorMessage) {
-	return new Promise((resolve, reject) => {
-		const handler = (ctx) => {
-			if (ctx.id !== hookId) return;
-			hooks.off("kubb:hook:end", handler);
-			if (!ctx.success) {
-				reject(ctx.error ?? new Error(fallbackErrorMessage));
-				return;
-			}
-			Promise.resolve(onSuccess()).then(resolve).catch(reject);
-		};
-		hooks.on("kubb:hook:end", handler);
-	});
-}
-async function runToolPass({ toolValue, detect, toolMap, toolLabel, successPrefix, noToolMessage, configName, outputPath, logLevel: logLevel$1, hooks, onStart, onEnd }) {
+async function runToolPass({ toolValue, detect, toolMap, toolLabel, successPrefix, noToolMessage, outputPath, logLevel: logLevel$1, hooks, onStart, onEnd }) {
 	await onStart();
 	let resolvedTool = toolValue;
 	if (resolvedTool === "auto") {
 		const detected = await detect();
-		if (!detected) await hooks.emit("kubb:warn", { message: noToolMessage });
+		if (!detected) await hooks.callHook("kubb:warn", { message: noToolMessage });
 		else {
 			resolvedTool = detected;
-			await hooks.emit("kubb:info", { message: `Auto-detected ${toolLabel}: ${styleText("dim", resolvedTool)}` });
+			await hooks.callHook("kubb:info", { message: `Auto-detected ${toolLabel}: ${styleText("dim", resolvedTool)}` });
 		}
 	}
-	let toolError;
+	let toolError = null;
 	if (resolvedTool && resolvedTool !== "auto" && resolvedTool in toolMap && existsSync(outputPath)) {
 		const toolConfig = toolMap[resolvedTool];
-		const hookId = hash("sha256", [configName, resolvedTool].filter(Boolean).join("-"), "hex");
 		const successMessage = [
 			`${successPrefix} with ${styleText("dim", resolvedTool)}`,
 			logLevel$1 >= logLevel.info ? `on ${styleText("dim", outputPath)}` : void 0,
 			"successfully"
 		].filter(Boolean).join(" ");
 		try {
+			const hookId = createHookId();
 			const hookArgs = toolConfig.args(outputPath);
 			const commandWithArgs = [toolConfig.command, ...hookArgs].join(" ");
-			const hookEndPromise = waitForHookEnd(hooks, hookId, () => hooks.emit("kubb:success", { message: successMessage }), toolConfig.errorMessage);
-			await hooks.emit("kubb:hook:start", {
+			await hooks.callHook("kubb:hook:start", {
 				id: hookId,
 				command: toolConfig.command,
 				args: hookArgs
 			});
-			runHook({
+			const result = await runHook({
 				id: hookId,
 				command: toolConfig.command,
 				args: hookArgs,
 				commandWithArgs,
 				hooks
-			}).catch(() => {});
-			await hookEndPromise;
+			});
+			if (result.success) await hooks.callHook("kubb:success", { message: successMessage });
+			else toolError = result.error ?? new Error(toolConfig.errorMessage);
 		} catch (caughtError) {
 			toolError = toError(caughtError);
 		}
 	}
 	await onEnd();
-	if (toolError) throw toolError;
+	return toolError;
 }
 async function generate(options) {
 	const { input, hooks, logLevel } = options;
@@ -1090,22 +1048,21 @@ async function generate(options) {
 		input: inputPath ? {
 			...options.config.input,
 			path: inputPath
-		} : options.config.input,
-		...options.config.output
+		} : options.config.input
 	};
 	const kubb = createKubb(config, { hooks });
-	await hooks.emit("kubb:generation:start", { config });
-	await hooks.emit("kubb:info", {
+	await hooks.callHook("kubb:generation:start", { config });
+	await hooks.callHook("kubb:info", {
 		message: config.name ? `Setup generation ${styleText("bold", config.name)}` : "Setup generation",
 		info: inputPath
 	});
 	await kubb.setup();
-	await hooks.emit("kubb:info", {
+	await hooks.callHook("kubb:info", {
 		message: config.name ? `Build generation ${styleText("bold", config.name)}` : "Build generation",
 		info: inputPath
 	});
 	const { files, diagnostics, driver } = await kubb.safeBuild();
-	await hooks.emit("kubb:info", { message: "Load summary" });
+	await hooks.callHook("kubb:info", { message: "Load summary" });
 	const telemetryPlugins = Array.from(driver.plugins.values(), (p) => ({
 		name: p.name,
 		options: p.options
@@ -1121,11 +1078,11 @@ async function generate(options) {
 	for (const diagnostic of diagnostics) {
 		if (!Diagnostics.isProblem(diagnostic)) continue;
 		const unknown = Diagnostics.narrow(diagnostic, Diagnostics.code.unknown);
-		if (unknown) await hooks.emit("kubb:error", { error: unknown.cause ?? new Error(unknown.message) });
+		if (unknown) await hooks.callHook("kubb:error", { error: unknown.cause ?? new Error(unknown.message) });
 		else await Diagnostics.emit(hooks, diagnostic);
 	}
 	if (Diagnostics.hasError(diagnostics)) {
-		await hooks.emit("kubb:generation:end", {
+		await hooks.callHook("kubb:generation:end", {
 			config,
 			storage: kubb.storage,
 			diagnostics,
@@ -1138,77 +1095,70 @@ async function generate(options) {
 	}
 	const outputPath = path.resolve(config.root, config.output.path);
 	const outputDiagnostics = [];
-	const toolPasses = [config.output.format && {
-		code: Diagnostics.code.formatFailed,
-		toolValue: config.output.format,
-		detect: () => detectTool([
-			"oxfmt",
-			"biome",
-			"prettier"
-		]),
-		toolMap: formatters,
-		toolLabel: "formatter",
-		successPrefix: "Formatting",
-		noToolMessage: "No formatter found (oxfmt, biome, or prettier). Skipping formatting.",
-		onStart: () => hooks.emit("kubb:format:start"),
-		onEnd: () => hooks.emit("kubb:format:end")
-	}, config.output.lint && {
-		code: Diagnostics.code.lintFailed,
-		toolValue: config.output.lint,
-		detect: () => detectTool([
-			"oxlint",
-			"biome",
-			"eslint"
-		]),
-		toolMap: linters,
-		toolLabel: "linter",
-		successPrefix: "Linting",
-		noToolMessage: "No linter found (oxlint, biome, or eslint). Skipping linting.",
-		onStart: () => hooks.emit("kubb:lint:start"),
-		onEnd: () => hooks.emit("kubb:lint:end")
-	}].filter(Boolean);
-	for (const { code, ...pass } of toolPasses) try {
-		await runToolPass({
-			...pass,
-			configName: config.name,
+	const reportOutputFailure = async (code, label, error) => {
+		const diagnostic = outputDiagnostic(code, label, error);
+		outputDiagnostics.push(diagnostic);
+		await Diagnostics.emit(hooks, diagnostic);
+	};
+	if (config.output.format) {
+		const error = await runToolPass({
+			toolValue: config.output.format,
+			detect: () => detectTool([
+				"oxfmt",
+				"biome",
+				"prettier"
+			]),
+			toolMap: formatters,
+			toolLabel: "formatter",
+			successPrefix: "Formatting",
+			noToolMessage: "No formatter found (oxfmt, biome, or prettier). Skipping formatting.",
+			onStart: () => hooks.callHook("kubb:format:start"),
+			onEnd: () => hooks.callHook("kubb:format:end"),
 			outputPath,
 			logLevel,
 			hooks
 		});
-	} catch (caughtError) {
-		const diagnostic = outputDiagnostic(code, pass.toolLabel, caughtError);
-		outputDiagnostics.push(diagnostic);
-		await Diagnostics.emit(hooks, diagnostic);
+		if (error) await reportOutputFailure(Diagnostics.code.formatFailed, "formatter", error);
+	}
+	if (config.output.lint) {
+		const error = await runToolPass({
+			toolValue: config.output.lint,
+			detect: () => detectTool([
+				"oxlint",
+				"biome",
+				"eslint"
+			]),
+			toolMap: linters,
+			toolLabel: "linter",
+			successPrefix: "Linting",
+			noToolMessage: "No linter found (oxlint, biome, or eslint). Skipping linting.",
+			onStart: () => hooks.callHook("kubb:lint:start"),
+			onEnd: () => hooks.callHook("kubb:lint:end"),
+			outputPath,
+			logLevel,
+			hooks
+		});
+		if (error) await reportOutputFailure(Diagnostics.code.lintFailed, "linter", error);
 	}
 	if (config.hooks) {
-		await hooks.emit("kubb:hooks:start");
-		const hookFailures = [];
-		const onHookEnd = (ctx) => {
-			if (!ctx.success) hookFailures.push(ctx.error ?? /* @__PURE__ */ new Error("Post-generate hook failed"));
-		};
-		hooks.on("kubb:hook:end", onHookEnd);
-		try {
-			await executeHooks({
-				configHooks: config.hooks,
-				hooks
-			});
-		} finally {
-			hooks.off("kubb:hook:end", onHookEnd);
-		}
-		for (const error of hookFailures) {
-			const diagnostic = outputDiagnostic(Diagnostics.code.hookFailed, "Post-generate hook", error);
-			outputDiagnostics.push(diagnostic);
-			await Diagnostics.emit(hooks, diagnostic);
+		await hooks.callHook("kubb:hooks:start");
+		const hookResults = await executeHooks({
+			configHooks: config.hooks,
+			hooks
+		});
+		for (const result of hookResults) {
+			if (result.success) continue;
+			await reportOutputFailure(Diagnostics.code.hookFailed, "Post-generate hook", result.error ?? /* @__PURE__ */ new Error("Post-generate hook failed"));
 		}
-		await hooks.emit("kubb:hooks:end");
+		await hooks.callHook("kubb:hooks:end");
 	}
 	const finalDiagnostics = [...diagnostics, ...outputDiagnostics];
 	const failed = Diagnostics.hasError(outputDiagnostics);
-	if (!failed) await hooks.emit("kubb:success", {
+	if (!failed) await hooks.callHook("kubb:success", {
 		message: "Generation succeeded",
 		info: inputPath
 	});
-	await hooks.emit("kubb:generation:end", {
+	await hooks.callHook("kubb:generation:end", {
 		config,
 		storage: kubb.storage,
 		diagnostics: finalDiagnostics,
@@ -1235,8 +1185,8 @@ function outputDiagnostic(code, label, caughtError) {
 }
 async function checkForUpdate(hooks) {
 	try {
-		const data = await (await fetch(KUBB_NPM_PACKAGE_URL)).json();
-		if (data.version && version < data.version) await Diagnostics.emit(hooks, Diagnostics.update({
+		const data = await (await fetch(KUBB_NPM_PACKAGE_URL, { signal: AbortSignal.timeout(UPDATE_CHECK_TIMEOUT_MS) })).json();
+		if (data.version && isNewerVersion(version, data.version)) await Diagnostics.emit(hooks, Diagnostics.update({
 			currentVersion: version,
 			latestVersion: data.version
 		}));
@@ -1249,7 +1199,7 @@ async function checkForUpdate(hooks) {
 */
 async function run({ input, configPath, logLevel: logLevelKey, watch, reporters: cliReporters }) {
 	const logLevel$2 = logLevel[logLevelKey] ?? logLevel.info;
-	const hooks = new AsyncEventEmitter();
+	const hooks = new Hookable();
 	let configs;
 	let resolvedConfigPath;
 	try {
@@ -1266,7 +1216,7 @@ async function run({ input, configPath, logLevel: logLevelKey, watch, reporters:
 			logLevel: logLevel$2,
 			reporters: [cliReporter]
 		});
-		await hooks.emit("kubb:error", { error: toError(error) });
+		await hooks.callHook("kubb:error", { error: toError(error) });
 		process$1.exit(1);
 	}
 	const requestedNames = cliReporters?.length ? cliReporters : ["cli"];
@@ -1274,32 +1224,40 @@ async function run({ input, configPath, logLevel: logLevelKey, watch, reporters:
 		logLevel: logLevel$2,
 		reporters: selectReporters(configs[0]?.reporters ?? [], requestedNames)
 	});
-	await hooks.emit("kubb:lifecycle:start", { version });
+	await hooks.callHook("kubb:lifecycle:start", { version });
 	await checkForUpdate(hooks);
 	try {
 		const relativeConfigPath = path.relative(process$1.cwd(), resolvedConfigPath);
-		await hooks.emit("kubb:info", {
+		await hooks.callHook("kubb:info", {
 			message: "Config loaded",
 			info: relativeConfigPath
 		});
-		await hooks.emit("kubb:success", {
+		await hooks.callHook("kubb:success", {
 			message: "Config loaded successfully",
 			info: relativeConfigPath
 		});
 		let anyFailed = false;
-		for (const config of configs) if (config.input && "path" in config.input && watch) await startWatcher([input || config.input.path], async (paths) => {
-			await generate({
-				input,
-				config,
-				logLevel: logLevel$2,
-				hooks
+		for (const config of configs) if (config.input && "path" in config.input && watch) {
+			const watchedPaths = [input || config.input.path];
+			const build = async (paths) => {
+				await generate({
+					input,
+					config,
+					logLevel: logLevel$2,
+					hooks
+				});
+				clack.log.step(styleText("yellow", `Watching for changes in ${paths.join(" and ")}`));
+			};
+			try {
+				await build(watchedPaths);
+			} catch (buildError) {
+				await hooks.callHook("kubb:error", { error: toError(buildError) });
+			}
+			await startWatcher(watchedPaths, build, {
+				info: (msg) => clack.log.info(msg),
+				error: (msg) => clack.log.error(msg)
 			});
-			clack.log.step(styleText("yellow", `Watching for changes in ${paths.join(" and ")}`));
-		}, {
-			info: (msg) => clack.log.info(msg),
-			error: (msg) => clack.log.error(msg)
-		});
-		else try {
+		} else try {
 			if (!await generate({
 				input,
 				config,
@@ -1307,17 +1265,17 @@ async function run({ input, configPath, logLevel: logLevelKey, watch, reporters:
 				hooks
 			})) anyFailed = true;
 		} catch (configError) {
-			await hooks.emit("kubb:error", { error: toError(configError) });
+			await hooks.callHook("kubb:error", { error: toError(configError) });
 			anyFailed = true;
 		}
-		await hooks.emit("kubb:lifecycle:end");
+		await hooks.callHook("kubb:lifecycle:end");
 		if (anyFailed) process$1.exit(1);
 	} catch (error) {
-		await hooks.emit("kubb:error", { error: toError(error) });
+		await hooks.callHook("kubb:error", { error: toError(error) });
 		process$1.exit(1);
 	}
 }
 //#endregion
 export { run };
 
-//# sourceMappingURL=run-D8TRnpBB.js.map
+//# sourceMappingURL=run-BxMfDivH.js.map