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

package/dist/commands/arrange.mjs

@@ -1,107 +0,0 @@
-import { messageFromCaughtUnknown } from "../lib/infra/caught-unknown-message.mjs";
-import { loadConfig } from "../lib/config/infra/loader.mjs";
-import "../lib/config/index.mjs";
-import { printConfigSchemaWarnings } from "../lib/infra/config-reporter.mjs";
-import { DEFAULT_ARRANGE_TARGET } from "../lib/arrange/domain/constants.mjs";
-import { analyzeDirectory } from "../lib/arrange/application/analyze.mjs";
-import { printAnalyzeReport } from "../lib/arrange/presentation/report.mjs";
-import { suggestCnGroups, summarizeGroupBucketLabels } from "../lib/arrange/domain/grouping.mjs";
-import { formatArray, formatCnCall } from "../lib/arrange/presentation/formatters.mjs";
-import { runArrangeSync } from "../lib/arrange/application/run-target.mjs";
-import { createNodeCliFs, createNodeCliLogger } from "../lib/infra/node-io.mjs";
-import "../lib/arrange/index.mjs";
-import { findRepoRoot } from "../lib/infra/workspace/repo-root.mjs";
-import process from "node:process";
-import path from "node:path";
-import { Option } from "commander";
-//#region src/commands/arrange.ts
-/** Commander attribute `withClassName` (second long flag `--with-class-name`). */
-function createWithClassNameOption() {
-	return new Option("--with-classname, --with-class-name", "Append className as final cn() argument").default(false);
-}
-function defaultTargetPath() {
-	return path.resolve(process.cwd(), DEFAULT_ARRANGE_TARGET);
-}
-function checkTargetExists(resolved, fs, logger) {
-	if (!fs.existsSync(resolved)) {
-		logger.err(`Not found: ${resolved}`);
-		process.exitCode = 1;
-		return false;
-	}
-	return true;
-}
-async function loadArrangeCommandConfig(fs, logger, rootDir) {
-	try {
-		const { config, warnings } = await loadConfig(fs, rootDir);
-		printConfigSchemaWarnings(logger, warnings);
-		return { arrangeConfig: config.arrange ?? {} };
-	} catch (caughtConfigError) {
-		logger.err(messageFromCaughtUnknown(caughtConfigError));
-		process.exitCode = 1;
-		return;
-	}
-}
-function registerArrangeCommand(program) {
-	const arrange = program.command("arrange").description("Analyze and regroup Tailwind classes in cn() / tv() calls (Tailwind v4)");
-	arrange.command("analyze").description("Report long strings, nested cn in tv(), and related findings").argument("[target]", "Directory or file (default: packages/ui/src/components)").action(async (target) => {
-		const fs = createNodeCliFs();
-		const logger = createNodeCliLogger();
-		const resolved = target ? path.resolve(target) : defaultTargetPath();
-		if (!checkTargetExists(resolved, fs, logger)) return;
-		if (!await loadArrangeCommandConfig(fs, logger, findRepoRoot(fs))) return;
-		printAnalyzeReport(resolved, analyzeDirectory(resolved, fs), logger);
-	});
-	arrange.command("preview").description("Dry-run: print suggested replacements without writing files").argument("[target]", "Directory or file (default: packages/ui/src/components)").addOption(createWithClassNameOption()).option("--cn-import <spec>", "Override module specifier when adding cn import").action(async (target, opts) => {
-		const fs = createNodeCliFs();
-		const logger = createNodeCliLogger();
-		const resolved = target ? path.resolve(target) : defaultTargetPath();
-		if (!checkTargetExists(resolved, fs, logger)) return;
-		const rootDir = findRepoRoot(fs);
-		const loaded = await loadArrangeCommandConfig(fs, logger, rootDir);
-		if (!loaded) return;
-		process.exitCode = await runArrangeSync({
-			rootDir,
-			config: loaded.arrangeConfig,
-			targetPath: resolved,
-			write: false,
-			withClassName: opts.withClassName,
-			cnImport: opts.cnImport,
-			fs,
-			logger
-		});
-	});
-	arrange.command("apply").description("Apply grouping and cn-in-tv unwrap edits to files").argument("[target]", "Directory or file (default: packages/ui/src/components)").addOption(createWithClassNameOption()).option("--cn-import <spec>", "Override module specifier when adding cn import").action(async (target, opts) => {
-		const fs = createNodeCliFs();
-		const logger = createNodeCliLogger();
-		const resolved = target ? path.resolve(target) : defaultTargetPath();
-		if (!checkTargetExists(resolved, fs, logger)) return;
-		const rootDir = findRepoRoot(fs);
-		const loaded = await loadArrangeCommandConfig(fs, logger, rootDir);
-		if (!loaded) return;
-		process.exitCode = await runArrangeSync({
-			rootDir,
-			config: loaded.arrangeConfig,
-			targetPath: resolved,
-			write: true,
-			withClassName: opts.withClassName,
-			cnImport: opts.cnImport,
-			fs,
-			logger
-		});
-	});
-	arrange.command("group").description("Try grouping on a pasted class string (stdout: cn(...) or tv array with --tv)").argument("[tokens...]", "Class tokens (quote a single string if it contains spaces)").option("--tv", "Emit tv()-style array instead of cn() call", false).addOption(createWithClassNameOption()).action((tokens, opts) => {
-		const inlineClasses = tokens.join(" ").trim();
-		if (!inlineClasses) {
-			process.stderr.write("Pass a class string. Example: codefast arrange group \"flex gap-2 text-sm rounded-md\"\n");
-			process.exitCode = 1;
-			return;
-		}
-		const groups = suggestCnGroups(inlineClasses);
-		const result = opts.tv ? formatArray(groups) : formatCnCall(groups, { trailingClassName: !!opts.withClassName });
-		process.stdout.write(`${result}\n`);
-		const bucketSummary = summarizeGroupBucketLabels(groups);
-		process.stdout.write(`\n// Buckets: ${JSON.stringify(bucketSummary)}\n`);
-	});
-}
-//#endregion
-export { registerArrangeCommand };

package/dist/commands/mirror.mjs

@@ -1,66 +0,0 @@
-import { messageFromCaughtUnknown } from "../lib/infra/caught-unknown-message.mjs";
-import { loadConfig } from "../lib/config/infra/loader.mjs";
-import "../lib/config/index.mjs";
-import { printConfigSchemaWarnings } from "../lib/infra/config-reporter.mjs";
-import { createNodeCliFs, createNodeCliLogger } from "../lib/infra/node-io.mjs";
-import { findRepoRoot } from "../lib/infra/workspace/repo-root.mjs";
-import { runMirrorSync } from "../lib/mirror/application/sync.mjs";
-import "../lib/mirror/index.mjs";
-import process from "node:process";
-import { realpathSync } from "node:fs";
-import path from "node:path";
-//#region src/commands/mirror.ts
-function tryRealpath(entryPath) {
-	try {
-		return realpathSync.native(entryPath);
-	} catch {
-		return path.resolve(entryPath);
-	}
-}
-function normalizePath(relPath) {
-	return relPath.split(path.sep).join("/").replace(/\\/g, "/");
-}
-function packageArgToRelative(rootDir, arg) {
-	if (!arg) return;
-	const rootReal = tryRealpath(path.resolve(rootDir));
-	const cwdReal = tryRealpath(process.cwd());
-	const targetReal = tryRealpath(path.isAbsolute(arg) ? path.resolve(arg) : path.resolve(cwdReal, arg));
-	const normalized = normalizePath(path.relative(rootReal, targetReal));
-	if (normalized.startsWith("..") || path.isAbsolute(normalized) || normalized === "" || normalized === ".") throw new Error(`Package path must be a subdirectory under monorepo root: ${rootDir}`);
-	return normalized;
-}
-function registerMirrorCommand(program) {
-	program.command("mirror").description("Keep package manifests aligned with what you ship").command("sync").description("Write package.json exports from dist/ for workspace packages").argument("[package]", "Optional package path relative to repo root (e.g. packages/ui)").option("-v, --verbose", "Print extra diagnostics", false).action(async function(pkg, options) {
-		const globals = this.optsWithGlobals();
-		const fs = createNodeCliFs();
-		const logger = createNodeCliLogger();
-		const rootDir = findRepoRoot(fs);
-		let packageFilter;
-		try {
-			packageFilter = packageArgToRelative(rootDir, pkg);
-		} catch (caughtPathError) {
-			this.error(messageFromCaughtUnknown(caughtPathError));
-			return;
-		}
-		let mirrorConfig = {};
-		try {
-			const { config, warnings } = await loadConfig(fs, rootDir);
-			printConfigSchemaWarnings(logger, warnings);
-			mirrorConfig = config.mirror ?? {};
-		} catch (caughtConfigError) {
-			this.error(messageFromCaughtUnknown(caughtConfigError));
-			return;
-		}
-		process.exitCode = await runMirrorSync({
-			rootDir,
-			config: mirrorConfig,
-			verbose: options.verbose,
-			noColor: globals.color === false,
-			packageFilter,
-			fs,
-			logger
-		});
-	});
-}
-//#endregion
-export { packageArgToRelative, registerMirrorCommand };

package/dist/commands/tag.mjs

@@ -1,58 +0,0 @@
-import { messageFromCaughtUnknown } from "../lib/infra/caught-unknown-message.mjs";
-import { loadConfig } from "../lib/config/infra/loader.mjs";
-import "../lib/config/index.mjs";
-import { printConfigSchemaWarnings } from "../lib/infra/config-reporter.mjs";
-import { createNodeCliFs, createNodeCliLogger } from "../lib/infra/node-io.mjs";
-import { findRepoRoot } from "../lib/infra/workspace/repo-root.mjs";
-import { runTagSync } from "../lib/tag/application/engine.mjs";
-import { createTagProgressListener, formatSummary, formatTargetTable, formatWarningsAndErrors } from "../lib/tag/presentation/tag-presenter.mjs";
-import "../lib/tag/index.mjs";
-import process from "node:process";
-import path from "node:path";
-//#region src/commands/tag.ts
-function resolveTagRootDir(fs, logger) {
-	try {
-		return findRepoRoot(fs);
-	} catch (caughtRepoRootError) {
-		logger.out(`[tag] workspace root auto-detection failed (${messageFromCaughtUnknown(caughtRepoRootError)}), using cwd=${process.cwd()}`);
-		return process.cwd();
-	}
-}
-function registerTagCommand(program) {
-	program.command("tag").alias("annotate").description("Add @since <version> JSDoc tags to exported declarations").argument("[target]", "Directory or file to annotate (default: auto-discover workspace packages)").option("--dry-run", "Show summary without writing files", false).action(async (target, options) => {
-		const fs = createNodeCliFs();
-		const logger = createNodeCliLogger();
-		const rootDir = resolveTagRootDir(fs, logger);
-		let tagConfig = {};
-		try {
-			const { config, warnings } = await loadConfig(fs, rootDir);
-			printConfigSchemaWarnings(logger, warnings);
-			tagConfig = config.tag ?? {};
-		} catch (caughtConfigError) {
-			logger.err(messageFromCaughtUnknown(caughtConfigError));
-			process.exitCode = 1;
-			return;
-		}
-		const tagResult = await runTagSync({
-			rootDir,
-			config: tagConfig,
-			skipPackages: tagConfig.skipPackages,
-			targetPath: target ? path.resolve(target) : void 0,
-			write: !options.dryRun,
-			fs,
-			listener: createTagProgressListener((line) => logger.out(line))
-		});
-		logger.out(formatTargetTable(tagResult.selectedTargets, rootDir));
-		if (tagResult.selectedTargets.length === 0) {
-			logger.err("No packages found in workspace. Check your pnpm-workspace.yaml or provide an explicit target path.");
-			process.exitCode = 1;
-			return;
-		}
-		const warningsAndErrorsSection = formatWarningsAndErrors(tagResult);
-		if (warningsAndErrorsSection) logger.err(warningsAndErrorsSection);
-		logger.out(formatSummary(tagResult));
-		process.exitCode = tagResult.targetResults.some((targetResult) => targetResult.runError !== null) || tagResult.hookError ? 1 : 0;
-	});
-}
-//#endregion
-export { registerTagCommand };

package/dist/lib/arrange/application/analyze.mjs

@@ -1,92 +0,0 @@
-import "../domain/constants.mjs";
-import { tokenizeClassString } from "../domain/tokenizer.mjs";
-import { forEachStringLiteralInClassExpression } from "../domain/ast/collectors-cn.mjs";
-import { jsxClassNameStaticLiteral } from "../domain/ast/collectors-jsx.mjs";
-import { buildKnownCnTvBindings, isCnOrTvIdentifier, lineOf } from "../domain/ast/ast-helpers.mjs";
-import { collectCnCallsInsideTv, traverseTvObject } from "../domain/ast/collectors-tv.mjs";
-import { walkTsxFiles } from "../infra/walk.mjs";
-import ts from "typescript";
-//#region src/lib/arrange/application/analyze.ts
-function analyzeCnCall(sf, call, report) {
-	for (const arg of call.arguments) forEachStringLiteralInClassExpression(arg, (lit) => {
-		const text = lit.text;
-		const tokenCount = tokenizeClassString(text).length;
-		if (tokenCount >= 18) report.longCnStringLiterals.push({
-			file: sf.fileName,
-			line: lineOf(sf, lit),
-			tokenCount,
-			preview: text.length > 72 ? `${text.slice(0, 72)}…` : text
-		});
-	});
-}
-function visitCallExpressionForArrangeAnalyze(callExpression, sf, sourceText, knownBindings, report) {
-	if (isCnOrTvIdentifier(callExpression.expression, "cn", knownBindings)) {
-		report.cnCallExpressions++;
-		analyzeCnCall(sf, callExpression, report);
-		return;
-	}
-	if (!isCnOrTvIdentifier(callExpression.expression, "tv", knownBindings)) return;
-	report.tvCallExpressions++;
-	const arg0 = callExpression.arguments[0];
-	if (!arg0 || !ts.isObjectLiteralExpression(arg0)) return;
-	for (const nestedCn of collectCnCallsInsideTv(sf, arg0, knownBindings, 0)) {
-		const src = sourceText.slice(nestedCn.getStart(sf), nestedCn.getEnd());
-		const preview = src.length > 72 ? `${src.slice(0, 72)}…` : src;
-		report.cnInsideTvCalls.push({
-			file: sf.fileName,
-			line: lineOf(sf, nestedCn),
-			argCount: nestedCn.arguments.length,
-			preview
-		});
-	}
-	traverseTvObject(sf, arg0, (classLiteral) => {
-		const text = classLiteral.text;
-		const tokenCount = tokenizeClassString(text).length;
-		if (tokenCount >= 18) report.longTvStringLiterals.push({
-			file: sf.fileName,
-			line: lineOf(sf, classLiteral),
-			tokenCount,
-			preview: text.length > 72 ? `${text.slice(0, 72)}…` : text
-		});
-	}, 0, knownBindings);
-}
-function visitJsxAttributeForArrangeAnalyze(jsxClassAttribute, sf, filePath, report) {
-	if (!filePath.endsWith(".tsx")) return;
-	const parsed = jsxClassNameStaticLiteral(jsxClassAttribute);
-	if (!parsed) return;
-	const text = parsed.lit.text;
-	const tokenCount = tokenizeClassString(text).length;
-	if (tokenCount >= 18) report.longJsxClassNameLiterals.push({
-		file: sf.fileName,
-		line: lineOf(sf, parsed.lit),
-		tokenCount,
-		preview: text.length > 72 ? `${text.slice(0, 72)}…` : text
-	});
-}
-function analyzeDirectory(analyzeRootPath, fs) {
-	const report = {
-		files: 0,
-		cnCallExpressions: 0,
-		tvCallExpressions: 0,
-		cnInsideTvCalls: [],
-		longCnStringLiterals: [],
-		longTvStringLiterals: [],
-		longJsxClassNameLiterals: []
-	};
-	const files = fs.statSync(analyzeRootPath).isDirectory() ? walkTsxFiles(analyzeRootPath, fs) : [analyzeRootPath];
-	for (const filePath of files) {
-		const sourceText = fs.readFileSync(filePath, "utf8");
-		const sf = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
-		report.files++;
-		const knownBindings = buildKnownCnTvBindings(sf);
-		const visitTypeScriptSubtree = (tsNode) => {
-			if (ts.isCallExpression(tsNode)) visitCallExpressionForArrangeAnalyze(tsNode, sf, sourceText, knownBindings, report);
-			if (ts.isJsxAttribute(tsNode)) visitJsxAttributeForArrangeAnalyze(tsNode, sf, filePath, report);
-			ts.forEachChild(tsNode, visitTypeScriptSubtree);
-		};
-		visitTypeScriptSubtree(sf);
-	}
-	return report;
-}
-//#endregion
-export { analyzeDirectory };

package/dist/lib/arrange/application/group-file.mjs

@@ -1,113 +0,0 @@
-import { applyEditsDescending, buildKnownCnTvBindings, lineOf, unwrapCnInsideTvCallReplacement } from "../domain/ast/ast-helpers.mjs";
-import { listAllCnCallsInsideTvInSourceFile } from "../domain/ast/collectors-tv.mjs";
-import { collectGroupTargets, planGroupEditForTarget, targetReplaceStart } from "../domain/ast/targets.mjs";
-import { ensureCnImport } from "../domain/imports.mjs";
-import ts from "typescript";
-//#region src/lib/arrange/application/group-file.ts
-function printGroupFilePreview(logger, args) {
-	const { out } = logger;
-	const { filePath, reportTotal, cnInTvNoReplacement, cnInTvCalls, unwrapReplacementByCall, sourceText, sf, unwrapEdits, plannedGroupEdits } = args;
-	let header = `\n── ${filePath} (${reportTotal} site(s)`;
-	if (cnInTvNoReplacement > 0) header += `; plus ${cnInTvNoReplacement} cn() inside tv left unchanged (0 args)`;
-	header += `) ──`;
-	out(header);
-	for (const call of cnInTvCalls) {
-		const replacement = unwrapReplacementByCall.get(call);
-		if (replacement === void 0) {
-			out(`  Line ${lineOf(sf, call)} [tv ⊃ cn]: cn(...) has no arguments — skipped`);
-			continue;
-		}
-		const start = call.getStart(sf);
-		const end = call.getEnd();
-		if (sourceText.slice(start, end) === replacement) continue;
-		out(`  Line ${lineOf(sf, call)} [tv ⊃ cn → string/array]:`);
-		out(`  ${replacement.split("\n").join("\n  ")}`);
-	}
-	if (unwrapEdits.length > 0 && plannedGroupEdits.length > 0) out("  ([cn] / [tv] / [JSX className] lines below reflect content after unwrap of cn inside tv.)");
-	for (const plan of plannedGroupEdits) {
-		out(`  Line ${lineOf(plan.lineSf, plan.reportNode)} [${plan.label}]:`);
-		out(`  ${plan.replacement.split("\n").join("\n  ")}`);
-		out(`  // Buckets: ${JSON.stringify(plan.bucketSummary)}`);
-	}
-}
-function applyGroupFileWrites(filePath, options, fs, logger, unwrapEdits, textAfterUnwrap, plannedGroupEdits, cnInTvNoReplacement) {
-	const groupEdits = plannedGroupEdits.map((plannedEdit) => ({
-		start: plannedEdit.start,
-		end: plannedEdit.end,
-		replacement: plannedEdit.replacement,
-		jsxCn: plannedEdit.jsxCn
-	}));
-	const touchedJsxCn = groupEdits.some((groupEdit) => groupEdit.jsxCn);
-	let newText = groupEdits.length > 0 ? applyEditsDescending(textAfterUnwrap, groupEdits) : textAfterUnwrap;
-	const changed = unwrapEdits.length + groupEdits.length;
-	if (changed > 0) {
-		if (touchedJsxCn) newText = ensureCnImport(newText, filePath, options.cnImport);
-		fs.writeFileSync(filePath, newText, "utf8");
-	}
-	return {
-		filePath,
-		totalFound: changed + cnInTvNoReplacement,
-		changed
-	};
-}
-function groupFile(filePath, options, fs, logger) {
-	const sourceText = fs.readFileSync(filePath, "utf8");
-	const sf = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
-	const cnInTvCalls = listAllCnCallsInsideTvInSourceFile(sf, buildKnownCnTvBindings(sf));
-	const unwrapPlans = cnInTvCalls.map((call) => {
-		const replacement = unwrapCnInsideTvCallReplacement(call, sourceText, sf);
-		if (replacement === void 0) return;
-		return {
-			start: call.getStart(sf),
-			end: call.getEnd(),
-			replacement,
-			call
-		};
-	}).filter((planOrUndefined) => planOrUndefined !== void 0);
-	const unwrapReplacementByCall = new Map(unwrapPlans.map((unwrapPlan) => [unwrapPlan.call, unwrapPlan.replacement]));
-	const unwrapEdits = unwrapPlans.filter((unwrapPlan) => sourceText.slice(unwrapPlan.start, unwrapPlan.end) !== unwrapPlan.replacement);
-	const textAfterUnwrap = unwrapEdits.length > 0 ? applyEditsDescending(sourceText, unwrapEdits) : sourceText;
-	const groupTargets = collectGroupTargets(ts.createSourceFile(filePath, textAfterUnwrap, ts.ScriptTarget.Latest, true, filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS), filePath);
-	const cnInTvNoReplacement = cnInTvCalls.length - unwrapPlans.length;
-	const sortedTargets = [...groupTargets].sort((leftTarget, rightTarget) => targetReplaceStart(rightTarget) - targetReplaceStart(leftTarget));
-	const plannedGroupEdits = [];
-	for (const groupTarget of sortedTargets) {
-		const plan = planGroupEditForTarget(groupTarget, textAfterUnwrap, options.withClassName);
-		if (plan === void 0) continue;
-		if (textAfterUnwrap.slice(plan.start, plan.end) === plan.replacement) continue;
-		plannedGroupEdits.push(plan);
-	}
-	const editSitesCount = unwrapEdits.length + plannedGroupEdits.length;
-	const reportTotal = editSitesCount + cnInTvNoReplacement;
-	if (cnInTvCalls.length === 0 && groupTargets.length === 0) return {
-		filePath,
-		totalFound: 0,
-		changed: 0
-	};
-	if (!options.write) {
-		if (editSitesCount === 0 && cnInTvNoReplacement === 0) return {
-			filePath,
-			totalFound: 0,
-			changed: 0
-		};
-		printGroupFilePreview(logger, {
-			filePath,
-			reportTotal,
-			cnInTvNoReplacement,
-			cnInTvCalls,
-			unwrapReplacementByCall,
-			sourceText,
-			sf,
-			unwrapEdits,
-			plannedGroupEdits
-		});
-		return {
-			filePath,
-			totalFound: reportTotal,
-			changed: 0
-		};
-	}
-	return applyGroupFileWrites(filePath, options, fs, logger, unwrapEdits, textAfterUnwrap, plannedGroupEdits, cnInTvNoReplacement);
-}
-//#endregion
-export { groupFile };

package/dist/lib/arrange/application/run-target.mjs

@@ -1,65 +0,0 @@
-import { messageFromCaughtUnknown } from "../../infra/caught-unknown-message.mjs";
-import { walkTsxFiles } from "../infra/walk.mjs";
-import { groupFile } from "./group-file.mjs";
-import { ArrangeError, ArrangeErrorCode } from "../domain/errors.mjs";
-import path from "node:path";
-//#region src/lib/arrange/application/run-target.ts
-function runOnTarget(target, options, fs, logger) {
-	const { out } = logger;
-	if (!fs.existsSync(target)) throw new ArrangeError(ArrangeErrorCode.TARGET_NOT_FOUND, `Not found: ${target}`);
-	const filePaths = fs.statSync(target).isDirectory() ? walkTsxFiles(target, fs) : [target];
-	const modifiedFiles = [];
-	let totalFound = 0;
-	let totalChanged = 0;
-	for (const filePath of filePaths) {
-		const result = groupFile(filePath, options, fs, logger);
-		totalFound += result.totalFound;
-		totalChanged += result.changed;
-		if (result.changed > 0) modifiedFiles.push(result.filePath);
-	}
-	out(`\nTotal: ${filePaths.length} file(s), ${totalFound} site(s) (cn/tv/JSX className) to review.`);
-	if (options.write) out(`Applied: ${totalChanged} site(s) updated.`);
-	else out(`(Run "apply" to write changes, or "pnpm cli:arrange-apply" / "pnpm exec codefast arrange apply")`);
-	if (options.write ? totalChanged > 0 : totalFound > 0) out("Note: class order may change across concern groups — smoke-test the UI if you rely on cascade order.");
-	return {
-		filePaths,
-		modifiedFiles,
-		totalFound,
-		totalChanged
-	};
-}
-async function runArrangeOnAfterWriteHook(logger, hook, modifiedFiles) {
-	if (!hook || modifiedFiles.length === 0) return;
-	try {
-		await hook({ files: modifiedFiles });
-	} catch (caughtHookError) {
-		logger.err(`[arrange] onAfterWrite hook failed: ${messageFromCaughtUnknown(caughtHookError)}`);
-	}
-}
-/**
-* CLI entry: run arrange preview/apply using config injected by the command layer.
-* @returns Process exit code (`0`, or `1` when the target path is missing).
-*/
-async function runArrangeSync(opts) {
-	opts.rootDir;
-	const { fs, logger } = opts;
-	const resolvedTarget = path.resolve(opts.targetPath);
-	let result;
-	try {
-		result = runOnTarget(resolvedTarget, {
-			write: opts.write,
-			withClassName: !!opts.withClassName,
-			cnImport: opts.cnImport
-		}, fs, logger);
-	} catch (caughtError) {
-		if (caughtError instanceof ArrangeError && caughtError.code === ArrangeErrorCode.TARGET_NOT_FOUND) {
-			logger.err(caughtError.message);
-			return 1;
-		}
-		throw caughtError;
-	}
-	if (opts.write && result.modifiedFiles.length > 0) await runArrangeOnAfterWriteHook(logger, opts.config?.onAfterWrite, result.modifiedFiles);
-	return 0;
-}
-//#endregion
-export { runArrangeSync, runOnTarget };

package/dist/lib/arrange/domain/ast/ast-helpers.mjs

@@ -1,115 +0,0 @@
-import { EMPTY_CN_TV_BINDINGS } from "../constants.mjs";
-import ts from "typescript";
-//#region src/lib/arrange/domain/ast/ast-helpers.ts
-/** Known module specifiers that export `cn` / `tv`. */
-const KNOWN_CN_TV_MODULES = new Set([
-	"@codefast/tailwind-variants",
-	"clsx",
-	"class-variance-authority",
-	"tailwind-variants",
-	"#lib/utils",
-	"~/lib/utils",
-	"@/lib/utils"
-]);
-/**
-* True for typical shadcn-style re-exports: `./utils`, `@/lib/utils`, `…/utils/…`,
-* or a dedicated `cn.ts` / `cn.tsx` module.
-*/
-function moduleLooksLikeCnTvReexport(moduleSpecifier) {
-	const norm = moduleSpecifier.replace(/\\/g, "/");
-	if (/(?:^|[./])utils(?:\/|$)/.test(norm)) return true;
-	if (/\/utils\//.test(norm) || /\/utils$/.test(norm)) return true;
-	if (/(?:^|\/)cn\.tsx?$/.test(norm)) return true;
-	return false;
-}
-/**
-* Build a set of local binding names that are imported from a known cn/tv
-* module in `sf`.
-*/
-function buildKnownCnTvBindings(sf) {
-	const bindings = /* @__PURE__ */ new Set();
-	for (const stmt of sf.statements) {
-		if (!ts.isImportDeclaration(stmt) || !stmt.importClause) continue;
-		if (stmt.importClause.isTypeOnly) continue;
-		const spec = stmt.moduleSpecifier;
-		if (!ts.isStringLiteral(spec)) continue;
-		const moduleSpecifier = spec.text;
-		if (!KNOWN_CN_TV_MODULES.has(moduleSpecifier) && !moduleLooksLikeCnTvReexport(moduleSpecifier)) continue;
-		const clause = stmt.importClause;
-		if (clause.name) bindings.add(clause.name.text);
-		if (!clause.namedBindings) continue;
-		if (ts.isNamedImports(clause.namedBindings)) {
-			for (const namedImport of clause.namedBindings.elements) bindings.add(namedImport.name.text);
-			continue;
-		}
-		bindings.add(clause.namedBindings.name.text);
-	}
-	return bindings;
-}
-/**
-* Returns true when `expr` is an identifier whose name matches `name` AND
-* that name is listed in `knownBindings` from a recognized import.
-*/
-function isCnOrTvIdentifier(expr, name, knownBindings = EMPTY_CN_TV_BINDINGS) {
-	if (knownBindings.size === 0) return false;
-	if (ts.isIdentifier(expr) && expr.text === name) return knownBindings.has(expr.text);
-	if (ts.isPropertyAccessExpression(expr) && expr.name.text === name) return ts.isIdentifier(expr.expression) && knownBindings.has(expr.expression.text);
-	return false;
-}
-function propertyAssignmentNameText(prop) {
-	if (ts.isIdentifier(prop.name)) return prop.name.text;
-	if (ts.isStringLiteral(prop.name)) return prop.name.text;
-}
-function lineOf(sf, tsNode) {
-	return sf.getLineAndCharacterOfPosition(tsNode.getStart(sf)).line + 1;
-}
-/**
-* Returns only the leading whitespace (tabs / spaces) of the line containing
-* `pos`.
-*/
-function indentOfLineContaining(source, pos) {
-	const searchPos = Math.max(0, Math.min(pos, source.length));
-	const prevLineBreak = Math.max(source.lastIndexOf("\n", searchPos - 1), source.lastIndexOf("\r", searchPos - 1));
-	const lineStart = prevLineBreak === -1 ? 0 : prevLineBreak + 1;
-	let lineEnd = source.length;
-	for (let i = lineStart; i < source.length; i++) {
-		const ch = source[i];
-		if (ch === "\n" || ch === "\r") {
-			lineEnd = i;
-			break;
-		}
-	}
-	const line = source.slice(lineStart, lineEnd);
-	return /^[\t ]*/.exec(line)?.[0] ?? "";
-}
-function applyEditsDescending(sourceText, edits) {
-	const sorted = [...edits].sort((editA, editB) => editB.start - editA.start);
-	let out = sourceText;
-	for (const edit of sorted) out = out.slice(0, edit.start) + edit.replacement + out.slice(edit.end);
-	return out;
-}
-/**
-* Replace `cn(...)` nested in `tv({...})` with a plain string (one arg) or a string
-* array (multiple args). Returns undefined when there are zero arguments.
-*/
-function unwrapCnInsideTvCallReplacement(call, sourceText, sf) {
-	const args = call.arguments;
-	if (args.length === 0) return;
-	const baseIndent = indentOfLineContaining(sourceText, call.getStart(sf));
-	const innerIndent = `${baseIndent}  `;
-	if (args.length === 1) {
-		const firstArg = args[0];
-		return sourceText.slice(firstArg.getStart(sf), firstArg.getEnd());
-	}
-	const lines = ["["];
-	for (let i = 0; i < args.length; i++) {
-		const arg = args[i];
-		const piece = sourceText.slice(arg.getStart(sf), arg.getEnd());
-		const comma = i < args.length - 1 || args.length > 1 ? "," : "";
-		lines.push(`${innerIndent}${piece}${comma}`);
-	}
-	lines.push(`${baseIndent}]`);
-	return lines.join("\n");
-}
-//#endregion
-export { KNOWN_CN_TV_MODULES, applyEditsDescending, buildKnownCnTvBindings, indentOfLineContaining, isCnOrTvIdentifier, lineOf, moduleLooksLikeCnTvReexport, propertyAssignmentNameText, unwrapCnInsideTvCallReplacement };