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

package/dist/{generate-8xxZmvqZ.js → generate-aphAGUgm.js}

@@ -1,9 +1,9 @@
 import "./chunk--u3MIqq1.js";
-import { n as toCause, r as toError } from "./errors-6mF_WKxg.js";
-import { a as canUseTTY, i as executeIfOnline, o as isGitHubActions, r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-DxiR7clS.js";
-import { n as tokenize } from "./shell-DqqWsHCD.js";
-import { t as version } from "./package-B4LgzOaR.js";
-import { i as WATCHER_IGNORED_PATHS, r as SUMMARY_SEPARATOR, t as KUBB_NPM_PACKAGE_URL } from "./constants-CM3dJzjK.js";
+import { n as toCause, r as toError } from "./errors-CjPmyZHy.js";
+import { a as canUseTTY, i as executeIfOnline, o as isGitHubActions, r as sendTelemetry, t as buildTelemetryEvent } from "./telemetry-CBISr5w4.js";
+import { n as tokenize } from "./shell-DLzN4fRo.js";
+import { t as version } from "./package-Bu9RKng0.js";
+import { a as WATCHER_IGNORED_PATHS, i as SUMMARY_SEPARATOR, t as KUBB_NPM_PACKAGE_URL } from "./constants-DJM9zCXm.js";
 import { styleText } from "node:util";
 import { EventEmitter } from "node:events";
 import { createHash } from "node:crypto";
@@ -12,19 +12,26 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path, { dirname, relative, resolve } from "node:path";
 import process$1 from "node:process";
 import * as clack from "@clack/prompts";
-import { PromiseManager, defineLogger, detectFormatter, detectLinter, formatters, getConfigs, isInputPath, linters, logLevel, safeBuild, setup } from "@kubb/core";
+import { defineLogger, detectFormatter, detectLinter, formatters, getConfigs, isInputPath, linters, logLevel, safeBuild, setup } from "@kubb/core";
 import { NonZeroExitError, x } from "tinyexec";
 import { Writable } from "node:stream";
 import { cosmiconfig } from "cosmiconfig";
 import { createJiti } from "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) {
@@ -32,8 +39,13 @@ var AsyncEventEmitter = class {
 	}
 	#emitter = new 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);
@@ -52,11 +64,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);
@@ -64,11 +90,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();
 	}
@@ -76,8 +116,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);
@@ -85,8 +132,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`;
@@ -94,7 +147,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));
@@ -136,7 +196,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"),
@@ -147,7 +209,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([
@@ -165,7 +232,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",
@@ -178,15 +251,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 styleText(randomColors[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,24 +283,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 = 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 readFile(resolved, { encoding: "utf-8" }) === trimmed) return void 0;
+		if (await readFile(resolved, { encoding: "utf-8" }) === trimmed) return null;
 	} catch {}
 	await mkdir(dirname(resolved), { recursive: true });
 	await writeFile(resolved, trimmed, { encoding: "utf-8" });
@@ -432,15 +522,20 @@ const clackLogger = defineLogger({
 		});
 		context.on("version:new", (version, latestVersion) => {
 			if (logLevel$8 <= logLevel.silent) return;
-			clack.box(`\`v${version}\` → \`v${latestVersion}\`
+			try {
+				clack.box(`\`v${version}\` → \`v${latestVersion}\`
 Run \`npm install -g @kubb/cli\` to update`, "Update available for `Kubb`", {
-				width: "auto",
-				formatBorder: (s) => styleText("yellow", s),
-				rounded: true,
-				withGuide: false,
-				contentAlign: "center",
-				titleAlign: "center"
-			});
+					width: "auto",
+					formatBorder: (s) => 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({
@@ -610,14 +705,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.box(summary.join("\n"), getMessage(title), {
-				width: "auto",
-				formatBorder: (s) => styleText(borderColor, s),
-				rounded: true,
-				withGuide: false,
-				contentAlign: "left",
-				titleAlign: "center"
-			});
+			try {
+				clack.box(summary.join("\n"), getMessage(title), {
+					width: "auto",
+					formatBorder: (s) => styleText(borderColor, s),
+					rounded: true,
+					withGuide: false,
+					contentAlign: "left",
+					titleAlign: "center"
+				});
+			} catch {
+				console.log(summary.join("\n"));
+			}
 		});
 		context.on("lifecycle:end", () => {
 			reset();
@@ -1316,7 +1415,7 @@ async function generate({ input, config: userConfig, events, logLevel: logLevel$
 	};
 	await events.emit("generation:start", config);
 	await events.emit("info", config.name ? `Setup generation ${styleText("bold", config.name)}` : "Setup generation", inputPath);
-	const { sources, fabric, pluginManager } = await setup({
+	const { sources, fabric, driver } = await setup({
 		config,
 		events
 	});
@@ -1325,7 +1424,7 @@ async function generate({ input, config: userConfig, events, logLevel: logLevel$
 		config,
 		events
 	}, {
-		pluginManager,
+		driver,
 		fabric,
 		events,
 		sources
@@ -1345,7 +1444,7 @@ async function generate({ input, config: userConfig, events, logLevel: logLevel$
 		await sendTelemetry(buildTelemetryEvent({
 			command: "generate",
 			kubbVersion: version,
-			plugins: pluginManager.plugins.map((p) => ({
+			plugins: driver.plugins.map((p) => ({
 				name: p.name,
 				options: p.options
 			})),
@@ -1404,7 +1503,7 @@ async function generate({ input, config: userConfig, events, logLevel: logLevel$
 	await sendTelemetry(buildTelemetryEvent({
 		command: "generate",
 		kubbVersion: version,
-		plugins: pluginManager.plugins.map((p) => ({
+		plugins: driver.plugins.map((p) => ({
 			name: p.name,
 			options: p.options
 		})),
@@ -1416,7 +1515,6 @@ async function generate({ input, config: userConfig, events, logLevel: logLevel$
 async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, watch }) {
 	const logLevel$3 = logLevel[logLevelKey] ?? logLevel.info;
 	const events = new AsyncEventEmitter();
-	const promiseManager = new PromiseManager();
 	await setupLogger(events, { logLevel: logLevel$3 });
 	await executeIfOnline(async () => {
 		try {
@@ -1432,30 +1530,22 @@ async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, wa
 		await events.emit("success", "Config loaded successfully", path.relative(process$1.cwd(), result.filepath));
 		await events.emit("config:end", configs);
 		await events.emit("lifecycle:start", version);
-		const promises = configs.map((config) => {
-			return async () => {
-				if (isInputPath(config) && watch) {
-					await startWatcher([input || config.input.path], async (paths) => {
-						events.removeAll();
-						await generate({
-							input,
-							config,
-							logLevel: logLevel$3,
-							events
-						});
-						clack.log.step(styleText("yellow", `Watching for changes in ${paths.join(" and ")}`));
-					});
-					return;
-				}
-				await generate({
-					input,
-					config,
-					logLevel: logLevel$3,
-					events
-				});
-			};
+		for (const config of configs) if (isInputPath(config) && watch) await startWatcher([input || config.input.path], async (paths) => {
+			events.removeAll();
+			await generate({
+				input,
+				config,
+				logLevel: logLevel$3,
+				events
+			});
+			clack.log.step(styleText("yellow", `Watching for changes in ${paths.join(" and ")}`));
+		});
+		else await generate({
+			input,
+			config,
+			logLevel: logLevel$3,
+			events
 		});
-		await promiseManager.run("seq", promises);
 		await events.emit("lifecycle:end");
 	} catch (error) {
 		await events.emit("error", toError(error));
@@ -1465,4 +1555,4 @@ async function runGenerateCommand({ input, configPath, logLevel: logLevelKey, wa
 //#endregion
 export { runGenerateCommand };
 
-//# sourceMappingURL=generate-8xxZmvqZ.js.map
+//# sourceMappingURL=generate-aphAGUgm.js.map