@kubb/cli 5.0.0-alpha.2 → 5.0.0-alpha.20

package/dist/errors-CjPmyZHy.js

@@ -0,0 +1,43 @@
+import "./chunk--u3MIqq1.js";
+//#region ../../internals/utils/src/errors.ts
+/**
+* Coerces an unknown thrown value to an `Error` instance.
+* Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.
+*
+* @example
+* ```ts
+* try { ... } catch(err) {
+*   throw new BuildError('Build failed', { cause: toError(err), errors: [] })
+* }
+* ```
+*/
+function toError(value) {
+	return value instanceof Error ? value : new Error(String(value));
+}
+/**
+* Extracts a human-readable message from any thrown value.
+*
+* @example
+* ```ts
+* getErrorMessage(new Error('oops')) // 'oops'
+* getErrorMessage('plain string')    // 'plain string'
+* ```
+*/
+function getErrorMessage(value) {
+	return value instanceof Error ? value.message : String(value);
+}
+/**
+* Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.
+*
+* @example
+* ```ts
+* const cause = toCause(buildError) // Error | undefined
+* ```
+*/
+function toCause(error) {
+	return error.cause instanceof Error ? error.cause : void 0;
+}
+//#endregion
+export { toCause as n, toError as r, getErrorMessage as t };
+
+//# sourceMappingURL=errors-CjPmyZHy.js.map

package/dist/errors-CjPmyZHy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-CjPmyZHy.js","names":[],"sources":["../../../internals/utils/src/errors.ts"],"sourcesContent":["/** Thrown when a plugin's configuration or input fails validation.\n *\n * @example\n * ```ts\n * throw new ValidationPluginError('Invalid config: \"output.path\" is required')\n * ```\n */\nexport class ValidationPluginError extends Error {}\n\n/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n"],"mappings":";;;;;;;;;;;;;AAuCA,SAAgB,QAAQ,OAAuB;AAC7C,QAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;;;;;;;;;;;AAYlE,SAAgB,gBAAgB,OAAwB;AACtD,QAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;;;;;;;;;;AAW/D,SAAgB,QAAQ,OAAiC;AACvD,QAAO,MAAM,iBAAiB,QAAQ,MAAM,QAAQ,KAAA"}

package/dist/{generate-DYZYA7O1.js → generate-Bem8MuCe.js}

@@ -1,5 +1,5 @@
 import "./chunk--u3MIqq1.js";
-import { n as defineCommand } from "./define--M_JMcDC.js";
+import { n as defineCommand } from "./define-Ctii4bel.js";
 //#region src/commands/generate.ts
 const command = defineCommand({
 	name: "generate",
@@ -51,7 +51,7 @@ const command = defineCommand({
 	},
 	async run({ values, positionals }) {
 		const logLevel = values.debug ? "debug" : values.verbose ? "verbose" : values.silent ? "silent" : values.logLevel;
-		const { runGenerateCommand } = await import("./generate-8xxZmvqZ.js");
+		const { runGenerateCommand } = await import("./generate-aphAGUgm.js");
 		await runGenerateCommand({
 			input: positionals[0],
 			configPath: values.config,
@@ -63,4 +63,4 @@ const command = defineCommand({
 //#endregion
 export { command };
 
-//# sourceMappingURL=generate-DYZYA7O1.js.map
+//# sourceMappingURL=generate-Bem8MuCe.js.map

package/dist/{generate-DYZYA7O1.js.map → generate-Bem8MuCe.js.map}

@@ -1 +1 @@
-{"version":3,"file":"generate-DYZYA7O1.js","names":[],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\n\nexport const command = defineCommand({\n  name: 'generate',\n  description: \"[input] Generate files based on a 'kubb.config.ts' file\",\n  arguments: ['[input]'],\n  options: {\n    config: { type: 'string', description: 'Path to the Kubb config', short: 'c' },\n    logLevel: {\n      type: 'string',\n      description: 'Info, silent, verbose or debug',\n      short: 'l',\n      default: 'info',\n      hint: 'silent|info|verbose|debug',\n      enum: ['silent', 'info', 'verbose', 'debug'],\n    },\n    watch: { type: 'boolean', description: 'Watch mode based on the input file', short: 'w', default: false },\n    debug: { type: 'boolean', description: 'Override logLevel to debug', short: 'd', default: false },\n    verbose: { type: 'boolean', description: 'Override logLevel to verbose', short: 'v', default: false },\n    silent: { type: 'boolean', description: 'Override logLevel to silent', short: 's', default: false },\n  },\n  async run({ values, positionals }) {\n    const logLevel = values.debug ? 'debug' : values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\n    const { runGenerateCommand } = await import('../runners/generate.ts')\n\n    await runGenerateCommand({ input: positionals[0], configPath: values.config, logLevel, watch: values.watch })\n  },\n})\n"],"mappings":";;;AAEA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aAAa;CACb,WAAW,CAAC,UAAU;CACtB,SAAS;EACP,QAAQ;GAAE,MAAM;GAAU,aAAa;GAA2B,OAAO;GAAK;EAC9E,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;IAAW;IAAQ;GAC7C;EACD,OAAO;GAAE,MAAM;GAAW,aAAa;GAAsC,OAAO;GAAK,SAAS;GAAO;EACzG,OAAO;GAAE,MAAM;GAAW,aAAa;GAA8B,OAAO;GAAK,SAAS;GAAO;EACjG,SAAS;GAAE,MAAM;GAAW,aAAa;GAAgC,OAAO;GAAK,SAAS;GAAO;EACrG,QAAQ;GAAE,MAAM;GAAW,aAAa;GAA+B,OAAO;GAAK,SAAS;GAAO;EACpG;CACD,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,QAAQ,UAAU,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EACzG,MAAM,EAAE,uBAAuB,MAAM,OAAO;AAE5C,QAAM,mBAAmB;GAAE,OAAO,YAAY;GAAI,YAAY,OAAO;GAAQ;GAAU,OAAO,OAAO;GAAO,CAAC;;CAEhH,CAAC"}
+{"version":3,"file":"generate-Bem8MuCe.js","names":[],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\n\nexport const command = defineCommand({\n  name: 'generate',\n  description: \"[input] Generate files based on a 'kubb.config.ts' file\",\n  arguments: ['[input]'],\n  options: {\n    config: { type: 'string', description: 'Path to the Kubb config', short: 'c' },\n    logLevel: {\n      type: 'string',\n      description: 'Info, silent, verbose or debug',\n      short: 'l',\n      default: 'info',\n      hint: 'silent|info|verbose|debug',\n      enum: ['silent', 'info', 'verbose', 'debug'],\n    },\n    watch: { type: 'boolean', description: 'Watch mode based on the input file', short: 'w', default: false },\n    debug: { type: 'boolean', description: 'Override logLevel to debug', short: 'd', default: false },\n    verbose: { type: 'boolean', description: 'Override logLevel to verbose', short: 'v', default: false },\n    silent: { type: 'boolean', description: 'Override logLevel to silent', short: 's', default: false },\n  },\n  async run({ values, positionals }) {\n    const logLevel = values.debug ? 'debug' : values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\n    const { runGenerateCommand } = await import('../runners/generate.ts')\n\n    await runGenerateCommand({ input: positionals[0], configPath: values.config, logLevel, watch: values.watch })\n  },\n})\n"],"mappings":";;;AAEA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aAAa;CACb,WAAW,CAAC,UAAU;CACtB,SAAS;EACP,QAAQ;GAAE,MAAM;GAAU,aAAa;GAA2B,OAAO;GAAK;EAC9E,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;IAAW;IAAQ;GAC7C;EACD,OAAO;GAAE,MAAM;GAAW,aAAa;GAAsC,OAAO;GAAK,SAAS;GAAO;EACzG,OAAO;GAAE,MAAM;GAAW,aAAa;GAA8B,OAAO;GAAK,SAAS;GAAO;EACjG,SAAS;GAAE,MAAM;GAAW,aAAa;GAAgC,OAAO;GAAK,SAAS;GAAO;EACrG,QAAQ;GAAE,MAAM;GAAW,aAAa;GAA+B,OAAO;GAAK,SAAS;GAAO;EACpG;CACD,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,QAAQ,UAAU,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EACzG,MAAM,EAAE,uBAAuB,MAAM,OAAO;AAE5C,QAAM,mBAAmB;GAAE,OAAO,YAAY;GAAI,YAAY,OAAO;GAAQ;GAAU,OAAO,OAAO;GAAO,CAAC;;CAEhH,CAAC"}

package/dist/{generate-C52-Gwzu.cjs → generate-D0kZqfuL.cjs}

@@ -1,6 +1,6 @@
 require("./chunk-ByKO4r7w.cjs");
 //#region src/commands/generate.ts
-const command = require("./define-D6Kfm7-Z.cjs").defineCommand({
+const command = require("./define-Bdn8j5VM.cjs").defineCommand({
 	name: "generate",
 	description: "[input] Generate files based on a 'kubb.config.ts' file",
 	arguments: ["[input]"],
@@ -50,7 +50,7 @@ const command = require("./define-D6Kfm7-Z.cjs").defineCommand({
 	},
 	async run({ values, positionals }) {
 		const logLevel = values.debug ? "debug" : values.verbose ? "verbose" : values.silent ? "silent" : values.logLevel;
-		const { runGenerateCommand } = await Promise.resolve().then(() => require("./generate-D8p6X0le.cjs"));
+		const { runGenerateCommand } = await Promise.resolve().then(() => require("./generate-Rcp3a_oB.cjs"));
 		await runGenerateCommand({
 			input: positionals[0],
 			configPath: values.config,
@@ -62,4 +62,4 @@ const command = require("./define-D6Kfm7-Z.cjs").defineCommand({
 //#endregion
 exports.command = command;
 
-//# sourceMappingURL=generate-C52-Gwzu.cjs.map
+//# sourceMappingURL=generate-D0kZqfuL.cjs.map

package/dist/{generate-C52-Gwzu.cjs.map → generate-D0kZqfuL.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"generate-C52-Gwzu.cjs","names":["defineCommand"],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\n\nexport const command = defineCommand({\n  name: 'generate',\n  description: \"[input] Generate files based on a 'kubb.config.ts' file\",\n  arguments: ['[input]'],\n  options: {\n    config: { type: 'string', description: 'Path to the Kubb config', short: 'c' },\n    logLevel: {\n      type: 'string',\n      description: 'Info, silent, verbose or debug',\n      short: 'l',\n      default: 'info',\n      hint: 'silent|info|verbose|debug',\n      enum: ['silent', 'info', 'verbose', 'debug'],\n    },\n    watch: { type: 'boolean', description: 'Watch mode based on the input file', short: 'w', default: false },\n    debug: { type: 'boolean', description: 'Override logLevel to debug', short: 'd', default: false },\n    verbose: { type: 'boolean', description: 'Override logLevel to verbose', short: 'v', default: false },\n    silent: { type: 'boolean', description: 'Override logLevel to silent', short: 's', default: false },\n  },\n  async run({ values, positionals }) {\n    const logLevel = values.debug ? 'debug' : values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\n    const { runGenerateCommand } = await import('../runners/generate.ts')\n\n    await runGenerateCommand({ input: positionals[0], configPath: values.config, logLevel, watch: values.watch })\n  },\n})\n"],"mappings":";;AAEA,MAAa,2CAAUA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,WAAW,CAAC,UAAU;CACtB,SAAS;EACP,QAAQ;GAAE,MAAM;GAAU,aAAa;GAA2B,OAAO;GAAK;EAC9E,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;IAAW;IAAQ;GAC7C;EACD,OAAO;GAAE,MAAM;GAAW,aAAa;GAAsC,OAAO;GAAK,SAAS;GAAO;EACzG,OAAO;GAAE,MAAM;GAAW,aAAa;GAA8B,OAAO;GAAK,SAAS;GAAO;EACjG,SAAS;GAAE,MAAM;GAAW,aAAa;GAAgC,OAAO;GAAK,SAAS;GAAO;EACrG,QAAQ;GAAE,MAAM;GAAW,aAAa;GAA+B,OAAO;GAAK,SAAS;GAAO;EACpG;CACD,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,QAAQ,UAAU,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EACzG,MAAM,EAAE,uBAAuB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,0BAAA,CAAA;AAErC,QAAM,mBAAmB;GAAE,OAAO,YAAY;GAAI,YAAY,OAAO;GAAQ;GAAU,OAAO,OAAO;GAAO,CAAC;;CAEhH,CAAC"}
+{"version":3,"file":"generate-D0kZqfuL.cjs","names":["defineCommand"],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\n\nexport const command = defineCommand({\n  name: 'generate',\n  description: \"[input] Generate files based on a 'kubb.config.ts' file\",\n  arguments: ['[input]'],\n  options: {\n    config: { type: 'string', description: 'Path to the Kubb config', short: 'c' },\n    logLevel: {\n      type: 'string',\n      description: 'Info, silent, verbose or debug',\n      short: 'l',\n      default: 'info',\n      hint: 'silent|info|verbose|debug',\n      enum: ['silent', 'info', 'verbose', 'debug'],\n    },\n    watch: { type: 'boolean', description: 'Watch mode based on the input file', short: 'w', default: false },\n    debug: { type: 'boolean', description: 'Override logLevel to debug', short: 'd', default: false },\n    verbose: { type: 'boolean', description: 'Override logLevel to verbose', short: 'v', default: false },\n    silent: { type: 'boolean', description: 'Override logLevel to silent', short: 's', default: false },\n  },\n  async run({ values, positionals }) {\n    const logLevel = values.debug ? 'debug' : values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\n    const { runGenerateCommand } = await import('../runners/generate.ts')\n\n    await runGenerateCommand({ input: positionals[0], configPath: values.config, logLevel, watch: values.watch })\n  },\n})\n"],"mappings":";;AAEA,MAAa,2CAAUA,cAAc;CACnC,MAAM;CACN,aAAa;CACb,WAAW,CAAC,UAAU;CACtB,SAAS;EACP,QAAQ;GAAE,MAAM;GAAU,aAAa;GAA2B,OAAO;GAAK;EAC9E,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;IAAW;IAAQ;GAC7C;EACD,OAAO;GAAE,MAAM;GAAW,aAAa;GAAsC,OAAO;GAAK,SAAS;GAAO;EACzG,OAAO;GAAE,MAAM;GAAW,aAAa;GAA8B,OAAO;GAAK,SAAS;GAAO;EACjG,SAAS;GAAE,MAAM;GAAW,aAAa;GAAgC,OAAO;GAAK,SAAS;GAAO;EACrG,QAAQ;GAAE,MAAM;GAAW,aAAa;GAA+B,OAAO;GAAK,SAAS;GAAO;EACpG;CACD,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,QAAQ,UAAU,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EACzG,MAAM,EAAE,uBAAuB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,0BAAA,CAAA;AAErC,QAAM,mBAAmB;GAAE,OAAO,YAAY;GAAI,YAAY,OAAO;GAAQ;GAAU,OAAO,OAAO;GAAO,CAAC;;CAEhH,CAAC"}

package/dist/{generate-D8p6X0le.cjs → generate-Rcp3a_oB.cjs}

@@ -1,9 +1,9 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
-const require_errors = require("./errors-DBW0N9w4.cjs");
-const require_telemetry = require("./telemetry-Cn9X1I5B.cjs");
-const require_shell = require("./shell-7HPrTCJ5.cjs");
-const require_package = require("./package-lo3R7SUU.cjs");
-const require_constants = require("./constants-BTUap0zs.cjs");
+const require_errors = require("./errors-CLCjoSg0.cjs");
+const require_telemetry = require("./telemetry-YO-uwAbf.cjs");
+const require_shell = require("./shell-475fQKaX.cjs");
+const require_package = require("./package-DcCkJTYU.cjs");
+const require_constants = require("./constants-D0XHAHeZ.cjs");
 let node_util = require("node:util");
 let node_events = require("node:events");
 let node_crypto = require("node:crypto");
@@ -22,12 +22,19 @@ let cosmiconfig = require("cosmiconfig");
 let jiti = require("jiti");
 //#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,8 +42,13 @@ 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 in parallel.
 	* 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);
@@ -55,11 +67,25 @@ var AsyncEventEmitter = class {
 			}
 		}));
 	}
-	/** 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 +93,25 @@ 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. */
+	/**
+	* Removes all listeners from every event channel.
+	*
+	* @example
+	* ```ts
+	* emitter.removeAll()
+	* ```
+	*/
 	removeAll() {
 		this.#emitter.removeAllListeners();
 	}
@@ -79,8 +119,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 +135,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 +150,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,7 +199,9 @@ 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 = {
 	lid: hex("#F55A17"),
 	woodTop: hex("#F5A217"),
@@ -150,7 +212,12 @@ const palette = {
 	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 +235,13 @@ function getIntro({ title, description, version, areEyesOpen }) {
    ${palette.woodBase("▀▀▀▀▀▀▀▀▀▀▀▀▀")}
 `;
 }
-/** ANSI color names available for terminal output. */
+/** ANSI color names available for deterministic terminal coloring.
+*
+* @example
+* ```ts
+* const color = randomColors[2] // 'green'
+* ```
+*/
 const randomColors = [
 	"black",
 	"red",
@@ -181,15 +254,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[33mpetstore\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);
@@ -201,24 +286,29 @@ function formatMsWithColor(ms) {
 //#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" });
@@ -435,15 +525,20 @@ const clackLogger = (0, _kubb_core.defineLogger)({
 		});
 		context.on("version:new", (version, latestVersion) => {
 			if (logLevel <= _kubb_core.logLevel.silent) return;
-			_clack_prompts.box(`\`v${version}\` → \`v${latestVersion}\`
+			try {
+				_clack_prompts.box(`\`v${version}\` → \`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${version} → v${latestVersion}`);
+				console.log("Run `npm install -g @kubb/cli` to update");
+			}
 		});
 		context.on("lifecycle:start", async (version) => {
 			console.log(`\n${getIntro({
@@ -613,14 +708,18 @@ 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", () => {
 			reset();
@@ -1319,7 +1418,7 @@ async function generate({ input, config: userConfig, events, logLevel }) {
 	};
 	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, pluginManager } = await (0, _kubb_core.setup)({
+	const { sources, fabric, driver } = await (0, _kubb_core.setup)({
 		config,
 		events
 	});
@@ -1328,7 +1427,7 @@ async function generate({ input, config: userConfig, events, logLevel }) {
 		config,
 		events
 	}, {
-		pluginManager,
+		driver,
 		fabric,
 		events,
 		sources
@@ -1348,7 +1447,7 @@ async function generate({ input, config: userConfig, events, logLevel }) {
 		await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
 			command: "generate",
 			kubbVersion: require_package.version,
-			plugins: pluginManager.plugins.map((p) => ({
+			plugins: driver.plugins.map((p) => ({
 				name: p.name,
 				options: p.options
 			})),
@@ -1407,7 +1506,7 @@ async function generate({ input, config: userConfig, events, logLevel }) {
 	await require_telemetry.sendTelemetry(require_telemetry.buildTelemetryEvent({
 		command: "generate",
 		kubbVersion: require_package.version,
-		plugins: pluginManager.plugins.map((p) => ({
+		plugins: driver.plugins.map((p) => ({
 			name: p.name,
 			options: p.options
 		})),
@@ -1419,7 +1518,6 @@ async function generate({ input, config: userConfig, events, logLevel }) {
 async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, watch }) {
 	const logLevel = _kubb_core.logLevel[logLevelKey] ?? _kubb_core.logLevel.info;
 	const events = new AsyncEventEmitter();
-	const promiseManager = new _kubb_core.PromiseManager();
 	await setupLogger(events, { logLevel });
 	await require_telemetry.executeIfOnline(async () => {
 		try {
@@ -1435,30 +1533,22 @@ async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, wa
 		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 promises = configs.map((config) => {
-			return async () => {
-				if ((0, _kubb_core.isInputPath)(config) && watch) {
-					await startWatcher([input || config.input.path], async (paths) => {
-						events.removeAll();
-						await generate({
-							input,
-							config,
-							logLevel,
-							events
-						});
-						_clack_prompts.log.step((0, node_util.styleText)("yellow", `Watching for changes in ${paths.join(" and ")}`));
-					});
-					return;
-				}
-				await generate({
-					input,
-					config,
-					logLevel,
-					events
-				});
-			};
+		for (const config of configs) if ((0, _kubb_core.isInputPath)(config) && watch) await startWatcher([input || config.input.path], async (paths) => {
+			events.removeAll();
+			await generate({
+				input,
+				config,
+				logLevel,
+				events
+			});
+			_clack_prompts.log.step((0, node_util.styleText)("yellow", `Watching for changes in ${paths.join(" and ")}`));
+		});
+		else await generate({
+			input,
+			config,
+			logLevel,
+			events
 		});
-		await promiseManager.run("seq", promises);
 		await events.emit("lifecycle:end");
 	} catch (error) {
 		await events.emit("error", require_errors.toError(error));
@@ -1468,4 +1558,4 @@ async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, wa
 //#endregion
 exports.runGenerateCommand = runGenerateCommand;
 
-//# sourceMappingURL=generate-D8p6X0le.cjs.map
+//# sourceMappingURL=generate-Rcp3a_oB.cjs.map