i18next-cli 1.60.0 → 1.61.1

package/README.md

@@ -204,6 +204,8 @@ npx i18next-cli extract --watch --with-types
 
 Displays a health check of your project's translation status. Can run without a config file. Exits with a non-zero status code when translations are missing.
 
+The primary language is checked too: any key used in your code but absent from the primary language's translation files (a typo, or `extract` was never run) is reported and causes a non-zero exit code. Empty-string placeholders written by `extract` are considered present and do not fail the check. Running `npx i18next-cli status <primaryLanguage>` shows the absent keys in detail.
+
 **Options:**
 - `--namespace <ns>, -n <ns>`: Filter the report by a specific namespace.
 - `--hide-translated`: Hide already translated keys in the detailed view, showing only missing translations.
@@ -541,7 +543,7 @@ npx i18next-cli locize-sync [options]
 
 **Options:**
 - `--update-values`: Update values of existing translations on locize
-- `--src-lng-only`: Check for changes in source language only
+- `--src-lng-only <true|false>`: Check for changes in source language only (default: `true`). Pass `--src-lng-only false` to sync all languages
 - `--compare-mtime`: Compare modification times when syncing
 - `--dry-run`: Run the command without making any changes
 

package/dist/cjs/cli.js

@@ -32,7 +32,7 @@ const program = new commander.Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.60.0'); // This string is replaced with the actual version at build time by rollup
+    .version('1.61.1'); // 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
@@ -290,7 +290,7 @@ program
     .command('locize-sync')
     .description('Synchronize local translations with your Locize project.')
     .option('--update-values', 'Update values of existing translations on Locize.')
-    .option('--src-lng-only', 'Check for changes in source language only.')
+    .option('--src-lng-only <true|false>', 'Check for changes in source language only. (default: true)')
     .option('--compare-mtime', 'Compare modification times when syncing.')
     .option('--dry-run', 'Run the command without making any changes.')
     .option('--cdn-type <standard|pro>', 'Specify the cdn endpoint that should be used (depends on which cdn type you\'ve in your locize project)')

package/dist/cjs/locize.js

@@ -165,9 +165,14 @@ function buildArgs(command, config, cliOptions) {
         const updateValues = cliOptions.updateValues ?? locizeConfig.updateValues;
         if (updateValues)
             commandArgs.push('--update-values', 'true');
+        // `--reference-language-only` defaults to `true` in locize-cli, so we only
+        // forward it when explicitly set – passing `false` is the whole point, as it
+        // is the only way to opt out of the source-language-only behavior.
         const srcLngOnly = cliOptions.srcLngOnly ?? locizeConfig.sourceLanguageOnly;
-        if (srcLngOnly)
-            commandArgs.push('--reference-language-only', 'true');
+        if (srcLngOnly !== undefined) {
+            const referenceLanguageOnly = srcLngOnly === true || srcLngOnly === 'true';
+            commandArgs.push('--reference-language-only', String(referenceLanguageOnly));
+        }
         const compareMtime = cliOptions.compareMtime ?? locizeConfig.compareModificationTime;
         if (compareMtime)
             commandArgs.push('--compare-modification-time', 'true');

package/dist/cjs/status.js

@@ -56,6 +56,11 @@ async function runStatus(config, options = {}) {
                 break;
             }
         }
+        // The primary language fails the check only on absent keys (used in code but
+        // missing from the translation file); empty placeholders are tolerated.
+        if (!hasMissing && report.primary && report.primary.totalAbsent > 0) {
+            hasMissing = true;
+        }
         if (hasMissing) {
             spinner.fail('Error: Incomplete translations detected.');
             process.exit(1);
@@ -203,7 +208,13 @@ async function generateStatusReport(config) {
         if (nestedRefKeys.length > 0)
             nestedReferenceKeysByNs.set(ns, nestedRefKeys);
     }
-    for (const locale of secondaryLanguages) {
+    // The primary language is checked first so that keys used in code but absent
+    // from the primary translation file (e.g. a typo, or `extract` never run) are
+    // surfaced as well. For the primary, an empty value is a deliberate
+    // placeholder and counts as present — only truly absent keys are flagged.
+    const localesToCheck = [primaryLanguage, ...secondaryLanguages.filter((l) => l !== primaryLanguage)];
+    for (const locale of localesToCheck) {
+        const isPrimary = locale === primaryLanguage;
         let totalTranslatedForLocale = 0;
         let totalEmptyForLocale = 0;
         let totalAbsentForLocale = 0;
@@ -264,11 +275,17 @@ async function generateStatusReport(config) {
                 const primaryState = classifyValue(primaryValue);
                 // Only fall back when the key is genuinely absent from the primary file.
                 // An empty string is intentional (placeholder from extract) — don't hide it.
+                let state = primaryState;
                 if (primaryState === 'absent' && fallbackTranslations) {
                     const fallbackValue = nestedObject.getNestedValue(fallbackTranslations, key, sep);
-                    return classifyValue(fallbackValue);
+                    state = classifyValue(fallbackValue);
                 }
-                return primaryState;
+                // For the primary language the file itself is the source of values, so an
+                // empty placeholder still means the key is present. Only a truly absent
+                // key (used in code, missing from the file) is a problem here.
+                if (isPrimary && state === 'empty')
+                    return 'translated';
+                return state;
             };
             const processedKeys = new Set();
             // Combine AST-extracted keys with nested-reference keys discovered in
@@ -365,13 +382,19 @@ async function generateStatusReport(config) {
             totalAbsentForLocale += absentInNs;
             totalKeysForLocale += totalInNs;
         }
-        report.locales.set(locale, {
+        const localeStatus = {
             totalKeys: totalKeysForLocale,
             totalTranslated: totalTranslatedForLocale,
             totalEmpty: totalEmptyForLocale,
             totalAbsent: totalAbsentForLocale,
             namespaces,
-        });
+        };
+        if (isPrimary) {
+            report.primary = localeStatus;
+        }
+        else {
+            report.locales.set(locale, localeStatus);
+        }
     }
     return report;
 }
@@ -419,15 +442,12 @@ async function displayStatusReport(report, config, options) {
  *   ✗  red    — absent from file entirely (structural problem)
  */
 async function displayDetailedLocaleReport(report, config, locale, namespaceFilter, hideTranslated) {
-    if (locale === config.extract.primaryLanguage) {
-        console.log(node_util.styleText('yellow', `Locale "${locale}" is the primary language. All keys are considered present.`));
-        return;
-    }
     if (!config.locales.includes(locale)) {
         console.error(node_util.styleText('red', `Error: Locale "${locale}" is not defined in your configuration.`));
         return;
     }
-    const localeData = report.locales.get(locale);
+    const isPrimary = locale === config.extract.primaryLanguage;
+    const localeData = isPrimary ? report.primary : report.locales.get(locale);
     if (!localeData) {
         console.error(node_util.styleText('red', `Error: Locale "${locale}" is not a valid secondary language.`));
         return;
@@ -465,8 +485,16 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
     }
     const missingCount = totalKeysForLocale - localeData.totalTranslated;
     if (missingCount > 0) {
-        const summaryBreakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
-        console.log(node_util.styleText(['yellow', 'bold'], `\nSummary: Found ${missingCount} incomplete translations for "${locale}" — ${summaryBreakdown}.`));
+        if (isPrimary) {
+            console.log(node_util.styleText(['red', 'bold'], `\nSummary: Found ${missingCount} key(s) used in code but absent from the "${locale}" translation files. Run "i18next-cli extract" to add them.`));
+        }
+        else {
+            const summaryBreakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
+            console.log(node_util.styleText(['yellow', 'bold'], `\nSummary: Found ${missingCount} incomplete translations for "${locale}" — ${summaryBreakdown}.`));
+        }
+    }
+    else if (isPrimary) {
+        console.log(node_util.styleText(['green', 'bold'], `\nSummary: 🎉 All keys used in code are present in the "${locale}" translation files.`));
     }
     else {
         console.log(node_util.styleText(['green', 'bold'], `\nSummary: 🎉 All keys are translated for "${locale}".`));
@@ -501,6 +529,11 @@ async function displayNamespaceSummaryReport(report, config, namespace) {
             console.log(`- ${locale}: ${bar} ${percentage}% (${nsLocaleData.translatedKeys}/${nsLocaleData.totalKeys} keys)${suffix}`);
         }
     }
+    const primaryNsData = report.primary?.namespaces.get(namespace);
+    if (primaryNsData && primaryNsData.absentKeys > 0) {
+        const { primaryLanguage } = config.extract;
+        console.log(node_util.styleText(['red', 'bold'], `\n⚠ Primary language "${primaryLanguage}" is missing ${primaryNsData.absentKeys} key(s) that are used in code.`));
+    }
     await printLocizeFunnel();
 }
 /**
@@ -531,6 +564,10 @@ async function displayOverallSummaryReport(report, config) {
         const suffix = breakdown ? `  — ${breakdown}` : '';
         console.log(`- ${locale}: ${bar} ${percentage}% (${localeData.totalTranslated}/${localeData.totalKeys} keys)${suffix}`);
     }
+    if (report.primary && report.primary.totalAbsent > 0) {
+        console.log(node_util.styleText(['red', 'bold'], `\n⚠ Primary language "${primaryLanguage}" is missing ${report.primary.totalAbsent} key(s) that are used in code.`));
+        console.log(node_util.styleText('red', `  Run "i18next-cli status ${primaryLanguage}" for details, or "i18next-cli extract" to add them.`));
+    }
     await printLocizeFunnel();
 }
 /**

package/dist/esm/cli.js

@@ -30,7 +30,7 @@ const program = new Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.60.0'); // This string is replaced with the actual version at build time by rollup
+    .version('1.61.1'); // 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
@@ -288,7 +288,7 @@ program
     .command('locize-sync')
     .description('Synchronize local translations with your Locize project.')
     .option('--update-values', 'Update values of existing translations on Locize.')
-    .option('--src-lng-only', 'Check for changes in source language only.')
+    .option('--src-lng-only <true|false>', 'Check for changes in source language only. (default: true)')
     .option('--compare-mtime', 'Compare modification times when syncing.')
     .option('--dry-run', 'Run the command without making any changes.')
     .option('--cdn-type <standard|pro>', 'Specify the cdn endpoint that should be used (depends on which cdn type you\'ve in your locize project)')

package/dist/esm/locize.js

@@ -163,9 +163,14 @@ function buildArgs(command, config, cliOptions) {
         const updateValues = cliOptions.updateValues ?? locizeConfig.updateValues;
         if (updateValues)
             commandArgs.push('--update-values', 'true');
+        // `--reference-language-only` defaults to `true` in locize-cli, so we only
+        // forward it when explicitly set – passing `false` is the whole point, as it
+        // is the only way to opt out of the source-language-only behavior.
         const srcLngOnly = cliOptions.srcLngOnly ?? locizeConfig.sourceLanguageOnly;
-        if (srcLngOnly)
-            commandArgs.push('--reference-language-only', 'true');
+        if (srcLngOnly !== undefined) {
+            const referenceLanguageOnly = srcLngOnly === true || srcLngOnly === 'true';
+            commandArgs.push('--reference-language-only', String(referenceLanguageOnly));
+        }
         const compareMtime = cliOptions.compareMtime ?? locizeConfig.compareModificationTime;
         if (compareMtime)
             commandArgs.push('--compare-modification-time', 'true');

package/dist/esm/status.js

@@ -54,6 +54,11 @@ async function runStatus(config, options = {}) {
                 break;
             }
         }
+        // The primary language fails the check only on absent keys (used in code but
+        // missing from the translation file); empty placeholders are tolerated.
+        if (!hasMissing && report.primary && report.primary.totalAbsent > 0) {
+            hasMissing = true;
+        }
         if (hasMissing) {
             spinner.fail('Error: Incomplete translations detected.');
             process.exit(1);
@@ -201,7 +206,13 @@ async function generateStatusReport(config) {
         if (nestedRefKeys.length > 0)
             nestedReferenceKeysByNs.set(ns, nestedRefKeys);
     }
-    for (const locale of secondaryLanguages) {
+    // The primary language is checked first so that keys used in code but absent
+    // from the primary translation file (e.g. a typo, or `extract` never run) are
+    // surfaced as well. For the primary, an empty value is a deliberate
+    // placeholder and counts as present — only truly absent keys are flagged.
+    const localesToCheck = [primaryLanguage, ...secondaryLanguages.filter((l) => l !== primaryLanguage)];
+    for (const locale of localesToCheck) {
+        const isPrimary = locale === primaryLanguage;
         let totalTranslatedForLocale = 0;
         let totalEmptyForLocale = 0;
         let totalAbsentForLocale = 0;
@@ -262,11 +273,17 @@ async function generateStatusReport(config) {
                 const primaryState = classifyValue(primaryValue);
                 // Only fall back when the key is genuinely absent from the primary file.
                 // An empty string is intentional (placeholder from extract) — don't hide it.
+                let state = primaryState;
                 if (primaryState === 'absent' && fallbackTranslations) {
                     const fallbackValue = getNestedValue(fallbackTranslations, key, sep);
-                    return classifyValue(fallbackValue);
+                    state = classifyValue(fallbackValue);
                 }
-                return primaryState;
+                // For the primary language the file itself is the source of values, so an
+                // empty placeholder still means the key is present. Only a truly absent
+                // key (used in code, missing from the file) is a problem here.
+                if (isPrimary && state === 'empty')
+                    return 'translated';
+                return state;
             };
             const processedKeys = new Set();
             // Combine AST-extracted keys with nested-reference keys discovered in
@@ -363,13 +380,19 @@ async function generateStatusReport(config) {
             totalAbsentForLocale += absentInNs;
             totalKeysForLocale += totalInNs;
         }
-        report.locales.set(locale, {
+        const localeStatus = {
             totalKeys: totalKeysForLocale,
             totalTranslated: totalTranslatedForLocale,
             totalEmpty: totalEmptyForLocale,
             totalAbsent: totalAbsentForLocale,
             namespaces,
-        });
+        };
+        if (isPrimary) {
+            report.primary = localeStatus;
+        }
+        else {
+            report.locales.set(locale, localeStatus);
+        }
     }
     return report;
 }
@@ -417,15 +440,12 @@ async function displayStatusReport(report, config, options) {
  *   ✗  red    — absent from file entirely (structural problem)
  */
 async function displayDetailedLocaleReport(report, config, locale, namespaceFilter, hideTranslated) {
-    if (locale === config.extract.primaryLanguage) {
-        console.log(styleText('yellow', `Locale "${locale}" is the primary language. All keys are considered present.`));
-        return;
-    }
     if (!config.locales.includes(locale)) {
         console.error(styleText('red', `Error: Locale "${locale}" is not defined in your configuration.`));
         return;
     }
-    const localeData = report.locales.get(locale);
+    const isPrimary = locale === config.extract.primaryLanguage;
+    const localeData = isPrimary ? report.primary : report.locales.get(locale);
     if (!localeData) {
         console.error(styleText('red', `Error: Locale "${locale}" is not a valid secondary language.`));
         return;
@@ -463,8 +483,16 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
     }
     const missingCount = totalKeysForLocale - localeData.totalTranslated;
     if (missingCount > 0) {
-        const summaryBreakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
-        console.log(styleText(['yellow', 'bold'], `\nSummary: Found ${missingCount} incomplete translations for "${locale}" — ${summaryBreakdown}.`));
+        if (isPrimary) {
+            console.log(styleText(['red', 'bold'], `\nSummary: Found ${missingCount} key(s) used in code but absent from the "${locale}" translation files. Run "i18next-cli extract" to add them.`));
+        }
+        else {
+            const summaryBreakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
+            console.log(styleText(['yellow', 'bold'], `\nSummary: Found ${missingCount} incomplete translations for "${locale}" — ${summaryBreakdown}.`));
+        }
+    }
+    else if (isPrimary) {
+        console.log(styleText(['green', 'bold'], `\nSummary: 🎉 All keys used in code are present in the "${locale}" translation files.`));
     }
     else {
         console.log(styleText(['green', 'bold'], `\nSummary: 🎉 All keys are translated for "${locale}".`));
@@ -499,6 +527,11 @@ async function displayNamespaceSummaryReport(report, config, namespace) {
             console.log(`- ${locale}: ${bar} ${percentage}% (${nsLocaleData.translatedKeys}/${nsLocaleData.totalKeys} keys)${suffix}`);
         }
     }
+    const primaryNsData = report.primary?.namespaces.get(namespace);
+    if (primaryNsData && primaryNsData.absentKeys > 0) {
+        const { primaryLanguage } = config.extract;
+        console.log(styleText(['red', 'bold'], `\n⚠ Primary language "${primaryLanguage}" is missing ${primaryNsData.absentKeys} key(s) that are used in code.`));
+    }
     await printLocizeFunnel();
 }
 /**
@@ -529,6 +562,10 @@ async function displayOverallSummaryReport(report, config) {
         const suffix = breakdown ? `  — ${breakdown}` : '';
         console.log(`- ${locale}: ${bar} ${percentage}% (${localeData.totalTranslated}/${localeData.totalKeys} keys)${suffix}`);
     }
+    if (report.primary && report.primary.totalAbsent > 0) {
+        console.log(styleText(['red', 'bold'], `\n⚠ Primary language "${primaryLanguage}" is missing ${report.primary.totalAbsent} key(s) that are used in code.`));
+        console.log(styleText('red', `  Run "i18next-cli status ${primaryLanguage}" for details, or "i18next-cli extract" to add them.`));
+    }
     await printLocizeFunnel();
 }
 /**

package/package.json

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

package/types/locize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locize.d.ts","sourceRoot":"","sources":["../src/locize.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAgTtD,eAAO,MAAM,aAAa,GAAI,QAAQ,oBAAoB,EAAE,aAAa,GAAG,kBAAiD,CAAA;AAC7H,eAAO,MAAM,iBAAiB,GAAI,QAAQ,oBAAoB,EAAE,aAAa,GAAG,kBAAqD,CAAA;AACrI,eAAO,MAAM,gBAAgB,GAAI,QAAQ,oBAAoB,EAAE,aAAa,GAAG,kBAAoD,CAAA"}
+{"version":3,"file":"locize.d.ts","sourceRoot":"","sources":["../src/locize.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAsTtD,eAAO,MAAM,aAAa,GAAI,QAAQ,oBAAoB,EAAE,aAAa,GAAG,kBAAiD,CAAA;AAC7H,eAAO,MAAM,iBAAiB,GAAI,QAAQ,oBAAoB,EAAE,aAAa,GAAG,kBAAqD,CAAA;AACrI,eAAO,MAAM,gBAAgB,GAAI,QAAQ,oBAAoB,EAAE,aAAa,GAAG,kBAAoD,CAAA"}

package/types/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAgB,MAAM,YAAY,CAAA;AAOpE;;GAEG;AACH,UAAU,aAAa;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAqDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAuBzF"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAgB,MAAM,YAAY,CAAA;AAOpE;;GAEG;AACH,UAAU,aAAa;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAiED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBA4BzF"}