@rzl-zone/build-tools 0.0.11 → 0.0.12

package/dist/commander-kit/index.cjs

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/build-tools
 * ------------------------------------------------------------------------
-*  Version: `0.0.11`
+*  Version: `0.0.12`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
 * ========================================================================
@@ -10,10 +10,10 @@
 
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_helper = require('../helper-DNj9Sj4w.cjs');
-const require_server = require('../server-CvLC0e2m.cjs');
-const require_identity = require('../identity-Crq3bzhv.cjs');
-const require_client = require('../client-CuivP4z0.cjs');
+const require_formatter = require('../formatter-DEp7VUev.cjs');
+const require_server = require('../server-CyO1Pxp8.cjs');
+const require_identity = require('../identity-C9ff_g77.cjs');
+const require_client = require('../client-BxJj_VrQ.cjs');
 require("@rzl-zone/node-only");
 let node_path = require("node:path");
 let commander = require("commander");
@@ -30,7 +30,7 @@ function getCommanderErrorCode(err) {
 }
 var CliCommand = class extends commander.Command {
 	constructor(name) {
-		name = require_helper.isNonEmptyString(name) ? name : void 0;
+		name = require_formatter.isNonEmptyString(name) ? name : void 0;
 		super(name);
 	}
 	usage(str) {
@@ -38,7 +38,7 @@ var CliCommand = class extends commander.Command {
 			super.usage("");
 			return this;
 		}
-		if (!require_helper.isNonEmptyString(str)) return super.usage();
+		if (!require_formatter.isNonEmptyString(str)) return super.usage();
 		return super.usage(str);
 	}
 	version(str, flags, description) {
@@ -46,7 +46,7 @@ var CliCommand = class extends commander.Command {
 			super.version("");
 			return this;
 		}
-		if (!require_helper.isNonEmptyString(str)) return super.version();
+		if (!require_formatter.isNonEmptyString(str)) return super.version();
 		return super.version(str, flags, description);
 	}
 };
@@ -59,11 +59,28 @@ function handleCommanderExit(err) {
 	console.error(err);
 	process.exit(1);
 }
+//! Reject primitive values: prototype chains only exist on object-like entities
+//! Safety guard: If target has no prototype (e.g., Object.create(null)), match is impossible
+//! Constraint: Primitives do not have prototype chains and cannot be instances
 function isExactInstanceOf(value, ctor) {
 	//! Constraint: Immediately reject primitives
 	if (value === null || typeof value !== "object" && typeof value !== "function") return false;
 	return Object.getPrototypeOf(value) === ctor.prototype;
 }
+//! Requirement: Must be a function to even be a candidate for a constructor
+//! Safety Guard: If toString fails (e.g. on certain Proxy types), reject immediately
+//! Logic Boundary: If it lacks both ES6 class syntax and native constructor markers, reject as regular function
+//! also Reject ordinary functions that are not constructable class-like entities
+//! Validity constructor must have valid prototype object
+//! Identity Verification: The back-reference must strictly equal the original function
+//! Panic Guard: Catch errors from potential 'poisoned' prototypes or proxy traps
+//! Reference Matching: Ensure the descriptor's value is the exact same object as the prototype link
+//! NOTE:
+//! Native class constructors (e.g. Map, Set, Promise, Error)
+//! may have non-writable prototype properties.
+//!
+//! Therefore, checking descriptor.value identity is sufficient
+//! to confirm structural integrity without enforcing write-ability.
 var CliHelp = class extends commander.Help {
 	constructor() {
 		super();
@@ -165,25 +182,25 @@ function setInternalUiState(cmd, input) {
 }
 function createUIState(input) {
 	const result = {};
-	if (require_helper.isNonEmptyString(input.title)) result.title = input.title;
-	if (require_helper.isNonEmptyString(input.usage)) result.usage = input.usage;
-	if (require_helper.isNonEmptyString(input.packageName)) result.packageName = input.packageName;
-	if (require_helper.isNonEmptyString(input.version)) result.version = input.version;
+	if (require_formatter.isNonEmptyString(input.title)) result.title = input.title;
+	if (require_formatter.isNonEmptyString(input.usage)) result.usage = input.usage;
+	if (require_formatter.isNonEmptyString(input.packageName)) result.packageName = input.packageName;
+	if (require_formatter.isNonEmptyString(input.version)) result.version = input.version;
 	return result;
 }
 function styleUsage(raw, { fromHelpCommandUsage, errorConfig: { field = "raw", expected = "a non-empty string", context = "styleUsage" } = {} } = {}) {
-	if (!require_helper.isNonEmptyString(raw)) throw require_client.ConfigurationError.type(field, expected, raw, context);
+	if (!require_formatter.isNonEmptyString(raw)) throw require_client.ConfigurationError.type(field, expected, raw, context);
 	return raw.split(/\s+/).map((token, index) => {
-		if (!!fromHelpCommandUsage && index === 0) return require_client.picocolors.cyanBright(token);
-		if (token === "[options]") return require_client.picocolors.blueBright(token);
-		if (token === "[command]") return require_client.picocolors.magentaBright(token);
-		if (token.startsWith("<") && token.endsWith(">")) return require_client.picocolors.gray(token);
-		if (token.startsWith("[") && token.endsWith("]")) return require_client.picocolors.gray(token);
+		if (!!fromHelpCommandUsage && index === 0) return require_formatter.picocolors.cyanBright(token);
+		if (token === "[options]") return require_formatter.picocolors.blueBright(token);
+		if (token === "[command]") return require_formatter.picocolors.magentaBright(token);
+		if (token.startsWith("<") && token.endsWith(">")) return require_formatter.picocolors.gray(token);
+		if (token.startsWith("[") && token.endsWith("]")) return require_formatter.picocolors.gray(token);
 		return token;
 	}).join(" ");
 }
 function reorderUsage(raw, { errorConfig: { field = "raw", expected = "a non-empty string", context = "reorderUsage" } = {} } = {}) {
-	if (!require_helper.isNonEmptyString(raw)) throw require_client.ConfigurationError.type(field, expected, raw, context);
+	if (!require_formatter.isNonEmptyString(raw)) throw require_client.ConfigurationError.type(field, expected, raw, context);
 	const tokens = raw.match(/\S+/g) ?? [];
 	const optionTokens = tokens.filter((t) => t === "[options]");
 	return [...tokens.filter((t) => t !== "[options]"), ...optionTokens].join(" ");
@@ -195,8 +212,8 @@ var StyledHelp = class extends CliHelp {
 	commandUsage(cmd) {
 		const { manualUsage, ui, disableUsage } = getInternalState(cmd);
 		if (disableUsage) return "";
-		if (require_helper.isNonEmptyString(manualUsage)) return manualUsage;
-		if (require_helper.isNonEmptyString(ui?.usage)) return ui.usage;
+		if (require_formatter.isNonEmptyString(manualUsage)) return manualUsage;
+		if (require_formatter.isNonEmptyString(ui?.usage)) return ui.usage;
 		return styleUsage(reorderUsage(super.commandUsage(cmd), { errorConfig: {
 			field: "`super.commandUsage(cmd)`",
 			context: "StyledHelp.commandUsage"
@@ -210,20 +227,20 @@ var StyledHelp = class extends CliHelp {
 	}
 	formatHelp(cmd, helper) {
 		const usage = this.commandUsage(cmd);
-		const usageBlock = require_client.joinLinesLoose(require_client.picocolors.reset("Usage:"), `  ${usage}`);
+		const usageBlock = require_formatter.joinLinesLoose(require_formatter.picocolors.reset("Usage:"), `  ${usage}`);
 		const rest = super.formatHelp(cmd, helper);
 		if (!usage) return rest.replace(/^Usage:[\s\S]*?\n(?=\S)/, "");
-		return rest.replace(/^Usage:[\s\S]*?\n(?=\S)/, usageBlock + require_client.EOL + require_client.EOL);
+		return rest.replace(/^Usage:[\s\S]*?\n(?=\S)/, usageBlock + require_formatter.EOL + require_formatter.EOL);
 	}
 	optionDescription(option) {
 		let desc = option.description || "";
 		const hasDefault = option.defaultValue !== void 0;
-		if (require_helper.isNonEmptyString(desc)) {
+		if (require_formatter.isNonEmptyString(desc)) {
 			desc = desc.trim();
 			if (hasDefault) {
 				if (desc.endsWith(".")) desc = desc.slice(0, -1) + "";
 				else if (!desc.endsWith(",")) desc += "";
-				desc += ` ${require_client.picocolors.italic(`(default: ${require_client.formatOptionValue(option.defaultValue)})`)}.`;
+				desc += ` ${require_formatter.picocolors.italic(`(default: ${require_formatter.formatOptionValue(option.defaultValue)})`)}.`;
 			} else if (!desc.trim().endsWith(".")) desc += ".";
 		}
 		return desc;
@@ -238,13 +255,13 @@ function resolveInstanceOriginErrorSuffix(programCommand) {
 function interceptUsage(cmd) {
 	const originalUsage = cmd.usage.bind(cmd);
 	function usage(str) {
-		if (!require_helper.isNil(str)) {
+		if (!require_formatter.isNil(str)) {
 			if (str === false) {
 				getInternalState(cmd).manualUsage = void 0;
 				getInternalState(cmd).disableUsage = true;
 				return cmd;
 			}
-			if (!require_helper.isNonEmptyString(str)) {
+			if (!require_formatter.isNonEmptyString(str)) {
 				const errorMessageByFactory = resolveFactoryOriginErrorSuffix(cmd);
 				const errorMessageInstance = resolveInstanceOriginErrorSuffix(cmd);
 				throw require_client.ConfigurationError.type("usage", "a non-empty string or `false` only", str, `'${errorMessageInstance}.usage'${errorMessageByFactory}`);
@@ -256,7 +273,7 @@ function interceptUsage(cmd) {
 	}
 	cmd.usage = usage;
 }
-const COMMANDER_UI_DEFAULTS = require_helper.deepFreeze({
+const COMMANDER_UI_DEFAULTS = require_formatter.deepFreeze({
 	FLAGS: {
 		VERSION: "-v, --version",
 		HELP: "-h, --help"
@@ -275,15 +292,15 @@ function interceptHelp(cmd) {
 	cmd.helpOption = function(flags, description) {
 		const errorMessageByFactory = resolveFactoryOriginErrorSuffix(cmd);
 		const errorMessageInstance = resolveInstanceOriginErrorSuffix(cmd);
-		if (!require_helper.isNil(flags) && !require_helper.isNonEmptyString(flags) && !require_helper.isBoolean(flags)) {
+		if (!require_formatter.isNil(flags) && !require_formatter.isNonEmptyString(flags) && !require_formatter.isBoolean(flags)) {
 			resetInternalHelpState(cmd);
 			throw require_client.ConfigurationError.type("flags", "a non-empty string or a boolean", flags, `'${errorMessageInstance}.helpOption'${errorMessageByFactory}`);
 		}
-		if (!require_helper.isNil(description) && !require_helper.isNonEmptyString(description)) {
+		if (!require_formatter.isNil(description) && !require_formatter.isNonEmptyString(description)) {
 			resetInternalHelpState(cmd);
 			throw require_client.ConfigurationError.type("description", "a non-empty string if provided", description, `'${errorMessageInstance}.helpOption'${errorMessageByFactory}`);
 		}
-		const _decs = require_helper.isNonEmptyString(description) ? description : DESCRIPTIONS$2.HELP;
+		const _decs = require_formatter.isNonEmptyString(description) ? description : DESCRIPTIONS$2.HELP;
 		if (flags === false) {
 			getInternalState(cmd).help = { disabled: true };
 			return original(flags);
@@ -296,7 +313,7 @@ function interceptHelp(cmd) {
 			};
 			return original(flags, _decs);
 		}
-		if (require_helper.isNonEmptyString(flags)) {
+		if (require_formatter.isNonEmptyString(flags)) {
 			getInternalState(cmd).help = {
 				flags,
 				description: _decs,
@@ -320,11 +337,11 @@ function interceptVersion(cmd, versionDescription) {
 		}
 		const errorMessageByFactory = resolveFactoryOriginErrorSuffix(cmd);
 		const errorMessageInstance = resolveInstanceOriginErrorSuffix(cmd);
-		if (!require_helper.isNonEmptyString(value)) throw require_client.ConfigurationError.type("str", "a non-empty string", value, `'${errorMessageInstance}.version'${errorMessageByFactory}`);
-		if (!require_helper.isNil(flags) && !require_helper.isNonEmptyString(flags)) throw require_client.ConfigurationError.type("flags", "a non-empty string if provided", flags, `'${errorMessageInstance}.version'${errorMessageByFactory}`);
-		if (!require_helper.isNil(description) && !require_helper.isNonEmptyString(description)) throw require_client.ConfigurationError.type("description", "a non-empty string if provided", description, `'${errorMessageInstance}.version'${errorMessageByFactory}`);
-		const _flag = require_helper.isNonEmptyString(flags) ? flags : FLAGS$2.VERSION;
-		const _decs = require_helper.isNonEmptyString(description) ? description : versionDescription;
+		if (!require_formatter.isNonEmptyString(value)) throw require_client.ConfigurationError.type("str", "a non-empty string", value, `'${errorMessageInstance}.version'${errorMessageByFactory}`);
+		if (!require_formatter.isNil(flags) && !require_formatter.isNonEmptyString(flags)) throw require_client.ConfigurationError.type("flags", "a non-empty string if provided", flags, `'${errorMessageInstance}.version'${errorMessageByFactory}`);
+		if (!require_formatter.isNil(description) && !require_formatter.isNonEmptyString(description)) throw require_client.ConfigurationError.type("description", "a non-empty string if provided", description, `'${errorMessageInstance}.version'${errorMessageByFactory}`);
+		const _flag = require_formatter.isNonEmptyString(flags) ? flags : FLAGS$2.VERSION;
+		const _decs = require_formatter.isNonEmptyString(description) ? description : versionDescription;
 		getInternalState(cmd).versionMeta = {
 			value,
 			flags: _flag,
@@ -342,37 +359,37 @@ var CliArgument = class extends commander.Argument {
 };
 const { DESCRIPTIONS: DESCRIPTIONS$1, FLAGS: FLAGS$1 } = COMMANDER_UI_DEFAULTS;
 const composeVersionDescription = (packageName) => {
-	const isPkgNameEmptyString = !require_helper.isNonEmptyString(packageName);
-	if (!require_helper.isUndefined(packageName) && isPkgNameEmptyString) throw require_client.ConfigurationError.type("packageName", "a non-empty string", packageName, "composeVersionDescription");
+	const isPkgNameEmptyString = !require_formatter.isNonEmptyString(packageName);
+	if (!require_formatter.isUndefined(packageName) && isPkgNameEmptyString) throw require_client.ConfigurationError.type("packageName", "a non-empty string", packageName, "composeVersionDescription");
 	return (!isPkgNameEmptyString ? `The version package of ${packageName}.` : DESCRIPTIONS$1.VERSION).trim().replace(/\.*$/, "") + ".";
 };
 function normalizeVersionPrefix(version) {
-	if (!require_helper.isNil(version) && !require_helper.isNonEmptyString(version)) throw require_client.ConfigurationError.type("version", "a non-empty string, null or undefined", version, "composeVersionDescription");
-	if (require_helper.isNull(version)) return null;
+	if (!require_formatter.isNil(version) && !require_formatter.isNonEmptyString(version)) throw require_client.ConfigurationError.type("version", "a non-empty string, null or undefined", version, "composeVersionDescription");
+	if (require_formatter.isNull(version)) return null;
 	return version?.replace(/^v(?=\d)/, "");
 }
 function ensureVersionInjected(cmd, options) {
 	const { pkgNameFormatted, normalizedVersion } = options;
 	const _internal = getInternalState(cmd);
 	if (!_internal.versionSetByUser && !_internal.versionInjected) {
-		const _isNonEmptyString = require_helper.isNonEmptyString(pkgNameFormatted);
+		const _isNonEmptyString = require_formatter.isNonEmptyString(pkgNameFormatted);
 		const _pkgName = _isNonEmptyString ? pkgNameFormatted : void 0;
-		const _subTitle = _isNonEmptyString ? `${pkgNameFormatted} ${require_client.picocolors.reset("version")}:` : `${require_client.picocolors.blueBright("Version")}:`;
-		_internal.versionOriginal?.(require_client.joinLinesLoose(_subTitle, require_client.joinInline(`${require_client.picocolors.magentaBright(require_server.ICONS.arrowRight)}`, `${require_client.picocolors.gray(`v${normalizedVersion}`)}`)), FLAGS$1.VERSION, composeVersionDescription(_pkgName));
+		const _subTitle = _isNonEmptyString ? `${pkgNameFormatted} ${require_formatter.picocolors.reset("version")}:` : `${require_formatter.picocolors.blueBright("Version")}:`;
+		_internal.versionOriginal?.(require_formatter.joinLinesLoose(_subTitle, require_formatter.joinInline(`${require_formatter.picocolors.magentaBright(require_server.ICONS.arrowRight)}`, `${require_formatter.picocolors.gray(`v${normalizedVersion}`)}`)), FLAGS$1.VERSION, composeVersionDescription(_pkgName));
 		_internal.versionInjected = true;
 	}
 }
 function resolveBaseProgramPresentationMeta(params) {
 	const { cliName, packageName, packageVersion, commandIdentity, ui } = params;
-	const resolvedCliName = require_helper.isNonEmptyString(cliName) ? cliName : require_helper.isNonEmptyString(commandIdentity?.commandName) ? commandIdentity.commandName : require_helper.isNonEmptyString(process.argv[1]) ? (0, node_path.parse)(process.argv[1]).name : void 0;
+	const resolvedCliName = require_formatter.isNonEmptyString(cliName) ? cliName : require_formatter.isNonEmptyString(commandIdentity?.commandName) ? commandIdentity.commandName : require_formatter.isNonEmptyString(process.argv[1]) ? (0, node_path.parse)(process.argv[1]).name : void 0;
 	const identityTitle = commandIdentity?.cli?.();
-	const commandTitle = require_helper.isNonEmptyString(identityTitle) ? identityTitle : require_helper.isNonEmptyString(ui?.title) ? ui.title : void 0;
-	const resolvedPackageName = require_helper.isNonEmptyString(packageName) ? packageName : require_helper.isNonEmptyString(commandIdentity?.packageName) ? commandIdentity.packageName : require_identity.PACKAGE_META.name;
-	const resolvedPackageVersion = require_helper.isNonEmptyString(packageVersion) ? packageVersion : require_helper.isNonEmptyString(commandIdentity?.version) ? commandIdentity.version : require_identity.PACKAGE_META.version;
+	const commandTitle = require_formatter.isNonEmptyString(identityTitle) ? identityTitle : require_formatter.isNonEmptyString(ui?.title) ? ui.title : void 0;
+	const resolvedPackageName = require_formatter.isNonEmptyString(packageName) ? packageName : require_formatter.isNonEmptyString(commandIdentity?.packageName) ? commandIdentity.packageName : require_identity.PACKAGE_META.name;
+	const resolvedPackageVersion = require_formatter.isNonEmptyString(packageVersion) ? packageVersion : require_formatter.isNonEmptyString(commandIdentity?.version) ? commandIdentity.version : require_identity.PACKAGE_META.version;
 	const normalizedVersion = normalizeVersionPrefix(resolvedPackageVersion);
 	const isDiffCommandName = !!resolvedCliName && resolvedCliName !== require_identity.PACKAGE_META.name;
-	const pkgNameFormatted = `${require_client.picocolors.blueBright(resolvedPackageName)}${isDiffCommandName ? ` ${require_client.picocolors.cyanBright(`(${resolvedCliName})`)}` : ""}`;
-	const defaultTitleFormatted = require_client.joinInline(require_client.picocolors.blueBright(require_identity.PACKAGE_META.name + "@" + normalizedVersion), isDiffCommandName ? `${require_client.picocolors.magentaBright(require_server.ICONS.arrowRight)} ${require_client.picocolors.yellowBright(resolvedCliName)}` : false);
+	const pkgNameFormatted = `${require_formatter.picocolors.blueBright(resolvedPackageName)}${isDiffCommandName ? ` ${require_formatter.picocolors.cyanBright(`(${resolvedCliName})`)}` : ""}`;
+	const defaultTitleFormatted = require_formatter.joinInline(require_formatter.picocolors.blueBright(require_identity.PACKAGE_META.name + "@" + normalizedVersion), isDiffCommandName ? `${require_formatter.picocolors.magentaBright(require_server.ICONS.arrowRight)} ${require_formatter.picocolors.yellowBright(resolvedCliName)}` : false);
 	return Object.freeze({
 		resolvedCliName,
 		commandTitle,
@@ -428,7 +445,7 @@ function createBaseProgram(options = {}) {
 	interceptHelp(cmd);
 	interceptVersion(cmd, composeVersionDescription(pkgNameFormatted));
 	cmd.createHelp = () => new StyledHelp();
-	cmd.addHelpText("before", require_client.joinLinesLoose("", commandTitle ?? defaultTitleFormatted, ""));
+	cmd.addHelpText("before", require_formatter.joinLinesLoose("", commandTitle ?? defaultTitleFormatted, ""));
 	cmd.exitOverride(handleCommanderExit);
 	const cmdApplyUi = applyCommanderUi(cmd, {
 		title: commandTitle,
@@ -446,21 +463,21 @@ function resolveCliPresentationMeta(params) {
 	const { program, commandName, title, version, packageName } = params;
 	const _internal = getInternalState(program);
 	const isCommandBaseProgram = isExactInstanceOf(program, CommandBaseProgram);
-	const resolvedCliName = require_helper.isNonEmptyString(commandName) ? commandName : require_helper.isNonEmptyString(process.argv[1]) ? (0, node_path.parse)(process.argv[1]).name : void 0;
+	const resolvedCliName = require_formatter.isNonEmptyString(commandName) ? commandName : require_formatter.isNonEmptyString(process.argv[1]) ? (0, node_path.parse)(process.argv[1]).name : void 0;
 	const isDiffCommandName = !!resolvedCliName && resolvedCliName !== require_identity.PACKAGE_META.name;
-	const commandTitle = require_helper.isNonEmptyString(commandName) ? commandName : require_helper.isNonEmptyString(title) ? title : void 0;
-	let normalizedVersion = normalizeVersionPrefix(!isCommandBaseProgram && require_helper.isNonEmptyString(version) ? version : require_helper.isNonEmptyString(_internal.versionMeta?.value) ? _internal.versionMeta.value : void 0);
-	normalizedVersion = require_helper.isNonEmptyString(normalizedVersion) ? normalizedVersion : normalizeVersionPrefix(require_identity.PACKAGE_META.version);
-	const defaultTitleFormatted = require_client.joinInline(require_client.picocolors.blueBright((require_helper.isNonEmptyString(_internal.packageName) ? _internal.packageName : require_identity.PACKAGE_META.name) + "@" + normalizedVersion), isDiffCommandName ? `${require_client.picocolors.magentaBright(require_server.ICONS.arrowRight)} ${require_client.picocolors.yellowBright(resolvedCliName)}` : false);
-	const dynamicUsage = require_helper.isNonEmptyString(_internal.manualUsage) ? _internal.manualUsage : require_helper.isNonEmptyString(_internal.ui?.usage) ? _internal.ui.usage : (isDiffCommandName ? `${require_client.picocolors.cyanBright(resolvedCliName)} ` : "") + (require_helper.isNonEmptyString(program.usage()) ? styleUsage(reorderUsage(program.usage(), { errorConfig: {
+	const commandTitle = require_formatter.isNonEmptyString(commandName) ? commandName : require_formatter.isNonEmptyString(title) ? title : void 0;
+	let normalizedVersion = normalizeVersionPrefix(!isCommandBaseProgram && require_formatter.isNonEmptyString(version) ? version : require_formatter.isNonEmptyString(_internal.versionMeta?.value) ? _internal.versionMeta.value : void 0);
+	normalizedVersion = require_formatter.isNonEmptyString(normalizedVersion) ? normalizedVersion : normalizeVersionPrefix(require_identity.PACKAGE_META.version);
+	const defaultTitleFormatted = require_formatter.joinInline(require_formatter.picocolors.blueBright((require_formatter.isNonEmptyString(_internal.packageName) ? _internal.packageName : require_identity.PACKAGE_META.name) + "@" + normalizedVersion), isDiffCommandName ? `${require_formatter.picocolors.magentaBright(require_server.ICONS.arrowRight)} ${require_formatter.picocolors.yellowBright(resolvedCliName)}` : false);
+	const dynamicUsage = require_formatter.isNonEmptyString(_internal.manualUsage) ? _internal.manualUsage : require_formatter.isNonEmptyString(_internal.ui?.usage) ? _internal.ui.usage : (isDiffCommandName ? `${require_formatter.picocolors.cyanBright(resolvedCliName)} ` : "") + (require_formatter.isNonEmptyString(program.usage()) ? styleUsage(reorderUsage(program.usage(), { errorConfig: {
 		field: "`program.usage()`",
 		context: "resolveCliPresentationMeta (by `program.usage()` at const variable 'dynamicUsage')"
 	} }), { errorConfig: {
 		field: "`reorderUsage(program.usage())`",
 		context: "resolveCliPresentationMeta (by `reorderUsage(program.usage())` at const variable 'dynamicUsage')"
 	} }) : "");
-	const resolvedPackageName = require_helper.isNonEmptyString(packageName) ? packageName : require_identity.PACKAGE_META.name;
-	const resolvedPackageNameFormatted = `${require_client.picocolors.blueBright(resolvedPackageName)}${isDiffCommandName ? ` ${require_client.picocolors.cyanBright(`(${resolvedCliName})`)}` : ""}`;
+	const resolvedPackageName = require_formatter.isNonEmptyString(packageName) ? packageName : require_identity.PACKAGE_META.name;
+	const resolvedPackageNameFormatted = `${require_formatter.picocolors.blueBright(resolvedPackageName)}${isDiffCommandName ? ` ${require_formatter.picocolors.cyanBright(`(${resolvedCliName})`)}` : ""}`;
 	const helpMeta = _internal.help;
 	const isHelpDisabled = helpMeta?.disabled === true;
 	const helpFlags = helpMeta?.flags ?? FLAGS.HELP;
@@ -501,7 +518,7 @@ function applyCommanderUi(program, options) {
 		interceptHelp(program);
 		interceptVersion(program, composeVersionDescription(resolvedPackageNameFormatted));
 		program.createHelp = () => new StyledHelp();
-		program.addHelpText("before", require_client.joinLinesLoose("", commandTitle ?? defaultTitleFormatted, ""));
+		program.addHelpText("before", require_formatter.joinLinesLoose("", commandTitle ?? defaultTitleFormatted, ""));
 		program.exitOverride(handleCommanderExit);
 		installParseVersionInterceptor(program, { versionInjection: {
 			normalizedVersion,
@@ -518,13 +535,13 @@ function applyCommanderUi(program, options) {
 			commandName: __commandName
 		});
 		const printOut = [
-			require_helper.isNonEmptyString(title) ? title : defaultTitleFormatted,
+			require_formatter.isNonEmptyString(title) ? title : defaultTitleFormatted,
 			"",
-			`${require_client.picocolors.bold(`${require_client.picocolors.red(`${require_server.ICONS.error} Error`)}`)} ${require_client.picocolors.redBright(errMsg)}`
+			`${require_formatter.picocolors.bold(`${require_formatter.picocolors.red(`${require_server.ICONS.error} Error`)}`)} ${require_formatter.picocolors.redBright(errMsg)}`
 		];
-		if (!disableUsage && require_helper.isNonEmptyString(dynamicUsage)) printOut.push("", require_client.picocolors.bold("Usage:"), `  ${require_client.picocolors.reset(require_client.picocolors.gray(dynamicUsage))}`);
-		if (!help.disabled) printOut.push("", `${require_client.picocolors.dim("Run")} ${require_client.picocolors.cyanBright(help.flags)} ${require_client.picocolors.dim(help.description)}`);
-		console.error(require_client.joinLinesLoose(...printOut));
+		if (!disableUsage && require_formatter.isNonEmptyString(dynamicUsage)) printOut.push("", require_formatter.picocolors.bold("Usage:"), `  ${require_formatter.picocolors.reset(require_formatter.picocolors.gray(dynamicUsage))}`);
+		if (!help.disabled) printOut.push("", `${require_formatter.picocolors.dim("Run")} ${require_formatter.picocolors.cyanBright(help.flags)} ${require_formatter.picocolors.dim(help.description)}`);
+		console.error(require_formatter.joinLinesLoose(...printOut));
 		process.exit(1);
 	};
 	return program;
@@ -548,6 +565,8 @@ var CliInvalidOptionArgumentError = class extends commander.InvalidOptionArgumen
 const cliCreateArgument = (name, description) => new CliArgument(name, description);
 const cliCreateCommand = (name) => new CliCommand(name);
 const cliCreateOption = (arg, description) => new CliOption(arg, description);
+//! --- CLI ---
+//! --- CLI TYPE ---
 exports.CliArgument = CliArgument;
 exports.CliCommand = CliCommand;
 exports.CliCommanderError = CliCommanderError;