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

package/dist/{generate-D8p6X0le.cjs → generate-C1x42EUt.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-CH6AW-ko.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();
@@ -1207,10 +1306,14 @@ async function getCosmiConfig(moduleName, config) {
 		`.${moduleName}rc.yaml`,
 		`.${moduleName}rc.yml`,
 		`.${moduleName}rc.ts`,
+		`.${moduleName}rc.mts`,
+		`.${moduleName}rc.cts`,
 		`.${moduleName}rc.js`,
 		`.${moduleName}rc.mjs`,
 		`.${moduleName}rc.cjs`,
 		`${moduleName}.config.ts`,
+		`${moduleName}.config.mts`,
+		`${moduleName}.config.cts`,
 		`${moduleName}.config.js`,
 		`${moduleName}.config.mjs`,
 		`${moduleName}.config.cjs`
@@ -1226,7 +1329,11 @@ async function getCosmiConfig(moduleName, config) {
 			}),
 			...searchPlaces
 		],
-		loaders: { ".ts": tsLoader }
+		loaders: {
+			".ts": tsLoader,
+			".mts": tsLoader,
+			".cts": tsLoader
+		}
 	});
 	try {
 		result = config ? await explorer.load(config) : await explorer.search();
@@ -1265,6 +1372,7 @@ async function runToolPass({ toolValue, detect, toolMap, toolLabel, successPrefi
 			await events.emit("info", `Auto-detected ${toolLabel}: ${(0, node_util.styleText)("dim", resolvedTool)}`);
 		}
 	}
+	let toolError;
 	if (resolvedTool && resolvedTool !== "auto" && resolvedTool in toolMap) {
 		const toolConfig = toolMap[resolvedTool];
 		try {
@@ -1295,9 +1403,11 @@ async function runToolPass({ toolValue, detect, toolMap, toolLabel, successPrefi
 			const err = new Error(toolConfig.errorMessage);
 			err.cause = caughtError;
 			await events.emit("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);
@@ -1319,7 +1429,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 +1438,7 @@ async function generate({ input, config: userConfig, events, logLevel }) {
 		config,
 		events
 	}, {
-		pluginManager,
+		driver,
 		fabric,
 		events,
 		sources
@@ -1348,7 +1458,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 +1517,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 +1529,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 +1544,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 +1569,4 @@ async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, wa
 //#endregion
 exports.runGenerateCommand = runGenerateCommand;
 
-//# sourceMappingURL=generate-D8p6X0le.cjs.map
+//# sourceMappingURL=generate-C1x42EUt.cjs.map