@kubb/cli 5.0.0-alpha.9 → 5.0.0-beta.10

package/dist/{generate-Cq5RDTBL.cjs → run-CVlrIZoW.cjs}

@@ -1,33 +1,41 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
-const require_errors = require("./errors-DBW0N9w4.cjs");
-const require_telemetry = require("./telemetry-DZ7IrLAU.cjs");
-const require_shell = require("./shell-7HPrTCJ5.cjs");
-const require_package = require("./package-BJ6ionm6.cjs");
-const require_constants = require("./constants-D0XHAHeZ.cjs");
+const require_errors = require("./errors-CLCjoSg0.cjs");
+const require_telemetry = require("./telemetry-B2iWkY5e.cjs");
+const require_shell = require("./shell-475fQKaX.cjs");
+const require_package = require("./package-DZ-6zAIO.cjs");
+const require_constants = require("./constants-BINTA5VZ.cjs");
 let node_util = require("node:util");
 let node_events = require("node:events");
 let node_crypto = require("node:crypto");
-require("node:fs");
+let node_child_process = require("node:child_process");
+let node_fs = require("node:fs");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
-node_path = require_chunk.__toESM(node_path);
+node_path = require_chunk.__toESM(node_path, 1);
 let node_process = require("node:process");
-node_process = require_chunk.__toESM(node_process);
+node_process = require_chunk.__toESM(node_process, 1);
 let _clack_prompts = require("@clack/prompts");
-_clack_prompts = require_chunk.__toESM(_clack_prompts);
+_clack_prompts = require_chunk.__toESM(_clack_prompts, 1);
 let _kubb_core = require("@kubb/core");
-let tinyexec = require("tinyexec");
 let node_stream = require("node:stream");
 let cosmiconfig = require("cosmiconfig");
 let jiti = require("jiti");
+let tinyexec = require("tinyexec");
 //#region ../../internals/utils/src/asyncEventEmitter.ts
 /**
-* A typed EventEmitter that awaits all async listeners before resolving.
+* 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 {
 	/**
-	* `maxListener` controls the maximum number of listeners per event before Node emits a memory-leak warning.
+	* Maximum number of listeners per event before Node emits a memory-leak warning.
 	* @default 10
 	*/
 	constructor(maxListener = 10) {
@@ -35,31 +43,48 @@ var AsyncEventEmitter = class {
 	}
 	#emitter = new node_events.EventEmitter();
 	/**
-	* Emits an event and awaits all registered listeners in parallel.
+	* 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')
+	* ```
 	*/
 	async emit(eventName, ...eventArgs) {
 		const listeners = this.#emitter.listeners(eventName);
 		if (listeners.length === 0) return;
-		await Promise.all(listeners.map(async (listener) => {
+		for (const listener of listeners) try {
+			await listener(...eventArgs);
+		} catch (err) {
+			let serializedArgs;
 			try {
-				return 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: require_errors.toError(err) });
+				serializedArgs = JSON.stringify(eventArgs);
+			} catch {
+				serializedArgs = String(eventArgs);
 			}
-		}));
+			throw new Error(`Error in async listener for "${eventName}" with eventArgs ${serializedArgs}`, { cause: require_errors.toError(err) });
+		}
 	}
-	/** Registers a persistent listener for the given event. */
+	/**
+	* Registers a persistent listener for `eventName`.
+	*
+	* @example
+	* ```ts
+	* emitter.on('build', async (name) => { console.log(name) })
+	* ```
+	*/
 	on(eventName, handler) {
 		this.#emitter.on(eventName, handler);
 	}
-	/** Registers a one-shot listener that removes itself after the first invocation. */
+	/**
+	* Registers a one-shot listener that removes itself after the first invocation.
+	*
+	* @example
+	* ```ts
+	* emitter.onOnce('build', async (name) => { console.log(name) })
+	* ```
+	*/
 	onOnce(eventName, handler) {
 		const wrapper = (...args) => {
 			this.off(eventName, wrapper);
@@ -67,11 +92,37 @@ var AsyncEventEmitter = class {
 		};
 		this.on(eventName, wrapper);
 	}
-	/** Removes a previously registered listener. */
+	/**
+	* Removes a previously registered listener.
+	*
+	* @example
+	* ```ts
+	* emitter.off('build', handler)
+	* ```
+	*/
 	off(eventName, handler) {
 		this.#emitter.off(eventName, handler);
 	}
-	/** Removes all listeners from every event channel. */
+	/**
+	* 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);
+	}
+	/**
+	* Removes all listeners from every event channel.
+	*
+	* @example
+	* ```ts
+	* emitter.removeAll()
+	* ```
+	*/
 	removeAll() {
 		this.#emitter.removeAllListeners();
 	}
@@ -79,8 +130,15 @@ var AsyncEventEmitter = class {
 //#endregion
 //#region ../../internals/utils/src/time.ts
 /**
-* Calculates elapsed time in milliseconds from a high-resolution start time.
-* Rounds to 2 decimal places to provide sub-millisecond precision without noise.
+* Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.
+* Rounds to 2 decimal places for sub-millisecond precision without noise.
+*
+* @example
+* ```ts
+* const start = process.hrtime()
+* doWork()
+* getElapsedMs(start) // 42.35
+* ```
 */
 function getElapsedMs(hrStart) {
 	const [seconds, nanoseconds] = process.hrtime(hrStart);
@@ -88,8 +146,14 @@ function getElapsedMs(hrStart) {
 	return Math.round(ms * 100) / 100;
 }
 /**
-* Converts a millisecond duration into a human-readable string.
-* Adjusts units (ms, s, m s) based on the magnitude of the duration.
+* Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).
+*
+* @example
+* ```ts
+* formatMs(250)   // '250ms'
+* formatMs(1500)  // '1.50s'
+* formatMs(90000) // '1m 30.0s'
+* ```
 */
 function formatMs(ms) {
 	if (ms >= 6e4) return `${Math.floor(ms / 6e4)}m ${(ms % 6e4 / 1e3).toFixed(1)}s`;
@@ -97,7 +161,14 @@ function formatMs(ms) {
 	return `${Math.round(ms)}ms`;
 }
 /**
-* Convenience helper: formats the elapsed time since `hrStart` in one step.
+* Formats the elapsed time since `hrStart` as a human-readable string.
+*
+* @example
+* ```ts
+* const start = process.hrtime()
+* doWork()
+* formatHrtime(start) // '1.50s'
+* ```
 */
 function formatHrtime(hrStart) {
 	return formatMs(getElapsedMs(hrStart));
@@ -139,18 +210,46 @@ function gradient(colorStops, text) {
 		return `\x1b[38;2;${Math.round(from.r + (to.r - from.r) * lt)};${Math.round(from.g + (to.g - from.g) * lt)};${Math.round(from.b + (to.b - from.b) * lt)}m${char}\x1b[0m`;
 	}).join("");
 }
-/** ANSI color functions for each part of the Kubb mascot illustration. */
+/**
+* ANSI color functions for each part of the Kubb mascot illustration.
+*/
 const palette = {
+	/**
+	* Top cap of the skittle.
+	*/
 	lid: hex("#F55A17"),
+	/**
+	* Upper wood body.
+	*/
 	woodTop: hex("#F5A217"),
+	/**
+	* Middle wood body.
+	*/
 	woodMid: hex("#F58517"),
+	/**
+	* Base wood body.
+	*/
 	woodBase: hex("#B45309"),
+	/**
+	* Eye whites.
+	*/
 	eye: hex("#FFFFFF"),
+	/**
+	* Highlight accent.
+	*/
 	highlight: hex("#adadc6"),
+	/**
+	* Cheek blush.
+	*/
 	blush: hex("#FDA4AF")
 };
 /**
-* Generates the Kubb mascot welcome banner.
+* Generates the Kubb mascot welcome banner as an ANSI-colored string.
+*
+* @example
+* ```ts
+* console.log(getIntro({ title: 'kubb.config.ts', description: 'generating…', version: '5.0.0', areEyesOpen: true }))
+* ```
 */
 function getIntro({ title, description, version, areEyesOpen }) {
 	const kubbVersion = gradient([
@@ -168,7 +267,9 @@ function getIntro({ title, description, version, areEyesOpen }) {
    ${palette.woodBase("▀▀▀▀▀▀▀▀▀▀▀▀▀")}
 `;
 }
-/** ANSI color names available for terminal output. */
+/**
+* ANSI color names used by {@link randomCliColor} for deterministic terminal coloring.
+*/
 const randomColors = [
 	"black",
 	"red",
@@ -181,15 +282,27 @@ const randomColors = [
 	"gray"
 ];
 /**
-* Returns the text wrapped in a deterministic ANSI color derived from the text's SHA-256 hash.
+* Wraps `text` in a deterministic ANSI color derived from the text's SHA-256 hash.
+*
+* @example
+* ```ts
+* randomCliColor('petstore') // '\x1b[33m' + 'petstore' + '\x1b[39m' (always the same color for 'petstore')
+* ```
 */
 function randomCliColor(text) {
 	if (!text) return "";
 	return (0, node_util.styleText)(randomColors[(0, node_crypto.createHash)("sha256").update(text).digest().readUInt32BE(0) % randomColors.length] ?? "white", text);
 }
 /**
-* Formats a millisecond duration with an ANSI color based on thresholds:
-* green ≤ 500 ms · yellow ≤ 1 000 ms · red > 1 000 ms
+* Formats a millisecond duration with a threshold-based ANSI color.
+* `≤ 500 ms` → green · `≤ 1 000 ms` → yellow · `> 1 000 ms` → red.
+*
+* @example
+* ```ts
+* formatMsWithColor(200)  // '\x1b[32m200ms\x1b[39m'
+* formatMsWithColor(800)  // '\x1b[33m800ms\x1b[39m'
+* formatMsWithColor(1500) // '\x1b[31m1.50s\x1b[39m'
+* ```
 */
 function formatMsWithColor(ms) {
 	const formatted = formatMs(ms);
@@ -198,27 +311,96 @@ function formatMsWithColor(ms) {
 	return (0, node_util.styleText)("red", formatted);
 }
 //#endregion
+//#region ../../internals/utils/src/formatters.ts
+/**
+* CLI command descriptors for each supported code formatter.
+*
+* Each entry contains the executable `command`, an `args` factory that maps an
+* output path to the correct argument list, and an `errorMessage` shown when
+* the formatter is not found.
+*/
+const formatters = {
+	prettier: {
+		command: "prettier",
+		args: (outputPath) => [
+			"--ignore-unknown",
+			"--write",
+			outputPath
+		],
+		errorMessage: "Prettier not found"
+	},
+	biome: {
+		command: "biome",
+		args: (outputPath) => [
+			"format",
+			"--write",
+			outputPath
+		],
+		errorMessage: "Biome not found"
+	},
+	oxfmt: {
+		command: "oxfmt",
+		args: (outputPath) => [outputPath],
+		errorMessage: "Oxfmt not found"
+	}
+};
+async function isFormatterAvailable(formatter) {
+	return new Promise((resolve) => {
+		const child = (0, node_child_process.spawn)(formatter, ["--version"], { stdio: "ignore" });
+		child.on("close", (code) => resolve(code === 0));
+		child.on("error", () => resolve(false));
+	});
+}
+/**
+* Detects the first available code formatter on the current system.
+*
+* - Checks in preference order: `oxfmt`, `biome`, `prettier`.
+* - Returns `null` when none are found.
+*
+* @example
+* ```ts
+* const formatter = await detectFormatter()
+* if (formatter) {
+*   console.log(`Using ${formatter} for formatting`)
+* }
+* ```
+*/
+async function detectFormatter() {
+	const formatterNames = new Set([
+		"oxfmt",
+		"biome",
+		"prettier"
+	]);
+	for (const formatter of formatterNames) if (await isFormatterAvailable(formatter)) return formatter;
+	return null;
+}
+//#endregion
 //#region ../../internals/utils/src/fs.ts
 /**
 * Writes `data` to `path`, trimming leading/trailing whitespace before saving.
-* Skips the write and returns `undefined` when the trimmed content is empty or
-* identical to what is already on disk.
+* Skips the write when the trimmed content is empty or identical to what is already on disk.
 * Creates any missing parent directories automatically.
-* When `sanity` is `true`, re-reads the file after writing and throws if the
-* content does not match.
+* When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.
+*
+* @example
+* ```ts
+* await write('./src/Pet.ts', source)         // writes and returns trimmed content
+* await write('./src/Pet.ts', source)         // null — file unchanged
+* await write('./src/Pet.ts', '  ')           // null — empty content skipped
+* ```
 */
 async function write(path, data, options = {}) {
 	const trimmed = data.trim();
-	if (trimmed === "") return void 0;
+	if (trimmed === "") return null;
 	const resolved = (0, node_path.resolve)(path);
 	if (typeof Bun !== "undefined") {
 		const file = Bun.file(resolved);
-		if ((await file.exists() ? await file.text() : null) === trimmed) return void 0;
+		if ((await file.exists() ? await file.text() : null) === trimmed) return null;
 		await Bun.write(resolved, trimmed);
 		return trimmed;
 	}
 	try {
-		if (await (0, node_fs_promises.readFile)(resolved, { encoding: "utf-8" }) === trimmed) return void 0;
+		if (await (0, node_fs_promises.readFile)(resolved, { encoding: "utf-8" }) === trimmed) return null;
 	} catch {}
 	await (0, node_fs_promises.mkdir)((0, node_path.dirname)(resolved), { recursive: true });
 	await (0, node_fs_promises.writeFile)(resolved, trimmed, { encoding: "utf-8" });
@@ -230,102 +412,88 @@ async function write(path, data, options = {}) {
 	return trimmed;
 }
 //#endregion
-//#region src/utils/getSummary.ts
-function getSummary({ failedPlugins, filesCreated, status, hrStart, config, pluginTimings }) {
-	const duration = formatHrtime(hrStart);
-	const pluginsCount = config.plugins?.length ?? 0;
-	const successCount = pluginsCount - failedPlugins.size;
-	const meta = {
-		plugins: status === "success" ? `${(0, node_util.styleText)("green", `${successCount} successful`)}, ${pluginsCount} total` : `${(0, node_util.styleText)("green", `${successCount} successful`)}, ${(0, node_util.styleText)("red", `${failedPlugins.size} failed`)}, ${pluginsCount} total`,
-		pluginsFailed: status === "failed" ? [...failedPlugins].map(({ plugin }) => randomCliColor(plugin.name)).join(", ") : void 0,
-		filesCreated,
-		time: (0, node_util.styleText)("green", duration),
-		output: node_path.default.isAbsolute(config.root) ? node_path.default.resolve(config.root, config.output.path) : config.root
-	};
-	const labels = {
-		plugins: "Plugins:",
-		failed: "Failed:",
-		generated: "Generated:",
-		pluginTimings: "Plugin Timings:",
-		output: "Output:"
-	};
-	const maxLength = Math.max(0, ...[...Object.values(labels), ...pluginTimings ? Array.from(pluginTimings.keys()) : []].map((s) => s.length));
-	const summaryLines = [];
-	summaryLines.push(`${labels.plugins.padEnd(maxLength + 2)} ${meta.plugins}`);
-	if (meta.pluginsFailed) summaryLines.push(`${labels.failed.padEnd(maxLength + 2)} ${meta.pluginsFailed}`);
-	summaryLines.push(`${labels.generated.padEnd(maxLength + 2)} ${meta.filesCreated} files in ${meta.time}`);
-	if (pluginTimings && pluginTimings.size > 0) {
-		const sortedTimings = Array.from(pluginTimings.entries()).sort((a, b) => b[1] - a[1]);
-		summaryLines.push(`${labels.pluginTimings}`);
-		sortedTimings.forEach(([name, time]) => {
-			const timeStr = time >= 1e3 ? `${(time / 1e3).toFixed(2)}s` : `${Math.round(time)}ms`;
-			const barLength = Math.min(Math.ceil(time / 100), 10);
-			const bar = (0, node_util.styleText)("dim", "█".repeat(barLength));
-			summaryLines.push(`${(0, node_util.styleText)("dim", "•")} ${name.padEnd(maxLength + 1)}${bar} ${timeStr}`);
-		});
+//#region ../../internals/utils/src/linters.ts
+/**
+* Collects all files under `dir` recursively using Node's built-in fs APIs.
+*
+* Passing explicit file paths to oxlint (instead of a directory) bypasses
+* oxlint's `.gitignore`-aware directory traversal, which would otherwise skip
+* files that are listed in `.gitignore` (e.g. generated output directories).
+*/
+function findLintableFiles(dir) {
+	try {
+		return (0, node_fs.readdirSync)(dir, {
+			withFileTypes: true,
+			recursive: true
+		}).filter((d) => d.isFile()).map((d) => `${d.parentPath}/${d.name}`);
+	} catch {
+		return [];
 	}
-	summaryLines.push(`${labels.output.padEnd(maxLength + 2)} ${meta.output}`);
-	return summaryLines;
 }
-//#endregion
-//#region src/utils/runHook.ts
 /**
-* Execute a hook command, emit debug/hook:end events, and forward output to
-* an optional HookOutputSink.  All three logger adapters share this function
-* so the process-spawning logic lives in exactly one place.
+* CLI command descriptors for each supported linter.
+*
+* Each entry contains the executable `command`, an `args` factory that maps an
+* output path to the correct argument list, and an `errorMessage` shown when
+* the linter is not found.
 */
-async function runHook({ id, command, args, commandWithArgs, context, stream = false, sink }) {
-	try {
-		const proc = (0, tinyexec.x)(command, [...args ?? []], {
-			nodeOptions: { detached: true },
-			throwOnError: true
-		});
-		if (stream && sink?.onLine) for await (const line of proc) sink.onLine(line);
-		const result = await proc;
-		await context.emit("debug", {
-			date: /* @__PURE__ */ new Date(),
-			logs: [result.stdout.trimEnd()]
-		});
-		await context.emit("hook:end", {
-			command,
-			args,
-			id,
-			success: true,
-			error: null
-		});
-	} catch (err) {
-		if (!(err instanceof tinyexec.NonZeroExitError)) {
-			await context.emit("hook:end", {
-				command,
-				args,
-				id,
-				success: false,
-				error: require_errors.toError(err)
-			});
-			await context.emit("error", require_errors.toError(err));
-			return;
-		}
-		const stderr = err.output?.stderr ?? "";
-		const stdout = err.output?.stdout ?? "";
-		await context.emit("debug", {
-			date: /* @__PURE__ */ new Date(),
-			logs: [stdout, stderr].filter(Boolean)
-		});
-		if (stderr) sink?.onStderr?.(stderr);
-		if (stdout) sink?.onStdout?.(stdout);
-		const errorMessage = /* @__PURE__ */ new Error(`Hook execute failed: ${commandWithArgs}`);
-		await context.emit("hook:end", {
-			command,
-			args,
-			id,
-			success: false,
-			error: errorMessage
-		});
-		await context.emit("error", errorMessage);
+const linters = {
+	eslint: {
+		command: "eslint",
+		args: (outputPath) => [outputPath, "--fix"],
+		errorMessage: "Eslint not found"
+	},
+	biome: {
+		command: "biome",
+		args: (outputPath) => [
+			"lint",
+			"--fix",
+			outputPath
+		],
+		errorMessage: "Biome not found"
+	},
+	oxlint: {
+		command: "oxlint",
+		args: (outputPath) => ["--fix", ...findLintableFiles(outputPath)],
+		errorMessage: "Oxlint not found"
 	}
+};
+async function isLinterAvailable(linter) {
+	return new Promise((resolve) => {
+		const child = (0, node_child_process.spawn)(linter, ["--version"], { stdio: "ignore" });
+		child.on("close", (code) => resolve(code === 0));
+		child.on("error", () => resolve(false));
+	});
+}
+/**
+* Detects the first available linter on the current system.
+*
+* - Checks in preference order: `oxlint`, `biome`, `eslint`.
+* - Returns `null` when none are found.
+*
+* @example
+* ```ts
+* const linter = await detectLinter()
+* if (linter) {
+*   console.log(`Using ${linter} for linting`)
+* }
+* ```
+*/
+async function detectLinter() {
+	const linterNames = new Set([
+		"oxlint",
+		"biome",
+		"eslint"
+	]);
+	for (const linter of linterNames) if (await isLinterAvailable(linter)) return linter;
+	return null;
 }
 //#endregion
-//#region src/utils/Writables.ts
+//#region src/loggers/clackLogger.ts
+/**
+* Node.js `Writable` stream that forwards each chunk to a clack `taskLog` message.
+* Used to pipe hook subprocess output into the clack task log UI.
+*/
 var ClackWritable = class extends node_stream.Writable {
 	taskLog;
 	constructor(taskLog, opts) {
@@ -337,11 +505,8 @@ var ClackWritable = class extends node_stream.Writable {
 		callback();
 	}
 };
-//#endregion
-//#region src/loggers/clackLogger.ts
 /**
-* Clack adapter for local TTY environments
-* Provides a beautiful CLI UI with flat structure inspired by Claude's CLI patterns
+* TTY logger with beautiful UI and progress indicators for local development.
 */
 const clackLogger = (0, _kubb_core.defineLogger)({
 	name: "clack",
@@ -389,7 +554,7 @@ const clackLogger = (0, _kubb_core.defineLogger)({
 			state.spinner.stop(text);
 			state.isSpinning = false;
 		}
-		context.on("info", (message, info = "") => {
+		context.on("kubb:info", ({ message, info = "" }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage([
 				(0, node_util.styleText)("blue", "ℹ"),
@@ -399,7 +564,7 @@ const clackLogger = (0, _kubb_core.defineLogger)({
 			if (state.isSpinning) state.spinner.message(text);
 			else _clack_prompts.log.info(text);
 		});
-		context.on("success", (message, info = "") => {
+		context.on("kubb:success", ({ message, info = "" }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage([
 				(0, node_util.styleText)("blue", "✓"),
@@ -409,7 +574,7 @@ const clackLogger = (0, _kubb_core.defineLogger)({
 			if (state.isSpinning) stopSpinner(text);
 			else _clack_prompts.log.success(text);
 		});
-		context.on("warn", (message, info) => {
+		context.on("kubb:warn", ({ message, info }) => {
 			if (logLevel < _kubb_core.logLevel.warn) return;
 			const text = getMessage([
 				(0, node_util.styleText)("yellow", "⚠"),
@@ -418,7 +583,7 @@ const clackLogger = (0, _kubb_core.defineLogger)({
 			].filter(Boolean).join(" "));
 			_clack_prompts.log.warn(text);
 		});
-		context.on("error", (error) => {
+		context.on("kubb:error", ({ error }) => {
 			const caused = require_errors.toCause(error);
 			const text = [(0, node_util.styleText)("red", "✗"), error.message].join(" ");
 			if (state.isSpinning) stopSpinner(getMessage(text));
@@ -433,19 +598,24 @@ const clackLogger = (0, _kubb_core.defineLogger)({
 				}
 			}
 		});
-		context.on("version:new", (version, latestVersion) => {
+		context.on("kubb:version:new", ({ currentVersion, latestVersion }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
-			_clack_prompts.box(`\`v${version}\` → \`v${latestVersion}\`
+			try {
+				_clack_prompts.box(`\`v${currentVersion}\` → \`v${latestVersion}\`
 Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
-				width: "auto",
-				formatBorder: (s) => (0, node_util.styleText)("yellow", s),
-				rounded: true,
-				withGuide: false,
-				contentAlign: "center",
-				titleAlign: "center"
-			});
+					width: "auto",
+					formatBorder: (s) => (0, node_util.styleText)("yellow", s),
+					rounded: true,
+					withGuide: false,
+					contentAlign: "center",
+					titleAlign: "center"
+				});
+			} catch {
+				console.log(`Update available for Kubb: v${currentVersion} → v${latestVersion}`);
+				console.log("Run `npm install -g @kubb/cli` to update");
+			}
 		});
-		context.on("lifecycle:start", async (version) => {
+		context.on("kubb:lifecycle:start", async ({ version }) => {
 			console.log(`\n${getIntro({
 				title: "The ultimate toolkit for working with APIs",
 				description: "Ready to start",
@@ -454,24 +624,24 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 			})}\n`);
 			reset();
 		});
-		context.on("config:start", () => {
+		context.on("kubb:config:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Configuration started");
 			_clack_prompts.intro(text);
 			startSpinner(getMessage("Configuration loading"));
 		});
-		context.on("config:end", (_configs) => {
+		context.on("kubb:config:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Configuration completed");
 			_clack_prompts.outro(text);
 		});
-		context.on("generation:start", (config) => {
+		context.on("kubb:generation:start", ({ config }) => {
 			reset();
 			state.totalPlugins = config.plugins?.length ?? 0;
 			const text = getMessage(["Generation started", config.name ? `for ${(0, node_util.styleText)("dim", config.name)}` : void 0].filter(Boolean).join(" "));
 			_clack_prompts.intro(text);
 		});
-		context.on("plugin:start", (plugin) => {
+		context.on("kubb:plugin:start", ({ plugin }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			stopSpinner();
 			const progressBar = _clack_prompts.progress({
@@ -489,7 +659,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 				interval
 			});
 		});
-		context.on("plugin:end", (plugin, { duration, success }) => {
+		context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
 			stopSpinner();
 			const active = state.activeProgress.get(plugin.name);
 			if (!active || logLevel === _kubb_core.logLevel.silent) return;
@@ -502,7 +672,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 			state.activeProgress.delete(plugin.name);
 			showProgressStep();
 		});
-		context.on("files:processing:start", (files) => {
+		context.on("kubb:files:processing:start", ({ files }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			stopSpinner();
 			state.totalFiles = files.length;
@@ -513,11 +683,11 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 				max: files.length,
 				size: 30
 			});
-			context.emit("info", text);
+			context.emit("kubb:info", { message: text });
 			progressBar.start(getMessage(text));
 			state.activeProgress.set("files", { progressBar });
 		});
-		context.on("file:processing:update", ({ file, config }) => {
+		context.on("kubb:file:processing:update", ({ file, config }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			stopSpinner();
 			state.processedFiles++;
@@ -526,7 +696,7 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 			if (!active) return;
 			active.progressBar.advance(void 0, text);
 		});
-		context.on("files:processing:end", () => {
+		context.on("kubb:files:processing:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			stopSpinner();
 			const text = getMessage("Files written successfully");
@@ -536,71 +706,41 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 			state.activeProgress.delete("files");
 			showProgressStep();
 		});
-		context.on("generation:end", (config) => {
+		context.on("kubb:generation:end", ({ config }) => {
 			const text = getMessage(config.name ? `Generation completed for ${(0, node_util.styleText)("dim", config.name)}` : "Generation completed");
 			_clack_prompts.outro(text);
 		});
-		context.on("format:start", () => {
+		context.on("kubb:format:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Format started");
 			_clack_prompts.intro(text);
 		});
-		context.on("format:end", () => {
+		context.on("kubb:format:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Format completed");
 			_clack_prompts.outro(text);
 		});
-		context.on("lint:start", () => {
+		context.on("kubb:lint:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Lint started");
 			_clack_prompts.intro(text);
 		});
-		context.on("lint:end", () => {
+		context.on("kubb:lint:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Lint completed");
 			_clack_prompts.outro(text);
 		});
-		context.on("hook:start", async ({ id, command, args }) => {
-			const commandWithArgs = formatCommandWithArgs(command, args);
-			const text = getMessage(`Hook ${(0, node_util.styleText)("dim", commandWithArgs)} started`);
-			if (!id) return;
-			if (logLevel <= _kubb_core.logLevel.silent) {
-				await runHook({
-					id,
-					command,
-					args,
-					commandWithArgs,
-					context,
-					sink: {
-						onStderr: (s) => console.error(s),
-						onStdout: (s) => console.log(s)
-					}
-				});
-				return;
-			}
+		context.on("kubb:hook:start", ({ command, args }) => {
+			if (logLevel <= _kubb_core.logLevel.silent) return;
+			const text = getMessage(`Hook ${(0, node_util.styleText)("dim", formatCommandWithArgs(command, args))} started`);
 			_clack_prompts.intro(text);
-			const logger = _clack_prompts.taskLog({ title: getMessage(["Executing hook", logLevel >= _kubb_core.logLevel.info ? (0, node_util.styleText)("dim", commandWithArgs) : void 0].filter(Boolean).join(" ")) });
-			const writable = new ClackWritable(logger);
-			await runHook({
-				id,
-				command,
-				args,
-				commandWithArgs,
-				context,
-				stream: true,
-				sink: {
-					onLine: (line) => writable.write(line),
-					onStderr: (s) => logger.error(s),
-					onStdout: (s) => logger.message(s)
-				}
-			});
 		});
-		context.on("hook:end", ({ command, args }) => {
+		context.on("kubb:hook:end", ({ command, args }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage(`Hook ${(0, node_util.styleText)("dim", formatCommandWithArgs(command, args))} successfully executed`);
 			_clack_prompts.outro(text);
 		});
-		context.on("generation:summary", (config, { pluginTimings, failedPlugins, filesCreated, status, hrStart }) => {
+		context.on("kubb:generation:summary", ({ config, pluginTimings, failedPlugins, filesCreated, status, hrStart }) => {
 			const summary = getSummary({
 				failedPlugins,
 				filesCreated,
@@ -613,28 +753,44 @@ Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
 			summary.unshift("\n");
 			summary.push("\n");
 			const borderColor = status === "success" ? "green" : "red";
-			_clack_prompts.box(summary.join("\n"), getMessage(title), {
-				width: "auto",
-				formatBorder: (s) => (0, node_util.styleText)(borderColor, s),
-				rounded: true,
-				withGuide: false,
-				contentAlign: "left",
-				titleAlign: "center"
-			});
+			try {
+				_clack_prompts.box(summary.join("\n"), getMessage(title), {
+					width: "auto",
+					formatBorder: (s) => (0, node_util.styleText)(borderColor, s),
+					rounded: true,
+					withGuide: false,
+					contentAlign: "left",
+					titleAlign: "center"
+				});
+			} catch {
+				console.log(summary.join("\n"));
+			}
 		});
-		context.on("lifecycle:end", () => {
+		context.on("kubb:lifecycle:end", () => {
 			reset();
 		});
+		return (commandWithArgs) => {
+			if (logLevel <= _kubb_core.logLevel.silent) return {
+				onStdout: (s) => console.log(s),
+				onStderr: (s) => console.error(s)
+			};
+			const logger = _clack_prompts.taskLog({ title: getMessage(["Executing hook", logLevel >= _kubb_core.logLevel.info ? (0, node_util.styleText)("dim", commandWithArgs) : void 0].filter(Boolean).join(" ")) });
+			const writable = new ClackWritable(logger);
+			return {
+				stream: true,
+				onLine: (line) => writable.write(line),
+				onStdout: (s) => logger.message(s),
+				onStderr: (s) => logger.error(s)
+			};
+		};
 	}
 });
 //#endregion
 //#region src/loggers/fileSystemLogger.ts
 /**
-* FileSystem logger for debug log persistence
-* Captures debug and verbose events and writes them to files in .kubb directory
+* FileSystem logger that captures debug events and writes them to `.kubb` directory files.
 *
-* Note: Logs are written on lifecycle:end or process exit. If the process crashes
-* before these events, some cached logs may be lost.
+* @note Logs are written on `kubb:lifecycle:end` or process exit. Cached logs may be lost if the process crashes before either event.
 */
 const fileSystemLogger = (0, _kubb_core.defineLogger)({
 	name: "filesystem",
@@ -659,67 +815,73 @@ const fileSystemLogger = (0, _kubb_core.defineLogger)({
 				const pathName = (0, node_path.resolve)(node_process.default.cwd(), ".kubb", baseName);
 				if (!files[pathName]) files[pathName] = [];
 				if (log.logs.length > 0) {
-					const timestamp = log.date.toLocaleString();
-					files[pathName].push(`[${timestamp}]\n${log.logs.join("\n")}`);
+					const prefix = `[${log.date.toLocaleString()}] `;
+					const indent = " ".repeat(prefix.length);
+					const [first, ...rest] = log.logs;
+					files[pathName].push([prefix + first, ...rest.map((line) => indent + line)].join("\n"));
 				}
 			}
-			await Promise.all(Object.entries(files).map(([fileName, logs]) => write(fileName, logs.join("\n\n"))));
+			for (const [fileName, logs] of Object.entries(files)) await write(fileName, logs.join("\n"));
 			return Object.keys(files);
 		}
-		context.on("info", (message, info) => {
+		context.on("kubb:info", ({ message, info }) => {
 			state.cachedLogs.add({
 				date: /* @__PURE__ */ new Date(),
-				logs: [`ℹ ${message} ${info}`]
+				logs: [`ℹ ${[message, info].filter(Boolean).join(" ")}`]
 			});
 		});
-		context.on("success", (message, info) => {
+		context.on("kubb:success", ({ message, info }) => {
 			state.cachedLogs.add({
 				date: /* @__PURE__ */ new Date(),
-				logs: [`✓ ${message} ${info}`]
+				logs: [`✓ ${[message, info].filter(Boolean).join(" ")}`]
 			});
 		});
-		context.on("warn", (message, info) => {
+		context.on("kubb:warn", ({ message, info }) => {
 			state.cachedLogs.add({
 				date: /* @__PURE__ */ new Date(),
-				logs: [`⚠ ${message} ${info}`]
+				logs: [`⚠ ${[message, info].filter(Boolean).join(" ")}`]
 			});
 		});
-		context.on("error", (error) => {
+		context.on("kubb:error", ({ error }) => {
 			state.cachedLogs.add({
 				date: /* @__PURE__ */ new Date(),
 				logs: [`✗ ${error.message}`, error.stack || "unknown stack"]
 			});
 		});
-		context.on("debug", (message) => {
+		context.on("kubb:debug", ({ date, fileName, logs }) => {
 			state.cachedLogs.add({
-				date: /* @__PURE__ */ new Date(),
-				logs: message.logs
+				date,
+				fileName,
+				logs
 			});
 		});
-		context.on("plugin:start", (plugin) => {
+		context.on("kubb:plugin:start", ({ plugin }) => {
 			state.cachedLogs.add({
 				date: /* @__PURE__ */ new Date(),
-				logs: [`Generating ${plugin.name}`]
+				logs: [`► Generating ${plugin.name}`]
 			});
 		});
-		context.on("plugin:end", (plugin, { duration, success }) => {
+		context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
 			const durationStr = formatMs(duration);
 			state.cachedLogs.add({
 				date: /* @__PURE__ */ new Date(),
-				logs: [success ? `${plugin.name} completed in ${durationStr}` : `${plugin.name} failed in ${durationStr}`]
+				logs: [success ? `✓ ${plugin.name} completed in ${durationStr}` : `✗ ${plugin.name} failed in ${durationStr}`]
 			});
 		});
-		context.on("files:processing:start", (files) => {
+		context.on("kubb:files:processing:start", ({ files }) => {
 			state.cachedLogs.add({
 				date: /* @__PURE__ */ new Date(),
-				logs: [`Start ${files.length} writing:`, ...files.map((file) => file.path)]
+				logs: [`► Writing ${files.length} files`, ...files.map((file) => `  ${file.path}`)]
 			});
 		});
-		context.on("generation:end", async (config) => {
+		context.on("kubb:generation:end", async ({ config }) => {
 			const writtenFilePaths = await writeLogs(config.name);
 			if (writtenFilePaths.length > 0) {
 				const files = writtenFilePaths.map((f) => (0, node_path.relative)(node_process.default.cwd(), f));
-				await context.emit("info", "Debug files written to:", files.join(", "));
+				await context.emit("kubb:info", {
+					message: "Debug files written to:",
+					info: files.join(", ")
+				});
 			}
 			reset();
 		});
@@ -734,8 +896,7 @@ const fileSystemLogger = (0, _kubb_core.defineLogger)({
 //#endregion
 //#region src/loggers/githubActionsLogger.ts
 /**
-* GitHub Actions adapter for CI environments
-* Uses Github group annotations for collapsible sections
+* GitHub Actions logger using group annotations for collapsible sections in CI.
 */
 const githubActionsLogger = (0, _kubb_core.defineLogger)({
 	name: "github-actions",
@@ -773,7 +934,7 @@ const githubActionsLogger = (0, _kubb_core.defineLogger)({
 		function closeGroup(_name) {
 			console.log("::endgroup::");
 		}
-		context.on("info", (message, info = "") => {
+		context.on("kubb:info", ({ message, info = "" }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage([
 				(0, node_util.styleText)("blue", "ℹ"),
@@ -782,7 +943,7 @@ const githubActionsLogger = (0, _kubb_core.defineLogger)({
 			].join(" "));
 			console.log(text);
 		});
-		context.on("success", (message, info = "") => {
+		context.on("kubb:success", ({ message, info = "" }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage([
 				(0, node_util.styleText)("blue", "✓"),
@@ -791,7 +952,7 @@ const githubActionsLogger = (0, _kubb_core.defineLogger)({
 			].filter(Boolean).join(" "));
 			console.log(text);
 		});
-		context.on("warn", (message, info = "") => {
+		context.on("kubb:warn", ({ message, info = "" }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage([
 				(0, node_util.styleText)("yellow", "⚠"),
@@ -800,7 +961,7 @@ const githubActionsLogger = (0, _kubb_core.defineLogger)({
 			].filter(Boolean).join(" "));
 			console.warn(`::warning::${text}`);
 		});
-		context.on("error", (error) => {
+		context.on("kubb:error", ({ error }) => {
 			const caused = require_errors.toCause(error);
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const message = error.message || String(error);
@@ -815,37 +976,37 @@ const githubActionsLogger = (0, _kubb_core.defineLogger)({
 				}
 			}
 		});
-		context.on("lifecycle:start", (version) => {
+		context.on("kubb:lifecycle:start", ({ version }) => {
 			console.log((0, node_util.styleText)("yellow", `Kubb ${version} 🧩`));
 			reset();
 		});
-		context.on("config:start", () => {
+		context.on("kubb:config:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Configuration started");
 			openGroup("Configuration");
 			console.log(text);
 		});
-		context.on("config:end", (configs) => {
+		context.on("kubb:config:end", ({ configs }) => {
 			state.currentConfigs = configs;
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Configuration completed");
 			console.log(text);
 			closeGroup("Configuration");
 		});
-		context.on("generation:start", (config) => {
+		context.on("kubb:generation:start", ({ config }) => {
 			reset();
 			state.totalPlugins = config.plugins?.length ?? 0;
 			const text = config.name ? `Generation for ${(0, node_util.styleText)("bold", config.name)}` : "Generation";
 			if (state.currentConfigs.length > 1) openGroup(text);
 			if (state.currentConfigs.length === 1) console.log(getMessage(text));
 		});
-		context.on("plugin:start", (plugin) => {
+		context.on("kubb:plugin:start", ({ plugin }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage(`Generating ${(0, node_util.styleText)("bold", plugin.name)}`);
 			if (state.currentConfigs.length === 1) openGroup(`Plugin: ${plugin.name}`);
 			console.log(text);
 		});
-		context.on("plugin:end", (plugin, { duration, success }) => {
+		context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			if (success) state.completedPlugins++;
 			else state.failedPlugins++;
@@ -856,7 +1017,7 @@ const githubActionsLogger = (0, _kubb_core.defineLogger)({
 			if (state.currentConfigs.length === 1) closeGroup(`Plugin: ${plugin.name}`);
 			showProgressStep();
 		});
-		context.on("files:processing:start", (files) => {
+		context.on("kubb:files:processing:start", ({ files }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			state.totalFiles = files.length;
 			state.processedFiles = 0;
@@ -864,73 +1025,60 @@ const githubActionsLogger = (0, _kubb_core.defineLogger)({
 			const text = getMessage(`Writing ${files.length} files`);
 			console.log(text);
 		});
-		context.on("files:processing:end", () => {
+		context.on("kubb:files:processing:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Files written successfully");
 			console.log(text);
 			if (state.currentConfigs.length === 1) closeGroup("File Generation");
 			showProgressStep();
 		});
-		context.on("file:processing:update", () => {
+		context.on("kubb:file:processing:update", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			state.processedFiles++;
 		});
-		context.on("generation:end", (config) => {
+		context.on("kubb:generation:end", ({ config }) => {
 			const text = getMessage(config.name ? `${(0, node_util.styleText)("blue", "✓")} Generation completed for ${(0, node_util.styleText)("dim", config.name)}` : `${(0, node_util.styleText)("blue", "✓")} Generation completed`);
 			console.log(text);
 		});
-		context.on("format:start", () => {
+		context.on("kubb:format:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Format started");
 			if (state.currentConfigs.length === 1) openGroup("Formatting");
 			console.log(text);
 		});
-		context.on("format:end", () => {
+		context.on("kubb:format:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Format completed");
 			console.log(text);
 			if (state.currentConfigs.length === 1) closeGroup("Formatting");
 		});
-		context.on("lint:start", () => {
+		context.on("kubb:lint:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Lint started");
 			if (state.currentConfigs.length === 1) openGroup("Linting");
 			console.log(text);
 		});
-		context.on("lint:end", () => {
+		context.on("kubb:lint:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Lint completed");
 			console.log(text);
 			if (state.currentConfigs.length === 1) closeGroup("Linting");
 		});
-		context.on("hook:start", async ({ id, command, args }) => {
+		context.on("kubb:hook:start", ({ command, args }) => {
+			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const commandWithArgs = formatCommandWithArgs(command, args);
 			const text = getMessage(`Hook ${(0, node_util.styleText)("dim", commandWithArgs)} started`);
-			if (logLevel > _kubb_core.logLevel.silent) {
-				if (state.currentConfigs.length === 1) openGroup(`Hook ${commandWithArgs}`);
-				console.log(text);
-			}
-			if (!id) return;
-			await runHook({
-				id,
-				command,
-				args,
-				commandWithArgs,
-				context,
-				sink: {
-					onStdout: logLevel > _kubb_core.logLevel.silent ? (s) => console.log(s) : void 0,
-					onStderr: logLevel > _kubb_core.logLevel.silent ? (s) => console.error(`::error::${s}`) : void 0
-				}
-			});
+			if (state.currentConfigs.length === 1) openGroup(`Hook ${commandWithArgs}`);
+			console.log(text);
 		});
-		context.on("hook:end", ({ command, args }) => {
+		context.on("kubb:hook:end", ({ command, args }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const commandWithArgs = formatCommandWithArgs(command, args);
 			const text = getMessage(`Hook ${(0, node_util.styleText)("dim", commandWithArgs)} completed`);
 			console.log(text);
 			if (state.currentConfigs.length === 1) closeGroup(`Hook ${commandWithArgs}`);
 		});
-		context.on("generation:summary", (config, { status, hrStart, failedPlugins }) => {
+		context.on("kubb:generation:summary", ({ config, status, hrStart, failedPlugins }) => {
 			const pluginsCount = config.plugins?.length ?? 0;
 			const successCount = pluginsCount - failedPlugins.size;
 			const duration = formatHrtime(hrStart);
@@ -938,16 +1086,19 @@ const githubActionsLogger = (0, _kubb_core.defineLogger)({
 			console.log(status === "success" ? `Kubb Summary: ${(0, node_util.styleText)("blue", "✓")} ${`${successCount} successful`}, ${pluginsCount} total, ${(0, node_util.styleText)("green", duration)}` : `Kubb Summary: ${(0, node_util.styleText)("blue", "✓")} ${`${successCount} successful`}, ✗ ${`${failedPlugins.size} failed`}, ${pluginsCount} total, ${(0, node_util.styleText)("green", duration)}`);
 			if (state.currentConfigs.length > 1) closeGroup(config.name ? `Generation for ${(0, node_util.styleText)("bold", config.name)}` : "Generation");
 		});
-		context.on("lifecycle:end", () => {
+		context.on("kubb:lifecycle:end", () => {
 			reset();
 		});
+		return (_commandWithArgs) => ({
+			onStdout: logLevel > _kubb_core.logLevel.silent ? (s) => console.log(s) : void 0,
+			onStderr: logLevel > _kubb_core.logLevel.silent ? (s) => console.error(`::error::${s}`) : void 0
+		});
 	}
 });
 //#endregion
 //#region src/loggers/plainLogger.ts
 /**
-* Plain console adapter for non-TTY environments
-* Simple console.log output with indentation
+* Plain console adapter for non-TTY environments with simple `console.log` output.
 */
 const plainLogger = (0, _kubb_core.defineLogger)({
 	name: "plain",
@@ -956,7 +1107,7 @@ const plainLogger = (0, _kubb_core.defineLogger)({
 		function getMessage(message) {
 			return formatMessage(message, logLevel);
 		}
-		context.on("info", (message, info) => {
+		context.on("kubb:info", ({ message, info }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage([
 				"ℹ",
@@ -965,7 +1116,7 @@ const plainLogger = (0, _kubb_core.defineLogger)({
 			].join(" "));
 			console.log(text);
 		});
-		context.on("success", (message, info = "") => {
+		context.on("kubb:success", ({ message, info = "" }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage([
 				"✓",
@@ -974,7 +1125,7 @@ const plainLogger = (0, _kubb_core.defineLogger)({
 			].filter(Boolean).join(" "));
 			console.log(text);
 		});
-		context.on("warn", (message, info) => {
+		context.on("kubb:warn", ({ message, info }) => {
 			if (logLevel < _kubb_core.logLevel.warn) return;
 			const text = getMessage([
 				"⚠",
@@ -983,7 +1134,7 @@ const plainLogger = (0, _kubb_core.defineLogger)({
 			].filter(Boolean).join(" "));
 			console.log(text);
 		});
-		context.on("error", (error) => {
+		context.on("kubb:error", ({ error }) => {
 			const caused = require_errors.toCause(error);
 			const text = getMessage(["✗", error.message].join(" "));
 			console.log(text);
@@ -997,96 +1148,84 @@ const plainLogger = (0, _kubb_core.defineLogger)({
 				}
 			}
 		});
-		context.on("lifecycle:start", () => {
+		context.on("kubb:lifecycle:start", () => {
 			console.log("Kubb CLI 🧩");
 		});
-		context.on("config:start", () => {
+		context.on("kubb:config:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Configuration started");
 			console.log(text);
 		});
-		context.on("config:end", () => {
+		context.on("kubb:config:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Configuration completed");
 			console.log(text);
 		});
-		context.on("generation:start", () => {
+		context.on("kubb:generation:start", () => {
 			const text = getMessage("Generation started");
 			console.log(text);
 		});
-		context.on("plugin:start", (plugin) => {
+		context.on("kubb:plugin:start", ({ plugin }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage(`Generating ${plugin.name}`);
 			console.log(text);
 		});
-		context.on("plugin:end", (plugin, { duration, success }) => {
+		context.on("kubb:plugin:end", ({ plugin, duration, success }) => {
 			if (logLevel <= _kubb_core.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("files:processing:start", (files) => {
+		context.on("kubb:files:processing:start", ({ files }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage(`Writing ${files.length} files`);
 			console.log(text);
 		});
-		context.on("file:processing:update", ({ file, config }) => {
+		context.on("kubb:file:processing:update", ({ file, config }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage(`Writing ${(0, node_path.relative)(config.root, file.path)}`);
 			console.log(text);
 		});
-		context.on("files:processing:end", () => {
+		context.on("kubb:files:processing:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Files written successfully");
 			console.log(text);
 		});
-		context.on("generation:end", (config) => {
+		context.on("kubb:generation:end", ({ config }) => {
 			const text = getMessage(config.name ? `Generation completed for ${config.name}` : "Generation completed");
 			console.log(text);
 		});
-		context.on("format:start", () => {
+		context.on("kubb:format:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Format started");
 			console.log(text);
 		});
-		context.on("format:end", () => {
+		context.on("kubb:format:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Format completed");
 			console.log(text);
 		});
-		context.on("lint:start", () => {
+		context.on("kubb:lint:start", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Lint started");
 			console.log(text);
 		});
-		context.on("lint:end", () => {
+		context.on("kubb:lint:end", () => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage("Lint completed");
 			console.log(text);
 		});
-		context.on("hook:start", async ({ id, command, args }) => {
-			const commandWithArgs = formatCommandWithArgs(command, args);
-			const text = getMessage(`Hook ${commandWithArgs} started`);
-			if (logLevel > _kubb_core.logLevel.silent) console.log(text);
-			if (!id) return;
-			await runHook({
-				id,
-				command,
-				args,
-				commandWithArgs,
-				context,
-				sink: {
-					onStdout: logLevel > _kubb_core.logLevel.silent ? (s) => console.log(s) : void 0,
-					onStderr: logLevel > _kubb_core.logLevel.silent ? (s) => console.error(s) : void 0
-				}
-			});
+		context.on("kubb:hook:start", ({ command, args }) => {
+			if (logLevel <= _kubb_core.logLevel.silent) return;
+			const text = getMessage(`Hook ${formatCommandWithArgs(command, args)} started`);
+			console.log(text);
 		});
-		context.on("hook:end", ({ command, args }) => {
+		context.on("kubb:hook:end", ({ command, args }) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
 			const text = getMessage(`Hook ${formatCommandWithArgs(command, args)} completed`);
 			console.log(text);
 		});
-		context.on("generation:summary", (config, { pluginTimings, status, hrStart, failedPlugins, filesCreated }) => {
+		context.on("kubb:generation:summary", ({ config, pluginTimings, status, hrStart, failedPlugins, filesCreated }) => {
 			const summary = getSummary({
 				failedPlugins,
 				filesCreated,
@@ -1099,6 +1238,10 @@ const plainLogger = (0, _kubb_core.defineLogger)({
 			console.log(summary.join("\n"));
 			console.log(require_constants.SUMMARY_SEPARATOR);
 		});
+		return (_commandWithArgs) => ({
+			onStdout: logLevel > _kubb_core.logLevel.silent ? (s) => console.log(s) : void 0,
+			onStderr: logLevel > _kubb_core.logLevel.silent ? (s) => console.error(s) : void 0
+		});
 	}
 });
 //#endregion
@@ -1153,310 +1296,446 @@ async function setupLogger(context, { logLevel }) {
 	const type = detectLogger();
 	const logger = logMapper[type];
 	if (!logger) throw new Error(`Unknown adapter type: ${type}`);
-	const cleanup = await logger.install(context, { logLevel });
+	const makeSink = await logger.install(context, { logLevel });
 	if (logLevel >= _kubb_core.logLevel.debug) await fileSystemLogger.install(context, { logLevel });
-	return cleanup;
+	return typeof makeSink === "function" ? makeSink : void 0;
 }
-//#endregion
-//#region src/utils/executeHooks.ts
-async function executeHooks({ hooks, events }) {
-	const commands = Array.isArray(hooks.done) ? hooks.done : [hooks.done].filter(Boolean);
-	for (const command of commands) {
-		const [cmd, ...args] = require_shell.tokenize(command);
-		if (!cmd) continue;
-		const hookId = (0, node_crypto.createHash)("sha256").update(command).digest("hex");
-		const hookEndPromise = new Promise((resolve, reject) => {
-			const handler = ({ id, success, error }) => {
-				if (id !== hookId) return;
-				events.off("hook:end", handler);
-				if (!success) {
-					reject(error ?? /* @__PURE__ */ new Error(`Hook failed: ${command}`));
-					return;
-				}
-				events.emit("success", `${(0, node_util.styleText)("dim", command)} successfully executed`).then(resolve).catch(reject);
-			};
-			events.on("hook:end", handler);
-		});
-		await events.emit("hook:start", {
-			id: hookId,
-			command: cmd,
-			args
+/**
+* Builds the generation summary lines rendered in the end-of-run box.
+* Returns an array of styled strings, one per summary row.
+*/
+function getSummary({ failedPlugins, filesCreated, status, hrStart, config, pluginTimings }) {
+	const duration = formatHrtime(hrStart);
+	const pluginsCount = config.plugins?.length ?? 0;
+	const successCount = pluginsCount - failedPlugins.size;
+	const meta = {
+		plugins: status === "success" ? `${(0, node_util.styleText)("green", `${successCount} successful`)}, ${pluginsCount} total` : `${(0, node_util.styleText)("green", `${successCount} successful`)}, ${(0, node_util.styleText)("red", `${failedPlugins.size} failed`)}, ${pluginsCount} total`,
+		pluginsFailed: status === "failed" ? [...failedPlugins].map(({ plugin }) => randomCliColor(plugin.name)).join(", ") : void 0,
+		filesCreated,
+		time: (0, node_util.styleText)("green", duration),
+		output: node_path.default.resolve(config.root, config.output.path)
+	};
+	const labels = {
+		plugins: "Plugins:",
+		failed: "Failed:",
+		generated: "Generated:",
+		pluginTimings: "Plugin Timings:",
+		output: "Output:"
+	};
+	const maxLength = Math.max(0, ...[...Object.values(labels), ...pluginTimings ? Array.from(pluginTimings.keys()) : []].map((s) => s.length));
+	const summaryLines = [];
+	summaryLines.push(`${labels.plugins.padEnd(maxLength + 2)} ${meta.plugins}`);
+	if (meta.pluginsFailed) summaryLines.push(`${labels.failed.padEnd(maxLength + 2)} ${meta.pluginsFailed}`);
+	summaryLines.push(`${labels.generated.padEnd(maxLength + 2)} ${meta.filesCreated} files in ${meta.time}`);
+	if (pluginTimings && pluginTimings.size > 0) {
+		const sortedTimings = Array.from(pluginTimings.entries()).sort((a, b) => b[1] - a[1]);
+		summaryLines.push(`${labels.pluginTimings}`);
+		sortedTimings.forEach(([name, time]) => {
+			const timeStr = time >= 1e3 ? `${(time / 1e3).toFixed(2)}s` : `${Math.round(time)}ms`;
+			const barLength = Math.min(Math.ceil(time / 100), 10);
+			const bar = (0, node_util.styleText)("dim", "█".repeat(barLength));
+			summaryLines.push(`${(0, node_util.styleText)("dim", "•")} ${name.padEnd(maxLength + 1)}${bar} ${timeStr}`);
 		});
-		await hookEndPromise;
 	}
+	summaryLines.push(`${labels.output.padEnd(maxLength + 2)} ${meta.output}`);
+	return summaryLines;
 }
 //#endregion
-//#region src/utils/getCosmiConfig.ts
+//#region src/runners/generate/utils.ts
 const jiti$1 = (0, jiti.createJiti)(require("url").pathToFileURL(__filename).href, {
 	jsx: {
 		runtime: "automatic",
-		importSource: "@kubb/react-fabric"
+		importSource: "@kubb/renderer-jsx"
 	},
-	sourceMaps: true,
-	interopDefault: true
+	moduleCache: false
 });
-const tsLoader = async (configFile) => {
-	return await jiti$1.import(configFile, { default: true });
-};
-async function getCosmiConfig(moduleName, config) {
-	let result;
-	const searchPlaces = [
-		"package.json",
-		`.${moduleName}rc`,
-		`.${moduleName}rc.json`,
-		`.${moduleName}rc.yaml`,
-		`.${moduleName}rc.yml`,
-		`.${moduleName}rc.ts`,
-		`.${moduleName}rc.js`,
-		`.${moduleName}rc.mjs`,
-		`.${moduleName}rc.cjs`,
-		`${moduleName}.config.ts`,
-		`${moduleName}.config.js`,
-		`${moduleName}.config.mjs`,
-		`${moduleName}.config.cjs`
-	];
-	const explorer = (0, cosmiconfig.cosmiconfig)(moduleName, {
+const tsLoader = (configFile) => jiti$1.import(configFile, { default: true });
+const MODULE_NAME = "kubb";
+const BASE_SEARCH_PLACES = [
+	"package.json",
+	`.${MODULE_NAME}rc`,
+	`.${MODULE_NAME}rc.json`,
+	`.${MODULE_NAME}rc.yaml`,
+	`.${MODULE_NAME}rc.yml`,
+	`.${MODULE_NAME}rc.ts`,
+	`.${MODULE_NAME}rc.mts`,
+	`.${MODULE_NAME}rc.cts`,
+	`.${MODULE_NAME}rc.js`,
+	`.${MODULE_NAME}rc.mjs`,
+	`.${MODULE_NAME}rc.cjs`,
+	`${MODULE_NAME}.config.ts`,
+	`${MODULE_NAME}.config.mts`,
+	`${MODULE_NAME}.config.cts`,
+	`${MODULE_NAME}.config.js`,
+	`${MODULE_NAME}.config.mjs`,
+	`${MODULE_NAME}.config.cjs`
+];
+const SEARCH_PLACES = [
+	"",
+	".config/",
+	"configs/"
+].flatMap((prefix) => BASE_SEARCH_PLACES.map((p) => `${prefix}${p}`));
+async function getCosmiConfig(configFile) {
+	const explorer = (0, cosmiconfig.cosmiconfig)(MODULE_NAME, {
 		cache: false,
-		searchPlaces: [
-			...searchPlaces.map((searchPlace) => {
-				return `.config/${searchPlace}`;
-			}),
-			...searchPlaces.map((searchPlace) => {
-				return `configs/${searchPlace}`;
-			}),
-			...searchPlaces
-		],
-		loaders: { ".ts": tsLoader }
+		searchPlaces: SEARCH_PLACES,
+		loaders: {
+			".ts": tsLoader,
+			".mts": tsLoader,
+			".cts": tsLoader
+		}
 	});
+	let result;
 	try {
-		result = config ? await explorer.load(config) : await explorer.search();
+		result = configFile ? await explorer.load(configFile) : await explorer.search();
 	} catch (error) {
 		throw new Error("Config failed loading", { cause: error });
 	}
-	if (result?.isEmpty || !result || !result.config) throw new Error("Config not defined, create a kubb.config.js or pass through your config with the option --config");
+	if (!result?.config || result.isEmpty) throw new Error("Config not defined, create a kubb.config.js or pass through your config with the option --config");
 	return result;
 }
-//#endregion
-//#region src/utils/watcher.ts
-async function startWatcher(path, cb) {
+/**
+* Discovers the Kubb config via cosmiconfig and resolves it into a normalized array of configs.
+* Every config in the result is guaranteed to have a `plugins` array.
+*/
+async function getConfigs({ configPath, input }) {
+	const result = await getCosmiConfig(configPath);
+	const resolved = await (typeof result.config === "function" ? result.config({ input }) : result.config);
+	const userConfigs = Array.isArray(resolved) ? resolved : [resolved];
+	return {
+		configPath: result.filepath,
+		configs: userConfigs.map((item) => ({
+			...item,
+			plugins: item.plugins ?? []
+		}))
+	};
+}
+/**
+* Runs the `done` hooks defined in a Kubb config in sequence.
+*/
+async function executeHooks({ configHooks, hooks, makeSink }) {
+	const commands = Array.isArray(configHooks.done) ? configHooks.done : [configHooks.done].filter(Boolean);
+	for (const command of commands) {
+		const [cmd, ...args] = require_shell.tokenize(command);
+		if (!cmd) continue;
+		const hookId = (0, node_crypto.createHash)("sha256").update(command).digest("hex");
+		const commandWithArgs = [cmd, ...args].join(" ");
+		await hooks.emit("kubb:hook:start", {
+			id: hookId,
+			command: cmd,
+			args
+		});
+		const { stream = false, onLine, onStdout, onStderr } = makeSink?.(commandWithArgs) ?? {};
+		await runHook({
+			id: hookId,
+			command: cmd,
+			args,
+			commandWithArgs,
+			context: hooks,
+			stream,
+			sink: {
+				onLine,
+				onStdout,
+				onStderr
+			}
+		});
+	}
+}
+async function runHook({ id, command, args, commandWithArgs, context, stream = false, sink }) {
+	const emitEnd = (success, error) => context.emit("kubb:hook:end", {
+		command,
+		args,
+		id,
+		success,
+		error
+	});
+	try {
+		const proc = (0, tinyexec.x)(command, [...args ?? []], {
+			nodeOptions: { detached: process.platform !== "win32" },
+			throwOnError: true
+		});
+		if (stream && sink?.onLine) for await (const line of proc) sink.onLine(line);
+		const result = await proc;
+		await context.emit("kubb:debug", {
+			date: /* @__PURE__ */ new Date(),
+			logs: [result.stdout.trimEnd()]
+		});
+		await context.emit("kubb:success", { message: `${(0, node_util.styleText)("dim", commandWithArgs)} successfully executed` });
+		await emitEnd(true, null);
+	} catch (err) {
+		if (!(err instanceof tinyexec.NonZeroExitError)) {
+			const error = require_errors.toError(err);
+			await emitEnd(false, error);
+			await context.emit("kubb:error", { error });
+			return;
+		}
+		const stderr = err.output?.stderr ?? "";
+		const stdout = err.output?.stdout ?? "";
+		await context.emit("kubb:debug", {
+			date: /* @__PURE__ */ new Date(),
+			logs: [stdout, stderr].filter(Boolean)
+		});
+		if (stderr) sink?.onStderr?.(stderr);
+		if (stdout) sink?.onStdout?.(stdout);
+		const error = /* @__PURE__ */ new Error(`Hook execute failed: ${commandWithArgs}`);
+		await emitEnd(false, error);
+		await context.emit("kubb:error", { error });
+	}
+}
+/**
+* Starts a file watcher on the given paths and calls `cb` on any change.
+* Ignores `.git` and `node_modules` directories.
+*/
+async function startWatcher(path, cb, log = {
+	info: console.log,
+	error: console.log
+}) {
 	const { watch } = await import("chokidar");
 	watch(path, {
 		ignorePermissionErrors: true,
 		ignored: require_constants.WATCHER_IGNORED_PATHS
 	}).on("all", async (type, file) => {
-		console.log((0, node_util.styleText)("yellow", (0, node_util.styleText)("bold", `Change detected: ${type} ${file}`)));
+		log.info((0, node_util.styleText)("yellow", (0, node_util.styleText)("bold", `Change detected: ${type} ${file}`)));
 		try {
 			await cb(path);
 		} catch (_e) {
-			console.log((0, node_util.styleText)("red", "Watcher failed"));
+			log.error((0, node_util.styleText)("red", "Watcher failed"));
 		}
 	});
 }
 //#endregion
-//#region src/runners/generate.ts
-async function runToolPass({ toolValue, detect, toolMap, toolLabel, successPrefix, noToolMessage, configName, outputPath, logLevel, events, onStart, onEnd }) {
+//#region src/runners/generate/run.ts
+/**
+* Registers a one-shot `kubb:hook:end` listener for `hookId` BEFORE the caller emits `kubb:hook:start`,
+* avoiding the race where a synchronous emitter fires end before the listener is attached.
+*/
+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;
+			}
+			onSuccess().then(resolve).catch(reject);
+		};
+		hooks.on("kubb:hook:end", handler);
+	});
+}
+async function runToolPass({ toolValue, detect, toolMap, toolLabel, successPrefix, noToolMessage, configName, outputPath, logLevel, hooks, onStart, onEnd }) {
 	await onStart();
 	let resolvedTool = toolValue;
 	if (resolvedTool === "auto") {
 		const detected = await detect();
-		if (!detected) await events.emit("warn", noToolMessage);
+		if (!detected) await hooks.emit("kubb:warn", { message: noToolMessage });
 		else {
 			resolvedTool = detected;
-			await events.emit("info", `Auto-detected ${toolLabel}: ${(0, node_util.styleText)("dim", resolvedTool)}`);
+			await hooks.emit("kubb:info", { message: `Auto-detected ${toolLabel}: ${(0, node_util.styleText)("dim", resolvedTool)}` });
 		}
 	}
+	let toolError;
 	if (resolvedTool && resolvedTool !== "auto" && resolvedTool in toolMap) {
 		const toolConfig = toolMap[resolvedTool];
+		const hookId = (0, node_crypto.createHash)("sha256").update([configName, resolvedTool].filter(Boolean).join("-")).digest("hex");
+		const successMessage = [
+			`${successPrefix} with ${(0, node_util.styleText)("dim", resolvedTool)}`,
+			logLevel >= _kubb_core.logLevel.info ? `on ${(0, node_util.styleText)("dim", outputPath)}` : void 0,
+			"successfully"
+		].filter(Boolean).join(" ");
 		try {
-			const hookId = (0, node_crypto.createHash)("sha256").update([configName, resolvedTool].filter(Boolean).join("-")).digest("hex");
-			const hookEndPromise = new Promise((resolve, reject) => {
-				const handler = ({ id, success, error }) => {
-					if (id !== hookId) return;
-					events.off("hook:end", handler);
-					if (!success) {
-						reject(error ?? /* @__PURE__ */ new Error(`${toolConfig.errorMessage}`));
-						return;
-					}
-					events.emit("success", [
-						`${successPrefix} with ${(0, node_util.styleText)("dim", resolvedTool)}`,
-						logLevel >= _kubb_core.logLevel.info ? `on ${(0, node_util.styleText)("dim", outputPath)}` : void 0,
-						"successfully"
-					].filter(Boolean).join(" ")).then(resolve).catch(reject);
-				};
-				events.on("hook:end", handler);
-			});
-			await events.emit("hook:start", {
+			const hookEndPromise = waitForHookEnd(hooks, hookId, () => hooks.emit("kubb:success", { message: successMessage }), toolConfig.errorMessage);
+			await hooks.emit("kubb:hook:start", {
 				id: hookId,
 				command: toolConfig.command,
 				args: toolConfig.args(outputPath)
 			});
 			await hookEndPromise;
 		} catch (caughtError) {
-			const err = new Error(toolConfig.errorMessage);
-			err.cause = caughtError;
-			await events.emit("error", err);
+			const err = require_errors.toError(caughtError);
+			await hooks.emit("kubb:error", { error: err });
+			toolError = err;
 		}
 	}
 	await onEnd();
+	if (toolError) throw toolError;
 }
-async function generate({ input, config: userConfig, events, logLevel }) {
-	const inputPath = input ?? ("path" in userConfig.input ? userConfig.input.path : void 0);
+async function generate(options) {
+	const { input, hooks, logLevel, makeSink } = options;
 	const hrStart = node_process.default.hrtime();
+	const inputPath = input ?? (options.config.input && "path" in options.config.input ? options.config.input.path : void 0);
 	const config = {
-		...userConfig,
-		root: userConfig.root || node_process.default.cwd(),
+		...options.config,
 		input: inputPath ? {
-			...userConfig.input,
+			...options.config.input,
 			path: inputPath
-		} : userConfig.input,
-		output: {
-			write: true,
-			barrelType: "named",
-			extension: { ".ts": ".ts" },
-			format: "prettier",
-			...userConfig.output
-		}
+		} : options.config.input,
+		...options.config.output
 	};
-	await events.emit("generation:start", config);
-	await events.emit("info", config.name ? `Setup generation ${(0, node_util.styleText)("bold", config.name)}` : "Setup generation", inputPath);
-	const { sources, fabric, driver } = await (0, _kubb_core.setup)({
-		config,
-		events
+	const kubb = (0, _kubb_core.createKubb)(config, { hooks });
+	await kubb.setup();
+	await hooks.emit("kubb:generation:start", { config });
+	await hooks.emit("kubb:info", {
+		message: config.name ? `Setup generation ${(0, node_util.styleText)("bold", config.name)}` : "Setup generation",
+		info: inputPath
 	});
-	await events.emit("info", config.name ? `Build generation ${(0, node_util.styleText)("bold", config.name)}` : "Build generation", inputPath);
-	const { files, failedPlugins, pluginTimings, error } = await (0, _kubb_core.safeBuild)({
-		config,
-		events
-	}, {
-		driver,
-		fabric,
-		events,
-		sources
+	await hooks.emit("kubb:info", {
+		message: config.name ? `Build generation ${(0, node_util.styleText)("bold", config.name)}` : "Build generation",
+		info: inputPath
 	});
-	await events.emit("info", "Load summary");
+	const { files, failedPlugins, pluginTimings, error, driver } = await kubb.safeBuild();
+	await hooks.emit("kubb:info", { message: "Load summary" });
+	const telemetryPlugins = Array.from(driver.plugins.values(), (p) => ({
+		name: p.name,
+		options: p.options
+	}));
+	const reportTelemetry = (status) => require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
+		command: "generate",
+		kubbVersion: require_package.version,
+		plugins: telemetryPlugins,
+		hrStart,
+		filesCreated: files.length,
+		status
+	}));
 	if (failedPlugins.size > 0 || error) {
-		const allErrors = [error, ...Array.from(failedPlugins).filter((it) => it.error).map((it) => it.error)].filter(Boolean);
-		for (const err of allErrors) await events.emit("error", err);
-		await events.emit("generation:end", config, files, sources);
-		await events.emit("generation:summary", config, {
+		const allErrors = [error, ...Array.from(failedPlugins, (it) => it.error)].filter(Boolean);
+		for (const err of allErrors) await hooks.emit("kubb:error", { error: err });
+		await hooks.emit("kubb:generation:end", {
+			config,
+			files,
+			sources: kubb.sources
+		});
+		await hooks.emit("kubb:generation:summary", {
+			config,
 			failedPlugins,
 			filesCreated: files.length,
 			status: "failed",
 			hrStart,
 			pluginTimings: logLevel >= _kubb_core.logLevel.verbose ? pluginTimings : void 0
 		});
-		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
-			command: "generate",
-			kubbVersion: require_package.version,
-			plugins: driver.plugins.map((p) => ({
-				name: p.name,
-				options: p.options
-			})),
-			hrStart,
-			filesCreated: files.length,
-			status: "failed"
-		}));
+		await reportTelemetry("failed");
 		node_process.default.exit(1);
 	}
-	await events.emit("success", "Generation successfully", inputPath);
-	await events.emit("generation:end", config, files, sources);
+	await hooks.emit("kubb:success", {
+		message: "Generation succeeded",
+		info: inputPath
+	});
+	await hooks.emit("kubb:generation:end", {
+		config,
+		files,
+		sources: kubb.sources
+	});
 	const outputPath = node_path.default.resolve(config.root, config.output.path);
-	if (config.output.format) await runToolPass({
+	const toolPasses = [config.output.format && {
 		toolValue: config.output.format,
-		detect: _kubb_core.detectFormatter,
-		toolMap: _kubb_core.formatters,
+		detect: detectFormatter,
+		toolMap: formatters,
 		toolLabel: "formatter",
 		successPrefix: "Formatting",
-		noToolMessage: "No formatter found (biome, prettier, or oxfmt). Skipping formatting.",
-		configName: config.name,
-		outputPath,
-		logLevel,
-		events,
-		onStart: () => events.emit("format:start"),
-		onEnd: () => events.emit("format:end")
-	});
-	if (config.output.lint) await runToolPass({
+		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 && {
 		toolValue: config.output.lint,
-		detect: _kubb_core.detectLinter,
-		toolMap: _kubb_core.linters,
+		detect: detectLinter,
+		toolMap: linters,
 		toolLabel: "linter",
 		successPrefix: "Linting",
-		noToolMessage: "No linter found (biome, oxlint, or eslint). Skipping 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 pass of toolPasses) await runToolPass({
+		...pass,
 		configName: config.name,
 		outputPath,
 		logLevel,
-		events,
-		onStart: () => events.emit("lint:start"),
-		onEnd: () => events.emit("lint:end")
+		hooks
 	});
 	if (config.hooks) {
-		await events.emit("hooks:start");
+		await hooks.emit("kubb:hooks:start");
 		await executeHooks({
-			hooks: config.hooks,
-			events
+			configHooks: config.hooks,
+			hooks,
+			makeSink
 		});
-		await events.emit("hooks:end");
+		await hooks.emit("kubb:hooks:end");
 	}
-	await events.emit("generation:summary", config, {
+	await hooks.emit("kubb:generation:summary", {
+		config,
 		failedPlugins,
 		filesCreated: files.length,
 		status: "success",
 		hrStart,
 		pluginTimings
 	});
-	await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
-		command: "generate",
-		kubbVersion: require_package.version,
-		plugins: driver.plugins.map((p) => ({
-			name: p.name,
-			options: p.options
-		})),
-		hrStart,
-		filesCreated: files.length,
-		status: "success"
-	}));
+	await reportTelemetry("success");
 }
-async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, watch }) {
-	const logLevel = _kubb_core.logLevel[logLevelKey] ?? _kubb_core.logLevel.info;
-	const events = new AsyncEventEmitter();
-	await setupLogger(events, { logLevel });
+async function checkForUpdate(hooks) {
 	await require_telemetry.executeIfOnline(async () => {
 		try {
-			const latestVersion = (await (await fetch(require_constants.KUBB_NPM_PACKAGE_URL)).json()).version;
-			if (latestVersion && require_package.version < latestVersion) await events.emit("version:new", require_package.version, latestVersion);
+			const data = await (await fetch(require_constants.KUBB_NPM_PACKAGE_URL)).json();
+			if (data.version && require_package.version < data.version) await hooks.emit("kubb:version:new", {
+				currentVersion: require_package.version,
+				latestVersion: data.version
+			});
 		} catch {}
 	});
+}
+/**
+* Runs the full Kubb generation lifecycle for the given CLI options.
+* Sets up the logger, checks for a newer version, loads configs, and calls `generate` for each config entry.
+*/
+async function run({ input, configPath, logLevel: logLevelKey, watch }) {
+	const logLevel = _kubb_core.logLevel[logLevelKey] ?? _kubb_core.logLevel.info;
+	const hooks = new AsyncEventEmitter();
+	const makeSink = await setupLogger(hooks, { logLevel });
+	await checkForUpdate(hooks);
 	try {
-		const result = await getCosmiConfig("kubb", configPath);
-		const configs = await (0, _kubb_core.getConfigs)(result.config, { input });
-		await events.emit("config:start");
-		await events.emit("info", "Config loaded", node_path.default.relative(node_process.default.cwd(), result.filepath));
-		await events.emit("success", "Config loaded successfully", node_path.default.relative(node_process.default.cwd(), result.filepath));
-		await events.emit("config:end", configs);
-		await events.emit("lifecycle:start", require_package.version);
+		const { configs, configPath: resolvedConfigPath } = await getConfigs({
+			configPath,
+			input
+		});
+		const relativeConfigPath = node_path.default.relative(node_process.default.cwd(), resolvedConfigPath);
+		await hooks.emit("kubb:config:start");
+		await hooks.emit("kubb:info", {
+			message: "Config loaded",
+			info: relativeConfigPath
+		});
+		await hooks.emit("kubb:success", {
+			message: "Config loaded successfully",
+			info: relativeConfigPath
+		});
+		await hooks.emit("kubb:config:end", { configs });
+		await hooks.emit("kubb:lifecycle:start", { version: require_package.version });
 		for (const config of configs) if ((0, _kubb_core.isInputPath)(config) && watch) await startWatcher([input || config.input.path], async (paths) => {
-			events.removeAll();
+			hooks.removeAll();
 			await generate({
 				input,
 				config,
 				logLevel,
-				events
+				hooks,
+				makeSink
 			});
 			_clack_prompts.log.step((0, node_util.styleText)("yellow", `Watching for changes in ${paths.join(" and ")}`));
+		}, {
+			info: (msg) => _clack_prompts.log.info(msg),
+			error: (msg) => _clack_prompts.log.error(msg)
 		});
 		else await generate({
 			input,
 			config,
 			logLevel,
-			events
+			hooks,
+			makeSink
 		});
-		await events.emit("lifecycle:end");
+		await hooks.emit("kubb:lifecycle:end");
 	} catch (error) {
-		await events.emit("error", require_errors.toError(error));
+		await hooks.emit("kubb:error", { error: require_errors.toError(error) });
 		node_process.default.exit(1);
 	}
 }
 //#endregion
-exports.runGenerateCommand = runGenerateCommand;
+exports.run = run;
 
-//# sourceMappingURL=generate-Cq5RDTBL.cjs.map
+//# sourceMappingURL=run-CVlrIZoW.cjs.map