i18nsmith 0.1.0

package/dist/commands/translate/index.js

@@ -0,0 +1,170 @@
+/**
+ * Translate command - fill missing locale entries via translation adapters
+ */
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { DEFAULT_PLACEHOLDER_FORMATS, PlaceholderValidator, loadConfig, TranslationService, } from '@i18nsmith/core';
+import { TranslatorLoadError } from '@i18nsmith/translation';
+import { emitTranslateOutput, maybePrintEstimate } from './reporter.js';
+import { handleCsvExport, handleCsvImport } from './csv-handler.js';
+import { executeTranslations } from './executor.js';
+// Re-export types for external use
+export * from './types.js';
+/**
+ * Parse comma-separated locale values
+ */
+function collectLocales(value, previous) {
+    const tokens = (Array.isArray(value) ? value : value.split(','))
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    return [...previous, ...tokens];
+}
+/**
+ * Resolve provider settings from config and options
+ */
+function resolveProviderSettings(translationConfig, override) {
+    const providerName = (override ?? translationConfig?.provider ?? 'manual').trim();
+    const moduleSpecifier = translationConfig?.module;
+    let secret;
+    if (translationConfig?.secretEnvVar) {
+        secret = process.env[translationConfig.secretEnvVar];
+    }
+    const loaderOptions = {
+        provider: providerName,
+        module: moduleSpecifier,
+        apiKey: translationConfig?.apiKey,
+        secret,
+        concurrency: translationConfig?.concurrency,
+        batchSize: translationConfig?.batchSize,
+        config: translationConfig ? { ...translationConfig } : undefined,
+    };
+    return {
+        name: providerName,
+        loaderOptions,
+    };
+}
+/**
+ * Prompt for translation confirmation
+ */
+async function confirmTranslate(plan, providerName) {
+    const { proceed } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'proceed',
+            default: false,
+            message: `Translate ${plan.totalTasks} key${plan.totalTasks === 1 ? '' : 's'} (${plan.totalCharacters} chars) across ${plan.locales.length} locale${plan.locales.length === 1 ? '' : 's'} via ${providerName}?`,
+        },
+    ]);
+    return proceed;
+}
+/**
+ * Register the translate command
+ */
+export function registerTranslate(program) {
+    program
+        .command('translate')
+        .description('Fill missing locale entries by invoking configured translation adapters')
+        .option('-c, --config <path>', 'Path to i18nsmith config file', 'i18n.config.json')
+        .option('--json', 'Print raw JSON results', false)
+        .option('--report <path>', 'Write JSON summary to a file')
+        .option('--write', 'Write translated values to locale files (defaults to dry-run)', false)
+        .option('--locales <codes...>', 'Comma-separated list of locale codes to translate', collectLocales, [])
+        .option('--provider <name>', 'Override the translation provider configured in i18n.config.json')
+        .option('--force', 'Retranslate keys even if a locale already has a value', false)
+        .option('--estimate', 'Attempt to estimate cost when running in dry-run mode', false)
+        .option('--no-skip-empty', 'Allow writing empty translator results (default skips them)')
+        .option('-y, --yes', 'Skip interactive confirmation when applying translations', false)
+        .option('--strict-placeholders', 'Fail if translated output has placeholder mismatches (for CI)', false)
+        .option('--export <path>', 'Export missing translations to a CSV file for external translation')
+        .option('--import <path>', 'Import translations from a CSV file and merge into locale files')
+        .action(async (options) => {
+        // Handle CSV export mode
+        if (options.export) {
+            await handleCsvExport(options);
+            return;
+        }
+        // Handle CSV import mode
+        if (options.import) {
+            await handleCsvImport(options);
+            return;
+        }
+        console.log(chalk.blue(options.write ? 'Translating locale files...' : 'Planning translations (dry-run)...'));
+        try {
+            const config = await loadConfig(options.config);
+            const translationService = new TranslationService(config);
+            const plan = await translationService.buildPlan({
+                locales: options.locales,
+                force: options.force,
+            });
+            const placeholderValidator = new PlaceholderValidator(config.sync?.placeholderFormats?.length ? config.sync.placeholderFormats : DEFAULT_PLACEHOLDER_FORMATS);
+            if (!plan.totalTasks) {
+                console.log(chalk.green('✓ No missing translations detected.'));
+                return;
+            }
+            const providerSettings = resolveProviderSettings(config.translation, options.provider);
+            const summary = {
+                provider: providerSettings.name,
+                dryRun: !options.write,
+                plan,
+                locales: [],
+                localeStats: [],
+                totalCharacters: plan.totalCharacters,
+            };
+            if (!options.write) {
+                if (options.estimate && providerSettings.name !== 'manual') {
+                    await maybePrintEstimate(plan, providerSettings);
+                }
+                await emitTranslateOutput(summary, options);
+                return;
+            }
+            if (providerSettings.name === 'manual') {
+                throw new Error('No translation provider configured. Update "translation.provider" in i18n.config.json or pass --provider.');
+            }
+            if (options.write && !options.yes) {
+                if (!process.stdout.isTTY) {
+                    throw new Error('Interactive confirmation required in non-TTY environment. Re-run with --yes to proceed.');
+                }
+                const confirmed = await confirmTranslate(plan, providerSettings.name);
+                if (!confirmed) {
+                    console.log(chalk.yellow('Translation aborted by user.'));
+                    return;
+                }
+            }
+            const skipEmpty = options.skipEmpty !== false;
+            const strictPlaceholders = options.strictPlaceholders ?? false;
+            const localeResults = await executeTranslations({
+                plan,
+                translationService,
+                provider: providerSettings,
+                overwrite: options.force ?? false,
+                skipEmpty,
+                placeholderValidator,
+                strictPlaceholders,
+            });
+            summary.locales = localeResults.results;
+            summary.localeStats = localeResults.stats;
+            // Check for placeholder issues in strict mode
+            const allPlaceholderIssues = localeResults.results.flatMap((r) => r.placeholderIssues);
+            if (strictPlaceholders && allPlaceholderIssues.length > 0) {
+                console.error(chalk.red(`\n✗ ${allPlaceholderIssues.length} placeholder issue(s) detected in translated output:`));
+                allPlaceholderIssues.slice(0, 10).forEach((issue) => {
+                    console.error(chalk.red(`  • ${issue.key} (${issue.locale}): ${issue.type} placeholder${issue.placeholders.length === 1 ? '' : 's'} ${issue.placeholders.join(', ')}`));
+                });
+                if (allPlaceholderIssues.length > 10) {
+                    console.error(chalk.red(`  ... and ${allPlaceholderIssues.length - 10} more issues`));
+                }
+                process.exitCode = 1;
+            }
+            await emitTranslateOutput(summary, options);
+        }
+        catch (error) {
+            const translatorError = error instanceof TranslatorLoadError ? error : undefined;
+            const normalizedError = error instanceof Error
+                ? error
+                : new Error(typeof error === 'string' ? error : JSON.stringify(error));
+            console.error(chalk.red('Translate failed:'), translatorError?.message ?? normalizedError.message);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/translate/index.js.map

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

package/dist/commands/translate/reporter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Output formatting and reporting utilities for the translate command
+ */
+import type { TranslationPlan } from '@i18nsmith/core';
+import { type TranslatorLoadOptions } from '@i18nsmith/translation';
+import type { TranslateSummary, TranslateLocaleResult, TranslateCommandOptions, ProviderSettings } from './types.js';
+/**
+ * Emit the translation output (report file, JSON, or console)
+ */
+export declare function emitTranslateOutput(summary: TranslateSummary, options: TranslateCommandOptions): Promise<void>;
+/**
+ * Print a summary of the translation plan
+ */
+export declare function printPlanSummary(plan: TranslationPlan): void;
+/**
+ * Print the execution summary after translations are applied
+ */
+export declare function printExecutionSummary(results: TranslateLocaleResult[]): void;
+/**
+ * Print cost estimation if available
+ */
+export declare function maybePrintEstimate(plan: TranslationPlan, provider: ProviderSettings & {
+    loaderOptions: TranslatorLoadOptions;
+}): Promise<void>;
+/**
+ * Print a generic cost estimate based on common cloud provider rates
+ */
+export declare function printGenericEstimate(plan: TranslationPlan): void;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/commands/translate/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../src/commands/translate/reporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAqB5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAY5E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,gBAAgB,GAAG;IAAE,aAAa,EAAE,qBAAqB,CAAA;CAAE,GACpE,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAShE"}

package/dist/commands/translate/reporter.js

@@ -0,0 +1,103 @@
+/**
+ * Output formatting and reporting utilities for the translate command
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import chalk from 'chalk';
+import { loadTranslator } from '@i18nsmith/translation';
+/**
+ * Emit the translation output (report file, JSON, or console)
+ */
+export async function emitTranslateOutput(summary, options) {
+    if (options.report) {
+        const outputPath = path.resolve(process.cwd(), options.report);
+        await fs.mkdir(path.dirname(outputPath), { recursive: true });
+        await fs.writeFile(outputPath, JSON.stringify(summary, null, 2));
+        console.log(chalk.green(`Translate report written to ${outputPath}`));
+    }
+    if (options.json) {
+        console.log(JSON.stringify(summary, null, 2));
+        return;
+    }
+    printPlanSummary(summary.plan);
+    if (!summary.dryRun) {
+        printExecutionSummary(summary.locales);
+        const mutations = summary.localeStats.reduce((total, stat) => total + stat.added.length + stat.updated.length, 0);
+        if (mutations === 0) {
+            console.log(chalk.yellow('No locale files were updated. Translator may have skipped all entries.'));
+        }
+    }
+    else {
+        console.log(chalk.yellow('Run again with --write to apply translations.'));
+    }
+}
+/**
+ * Print a summary of the translation plan
+ */
+export function printPlanSummary(plan) {
+    console.log(chalk.green(`Source locale ${plan.sourceLocale}; ${plan.totalTasks} missing entr${plan.totalTasks === 1 ? 'y' : 'ies'} across ${plan.locales.length} locale${plan.locales.length === 1 ? '' : 's'}.`));
+    if (!plan.locales.length) {
+        console.log(chalk.green('All configured locales are up to date.'));
+        return;
+    }
+    plan.locales.forEach((localePlan) => {
+        const reuseCount = localePlan.tasks.filter((task) => task.reusedValue).length;
+        const reuseMessage = reuseCount > 0 ? chalk.gray(` (${reuseCount} reusable)`) : '';
+        console.log(`  • ${localePlan.locale}: ${localePlan.tasks.length} key${localePlan.tasks.length === 1 ? '' : 's'} (${localePlan.totalCharacters} chars)${reuseMessage}`);
+    });
+}
+/**
+ * Print the execution summary after translations are applied
+ */
+export function printExecutionSummary(results) {
+    if (!results.length) {
+        console.log(chalk.yellow('No translations were written.'));
+        return;
+    }
+    console.log(chalk.blue('\nTranslation results:'));
+    results.forEach((result) => {
+        console.log(`  • ${result.locale}: ${result.written} written, ${result.skipped} skipped, ${result.emptySkipped} empty (${result.characters} chars)`);
+    });
+}
+/**
+ * Print cost estimation if available
+ */
+export async function maybePrintEstimate(plan, provider) {
+    console.log(chalk.blue('\n📊 Cost Estimation:'));
+    console.log(chalk.gray(`  Provider: ${provider.name}`));
+    console.log(chalk.gray(`  Total characters: ${plan.totalCharacters.toLocaleString()}`));
+    console.log(chalk.gray(`  Locales: ${plan.locales.length}`));
+    try {
+        const translator = await loadTranslator(provider.loaderOptions);
+        if (typeof translator.estimateCost === 'function') {
+            const estimate = await translator.estimateCost(plan.totalCharacters, { localeCount: plan.locales.length });
+            const formattedCost = typeof estimate === 'number'
+                ? `$${estimate.toFixed(4)}`
+                : String(estimate);
+            console.log(chalk.green(`  Estimated cost: ${formattedCost}`));
+        }
+        else {
+            console.log(chalk.yellow('  Provider does not expose cost estimation.'));
+            printGenericEstimate(plan);
+        }
+        await translator.dispose?.();
+    }
+    catch (error) {
+        console.log(chalk.yellow(`  Unable to estimate via provider: ${error.message}`));
+        printGenericEstimate(plan);
+    }
+}
+/**
+ * Print a generic cost estimate based on common cloud provider rates
+ */
+export function printGenericEstimate(plan) {
+    // Generic estimation based on common cloud provider rates (rough average)
+    // Google/AWS/Azure typically charge ~$20 per million characters
+    const ratePerMillion = 20;
+    const charsByLocale = plan.totalCharacters;
+    const totalChars = charsByLocale * plan.locales.length;
+    const estimated = (totalChars / 1000000) * ratePerMillion;
+    console.log(chalk.gray(`  Generic estimate (at ~$20/M chars): $${estimated.toFixed(4)}`));
+    console.log(chalk.gray('  (Actual costs vary by provider and tier)'));
+}
+//# sourceMappingURL=reporter.js.map

package/dist/commands/translate/reporter.js.map

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

package/dist/commands/translate/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Type definitions for the translate command
+ */
+import type { TranslationWriteSummary, TranslationPlan } from '@i18nsmith/core';
+import type { TranslationService } from '@i18nsmith/core';
+export interface TranslateCommandOptions {
+    config?: string;
+    json?: boolean;
+    report?: string;
+    write?: boolean;
+    locales?: string[];
+    provider?: string;
+    force?: boolean;
+    estimate?: boolean;
+    skipEmpty?: boolean;
+    yes?: boolean;
+    strictPlaceholders?: boolean;
+    export?: string;
+    import?: string;
+}
+export interface TranslateLocaleResult extends TranslationWriteSummary {
+    characters: number;
+    placeholderIssues: PlaceholderIssue[];
+}
+export interface PlaceholderIssue {
+    key: string;
+    locale: string;
+    type: 'missing' | 'extra';
+    placeholders: string[];
+}
+export interface TranslateSummary {
+    provider: string;
+    dryRun: boolean;
+    plan: TranslationPlan;
+    locales: TranslateLocaleResult[];
+    localeStats: Awaited<ReturnType<TranslationService['flush']>>;
+    totalCharacters: number;
+}
+export interface ProviderSettings {
+    name: string;
+    options?: Record<string, unknown>;
+}
+export interface CsvRow {
+    key: string;
+    sourceLocale: string;
+    sourceValue: string;
+    targetLocale: string;
+    targetValue: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/translate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/translate/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/commands/translate/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the translate command
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/translate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/translate/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/commands/translate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Translate command - re-exports from translate module
+ * @deprecated Import from './translate/index.js' instead
+ */
+export { registerTranslate } from './translate/index.js';
+export * from './translate/types.js';
+//# sourceMappingURL=translate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../src/commands/translate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,cAAc,sBAAsB,CAAC"}

package/dist/commands/translate.js

@@ -0,0 +1,7 @@
+/**
+ * Translate command - re-exports from translate module
+ * @deprecated Import from './translate/index.js' instead
+ */
+export { registerTranslate } from './translate/index.js';
+export * from './translate/types.js';
+//# sourceMappingURL=translate.js.map

package/dist/commands/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../src/commands/translate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,cAAc,sBAAsB,CAAC"}

package/dist/commands/translate.test.d.ts

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

package/dist/commands/translate.test.d.ts.map

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

package/dist/commands/translate.test.js

@@ -0,0 +1,118 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+describe('translate command', () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'i18nsmith-translate-test-'));
+        // Create basic project structure
+        await fs.mkdir(path.join(tempDir, 'src'), { recursive: true });
+        await fs.mkdir(path.join(tempDir, 'locales'), { recursive: true });
+        // Create source file with translation calls
+        await fs.writeFile(path.join(tempDir, 'src', 'App.tsx'), `import { useTranslation } from 'react-i18next';
+export function App() {
+  const { t } = useTranslation();
+  return <div>{t('greeting')}{t('farewell')}</div>;
+}
+`);
+        // Create source locale
+        await fs.writeFile(path.join(tempDir, 'locales', 'en.json'), JSON.stringify({ greeting: 'Hello', farewell: 'Goodbye' }, null, 2));
+        // Create target locale with one missing key
+        await fs.writeFile(path.join(tempDir, 'locales', 'fr.json'), JSON.stringify({ greeting: 'Bonjour' }, null, 2));
+        // Create config
+        await fs.writeFile(path.join(tempDir, 'i18n.config.json'), JSON.stringify({
+            version: 1,
+            sourceLanguage: 'en',
+            targetLanguages: ['fr'],
+            localesDir: 'locales',
+            include: ['src/**/*.{ts,tsx}'],
+        }, null, 2));
+    });
+    afterEach(async () => {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    const runCli = (args) => {
+        const cliPath = path.resolve(__dirname, '..', '..', 'dist', 'index.js');
+        try {
+            return execSync(`node ${cliPath} ${args}`, {
+                cwd: tempDir,
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        catch (error) {
+            const err = error;
+            return (err.stdout ?? '') + (err.stderr ?? '');
+        }
+    };
+    describe('--export', () => {
+        it('exports missing translations to CSV', async () => {
+            const csvPath = path.join(tempDir, 'missing.csv');
+            const output = runCli(`translate --export ${csvPath}`);
+            expect(output).toContain('Exported');
+            const csvContent = await fs.readFile(csvPath, 'utf8');
+            expect(csvContent).toContain('key,sourceLocale,sourceValue,targetLocale,translatedValue');
+            expect(csvContent).toContain('farewell');
+            expect(csvContent).toContain('Goodbye');
+            expect(csvContent).toContain('fr');
+        });
+        it('handles empty values correctly', async () => {
+            // All translations are present
+            await fs.writeFile(path.join(tempDir, 'locales', 'fr.json'), JSON.stringify({ greeting: 'Bonjour', farewell: 'Au revoir' }, null, 2));
+            const output = runCli('translate --export output.csv');
+            expect(output).toContain('No missing translations');
+        });
+    });
+    describe('--import', () => {
+        it('imports translations from CSV', async () => {
+            const csvPath = path.join(tempDir, 'translations.csv');
+            await fs.writeFile(csvPath, `key,sourceLocale,sourceValue,targetLocale,translatedValue
+farewell,en,Goodbye,fr,Au revoir
+`);
+            const output = runCli(`translate --import ${csvPath} --write`);
+            expect(output).toContain('1 row');
+            const frContent = await fs.readFile(path.join(tempDir, 'locales', 'fr.json'), 'utf8');
+            const frData = JSON.parse(frContent);
+            expect(frData.farewell).toBe('Au revoir');
+        });
+        it('skips rows with empty translatedValue', async () => {
+            const csvPath = path.join(tempDir, 'translations.csv');
+            await fs.writeFile(csvPath, `key,sourceLocale,sourceValue,targetLocale,translatedValue
+farewell,en,Goodbye,fr,
+`);
+            const output = runCli(`translate --import ${csvPath}`);
+            expect(output).toContain('skipped');
+        });
+        it('handles quoted CSV fields with commas', async () => {
+            // Add a source key with comma
+            await fs.writeFile(path.join(tempDir, 'locales', 'en.json'), JSON.stringify({
+                greeting: 'Hello',
+                farewell: 'Goodbye',
+                message: 'Hello, world!'
+            }, null, 2));
+            const csvPath = path.join(tempDir, 'translations.csv');
+            await fs.writeFile(csvPath, `key,sourceLocale,sourceValue,targetLocale,translatedValue
+message,en,"Hello, world!",fr,"Bonjour, le monde!"
+`);
+            const output = runCli(`translate --import ${csvPath} --write`);
+            expect(output).toContain('1 row');
+            const frContent = await fs.readFile(path.join(tempDir, 'locales', 'fr.json'), 'utf8');
+            const frData = JSON.parse(frContent);
+            expect(frData.message).toBe('Bonjour, le monde!');
+        });
+        it('dry-run mode does not write files', async () => {
+            const csvPath = path.join(tempDir, 'translations.csv');
+            await fs.writeFile(csvPath, `key,sourceLocale,sourceValue,targetLocale,translatedValue
+farewell,en,Goodbye,fr,Au revoir
+`);
+            const originalContent = await fs.readFile(path.join(tempDir, 'locales', 'fr.json'), 'utf8');
+            const output = runCli(`translate --import ${csvPath}`);
+            expect(output).toContain('DRY RUN');
+            const newContent = await fs.readFile(path.join(tempDir, 'locales', 'fr.json'), 'utf8');
+            expect(newContent).toBe(originalContent);
+        });
+    });
+});
+//# sourceMappingURL=translate.test.js.map

package/dist/commands/translate.test.js.map

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

package/dist/e2e.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * E2E Tests using fixture projects
+ * These tests run against pre-configured fixture projects to test real-world scenarios
+ */
+export {};
+//# sourceMappingURL=e2e.test.d.ts.map

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

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