i18nsmith 0.1.8 → 0.2.0

package/dist/integration.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Integration tests for CLI commands
+ * These tests run the actual CLI commands against real file systems
+ */
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/integration.test.d.ts.map

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

package/dist/test-helpers/ensure-cli-built.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureCliBuilt(cliPath: string): Promise<void>;
+//# sourceMappingURL=ensure-cli-built.d.ts.map

package/dist/test-helpers/ensure-cli-built.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-cli-built.d.ts","sourceRoot":"","sources":["../../src/test-helpers/ensure-cli-built.ts"],"names":[],"mappings":"AAUA,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBnE"}

package/dist/utils/diagnostics-exit.d.ts

@@ -0,0 +1,12 @@
+import type { DiagnoseConflict, DiagnosisReport } from '@i18nsmith/core';
+export interface DiagnosisExitSignal {
+    code: number;
+    reason: string;
+}
+export declare function getDiagnosisExitSignal(report: Pick<DiagnosisReport, 'conflicts'>): DiagnosisExitSignal | null;
+export declare function selectExitSignal(conflicts: DiagnoseConflict[]): DiagnosisExitSignal | null;
+export declare function describeDiagnosisExitCodes(): Array<{
+    code: number;
+    reason: string;
+}>;
+//# sourceMappingURL=diagnostics-exit.d.ts.map

package/dist/utils/diagnostics-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-exit.d.ts","sourceRoot":"","sources":["../../src/utils/diagnostics-exit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGzE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAE7G;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,mBAAmB,GAAG,IAAI,CA2B1F;AAED,wBAAgB,0BAA0B,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAMpF"}

package/dist/utils/diagnostics-exit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostics-exit.test.d.ts.map

package/dist/utils/diagnostics-exit.test.d.ts.map

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

package/dist/utils/diff-utils.d.ts

@@ -0,0 +1,4 @@
+import type { SyncSummary } from '@i18nsmith/core';
+export declare function printLocaleDiffs(diffs: SyncSummary['diffs']): void;
+export declare function writeLocaleDiffPatches(diffs: SyncSummary['diffs'], directory: string): Promise<void>;
+//# sourceMappingURL=diff-utils.d.ts.map

package/dist/utils/diff-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-utils.d.ts","sourceRoot":"","sources":["../../src/utils/diff-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,QAW3D;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,iBAuB1F"}

package/dist/utils/diff-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diff-utils.test.d.ts.map

package/dist/utils/diff-utils.test.d.ts.map

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

package/dist/utils/exit-codes.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Exit Code Reference for i18nsmith CLI
+ *
+ * This module centralizes all exit codes used by the CLI for consistent
+ * behavior across commands and improved CI/CD integration.
+ *
+ * ## Exit Code Ranges
+ *
+ * | Range  | Category              | Description                           |
+ * |--------|-----------------------|---------------------------------------|
+ * | 0      | Success               | Command completed successfully        |
+ * | 1      | General Error         | Unspecified error or crash            |
+ * | 2-5    | Diagnostics           | Workspace diagnostic conflicts        |
+ * | 10-19  | Check Command         | Health check warnings/conflicts       |
+ * | 1-4    | Sync Command          | Sync drift/validation issues          |
+ *
+ * Note: Sync exit codes overlap with diagnostics for backward compatibility.
+ * Use `--prefer-diagnostics-exit` in `check` command to disambiguate.
+ *
+ * ## Usage in CI/CD
+ *
+ * ```bash
+ * # Basic CI check
+ * npx i18nsmith check --fail-on conflicts
+ * if [ $? -eq 11 ]; then
+ *   echo "Blocking conflicts found"
+ * fi
+ *
+ * # Strict sync check
+ * npx i18nsmith sync --check --strict
+ * case $? in
+ *   0) echo "All clear" ;;
+ *   1) echo "Locale drift detected" ;;
+ *   2) echo "Placeholder mismatch" ;;
+ *   4) echo "Suspicious keys found" ;;
+ * esac
+ * ```
+ */
+/**
+ * Exit codes for the `sync` command.
+ *
+ * Used when running `i18nsmith sync --check` or `--strict` mode.
+ */
+export declare const SYNC_EXIT_CODES: {
+    /** Locale drift detected (missing or unused keys) */
+    readonly DRIFT: 1;
+    /** Placeholder/interpolation mismatch between locales */
+    readonly PLACEHOLDER_MISMATCH: 2;
+    /** Empty or placeholder values in locale files */
+    readonly EMPTY_VALUES: 3;
+    /** Suspicious key patterns detected (e.g., key=value, raw text keys) */
+    readonly SUSPICIOUS_KEYS: 4;
+};
+/**
+ * Exit codes for the `check` command.
+ *
+ * Used when running `i18nsmith check --fail-on <level>`.
+ */
+export declare const CHECK_EXIT_CODES: {
+    /** Warnings detected (when --fail-on warnings) */
+    readonly WARNINGS: 10;
+    /** Blocking conflicts detected (when --fail-on conflicts) */
+    readonly CONFLICTS: 11;
+};
+/**
+ * Exit codes for the `diagnose` command and diagnostic conflicts.
+ *
+ * These are also used by `check` when `--prefer-diagnostics-exit` is set.
+ */
+export declare const DIAGNOSTICS_EXIT_CODES: {
+    /** Missing source locale file */
+    readonly MISSING_SOURCE_LOCALE: 2;
+    /** Invalid JSON in locale file */
+    readonly INVALID_LOCALE_JSON: 3;
+    /** Provider/adapter clash detected */
+    readonly UNSAFE_PROVIDER_CLASH: 4;
+    /** General diagnostics conflict (fallback) */
+    readonly GENERAL_CONFLICT: 5;
+};
+/**
+ * General exit codes used across all commands.
+ */
+export declare const GENERAL_EXIT_CODES: {
+    /** Success - no issues found */
+    readonly SUCCESS: 0;
+    /** General error (catch-all for exceptions) */
+    readonly ERROR: 1;
+};
+/**
+ * Type for all sync exit codes
+ */
+export type SyncExitCode = (typeof SYNC_EXIT_CODES)[keyof typeof SYNC_EXIT_CODES];
+/**
+ * Type for all check exit codes
+ */
+export type CheckExitCode = (typeof CHECK_EXIT_CODES)[keyof typeof CHECK_EXIT_CODES];
+/**
+ * Type for all diagnostics exit codes
+ */
+export type DiagnosticsExitCode = (typeof DIAGNOSTICS_EXIT_CODES)[keyof typeof DIAGNOSTICS_EXIT_CODES];
+/**
+ * Human-readable descriptions for sync exit codes.
+ */
+export declare const SYNC_EXIT_DESCRIPTIONS: Record<number, string>;
+/**
+ * Human-readable descriptions for check exit codes.
+ */
+export declare const CHECK_EXIT_DESCRIPTIONS: Record<number, string>;
+/**
+ * Human-readable descriptions for diagnostics exit codes.
+ */
+export declare const DIAGNOSTICS_EXIT_DESCRIPTIONS: Record<number, string>;
+/**
+ * All exit code descriptions by command context.
+ */
+export declare const EXIT_CODE_DESCRIPTIONS: {
+    readonly general: {
+        readonly 0: "Success - no issues found";
+        readonly 1: "General error";
+    };
+    readonly sync: Record<number, string>;
+    readonly check: Record<number, string>;
+    readonly diagnostics: Record<number, string>;
+};
+/**
+ * Get a human-readable description for an exit code.
+ *
+ * @param code - The exit code
+ * @param context - Optional context to disambiguate overlapping codes
+ * @returns Description string, or 'Unknown exit code' if not recognized
+ */
+export declare function getExitCodeDescription(code: number, context?: 'sync' | 'check' | 'diagnostics'): string;
+/**
+ * Helper to set process exit code with optional logging.
+ *
+ * @param code - The exit code to set
+ * @param options - Optional configuration
+ */
+export declare function setExitCode(code: number, options?: {
+    silent?: boolean;
+}): void;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/utils/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/utils/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe;IAC1B,qDAAqD;;IAErD,yDAAyD;;IAEzD,kDAAkD;;IAElD,wEAAwE;;CAEhE,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;IAC3B,kDAAkD;;IAElD,6DAA6D;;CAErD,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IACjC,iCAAiC;;IAEjC,kCAAkC;;IAElC,sCAAsC;;IAEtC,8CAA8C;;CAEtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,gCAAgC;;IAEhC,+CAA+C;;CAEvC,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AAEvG;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;CAQzB,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GACzC,MAAM,CAsBR;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,IAAI,CAQN"}

package/dist/utils/package-manager.d.ts

@@ -0,0 +1,4 @@
+export type PackageManager = 'pnpm' | 'yarn' | 'npm';
+export declare function detectPackageManager(workspaceRoot?: string): Promise<PackageManager>;
+export declare function installDependencies(manager: PackageManager, deps: string[], workspaceRoot?: string): Promise<void>;
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/utils/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD,wBAAsB,oBAAoB,CAAC,aAAa,SAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAQjG;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,SAAgB,iBAkB/G"}

package/dist/utils/pkg.d.ts

@@ -0,0 +1,3 @@
+export declare function readPackageJson(cwd?: string): Promise<Record<string, unknown> | undefined>;
+export declare function hasDependency(pkg: Record<string, unknown> | undefined, dep: string): boolean;
+//# sourceMappingURL=pkg.d.ts.map

package/dist/utils/pkg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg.d.ts","sourceRoot":"","sources":["../../src/utils/pkg.ts"],"names":[],"mappings":"AAGA,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,gDAYjD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,WAKlF"}

package/dist/utils/preview.d.ts

@@ -0,0 +1,13 @@
+export interface PreviewPayload<TSummary> {
+    type: string;
+    version: number;
+    command: string;
+    args: string[];
+    timestamp: string;
+    summary: TSummary;
+}
+export type PreviewKind = 'sync' | 'transform' | 'rename-key' | 'translate';
+export declare function writePreviewFile<TSummary>(kind: PreviewKind, summary: TSummary, outputPath: string): Promise<string>;
+export declare function readPreviewFile<TSummary>(expectedKind: PreviewKind, previewPath: string): Promise<PreviewPayload<TSummary>>;
+export declare function applyPreviewFile(expectedKind: PreviewKind, previewPath: string, extraArgs?: string[]): Promise<void>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/utils/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/utils/preview.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc,CAAC,QAAQ;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAE5E,wBAAsB,gBAAgB,CAAC,QAAQ,EAC7C,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,QAAQ,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAC5C,YAAY,EAAE,WAAW,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAWnC;AAED,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,WAAW,EACzB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAM,EAAO,GACvB,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/utils/provider-injector.d.ts

@@ -0,0 +1,36 @@
+export type ProviderInjectionResult = {
+    status: 'injected';
+    file: string;
+    diff?: string;
+} | {
+    status: 'preview';
+    file: string;
+    diff: string;
+} | {
+    status: 'skipped';
+    file: string;
+    existingProvider?: string;
+} | {
+    status: 'failed';
+    file: string;
+    reason: string;
+} | {
+    status: 'not-found';
+};
+export interface ProviderDetectionResult {
+    found: boolean;
+    file?: string;
+    provider?: string;
+    candidates: string[];
+}
+export interface ProviderInjectionOptions {
+    providerComponentPath: string;
+    candidates?: string[];
+    dryRun?: boolean;
+}
+/**
+ * Detect if any provider file exists and whether an i18n provider is already wired.
+ */
+export declare function detectExistingProvider(candidates?: string[]): Promise<ProviderDetectionResult>;
+export declare function maybeInjectProvider(options: ProviderInjectionOptions): Promise<ProviderInjectionResult>;
+//# sourceMappingURL=provider-injector.d.ts.map

package/dist/utils/provider-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-injector.d.ts","sourceRoot":"","sources":["../../src/utils/provider-injector.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAuCD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,GAAE,MAAM,EAAgC,GACjD,OAAO,CAAC,uBAAuB,CAAC,CAwClC;AAuBD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA2BlC"}

package/dist/utils/provider-injector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-injector.test.d.ts.map

package/dist/utils/provider-injector.test.d.ts.map

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

package/dist/utils/scaffold.d.ts

@@ -0,0 +1,20 @@
+interface ScaffoldOptions {
+    localesDir?: string;
+    workspaceRoot?: string;
+    force?: boolean;
+    dryRun?: boolean;
+}
+export interface ScaffoldResult {
+    path: string;
+    content: string;
+    written: boolean;
+}
+export declare function scaffoldTranslationContext(filePath: string, sourceLanguage: string, options?: ScaffoldOptions): Promise<ScaffoldResult>;
+export declare function scaffoldI18next(i18nPath: string, providerPath: string, sourceLanguage: string, localesDir?: string, options?: ScaffoldOptions): Promise<{
+    i18nPath: string;
+    providerPath: string;
+    i18nResult: ScaffoldResult;
+    providerResult: ScaffoldResult;
+}>;
+export {};
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/utils/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/utils/scaffold.ts"],"names":[],"mappings":"AAGA,UAAU,eAAe;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AA2CD,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA0DzB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,UAAU,SAAY,EACtB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,cAAc,CAAA;CAAE,CAAC,CAgHjH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18nsmith",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "CLI for i18nsmith",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,8 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "scripts": {

package/src/commands/debug-patterns.test.ts

@@ -1,9 +1,10 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { describe, it, expect, beforeEach, afterEach, beforeAll } from 'vitest';
 import fs from 'fs/promises';
 import path from 'path';
 import os from 'os';
 import { spawnSync } from 'child_process';
 import { fileURLToPath } from 'url';
+import { ensureCliBuilt } from '../test-helpers/ensure-cli-built';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -33,6 +34,10 @@ function runCli(args: string[], options: { cwd?: string } = {}) {
 describe('debug-patterns command', () => {
   let tmpDir: string;
 
+  beforeAll(async () => {
+    await ensureCliBuilt(CLI_PATH);
+  });
+
   beforeEach(async () => {
     tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'i18nsmith-debug-patterns-'));
     

package/src/commands/rename.ts

@@ -3,6 +3,7 @@ import chalk from 'chalk';
 import path from 'node:path';
 import { promises as fs } from 'node:fs';
 import { loadConfig, KeyRenamer, type KeyRenameSummary, type KeyRenameBatchSummary, type KeyRenameMapping } from '@i18nsmith/core';
+import { applyPreviewFile, writePreviewFile } from '../utils/preview.js';
 
 interface ScanOptions {
   config: string;
@@ -10,6 +11,13 @@ interface ScanOptions {
   report?: string;
 }
 
+interface RenameKeyOptions extends ScanOptions {
+  write?: boolean;
+  diff?: boolean;
+  previewOutput?: string;
+  applyPreview?: string;
+}
+
 interface RenameMapOptions extends ScanOptions {
   map: string;
   write?: boolean;
@@ -29,13 +37,37 @@ export function registerRename(program: Command): void {
     .option('--json', 'Print raw JSON results', false)
     .option('--report <path>', 'Write JSON summary to a file (for CI or editors)')
     .option('--write', 'Write changes to disk (defaults to dry-run)', false)
-    .action(async (oldKey: string, newKey: string, options: ScanOptions & { write?: boolean }) => {
-      console.log(chalk.blue(options.write ? 'Renaming translation key...' : 'Planning key rename (dry-run)...'));
+    .option('--diff', 'Display unified diffs for files that would change', false)
+    .option('--preview-output <path>', 'Write preview summary (JSON) to a file (implies dry-run)')
+    .option('--apply-preview <path>', 'Apply a previously saved rename preview JSON file safely')
+    .action(async (oldKey: string, newKey: string, options: RenameKeyOptions) => {
+      if (options.applyPreview) {
+        await applyPreviewFile('rename-key', options.applyPreview);
+        return;
+      }
+
+      const previewMode = Boolean(options.previewOutput);
+      const writeEnabled = Boolean(options.write) && !previewMode;
+      if (previewMode && options.write) {
+        console.log(chalk.yellow('Preview requested; ignoring --write and running in dry-run mode.'));
+      }
+      options.write = writeEnabled;
+
+      console.log(chalk.blue(writeEnabled ? 'Renaming translation key...' : 'Planning key rename (dry-run)...'));
 
       try {
         const config = await loadConfig(options.config);
         const renamer = new KeyRenamer(config);
-        const summary = await renamer.rename(oldKey, newKey, { write: options.write });
+        const summary = await renamer.rename(oldKey, newKey, {
+          write: options.write,
+          diff: options.diff || previewMode,
+        });
+
+        if (previewMode && options.previewOutput) {
+          const savedPath = await writePreviewFile('rename-key', summary, options.previewOutput);
+          console.log(chalk.green(`Preview written to ${path.relative(process.cwd(), savedPath)}`));
+          return;
+        }
 
         if (options.report) {
           const outputPath = path.resolve(process.cwd(), options.report);

package/src/commands/review.test.ts

@@ -0,0 +1,12 @@
+import { describe, it, expect } from 'vitest';
+import { literalToRegexPattern } from './review.js';
+
+describe('literalToRegexPattern', () => {
+  it('anchors the value and escapes regex metacharacters', () => {
+    expect(literalToRegexPattern('Price (USD)+?')).toBe('^Price \\(USD\\)\\+\\?$');
+  });
+
+  it('preserves whitespace and newline characters', () => {
+    expect(literalToRegexPattern('Multi\nLine')).toBe('^Multi\nLine$');
+  });
+});