locai 2.2.0 → 2.4.0

package/dist/commands/interactive-review.js

@@ -0,0 +1,109 @@
+import prompts from "prompts";
+import fs from "fs";
+import path from "path";
+import ConfidenceScorer from "../utils/confidence-scorer.js";
+export class InteractiveReviewer {
+    queue;
+    decisions;
+    constructor() {
+        this.queue = [];
+        this.decisions = {
+            accepted: [],
+            edited: [],
+            rejected: [],
+            skipped: [],
+        };
+    }
+    loadQueue() {
+        const reviewFile = path.join(process.cwd(), ".localize-cache", "review-queue.json");
+        if (!fs.existsSync(reviewFile))
+            return false;
+        try {
+            const data = JSON.parse(fs.readFileSync(reviewFile, "utf8"));
+            this.queue = data.items || [];
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    async start() {
+        if (!this.loadQueue() || this.queue.length === 0) {
+            console.log("No items to review.");
+            return;
+        }
+        console.clear();
+        console.log(`\n🔍 Interactive Review Mode (${this.queue.length} items)\n`);
+        for (let i = 0; i < this.queue.length; i++) {
+            const item = this.queue[i];
+            const progress = `[${i + 1}/${this.queue.length}]`;
+            console.log(`\n${progress} ${item.language.toUpperCase()} | Key: ${item.key}`);
+            console.log(`Confidence: ${ConfidenceScorer.formatConfidence(item.confidence.score)} (${item.confidence.level})`);
+            const response = await prompts({
+                type: "select",
+                name: "action",
+                message: `Translation: "${item.translation}"\nSource:      "${item.source}"\nAction:`,
+                choices: [
+                    { title: "✅ Approve", value: "approve" },
+                    { title: "✏️  Edit", value: "edit" },
+                    { title: "⏭️  Skip", value: "skip" },
+                    { title: "🚪 Exit", value: "exit" },
+                ],
+                initial: 0,
+            });
+            if (response.action === "exit")
+                break;
+            await this.handleAction(response.action, item);
+        }
+        this.saveDecisions();
+    }
+    async handleAction(action, item) {
+        switch (action) {
+            case "approve":
+                this.decisions.accepted.push(item);
+                break;
+            case "edit":
+                const editResponse = await prompts({
+                    type: "text",
+                    name: "newTranslation",
+                    message: "Enter new translation:",
+                    initial: item.translation,
+                });
+                if (editResponse.newTranslation) {
+                    item.translation = editResponse.newTranslation;
+                    item.edited = true;
+                    this.decisions.edited.push(item);
+                }
+                else {
+                    this.decisions.skipped.push(item);
+                }
+                break;
+            case "skip":
+                this.decisions.skipped.push(item);
+                break;
+        }
+    }
+    saveDecisions() {
+        // Reuse existing ReviewCommand logic or implement save/apply logic here
+        // For now, let's save to a decision file that ReviewCommand can pick up or apply directly
+        const cacheDir = path.join(process.cwd(), ".localize-cache");
+        if (!fs.existsSync(cacheDir))
+            fs.mkdirSync(cacheDir, { recursive: true });
+        const decisionsFile = path.join(cacheDir, "review-decisions.json");
+        const data = {
+            timestamp: new Date().toISOString(),
+            decisions: this.decisions,
+            stats: {
+                accepted: this.decisions.accepted.length,
+                edited: this.decisions.edited.length,
+                rejected: this.decisions.rejected.length,
+                skipped: this.decisions.skipped.length,
+            },
+        };
+        fs.writeFileSync(decisionsFile, JSON.stringify(data, null, 2));
+        console.log(`\n✅ Review complete! Decisions saved to ${decisionsFile}`);
+        console.log(`Run 'locai review --apply' to apply changes to files.`);
+        // Note: The existing CLI 'review' command applies immediately in its class.
+        // We might want to trigger apply here or ensuring ReviewCommand is used.
+    }
+}

package/dist/commands/review.d.ts

@@ -1,7 +1,3 @@
-/**
- * Interactive Review Command.
- * Allows manual review of low-confidence translations.
- */
 interface ReviewItem {
     key: string;
     language: string;
@@ -28,7 +24,6 @@ interface ReviewCommandConfig {
 declare class ReviewCommand {
     private config;
     private reviewQueue;
-    private currentIndex;
     private decisions;
     /**
      * Initialize ReviewCommand.
@@ -44,35 +39,10 @@ declare class ReviewCommand {
      * Start interactive review session.
      */
     startReview(): Promise<void>;
-    /**
-     * Review a single translation item.
-     * @param {ReviewItem} item - Translation item to review.
-     * @param {number} current - Current item index (1-based).
-     * @param {number} total - Total items.
-     * @returns {Promise<string>} - Decision result.
-     */
-    reviewItem(item: ReviewItem, current: number, total: number): Promise<string>;
     /**
      * Handle user action input.
-     * @param {string} action - User action code.
-     * @param {ReviewItem} item - Current item.
-     * @returns {Promise<string>} - Result status.
-     */
-    handleAction(action: string, item: ReviewItem): Promise<string>;
-    /**
-     * Edit translation interactively.
-     * @param {ReviewItem} item - Item to edit.
-     * @returns {Promise<ReviewItem>} - Edited item.
-     */
-    editTranslation(item: ReviewItem): Promise<ReviewItem>;
-    /**
-     * Show help information to the user.
-     */
-    showHelp(): void;
-    /**
-     * Show summary of review session.
      */
-    showSummary(): void;
+    private handleAction;
     /**
      * Save review decisions to disk and apply them.
      */
@@ -88,12 +58,6 @@ declare class ReviewCommand {
      * @param {any} value - Value to set.
      */
     setNestedValue(obj: any, path: string, value: any): void;
-    /**
-     * Get user input from terminal.
-     * @param {string} prompt - Prompt to display.
-     * @returns {Promise<string>} - User input.
-     */
-    getUserInput(prompt: string): Promise<string>;
     /**
      * Export review queue to JSON.
      * @param {string} format - Export format (json or csv).

package/dist/commands/review.js

@@ -1,15 +1,10 @@
-/**
- * Interactive Review Command.
- * Allows manual review of low-confidence translations.
- */
 import fs from "fs";
 import path from "path";
-import readline from "readline";
+import prompts from "prompts";
 import ConfidenceScorer from "../utils/confidence-scorer.js";
 class ReviewCommand {
     config;
     reviewQueue;
-    currentIndex;
     decisions;
     /**
      * Initialize ReviewCommand.
@@ -18,7 +13,6 @@ class ReviewCommand {
     constructor(config) {
         this.config = config;
         this.reviewQueue = [];
-        this.currentIndex = 0;
         this.decisions = {
             accepted: [],
             edited: [],
@@ -40,7 +34,6 @@ class ReviewCommand {
         try {
             const data = JSON.parse(fs.readFileSync(reviewFile, "utf8"));
             this.reviewQueue = data.items || [];
-            console.log(`\nLoaded ${this.reviewQueue.length} items for review\n`);
             return true;
         }
         catch (error) {
@@ -56,159 +49,63 @@ class ReviewCommand {
             return;
         }
         if (this.reviewQueue.length === 0) {
-            console.log("\nNo items need review. All translations meet quality threshold!\n");
+            console.log("No items to review.");
             return;
         }
-        console.log("━".repeat(70));
-        console.log(`Review Queue: ${this.reviewQueue.length} translations need attention`);
-        console.log("━".repeat(70));
+        console.clear();
+        console.log(`\nInteractive Review Mode (${this.reviewQueue.length} items)\n`);
         for (let i = 0; i < this.reviewQueue.length; i++) {
-            this.currentIndex = i;
             const item = this.reviewQueue[i];
-            const decision = await this.reviewItem(item, i + 1, this.reviewQueue.length);
-            if (decision === "quit") {
+            const progress = `[${i + 1}/${this.reviewQueue.length}]`;
+            console.log(`\n${progress} ${item.language.toUpperCase()} | Key: ${item.key}`);
+            console.log(`Confidence: ${ConfidenceScorer.formatConfidence(item.confidence.score)} (${item.confidence.level})`);
+            const response = await prompts({
+                type: "select",
+                name: "action",
+                message: `Translation: "${item.translation}"\nSource:      "${item.source}"\nAction:`,
+                choices: [
+                    { title: "[Approve]", value: "approve" },
+                    { title: "[Edit]", value: "edit" },
+                    { title: "[Skip]", value: "skip" },
+                    { title: "[Exit]", value: "exit" },
+                ],
+                initial: 0,
+            });
+            if (response.action === "exit")
                 break;
-            }
+            await this.handleAction(response.action, item);
         }
-        this.showSummary();
         this.saveDecisions();
     }
-    /**
-     * Review a single translation item.
-     * @param {ReviewItem} item - Translation item to review.
-     * @param {number} current - Current item index (1-based).
-     * @param {number} total - Total items.
-     * @returns {Promise<string>} - Decision result.
-     */
-    async reviewItem(item, current, total) {
-        console.log(`\n[${current}/${total}] Translation Review`);
-        console.log("━".repeat(70));
-        console.log(`Key:        ${item.key}`);
-        console.log(`Language:   ${item.language}`);
-        const score = item.confidence?.score || 0;
-        const level = item.confidence?.level || "unknown";
-        console.log(`Confidence: ${ConfidenceScorer.formatConfidence(score)} (${level})`);
-        console.log(`Category:   ${item.category || "general"}`);
-        console.log(`\nSource:`);
-        console.log(`  "${item.source}"`);
-        console.log(`\nTranslation:`);
-        console.log(`  "${item.translation}"`);
-        // Show issues if any
-        if (item.confidence?.issues && item.confidence.issues.length > 0) {
-            console.log(`\nIssues Detected:`);
-            item.confidence.issues.forEach((issue) => {
-                const icon = issue.severity === "critical" ? "[!]" : "[*]";
-                console.log(`  ${icon} ${issue.message}`);
-            });
-        }
-        console.log(`\nActions:`);
-        console.log(`  [A] Accept    [E] Edit    [R] Reject    [S] Skip`);
-        console.log(`  [N] Next      [Q] Quit    [?] Help`);
-        const action = await this.getUserInput("\nYour choice: ");
-        return this.handleAction(action.toLowerCase(), item);
-    }
     /**
      * Handle user action input.
-     * @param {string} action - User action code.
-     * @param {ReviewItem} item - Current item.
-     * @returns {Promise<string>} - Result status.
      */
     async handleAction(action, item) {
         switch (action) {
-            case "a":
-            case "accept":
+            case "approve":
                 this.decisions.accepted.push(item);
-                console.log("Accepted");
-                return "continue";
+                break;
             case "edit": {
-                const edited = await this.editTranslation(item);
-                this.decisions.edited.push(edited);
-                console.log("Edited and saved");
-                return "continue";
+                const editResponse = await prompts({
+                    type: "text",
+                    name: "newTranslation",
+                    message: "Enter new translation:",
+                    initial: item.translation,
+                });
+                if (editResponse.newTranslation) {
+                    item.translation = editResponse.newTranslation;
+                    item.edited = true;
+                    this.decisions.edited.push(item);
+                }
+                else {
+                    this.decisions.skipped.push(item);
+                }
+                break;
             }
-            case "r":
-            case "reject":
-                this.decisions.rejected.push(item);
-                console.log("Rejected - will be retranslated");
-                return "continue";
-            case "s":
             case "skip":
                 this.decisions.skipped.push(item);
-                console.log("Skipped");
-                return "continue";
-            case "n":
-            case "next":
-                return "continue";
-            case "q":
-            case "quit":
-                console.log("\n👋 Exiting review session...");
-                return "quit";
-            case "?":
-            case "help":
-                this.showHelp();
-                return this.handleAction(await this.getUserInput("\nYour choice: "), item);
-            default:
-                console.log("Invalid action. Try again.");
-                return this.handleAction(await this.getUserInput("\nYour choice: "), item);
-        }
-    }
-    /**
-     * Edit translation interactively.
-     * @param {ReviewItem} item - Item to edit.
-     * @returns {Promise<ReviewItem>} - Edited item.
-     */
-    async editTranslation(item) {
-        console.log(`\nCurrent: "${item.translation}"`);
-        const newTranslation = await this.getUserInput("New translation: ");
-        if (newTranslation.trim() === "") {
-            console.log("Warning: Empty translation, keeping original");
-            return item;
+                break;
         }
-        // Recalculate confidence for edited translation
-        const newConfidence = ConfidenceScorer.calculateConfidence({
-            aiConfidence: 1.0, // Manual edit gets high confidence
-            sourceText: item.source,
-            translation: newTranslation,
-            sourceLang: item.sourceLang || this.config.source,
-            targetLang: item.language,
-            provider: "manual",
-            category: item.category,
-        });
-        return {
-            ...item,
-            translation: newTranslation,
-            confidence: newConfidence,
-            edited: true,
-            editedAt: new Date().toISOString(),
-        };
-    }
-    /**
-     * Show help information to the user.
-     */
-    showHelp() {
-        console.log("\n━━━ Help ━━━");
-        console.log("A (Accept):  Approve translation as-is");
-        console.log("E (Edit):    Modify the translation manually");
-        console.log("R (Reject):  Mark for retranslation");
-        console.log("S (Skip):    Skip for now, review later");
-        console.log("N (Next):    Skip to next item");
-        console.log("Q (Quit):    Exit review session");
-        console.log("? (Help):    Show this help message");
-        console.log("━".repeat(70));
-    }
-    /**
-     * Show summary of review session.
-     */
-    showSummary() {
-        console.log("\n━".repeat(70));
-        console.log("Review Summary");
-        console.log("━".repeat(70));
-        console.log(`Accepted:  ${this.decisions.accepted.length}`);
-        console.log(`Edited:    ${this.decisions.edited.length}`);
-        console.log(`Rejected:  ${this.decisions.rejected.length}`);
-        console.log(`Skipped:   ${this.decisions.skipped.length}`);
-        console.log(`Total:     ${this.decisions.accepted.length + this.decisions.edited.length + this.decisions.rejected.length + this.decisions.skipped.length}/${this.reviewQueue.length}`);
-        console.log("━".repeat(70));
     }
     /**
      * Save review decisions to disk and apply them.
@@ -230,7 +127,7 @@ class ReviewCommand {
             },
         };
         fs.writeFileSync(decisionsFile, JSON.stringify(data, null, 2));
-        console.log(`\nDecisions saved to: ${decisionsFile}`);
+        console.log(`\nReview complete! Decisions saved to ${decisionsFile}`);
         // Apply accepted and edited translations
         this.applyDecisions();
     }
@@ -284,23 +181,6 @@ class ReviewCommand {
         }
         current[keys[keys.length - 1]] = value;
     }
-    /**
-     * Get user input from terminal.
-     * @param {string} prompt - Prompt to display.
-     * @returns {Promise<string>} - User input.
-     */
-    getUserInput(prompt) {
-        return new Promise((resolve) => {
-            const rl = readline.createInterface({
-                input: process.stdin,
-                output: process.stdout,
-            });
-            rl.question(prompt, (answer) => {
-                rl.close();
-                resolve(answer.trim());
-            });
-        });
-    }
     /**
      * Export review queue to JSON.
      * @param {string} format - Export format (json or csv).

package/dist/commands/translator.d.ts

@@ -1,4 +1,4 @@
-import { TranslationOptions, GlobalStats } from "../services/translation-service.js";
+import { GlobalStats, TranslationOptions } from "../types/index.js";
 /**
  * Main translator function to process source file and create translations.
  * @param {string} file - Source file path.

package/dist/config/index.d.ts

@@ -143,3 +143,4 @@ export declare function loadConfig(cwd?: string): Promise<{
     configFile: string | undefined;
     layers: ConfigLayer<LocalizeConfig, import("c12").ConfigLayerMeta>[] | undefined;
 }>;
+export declare const validateEnvironment: (config?: any) => void;

package/dist/config/index.js

@@ -50,3 +50,29 @@ export async function loadConfig(cwd = process.cwd()) {
         layers,
     };
 }
+export const validateEnvironment = (config) => {
+    const providerMap = {
+        openai: "OPENAI_API_KEY",
+        anthropic: "ANTHROPIC_API_KEY",
+        gemini: "GEMINI_API_KEY",
+        deepseek: "DEEPSEEK_API_KEY",
+        xai: "XAI_API_KEY",
+        dashscope: "DASHSCOPE_API_KEY",
+    };
+    // If a specific provider is configured, check its key
+    if (config?.apiProvider && config.apiProvider !== "auto") {
+        const requiredKey = providerMap[config.apiProvider];
+        if (requiredKey && !process.env[requiredKey]) {
+            console.warn(`\n\u26a0\ufe0f  Warning: ${requiredKey} is missing for provider '${config.apiProvider}'`);
+            console.warn(`   Please add it to your .env file or environment variables.\n`);
+        }
+        return;
+    }
+    // If auto or no provider, check if ANY valid key exists
+    const hasAnyKey = Object.values(providerMap).some((key) => process.env[key]);
+    if (!hasAnyKey) {
+        console.warn("\n\u26a0\ufe0f  Warning: No supported API keys found in environment.");
+        console.warn("   Supported keys: " + Object.values(providerMap).join(", "));
+        console.warn("   Please add at least one to your .env file.\n");
+    }
+};

package/dist/config/setup.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Load environment variables from .env files.
+ * Prioritizes .env.local over .env.
+ */
+export declare const loadEnvironmentVariables: () => Promise<void>;
+/**
+ * Configure global components (logger, rate limiter, etc.).
+ * @param {any} config - Configuration object.
+ */
+export declare const configureComponents: (config: any) => void;

package/dist/config/setup.js

@@ -0,0 +1,79 @@
+import dotenv from "dotenv";
+import { promises as fs } from "fs";
+import path from "path";
+import { FileManager } from "../utils/file-manager.js";
+import { getLogger } from "../utils/logger.js";
+import rateLimiter from "../utils/rate-limiter.js";
+/**
+ * Load environment variables from .env files.
+ * Prioritizes .env.local over .env.
+ */
+export const loadEnvironmentVariables = async () => {
+    // Load environment files in priority order
+    // First load .env (base defaults), then .env.local (local overrides)
+    // This ensures .env.local values take precedence over .env values
+    const envFiles = [
+        { file: ".env", override: false },
+        { file: ".env.local", override: true },
+    ];
+    let loadedCount = 0;
+    for (const { file: envFile, override } of envFiles) {
+        const envPath = path.resolve(process.cwd(), envFile);
+        try {
+            await fs.access(envPath);
+            const result = dotenv.config({ path: envPath, override });
+            if (!result.error) {
+                loadedCount++;
+                // Only log in verbose/debug mode to reduce noise
+                if (process.env.VERBOSE || process.env.DEBUG) {
+                    console.log(`Loaded environment variables from ${envFile}`);
+                }
+            }
+        }
+        catch (error) {
+            // ENOENT is expected when files don't exist - silently skip
+            if (error.code !== "ENOENT") {
+                console.warn(`Warning: Could not load ${envFile}: ${error.message}`);
+            }
+        }
+    }
+    // Informative message only if verbose/debug and at least one file was loaded
+    if ((process.env.VERBOSE || process.env.DEBUG) && loadedCount > 0) {
+        console.log(`Environment: ${loadedCount} file(s) loaded`);
+    }
+};
+/**
+ * Configure global components (logger, rate limiter, etc.).
+ * @param {any} config - Configuration object.
+ */
+export const configureComponents = (config) => {
+    // Configure FileManager with config settings
+    if (config.fileOperations) {
+        FileManager.configure(config.fileOperations);
+    }
+    // Initialize logger with config
+    if (config.logging) {
+        const logger = getLogger(config.logging);
+        if (config.logging.verbose || config.debug) {
+            logger.info("Logger initialized", {
+                saveErrorLogs: config.logging.saveErrorLogs,
+                logDirectory: config.logging.logDirectory,
+                rotationEnabled: config.logging.logRotation?.enabled,
+            });
+        }
+    }
+    if (config.rateLimiter) {
+        rateLimiter.updateConfig({
+            queueStrategy: config.rateLimiter.queueStrategy || "priority",
+            queueTimeout: config.rateLimiter.queueTimeout || 30000,
+            adaptiveThrottling: config.rateLimiter.adaptiveThrottling !== false,
+            providerLimits: config.rateLimiter.providerLimits,
+        });
+    }
+    if (config.advanced?.debug) {
+        process.env.DEBUG = "true";
+    }
+    if (config.logging?.verbose) {
+        process.env.VERBOSE = "true";
+    }
+};

package/dist/core/adapters/android-adapter.d.ts

@@ -0,0 +1,12 @@
+import { FileFormatAdapter } from "./base-adapter.js";
+/**
+ * Adapter for Android XML resources files (strings.xml)
+ */
+export declare class AndroidAdapter implements FileFormatAdapter {
+    extensions: string[];
+    private parser;
+    private builder;
+    constructor();
+    parse(content: string): Promise<Record<string, any>>;
+    serialize(data: Record<string, any>): Promise<string>;
+}