i18nsmith 0.1.0

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/exit-codes.js

@@ -0,0 +1,168 @@
+/**
+ * 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 const SYNC_EXIT_CODES = {
+    /** Locale drift detected (missing or unused keys) */
+    DRIFT: 1,
+    /** Placeholder/interpolation mismatch between locales */
+    PLACEHOLDER_MISMATCH: 2,
+    /** Empty or placeholder values in locale files */
+    EMPTY_VALUES: 3,
+    /** Suspicious key patterns detected (e.g., key=value, raw text keys) */
+    SUSPICIOUS_KEYS: 4,
+};
+/**
+ * Exit codes for the `check` command.
+ *
+ * Used when running `i18nsmith check --fail-on <level>`.
+ */
+export const CHECK_EXIT_CODES = {
+    /** Warnings detected (when --fail-on warnings) */
+    WARNINGS: 10,
+    /** Blocking conflicts detected (when --fail-on conflicts) */
+    CONFLICTS: 11,
+};
+/**
+ * Exit codes for the `diagnose` command and diagnostic conflicts.
+ *
+ * These are also used by `check` when `--prefer-diagnostics-exit` is set.
+ */
+export const DIAGNOSTICS_EXIT_CODES = {
+    /** Missing source locale file */
+    MISSING_SOURCE_LOCALE: 2,
+    /** Invalid JSON in locale file */
+    INVALID_LOCALE_JSON: 3,
+    /** Provider/adapter clash detected */
+    UNSAFE_PROVIDER_CLASH: 4,
+    /** General diagnostics conflict (fallback) */
+    GENERAL_CONFLICT: 5,
+};
+/**
+ * General exit codes used across all commands.
+ */
+export const GENERAL_EXIT_CODES = {
+    /** Success - no issues found */
+    SUCCESS: 0,
+    /** General error (catch-all for exceptions) */
+    ERROR: 1,
+};
+/**
+ * Human-readable descriptions for sync exit codes.
+ */
+export const SYNC_EXIT_DESCRIPTIONS = {
+    [SYNC_EXIT_CODES.DRIFT]: 'Locale drift detected (missing or unused keys)',
+    [SYNC_EXIT_CODES.PLACEHOLDER_MISMATCH]: 'Placeholder mismatch between locales',
+    [SYNC_EXIT_CODES.EMPTY_VALUES]: 'Empty or placeholder values in locale files',
+    [SYNC_EXIT_CODES.SUSPICIOUS_KEYS]: 'Suspicious key patterns detected',
+};
+/**
+ * Human-readable descriptions for check exit codes.
+ */
+export const CHECK_EXIT_DESCRIPTIONS = {
+    [CHECK_EXIT_CODES.WARNINGS]: 'Warnings detected',
+    [CHECK_EXIT_CODES.CONFLICTS]: 'Blocking conflicts detected',
+};
+/**
+ * Human-readable descriptions for diagnostics exit codes.
+ */
+export const DIAGNOSTICS_EXIT_DESCRIPTIONS = {
+    [DIAGNOSTICS_EXIT_CODES.MISSING_SOURCE_LOCALE]: 'Missing source locale file',
+    [DIAGNOSTICS_EXIT_CODES.INVALID_LOCALE_JSON]: 'Invalid JSON in locale file',
+    [DIAGNOSTICS_EXIT_CODES.UNSAFE_PROVIDER_CLASH]: 'Provider/adapter clash detected',
+    [DIAGNOSTICS_EXIT_CODES.GENERAL_CONFLICT]: 'General diagnostics conflict',
+};
+/**
+ * All exit code descriptions by command context.
+ */
+export const EXIT_CODE_DESCRIPTIONS = {
+    general: {
+        [GENERAL_EXIT_CODES.SUCCESS]: 'Success - no issues found',
+        [GENERAL_EXIT_CODES.ERROR]: 'General error',
+    },
+    sync: SYNC_EXIT_DESCRIPTIONS,
+    check: CHECK_EXIT_DESCRIPTIONS,
+    diagnostics: DIAGNOSTICS_EXIT_DESCRIPTIONS,
+};
+/**
+ * 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 function getExitCodeDescription(code, context) {
+    // Check context-specific first
+    if (context) {
+        const contextMap = EXIT_CODE_DESCRIPTIONS[context];
+        if (contextMap[code]) {
+            return contextMap[code];
+        }
+    }
+    // Try general codes
+    if (code in EXIT_CODE_DESCRIPTIONS.general) {
+        return EXIT_CODE_DESCRIPTIONS.general[code];
+    }
+    // Search all contexts
+    for (const ctxMap of [SYNC_EXIT_DESCRIPTIONS, CHECK_EXIT_DESCRIPTIONS, DIAGNOSTICS_EXIT_DESCRIPTIONS]) {
+        if (ctxMap[code]) {
+            return ctxMap[code];
+        }
+    }
+    return `Unknown exit code: ${code}`;
+}
+/**
+ * Helper to set process exit code with optional logging.
+ *
+ * @param code - The exit code to set
+ * @param options - Optional configuration
+ */
+export function setExitCode(code, options) {
+    process.exitCode = code;
+    if (!options?.silent && code !== 0) {
+        // Only log in development/debug mode
+        if (process.env.DEBUG?.includes('i18nsmith')) {
+            console.error(`[i18nsmith] Exit code ${code}: ${getExitCodeDescription(code)}`);
+        }
+    }
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/utils/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/utils/exit-codes.ts"],"names":[],"mappings":"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"}

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/package-manager.js

@@ -0,0 +1,40 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { spawn } from 'child_process';
+export async function detectPackageManager(workspaceRoot = process.cwd()) {
+    if (await fileExists(path.join(workspaceRoot, 'pnpm-lock.yaml'))) {
+        return 'pnpm';
+    }
+    if (await fileExists(path.join(workspaceRoot, 'yarn.lock'))) {
+        return 'yarn';
+    }
+    return 'npm';
+}
+export async function installDependencies(manager, deps, workspaceRoot = process.cwd()) {
+    const args = manager === 'npm' ? ['install', ...deps] : ['add', ...deps];
+    await new Promise((resolve, reject) => {
+        const child = spawn(manager, args, {
+            cwd: workspaceRoot,
+            stdio: 'inherit',
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`${manager} exited with code ${code}`));
+            }
+        });
+    });
+}
+async function fileExists(target) {
+    try {
+        await fs.access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/utils/package-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAItC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;IACtE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAuB,EAAE,IAAc,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9G,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAEzE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG,EAAE,aAAa;YAClB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAAc;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

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/pkg.js

@@ -0,0 +1,24 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+export async function readPackageJson(cwd) {
+    const pkgPath = path.join(cwd ?? process.cwd(), 'package.json');
+    try {
+        const content = await fs.readFile(pkgPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+            return undefined;
+        }
+        console.warn('Unable to read package.json for dependency checks.');
+        return undefined;
+    }
+}
+export function hasDependency(pkg, dep) {
+    if (!pkg)
+        return false;
+    const deps = pkg.dependencies;
+    const devDeps = pkg.devDependencies;
+    return Boolean(deps?.[dep] || devDeps?.[dep]);
+}
+//# sourceMappingURL=pkg.js.map

package/dist/utils/pkg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg.js","sourceRoot":"","sources":["../../src/utils/pkg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAY;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;IACxD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrF,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAwC,EAAE,GAAW;IACjF,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,YAAmD,CAAC;IACrE,MAAM,OAAO,GAAG,GAAG,CAAC,eAAsD,CAAC;IAC3E,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC"}

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.js

@@ -0,0 +1,223 @@
+import path from 'path';
+import { promises as fs } from 'fs';
+import { createTwoFilesPatch } from 'diff';
+import { Node, Project, SyntaxKind, } from 'ts-morph';
+const DEFAULT_PROVIDER_CANDIDATES = [
+    // Next.js App Router patterns
+    'app/providers.tsx',
+    'app/providers.ts',
+    'app/providers.jsx',
+    'app/providers.js',
+    'src/app/providers.tsx',
+    'src/app/providers.ts',
+    'src/app/providers.jsx',
+    'src/app/providers.js',
+    // Next.js layout files (common provider host)
+    'app/layout.tsx',
+    'app/layout.ts',
+    'app/layout.jsx',
+    'app/layout.js',
+    'src/app/layout.tsx',
+    'src/app/layout.ts',
+    'src/app/layout.jsx',
+    'src/app/layout.js',
+    // Generic provider wrappers
+    'src/providers.tsx',
+    'src/providers.ts',
+    'src/providers.jsx',
+    'src/providers.js',
+];
+const KNOWN_I18N_PROVIDERS = [
+    'I18nProvider',
+    'IntlProvider', // react-intl
+    'NextIntlClientProvider', // next-intl
+    'NextIntlProvider', // next-intl (older)
+    'I18nextProvider', // react-i18next
+    'TranslationProvider', // common custom name
+    'LocaleProvider', // common custom name
+    'LanguageProvider', // common custom name
+];
+/**
+ * Detect if any provider file exists and whether an i18n provider is already wired.
+ */
+export async function detectExistingProvider(candidates = DEFAULT_PROVIDER_CANDIDATES) {
+    const workspaceRoot = process.cwd();
+    const existingFiles = [];
+    for (const candidate of candidates) {
+        const absoluteCandidate = path.resolve(workspaceRoot, candidate);
+        if (await fileExists(absoluteCandidate)) {
+            existingFiles.push(candidate);
+        }
+    }
+    if (existingFiles.length === 0) {
+        return { found: false, candidates: [] };
+    }
+    // Check each existing file for an i18n provider
+    for (const file of existingFiles) {
+        const absolutePath = path.resolve(workspaceRoot, file);
+        const contents = await fs.readFile(absolutePath, 'utf8');
+        const project = new Project({
+            useInMemoryFileSystem: false,
+            skipAddingFilesFromTsConfig: true,
+        });
+        const sourceFile = project.createSourceFile(absolutePath, contents, { overwrite: true });
+        const detectedProvider = getDetectedProvider(sourceFile);
+        if (detectedProvider) {
+            return {
+                found: true,
+                file,
+                provider: detectedProvider,
+                candidates: existingFiles,
+            };
+        }
+    }
+    // Files exist but no provider detected
+    return { found: false, candidates: existingFiles };
+}
+/**
+ * Returns the name of the detected i18n provider, or undefined if none found.
+ */
+function getDetectedProvider(sourceFile) {
+    for (const pattern of KNOWN_I18N_PROVIDERS) {
+        const hasPattern = sourceFile
+            .getDescendantsOfKind(SyntaxKind.JsxOpeningElement)
+            .some((element) => getTagName(element) === pattern) ||
+            sourceFile
+                .getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)
+                .some((element) => getTagName(element) === pattern);
+        if (hasPattern) {
+            return pattern;
+        }
+    }
+    return undefined;
+}
+export async function maybeInjectProvider(options) {
+    const { providerComponentPath, candidates = DEFAULT_PROVIDER_CANDIDATES, dryRun = false } = options;
+    const workspaceRoot = process.cwd();
+    const providerAbsolute = path.resolve(providerComponentPath);
+    for (const candidate of candidates) {
+        const absoluteCandidate = path.resolve(workspaceRoot, candidate);
+        if (!(await fileExists(absoluteCandidate))) {
+            continue;
+        }
+        const injection = await injectIntoCandidate({
+            candidateRelativePath: candidate,
+            candidateAbsolutePath: absoluteCandidate,
+            providerAbsolutePath: providerAbsolute,
+            dryRun,
+        });
+        if (injection.status === 'not-found') {
+            // Should never happen because we only call when file exists, but keep for safety
+            continue;
+        }
+        return injection;
+    }
+    return { status: 'not-found' };
+}
+async function injectIntoCandidate({ candidateRelativePath, candidateAbsolutePath, providerAbsolutePath, dryRun, }) {
+    const originalContents = await fs.readFile(candidateAbsolutePath, 'utf8');
+    const project = new Project({
+        useInMemoryFileSystem: false,
+        skipAddingFilesFromTsConfig: true,
+    });
+    const sourceFile = project.createSourceFile(candidateAbsolutePath, originalContents, { overwrite: true });
+    const existingProvider = getDetectedProvider(sourceFile);
+    if (existingProvider) {
+        return { status: 'skipped', file: candidateRelativePath, existingProvider };
+    }
+    const childrenExpressions = findChildrenExpressions(sourceFile);
+    if (childrenExpressions.length === 0) {
+        return {
+            status: 'failed',
+            file: candidateRelativePath,
+            reason: 'No `{children}` expression found to wrap with <I18nProvider>.',
+        };
+    }
+    if (childrenExpressions.length > 1) {
+        return {
+            status: 'failed',
+            file: candidateRelativePath,
+            reason: 'Multiple `{children}` expressions detected; unsure which one to wrap.',
+        };
+    }
+    const providerImportPath = toRelativeImport(path.dirname(candidateAbsolutePath), providerAbsolutePath);
+    ensureProviderImport(sourceFile, providerImportPath);
+    const expression = childrenExpressions[0];
+    expression.replaceWithText(`<I18nProvider>${expression.getText()}</I18nProvider>`);
+    const updatedContents = sourceFile.getFullText();
+    if (updatedContents === originalContents) {
+        return { status: 'skipped', file: candidateRelativePath };
+    }
+    const diff = createTwoFilesPatch(candidateRelativePath, candidateRelativePath, originalContents, updatedContents, '', '');
+    if (dryRun) {
+        return { status: 'preview', file: candidateRelativePath, diff };
+    }
+    await fs.writeFile(candidateAbsolutePath, updatedContents, 'utf8');
+    return { status: 'injected', file: candidateRelativePath, diff };
+}
+function getTagName(element) {
+    return element.getTagNameNode().getText();
+}
+function findChildrenExpressions(sourceFile) {
+    return sourceFile
+        .getDescendantsOfKind(SyntaxKind.JsxExpression)
+        .filter((expression) => {
+        const inner = expression.getExpression();
+        return inner && Node.isIdentifier(inner) && inner.getText() === 'children';
+    });
+}
+function ensureProviderImport(sourceFile, moduleSpecifier) {
+    const providerIdentifier = 'I18nProvider';
+    const existing = sourceFile.getImportDeclaration((declaration) => {
+        const spec = declaration.getModuleSpecifierSourceFile();
+        if (spec && spec.getFilePath() === moduleSpecifier) {
+            return true;
+        }
+        return declaration.getModuleSpecifierValue() === moduleSpecifier;
+    });
+    if (existing) {
+        const hasNamed = existing
+            .getNamedImports()
+            .some((namedImport) => namedImport.getName() === providerIdentifier);
+        if (!hasNamed) {
+            existing.addNamedImport(providerIdentifier);
+        }
+        return;
+    }
+    const statements = sourceFile.getStatements();
+    let insertIndex = 0;
+    for (const statement of statements) {
+        if (Node.isExpressionStatement(statement)) {
+            const expression = statement.getExpression();
+            if (Node.isStringLiteral(expression)) {
+                const literal = expression.getLiteralText();
+                if (literal.startsWith('use ')) {
+                    insertIndex += 1;
+                    continue;
+                }
+            }
+        }
+        break;
+    }
+    sourceFile.insertImportDeclaration(insertIndex, {
+        moduleSpecifier,
+        namedImports: [{ name: providerIdentifier }],
+    });
+}
+async function fileExists(target) {
+    try {
+        await fs.access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function toRelativeImport(fromDir, targetAbsolute) {
+    let relative = path.relative(fromDir, targetAbsolute).replace(/\\/g, '/');
+    if (!relative.startsWith('.')) {
+        relative = `./${relative}`;
+    }
+    return relative.replace(/\.(ts|tsx|js|jsx)$/i, '');
+}
+//# sourceMappingURL=provider-injector.js.map