@codefast/cli 0.9.0 → 0.10.0

package/dist/arrange/analyze.d.ts

@@ -0,0 +1,10 @@
+import type { AnalyzeReport } from "#/arrange/domain/types";
+import { AppError } from "#/core/errors";
+import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Result } from "#/core/result";
+/**
+ * Scans a directory's arrange targets and returns the accumulated analyze report.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function analyzeDirectory(fs: FilesystemPort, analyzeRootPath: string): Result<AnalyzeReport, AppError>;

package/dist/arrange/cli-schema.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+/**
+ * The request payload for `arrange analyze`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type ArrangeAnalyzeDirectoryRequest = {
+    analyzeRootPath: string;
+};
+/**
+ * The request payload for a top-level `arrange` run.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type ArrangeSyncRunRequest = {
+    rootDir: string;
+    targetPath: string;
+    write: boolean;
+    withClassName?: boolean | undefined;
+    cnImport?: string | undefined;
+    config?: unknown;
+};
+/**
+ * The request payload for `arrange group`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type ArrangeSuggestGroupsRequest = {
+    inlineClasses: string;
+    emitTvStyleArray: boolean;
+    trailingClassName: boolean;
+};
+/**
+ * The `zod` schema validating an `arrange analyze` request.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare const arrangeAnalyzeDirectoryRequestSchema: z.ZodType<ArrangeAnalyzeDirectoryRequest>;
+/**
+ * The `zod` schema validating an `arrange` run request.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare const arrangeSyncRunRequestSchema: z.ZodType<ArrangeSyncRunRequest>;
+/**
+ * The `zod` schema validating an `arrange group` request.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare const arrangeSuggestGroupsRequestSchema: z.ZodType<ArrangeSuggestGroupsRequest>;

package/dist/arrange/command.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+/**
+ * Creates the `arrange` command and its subcommands.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function createArrangeCommand(): Command;

package/dist/arrange/domain/analyze-service.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Rich domain: Tailwind/cn/tv analysis rules (counts, long literals, nested cn in tv).
+ * Pure orchestration of domain collectors and invariants — no I/O.
+ */
+import type { DomainSourceFile } from "#/arrange/domain/ast/ast-node";
+import type { AnalyzeReport } from "#/arrange/domain/types";
+/**
+ * Creates a zeroed analyze report ready for accumulation.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function createEmptyAnalyzeReport(): AnalyzeReport;
+/**
+ * Accumulates findings for one parsed source file into `report` (mutates report).
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function accumulateAnalyzeReportForSourceFile(report: AnalyzeReport, domainSf: DomainSourceFile, sourceText: string, filePath: string): void;

package/dist/arrange/domain/ast/ast-node.d.ts

@@ -0,0 +1,394 @@
+/**
+ * Pure-domain AST shapes for arrange analysis. No TypeScript compiler types.
+ * Positions mirror `getStart(sourceFile)` / `getEnd()` semantics from translation.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare enum DomainSyntaxKind {
+    Unknown = 1,
+    Identifier = 2,
+    StringLiteral = 3,
+    NoSubstitutionTemplateLiteral = 4,
+    ImportDeclaration = 5,
+    ImportClause = 6,
+    NamedImports = 7,
+    NamespaceImport = 8,
+    ImportSpecifier = 9,
+    CallExpression = 10,
+    PropertyAccessExpression = 11,
+    ObjectLiteralExpression = 12,
+    PropertyAssignment = 13,
+    ArrayLiteralExpression = 14,
+    SpreadElement = 15,
+    ParenthesizedExpression = 16,
+    AsExpression = 17,
+    SatisfiesExpression = 18,
+    NonNullExpression = 19,
+    ConditionalExpression = 20,
+    BinaryExpression = 21,
+    ExpressionStatement = 22,
+    JsxAttribute = 23,
+    JsxExpression = 24
+}
+/**
+ * The binary operators the domain AST distinguishes.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare enum DomainBinaryOperator {
+    Plus = 0,
+    Other = 1
+}
+/**
+ * The pure-domain counterpart of a parsed source file.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainSourceFile {
+    readonly fileName: string;
+    readonly text: string;
+    readonly statements: ReadonlyArray<DomainAstNode>;
+}
+interface DomainNodeBase {
+    readonly kind: DomainSyntaxKind;
+    readonly pos: number;
+    readonly end: number;
+    readonly parent: DomainAstNode | null;
+}
+/**
+ * A node kind the translator does not model, retained only for its children.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainUnknownAstNode extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.Unknown;
+    readonly children: ReadonlyArray<DomainAstNode>;
+}
+/**
+ * An identifier node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainIdentifier extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.Identifier;
+    readonly text: string;
+}
+/**
+ * A string literal node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainStringLiteral extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.StringLiteral;
+    readonly text: string;
+}
+/**
+ * A template literal without substitutions.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainNoSubstitutionTemplateLiteral extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.NoSubstitutionTemplateLiteral;
+    readonly text: string;
+}
+/**
+ * An `import` declaration node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainImportDeclaration extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.ImportDeclaration;
+    readonly importClause: DomainImportClause | undefined;
+    readonly moduleSpecifier: DomainAstNode;
+}
+/**
+ * The clause of an import declaration — default name plus named or namespace bindings.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainImportClause extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.ImportClause;
+    readonly isTypeOnly: boolean;
+    readonly name: DomainIdentifier | undefined;
+    readonly namedBindings: DomainNamedImports | DomainNamespaceImport | undefined;
+}
+/**
+ * The named-bindings list of an import clause.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainNamedImports extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.NamedImports;
+    readonly elements: ReadonlyArray<DomainImportSpecifier>;
+}
+/**
+ * A namespace (`* as name`) import binding.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainNamespaceImport extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.NamespaceImport;
+    readonly name: DomainIdentifier;
+}
+/**
+ * A single named-import specifier.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainImportSpecifier extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.ImportSpecifier;
+    readonly name: DomainIdentifier;
+    readonly propertyName: DomainIdentifier | undefined;
+}
+/**
+ * A call expression node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainCallExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.CallExpression;
+    readonly expression: DomainAstNode;
+    readonly arguments: ReadonlyArray<DomainAstNode>;
+}
+/**
+ * A property access (`object.name`) node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainPropertyAccessExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.PropertyAccessExpression;
+    readonly expression: DomainAstNode;
+    readonly name: DomainIdentifier;
+}
+/**
+ * An object literal node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainObjectLiteralExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.ObjectLiteralExpression;
+    readonly properties: ReadonlyArray<DomainAstNode>;
+}
+/**
+ * A `name: value` property inside an object literal.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainPropertyAssignment extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.PropertyAssignment;
+    readonly name: DomainAstNode;
+    readonly initializer: DomainAstNode;
+}
+/**
+ * An array literal node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainArrayLiteralExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.ArrayLiteralExpression;
+    readonly elements: ReadonlyArray<DomainAstNode>;
+}
+/**
+ * A spread (`...expression`) element node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainSpreadElement extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.SpreadElement;
+    readonly expression: DomainAstNode;
+}
+/**
+ * A parenthesized expression node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainParenthesizedExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.ParenthesizedExpression;
+    readonly expression: DomainAstNode;
+}
+/**
+ * An `as` type-assertion node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainAsExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.AsExpression;
+    readonly expression: DomainAstNode;
+}
+/**
+ * A `satisfies` expression node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainSatisfiesExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.SatisfiesExpression;
+    readonly expression: DomainAstNode;
+}
+/**
+ * A non-null assertion (`expression!`) node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainNonNullExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.NonNullExpression;
+    readonly expression: DomainAstNode;
+}
+/**
+ * A ternary conditional node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainConditionalExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.ConditionalExpression;
+    readonly condition: DomainAstNode;
+    readonly whenTrue: DomainAstNode;
+    readonly whenFalse: DomainAstNode;
+}
+/**
+ * A binary expression node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainBinaryExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.BinaryExpression;
+    readonly left: DomainAstNode;
+    readonly operator: DomainBinaryOperator;
+    readonly right: DomainAstNode;
+}
+/**
+ * An expression statement node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainExpressionStatement extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.ExpressionStatement;
+    readonly expression: DomainAstNode;
+}
+/**
+ * A JSX attribute node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainJsxAttribute extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.JsxAttribute;
+    readonly name: DomainAstNode;
+    readonly initializer: DomainAstNode | undefined;
+}
+/**
+ * A JSX expression container node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DomainJsxExpression extends DomainNodeBase {
+    readonly kind: DomainSyntaxKind.JsxExpression;
+    readonly expression: DomainAstNode | undefined;
+}
+/**
+ * The union of every node shape the domain AST models.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type DomainAstNode = DomainUnknownAstNode | DomainIdentifier | DomainStringLiteral | DomainNoSubstitutionTemplateLiteral | DomainImportDeclaration | DomainImportClause | DomainNamedImports | DomainNamespaceImport | DomainImportSpecifier | DomainCallExpression | DomainPropertyAccessExpression | DomainObjectLiteralExpression | DomainPropertyAssignment | DomainArrayLiteralExpression | DomainSpreadElement | DomainParenthesizedExpression | DomainAsExpression | DomainSatisfiesExpression | DomainNonNullExpression | DomainConditionalExpression | DomainBinaryExpression | DomainExpressionStatement | DomainJsxAttribute | DomainJsxExpression;
+/**
+ * A literal node that can carry a Tailwind class string.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type DomainTailwindClassLiteral = DomainStringLiteral | DomainNoSubstitutionTemplateLiteral;
+/**
+ * Narrows a node to `DomainIdentifier`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainIdentifier(node: DomainAstNode): node is DomainIdentifier;
+/**
+ * Narrows a node to `DomainStringLiteral`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainStringLiteral(node: DomainAstNode): node is DomainStringLiteral;
+/**
+ * Narrows a node to a literal that can carry Tailwind classes.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainTailwindClassLiteral(node: DomainAstNode): node is DomainTailwindClassLiteral;
+/**
+ * Narrows a node to `DomainImportDeclaration`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainImportDeclaration(node: DomainAstNode): node is DomainImportDeclaration;
+/**
+ * Narrows a node to `DomainNamedImports`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainNamedImports(node: DomainAstNode): node is DomainNamedImports;
+/**
+ * Narrows a node to `DomainNamespaceImport`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainNamespaceImport(node: DomainAstNode): node is DomainNamespaceImport;
+/**
+ * Narrows a node to `DomainCallExpression`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainCallExpression(node: DomainAstNode): node is DomainCallExpression;
+/**
+ * Narrows a node to `DomainObjectLiteralExpression`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainObjectLiteralExpression(node: DomainAstNode): node is DomainObjectLiteralExpression;
+/**
+ * Narrows a node to `DomainPropertyAssignment`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainPropertyAssignment(node: DomainAstNode): node is DomainPropertyAssignment;
+/**
+ * Narrows a node to `DomainArrayLiteralExpression`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainArrayLiteralExpression(node: DomainAstNode): node is DomainArrayLiteralExpression;
+/**
+ * Narrows a node to `DomainSpreadElement`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainSpreadElement(node: DomainAstNode): node is DomainSpreadElement;
+/**
+ * Narrows a node to `DomainPropertyAccessExpression`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainPropertyAccessExpression(node: DomainAstNode): node is DomainPropertyAccessExpression;
+/**
+ * Narrows a node to `DomainJsxAttribute`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainJsxAttribute(node: DomainAstNode): node is DomainJsxAttribute;
+/**
+ * Narrows a node to `DomainJsxExpression`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isDomainJsxExpression(node: DomainAstNode): node is DomainJsxExpression;
+/**
+ * Visits each direct child of a domain node.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function forEachDomainChild(node: DomainAstNode, visit: (child: DomainAstNode) => void): void;
+/**
+ * Resolves the one-based line number of a position in source text.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function lineOfSourcePosition(sourceText: string, pos: number): number;
+export {};

package/dist/arrange/domain/ast/collectors-cn.d.ts

@@ -0,0 +1,26 @@
+import type { DomainAstNode } from "#/arrange/domain/ast/ast-node";
+import type { ForEachStringLiteralInClassExpressionOptions, TailwindClassLiteral } from "#/arrange/domain/types";
+/**
+ * Visits every static class literal reachable inside a class expression.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function forEachStringLiteralInClassExpression(expr: DomainAstNode, sink: (classLiteral: TailwindClassLiteral) => void, depth?: number, options?: ForEachStringLiteralInClassExpressionOptions): void;
+/**
+ * Checks whether a literal sits directly inside an array literal, where splitting it apart is unsafe.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isUnsafeLiteralForCnStyleApplySplit(classLiteral: TailwindClassLiteral): boolean;
+/**
+ * The walk options for building the `cn` apply pool — conditional branches are never descended into.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare const CN_APPLY_LITERAL_WALK_OPTS: ForEachStringLiteralInClassExpressionOptions;
+/**
+ * Collects the static class literals in `cn()` arguments that are safe to regroup.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function collectUnconditionalTailwindLiteralsFromCnArguments(args: ReadonlyArray<DomainAstNode>): Array<TailwindClassLiteral>;

package/dist/arrange/domain/ast/collectors-jsx.d.ts

@@ -0,0 +1,8 @@
+import type { DomainJsxAttribute } from "#/arrange/domain/ast/ast-node";
+import type { JsxClassNameStatic } from "#/arrange/domain/types";
+/**
+ * Extracts the static literal of a JSX `className` attribute, or `undefined` when it is not static.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function jsxClassNameStaticLiteral(jsxClassNameAttribute: DomainJsxAttribute): JsxClassNameStatic | undefined;

package/dist/arrange/domain/ast/collectors-tv.d.ts

@@ -0,0 +1,34 @@
+import type { DomainCallExpression, DomainObjectLiteralExpression, DomainSourceFile } from "#/arrange/domain/ast/ast-node";
+import type { StringNode, TailwindClassLiteral } from "#/arrange/domain/types";
+type StringNodeVisitor = (classLiteral: TailwindClassLiteral, sourceFile: DomainSourceFile, cnCall?: DomainCallExpression) => void;
+/**
+ * Visits every class literal reachable inside a `tv({ ... })` object, including `cn()` arguments.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function traverseTvObject(sourceFile: DomainSourceFile, obj: DomainObjectLiteralExpression, visitor: StringNodeVisitor, depth?: number, knownBindings?: Set<string>): void;
+/**
+ * Collects the `cn()` calls nested inside a `tv({ ... })` object.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function collectCnCallsInsideTv(sourceFile: DomainSourceFile, obj: DomainObjectLiteralExpression, knownBindings: Set<string>, depth?: number): Array<DomainCallExpression>;
+/**
+ * Collects every `cn()` call nested inside any `tv()` call in a source file.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function listAllCnCallsInsideTvInSourceFile(sourceFile: DomainSourceFile, knownBindings: Set<string>): Array<DomainCallExpression>;
+/**
+ * Joins a slot's literals into one space-separated class string.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function slotClassString(stringNode: StringNode): string;
+/**
+ * Collects every groupable `cn()` / `tv()` string slot in a source file.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function collectGroupableStringNodes(sourceFile: DomainSourceFile): Array<StringNode>;
+export {};

package/dist/arrange/domain/ast/helpers.d.ts

@@ -0,0 +1,36 @@
+import type { DomainAstNode, DomainCallExpression, DomainPropertyAssignment, DomainSourceFile } from "#/arrange/domain/ast/ast-node";
+import { applyEditsDescending } from "#/core/source-text-edit";
+/**
+ * Builds a set of local binding names that are imported from a known cn/tv
+ * module in `sourceFile`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function buildKnownCnTvBindings(sourceFile: DomainSourceFile): Set<string>;
+/**
+ * Returns true when `expr` is an identifier whose name matches `name` AND
+ * that name is listed in `knownBindings` from a recognized import.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function isCnOrTvIdentifier(expr: DomainAstNode, name: "cn" | "tv", knownBindings?: Set<string>): boolean;
+/**
+ * Resolves a property assignment's name text, or `undefined` for computed names.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function propertyAssignmentNameText(prop: DomainPropertyAssignment): string | undefined;
+/**
+ * Resolves the one-based line number a node starts on.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function lineOf(sourceFile: DomainSourceFile, node: DomainAstNode): number;
+export { applyEditsDescending };
+/**
+ * Replace `cn(...)` nested in `tv({...})` with a plain string (one arg) or a string
+ * array (multiple args). Returns undefined when there are zero arguments.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function unwrapCnInsideTvCallReplacement(call: DomainCallExpression, sourceText: string): string | undefined;

package/dist/arrange/domain/ast/helpers.js

@@ -12,6 +12,7 @@ const KNOWN_CN_TV_MODULES = new Set([
     // from "tailwind-variants"; new code should prefer "@codefast/tailwind-variants".
     "tailwind-variants",
     "#lib/utils",
+    "#/lib/utils",
     "~/lib/utils",
     "@/lib/utils",
 ]);

package/dist/arrange/domain/ast/simplify-targets.d.ts

@@ -0,0 +1,22 @@
+import type { DomainSourceFile } from "#/arrange/domain/ast/ast-node";
+/**
+ * A planned text replacement produced by the simplify pass.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type PlannedSimplifyEdit = {
+    start: number;
+    end: number;
+    replacement: string;
+    label: string;
+};
+/**
+ * Collects all simplify edits for a source file:
+ * - Arrays of pure string literals inside tv() slots → flat string
+ * - cn() calls whose every argument is a static string literal → flat string (unwrap cn)
+ * - cn() calls with mixed static + dynamic args → merge adjacent statics into one string
+ * - JSX `className={cn(...all-static...)}` → `className="flat string"`
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function collectSimplifyTargets(sourceFile: DomainSourceFile): Array<PlannedSimplifyEdit>;

package/dist/arrange/domain/ast/targets.d.ts

@@ -0,0 +1,20 @@
+import type { DomainSourceFile } from "#/arrange/domain/ast/ast-node";
+import type { GroupTarget, PlannedGroupEdit } from "#/arrange/domain/types";
+/**
+ * Resolves the source position where a group target's replacement begins.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function targetReplaceStart(target: GroupTarget): number;
+/**
+ * Collects a file's group targets — `cn()` / `tv()` slots, plus long JSX `className` literals in `.tsx`.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function collectGroupTargets(sourceFile: DomainSourceFile, filePath: string): Array<GroupTarget>;
+/**
+ * Plans the grouped replacement for one target, or `undefined` when regrouping would change nothing.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function planGroupEditForTarget(target: GroupTarget, textAfterUnwrap: string, withClassName: boolean): PlannedGroupEdit | undefined;