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

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/{bin.mjs → bin.js}

@@ -1,8 +1,5 @@
 #!/usr/bin/env node
-import { runCli } from "./program.mjs";
 import process from "node:process";
-//#region src/bin.ts
+import { runCli } from "#program";
 const code = await runCli(process.argv);
 process.exit(code);
-//#endregion
-export {};

package/dist/commands/arrange.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerArrangeCommand(program: Command): void;
+//# sourceMappingURL=arrange.d.ts.map

package/dist/commands/arrange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrange.d.ts","sourceRoot":"","sources":["../../src/commands/arrange.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkI7D"}

package/dist/commands/arrange.js

@@ -0,0 +1,129 @@
+import path from "node:path";
+import process from "node:process";
+import { Option } from "commander";
+import { ArrangeAnalyzeDirectoryRequestSchema } from "#lib/arrange/application/requests/analyze-directory.request";
+import { ArrangeSyncRunRequestSchema } from "#lib/arrange/application/requests/arrange-sync.request";
+import { DEFAULT_ARRANGE_TARGET } from "#lib/arrange/domain/constants";
+import { suggestCnGroups, summarizeGroupBucketLabels } from "#lib/arrange/domain/grouping";
+import { formatArray, formatCnCall } from "#lib/arrange/domain/source-text-formatters";
+import { printAnalyzeReport } from "#lib/arrange/presentation/report";
+import { consumeCliAppError } from "#lib/core/presentation/cli-executor";
+import { assertPathExistsOrExit, createCliContext, parseWithCliSchema, resolveWorkspaceRoot, runAsyncExitCodeUseCaseAfterParse, runSyncUseCaseAfterParse, tryLoadCodefastConfig, } from "#lib/core/presentation/create-command-handler";
+function withClassNameOption() {
+    return new Option("--with-classname, --with-class-name", "Append className as final cn() argument").default(false);
+}
+function defaultTargetPath() {
+    return path.resolve(process.cwd(), DEFAULT_ARRANGE_TARGET);
+}
+export function registerArrangeCommand(program) {
+    const arrange = program
+        .command("arrange")
+        .description("Analyze and regroup Tailwind classes in cn() / tv() calls (Tailwind v4)");
+    arrange
+        .command("analyze")
+        .description("Report long strings, nested cn in tv(), and related findings")
+        .argument("[target]", "Directory or file (default: packages/ui/src/components)")
+        .action(async (target) => {
+        const cli = createCliContext();
+        const resolved = target ? path.resolve(target) : defaultTargetPath();
+        if (!assertPathExistsOrExit(resolved, cli)) {
+            return;
+        }
+        const rootOutcome = resolveWorkspaceRoot(cli);
+        if (!consumeCliAppError(cli.logger, rootOutcome)) {
+            return;
+        }
+        const rootDir = rootOutcome.value;
+        const loadedOutcome = await tryLoadCodefastConfig(cli, rootDir);
+        if (!consumeCliAppError(cli.logger, loadedOutcome)) {
+            return;
+        }
+        const parsed = parseWithCliSchema(ArrangeAnalyzeDirectoryRequestSchema, {
+            analyzeRootPath: resolved,
+        });
+        runSyncUseCaseAfterParse(cli, parsed, (input) => cli.arrange.analyzeDirectory(input), (report) => printAnalyzeReport(resolved, report, cli.logger));
+    });
+    arrange
+        .command("preview")
+        .description("Dry-run: print suggested replacements without writing files")
+        .argument("[target]", "Directory or file (default: packages/ui/src/components)")
+        .addOption(withClassNameOption())
+        .option("--cn-import <spec>", "Override module specifier when adding cn import")
+        .action(async (target, opts) => {
+        const cli = createCliContext();
+        const resolved = target ? path.resolve(target) : defaultTargetPath();
+        if (!assertPathExistsOrExit(resolved, cli)) {
+            return;
+        }
+        const rootOutcome = resolveWorkspaceRoot(cli);
+        if (!consumeCliAppError(cli.logger, rootOutcome)) {
+            return;
+        }
+        const rootDir = rootOutcome.value;
+        const loadedOutcome = await tryLoadCodefastConfig(cli, rootDir);
+        if (!consumeCliAppError(cli.logger, loadedOutcome)) {
+            return;
+        }
+        const parsed = parseWithCliSchema(ArrangeSyncRunRequestSchema, {
+            rootDir,
+            targetPath: resolved,
+            write: false,
+            withClassName: opts.withClassName,
+            cnImport: opts.cnImport,
+            config: loadedOutcome.value.config.arrange ?? {},
+        });
+        await runAsyncExitCodeUseCaseAfterParse(cli, parsed, (input) => cli.arrange.runArrangeSync(input));
+    });
+    arrange
+        .command("apply")
+        .description("Apply grouping and cn-in-tv unwrap edits to files")
+        .argument("[target]", "Directory or file (default: packages/ui/src/components)")
+        .addOption(withClassNameOption())
+        .option("--cn-import <spec>", "Override module specifier when adding cn import")
+        .action(async (target, opts) => {
+        const cli = createCliContext();
+        const resolved = target ? path.resolve(target) : defaultTargetPath();
+        if (!assertPathExistsOrExit(resolved, cli)) {
+            return;
+        }
+        const rootOutcome = resolveWorkspaceRoot(cli);
+        if (!consumeCliAppError(cli.logger, rootOutcome)) {
+            return;
+        }
+        const rootDir = rootOutcome.value;
+        const loadedOutcome = await tryLoadCodefastConfig(cli, rootDir);
+        if (!consumeCliAppError(cli.logger, loadedOutcome)) {
+            return;
+        }
+        const parsed = parseWithCliSchema(ArrangeSyncRunRequestSchema, {
+            rootDir,
+            targetPath: resolved,
+            write: true,
+            withClassName: opts.withClassName,
+            cnImport: opts.cnImport,
+            config: loadedOutcome.value.config.arrange ?? {},
+        });
+        await runAsyncExitCodeUseCaseAfterParse(cli, parsed, (input) => cli.arrange.runArrangeSync(input));
+    });
+    arrange
+        .command("group")
+        .description("Try grouping on a pasted class string (stdout: cn(...) or tv array with --tv)")
+        .argument("[tokens...]", "Class tokens (quote a single string if it contains spaces)")
+        .option("--tv", "Emit tv()-style array instead of cn() call", false)
+        .addOption(withClassNameOption())
+        .action((tokens, opts) => {
+        const cli = createCliContext();
+        const inlineClasses = tokens.join(" ").trim();
+        if (!inlineClasses) {
+            cli.logger.err('Pass a class string. Example: codefast arrange group "flex gap-2 text-sm rounded-md"\n');
+            process.exitCode = 1;
+            return;
+        }
+        const groups = suggestCnGroups(inlineClasses);
+        const result = opts.tv
+            ? formatArray(groups)
+            : formatCnCall(groups, { trailingClassName: !!opts.withClassName });
+        cli.logger.out(result);
+        cli.logger.out(`// Buckets: ${JSON.stringify(summarizeGroupBucketLabels(groups))}`);
+    });
+}

package/dist/commands/mirror.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+export declare function packageArgToRelative(rootDir: string, arg: string | undefined): string | undefined;
+export declare function registerMirrorCommand(program: Command): void;
+//# sourceMappingURL=mirror.d.ts.map

package/dist/commands/mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.d.ts","sourceRoot":"","sources":["../../src/commands/mirror.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBjG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4C5D"}

package/dist/commands/mirror.js

@@ -0,0 +1,75 @@
+import { realpathSync } from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { messageFromCaughtUnknown } from "#lib/core/application/utils/caught-unknown-message";
+import { consumeCliAppError } from "#lib/core/presentation/cli-executor";
+import { createCliContext, parseWithCliSchema, resolveWorkspaceRoot, runAsyncExitCodeUseCaseAfterParse, tryLoadCodefastConfig, } from "#lib/core/presentation/create-command-handler";
+import { MirrorSyncRunRequestSchema } from "#lib/mirror/application/requests/mirror-sync.request";
+function tryRealpath(entryPath) {
+    try {
+        return realpathSync.native(entryPath);
+    }
+    catch {
+        return path.resolve(entryPath);
+    }
+}
+function normalizePath(relPath) {
+    return relPath.split(path.sep).join("/").replace(/\\/g, "/");
+}
+export function packageArgToRelative(rootDir, arg) {
+    if (!arg) {
+        return undefined;
+    }
+    const rootReal = tryRealpath(path.resolve(rootDir));
+    const cwdReal = tryRealpath(process.cwd());
+    const resolved = path.isAbsolute(arg) ? path.resolve(arg) : path.resolve(cwdReal, arg);
+    const targetReal = tryRealpath(resolved);
+    const rel = path.relative(rootReal, targetReal);
+    const normalized = normalizePath(rel);
+    if (normalized.startsWith("..") ||
+        path.isAbsolute(normalized) ||
+        normalized === "" ||
+        normalized === ".") {
+        throw new Error(`Package path must be a subdirectory under monorepo root: ${rootDir}`);
+    }
+    return normalized;
+}
+export function registerMirrorCommand(program) {
+    const mirror = program
+        .command("mirror")
+        .description("Keep package manifests aligned with what you ship");
+    mirror
+        .command("sync")
+        .description("Write package.json exports from dist/ for workspace packages")
+        .argument("[package]", "Optional package path relative to repo root (e.g. packages/ui)")
+        .option("-v, --verbose", "Print extra diagnostics", false)
+        .action(async function (pkg, options) {
+        const globals = this.optsWithGlobals();
+        const cli = createCliContext();
+        const rootOutcome = resolveWorkspaceRoot(cli);
+        if (!consumeCliAppError(cli.logger, rootOutcome)) {
+            return;
+        }
+        const rootDir = rootOutcome.value;
+        let packageFilter;
+        try {
+            packageFilter = packageArgToRelative(rootDir, pkg);
+        }
+        catch (caughtPathError) {
+            this.error(messageFromCaughtUnknown(caughtPathError));
+            return;
+        }
+        const loadedOutcome = await tryLoadCodefastConfig(cli, rootDir);
+        if (!consumeCliAppError(cli.logger, loadedOutcome)) {
+            return;
+        }
+        const parsed = parseWithCliSchema(MirrorSyncRunRequestSchema, {
+            rootDir,
+            config: loadedOutcome.value.config.mirror ?? {},
+            verbose: options.verbose,
+            noColor: globals.color === false,
+            packageFilter,
+        });
+        await runAsyncExitCodeUseCaseAfterParse(cli, parsed, (input) => cli.mirror.runMirrorSync(input));
+    });
+}

package/dist/commands/tag.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerTagCommand(program: Command): void;
+//# sourceMappingURL=tag.d.ts.map

package/dist/commands/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/commands/tag.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqCzD"}

package/dist/commands/tag.js

@@ -0,0 +1,41 @@
+import path from "node:path";
+import process from "node:process";
+import { consumeCliAppError } from "#lib/core/presentation/cli-executor";
+import { createCliContext, parseWithCliSchema, resolveTagWorkspaceRoot, tryLoadCodefastConfig, } from "#lib/core/presentation/create-command-handler";
+import { TagSyncRunRequestSchema } from "#lib/tag/application/requests/tag-sync.request";
+import { createTagProgressListener, presentTagSyncCliResult, } from "#lib/tag/presentation/tag-presenter";
+export function registerTagCommand(program) {
+    program
+        .command("tag")
+        .alias("annotate")
+        .description("Add @since <version> JSDoc tags to exported declarations")
+        .argument("[target]", "Directory or file to annotate (default: auto-discover workspace packages)")
+        .option("--dry-run", "Show summary without writing files", false)
+        .action(async (target, options) => {
+        const cli = createCliContext();
+        const rootDir = resolveTagWorkspaceRoot(cli);
+        const loadedOutcome = await tryLoadCodefastConfig(cli, rootDir);
+        if (!consumeCliAppError(cli.logger, loadedOutcome)) {
+            return;
+        }
+        const tagConfig = loadedOutcome.value.config.tag ?? {};
+        const parsed = parseWithCliSchema(TagSyncRunRequestSchema, {
+            rootDir,
+            write: !options.dryRun,
+            targetPath: target ? path.resolve(target) : undefined,
+            skipPackages: tagConfig.skipPackages,
+            config: tagConfig,
+        });
+        if (!consumeCliAppError(cli.logger, parsed)) {
+            return;
+        }
+        const tagOutcome = await cli.tag.runTagSync({
+            ...parsed.value,
+            listener: createTagProgressListener((line) => cli.logger.out(line)),
+        });
+        if (!consumeCliAppError(cli.logger, tagOutcome)) {
+            return;
+        }
+        process.exitCode = presentTagSyncCliResult(cli.logger, tagOutcome.value, rootDir);
+    });
+}

package/dist/lib/arrange/application/analyze.d.ts

@@ -0,0 +1,17 @@
+import { type AppError } from "#lib/core/domain/errors";
+import { type Result } from "#lib/core/domain/result";
+import type { CliFs } from "#lib/core/application/ports/cli-io.port";
+import type { DomainSourceParserPort } from "#lib/arrange/application/ports/domain-source-parser.port";
+import type { ArrangeAnalyzeDirectoryRequest } from "#lib/arrange/application/requests/analyze-directory.request";
+import type { FileWalkerPort } from "#lib/arrange/application/ports/file-walker.port";
+import type { AnalyzeReport } from "#lib/arrange/domain/types";
+export type AnalyzeDirectoryDeps = {
+    readonly fs: CliFs;
+    readonly fileWalker: FileWalkerPort;
+    readonly domainSourceParser: DomainSourceParserPort;
+};
+/**
+ * Orchestrates filesystem + parse ports, delegates analysis rules to the domain service.
+ */
+export declare function analyzeDirectory(request: ArrangeAnalyzeDirectoryRequest, deps: AnalyzeDirectoryDeps): Result<AnalyzeReport, AppError>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/lib/arrange/application/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrange/application/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yCAAyC,CAAC;AAErE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AACvG,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6DAA6D,CAAC;AAClH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,8BAA8B,EACvC,IAAI,EAAE,oBAAoB,GACzB,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAiBjC"}

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

@@ -0,0 +1,24 @@
+import { appError } from "#lib/core/domain/errors";
+import { err, ok } from "#lib/core/domain/result";
+import { messageFromCaughtUnknown } from "#lib/core/application/utils/caught-unknown-message";
+import { accumulateAnalyzeReportForSourceFile, createEmptyAnalyzeReport, } from "#lib/arrange/domain/arrange-analyze.service";
+/**
+ * Orchestrates filesystem + parse ports, delegates analysis rules to the domain service.
+ */
+export function analyzeDirectory(request, deps) {
+    const report = createEmptyAnalyzeReport();
+    try {
+        const files = deps.fs.statSync(request.analyzeRootPath).isDirectory()
+            ? deps.fileWalker.walkTypeScriptFiles(request.analyzeRootPath, deps.fs)
+            : [request.analyzeRootPath];
+        for (const filePath of files) {
+            const sourceText = deps.fs.readFileSync(filePath, "utf8");
+            const domainSf = deps.domainSourceParser.parseDomainSourceFile(filePath, sourceText);
+            accumulateAnalyzeReportForSourceFile(report, domainSf, sourceText, filePath);
+        }
+        return ok(report);
+    }
+    catch (caughtError) {
+        return err(appError("INFRA_FAILURE", messageFromCaughtUnknown(caughtError), caughtError));
+    }
+}

package/dist/lib/arrange/application/group-file-preview.d.ts

@@ -0,0 +1,17 @@
+import type { CliLogger } from "#lib/core/application/ports/cli-io.port";
+import type { GroupFileUnwrapPlan, GroupFileWorkPlan } from "#lib/arrange/domain/arrange-grouping.service";
+import type { DomainCallExpression, DomainSourceFile } from "#lib/arrange/domain/ast/ast-node.model";
+import type { PlannedGroupEdit } from "#lib/arrange/domain/types";
+export declare function printGroupFilePreview(logger: CliLogger, args: {
+    filePath: string;
+    reportTotal: number;
+    cnInTvNoReplacement: number;
+    cnInTvCalls: readonly DomainCallExpression[];
+    unwrapReplacementByCall: ReadonlyMap<DomainCallExpression, string>;
+    sourceText: string;
+    domainSf: DomainSourceFile;
+    unwrapEdits: readonly GroupFileUnwrapPlan[];
+    plannedGroupEdits: readonly PlannedGroupEdit[];
+}): void;
+export declare function printGroupFilePreviewFromWork(logger: CliLogger, work: GroupFileWorkPlan): void;
+//# sourceMappingURL=group-file-preview.d.ts.map

package/dist/lib/arrange/application/group-file-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-file-preview.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrange/application/group-file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,8CAA8C,CAAC;AAEtD,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC7C,uBAAuB,EAAE,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC5C,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD,GACA,IAAI,CA6CN;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAY9F"}

package/dist/lib/arrange/application/group-file-preview.js

@@ -0,0 +1,46 @@
+import { lineOf } from "#lib/arrange/domain/ast/ast-helpers";
+export function printGroupFilePreview(logger, args) {
+    const { out } = logger;
+    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 += `) ──`;
+    out(header);
+    for (const call of cnInTvCalls) {
+        const replacement = unwrapReplacementByCall.get(call);
+        if (replacement === undefined) {
+            out(`  Line ${lineOf(domainSf, call)} [tv \u2283 cn]: cn(...) has no arguments — skipped`);
+            continue;
+        }
+        const start = call.pos;
+        const end = call.end;
+        if (sourceText.slice(start, end) === replacement) {
+            continue;
+        }
+        out(`  Line ${lineOf(domainSf, call)} [tv \u2283 cn \u2192 string/array]:`);
+        out(`  ${replacement.split("\n").join("\n  ")}`);
+    }
+    if (unwrapEdits.length > 0 && plannedGroupEdits.length > 0) {
+        out("  ([cn] / [tv] / [JSX className] lines below reflect content after unwrap of cn inside tv.)");
+    }
+    for (const plan of plannedGroupEdits) {
+        out(`  Line ${lineOf(plan.lineSf, plan.reportNode)} [${plan.label}]:`);
+        out(`  ${plan.replacement.split("\n").join("\n  ")}`);
+        out(`  // Buckets: ${JSON.stringify(plan.bucketSummary)}`);
+    }
+}
+export function printGroupFilePreviewFromWork(logger, work) {
+    printGroupFilePreview(logger, {
+        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,
+    });
+}

package/dist/lib/arrange/application/group-file.d.ts

@@ -0,0 +1,5 @@
+import type { CliFs, CliLogger } from "#lib/core/application/ports/cli-io.port";
+import type { DomainSourceParserPort } from "#lib/arrange/application/ports/domain-source-parser.port";
+import type { ArrangeGroupFileOptions, GroupFileResult } from "#lib/arrange/domain/types";
+export declare function groupFile(filePath: string, options: ArrangeGroupFileOptions, fs: CliFs, logger: CliLogger, domainSourceParser: DomainSourceParserPort): GroupFileResult;
+//# sourceMappingURL=group-file.d.ts.map

package/dist/lib/arrange/application/group-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-file.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrange/application/group-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAc1F,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uBAAuB,EAChC,EAAE,EAAE,KAAK,EACT,MAAM,EAAE,SAAS,EACjB,kBAAkB,EAAE,sBAAsB,GACzC,eAAe,CAgDjB"}

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

@@ -0,0 +1,40 @@
+import { buildGroupFileUnwrapState, countPersistedGroupFileEdits, groupFileDryRunNoEdits, groupFileEditsTouchJsxCn, groupFilePreviewTotals, groupFileWorkHasNothingToReport, mergeGroupFileBodyText, tryBuildGroupFileWorkPlan, } from "#lib/arrange/domain/arrange-grouping.service";
+import { ensureCnImport } from "#lib/arrange/domain/imports";
+import { printGroupFilePreviewFromWork } from "#lib/arrange/application/group-file-preview";
+export function groupFile(filePath, options, fs, logger, domainSourceParser) {
+    const sourceText = fs.readFileSync(filePath, "utf8");
+    const domainSfInitial = domainSourceParser.parseDomainSourceFile(filePath, sourceText);
+    const unwrap = buildGroupFileUnwrapState(domainSfInitial, sourceText);
+    const domainSfGrouped = domainSourceParser.parseDomainSourceFile(filePath, unwrap.textAfterUnwrap);
+    const work = tryBuildGroupFileWorkPlan({
+        filePath,
+        sourceText,
+        domainSfInitial,
+        domainSfGrouped,
+        withClassName: options.withClassName,
+        unwrap,
+    });
+    if (work === null) {
+        return groupFileDryRunNoEdits(filePath);
+    }
+    if (!options.write) {
+        if (groupFileWorkHasNothingToReport(work)) {
+            return groupFileDryRunNoEdits(filePath);
+        }
+        printGroupFilePreviewFromWork(logger, work);
+        return groupFilePreviewTotals(work);
+    }
+    const persistedEditCount = countPersistedGroupFileEdits(work);
+    let newText = mergeGroupFileBodyText(work);
+    if (persistedEditCount > 0) {
+        if (groupFileEditsTouchJsxCn(work)) {
+            newText = ensureCnImport(domainSourceParser.parseDomainSourceFile(filePath, newText), options.cnImport);
+        }
+        fs.writeFileSync(filePath, newText, "utf8");
+    }
+    return {
+        filePath,
+        totalFound: persistedEditCount + work.cnInTvNoReplacement,
+        changed: persistedEditCount,
+    };
+}

package/dist/lib/arrange/application/ports/domain-source-parser.port.d.ts

@@ -0,0 +1,5 @@
+import type { DomainSourceFile } from "#lib/arrange/domain/ast/ast-node.model";
+export interface DomainSourceParserPort {
+    parseDomainSourceFile(filePath: string, sourceText: string): DomainSourceFile;
+}
+//# sourceMappingURL=domain-source-parser.port.d.ts.map

package/dist/lib/arrange/application/ports/domain-source-parser.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-source-parser.port.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrange/application/ports/domain-source-parser.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC;CAC/E"}

package/dist/lib/arrange/application/ports/file-walker.port.d.ts

@@ -0,0 +1,5 @@
+import type { CliFs } from "#lib/core/application/ports/cli-io.port";
+export interface FileWalkerPort {
+    walkTypeScriptFiles(rootDirectoryPath: string, fs: CliFs): string[];
+}
+//# sourceMappingURL=file-walker.port.d.ts.map

package/dist/lib/arrange/application/ports/file-walker.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-walker.port.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrange/application/ports/file-walker.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yCAAyC,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,mBAAmB,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,GAAG,MAAM,EAAE,CAAC;CACrE"}

package/dist/lib/arrange/application/requests/analyze-directory.request.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+export declare const ArrangeAnalyzeDirectoryRequestSchema: z.ZodObject<{
+    analyzeRootPath: z.ZodString;
+}, z.core.$strip>;
+export type ArrangeAnalyzeDirectoryRequest = z.infer<typeof ArrangeAnalyzeDirectoryRequestSchema>;
+//# sourceMappingURL=analyze-directory.request.d.ts.map

package/dist/lib/arrange/application/requests/analyze-directory.request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-directory.request.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrange/application/requests/analyze-directory.request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oCAAoC;;iBAE/C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC"}

package/dist/lib/arrange/application/requests/analyze-directory.request.js

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export const ArrangeAnalyzeDirectoryRequestSchema = z.object({
+    analyzeRootPath: z.string().min(1, "analyzeRootPath is required"),
+});

package/dist/lib/arrange/application/requests/arrange-sync.request.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export declare const ArrangeSyncRunRequestSchema: z.ZodObject<{
+    rootDir: z.ZodString;
+    targetPath: z.ZodString;
+    write: z.ZodBoolean;
+    withClassName: z.ZodOptional<z.ZodBoolean>;
+    cnImport: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type ArrangeSyncRunRequest = z.infer<typeof ArrangeSyncRunRequestSchema>;
+export declare const ArrangeRunTargetRequestSchema: z.ZodObject<{
+    targetPath: z.ZodString;
+    write: z.ZodBoolean;
+    withClassName: z.ZodOptional<z.ZodBoolean>;
+    cnImport: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ArrangeRunTargetRequest = z.infer<typeof ArrangeRunTargetRequestSchema>;
+//# sourceMappingURL=arrange-sync.request.d.ts.map

package/dist/lib/arrange/application/requests/arrange-sync.request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrange-sync.request.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrange/application/requests/arrange-sync.request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,2BAA2B;;;;;;;iBAOtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,6BAA6B;;;;;iBAKxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/lib/arrange/application/requests/arrange-sync.request.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export const ArrangeSyncRunRequestSchema = z.object({
+    rootDir: z.string().min(1),
+    targetPath: z.string().min(1),
+    write: z.boolean(),
+    withClassName: z.boolean().optional(),
+    cnImport: z.string().optional(),
+    config: z.unknown().optional(),
+});
+export const ArrangeRunTargetRequestSchema = z.object({
+    targetPath: z.string().min(1),
+    write: z.boolean(),
+    withClassName: z.boolean().optional(),
+    cnImport: z.string().optional(),
+});

package/dist/lib/arrange/application/run-target.d.ts

@@ -0,0 +1,19 @@
+import { type AppError } from "#lib/core/domain/errors";
+import { type Result } from "#lib/core/domain/result";
+import type { CliFs, CliLogger } from "#lib/core/application/ports/cli-io.port";
+import type { DomainSourceParserPort } from "#lib/arrange/application/ports/domain-source-parser.port";
+import type { FileWalkerPort } from "#lib/arrange/application/ports/file-walker.port";
+import type { ArrangeRunTargetRequest, ArrangeSyncRunRequest } from "#lib/arrange/application/requests/arrange-sync.request";
+import type { ArrangeRunResult } from "#lib/arrange/domain/types";
+export type ArrangeSyncDeps = {
+    readonly fs: CliFs;
+    readonly logger: CliLogger;
+    readonly fileWalker: FileWalkerPort;
+    readonly domainSourceParser: DomainSourceParserPort;
+};
+export declare function runOnTarget(request: ArrangeRunTargetRequest, deps: ArrangeSyncDeps): Result<ArrangeRunResult, AppError>;
+/**
+ * Preview/apply orchestration: resolves target path, runs grouping pipeline, optional hook.
+ */
+export declare function runArrangeSync(request: ArrangeSyncRunRequest, deps: ArrangeSyncDeps): Promise<Result<number, AppError>>;
+//# sourceMappingURL=run-target.d.ts.map

package/dist/lib/arrange/application/run-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-target.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrange/application/run-target.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;CACrD,CAAC;AAEF,wBAAgB,WAAW,CACzB,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,eAAe,GACpB,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAsDpC;AAiBD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CA+BnC"}