@codefast/cli 0.3.7-canary.0 → 0.3.13-canary.0

package/dist/imports-DSVq1xhB.mjs

@@ -0,0 +1,54 @@
+import ts from "typescript";
+//#region src/lib/arrange/domain/imports.ts
+function sourceFileImportsCn(sf) {
+	for (const statement of sf.statements) {
+		if (!ts.isImportDeclaration(statement) || !statement.importClause) continue;
+		const clause = statement.importClause;
+		if (clause.name?.text === "cn") return true;
+		if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {
+			for (const importedBinding of clause.namedBindings.elements) if (importedBinding.name.text === "cn") return true;
+		}
+	}
+	return false;
+}
+/**
+* Resolve the module specifier used when injecting a `cn` import into a file.
+*/
+function cnModuleSpecifierForFile(filePath, override) {
+	if (override) return override;
+	return "@codefast/tailwind-variants";
+}
+function findImportDeclarationFromModule(sf, moduleSpecifier) {
+	for (const statement of sf.statements) {
+		if (!ts.isImportDeclaration(statement)) continue;
+		const spec = statement.moduleSpecifier;
+		if (ts.isStringLiteral(spec) && spec.text === moduleSpecifier) return statement;
+	}
+}
+function ensureCnImport(sourceText, filePath, cnImportOverride) {
+	const sf = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+	if (sourceFileImportsCn(sf)) return sourceText;
+	const moduleSpecifier = cnModuleSpecifierForFile(filePath, cnImportOverride);
+	const decl = findImportDeclarationFromModule(sf, moduleSpecifier);
+	if (decl?.importClause && !decl.importClause.isTypeOnly && decl.importClause.namedBindings && ts.isNamedImports(decl.importClause.namedBindings)) {
+		const elements = decl.importClause.namedBindings.elements;
+		if (elements.length > 0) {
+			const pos = elements[0].getStart(sf);
+			return `${sourceText.slice(0, pos)}cn, ${sourceText.slice(pos)}`;
+		}
+	}
+	const importLine = `import { cn } from "${moduleSpecifier}";`;
+	let firstImport = -1;
+	for (const statement of sf.statements) if (ts.isImportDeclaration(statement)) {
+		firstImport = statement.getStart(sf);
+		break;
+	}
+	const useClient = /^["']use client["'];?\s*\r?\n/.exec(sourceText);
+	let insertAt;
+	if (useClient) insertAt = useClient[0].length;
+	else if (firstImport !== -1) insertAt = firstImport;
+	else insertAt = 0;
+	return `${sourceText.slice(0, insertAt)}${importLine}\n${sourceText.slice(insertAt)}`;
+}
+//#endregion
+export { ensureCnImport as n, cnModuleSpecifierForFile as t };

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

@@ -0,0 +1,2 @@
+import { t as analyzeDirectory } from "../../../analyze-DvtJ3j9m.mjs";
+export { analyzeDirectory };

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

@@ -0,0 +1,171 @@
+import { t as analyzeDirectory } from "../../../analyze-DvtJ3j9m.mjs";
+import { t as printAnalyzeReport } from "../../../report-DYxvw34T.mjs";
+import { n as createNodeCliLogger, t as createNodeCliFs } from "../../../node-io-DFRbHO6m.mjs";
+import "../../../arrange-BqP2DI3w.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+//#region src/lib/arrange/application/analyze.test.ts
+const arrangeFs = createNodeCliFs();
+const arrangeLogger = createNodeCliLogger();
+function captureStdout(fn) {
+	const chunks = [];
+	const spy = jest.spyOn(process.stdout, "write").mockImplementation((chunk) => {
+		chunks.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf8"));
+		return true;
+	});
+	try {
+		fn();
+	} finally {
+		spy.mockRestore();
+	}
+	return chunks.join("");
+}
+describe("analyzeDirectory + printAnalyzeReport", () => {
+	it("collects long cn / tv / JSX literals and nested cn in tv", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-analyze-"));
+		const long = "peer flex size-4 shrink-0 items-center justify-center rounded-sm border border-input text-primary-foreground shadow-xs outline-hidden transition hover:not-disabled:not-aria-checked:border-ring/60 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:opacity-50";
+		const source = `import { cn, tv } from "@codefast/tailwind-variants";
+
+cn("${long}");
+export const styles = tv({ base: "${long}" });
+export function X() { return <div className={"${long}"} />; }
+export const nested = tv({ base: cn("x", "${long}") });
+`;
+		try {
+			fs.writeFileSync(path.join(dir, "Report.tsx"), source, "utf8");
+			const report = analyzeDirectory(dir, arrangeFs);
+			expect(report.files).toBe(1);
+			expect(report.cnCallExpressions).toBeGreaterThanOrEqual(1);
+			expect(report.tvCallExpressions).toBeGreaterThanOrEqual(1);
+			expect(report.longCnStringLiterals.length).toBeGreaterThanOrEqual(1);
+			expect(report.longTvStringLiterals.length).toBeGreaterThanOrEqual(1);
+			expect(report.longJsxClassNameLiterals.length).toBeGreaterThanOrEqual(1);
+			expect(report.cnInsideTvCalls.length).toBeGreaterThanOrEqual(1);
+			const printed = captureStdout(() => printAnalyzeReport(dir, report, arrangeLogger));
+			expect(printed).toContain("Long cn(...)");
+			expect(printed).toContain("nested inside tv");
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+	it("truncates long-cn listing after MAX_REPORT_LINES", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-analyze-many-"));
+		const long = "peer flex size-4 shrink-0 items-center justify-center rounded-sm border border-input text-primary-foreground shadow-xs outline-hidden transition hover:not-disabled:not-aria-checked:border-ring/60 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:opacity-50";
+		try {
+			let body = `import { cn } from "@codefast/tailwind-variants";\n`;
+			for (let i = 0; i < 42; i++) body += `cn("${long}");\n`;
+			fs.writeFileSync(path.join(dir, "Many.tsx"), body, "utf8");
+			const report = analyzeDirectory(dir, arrangeFs);
+			const printed = captureStdout(() => printAnalyzeReport(dir, report, arrangeLogger));
+			expect(report.longCnStringLiterals.length).toBeGreaterThan(40);
+			expect(printed).toMatch(/… and \d+ more/);
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+	it("truncates long-tv, JSX, and cn-inside-tv sections", () => {
+		const row = {
+			file: "x.tsx",
+			line: 1,
+			tokenCount: 22,
+			preview: "p".repeat(40)
+		};
+		const manyTv = Array.from({ length: 42 }, (_, i) => ({
+			...row,
+			line: i + 1
+		}));
+		const manyJsx = Array.from({ length: 42 }, (_, i) => ({
+			...row,
+			line: i + 1
+		}));
+		const manyNested = Array.from({ length: 42 }, (_, i) => ({
+			file: "x.tsx",
+			line: i + 1,
+			argCount: 1,
+			preview: "cn(...)"
+		}));
+		const matches = captureStdout(() => printAnalyzeReport("/tmp/arr-truncate", {
+			files: 1,
+			cnCallExpressions: 0,
+			tvCallExpressions: 1,
+			cnInsideTvCalls: manyNested,
+			longCnStringLiterals: [],
+			longTvStringLiterals: manyTv,
+			longJsxClassNameLiterals: manyJsx
+		}, arrangeLogger)).match(/… and \d+ more/g);
+		expect(matches?.length).toBeGreaterThanOrEqual(3);
+	});
+	it("does not count JSX className={identifier} as long literal", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-jsx-dyn-"));
+		try {
+			fs.writeFileSync(path.join(dir, "Dyn.tsx"), `export function F(cls: string) { return <div className={cls} />; }`, "utf8");
+			const report = analyzeDirectory(dir, arrangeFs);
+			expect(report.longJsxClassNameLiterals.length).toBe(0);
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+	it("analyzes tv compoundVariants with quoted className key", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-tv-quoted-"));
+		const long = "peer flex size-4 shrink-0 items-center justify-center rounded-sm border border-input text-primary-foreground shadow-xs outline-hidden transition hover:not-disabled:not-aria-checked:border-ring/60 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:opacity-50";
+		try {
+			fs.writeFileSync(path.join(dir, "Quoted.tsx"), `import { tv } from "@codefast/tailwind-variants";
+export const styles = tv({ compoundVariants: [{ "className": "${long}" }] });`, "utf8");
+			const report = analyzeDirectory(dir, arrangeFs);
+			expect(report.longTvStringLiterals.length).toBeGreaterThanOrEqual(1);
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+	it("analyzes tv array slots with nested cn", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-analyze-tv-array-"));
+		const long = "peer flex size-4 shrink-0 items-center justify-center rounded-sm border border-input text-primary-foreground shadow-xs outline-hidden transition hover:not-disabled:not-aria-checked:border-ring/60 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:opacity-50";
+		try {
+			fs.writeFileSync(path.join(dir, "TvArray.tsx"), `import { cn, tv } from "@codefast/tailwind-variants";
+export const styles = tv({ base: [cn("${long}"), "py-0"] });`, "utf8");
+			const report = analyzeDirectory(dir, arrangeFs);
+			expect(report.tvCallExpressions).toBeGreaterThanOrEqual(1);
+			expect(report.cnInsideTvCalls.length).toBeGreaterThanOrEqual(1);
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+	it("accepts legacy tailwind-variants imports during analyze pass (backward compat)", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-analyze-legacy-"));
+		const long = "peer flex size-4 shrink-0 items-center justify-center rounded-sm border border-input text-primary-foreground shadow-xs outline-hidden transition hover:not-disabled:not-aria-checked:border-ring/60 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:opacity-50";
+		const source = `import { cn, tv } from "tailwind-variants";
+
+cn("${long}");
+export const styles = tv({ base: "${long}" });
+`;
+		try {
+			fs.writeFileSync(path.join(dir, "Legacy.tsx"), source, "utf8");
+			const report = analyzeDirectory(dir, arrangeFs);
+			expect(report.cnCallExpressions).toBeGreaterThanOrEqual(1);
+			expect(report.tvCallExpressions).toBeGreaterThanOrEqual(1);
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+});
+//#endregion
+export {};

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

@@ -0,0 +1,2 @@
+import { t as groupFile } from "../../../group-file-ClW7XdD6.mjs";
+export { groupFile };

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

@@ -0,0 +1,273 @@
+import { t as groupFile } from "../../../group-file-ClW7XdD6.mjs";
+import { n as createNodeCliLogger, t as createNodeCliFs } from "../../../node-io-DFRbHO6m.mjs";
+import "../../../arrange-BqP2DI3w.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+//#region src/lib/arrange/application/group-file.test.ts
+const arrangeFs = createNodeCliFs();
+const arrangeLogger = createNodeCliLogger();
+function withTempFixture(name, source, fn) {
+	const dir = fs.mkdtempSync(path.join(os.tmpdir(), "group-file-"));
+	const filePath = path.join(dir, name);
+	try {
+		fs.writeFileSync(filePath, source, "utf8");
+		fn(filePath);
+	} finally {
+		fs.rmSync(dir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+function captureStdout(fn) {
+	const chunks = [];
+	const spy = jest.spyOn(process.stdout, "write").mockImplementation((chunk) => {
+		chunks.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf8"));
+		return true;
+	});
+	try {
+		fn();
+	} finally {
+		spy.mockRestore();
+	}
+	return chunks.join("");
+}
+describe("groupFile", () => {
+	it("unwraps cn() inside tv base into string/array form", () => {
+		withTempFixture("FixtureTv.tsx", `import { cn, tv } from "@codefast/tailwind-variants";
+
+export const styles = tv({
+  base: cn("flex gap-2 text-sm rounded-md border px-3 font-medium"),
+});
+`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(result.changed).toBeGreaterThan(0);
+			expect(after.includes("base: cn(")).toBe(false);
+			expect(after).toMatch(/base:\s*(\[|"[^"]+)/);
+		});
+	});
+	it("converts long JSX className and inserts cn import after use client", () => {
+		withTempFixture("FixtureUseClient.tsx", `"use client";
+
+export function Fixture() {
+  return <div className="flex items-center gap-2 px-4 py-2 text-sm rounded-md border bg-card" />;
+}
+`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(result.changed).toBeGreaterThan(0);
+			expect(after.startsWith(`"use client";\n\nimport { cn }`)).toBe(true);
+			expect(after).toContain("className={cn(");
+		});
+	});
+	it("supports namespace imports for tw.tv / tw.cn and rewrites tw.cn usage", () => {
+		withTempFixture("FixtureNamespace.tsx", `import * as tw from "@codefast/tailwind-variants";
+
+export const styles = tw.tv({
+  base: tw.cn("flex gap-2 text-sm rounded-md border px-3 font-medium hover:bg-accent"),
+});
+`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(result.changed).toBeGreaterThan(0);
+			expect(after).toContain("tw.tv(");
+			expect(after.includes("tw.cn(")).toBe(false);
+			expect(after).toMatch(/base:\s*(\[|"[^"]+)/);
+		});
+	});
+	it("supports namespace imports from legacy tailwind-variants package (backward compat)", () => {
+		withTempFixture("FixtureNamespaceLegacy.tsx", `import * as tw from "tailwind-variants";
+
+export const styles = tw.tv({
+  base: tw.cn("flex gap-2 text-sm rounded-md border px-3 font-medium hover:bg-accent"),
+});
+`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(result.changed).toBeGreaterThan(0);
+			expect(after).toContain("tw.tv(");
+			expect(after.includes("tw.cn(")).toBe(false);
+			expect(after).toMatch(/base:\s*(\[|"[^"]+)/);
+		});
+	});
+	it("recognizes cn/tv imports from local ./utils re-export", () => {
+		withTempFixture("FixtureLocalUtils.tsx", `import { cn, tv } from "./utils";
+export const styles = tv({ base: cn("flex gap-2 text-sm rounded-md border px-3 font-medium hover:bg-accent") });`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			expect(result.changed).toBeGreaterThan(0);
+		});
+	});
+	it("recognizes cn/tv imports from modules containing /utils/", () => {
+		withTempFixture("FixtureUtilsPath.tsx", `import { cn, tv } from "pkg/utils/cn";
+export const styles = tv({ base: cn("flex gap-2 text-sm rounded-md border px-3 font-medium hover:bg-accent") });`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			expect(result.changed).toBeGreaterThan(0);
+		});
+	});
+	it("recognizes cn/tv imports from ./cn.ts shim", () => {
+		withTempFixture("FixtureCnTs.tsx", `import { cn, tv } from "./cn.ts";
+export const styles = tv({ base: cn("flex gap-2 text-sm rounded-md border px-3 font-medium hover:bg-accent") });`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			expect(result.changed).toBeGreaterThan(0);
+		});
+	});
+	it("returns totalFound 0 for files without cn/tv/long class targets", () => {
+		withTempFixture("FixtureEmpty.tsx", "export const only = 1;\n", (filePath) => {
+			expect(groupFile(filePath, {
+				write: false,
+				withClassName: false
+			}, arrangeFs, arrangeLogger)).toEqual({
+				filePath,
+				totalFound: 0,
+				changed: 0
+			});
+		});
+	});
+	it("dry-run returns totalFound 0 when cn partition is already idempotent", () => {
+		withTempFixture("FixturePartitionEq.tsx", `import { cn } from "@codefast/tailwind-variants";
+cn("flex gap-2", "text-sm");`, (filePath) => {
+			expect(groupFile(filePath, {
+				write: false,
+				withClassName: false
+			}, arrangeFs, arrangeLogger)).toEqual({
+				filePath,
+				totalFound: 0,
+				changed: 0
+			});
+		});
+	});
+	it("counts cn() inside tv with zero args as found but unchanged", () => {
+		withTempFixture("FixtureZeroArg.tsx", `import { cn, tv } from "@codefast/tailwind-variants";
+export const broken = tv({ base: cn() });`, (filePath) => {
+			const dry = groupFile(filePath, {
+				write: false,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			expect(dry).toEqual({
+				filePath,
+				totalFound: 1,
+				changed: 0
+			});
+			const wet = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			expect(wet).toEqual({
+				filePath,
+				totalFound: 1,
+				changed: 0
+			});
+		});
+	});
+	it("inserts cn import before first existing import", () => {
+		withTempFixture("FixtureImportOrder.tsx", `import React from "react";
+export function Fixture() {
+  return <div className="flex items-center gap-2 px-4 py-2 text-sm rounded-md border bg-card" />;
+}`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			expect(result.changed).toBeGreaterThan(0);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(after.indexOf("import { cn }")).toBeLessThan(after.indexOf("import React"));
+		});
+	});
+	it("passes withClassName option through cn replacement", () => {
+		withTempFixture("FixtureWithClassName.tsx", `import { cn } from "@codefast/tailwind-variants";
+export function Fixture() {
+  return <div className="flex items-center gap-2 px-4 py-2 text-sm rounded-md border bg-card" />;
+}`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: true
+			}, arrangeFs, arrangeLogger);
+			expect(result.changed).toBeGreaterThan(0);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(after).toContain("className={cn(");
+			expect(after).toContain("className");
+		});
+	});
+	it("merges cn into existing named import when cnImport override matches", () => {
+		withTempFixture("FixtureMergeImport.tsx", `import { tv } from "clsx";
+export function Fixture() {
+  return <div className="flex items-center gap-2 px-4 py-2 text-sm rounded-md border bg-card" />;
+}`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false,
+				cnImport: "clsx"
+			}, arrangeFs, arrangeLogger);
+			expect(result.changed).toBeGreaterThan(0);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(after).toContain("import { cn, tv } from \"clsx\"");
+		});
+	});
+	it("groups compoundVariants class array slots", () => {
+		withTempFixture("FixtureCvClassArray.tsx", `import { tv } from "@codefast/tailwind-variants";
+export const sheet = tv({
+  compoundVariants: [{ className: ["flex gap-2 text-sm rounded-md border px-3 font-medium", "shadow-xs"] }],
+});`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			expect(result.changed).toBeGreaterThan(0);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(after).toContain("compoundVariants");
+		});
+	});
+	it("groups compoundVariants mixed class array slot with cn(...) and plain strings", () => {
+		withTempFixture("FixtureCvClassCn.tsx", `import { cn, tv } from "@codefast/tailwind-variants";
+export const sheet = tv({
+  compoundVariants: [{ class: ["py-1", cn("flex gap-2 text-sm rounded-md border px-3 font-medium shadow-xs")] }],
+});`, (filePath) => {
+			const result = groupFile(filePath, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+			expect(result.changed).toBeGreaterThan(0);
+			const after = fs.readFileSync(filePath, "utf8");
+			expect(after).toContain("class:");
+		});
+	});
+	it("dry-run prints combined unwrap + grouping note", () => {
+		const long = "flex items-center gap-2 px-4 py-2 text-sm rounded-md border bg-card font-medium shadow-xs";
+		withTempFixture("FixtureDryCombined.tsx", `import { cn, tv } from "@codefast/tailwind-variants";
+cn("${long}");
+export const styles = tv({ base: cn("${long}") });`, (filePath) => {
+			const output = captureStdout(() => {
+				groupFile(filePath, {
+					write: false,
+					withClassName: false
+				}, arrangeFs, arrangeLogger);
+			});
+			expect(output).toContain("[cn] / [tv] / [JSX className]");
+		});
+	});
+});
+//#endregion
+export {};

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

@@ -0,0 +1,2 @@
+import { n as runOnTarget, t as runArrangeSync } from "../../../run-target-CJWrqNT4.mjs";
+export { runArrangeSync, runOnTarget };

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

@@ -0,0 +1,97 @@
+import { n as ArrangeErrorCode, t as ArrangeError } from "../../../errors-CpU1ogfA.mjs";
+import { n as runOnTarget } from "../../../run-target-CJWrqNT4.mjs";
+import { n as createNodeCliLogger, t as createNodeCliFs } from "../../../node-io-DFRbHO6m.mjs";
+import "../../../arrange-BqP2DI3w.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+//#region src/lib/arrange/application/run-target.test.ts
+const arrangeFs = createNodeCliFs();
+const arrangeLogger = createNodeCliLogger();
+function captureStdout(fn) {
+	const chunks = [];
+	const spy = jest.spyOn(process.stdout, "write").mockImplementation((chunk) => {
+		chunks.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf8"));
+		return true;
+	});
+	try {
+		fn();
+	} finally {
+		spy.mockRestore();
+	}
+	return chunks.join("");
+}
+describe("runOnTarget", () => {
+	it("prints dry-run totals for directory targets", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-run-dry-"));
+		const long = "peer flex size-4 shrink-0 items-center justify-center rounded-sm border border-input text-primary-foreground shadow-xs outline-hidden transition hover:not-disabled:not-aria-checked:border-ring/60 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:opacity-50";
+		try {
+			fs.writeFileSync(path.join(dir, "Page.tsx"), `import { cn } from "@codefast/tailwind-variants"; export function P(){ cn("${long}"); return null; }`, "utf8");
+			const out = captureStdout(() => runOnTarget(dir, {
+				write: false,
+				withClassName: false
+			}, arrangeFs, arrangeLogger));
+			expect(out).toContain("Total:");
+			expect(out).toContain("to review");
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+	it("throws ArrangeError for missing target path", () => {
+		let caught;
+		try {
+			runOnTarget(path.join(os.tmpdir(), "no-such-arrange-target"), {
+				write: false,
+				withClassName: false
+			}, arrangeFs, arrangeLogger);
+		} catch (caughtError) {
+			caught = caughtError;
+		}
+		expect(caught).toBeInstanceOf(ArrangeError);
+		expect(caught.code).toBe(ArrangeErrorCode.TARGET_NOT_FOUND);
+	});
+	it("prints apply summary in write mode", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-run-apply-"));
+		const before = `import { cn } from "@codefast/tailwind-variants";
+export function Fixture() {
+  return <div className="flex items-center gap-2 px-4 py-2 text-sm rounded-md border bg-card" />;
+}`;
+		try {
+			fs.writeFileSync(path.join(dir, "Apply.tsx"), before, "utf8");
+			const out = captureStdout(() => runOnTarget(dir, {
+				write: true,
+				withClassName: false
+			}, arrangeFs, arrangeLogger));
+			expect(out).toContain("Applied:");
+			expect(out).toContain("Note:");
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+	it("accepts legacy tailwind-variants imports when running directory dry-run (backward compat)", () => {
+		const dir = fs.mkdtempSync(path.join(os.tmpdir(), "arr-run-dry-legacy-"));
+		const long = "peer flex size-4 shrink-0 items-center justify-center rounded-sm border border-input text-primary-foreground shadow-xs outline-hidden transition hover:not-disabled:not-aria-checked:border-ring/60 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:opacity-50";
+		try {
+			fs.writeFileSync(path.join(dir, "Page.tsx"), `import { cn } from "tailwind-variants"; export function P(){ cn("${long}"); return null; }`, "utf8");
+			const out = captureStdout(() => runOnTarget(dir, {
+				write: false,
+				withClassName: false
+			}, arrangeFs, arrangeLogger));
+			expect(out).toContain("Total:");
+			expect(out).toContain("to review");
+		} finally {
+			fs.rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+	});
+});
+//#endregion
+export {};

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

@@ -0,0 +1,2 @@
+import { a as isCnOrTvIdentifier, c as propertyAssignmentNameText, i as indentOfLineContaining, l as unwrapCnInsideTvCallReplacement, n as applyEditsDescending, o as lineOf, r as buildKnownCnTvBindings, s as moduleLooksLikeCnTvReexport, t as KNOWN_CN_TV_MODULES } from "../../../../ast-helpers-MDRYuIAk.mjs";
+export { KNOWN_CN_TV_MODULES, applyEditsDescending, buildKnownCnTvBindings, indentOfLineContaining, isCnOrTvIdentifier, lineOf, moduleLooksLikeCnTvReexport, propertyAssignmentNameText, unwrapCnInsideTvCallReplacement };