@codefast/cli 0.3.14 → 0.3.16-canary.0

package/README.md

@@ -2,6 +2,11 @@
 
 A small developer CLI for maintenance tasks in a TypeScript monorepo — Tailwind class arranging, `package.json` `exports` mirroring, and `@since` JSDoc tagging.
 
+[![CI](https://github.com/codefastlabs/codefast/actions/workflows/release.yml/badge.svg)](https://github.com/codefastlabs/codefast/actions/workflows/release.yml)
+[![npm version](https://img.shields.io/npm/v/@codefast/cli.svg)](https://www.npmjs.com/package/@codefast/cli)
+[![npm downloads](https://img.shields.io/npm/dm/@codefast/cli.svg)](https://www.npmjs.com/package/@codefast/cli)
+[![license](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 ---
 
 ## Table of Contents
@@ -9,7 +14,7 @@ A small developer CLI for maintenance tasks in a TypeScript monorepo — Tailwin
 - [Why @codefast/cli](#why-codefastcli)
 - [Requirements](#requirements)
 - [Installation](#installation)
-- [Quick start](#quick-start)
+- [Quick Start](#quick-start)
 - [Global options](#global-options)
 - [Exit codes](#exit-codes)
 - [`arrange`](#arrange)
@@ -75,7 +80,7 @@ npx @codefast/cli --help
 
 ---
 
-## Quick start
+## Quick Start
 
 ```bash
 # Analyze Tailwind classes in the nearest package
@@ -334,7 +339,7 @@ Contract:
 
 Adjacent buckets may be merged into a single string literal when declared _compatible_ (e.g. Layout + Sizing), which keeps `cn()` calls readable without flattening unrelated concerns.
 
-To change placement, edit `classifyBareUtility` in `src/lib/arrange/domain/tokenizer.util.ts` and add a matching case in `tokenizer.util.test.ts`.
+To change placement, extend `classifyBareUtility` in `packages/cli/src/arrange/domain/token-classifier.ts` (and cover the new rule with arrange tests if you introduce a new bucket).
 
 ---
 

package/dist/arrange/analyze.mjs

@@ -0,0 +1,24 @@
+import { AppError, messageFrom } from "../core/errors.mjs";
+import { err, ok } from "../core/result.mjs";
+import { accumulateAnalyzeReportForSourceFile, createEmptyAnalyzeReport } from "./domain/analyze-service.mjs";
+import { scanArrangeTargets } from "./scan-target.mjs";
+import { parseDomainSourceFile } from "./source-parse.mjs";
+//#region src/arrange/analyze.ts
+/**
+* @since 0.3.16-canary.0
+*/
+function analyzeDirectory(fs, analyzeRootPath) {
+	const report = createEmptyAnalyzeReport();
+	try {
+		const files = scanArrangeTargets(fs, analyzeRootPath);
+		for (const filePath of files) {
+			const sourceText = fs.readFileSync(filePath, "utf8");
+			accumulateAnalyzeReportForSourceFile(report, parseDomainSourceFile(filePath, sourceText), sourceText, filePath);
+		}
+		return ok(report);
+	} catch (caughtError) {
+		return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));
+	}
+}
+//#endregion
+export { analyzeDirectory };

package/dist/{lib/arrange/presentation/arrange-cli.schema.mjs → arrange/cli-schema.mjs}

@@ -1,6 +1,12 @@
 import { z } from "zod";
-//#region src/lib/arrange/presentation/arrange-cli.schema.ts
+//#region src/arrange/cli-schema.ts
+/**
+* @since 0.3.16-canary.0
+*/
 const arrangeAnalyzeDirectoryRequestSchema = z.object({ analyzeRootPath: z.string().min(1, "analyzeRootPath is required") });
+/**
+* @since 0.3.16-canary.0
+*/
 const arrangeSyncRunRequestSchema = z.object({
 	rootDir: z.string().min(1),
 	targetPath: z.string().min(1),
@@ -9,6 +15,9 @@ const arrangeSyncRunRequestSchema = z.object({
 	cnImport: z.string().optional(),
 	config: z.unknown().optional()
 });
+/**
+* @since 0.3.16-canary.0
+*/
 const arrangeSuggestGroupsRequestSchema = z.object({
 	inlineClasses: z.string().min(1, "Pass a class string. Example: codefast arrange group \"flex gap-2 text-sm rounded-md\""),
 	emitTvStyleArray: z.boolean(),

package/dist/arrange/command.mjs

@@ -0,0 +1,106 @@
+import { parseWithSchema } from "../core/schema-parse.mjs";
+import "../core/exit-codes.mjs";
+import { logger } from "../core/logger.mjs";
+import { consumeCliAppError, runCliResultAsync } from "../core/cli/result-handle.mjs";
+import { nodeFilesystem } from "../core/filesystem/node.mjs";
+import { arrangeAnalyzeDirectoryRequestSchema, arrangeSuggestGroupsRequestSchema, arrangeSyncRunRequestSchema } from "./cli-schema.mjs";
+import { prepareArrangeWorkspace } from "./workspace.mjs";
+import { analyzeDirectory } from "./analyze.mjs";
+import { runArrangeSync } from "./sync.mjs";
+import { suggestCnGroupsFromCli } from "./suggest.mjs";
+import { printAnalyzeReport, printGroupFilePreviewFromWork, printSyncResult } from "./output.mjs";
+import { readOptionalPositionalArg } from "../core/cli/positional.mjs";
+import process from "node:process";
+import { Command } from "commander";
+//#region src/arrange/command.ts
+/**
+* @since 0.3.16-canary.0
+*/
+function createArrangeCommand() {
+	const cmd = new Command("arrange").description("Analyze and regroup Tailwind classes in cn() / tv() calls (Tailwind v4)");
+	cmd.command("analyze").description("Report long strings, nested cn in tv(), and related findings").argument("[target]", "Directory or file (default: nearest package directory from cwd)").option("--json", "Print one JSON object on stdout instead of a human report", false).action(async (target, opts) => {
+		const prelude = await prepareArrangeWorkspace(nodeFilesystem, {
+			currentWorkingDirectory: process.cwd(),
+			rawTarget: readOptionalPositionalArg(target)
+		});
+		if (!consumeCliAppError(prelude)) return;
+		const { resolvedTarget } = prelude.value;
+		const parsed = parseWithSchema(arrangeAnalyzeDirectoryRequestSchema, { analyzeRootPath: resolvedTarget });
+		if (!consumeCliAppError(parsed)) return;
+		const outcome = analyzeDirectory(nodeFilesystem, parsed.value.analyzeRootPath);
+		if (!consumeCliAppError(outcome)) return;
+		if (opts.json) logger.out(formatArrangeAnalyzeJsonOutput(resolvedTarget, outcome.value));
+		else printAnalyzeReport(resolvedTarget, outcome.value);
+	});
+	const previewOrApply = (write) => async (target, opts) => {
+		const prelude = await prepareArrangeWorkspace(nodeFilesystem, {
+			currentWorkingDirectory: process.cwd(),
+			rawTarget: readOptionalPositionalArg(target)
+		});
+		if (!consumeCliAppError(prelude)) return;
+		const { resolvedTarget, rootDir, config } = prelude.value;
+		const parsed = parseWithSchema(arrangeSyncRunRequestSchema, {
+			rootDir,
+			targetPath: resolvedTarget,
+			write,
+			withClassName: opts.withClassName,
+			cnImport: opts.cnImport,
+			config: config.arrange ?? {}
+		});
+		if (!consumeCliAppError(parsed)) return;
+		await runCliResultAsync(runArrangeSync(nodeFilesystem, parsed.value), (value) => {
+			if (!write) for (const plan of value.previewPlans) printGroupFilePreviewFromWork(plan);
+			if (opts.json) {
+				logger.out(formatArrangeSyncJsonOutput(value, write));
+				return exitCodeForArrangeSyncResult(value);
+			}
+			printSyncResult(value, write);
+			return exitCodeForArrangeSyncResult(value);
+		});
+	};
+	cmd.command("preview").description("Dry-run: print suggested replacements without writing files").argument("[target]", "Directory or file (default: nearest package directory from cwd)").option("--with-classname, --with-class-name", "Append className as final cn() argument", false).option("--cn-import <spec>", "Override module specifier when adding cn import").option("--json", "Print one JSON object on stdout (suppresses human progress)", false).action(previewOrApply(false));
+	cmd.command("apply").description("Apply grouping and cn-in-tv unwrap edits to files").argument("[target]", "Directory or file (default: nearest package directory from cwd)").option("--with-classname, --with-class-name", "Append className as final cn() argument", false).option("--cn-import <spec>", "Override module specifier when adding cn import").option("--json", "Print one JSON object on stdout (suppresses human progress)", false).action(previewOrApply(true));
+	cmd.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).option("--with-classname, --with-class-name", "Append className as final cn() argument", false).option("--json", "Print one JSON object on stdout instead of plain lines", false).action(async (classTokenSeries, opts) => {
+		const parsed = parseWithSchema(arrangeSuggestGroupsRequestSchema, {
+			inlineClasses: classTokenSeries.join(" ").trim(),
+			emitTvStyleArray: !!opts.tv,
+			trailingClassName: !!opts.withClassName
+		});
+		if (!consumeCliAppError(parsed)) return;
+		const output = suggestCnGroupsFromCli(parsed.value);
+		if (opts.json) logger.out(formatArrangeGroupJsonOutput(output));
+		else {
+			logger.out(output.primaryLine);
+			logger.out(output.bucketsCommentLine);
+		}
+	});
+	return cmd;
+}
+function formatArrangeAnalyzeJsonOutput(analyzeRootPath, report) {
+	return JSON.stringify({
+		schemaVersion: 1,
+		analyzeRootPath,
+		report
+	});
+}
+function formatArrangeSyncJsonOutput(result, write) {
+	const { previewPlans: _plans, ...serializableResult } = result;
+	return JSON.stringify({
+		schemaVersion: 1,
+		ok: result.hookError === null,
+		write,
+		result: serializableResult
+	});
+}
+function formatArrangeGroupJsonOutput(output) {
+	return JSON.stringify({
+		schemaVersion: 1,
+		primaryLine: output.primaryLine,
+		bucketsCommentLine: output.bucketsCommentLine
+	});
+}
+function exitCodeForArrangeSyncResult(result) {
+	return result.hookError !== null ? 1 : 0;
+}
+//#endregion
+export { createArrangeCommand };

package/dist/{lib/arrange/domain/arrange-analyze.service.mjs → arrange/domain/analyze-service.mjs}

@@ -1,18 +1,22 @@
-import "./constants.domain.mjs";
-import { forEachDomainChild, isDomainCallExpression, isDomainJsxAttribute, isDomainObjectLiteralExpression } from "./ast/ast-node.model.mjs";
-import { buildKnownCnTvBindings, isCnOrTvIdentifier, lineOf } from "./ast/ast-helpers.helper.mjs";
-import { forEachStringLiteralInClassExpression } from "./ast/collectors-cn.collector.mjs";
-import { tokenizeClassString } from "./tailwind-token.value-object.mjs";
-import { collectCnCallsInsideTv, traverseTvObject } from "./ast/collectors-tv.collector.mjs";
-import { jsxClassNameStaticLiteral } from "./ast/collectors-jsx.collector.mjs";
-//#region src/lib/arrange/domain/arrange-analyze.service.ts
+import "./constants.mjs";
+import { tokenizeClassString } from "./tailwind-token.mjs";
+import { forEachDomainChild, isDomainCallExpression, isDomainJsxAttribute, isDomainObjectLiteralExpression } from "./ast/ast-node.mjs";
+import { forEachStringLiteralInClassExpression } from "./ast/collectors-cn.mjs";
+import { jsxClassNameStaticLiteral } from "./ast/collectors-jsx.mjs";
+import { buildKnownCnTvBindings, isCnOrTvIdentifier, lineOf } from "./ast/helpers.mjs";
+import { collectCnCallsInsideTv, traverseTvObject } from "./ast/collectors-tv.mjs";
+//#region src/arrange/domain/analyze-service.ts
 /**
 * Rich domain: Tailwind/cn/tv analysis rules (counts, long literals, nested cn in tv).
 * Pure orchestration of domain collectors and invariants — no I/O.
-*/ const PREVIEW_MAX_LENGTH = 72;
+*/
+const PREVIEW_MAX_LENGTH = 72;
 function previewText(text) {
 	return text.length > PREVIEW_MAX_LENGTH ? `${text.slice(0, PREVIEW_MAX_LENGTH)}…` : text;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function createEmptyAnalyzeReport() {
 	return {
 		files: 0,
@@ -81,7 +85,10 @@ function visitJsxAttributeForArrangeAnalyze(jsxClassAttribute, domainSf, filePat
 }
 /**
 * Accumulates findings for one parsed source file into `report` (mutates report).
-*/ function accumulateAnalyzeReportForSourceFile(report, domainSf, sourceText, filePath) {
+*
+* @since 0.3.16-canary.0
+*/
+function accumulateAnalyzeReportForSourceFile(report, domainSf, sourceText, filePath) {
 	report.files++;
 	const knownBindings = buildKnownCnTvBindings(domainSf);
 	const visitTypeScriptSubtree = (tsNode) => {

package/dist/{lib/arrange/domain/ast/ast-node.model.mjs → arrange/domain/ast/ast-node.mjs}

@@ -1,8 +1,11 @@
-//#region src/lib/arrange/domain/ast/ast-node.model.ts
+//#region src/arrange/domain/ast/ast-node.ts
 /**
 * Pure-domain AST shapes for arrange analysis. No TypeScript compiler types.
 * Positions mirror `getStart(sourceFile)` / `getEnd()` semantics from translation.
-*/ var DomainSyntaxKind = /* @__PURE__ */ function(DomainSyntaxKind) {
+*
+* @since 0.3.16-canary.0
+*/
+let DomainSyntaxKind = /* @__PURE__ */ function(DomainSyntaxKind) {
 	DomainSyntaxKind[DomainSyntaxKind["Unknown"] = 1] = "Unknown";
 	DomainSyntaxKind[DomainSyntaxKind["Identifier"] = 2] = "Identifier";
 	DomainSyntaxKind[DomainSyntaxKind["StringLiteral"] = 3] = "StringLiteral";
@@ -29,56 +32,104 @@
 	DomainSyntaxKind[DomainSyntaxKind["JsxExpression"] = 24] = "JsxExpression";
 	return DomainSyntaxKind;
 }({});
-var DomainBinaryOperator = /* @__PURE__ */ function(DomainBinaryOperator) {
+/**
+* @since 0.3.16-canary.0
+*/
+let DomainBinaryOperator = /* @__PURE__ */ function(DomainBinaryOperator) {
 	DomainBinaryOperator[DomainBinaryOperator["Plus"] = 0] = "Plus";
 	DomainBinaryOperator[DomainBinaryOperator["Other"] = 1] = "Other";
 	return DomainBinaryOperator;
 }({});
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainIdentifier(node) {
 	return node.kind === 2;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainStringLiteral(node) {
 	return node.kind === 3;
 }
 function isDomainNoSubstitutionTemplateLiteral(node) {
 	return node.kind === 4;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainTailwindClassLiteral(node) {
 	return isDomainStringLiteral(node) || isDomainNoSubstitutionTemplateLiteral(node);
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainImportDeclaration(node) {
 	return node.kind === 5;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainNamedImports(node) {
 	return node.kind === 7;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainNamespaceImport(node) {
 	return node.kind === 8;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainCallExpression(node) {
 	return node.kind === 10;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainObjectLiteralExpression(node) {
 	return node.kind === 12;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainPropertyAssignment(node) {
 	return node.kind === 13;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainArrayLiteralExpression(node) {
 	return node.kind === 14;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainSpreadElement(node) {
 	return node.kind === 15;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainPropertyAccessExpression(node) {
 	return node.kind === 11;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainJsxAttribute(node) {
 	return node.kind === 23;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isDomainJsxExpression(node) {
 	return node.kind === 24;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function forEachDomainChild(node, visit) {
 	switch (node.kind) {
 		case 1:
@@ -151,6 +202,9 @@ function forEachDomainChild(node, visit) {
 		default: return;
 	}
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function lineOfSourcePosition(sourceText, pos) {
 	const boundedPos = Math.max(0, Math.min(pos, sourceText.length));
 	let line = 1;

package/dist/{lib/arrange/domain/ast/collectors-cn.collector.mjs → arrange/domain/ast/collectors-cn.mjs}

@@ -1,44 +1,56 @@
-import "../constants.domain.mjs";
-import { DomainBinaryOperator, DomainSyntaxKind, isDomainArrayLiteralExpression, isDomainTailwindClassLiteral } from "./ast-node.model.mjs";
-//#region src/lib/arrange/domain/ast/collectors-cn.collector.ts
+import "../constants.mjs";
+import { isDomainArrayLiteralExpression, isDomainTailwindClassLiteral } from "./ast-node.mjs";
+//#region src/arrange/domain/ast/collectors-cn.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function forEachStringLiteralInClassExpression(expr, sink, depth = 0, options) {
 	if (depth > 12) return;
 	if (isDomainTailwindClassLiteral(expr)) {
 		sink(expr);
 		return;
 	}
-	if (expr.kind === DomainSyntaxKind.ParenthesizedExpression) {
+	if (expr.kind === 16) {
 		forEachStringLiteralInClassExpression(expr.expression, sink, depth + 1, options);
 		return;
 	}
-	if (expr.kind === DomainSyntaxKind.AsExpression || expr.kind === DomainSyntaxKind.SatisfiesExpression) {
+	if (expr.kind === 17 || expr.kind === 18) {
 		forEachStringLiteralInClassExpression(expr.expression, sink, depth + 1, options);
 		return;
 	}
-	if (expr.kind === DomainSyntaxKind.NonNullExpression) {
+	if (expr.kind === 19) {
 		forEachStringLiteralInClassExpression(expr.expression, sink, depth + 1, options);
 		return;
 	}
-	if (expr.kind === DomainSyntaxKind.ConditionalExpression) {
+	if (expr.kind === 20) {
 		if (options?.descendIntoConditional === false) return;
 		forEachStringLiteralInClassExpression(expr.whenTrue, sink, depth + 1, options);
 		forEachStringLiteralInClassExpression(expr.whenFalse, sink, depth + 1, options);
 		return;
 	}
-	if (expr.kind === DomainSyntaxKind.BinaryExpression && expr.operator === DomainBinaryOperator.Plus) {
+	if (expr.kind === 21 && expr.operator === 0) {
 		forEachStringLiteralInClassExpression(expr.left, sink, depth + 1, options);
 		forEachStringLiteralInClassExpression(expr.right, sink, depth + 1, options);
 		return;
 	}
 	if (isDomainArrayLiteralExpression(expr)) for (const arrayElement of expr.elements) {
-		if (arrayElement.kind === DomainSyntaxKind.SpreadElement) continue;
+		if (arrayElement.kind === 15) continue;
 		forEachStringLiteralInClassExpression(arrayElement, sink, depth + 1, options);
 	}
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isUnsafeLiteralForCnStyleApplySplit(classLiteral) {
 	return classLiteral.parent !== null && isDomainArrayLiteralExpression(classLiteral.parent);
 }
+/**
+* @since 0.3.16-canary.0
+*/
 const CN_APPLY_LITERAL_WALK_OPTS = { descendIntoConditional: false };
+/**
+* @since 0.3.16-canary.0
+*/
 function collectUnconditionalTailwindLiteralsFromCnArguments(args) {
 	const staticLits = [];
 	for (const arg of args) if (isDomainTailwindClassLiteral(arg)) {

package/dist/{lib/arrange/domain/ast/collectors-jsx.collector.mjs → arrange/domain/ast/collectors-jsx.mjs}

@@ -1,5 +1,8 @@
-import { isDomainIdentifier, isDomainJsxExpression, isDomainTailwindClassLiteral } from "./ast-node.model.mjs";
-//#region src/lib/arrange/domain/ast/collectors-jsx.collector.ts
+import { isDomainIdentifier, isDomainJsxExpression, isDomainTailwindClassLiteral } from "./ast-node.mjs";
+//#region src/arrange/domain/ast/collectors-jsx.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function jsxClassNameStaticLiteral(jsxClassNameAttribute) {
 	if (!isDomainIdentifier(jsxClassNameAttribute.name) || jsxClassNameAttribute.name.text !== "className") return;
 	const init = jsxClassNameAttribute.initializer;

package/dist/{lib/arrange/domain/ast/collectors-tv.collector.mjs → arrange/domain/ast/collectors-tv.mjs}

@@ -1,9 +1,12 @@
-import "../constants.domain.mjs";
-import { forEachDomainChild, isDomainArrayLiteralExpression, isDomainCallExpression, isDomainObjectLiteralExpression, isDomainPropertyAssignment, isDomainSpreadElement, isDomainTailwindClassLiteral } from "./ast-node.model.mjs";
-import { buildKnownCnTvBindings, isCnOrTvIdentifier, propertyAssignmentNameText } from "./ast-helpers.helper.mjs";
-import { CN_APPLY_LITERAL_WALK_OPTS, collectUnconditionalTailwindLiteralsFromCnArguments, forEachStringLiteralInClassExpression, isUnsafeLiteralForCnStyleApplySplit } from "./collectors-cn.collector.mjs";
-import { tokenizeClassString } from "../tailwind-token.value-object.mjs";
-//#region src/lib/arrange/domain/ast/collectors-tv.collector.ts
+import "../constants.mjs";
+import { tokenizeClassString } from "../tailwind-token.mjs";
+import { forEachDomainChild, isDomainArrayLiteralExpression, isDomainCallExpression, isDomainObjectLiteralExpression, isDomainPropertyAssignment, isDomainSpreadElement, isDomainTailwindClassLiteral } from "./ast-node.mjs";
+import { CN_APPLY_LITERAL_WALK_OPTS, collectUnconditionalTailwindLiteralsFromCnArguments, forEachStringLiteralInClassExpression, isUnsafeLiteralForCnStyleApplySplit } from "./collectors-cn.mjs";
+import { buildKnownCnTvBindings, isCnOrTvIdentifier, propertyAssignmentNameText } from "./helpers.mjs";
+//#region src/arrange/domain/ast/collectors-tv.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function traverseTvObject(sourceFile, obj, visitor, depth = 0, knownBindings) {
 	if (depth > 12) return;
 	for (const prop of obj.properties) {
@@ -37,6 +40,9 @@ function traverseTvObject(sourceFile, obj, visitor, depth = 0, knownBindings) {
 		});
 	}
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function collectCnCallsInsideTv(sourceFile, obj, knownBindings, depth = 0) {
 	if (depth > 12) return [];
 	const calls = [];
@@ -59,6 +65,9 @@ function collectCnCallsInsideTv(sourceFile, obj, knownBindings, depth = 0) {
 	}
 	return calls;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function listAllCnCallsInsideTvInSourceFile(sourceFile, knownBindings) {
 	const calls = [];
 	const visitSubtree = (tsNode) => {
@@ -84,6 +93,9 @@ function makeStringNode(nodes, sourceFile, isTvContext, cnCall) {
 		}
 	};
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function slotClassString(stringNode) {
 	return stringNode.nodes.map((literal) => literal.text).join(" ");
 }
@@ -144,6 +156,9 @@ function collectTvSlots(sourceFile, obj, knownBindings, results, seenNodePos, de
 		}
 	}
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function collectGroupableStringNodes(sourceFile) {
 	const results = [];
 	const seenNodePos = /* @__PURE__ */ new Set();

package/dist/{lib/arrange/domain/ast/ast-helpers.helper.mjs → arrange/domain/ast/helpers.mjs}

@@ -1,10 +1,11 @@
-import { EMPTY_CN_TV_BINDINGS } from "../constants.domain.mjs";
-import { applyEditsDescending, indentOfLineContaining } from "../../../shared/source-code/domain/text-edit.model.mjs";
-import { isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, isDomainNamespaceImport, isDomainPropertyAccessExpression, isDomainStringLiteral, lineOfSourcePosition } from "./ast-node.model.mjs";
-//#region src/lib/arrange/domain/ast/ast-helpers.helper.ts
+import { EMPTY_CN_TV_BINDINGS } from "../constants.mjs";
+import { isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, isDomainNamespaceImport, isDomainPropertyAccessExpression, isDomainStringLiteral, lineOfSourcePosition } from "./ast-node.mjs";
+import { applyEditsDescending, indentOfLineContaining } from "../../../core/source-text-edit.mjs";
+//#region src/arrange/domain/ast/helpers.ts
 /**
 * Known module specifiers that export `cn` / `tv`.
-*/ const KNOWN_CN_TV_MODULES = new Set([
+*/
+const KNOWN_CN_TV_MODULES = new Set([
 	"@codefast/tailwind-variants",
 	"clsx",
 	"class-variance-authority",
@@ -16,7 +17,8 @@ import { isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, is
 /**
 * True for typical shadcn-style re-exports: `./utils`, `@/lib/utils`, `…/utils/…`,
 * or a dedicated `cn.ts` / `cn.tsx` module.
-*/ function moduleLooksLikeCnTvReexport(moduleSpecifier) {
+*/
+function moduleLooksLikeCnTvReexport(moduleSpecifier) {
 	const norm = moduleSpecifier.replace(/\\/g, "/");
 	if (/(?:^|[./])utils(?:\/|$)/.test(norm)) return true;
 	if (/\/utils\//.test(norm) || /\/utils$/.test(norm)) return true;
@@ -26,7 +28,10 @@ import { isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, is
 /**
 * Build a set of local binding names that are imported from a known cn/tv
 * module in `sourceFile`.
-*/ function buildKnownCnTvBindings(sourceFile) {
+*
+* @since 0.3.16-canary.0
+*/
+function buildKnownCnTvBindings(sourceFile) {
 	const bindings = /* @__PURE__ */ new Set();
 	for (const stmt of sourceFile.statements) {
 		if (!isDomainImportDeclaration(stmt) || !stmt.importClause) continue;
@@ -50,23 +55,35 @@ import { isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, is
 /**
 * 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) {
+*
+* @since 0.3.16-canary.0
+*/
+function isCnOrTvIdentifier(expr, name, knownBindings = EMPTY_CN_TV_BINDINGS) {
 	if (knownBindings.size === 0) return false;
 	if (isDomainIdentifier(expr) && expr.text === name) return knownBindings.has(expr.text);
 	if (isDomainPropertyAccessExpression(expr) && expr.name.text === name) return isDomainIdentifier(expr.expression) && knownBindings.has(expr.expression.text);
 	return false;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function propertyAssignmentNameText(prop) {
 	if (isDomainIdentifier(prop.name)) return prop.name.text;
 	if (isDomainStringLiteral(prop.name)) return prop.name.text;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function lineOf(sourceFile, node) {
 	return lineOfSourcePosition(sourceFile.text, node.pos);
 }
 /**
 * 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) {
+*
+* @since 0.3.16-canary.0
+*/
+function unwrapCnInsideTvCallReplacement(call, sourceText) {
 	const args = call.arguments;
 	if (args.length === 0) return;
 	const baseIndent = indentOfLineContaining(sourceText, call.pos);

package/dist/{lib/arrange/domain/ast/targets.model.mjs → arrange/domain/ast/targets.mjs}

@@ -1,13 +1,16 @@
-import "../constants.domain.mjs";
-import { endAfterOptionalCommaFollowingInSource, indentOfLineContaining, textPrefixFromLineStartToPosition } from "../../../shared/source-code/domain/text-edit.model.mjs";
-import { forEachDomainChild, isDomainArrayLiteralExpression, isDomainJsxAttribute, isDomainTailwindClassLiteral } from "./ast-node.model.mjs";
-import { isUnsafeLiteralForCnStyleApplySplit } from "./collectors-cn.collector.mjs";
-import { tokenizeClassString } from "../tailwind-token.value-object.mjs";
-import { collectGroupableStringNodes, slotClassString } from "./collectors-tv.collector.mjs";
-import { areCnTailwindPartitionsEquivalent, suggestCnGroups, summarizeGroupBucketLabels } from "../grouping.domain.mjs";
-import { escapeTsStringLiteralContent, formatArray, formatArrayElementsAsSiblingLines, formatJsxCnAttributeValue } from "../source-text-formatters.formatter.mjs";
-import { jsxClassNameStaticLiteral } from "./collectors-jsx.collector.mjs";
-//#region src/lib/arrange/domain/ast/targets.model.ts
+import "../constants.mjs";
+import { tokenizeClassString } from "../tailwind-token.mjs";
+import { forEachDomainChild, isDomainArrayLiteralExpression, isDomainJsxAttribute, isDomainTailwindClassLiteral } from "./ast-node.mjs";
+import { isUnsafeLiteralForCnStyleApplySplit } from "./collectors-cn.mjs";
+import { jsxClassNameStaticLiteral } from "./collectors-jsx.mjs";
+import { endAfterOptionalCommaFollowingInSource, indentOfLineContaining, textPrefixFromLineStartToPosition } from "../../../core/source-text-edit.mjs";
+import { collectGroupableStringNodes, slotClassString } from "./collectors-tv.mjs";
+import { areCnTailwindPartitionsEquivalent, suggestCnGroups, summarizeGroupBucketLabels } from "../grouping.mjs";
+import { escapeTsStringLiteralContent, formatArray, formatArrayElementsAsSiblingLines, formatJsxCnAttributeValue } from "../source-text-formatters.mjs";
+//#region src/arrange/domain/ast/targets.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function targetReplaceStart(target) {
 	if (target.kind === "cnArg") return target.item.cnCall ? target.item.cnCall.pos : target.item.primaryClassLiteral.pos;
 	return target.valueNode.pos;
@@ -29,6 +32,9 @@ function collectLongJsxClassNameTargets(sourceFile) {
 	for (const stmt of sourceFile.statements) visitTypeScriptSubtree(stmt);
 	return results;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function collectGroupTargets(sourceFile, filePath) {
 	const cnPart = collectGroupableStringNodes(sourceFile).map((stringNode) => ({
 		kind: "cnArg",
@@ -58,6 +64,9 @@ function formatCnCallReplacement(stringNode, sourceText, withClassName) {
 	const commaAfterLastArg = allArgs.length > 1;
 	return `cn(\n${allArgs.map((argLine, lineIndex) => lineIndex < allArgs.length - 1 || commaAfterLastArg ? `${argLine},` : `${argLine}`).join("\n")}\n${baseIndent})`;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function planGroupEditForTarget(target, textAfterUnwrap, withClassName) {
 	if (target.kind === "jsxClassName") {
 		const groups = suggestCnGroups(target.lit.text);