@codefast/cli 0.3.13-canary.3 → 0.3.13-canary.4

package/dist/lib/arrange/presentation/prepare-arrange.orchestrator.mjs

@@ -0,0 +1,258 @@
+import { CliFsToken } from "../../core/operational/contracts/tokens.mjs";
+import { appError } from "../../core/domain/errors.domain.mjs";
+import { err, ok } from "../../core/domain/result.model.mjs";
+import { messageFromCaughtUnknown } from "../../core/application/utils/caught-unknown-message.util.mjs";
+import { findRepoRoot } from "../../infra/workspace/repo-root.adapter.mjs";
+import { resolveArrangeCliTargetPath } from "./resolve-arrange-cli-target.presenter.mjs";
+import { TryLoadCodefastConfigPresenterToken } from "../../core/contracts/tokens.mjs";
+import { inject, injectable } from "@codefast/di";
+//#region src/lib/arrange/presentation/prepare-arrange.orchestrator.ts
+function toPrimitive(input, hint) {
+	if (typeof input !== "object" || input === null) return input;
+	var prim = input[Symbol.toPrimitive];
+	if (prim !== void 0) {
+		var res = prim.call(input, hint || "default");
+		if (typeof res !== "object") return res;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return (hint === "string" ? String : Number)(input);
+}
+function toPropertyKey(arg) {
+	var key = toPrimitive(arg, "string");
+	return typeof key === "symbol" ? key : String(key);
+}
+function checkInRHS(value) {
+	if (Object(value) !== value) throw TypeError("right-hand side of 'in' should be an object, got " + (value !== null ? typeof value : "null"));
+	return value;
+}
+function setFunctionName(fn, name, prefix) {
+	if (typeof name === "symbol") {
+		name = name.description;
+		name = name ? "[" + name + "]" : "";
+	}
+	try {
+		Object.defineProperty(fn, "name", {
+			configurable: true,
+			value: prefix ? prefix + " " + name : name
+		});
+	} catch (_) {}
+	return fn;
+}
+function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis, instanceBrand, parentClass) {
+	var symbolMetadata = Symbol.metadata || Symbol.for("Symbol.metadata");
+	var defineProperty = Object.defineProperty;
+	var create = Object.create;
+	var metadata;
+	var existingNonFields = [create(null), create(null)];
+	var hasClassDecs = classDecs.length;
+	var _;
+	function createRunInitializers(initializers, useStaticThis, hasValue) {
+		return function(thisArg, value) {
+			if (useStaticThis) {
+				value = thisArg;
+				thisArg = targetClass;
+			}
+			for (var i = 0; i < initializers.length; i++) value = initializers[i].apply(thisArg, hasValue ? [value] : []);
+			return hasValue ? value : thisArg;
+		};
+	}
+	function assertCallable(fn, hint1, hint2, throwUndefined) {
+		if (typeof fn !== "function") {
+			if (throwUndefined || fn !== void 0) throw new TypeError(hint1 + " must " + (hint2 || "be") + " a function" + (throwUndefined ? "" : " or undefined"));
+		}
+		return fn;
+	}
+	function applyDec(Class, decInfo, decoratorsHaveThis, name, kind, initializers, ret, isStatic, isPrivate, isField, hasPrivateBrand) {
+		function assertInstanceIfPrivate(target) {
+			if (!hasPrivateBrand(target)) throw new TypeError("Attempted to access private element on non-instance");
+		}
+		var decs = [].concat(decInfo[0]);
+		var decVal = decInfo[3];
+		var isClass = !ret;
+		var isAccessor = kind === 1;
+		var isGetter = kind === 3;
+		var isSetter = kind === 4;
+		var isMethod = kind === 2;
+		function bindPropCall(name, useStaticThis, before) {
+			return function(_this, value) {
+				if (useStaticThis) {
+					value = _this;
+					_this = Class;
+				}
+				if (before) before(_this);
+				return desc[name].call(_this, value);
+			};
+		}
+		var desc1 = {};
+		var init = [];
+		var key = isGetter ? "get" : isSetter || isAccessor ? "set" : "value";
+		if (!isClass) {
+			if (isPrivate) {
+				if (isField || isAccessor) desc1 = {
+					get: setFunctionName(function() {
+						return decVal(this);
+					}, name, "get"),
+					set: function(value) {
+						decInfo[4](this, value);
+					}
+				};
+				else desc1[key] = decVal;
+				if (!isField) setFunctionName(desc1[key], name, isMethod ? "" : key);
+			} else if (!isField) desc1 = Object.getOwnPropertyDescriptor(Class, name);
+			if (!isField && !isPrivate) {
+				_ = existingNonFields[+isStatic][name];
+				if (_ && (_ ^ kind) !== 7) throw new Error("Decorating two elements with the same name (" + desc1[key].name + ") is not supported yet");
+				existingNonFields[+isStatic][name] = kind < 3 ? 1 : kind;
+			}
+		}
+		var newValue = Class;
+		for (var i = decs.length - 1; i >= 0; i -= decoratorsHaveThis ? 2 : 1) {
+			var dec = assertCallable(decs[i], "A decorator", "be", true);
+			var decThis = decoratorsHaveThis ? decs[i - 1] : void 0;
+			var decoratorFinishedRef = {};
+			var ctx = {
+				kind: [
+					"field",
+					"accessor",
+					"method",
+					"getter",
+					"setter",
+					"class"
+				][kind],
+				name,
+				metadata,
+				addInitializer: (function(decoratorFinishedRef, initializer) {
+					if (decoratorFinishedRef.v) throw new TypeError("attempted to call addInitializer after decoration was finished");
+					assertCallable(initializer, "An initializer", "be", true);
+					initializers.push(initializer);
+				}).bind(null, decoratorFinishedRef)
+			};
+			if (isClass) {
+				_ = dec.call(decThis, newValue, ctx);
+				decoratorFinishedRef.v = 1;
+				if (assertCallable(_, "class decorators", "return")) newValue = _;
+				continue;
+			}
+			ctx.static = isStatic;
+			ctx.private = isPrivate;
+			_ = ctx.access = { has: isPrivate ? hasPrivateBrand.bind() : function(target) {
+				return name in target;
+			} };
+			if (!isSetter) _.get = isPrivate ? isMethod ? function(_this) {
+				assertInstanceIfPrivate(_this);
+				return desc1.value;
+			} : bindPropCall("get", 0, assertInstanceIfPrivate) : function(target) {
+				return target[name];
+			};
+			if (!isMethod && !isGetter) _.set = isPrivate ? bindPropCall("set", 0, assertInstanceIfPrivate) : function(target, value) {
+				target[name] = value;
+			};
+			newValue = dec.call(decThis, isAccessor ? {
+				get: desc1.get,
+				set: desc1.set
+			} : desc1[key], ctx);
+			decoratorFinishedRef.v = 1;
+			if (isAccessor) {
+				if (typeof newValue === "object" && newValue) {
+					if (_ = assertCallable(newValue.get, "accessor.get")) desc1.get = _;
+					if (_ = assertCallable(newValue.set, "accessor.set")) desc1.set = _;
+					if (_ = assertCallable(newValue.init, "accessor.init")) init.unshift(_);
+				} else if (newValue !== void 0) throw new TypeError("accessor decorators must return an object with get, set, or init properties or undefined");
+			} else if (assertCallable(newValue, (isField ? "field" : "method") + " decorators", "return")) if (isField) init.unshift(newValue);
+			else desc1[key] = newValue;
+		}
+		if (kind < 2) ret.push(createRunInitializers(init, isStatic, 1), createRunInitializers(initializers, isStatic, 0));
+		if (!isField && !isClass) if (isPrivate) if (isAccessor) ret.splice(-1, 0, bindPropCall("get", isStatic), bindPropCall("set", isStatic));
+		else ret.push(isMethod ? desc1[key] : assertCallable.call.bind(desc1[key]));
+		else defineProperty(Class, name, desc1);
+		return newValue;
+	}
+	function applyMemberDecs() {
+		var ret = [];
+		var protoInitializers;
+		var staticInitializers;
+		var pushInitializers = function(initializers) {
+			if (initializers) ret.push(createRunInitializers(initializers));
+		};
+		var applyMemberDecsOfKind = function(isStatic, isField) {
+			for (var i = 0; i < memberDecs.length; i++) {
+				var decInfo = memberDecs[i];
+				var kind = decInfo[1];
+				var kindOnly = kind & 7;
+				if ((kind & 8) == isStatic && !kindOnly == isField) {
+					var name = decInfo[2];
+					var isPrivate = !!decInfo[3];
+					var decoratorsHaveThis = kind & 16;
+					applyDec(isStatic ? targetClass : targetClass.prototype, decInfo, decoratorsHaveThis, isPrivate ? "#" + name : toPropertyKey(name), kindOnly, kindOnly < 2 ? [] : isStatic ? staticInitializers = staticInitializers || [] : protoInitializers = protoInitializers || [], ret, !!isStatic, isPrivate, isField, isStatic && isPrivate ? function(_) {
+						return checkInRHS(_) === targetClass;
+					} : instanceBrand);
+				}
+			}
+		};
+		applyMemberDecsOfKind(8, 0);
+		applyMemberDecsOfKind(0, 0);
+		applyMemberDecsOfKind(8, 1);
+		applyMemberDecsOfKind(0, 1);
+		pushInitializers(protoInitializers);
+		pushInitializers(staticInitializers);
+		return ret;
+	}
+	function defineMetadata(Class) {
+		return defineProperty(Class, symbolMetadata, {
+			configurable: true,
+			enumerable: true,
+			value: metadata
+		});
+	}
+	if (parentClass !== void 0) metadata = parentClass[symbolMetadata];
+	metadata = create(metadata == null ? null : metadata);
+	_ = applyMemberDecs();
+	if (!hasClassDecs) defineMetadata(targetClass);
+	return {
+		e: _,
+		get c() {
+			var initializers = [];
+			return hasClassDecs && [defineMetadata(targetClass = applyDec(targetClass, [classDecs], classDecsHaveThis, targetClass.name, 5, initializers)), createRunInitializers(initializers, 1)];
+		}
+	};
+}
+let _dec, _initClass;
+_dec = injectable([inject(CliFsToken), inject(TryLoadCodefastConfigPresenterToken)]);
+let _PrepareArrangeOrchestrator;
+(class {
+	fs;
+	tryLoadCodefastConfig;
+	static {
+		({c: [_PrepareArrangeOrchestrator, _initClass]} = _apply_decs_2311(this, [_dec], []));
+	}
+	constructor(fs, tryLoadCodefastConfig) {
+		this.fs = fs;
+		this.tryLoadCodefastConfig = tryLoadCodefastConfig;
+	}
+	async execute(args) {
+		const resolvedTarget = resolveArrangeCliTargetPath({
+			fs: this.fs,
+			currentWorkingDirectory: args.currentWorkingDirectory,
+			rawTarget: args.rawTarget
+		});
+		if (!this.fs.existsSync(resolvedTarget)) return err(appError("NOT_FOUND", `Not found: ${resolvedTarget}`));
+		let rootDir;
+		try {
+			rootDir = findRepoRoot(this.fs, args.currentWorkingDirectory);
+		} catch (caughtError) {
+			return err(appError("INFRA_FAILURE", messageFromCaughtUnknown(caughtError), caughtError));
+		}
+		const loadedOutcome = await this.tryLoadCodefastConfig.execute(rootDir);
+		if (!loadedOutcome.ok) return loadedOutcome;
+		return ok({
+			resolvedTarget,
+			rootDir,
+			config: loadedOutcome.value.config
+		});
+	}
+	static {
+		_initClass();
+	}
+});
+//#endregion
+export { _PrepareArrangeOrchestrator as PrepareArrangeOrchestrator };

package/dist/lib/arrange/presentation/present-analyze-cli.presenter.mjs

@@ -0,0 +1,7 @@
+import { printAnalyzeReport } from "./report.presenter.mjs";
+//#region src/lib/arrange/presentation/present-analyze-cli.presenter.ts
+function presentAnalyzeCliReport(logger, resolvedTargetPath, report) {
+	printAnalyzeReport(resolvedTargetPath, report, logger);
+}
+//#endregion
+export { presentAnalyzeCliReport };

package/dist/lib/arrange/presentation/present-analyze-report.presenter.mjs

@@ -0,0 +1,233 @@
+import { CliLoggerToken } from "../../core/operational/contracts/tokens.mjs";
+import { presentAnalyzeCliReport } from "./present-analyze-cli.presenter.mjs";
+import { inject, injectable } from "@codefast/di";
+//#region src/lib/arrange/presentation/present-analyze-report.presenter.ts
+function toPrimitive(input, hint) {
+	if (typeof input !== "object" || input === null) return input;
+	var prim = input[Symbol.toPrimitive];
+	if (prim !== void 0) {
+		var res = prim.call(input, hint || "default");
+		if (typeof res !== "object") return res;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return (hint === "string" ? String : Number)(input);
+}
+function toPropertyKey(arg) {
+	var key = toPrimitive(arg, "string");
+	return typeof key === "symbol" ? key : String(key);
+}
+function checkInRHS(value) {
+	if (Object(value) !== value) throw TypeError("right-hand side of 'in' should be an object, got " + (value !== null ? typeof value : "null"));
+	return value;
+}
+function setFunctionName(fn, name, prefix) {
+	if (typeof name === "symbol") {
+		name = name.description;
+		name = name ? "[" + name + "]" : "";
+	}
+	try {
+		Object.defineProperty(fn, "name", {
+			configurable: true,
+			value: prefix ? prefix + " " + name : name
+		});
+	} catch (_) {}
+	return fn;
+}
+function _apply_decs_2311(targetClass, classDecs, memberDecs, classDecsHaveThis, instanceBrand, parentClass) {
+	var symbolMetadata = Symbol.metadata || Symbol.for("Symbol.metadata");
+	var defineProperty = Object.defineProperty;
+	var create = Object.create;
+	var metadata;
+	var existingNonFields = [create(null), create(null)];
+	var hasClassDecs = classDecs.length;
+	var _;
+	function createRunInitializers(initializers, useStaticThis, hasValue) {
+		return function(thisArg, value) {
+			if (useStaticThis) {
+				value = thisArg;
+				thisArg = targetClass;
+			}
+			for (var i = 0; i < initializers.length; i++) value = initializers[i].apply(thisArg, hasValue ? [value] : []);
+			return hasValue ? value : thisArg;
+		};
+	}
+	function assertCallable(fn, hint1, hint2, throwUndefined) {
+		if (typeof fn !== "function") {
+			if (throwUndefined || fn !== void 0) throw new TypeError(hint1 + " must " + (hint2 || "be") + " a function" + (throwUndefined ? "" : " or undefined"));
+		}
+		return fn;
+	}
+	function applyDec(Class, decInfo, decoratorsHaveThis, name, kind, initializers, ret, isStatic, isPrivate, isField, hasPrivateBrand) {
+		function assertInstanceIfPrivate(target) {
+			if (!hasPrivateBrand(target)) throw new TypeError("Attempted to access private element on non-instance");
+		}
+		var decs = [].concat(decInfo[0]);
+		var decVal = decInfo[3];
+		var isClass = !ret;
+		var isAccessor = kind === 1;
+		var isGetter = kind === 3;
+		var isSetter = kind === 4;
+		var isMethod = kind === 2;
+		function bindPropCall(name, useStaticThis, before) {
+			return function(_this, value) {
+				if (useStaticThis) {
+					value = _this;
+					_this = Class;
+				}
+				if (before) before(_this);
+				return desc[name].call(_this, value);
+			};
+		}
+		var desc1 = {};
+		var init = [];
+		var key = isGetter ? "get" : isSetter || isAccessor ? "set" : "value";
+		if (!isClass) {
+			if (isPrivate) {
+				if (isField || isAccessor) desc1 = {
+					get: setFunctionName(function() {
+						return decVal(this);
+					}, name, "get"),
+					set: function(value) {
+						decInfo[4](this, value);
+					}
+				};
+				else desc1[key] = decVal;
+				if (!isField) setFunctionName(desc1[key], name, isMethod ? "" : key);
+			} else if (!isField) desc1 = Object.getOwnPropertyDescriptor(Class, name);
+			if (!isField && !isPrivate) {
+				_ = existingNonFields[+isStatic][name];
+				if (_ && (_ ^ kind) !== 7) throw new Error("Decorating two elements with the same name (" + desc1[key].name + ") is not supported yet");
+				existingNonFields[+isStatic][name] = kind < 3 ? 1 : kind;
+			}
+		}
+		var newValue = Class;
+		for (var i = decs.length - 1; i >= 0; i -= decoratorsHaveThis ? 2 : 1) {
+			var dec = assertCallable(decs[i], "A decorator", "be", true);
+			var decThis = decoratorsHaveThis ? decs[i - 1] : void 0;
+			var decoratorFinishedRef = {};
+			var ctx = {
+				kind: [
+					"field",
+					"accessor",
+					"method",
+					"getter",
+					"setter",
+					"class"
+				][kind],
+				name,
+				metadata,
+				addInitializer: (function(decoratorFinishedRef, initializer) {
+					if (decoratorFinishedRef.v) throw new TypeError("attempted to call addInitializer after decoration was finished");
+					assertCallable(initializer, "An initializer", "be", true);
+					initializers.push(initializer);
+				}).bind(null, decoratorFinishedRef)
+			};
+			if (isClass) {
+				_ = dec.call(decThis, newValue, ctx);
+				decoratorFinishedRef.v = 1;
+				if (assertCallable(_, "class decorators", "return")) newValue = _;
+				continue;
+			}
+			ctx.static = isStatic;
+			ctx.private = isPrivate;
+			_ = ctx.access = { has: isPrivate ? hasPrivateBrand.bind() : function(target) {
+				return name in target;
+			} };
+			if (!isSetter) _.get = isPrivate ? isMethod ? function(_this) {
+				assertInstanceIfPrivate(_this);
+				return desc1.value;
+			} : bindPropCall("get", 0, assertInstanceIfPrivate) : function(target) {
+				return target[name];
+			};
+			if (!isMethod && !isGetter) _.set = isPrivate ? bindPropCall("set", 0, assertInstanceIfPrivate) : function(target, value) {
+				target[name] = value;
+			};
+			newValue = dec.call(decThis, isAccessor ? {
+				get: desc1.get,
+				set: desc1.set
+			} : desc1[key], ctx);
+			decoratorFinishedRef.v = 1;
+			if (isAccessor) {
+				if (typeof newValue === "object" && newValue) {
+					if (_ = assertCallable(newValue.get, "accessor.get")) desc1.get = _;
+					if (_ = assertCallable(newValue.set, "accessor.set")) desc1.set = _;
+					if (_ = assertCallable(newValue.init, "accessor.init")) init.unshift(_);
+				} else if (newValue !== void 0) throw new TypeError("accessor decorators must return an object with get, set, or init properties or undefined");
+			} else if (assertCallable(newValue, (isField ? "field" : "method") + " decorators", "return")) if (isField) init.unshift(newValue);
+			else desc1[key] = newValue;
+		}
+		if (kind < 2) ret.push(createRunInitializers(init, isStatic, 1), createRunInitializers(initializers, isStatic, 0));
+		if (!isField && !isClass) if (isPrivate) if (isAccessor) ret.splice(-1, 0, bindPropCall("get", isStatic), bindPropCall("set", isStatic));
+		else ret.push(isMethod ? desc1[key] : assertCallable.call.bind(desc1[key]));
+		else defineProperty(Class, name, desc1);
+		return newValue;
+	}
+	function applyMemberDecs() {
+		var ret = [];
+		var protoInitializers;
+		var staticInitializers;
+		var pushInitializers = function(initializers) {
+			if (initializers) ret.push(createRunInitializers(initializers));
+		};
+		var applyMemberDecsOfKind = function(isStatic, isField) {
+			for (var i = 0; i < memberDecs.length; i++) {
+				var decInfo = memberDecs[i];
+				var kind = decInfo[1];
+				var kindOnly = kind & 7;
+				if ((kind & 8) == isStatic && !kindOnly == isField) {
+					var name = decInfo[2];
+					var isPrivate = !!decInfo[3];
+					var decoratorsHaveThis = kind & 16;
+					applyDec(isStatic ? targetClass : targetClass.prototype, decInfo, decoratorsHaveThis, isPrivate ? "#" + name : toPropertyKey(name), kindOnly, kindOnly < 2 ? [] : isStatic ? staticInitializers = staticInitializers || [] : protoInitializers = protoInitializers || [], ret, !!isStatic, isPrivate, isField, isStatic && isPrivate ? function(_) {
+						return checkInRHS(_) === targetClass;
+					} : instanceBrand);
+				}
+			}
+		};
+		applyMemberDecsOfKind(8, 0);
+		applyMemberDecsOfKind(0, 0);
+		applyMemberDecsOfKind(8, 1);
+		applyMemberDecsOfKind(0, 1);
+		pushInitializers(protoInitializers);
+		pushInitializers(staticInitializers);
+		return ret;
+	}
+	function defineMetadata(Class) {
+		return defineProperty(Class, symbolMetadata, {
+			configurable: true,
+			enumerable: true,
+			value: metadata
+		});
+	}
+	if (parentClass !== void 0) metadata = parentClass[symbolMetadata];
+	metadata = create(metadata == null ? null : metadata);
+	_ = applyMemberDecs();
+	if (!hasClassDecs) defineMetadata(targetClass);
+	return {
+		e: _,
+		get c() {
+			var initializers = [];
+			return hasClassDecs && [defineMetadata(targetClass = applyDec(targetClass, [classDecs], classDecsHaveThis, targetClass.name, 5, initializers)), createRunInitializers(initializers, 1)];
+		}
+	};
+}
+let _dec, _initClass;
+_dec = injectable([inject(CliLoggerToken)]);
+let _PresentAnalyzeReportPresenterImpl;
+(class {
+	logger;
+	static {
+		({c: [_PresentAnalyzeReportPresenterImpl, _initClass]} = _apply_decs_2311(this, [_dec], []));
+	}
+	constructor(logger) {
+		this.logger = logger;
+	}
+	present(resolvedTargetPath, report) {
+		presentAnalyzeCliReport(this.logger, resolvedTargetPath, report);
+	}
+	static {
+		_initClass();
+	}
+});
+//#endregion
+export { _PresentAnalyzeReportPresenterImpl as PresentAnalyzeReportPresenterImpl };

package/dist/lib/arrange/presentation/report.presenter.mjs

@@ -0,0 +1,24 @@
+import "../domain/constants.domain.mjs";
+import path from "node:path";
+//#region src/lib/arrange/presentation/report.presenter.ts
+function printAnalyzeReport(analyzeRootDirectoryPath, analyzeReport, logger) {
+	const { out } = logger;
+	out(`Path: ${path.resolve(analyzeRootDirectoryPath)}`);
+	out(`.ts/.tsx files: ${analyzeReport.files}`);
+	out(`cn(...) call sites: ${analyzeReport.cnCallExpressions}`);
+	out(`tv(...) call sites: ${analyzeReport.tvCallExpressions}`);
+	out(`\nLong cn(...) string literals (≥18 tokens — consider splitting arguments): ${analyzeReport.longCnStringLiterals.length}`);
+	for (const findingEntry of analyzeReport.longCnStringLiterals.slice(0, 40)) out(`  ${findingEntry.file}:${findingEntry.line}  (${findingEntry.tokenCount} tokens)  ${findingEntry.preview}`);
+	if (analyzeReport.longCnStringLiterals.length > 40) out(`  … and ${analyzeReport.longCnStringLiterals.length - 40} more`);
+	out(`\nLong tv({...}) string literals in base/variants/… (≥18 tokens): ${analyzeReport.longTvStringLiterals.length}`);
+	for (const findingEntry of analyzeReport.longTvStringLiterals.slice(0, 40)) out(`  ${findingEntry.file}:${findingEntry.line}  (${findingEntry.tokenCount} tokens)  ${findingEntry.preview}`);
+	if (analyzeReport.longTvStringLiterals.length > 40) out(`  … and ${analyzeReport.longTvStringLiterals.length - 40} more`);
+	out(`\nJSX className="..." or className={'...'} (static strings, ≥18 tokens): ${analyzeReport.longJsxClassNameLiterals.length}`);
+	for (const findingEntry of analyzeReport.longJsxClassNameLiterals.slice(0, 40)) out(`  ${findingEntry.file}:${findingEntry.line}  (${findingEntry.tokenCount} tokens)  ${findingEntry.preview}`);
+	if (analyzeReport.longJsxClassNameLiterals.length > 40) out(`  … and ${analyzeReport.longJsxClassNameLiterals.length - 40} more`);
+	out(`\ncn(...) nested inside tv({...}) (prefer a string or array — preview/apply can rewrite): ${analyzeReport.cnInsideTvCalls.length}`);
+	for (const findingEntry of analyzeReport.cnInsideTvCalls.slice(0, 40)) out(`  ${findingEntry.file}:${findingEntry.line}  (${findingEntry.argCount} args)  ${findingEntry.preview}`);
+	if (analyzeReport.cnInsideTvCalls.length > 40) out(`  … and ${analyzeReport.cnInsideTvCalls.length - 40} more`);
+}
+//#endregion
+export { printAnalyzeReport };

package/dist/lib/arrange/presentation/resolve-arrange-cli-target.presenter.mjs

@@ -0,0 +1,21 @@
+import path from "node:path";
+//#region src/lib/arrange/presentation/resolve-arrange-cli-target.presenter.ts
+const PACKAGE_JSON_FILE = "package.json";
+function findNearestPackageDirectory(currentWorkingDirectory, fs) {
+	let currentDir = path.resolve(currentWorkingDirectory);
+	while (true) {
+		const packageJsonPath = path.join(currentDir, PACKAGE_JSON_FILE);
+		if (fs.existsSync(packageJsonPath)) return currentDir;
+		const parentDirectory = path.dirname(currentDir);
+		if (parentDirectory === currentDir) return;
+		currentDir = parentDirectory;
+	}
+}
+function resolveArrangeCliTargetPath(input) {
+	const explicitTargetPath = input.rawTarget ? path.isAbsolute(input.rawTarget) ? path.resolve(input.rawTarget) : path.resolve(input.currentWorkingDirectory, input.rawTarget) : void 0;
+	if (explicitTargetPath) return input.fs.canonicalPathSync(explicitTargetPath);
+	const resolvedDefaultTarget = findNearestPackageDirectory(input.currentWorkingDirectory, input.fs) ?? input.currentWorkingDirectory;
+	return input.fs.canonicalPathSync(resolvedDefaultTarget);
+}
+//#endregion
+export { resolveArrangeCliTargetPath };

package/dist/lib/config/application/use-cases/load-config.use-case.mjs

@@ -0,0 +1,17 @@
+import { appError } from "../../../core/domain/errors.domain.mjs";
+import { err, ok } from "../../../core/domain/result.model.mjs";
+import { messageFromCaughtUnknown } from "../../../core/application/utils/caught-unknown-message.util.mjs";
+//#region src/lib/config/application/use-cases/load-config.use-case.ts
+async function loadCodefastConfig(configLoader, fs, rootDir) {
+	try {
+		const { config, warnings } = await configLoader.loadConfig(fs, rootDir);
+		return ok({
+			config,
+			warnings
+		});
+	} catch (caughtError) {
+		return err(appError("INFRA_FAILURE", messageFromCaughtUnknown(caughtError), caughtError));
+	}
+}
+//#endregion
+export { loadCodefastConfig };

package/dist/lib/config/contracts/tokens.mjs

@@ -0,0 +1,5 @@
+import { token } from "@codefast/di";
+//#region src/lib/config/contracts/tokens.ts
+const ConfigLoaderPortToken = token("ConfigLoaderPort");
+//#endregion
+export { ConfigLoaderPortToken };

package/dist/lib/config/infra/config-schema.adapter.mjs

@@ -0,0 +1,25 @@
+import { z } from "zod";
+//#region src/lib/config/infra/config-schema.adapter.ts
+const hookSchema = z.custom((value) => typeof value === "function", { message: "Expected a function" });
+const mirrorConfigSchema = z.object({
+	skipPackages: z.array(z.string()).optional(),
+	pathTransformations: z.record(z.string(), z.object({ removePrefix: z.string().optional() }).strict()).optional(),
+	customExports: z.record(z.string(), z.record(z.string(), z.string())).optional(),
+	cssExports: z.record(z.string(), z.union([z.boolean(), z.object({
+		enabled: z.boolean().optional(),
+		customExports: z.record(z.string(), z.string()).optional(),
+		forceExportFiles: z.boolean().optional()
+	}).strict()])).optional()
+}).strict();
+const codefastTagConfigSchema = z.object({
+	skipPackages: z.array(z.string()).optional(),
+	onAfterWrite: hookSchema.optional()
+}).strict();
+const codefastArrangeConfigSchema = z.object({ onAfterWrite: hookSchema.optional() }).strict();
+const codefastConfigSchema = z.object({
+	mirror: mirrorConfigSchema.optional(),
+	tag: codefastTagConfigSchema.optional(),
+	arrange: codefastArrangeConfigSchema.optional()
+}).strict();
+//#endregion
+export { codefastArrangeConfigSchema, codefastConfigSchema, codefastTagConfigSchema, hookSchema, mirrorConfigSchema };

package/dist/lib/config/infra/loader.adapter.mjs

@@ -0,0 +1,84 @@
+import { codefastConfigSchema } from "./config-schema.adapter.mjs";
+import path from "node:path";
+import { ZodError } from "zod";
+import jiti from "jiti";
+//#region src/lib/config/infra/loader.adapter.ts
+const CONFIG_JS_PRIORITY = [
+	"codefast.config.mjs",
+	"codefast.config.js",
+	"codefast.config.cjs"
+];
+const CONFIG_JSON = "codefast.config.json";
+const cachedLoads = /* @__PURE__ */ new Map();
+function formatZodError(error, filePath) {
+	const formatted = error.issues.map((issue) => {
+		return `  - ${issue.path.length > 0 ? issue.path.join(".") : "<root>"}: ${issue.message}`;
+	}).join("\n");
+	return `Invalid config schema in ${path.basename(filePath)}:\n${formatted}`;
+}
+function parseLoadedConfig(raw, filePath) {
+	try {
+		return codefastConfigSchema.parse(raw);
+	} catch (caughtError) {
+		if (caughtError instanceof ZodError) throw new Error(formatZodError(caughtError, filePath));
+		throw caughtError;
+	}
+}
+function listConfigCandidates(startDir, fs) {
+	const candidates = [];
+	let current = path.resolve(startDir);
+	while (true) {
+		for (const name of CONFIG_JS_PRIORITY) {
+			const candidate = path.join(current, name);
+			if (fs.existsSync(candidate)) candidates.push(candidate);
+		}
+		const jsonCandidate = path.join(current, CONFIG_JSON);
+		if (fs.existsSync(jsonCandidate)) candidates.push(jsonCandidate);
+		const parent = path.dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+	return candidates;
+}
+async function readConfigFromPath(filePath, fs, jitiBaseDir) {
+	if (path.extname(filePath) === ".json") {
+		const content = await fs.readFile(filePath, "utf8");
+		return parseLoadedConfig(JSON.parse(content), filePath);
+	}
+	const moduleConfig = jiti(jitiBaseDir, {
+		interopDefault: true,
+		moduleCache: false
+	})(filePath);
+	return parseLoadedConfig(typeof moduleConfig === "object" && moduleConfig !== null && "default" in moduleConfig ? moduleConfig.default : moduleConfig, filePath);
+}
+async function loadOnce(fs, startDir) {
+	const warnings = [];
+	const configPaths = listConfigCandidates(startDir, fs);
+	if (configPaths.length === 0) return {
+		config: {},
+		warnings
+	};
+	const configPath = configPaths[0];
+	if (configPath === void 0) return {
+		config: {},
+		warnings
+	};
+	return {
+		config: await readConfigFromPath(configPath, fs, startDir),
+		warnings,
+		configPath
+	};
+}
+async function loadConfig(fs, startDir) {
+	const cacheKey = path.resolve(startDir);
+	if (!cachedLoads.has(cacheKey)) cachedLoads.set(cacheKey, loadOnce(fs, cacheKey));
+	const cached = cachedLoads.get(cacheKey);
+	if (cached === void 0) throw new Error("config loader cache invariant violated");
+	return cached;
+}
+function resetConfigLoaderCacheForTests() {
+	cachedLoads.clear();
+}
+const configLoaderAdapter = { loadConfig };
+//#endregion
+export { configLoaderAdapter, loadConfig, resetConfigLoaderCacheForTests };