@codefast/cli 0.5.0-canary.5 → 0.5.0-canary.6

package/dist/arrange/domain/token-classifier.mjs

@@ -1,218 +0,0 @@
-import { COMPATIBLE_BUCKET_SETS, RESPONSIVE_PREFIX, STATE_PREFIXES } from "./constants.mjs";
-import { indexOfFirstVariantColon, stripVariants } from "./tailwind-token.mjs";
-//#region src/arrange/domain/token-classifier.ts
-/**
-* Bare-token classification is **total** (always returns a {@link Bucket}). The `Result` pattern
-* (`isOk` / `isErr`) belongs at arrange use-case / I/O boundaries, not on this hot path.
-*
-* Variant stems not covered by a single entry in STATE_PREFIXES (compound `has-*`,
-* numbered `nth-*`, media features, v4 `in-[…]`, child selectors `*` / `**`, …).
-* When these are missed, `isStateToken` is false and the variant is stripped — the
-* utility is then bucketed as if it were unconditional, which breaks preview grouping.
-*/
-function isCompoundOrMediaVariantPrefix(prefix) {
-	if (prefix === "*" || prefix === "**") return true;
-	if (prefix === "inert") return true;
-	if (prefix.startsWith("has-")) return true;
-	if (prefix.startsWith("in-[")) return true;
-	if (/^nth(?:-last)?(?:-of-type)?(?:-\d+|-\[)/.test(prefix) || /^nth-of-type-\d+$/.test(prefix) || /^nth-last-of-type-\d+$/.test(prefix)) return true;
-	if (/^(?:user-valid|user-invalid|contrast-more|contrast-less|forced-colors|inverted-colors)$/.test(prefix)) return true;
-	if (/^(?:any-)?pointer-(?:fine|coarse|none)$/.test(prefix)) return true;
-	if (/^(?:portrait|landscape|noscript)$/.test(prefix)) return true;
-	return false;
-}
-/**
-* Outermost variant segment: first `:` at bracket depth 0 → text before it.
-*/
-function firstLeadingVariantPrefix(token) {
-	const colonIdx = indexOfFirstVariantColon(token);
-	if (colonIdx === -1) return;
-	return token.slice(0, colonIdx);
-}
-function isSelectorVariantToken(token) {
-	const prefix = firstLeadingVariantPrefix(token);
-	if (prefix === void 0) return false;
-	if (prefix === "*" || prefix === "**") return true;
-	if (prefix.startsWith("has-")) return true;
-	if (prefix.startsWith("in-[")) return true;
-	if (prefix.startsWith("group-[")) return true;
-	if (prefix.startsWith("peer-[")) return true;
-	if (prefix.startsWith("not-[")) return true;
-	return false;
-}
-function isStateToken(token) {
-	const prefix = firstLeadingVariantPrefix(token);
-	if (prefix === void 0) return false;
-	if (RESPONSIVE_PREFIX.test(token)) return true;
-	if (STATE_PREFIXES.has(prefix)) return true;
-	if (prefix.startsWith("data-[")) return true;
-	if (prefix.startsWith("aria-[")) return true;
-	if (prefix.startsWith("supports-[")) return true;
-	if (prefix.startsWith("in-data-")) return true;
-	if (/^data-(?!\[)/.test(prefix)) return true;
-	if (prefix.startsWith("aria-")) return true;
-	if (/^(group|peer)-/.test(prefix)) return true;
-	if (prefix.startsWith("not-")) return true;
-	if (isCompoundOrMediaVariantPrefix(prefix)) return true;
-	if (prefix.startsWith("[") && prefix.endsWith("]")) return true;
-	return false;
-}
-/**
-* Secondary sort inside the **composite** bucket: opacity / blend / isolation →
-* 3D context → 3D transforms → 2D transforms → filters → will-change.
-*
-* @since 0.3.16-canary.0
-*/
-function compositeSecondaryOrder(bareUtility) {
-	const b = bareUtility;
-	if (/^opacity(?:-|$)/.test(b) || b.startsWith("mix-blend-") || /^isolation(?:-|$)/.test(b) || b === "isolate") return 0;
-	if (b === "transform-3d" || /^perspective(?:-|$)/.test(b)) return 10;
-	if (/^rotate-[xyz](?:-|$)/.test(b) || /^translate-z(?:-|$)/.test(b) || /^scale-z(?:-|$)/.test(b)) return 20;
-	if (/^translate(?:-|$)/.test(b) || /^scale(?:-|$)/.test(b) || /^rotate(?:-|$)/.test(b) || /^skew(?:-|$)/.test(b)) return 30;
-	if (/^transform(?:-(?:gpu|cpu|none))?$/.test(b)) return 35;
-	if (/^blur(?:-|$)/.test(b) || b.startsWith("backdrop-") || /^filter(?:-|$)/.test(b) || b.startsWith("brightness-") || b.startsWith("contrast-") || /^grayscale(?:-|$)/.test(b) || b.startsWith("hue-rotate-") || /^invert(?:-|$)/.test(b) || b.startsWith("saturate-") || /^sepia(?:-|$)/.test(b)) return 40;
-	if (b.startsWith("will-change")) return 50;
-	return 99;
-}
-/**
-* Classify a **bare** utility (no `hover:` / `md:` / … prefixes).
-*/
-function classifyBareUtility(bareUtility) {
-	const b = bareUtility;
-	if (/^@container(?:\/[a-z][a-z0-9-]*)?$/i.test(b)) return "existence";
-	if (/^(?:hidden|contents|sr-only|not-sr-only|list-item|flow-root)$/.test(b) || /^(?:block|inline-block|inline)$/.test(b)) return "existence";
-	if (/^table(?:$|-)/.test(b)) return "existence";
-	if (b.startsWith("contain-")) return "existence";
-	if (/^(?:group|peer)(?:\/[a-z][a-z0-9-]*)?$/.test(b)) return "existence";
-	if (/^(?:static|relative|absolute|fixed|sticky)$/.test(b)) return "position";
-	if (/^-?(?:inset|top|right|bottom|left|start|end)(?:-|\/|$)/.test(b) || /^-?(?:inset-x|inset-y|inset-s|inset-e)-/.test(b)) return "position";
-	if (/^-?z-/.test(b) || b === "z-auto") return "position";
-	if (/^(?:flex|inline-flex|grid|inline-grid|subgrid|masonry)(?:$|-)/.test(b) || /^(?:items|justify|justify-items|justify-self|content|self|place|place-content|place-items|place-self)-/.test(b) || /^-?(?:gap|space-[xy]|col-|row-|grid-|auto-cols|auto-rows|order-|order$)/.test(b) || /^-?(?:auto-flow|grid-flow)-/.test(b) || /^(?:columns-|break-after|break-before|break-inside)-/.test(b) || /^(?:float|clear)-/.test(b) || /^(?:wrap-|flex-wrap|flex-nowrap|flex-row|flex-col|flex-auto|flex-initial|flex-none|flex-1|flex-\[)/.test(b) || /^container$/.test(b)) return "layout";
-	if (/^-?(?:w|h|min-w|max-w|min-h|max-h|size|aspect|shrink|grow|basis)-/.test(b) || /^(?:shrink|grow)(?:$|-)/.test(b) || /^-?overflow-/.test(b) || /^-?object-/.test(b)) return "sizing";
-	if (/^-?(?:p|px|py|pt|pb|pl|pr|ps|pe|m|mx|my|mt|mb|ml|mr|ms|me)-/.test(b)) return "spacing";
-	if (/^-?(?:rounded|border|ring|divide|inset-ring)(?:-|\/|$)/.test(b) || /^(?:rounded|border|ring|divide|inset-ring)$/.test(b) || b.startsWith("ring-offset-")) return "shape";
-	if (/^-?bg-/.test(b) || /^(?:from|via|to)(?:-|\/|$)/.test(b) || /^bg-(?:linear|radial|conic)-/.test(b) || /^-?mask-/.test(b) || /^-?(?:fill|stroke)-/.test(b)) return "background";
-	if (/^-?(?:shadow|inset-shadow|drop-shadow|text-shadow)(?:-|\/|$)/.test(b) || /^(?:shadow|inset-shadow)$/.test(b) || /^-?outline(?:-|\/|$)/.test(b) || /^outline$/.test(b)) return "shadow";
-	if (/^-?(?:font|leading|tracking|list|indent|align|decoration|underline-offset|text-wrap|text-balance|text-pretty)-/.test(b) || /^-?(?:text-(?!shadow))/.test(b) || /^-?(?:whitespace|break|line-clamp|hyphens)-/.test(b) || /^(?:antialiased|subpixel-antialiased|italic|not-italic|overline|line-through|underline|no-underline|uppercase|lowercase|capitalize|normal-case|truncate|text-wrap|text-balance|text-pretty)$/.test(b) || b.startsWith("text-wrap-") || /^tabular-nums$|^slashed-zero$|^lining-nums$|^oldstyle-nums$|^proportional-nums$/.test(b)) return "typography";
-	if (/^opacity(?:-|$)/.test(b) || b.startsWith("mix-blend-") || /^isolation(?:-|$)/.test(b) || b === "isolate" || /^transform(?:-(?:gpu|cpu|none))?$/.test(b) || /^-?(?:translate|scale|rotate|skew)-/.test(b) || /^perspective(?:-|$)/.test(b) || b === "transform-3d" || /^blur(?:-|$)/.test(b) || b.startsWith("backdrop-") || /^filter(?:-|$)/.test(b) || b.startsWith("brightness-") || b.startsWith("contrast-") || /^grayscale(?:-|$)/.test(b) || b.startsWith("hue-rotate-") || /^invert(?:-|$)/.test(b) || b.startsWith("saturate-") || /^sepia(?:-|$)/.test(b) || b.startsWith("will-change")) return "composite";
-	if (/^(?:transition|duration|ease|delay|animate)(?:-|$)/.test(b) || b.startsWith("ease-")) return "motion";
-	if (/^(?:cursor|pointer-events|select|touch|scroll|scroll-m|scroll-p|overscroll|snap|resize|field-sizing|appearance|scheme|color-scheme|accent|caret)(?:-|$)/.test(b) || /^(?:cursor|select|resize)$/.test(b) || b.startsWith("scroll-behavior") || b.startsWith("scroll-snap") || b.startsWith("touch-action") || b === "inert") return "behavior";
-	return "other";
-}
-/**
-* Arbitrary **parent** selectors (`[&…]`, `[&>a]:…`, slot forms with `&` inside the bracket)
-* scope utilities to descendants — bucket as `selector` so they chunk apart from base layout/typography
-* and are labeled distinctly from interactive `state` variants (`hover:`, `data-[…]:`, …).
-* Pure arbitrary **properties** (`[--x]:`, `[color:red]`) have no `&` in the leading `[…]` segment.
-*/
-function isArbitraryParentSelectorStateToken(token) {
-	if (token.startsWith("[&")) return true;
-	if (!token.startsWith("[")) return false;
-	const colonIdx = indexOfFirstVariantColon(token);
-	if (colonIdx === -1 || colonIdx === 0 || token[colonIdx - 1] !== "]") return false;
-	return token.slice(0, colonIdx).includes("&");
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function classifyToken(token) {
-	if (isArbitraryParentSelectorStateToken(token)) return "selector";
-	if (isSelectorVariantToken(token)) return "selector";
-	if (/^@container(?:\/[a-z][a-z0-9-]*)?$/i.test(token)) return "existence";
-	if (token.startsWith("[")) {
-		const splitIdx = indexOfFirstVariantColon(token);
-		if (splitIdx === -1) return "arbitrary";
-		if (splitIdx === 0 || token[splitIdx - 1] !== "]") return "arbitrary";
-	}
-	if (firstLeadingVariantPrefix(token) === "starting") return "starting";
-	if (isStateToken(token)) return "state";
-	return classifyBareUtility(stripVariants(token));
-}
-/**
-* Stable key for `data-[…]` variants so unrelated selectors stay split, while
-* **branching on the full bracket** (e.g. `data-[vaul-drawer-direction=bottom]`
-* vs `=left`) keeps direction-specific utilities in separate state groups.
-*/
-function dataAttributeStem(token) {
-	const match = token.match(/^data-\[([^\]]*)\]/);
-	return match ? `data-[${match[1]}]` : "data";
-}
-/**
-* Same idea as {@link dataAttributeStem} for `aria-[…]:` variants.
-*/
-function ariaAttributeStem(token) {
-	const match = token.match(/^aria-\[([^\]]*)\]/);
-	return match ? `aria-[${match[1]}]` : "aria";
-}
-/**
-* `in-data-[…]:` — normalize on the full bracket expression like {@link dataAttributeStem}.
-*/
-function inDataAttributeStem(token) {
-	const match = token.match(/^in-data-\[([^\]]*)\]/);
-	return match ? `in-data-[${match[1]}]` : "in-data";
-}
-/**
-* Stable key for splitting adjacent `state` / `starting` tokens in {@link suggestCnGroups}
-* (`selector` uses {@link selectorKey}).
-* Uses the **full variant stack** (every `:` segment outside `[…]`), not only the
-* outermost prefix, so `@md/foo:[&>*]:w-auto` and `@md/foo:has-[…]:mt-px` stay in
-* separate groups while `hover:opacity` still keys as `hover` + `opacity`…
-*
-* `data-[…]` / `aria-[…]` normalize the first segment via {@link dataAttributeStem} /
-* {@link ariaAttributeStem} (full token required for bracket capture).
-*
-* @since 0.3.16-canary.0
-*/
-function stateKey(token) {
-	const layers = [];
-	let rest = token;
-	while (rest.length > 0) {
-		const colonIdx = indexOfFirstVariantColon(rest);
-		if (colonIdx === -1) break;
-		layers.push(rest.slice(0, colonIdx));
-		rest = rest.slice(colonIdx + 1);
-	}
-	if (layers.length === 0) return token;
-	const firstLayer = layers[0];
-	if (firstLayer === void 0) return token;
-	if (firstLayer.startsWith("data-[")) layers[0] = dataAttributeStem(token);
-	else if (firstLayer.startsWith("aria-[")) layers[0] = ariaAttributeStem(token);
-	else if (firstLayer.startsWith("in-data-[")) layers[0] = inDataAttributeStem(token);
-	return layers.join("");
-}
-const SELECTOR_KEY_SEP = "";
-/**
-* Variant key for {@link Bucket} `"selector"` tokens in {@link suggestCnGroups}.
-* Reuses {@link stateKey} layer splitting, then normalizes common Radix SVG patterns so
-* `[&_svg]:…` and `[&_svg:not([class*='size-'])]:…` stay in one chunk.
-*
-* @since 0.3.16-canary.0
-*/
-function selectorKey(token) {
-	return stateKey(token).split(SELECTOR_KEY_SEP).map(normalizeSelectorVariantLayer).join(SELECTOR_KEY_SEP);
-}
-function normalizeSelectorVariantLayer(layer) {
-	if (layer === "[&_svg:not([class*='size-'])]") return "[&_svg]";
-	return layer;
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function bucketsCompatible(a, b) {
-	if (a === b) return true;
-	return COMPATIBLE_BUCKET_SETS.some((bucketSet) => bucketSet.has(a) && bucketSet.has(b));
-}
-/**
-* Like {@link bucketsCompatible}, but never merge two distinct state / starting / selector variant blobs.
-*
-* @since 0.3.16-canary.0
-*/
-function bucketsMergeCompatible(a, b) {
-	if (a === "state" && b === "state") return false;
-	if (a === "starting" && b === "starting") return false;
-	if (a === "selector" && b === "selector") return false;
-	if (a === "arbitrary" || b === "arbitrary") return false;
-	return bucketsCompatible(a, b);
-}
-//#endregion
-export { bucketsCompatible, bucketsMergeCompatible, classifyToken, compositeSecondaryOrder, selectorKey, stateKey };

package/dist/arrange/domain/types.mjs

@@ -1 +0,0 @@
-export {};

package/dist/arrange/output.mjs

@@ -1,87 +0,0 @@
-import "./domain/constants.mjs";
-import { lineOf } from "./domain/ast/helpers.mjs";
-import { logger } from "../core/logger.mjs";
-import path from "node:path";
-//#region src/arrange/output.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function printAnalyzeReport(resolvedTargetPath, report) {
-	logger.out(`Path: ${path.resolve(resolvedTargetPath)}`);
-	logger.out(`.ts/.tsx files: ${report.files}`);
-	logger.out(`cn(...) call sites: ${report.cnCallExpressions}`);
-	logger.out(`tv(...) call sites: ${report.tvCallExpressions}`);
-	logger.out(`\nLong cn(...) string literals (≥18 tokens — consider splitting arguments): ${report.longCnStringLiterals.length}`);
-	for (const findingEntry of report.longCnStringLiterals.slice(0, 40)) logger.out(`  ${findingEntry.file}:${findingEntry.line}  (${findingEntry.tokenCount} tokens)  ${findingEntry.preview}`);
-	if (report.longCnStringLiterals.length > 40) logger.out(`  … and ${report.longCnStringLiterals.length - 40} more`);
-	logger.out(`\nLong tv({...}) string literals in base/variants/… (≥18 tokens): ${report.longTvStringLiterals.length}`);
-	for (const findingEntry of report.longTvStringLiterals.slice(0, 40)) logger.out(`  ${findingEntry.file}:${findingEntry.line}  (${findingEntry.tokenCount} tokens)  ${findingEntry.preview}`);
-	if (report.longTvStringLiterals.length > 40) logger.out(`  … and ${report.longTvStringLiterals.length - 40} more`);
-	logger.out(`\nJSX className="..." or className={'...'} (static strings, ≥18 tokens): ${report.longJsxClassNameLiterals.length}`);
-	for (const findingEntry of report.longJsxClassNameLiterals.slice(0, 40)) logger.out(`  ${findingEntry.file}:${findingEntry.line}  (${findingEntry.tokenCount} tokens)  ${findingEntry.preview}`);
-	if (report.longJsxClassNameLiterals.length > 40) logger.out(`  … and ${report.longJsxClassNameLiterals.length - 40} more`);
-	logger.out(`\ncn(...) nested inside tv({...}) (prefer a string or array — preview/apply can rewrite): ${report.cnInsideTvCalls.length}`);
-	for (const findingEntry of report.cnInsideTvCalls.slice(0, 40)) logger.out(`  ${findingEntry.file}:${findingEntry.line}  (${findingEntry.argCount} args)  ${findingEntry.preview}`);
-	if (report.cnInsideTvCalls.length > 40) logger.out(`  … and ${report.cnInsideTvCalls.length - 40} more`);
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function printSyncResult(result, write) {
-	logger.out(`\nTotal: ${result.filePaths.length} file(s), ${result.totalFound} site(s) (cn/tv/JSX className) to review.`);
-	if (write) logger.out(`Applied: ${result.totalChanged} site(s) updated.`);
-	else logger.out(`(Re-run without --dry-run to write changes, or "pnpm cli:arrange" / "pnpm exec codefast arrange")`);
-	if (write ? result.totalChanged > 0 : result.totalFound > 0) logger.out("Note: class order may change across concern groups — smoke-test the UI if you rely on cascade order.");
-	if (result.hookError !== null) logger.err(result.hookError);
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function printSimplifyResult(result, write) {
-	logger.out(`\nTotal: ${result.filePaths.length} file(s), ${result.totalFound} site(s) to simplify.`);
-	if (write) logger.out(`Applied: ${result.totalChanged} site(s) updated.`);
-	else logger.out(`(Run "simplify" to write changes, or "pnpm cli:arrange-simplify" / "pnpm exec codefast arrange simplify")`);
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function printGroupFilePreviewFromWork(work) {
-	printGroupFilePreviewBody({
-		filePath: work.filePath,
-		reportTotal: work.reportTotal,
-		cnInTvNoReplacement: work.cnInTvNoReplacement,
-		cnInTvCalls: work.cnInTvCalls,
-		unwrapReplacementByCall: work.unwrapReplacementByCall,
-		sourceText: work.sourceText,
-		domainSf: work.domainSfForLineNumbers,
-		unwrapEdits: work.unwrapEdits,
-		plannedGroupEdits: work.plannedGroupEdits
-	});
-}
-function printGroupFilePreviewBody(args) {
-	const { filePath, reportTotal, cnInTvNoReplacement, cnInTvCalls, unwrapReplacementByCall, sourceText, domainSf, unwrapEdits, plannedGroupEdits } = args;
-	let header = `\n── ${filePath} (${reportTotal} site(s)`;
-	if (cnInTvNoReplacement > 0) header += `; plus ${cnInTvNoReplacement} cn() inside tv left unchanged (0 args)`;
-	header += `) ──`;
-	logger.out(header);
-	for (const call of cnInTvCalls) {
-		const replacement = unwrapReplacementByCall.get(call);
-		if (replacement === void 0) {
-			logger.out(`  Line ${lineOf(domainSf, call)} [tv ⊃ cn]: cn(...) has no arguments — skipped`);
-			continue;
-		}
-		const start = call.pos;
-		const end = call.end;
-		if (sourceText.slice(start, end) === replacement) continue;
-		logger.out(`  Line ${lineOf(domainSf, call)} [tv ⊃ cn → string/array]:`);
-		logger.out(`  ${replacement.split("\n").join("\n  ")}`);
-	}
-	if (unwrapEdits.length > 0 && plannedGroupEdits.length > 0) logger.out("  ([cn] / [tv] / [JSX className] lines below reflect content after unwrap of cn inside tv.)");
-	for (const plan of plannedGroupEdits) {
-		logger.out(`  Line ${lineOf(plan.lineSf, plan.reportNode)} [${plan.label}]:`);
-		logger.out(`  ${plan.replacement.split("\n").join("\n  ")}`);
-		logger.out(`  // Buckets: ${JSON.stringify(plan.bucketSummary)}`);
-	}
-}
-//#endregion
-export { printAnalyzeReport, printGroupFilePreviewFromWork, printSimplifyResult, printSyncResult };

package/dist/arrange/process-file.mjs

@@ -1,42 +0,0 @@
-import { parseDomainSourceFile } from "./source-parse.mjs";
-import { ensureCnImport } from "./domain/imports.mjs";
-import { buildGroupFileUnwrapState, countPersistedGroupFileEdits, groupFileDryRunNoEdits, groupFileEditsTouchJsxCn, groupFilePreviewTotals, groupFileWorkHasNothingToReport, mergeGroupFileBodyText, tryBuildGroupFileWorkPlan } from "./domain/grouping-service.mjs";
-//#region src/arrange/process-file.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function processArrangeGroupFile(fs, args) {
-	const { filePath, options } = args;
-	const sourceText = fs.readFileSync(filePath, "utf8");
-	const domainSfInitial = parseDomainSourceFile(filePath, sourceText);
-	const unwrap = buildGroupFileUnwrapState(domainSfInitial, sourceText);
-	const work = tryBuildGroupFileWorkPlan({
-		filePath,
-		sourceText,
-		domainSfInitial,
-		domainSfGrouped: parseDomainSourceFile(filePath, unwrap.textAfterUnwrap),
-		withClassName: options.withClassName,
-		unwrap
-	});
-	if (work === null) return groupFileDryRunNoEdits(filePath);
-	if (!options.write) {
-		if (groupFileWorkHasNothingToReport(work)) return groupFileDryRunNoEdits(filePath);
-		return {
-			...groupFilePreviewTotals(work),
-			workPlan: work
-		};
-	}
-	const persistedEditCount = countPersistedGroupFileEdits(work);
-	let newText = mergeGroupFileBodyText(work);
-	if (persistedEditCount > 0) {
-		if (groupFileEditsTouchJsxCn(work)) newText = ensureCnImport(parseDomainSourceFile(filePath, newText), options.cnImport);
-		fs.writeFileSync(filePath, newText, "utf8");
-	}
-	return {
-		filePath,
-		totalFound: persistedEditCount + work.cnInTvNoReplacement,
-		changed: persistedEditCount
-	};
-}
-//#endregion
-export { processArrangeGroupFile };

package/dist/arrange/resolve-target.mjs

@@ -1,24 +0,0 @@
-import path from "node:path";
-//#region src/arrange/resolve-target.ts
-const packageJsonFileName = "package.json";
-/**
-* @since 0.3.16-canary.0
-*/
-function resolveArrangeTargetPath(fs, args) {
-	const explicitTargetPath = args.rawTarget ? path.isAbsolute(args.rawTarget) ? path.resolve(args.rawTarget) : path.resolve(args.currentWorkingDirectory, args.rawTarget) : void 0;
-	if (explicitTargetPath) return fs.canonicalPathSync(explicitTargetPath);
-	const resolvedDefaultTarget = findNearestPackageDirectory(fs, args.currentWorkingDirectory) ?? args.currentWorkingDirectory;
-	return fs.canonicalPathSync(resolvedDefaultTarget);
-}
-function findNearestPackageDirectory(fs, currentWorkingDirectory) {
-	let currentDir = path.resolve(currentWorkingDirectory);
-	while (true) {
-		const packageJsonPath = path.join(currentDir, packageJsonFileName);
-		if (fs.existsSync(packageJsonPath)) return currentDir;
-		const parentDirectory = path.dirname(currentDir);
-		if (parentDirectory === currentDir) return;
-		currentDir = parentDirectory;
-	}
-}
-//#endregion
-export { resolveArrangeTargetPath };

package/dist/arrange/scan-target.mjs

@@ -1,29 +0,0 @@
-import { messageFrom } from "../core/errors.mjs";
-import { logger } from "../core/logger.mjs";
-import { walkTsxFiles } from "../core/workspace/typescript-walk.mjs";
-import path from "node:path";
-//#region src/arrange/scan-target.ts
-const TEST_FILE_PATTERN = /\.(?:test|spec)\.[cm]?[jt]sx?$/;
-/**
-* Test/spec files are excluded from directory scans: arrange rewrites class strings,
-* and a `cn(...)` inside an assertion (e.g. `expect(cn("a", "b"))`) is intentional test
-* data, not styling to reformat. An explicit single-file target is still honored.
-*/
-function isTestFile(filePath) {
-	return TEST_FILE_PATTERN.test(path.basename(filePath));
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function scanArrangeTargets(fs, targetPath) {
-	const resolvedTargetPath = path.resolve(targetPath);
-	if (fs.statSync(resolvedTargetPath).isDirectory()) try {
-		return walkTsxFiles(resolvedTargetPath, fs).filter((filePath) => !isTestFile(filePath));
-	} catch (caughtError) {
-		logger.err(`[file-walker] ${messageFrom(caughtError)}`);
-		throw caughtError;
-	}
-	return [resolvedTargetPath];
-}
-//#endregion
-export { scanArrangeTargets };

package/dist/arrange/simplify-process-file.mjs

@@ -1,35 +0,0 @@
-import { applyEditsDescending } from "../core/source-text-edit.mjs";
-import { parseDomainSourceFile } from "./source-parse.mjs";
-import { collectSimplifyTargets } from "./domain/ast/simplify-targets.mjs";
-import { dropCnImportIfUnused } from "./domain/imports.mjs";
-//#region src/arrange/simplify-process-file.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function processArrangeSimplifyFile(fs, args) {
-	const { filePath, write } = args;
-	const sourceText = fs.readFileSync(filePath, "utf8");
-	const meaningful = collectSimplifyTargets(parseDomainSourceFile(filePath, sourceText)).filter((edit) => sourceText.slice(edit.start, edit.end) !== edit.replacement);
-	const textAfterEdits = meaningful.length > 0 ? applyEditsDescending(sourceText, meaningful) : sourceText;
-	const textAfterImportDrop = dropCnImportIfUnused(parseDomainSourceFile(filePath, textAfterEdits));
-	const importDropped = textAfterImportDrop !== textAfterEdits;
-	const totalFound = meaningful.length + (importDropped ? 1 : 0);
-	if (totalFound === 0) return {
-		filePath,
-		totalFound: 0,
-		changed: 0
-	};
-	if (!write) return {
-		filePath,
-		totalFound,
-		changed: 0
-	};
-	fs.writeFileSync(filePath, textAfterImportDrop, "utf8");
-	return {
-		filePath,
-		totalFound,
-		changed: totalFound
-	};
-}
-//#endregion
-export { processArrangeSimplifyFile };

package/dist/arrange/simplify-sync.mjs

@@ -1,32 +0,0 @@
-import { scanArrangeTargets } from "./scan-target.mjs";
-import { ok } from "../core/result.mjs";
-import { processArrangeSimplifyFile } from "./simplify-process-file.mjs";
-//#region src/arrange/simplify-sync.ts
-/**
-* @since 0.3.16-canary.0
-*/
-async function runArrangeSimplify(fs, args) {
-	const filePaths = scanArrangeTargets(fs, args.targetPath);
-	const modifiedFiles = [];
-	let totalFound = 0;
-	let totalChanged = 0;
-	for (const filePath of filePaths) {
-		const result = processArrangeSimplifyFile(fs, {
-			filePath,
-			write: args.write
-		});
-		totalFound += result.totalFound;
-		totalChanged += result.changed;
-		if (result.changed > 0) modifiedFiles.push(result.filePath);
-	}
-	return ok({
-		filePaths,
-		modifiedFiles,
-		totalFound,
-		totalChanged,
-		hookError: null,
-		previewPlans: []
-	});
-}
-//#endregion
-export { runArrangeSimplify };

package/dist/arrange/source-parse.mjs

@@ -1,18 +0,0 @@
-import { messageFrom } from "../core/errors.mjs";
-import { logger } from "../core/logger.mjs";
-import { TypeScriptAstTranslator } from "./typescript-ast-translator.mjs";
-//#region src/arrange/source-parse.ts
-const translator = new TypeScriptAstTranslator();
-/**
-* @since 0.3.16-canary.0
-*/
-function parseDomainSourceFile(filePath, sourceText) {
-	try {
-		return translator.translateSourceFile(filePath, sourceText);
-	} catch (caughtError) {
-		logger.err(`[domain-source-parser] ${messageFrom(caughtError)}`);
-		throw caughtError;
-	}
-}
-//#endregion
-export { parseDomainSourceFile };

package/dist/arrange/suggest.mjs

@@ -1,15 +0,0 @@
-import { formatArray, formatCnCall } from "./domain/source-text-formatters.mjs";
-import { suggestCnGroups, summarizeGroupBucketLabels } from "./domain/grouping.mjs";
-//#region src/arrange/suggest.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function suggestCnGroupsFromCli(request) {
-	const groups = suggestCnGroups(request.inlineClasses);
-	return {
-		primaryLine: request.emitTvStyleArray ? formatArray(groups) : formatCnCall(groups, { trailingClassName: request.trailingClassName }),
-		bucketsCommentLine: `// Buckets: ${JSON.stringify(summarizeGroupBucketLabels(groups))}`
-	};
-}
-//#endregion
-export { suggestCnGroupsFromCli };

package/dist/arrange/sync.mjs

@@ -1,51 +0,0 @@
-import { messageFrom } from "../core/errors.mjs";
-import { scanArrangeTargets } from "./scan-target.mjs";
-import { ok } from "../core/result.mjs";
-import { processArrangeGroupFile } from "./process-file.mjs";
-//#region src/arrange/sync.ts
-async function runOnAfterWriteHook(hook, modifiedFiles) {
-	if (!hook || modifiedFiles.length === 0) return null;
-	try {
-		await hook({ files: modifiedFiles });
-		return null;
-	} catch (caughtHookError) {
-		return `[arrange] onAfterWrite hook failed: ${messageFrom(caughtHookError)}`;
-	}
-}
-/**
-* @since 0.3.16-canary.0
-*/
-async function runArrangeSync(fs, request) {
-	const filePaths = scanArrangeTargets(fs, request.targetPath);
-	const modifiedFiles = [];
-	const previewPlans = [];
-	let totalFound = 0;
-	let totalChanged = 0;
-	const groupOptions = {
-		write: request.write,
-		withClassName: !!request.withClassName,
-		cnImport: request.cnImport
-	};
-	for (const filePath of filePaths) {
-		const fileProcessResult = processArrangeGroupFile(fs, {
-			filePath,
-			options: groupOptions
-		});
-		totalFound += fileProcessResult.totalFound;
-		totalChanged += fileProcessResult.changed;
-		if (fileProcessResult.changed > 0) modifiedFiles.push(fileProcessResult.filePath);
-		if (fileProcessResult.workPlan) previewPlans.push(fileProcessResult.workPlan);
-	}
-	const arrangeConfig = request.config;
-	const hookError = request.write && modifiedFiles.length > 0 ? await runOnAfterWriteHook(arrangeConfig?.onAfterWrite, modifiedFiles) : null;
-	return ok({
-		filePaths,
-		modifiedFiles,
-		totalFound,
-		totalChanged,
-		hookError,
-		previewPlans
-	});
-}
-//#endregion
-export { runArrangeSync };