i18next-cli 1.38.2 → 1.39.0

package/README.md

@@ -33,7 +33,7 @@ A unified, high-performance i18next CLI toolchain, powered by SWC.
 
 ## Features
 
-- **Key Extraction**: Extract translation keys from JavaScript/TypeScript files with advanced AST analysis.
+- **Key Extraction**: Extraction means automatically finding and collecting all translation keys used in your source code (JavaScript/TypeScript, etc.) by analyzing the code's structure (AST). This ensures every string that needs translation is identified and included in your translation files, reducing manual work and preventing missing keys.
 - **Type Safety**: Generate TypeScript definitions for full autocomplete and type safety.
 - **Locale Synchronization**: Keep all language files in sync with your primary language.
 - **Accurate Code Linting**: Detect hardcoded strings with high precision and configurable rules.

package/dist/cjs/cli.js

@@ -28,7 +28,7 @@ const program = new commander.Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.38.2'); // This string is replaced with the actual version at build time by rollup
+    .version('1.39.0'); // This string is replaced with the actual version at build time by rollup
 // new: global config override option
 program.option('-c, --config <path>', 'Path to i18next-cli config file (overrides detection)');
 program

package/dist/cjs/rename-key.js

@@ -307,28 +307,56 @@ async function updateTranslationFiles(oldParts, newParts, config, dryRun, logger
     const results = [];
     const keySeparator = config.extract.keySeparator ?? '.';
     for (const locale of config.locales) {
-        const outputPath = fileUtils.getOutputPath(config.extract.output, locale, oldParts.namespace);
-        const fullPath = node_path.resolve(process.cwd(), outputPath);
+        const oldOutputPath = fileUtils.getOutputPath(config.extract.output, locale, oldParts.namespace);
+        const oldFullPath = node_path.resolve(process.cwd(), oldOutputPath);
+        const newOutputPath = fileUtils.getOutputPath(config.extract.output, locale, newParts.namespace);
+        const newFullPath = node_path.resolve(process.cwd(), newOutputPath);
+        let oldTranslations;
+        let newTranslations;
         try {
-            const translations = await fileUtils.loadTranslationFile(fullPath);
-            if (!translations)
-                continue;
-            const oldValue = nestedObject.getNestedValue(translations, oldParts.key, keySeparator);
-            if (oldValue === undefined)
-                continue;
-            // Remove old key
-            deleteNestedValue(translations, oldParts.key, keySeparator);
-            // Add new key with same value
-            nestedObject.setNestedValue(translations, newParts.key, oldValue, keySeparator);
+            oldTranslations = await fileUtils.loadTranslationFile(oldFullPath);
+        }
+        catch { }
+        if (!oldTranslations)
+            continue;
+        const oldValue = nestedObject.getNestedValue(oldTranslations, oldParts.key, keySeparator);
+        if (oldValue === undefined)
+            continue;
+        if (oldParts.namespace === newParts.namespace) {
+            // Rename within the same namespace
+            deleteNestedValue(oldTranslations, oldParts.key, keySeparator);
+            nestedObject.setNestedValue(oldTranslations, newParts.key, oldValue, keySeparator);
             if (!dryRun) {
-                const content = fileUtils.serializeTranslationFile(translations, config.extract.outputFormat, config.extract.indentation);
-                await promises.writeFile(fullPath, content, 'utf-8');
+                const content = fileUtils.serializeTranslationFile(oldTranslations, config.extract.outputFormat, config.extract.indentation);
+                await promises.writeFile(oldFullPath, content, 'utf-8');
             }
-            results.push({ path: fullPath, updated: true });
-            logger.info(`   ${dryRun ? '(dry-run) ' : ''}✓ ${fullPath}`);
+            results.push({ path: oldFullPath, updated: true });
+            logger.info(`   ${dryRun ? '(dry-run) ' : ''}✓ ${oldFullPath}`);
         }
-        catch (error) {
-            // File doesn't exist or couldn't be processed
+        else {
+            // Move across namespaces
+            // Remove from old namespace
+            deleteNestedValue(oldTranslations, oldParts.key, keySeparator);
+            if (!dryRun) {
+                const content = fileUtils.serializeTranslationFile(oldTranslations, config.extract.outputFormat, config.extract.indentation);
+                await promises.writeFile(oldFullPath, content, 'utf-8');
+            }
+            results.push({ path: oldFullPath, updated: true });
+            logger.info(`   ${dryRun ? '(dry-run) ' : ''}✓ ${oldFullPath}`);
+            // Add to new namespace
+            try {
+                newTranslations = await fileUtils.loadTranslationFile(newFullPath);
+            }
+            catch { }
+            if (!newTranslations)
+                newTranslations = {};
+            nestedObject.setNestedValue(newTranslations, newParts.key, oldValue, keySeparator);
+            if (!dryRun) {
+                const content = fileUtils.serializeTranslationFile(newTranslations, config.extract.outputFormat, config.extract.indentation);
+                await promises.writeFile(newFullPath, content, 'utf-8');
+            }
+            results.push({ path: newFullPath, updated: true });
+            logger.info(`   ${dryRun ? '(dry-run) ' : ''}✓ ${newFullPath}`);
         }
     }
     if (results.length > 0) {
@@ -342,13 +370,21 @@ function deleteNestedValue(obj, path, separator) {
         return;
     }
     const keys = path.split(String(separator));
-    let current = obj;
-    for (let i = 0; i < keys.length - 1; i++) {
-        if (!current[keys[i]])
-            return;
-        current = current[keys[i]];
+    function _delete(current, idx) {
+        const key = keys[idx];
+        if (idx === keys.length - 1) {
+            delete current[key];
+        }
+        else if (current[key]) {
+            const shouldDelete = _delete(current[key], idx + 1);
+            if (shouldDelete) {
+                delete current[key];
+            }
+        }
+        // Return true if current is now empty
+        return typeof current === 'object' && current !== null && Object.keys(current).length === 0;
     }
-    delete current[keys[keys.length - 1]];
+    _delete(obj, 0);
 }
 
 exports.runRenameKey = runRenameKey;

package/dist/esm/cli.js

@@ -26,7 +26,7 @@ const program = new Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.38.2'); // This string is replaced with the actual version at build time by rollup
+    .version('1.39.0'); // This string is replaced with the actual version at build time by rollup
 // new: global config override option
 program.option('-c, --config <path>', 'Path to i18next-cli config file (overrides detection)');
 program

package/dist/esm/rename-key.js

@@ -305,28 +305,56 @@ async function updateTranslationFiles(oldParts, newParts, config, dryRun, logger
     const results = [];
     const keySeparator = config.extract.keySeparator ?? '.';
     for (const locale of config.locales) {
-        const outputPath = getOutputPath(config.extract.output, locale, oldParts.namespace);
-        const fullPath = resolve(process.cwd(), outputPath);
+        const oldOutputPath = getOutputPath(config.extract.output, locale, oldParts.namespace);
+        const oldFullPath = resolve(process.cwd(), oldOutputPath);
+        const newOutputPath = getOutputPath(config.extract.output, locale, newParts.namespace);
+        const newFullPath = resolve(process.cwd(), newOutputPath);
+        let oldTranslations;
+        let newTranslations;
         try {
-            const translations = await loadTranslationFile(fullPath);
-            if (!translations)
-                continue;
-            const oldValue = getNestedValue(translations, oldParts.key, keySeparator);
-            if (oldValue === undefined)
-                continue;
-            // Remove old key
-            deleteNestedValue(translations, oldParts.key, keySeparator);
-            // Add new key with same value
-            setNestedValue(translations, newParts.key, oldValue, keySeparator);
+            oldTranslations = await loadTranslationFile(oldFullPath);
+        }
+        catch { }
+        if (!oldTranslations)
+            continue;
+        const oldValue = getNestedValue(oldTranslations, oldParts.key, keySeparator);
+        if (oldValue === undefined)
+            continue;
+        if (oldParts.namespace === newParts.namespace) {
+            // Rename within the same namespace
+            deleteNestedValue(oldTranslations, oldParts.key, keySeparator);
+            setNestedValue(oldTranslations, newParts.key, oldValue, keySeparator);
             if (!dryRun) {
-                const content = serializeTranslationFile(translations, config.extract.outputFormat, config.extract.indentation);
-                await writeFile(fullPath, content, 'utf-8');
+                const content = serializeTranslationFile(oldTranslations, config.extract.outputFormat, config.extract.indentation);
+                await writeFile(oldFullPath, content, 'utf-8');
             }
-            results.push({ path: fullPath, updated: true });
-            logger.info(`   ${dryRun ? '(dry-run) ' : ''}✓ ${fullPath}`);
+            results.push({ path: oldFullPath, updated: true });
+            logger.info(`   ${dryRun ? '(dry-run) ' : ''}✓ ${oldFullPath}`);
         }
-        catch (error) {
-            // File doesn't exist or couldn't be processed
+        else {
+            // Move across namespaces
+            // Remove from old namespace
+            deleteNestedValue(oldTranslations, oldParts.key, keySeparator);
+            if (!dryRun) {
+                const content = serializeTranslationFile(oldTranslations, config.extract.outputFormat, config.extract.indentation);
+                await writeFile(oldFullPath, content, 'utf-8');
+            }
+            results.push({ path: oldFullPath, updated: true });
+            logger.info(`   ${dryRun ? '(dry-run) ' : ''}✓ ${oldFullPath}`);
+            // Add to new namespace
+            try {
+                newTranslations = await loadTranslationFile(newFullPath);
+            }
+            catch { }
+            if (!newTranslations)
+                newTranslations = {};
+            setNestedValue(newTranslations, newParts.key, oldValue, keySeparator);
+            if (!dryRun) {
+                const content = serializeTranslationFile(newTranslations, config.extract.outputFormat, config.extract.indentation);
+                await writeFile(newFullPath, content, 'utf-8');
+            }
+            results.push({ path: newFullPath, updated: true });
+            logger.info(`   ${dryRun ? '(dry-run) ' : ''}✓ ${newFullPath}`);
         }
     }
     if (results.length > 0) {
@@ -340,13 +368,21 @@ function deleteNestedValue(obj, path, separator) {
         return;
     }
     const keys = path.split(String(separator));
-    let current = obj;
-    for (let i = 0; i < keys.length - 1; i++) {
-        if (!current[keys[i]])
-            return;
-        current = current[keys[i]];
+    function _delete(current, idx) {
+        const key = keys[idx];
+        if (idx === keys.length - 1) {
+            delete current[key];
+        }
+        else if (current[key]) {
+            const shouldDelete = _delete(current[key], idx + 1);
+            if (shouldDelete) {
+                delete current[key];
+            }
+        }
+        // Return true if current is now empty
+        return typeof current === 'object' && current !== null && Object.keys(current).length === 0;
     }
-    delete current[keys[keys.length - 1]];
+    _delete(obj, 0);
 }
 
 export { runRenameKey };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.38.2",
+  "version": "1.39.0",
   "description": "A unified, high-performance i18next CLI.",
   "type": "module",
   "bin": {