i18next-cli 1.50.2 → 1.50.3

package/dist/cjs/cli.js

@@ -31,7 +31,7 @@ const program = new commander.Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.50.2'); // This string is replaced with the actual version at build time by rollup
+    .version('1.50.3'); // 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/status.js

@@ -12,6 +12,13 @@ var fileUtils = require('./utils/file-utils.js');
 var funnelMsgTracker = require('./utils/funnel-msg-tracker.js');
 require('./extractor/parsers/jsx-parser.js');
 
+function classifyValue(value) {
+    if (value === undefined || value === null)
+        return 'absent';
+    if (value === '')
+        return 'empty';
+    return 'translated';
+}
 /**
  * Runs a health check on the project's i18next translations and displays a status report.
  *
@@ -22,6 +29,11 @@ require('./extractor/parsers/jsx-parser.js');
  * 4. Displaying a formatted report with key counts, locales, and progress bars.
  * 5. Serving as a value-driven funnel to introduce the locize commercial service.
  *
+ * Exit behaviour (unchanged): exits 1 when any key is either empty or absent.
+ * The output now distinguishes between the two states so developers can tell
+ * whether they have a structural problem (absent) or simply pending translation
+ * work (empty).
+ *
  * @param config - The i18next toolkit configuration object.
  * @param options - Options object, may contain a `detail` property with a locale string.
  * @throws {Error} When unable to extract keys or read translation files
@@ -42,7 +54,7 @@ async function runStatus(config, options = {}) {
             }
         }
         if (hasMissing) {
-            spinner.fail('Error: Missing translations detected.');
+            spinner.fail('Error: Incomplete translations detected.');
             process.exit(1);
         }
     }
@@ -94,6 +106,8 @@ async function generateStatusReport(config) {
     };
     for (const locale of secondaryLanguages) {
         let totalTranslatedForLocale = 0;
+        let totalEmptyForLocale = 0;
+        let totalAbsentForLocale = 0;
         let totalKeysForLocale = 0;
         const namespaces = new Map();
         const mergedTranslations = mergeNamespaces
@@ -120,6 +134,8 @@ async function generateStatusReport(config) {
                 }
             }
             let translatedInNs = 0;
+            let emptyInNs = 0;
+            let absentInNs = 0;
             let totalInNs = 0;
             const keyDetails = [];
             // Get the plural categories for THIS specific locale
@@ -135,6 +151,26 @@ async function generateStatusReport(config) {
                     return fallbackRules.resolvedOptions().pluralCategories;
                 }
             };
+            /**
+             * Resolves the value for a single key, applying the fallback namespace when
+             * configured, and classifies it as translated / empty / absent.
+             *
+             * The fallback is only consulted when the primary value is absent — an empty
+             * string is a deliberate placeholder written by `extract` and should not be
+             * silently replaced by a fallback value.
+             */
+            const resolveAndClassify = (key) => {
+                const sep = keySeparator ?? '.';
+                const primaryValue = nestedObject.getNestedValue(translationsForNs, key, sep);
+                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.
+                if (primaryState === 'absent' && fallbackTranslations) {
+                    const fallbackValue = nestedObject.getNestedValue(fallbackTranslations, key, sep);
+                    return classifyValue(fallbackValue);
+                }
+                return primaryState;
+            };
             for (const { key: baseKey, hasCount, isOrdinal, isExpandedPlural } of keysInNs) {
                 if (hasCount) {
                     if (isExpandedPlural) {
@@ -150,15 +186,14 @@ async function generateStatusReport(config) {
                         // Only count this key if it's a plural form used by this locale
                         if (localePluralCategories.includes(category)) {
                             totalInNs++;
-                            let value = nestedObject.getNestedValue(translationsForNs, baseKey, keySeparator ?? '.');
-                            // Fallback lookup
-                            if (!value && fallbackTranslations) {
-                                value = nestedObject.getNestedValue(fallbackTranslations, baseKey, keySeparator ?? '.');
-                            }
-                            const isTranslated = !!value;
-                            if (isTranslated)
+                            const state = resolveAndClassify(baseKey);
+                            if (state === 'translated')
                                 translatedInNs++;
-                            keyDetails.push({ key: baseKey, isTranslated });
+                            else if (state === 'empty')
+                                emptyInNs++;
+                            else
+                                absentInNs++;
+                            keyDetails.push({ key: baseKey, state });
                         }
                     }
                     else {
@@ -170,40 +205,57 @@ async function generateStatusReport(config) {
                             const pluralKey = isOrdinal
                                 ? `${baseKey}${pluralSeparator}ordinal${pluralSeparator}${category}`
                                 : `${baseKey}${pluralSeparator}${category}`;
-                            let value = nestedObject.getNestedValue(translationsForNs, pluralKey, keySeparator ?? '.');
-                            // Fallback lookup
-                            if (!value && fallbackTranslations) {
-                                value = nestedObject.getNestedValue(fallbackTranslations, pluralKey, keySeparator ?? '.');
-                            }
-                            const isTranslated = !!value;
-                            if (isTranslated)
+                            const state = resolveAndClassify(pluralKey);
+                            if (state === 'translated')
                                 translatedInNs++;
-                            keyDetails.push({ key: pluralKey, isTranslated });
+                            else if (state === 'empty')
+                                emptyInNs++;
+                            else
+                                absentInNs++;
+                            keyDetails.push({ key: pluralKey, state });
                         }
                     }
                 }
                 else {
-                    // It's a simple key
                     totalInNs++;
-                    let value = nestedObject.getNestedValue(translationsForNs, baseKey, keySeparator ?? '.');
-                    // Fallback lookup
-                    if (!value && fallbackTranslations) {
-                        value = nestedObject.getNestedValue(fallbackTranslations, baseKey, keySeparator ?? '.');
-                    }
-                    const isTranslated = !!value;
-                    if (isTranslated)
+                    const state = resolveAndClassify(baseKey);
+                    if (state === 'translated')
                         translatedInNs++;
-                    keyDetails.push({ key: baseKey, isTranslated });
+                    else if (state === 'empty')
+                        emptyInNs++;
+                    else
+                        absentInNs++;
+                    keyDetails.push({ key: baseKey, state });
                 }
             }
-            namespaces.set(ns, { totalKeys: totalInNs, translatedKeys: translatedInNs, keyDetails });
+            namespaces.set(ns, { totalKeys: totalInNs, translatedKeys: translatedInNs, emptyKeys: emptyInNs, absentKeys: absentInNs, keyDetails });
             totalTranslatedForLocale += translatedInNs;
+            totalEmptyForLocale += emptyInNs;
+            totalAbsentForLocale += absentInNs;
             totalKeysForLocale += totalInNs;
         }
-        report.locales.set(locale, { totalKeys: totalKeysForLocale, totalTranslated: totalTranslatedForLocale, namespaces });
+        report.locales.set(locale, {
+            totalKeys: totalKeysForLocale,
+            totalTranslated: totalTranslatedForLocale,
+            totalEmpty: totalEmptyForLocale,
+            totalAbsent: totalAbsentForLocale,
+            namespaces,
+        });
     }
     return report;
 }
+/**
+ * Builds a compact breakdown string like "3 untranslated, 2 absent" for use in
+ * summary lines. Returns an empty string when there is nothing to report.
+ */
+function buildBreakdown(emptyCount, absentCount) {
+    const parts = [];
+    if (emptyCount > 0)
+        parts.push(node_util.styleText('yellow', `${emptyCount} untranslated`));
+    if (absentCount > 0)
+        parts.push(node_util.styleText('red', `${absentCount} absent`));
+    return parts.join(', ');
+}
 /**
  * Main display router that calls the appropriate display function based on options.
  *
@@ -230,17 +282,10 @@ async function displayStatusReport(report, config, options) {
 /**
  * Displays the detailed, grouped report for a single locale.
  *
- * Shows:
- * - Overall progress for the locale
- * - Progress for each namespace (or filtered namespace)
- * - Individual key status (translated/missing) with visual indicators
- * - Summary message with total missing translations
- *
- * @param report - The generated status report data
- * @param config - The i18next toolkit configuration object
- * @param locale - The locale code to display details for
- * @param namespaceFilter - Optional namespace to filter the display
- * @param hideTranslated - When true, only untranslated keys are shown
+ * Key status icons:
+ *   ✓  green  — translated
+ *   ~  yellow — present in file but empty (needs translation)
+ *   ✗  red    — absent from file entirely (structural problem)
  */
 async function displayDetailedLocaleReport(report, config, locale, namespaceFilter, hideTranslated) {
     if (locale === config.extract.primaryLanguage) {
@@ -259,6 +304,9 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
     console.log(node_util.styleText('bold', `\nKey Status for "${node_util.styleText('cyan', locale)}":`));
     const totalKeysForLocale = localeData.totalKeys;
     printProgressBar('Overall', localeData.totalTranslated, totalKeysForLocale);
+    const breakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
+    if (breakdown)
+        console.log(`         ${breakdown}`);
     const namespacesToDisplay = namespaceFilter ? [namespaceFilter] : Array.from(localeData.namespaces.keys()).sort();
     for (const ns of namespacesToDisplay) {
         const nsData = localeData.namespaces.get(ns);
@@ -266,15 +314,28 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
             continue;
         console.log(node_util.styleText(['cyan', 'bold'], `\nNamespace: ${ns}`));
         printProgressBar('Namespace Progress', nsData.translatedKeys, nsData.totalKeys);
-        const keysToDisplay = hideTranslated ? nsData.keyDetails.filter(({ isTranslated }) => !isTranslated) : nsData.keyDetails;
-        keysToDisplay.forEach(({ key, isTranslated }) => {
-            const icon = isTranslated ? node_util.styleText('green', '✓') : node_util.styleText('red', '✗');
-            console.log(`  ${icon} ${key}`);
+        const nsBreakdown = buildBreakdown(nsData.emptyKeys, nsData.absentKeys);
+        if (nsBreakdown)
+            console.log(`                   ${nsBreakdown}`);
+        const keysToDisplay = hideTranslated
+            ? nsData.keyDetails.filter(({ state }) => state !== 'translated')
+            : nsData.keyDetails;
+        keysToDisplay.forEach(({ key, state }) => {
+            if (state === 'translated') {
+                console.log(`  ${node_util.styleText('green', '✓')} ${key}`);
+            }
+            else if (state === 'empty') {
+                console.log(`  ${node_util.styleText('yellow', '~')} ${key}  ${node_util.styleText('yellow', '(untranslated)')}`);
+            }
+            else {
+                console.log(`  ${node_util.styleText('red', '✗')} ${key}  ${node_util.styleText('red', '(absent)')}`);
+            }
         });
     }
     const missingCount = totalKeysForLocale - localeData.totalTranslated;
     if (missingCount > 0) {
-        console.log(node_util.styleText(['yellow', 'bold'], `\nSummary: Found ${missingCount} missing translations for "${locale}".`));
+        const summaryBreakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
+        console.log(node_util.styleText(['yellow', 'bold'], `\nSummary: Found ${missingCount} incomplete translations for "${locale}" — ${summaryBreakdown}.`));
     }
     else {
         console.log(node_util.styleText(['green', 'bold'], `\nSummary: 🎉 All keys are translated for "${locale}".`));
@@ -304,7 +365,9 @@ async function displayNamespaceSummaryReport(report, config, namespace) {
         if (nsLocaleData) {
             const percentage = nsLocaleData.totalKeys > 0 ? Math.round((nsLocaleData.translatedKeys / nsLocaleData.totalKeys) * 100) : 100;
             const bar = generateProgressBarText(percentage);
-            console.log(`- ${locale}: ${bar} ${percentage}% (${nsLocaleData.translatedKeys}/${nsLocaleData.totalKeys} keys)`);
+            const breakdown = buildBreakdown(nsLocaleData.emptyKeys, nsLocaleData.absentKeys);
+            const suffix = breakdown ? `  — ${breakdown}` : '';
+            console.log(`- ${locale}: ${bar} ${percentage}% (${nsLocaleData.translatedKeys}/${nsLocaleData.totalKeys} keys)${suffix}`);
         }
     }
     await printLocizeFunnel();
@@ -333,7 +396,9 @@ async function displayOverallSummaryReport(report, config) {
     for (const [locale, localeData] of report.locales.entries()) {
         const percentage = localeData.totalKeys > 0 ? Math.round((localeData.totalTranslated / localeData.totalKeys) * 100) : 100;
         const bar = generateProgressBarText(percentage);
-        console.log(`- ${locale}: ${bar} ${percentage}% (${localeData.totalTranslated}/${localeData.totalKeys} keys)`);
+        const breakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
+        const suffix = breakdown ? `  — ${breakdown}` : '';
+        console.log(`- ${locale}: ${bar} ${percentage}% (${localeData.totalTranslated}/${localeData.totalKeys} keys)${suffix}`);
     }
     await printLocizeFunnel();
 }

package/dist/esm/cli.js

@@ -29,7 +29,7 @@ const program = new Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.50.2'); // This string is replaced with the actual version at build time by rollup
+    .version('1.50.3'); // 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/status.js

@@ -10,6 +10,13 @@ import { loadTranslationFile, getOutputPath } from './utils/file-utils.js';
 import { shouldShowFunnel, recordFunnelShown } from './utils/funnel-msg-tracker.js';
 import './extractor/parsers/jsx-parser.js';
 
+function classifyValue(value) {
+    if (value === undefined || value === null)
+        return 'absent';
+    if (value === '')
+        return 'empty';
+    return 'translated';
+}
 /**
  * Runs a health check on the project's i18next translations and displays a status report.
  *
@@ -20,6 +27,11 @@ import './extractor/parsers/jsx-parser.js';
  * 4. Displaying a formatted report with key counts, locales, and progress bars.
  * 5. Serving as a value-driven funnel to introduce the locize commercial service.
  *
+ * Exit behaviour (unchanged): exits 1 when any key is either empty or absent.
+ * The output now distinguishes between the two states so developers can tell
+ * whether they have a structural problem (absent) or simply pending translation
+ * work (empty).
+ *
  * @param config - The i18next toolkit configuration object.
  * @param options - Options object, may contain a `detail` property with a locale string.
  * @throws {Error} When unable to extract keys or read translation files
@@ -40,7 +52,7 @@ async function runStatus(config, options = {}) {
             }
         }
         if (hasMissing) {
-            spinner.fail('Error: Missing translations detected.');
+            spinner.fail('Error: Incomplete translations detected.');
             process.exit(1);
         }
     }
@@ -92,6 +104,8 @@ async function generateStatusReport(config) {
     };
     for (const locale of secondaryLanguages) {
         let totalTranslatedForLocale = 0;
+        let totalEmptyForLocale = 0;
+        let totalAbsentForLocale = 0;
         let totalKeysForLocale = 0;
         const namespaces = new Map();
         const mergedTranslations = mergeNamespaces
@@ -118,6 +132,8 @@ async function generateStatusReport(config) {
                 }
             }
             let translatedInNs = 0;
+            let emptyInNs = 0;
+            let absentInNs = 0;
             let totalInNs = 0;
             const keyDetails = [];
             // Get the plural categories for THIS specific locale
@@ -133,6 +149,26 @@ async function generateStatusReport(config) {
                     return fallbackRules.resolvedOptions().pluralCategories;
                 }
             };
+            /**
+             * Resolves the value for a single key, applying the fallback namespace when
+             * configured, and classifies it as translated / empty / absent.
+             *
+             * The fallback is only consulted when the primary value is absent — an empty
+             * string is a deliberate placeholder written by `extract` and should not be
+             * silently replaced by a fallback value.
+             */
+            const resolveAndClassify = (key) => {
+                const sep = keySeparator ?? '.';
+                const primaryValue = getNestedValue(translationsForNs, key, sep);
+                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.
+                if (primaryState === 'absent' && fallbackTranslations) {
+                    const fallbackValue = getNestedValue(fallbackTranslations, key, sep);
+                    return classifyValue(fallbackValue);
+                }
+                return primaryState;
+            };
             for (const { key: baseKey, hasCount, isOrdinal, isExpandedPlural } of keysInNs) {
                 if (hasCount) {
                     if (isExpandedPlural) {
@@ -148,15 +184,14 @@ async function generateStatusReport(config) {
                         // Only count this key if it's a plural form used by this locale
                         if (localePluralCategories.includes(category)) {
                             totalInNs++;
-                            let value = getNestedValue(translationsForNs, baseKey, keySeparator ?? '.');
-                            // Fallback lookup
-                            if (!value && fallbackTranslations) {
-                                value = getNestedValue(fallbackTranslations, baseKey, keySeparator ?? '.');
-                            }
-                            const isTranslated = !!value;
-                            if (isTranslated)
+                            const state = resolveAndClassify(baseKey);
+                            if (state === 'translated')
                                 translatedInNs++;
-                            keyDetails.push({ key: baseKey, isTranslated });
+                            else if (state === 'empty')
+                                emptyInNs++;
+                            else
+                                absentInNs++;
+                            keyDetails.push({ key: baseKey, state });
                         }
                     }
                     else {
@@ -168,40 +203,57 @@ async function generateStatusReport(config) {
                             const pluralKey = isOrdinal
                                 ? `${baseKey}${pluralSeparator}ordinal${pluralSeparator}${category}`
                                 : `${baseKey}${pluralSeparator}${category}`;
-                            let value = getNestedValue(translationsForNs, pluralKey, keySeparator ?? '.');
-                            // Fallback lookup
-                            if (!value && fallbackTranslations) {
-                                value = getNestedValue(fallbackTranslations, pluralKey, keySeparator ?? '.');
-                            }
-                            const isTranslated = !!value;
-                            if (isTranslated)
+                            const state = resolveAndClassify(pluralKey);
+                            if (state === 'translated')
                                 translatedInNs++;
-                            keyDetails.push({ key: pluralKey, isTranslated });
+                            else if (state === 'empty')
+                                emptyInNs++;
+                            else
+                                absentInNs++;
+                            keyDetails.push({ key: pluralKey, state });
                         }
                     }
                 }
                 else {
-                    // It's a simple key
                     totalInNs++;
-                    let value = getNestedValue(translationsForNs, baseKey, keySeparator ?? '.');
-                    // Fallback lookup
-                    if (!value && fallbackTranslations) {
-                        value = getNestedValue(fallbackTranslations, baseKey, keySeparator ?? '.');
-                    }
-                    const isTranslated = !!value;
-                    if (isTranslated)
+                    const state = resolveAndClassify(baseKey);
+                    if (state === 'translated')
                         translatedInNs++;
-                    keyDetails.push({ key: baseKey, isTranslated });
+                    else if (state === 'empty')
+                        emptyInNs++;
+                    else
+                        absentInNs++;
+                    keyDetails.push({ key: baseKey, state });
                 }
             }
-            namespaces.set(ns, { totalKeys: totalInNs, translatedKeys: translatedInNs, keyDetails });
+            namespaces.set(ns, { totalKeys: totalInNs, translatedKeys: translatedInNs, emptyKeys: emptyInNs, absentKeys: absentInNs, keyDetails });
             totalTranslatedForLocale += translatedInNs;
+            totalEmptyForLocale += emptyInNs;
+            totalAbsentForLocale += absentInNs;
             totalKeysForLocale += totalInNs;
         }
-        report.locales.set(locale, { totalKeys: totalKeysForLocale, totalTranslated: totalTranslatedForLocale, namespaces });
+        report.locales.set(locale, {
+            totalKeys: totalKeysForLocale,
+            totalTranslated: totalTranslatedForLocale,
+            totalEmpty: totalEmptyForLocale,
+            totalAbsent: totalAbsentForLocale,
+            namespaces,
+        });
     }
     return report;
 }
+/**
+ * Builds a compact breakdown string like "3 untranslated, 2 absent" for use in
+ * summary lines. Returns an empty string when there is nothing to report.
+ */
+function buildBreakdown(emptyCount, absentCount) {
+    const parts = [];
+    if (emptyCount > 0)
+        parts.push(styleText('yellow', `${emptyCount} untranslated`));
+    if (absentCount > 0)
+        parts.push(styleText('red', `${absentCount} absent`));
+    return parts.join(', ');
+}
 /**
  * Main display router that calls the appropriate display function based on options.
  *
@@ -228,17 +280,10 @@ async function displayStatusReport(report, config, options) {
 /**
  * Displays the detailed, grouped report for a single locale.
  *
- * Shows:
- * - Overall progress for the locale
- * - Progress for each namespace (or filtered namespace)
- * - Individual key status (translated/missing) with visual indicators
- * - Summary message with total missing translations
- *
- * @param report - The generated status report data
- * @param config - The i18next toolkit configuration object
- * @param locale - The locale code to display details for
- * @param namespaceFilter - Optional namespace to filter the display
- * @param hideTranslated - When true, only untranslated keys are shown
+ * Key status icons:
+ *   ✓  green  — translated
+ *   ~  yellow — present in file but empty (needs translation)
+ *   ✗  red    — absent from file entirely (structural problem)
  */
 async function displayDetailedLocaleReport(report, config, locale, namespaceFilter, hideTranslated) {
     if (locale === config.extract.primaryLanguage) {
@@ -257,6 +302,9 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
     console.log(styleText('bold', `\nKey Status for "${styleText('cyan', locale)}":`));
     const totalKeysForLocale = localeData.totalKeys;
     printProgressBar('Overall', localeData.totalTranslated, totalKeysForLocale);
+    const breakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
+    if (breakdown)
+        console.log(`         ${breakdown}`);
     const namespacesToDisplay = namespaceFilter ? [namespaceFilter] : Array.from(localeData.namespaces.keys()).sort();
     for (const ns of namespacesToDisplay) {
         const nsData = localeData.namespaces.get(ns);
@@ -264,15 +312,28 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
             continue;
         console.log(styleText(['cyan', 'bold'], `\nNamespace: ${ns}`));
         printProgressBar('Namespace Progress', nsData.translatedKeys, nsData.totalKeys);
-        const keysToDisplay = hideTranslated ? nsData.keyDetails.filter(({ isTranslated }) => !isTranslated) : nsData.keyDetails;
-        keysToDisplay.forEach(({ key, isTranslated }) => {
-            const icon = isTranslated ? styleText('green', '✓') : styleText('red', '✗');
-            console.log(`  ${icon} ${key}`);
+        const nsBreakdown = buildBreakdown(nsData.emptyKeys, nsData.absentKeys);
+        if (nsBreakdown)
+            console.log(`                   ${nsBreakdown}`);
+        const keysToDisplay = hideTranslated
+            ? nsData.keyDetails.filter(({ state }) => state !== 'translated')
+            : nsData.keyDetails;
+        keysToDisplay.forEach(({ key, state }) => {
+            if (state === 'translated') {
+                console.log(`  ${styleText('green', '✓')} ${key}`);
+            }
+            else if (state === 'empty') {
+                console.log(`  ${styleText('yellow', '~')} ${key}  ${styleText('yellow', '(untranslated)')}`);
+            }
+            else {
+                console.log(`  ${styleText('red', '✗')} ${key}  ${styleText('red', '(absent)')}`);
+            }
         });
     }
     const missingCount = totalKeysForLocale - localeData.totalTranslated;
     if (missingCount > 0) {
-        console.log(styleText(['yellow', 'bold'], `\nSummary: Found ${missingCount} missing translations for "${locale}".`));
+        const summaryBreakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
+        console.log(styleText(['yellow', 'bold'], `\nSummary: Found ${missingCount} incomplete translations for "${locale}" — ${summaryBreakdown}.`));
     }
     else {
         console.log(styleText(['green', 'bold'], `\nSummary: 🎉 All keys are translated for "${locale}".`));
@@ -302,7 +363,9 @@ async function displayNamespaceSummaryReport(report, config, namespace) {
         if (nsLocaleData) {
             const percentage = nsLocaleData.totalKeys > 0 ? Math.round((nsLocaleData.translatedKeys / nsLocaleData.totalKeys) * 100) : 100;
             const bar = generateProgressBarText(percentage);
-            console.log(`- ${locale}: ${bar} ${percentage}% (${nsLocaleData.translatedKeys}/${nsLocaleData.totalKeys} keys)`);
+            const breakdown = buildBreakdown(nsLocaleData.emptyKeys, nsLocaleData.absentKeys);
+            const suffix = breakdown ? `  — ${breakdown}` : '';
+            console.log(`- ${locale}: ${bar} ${percentage}% (${nsLocaleData.translatedKeys}/${nsLocaleData.totalKeys} keys)${suffix}`);
         }
     }
     await printLocizeFunnel();
@@ -331,7 +394,9 @@ async function displayOverallSummaryReport(report, config) {
     for (const [locale, localeData] of report.locales.entries()) {
         const percentage = localeData.totalKeys > 0 ? Math.round((localeData.totalTranslated / localeData.totalKeys) * 100) : 100;
         const bar = generateProgressBarText(percentage);
-        console.log(`- ${locale}: ${bar} ${percentage}% (${localeData.totalTranslated}/${localeData.totalKeys} keys)`);
+        const breakdown = buildBreakdown(localeData.totalEmpty, localeData.totalAbsent);
+        const suffix = breakdown ? `  — ${breakdown}` : '';
+        console.log(`- ${locale}: ${bar} ${percentage}% (${localeData.totalTranslated}/${localeData.totalKeys} keys)${suffix}`);
     }
     await printLocizeFunnel();
 }

package/package.json

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

package/types/status.d.ts

@@ -20,6 +20,11 @@ interface StatusOptions {
  * 4. Displaying a formatted report with key counts, locales, and progress bars.
  * 5. Serving as a value-driven funnel to introduce the locize commercial service.
  *
+ * Exit behaviour (unchanged): exits 1 when any key is either empty or absent.
+ * The output now distinguishes between the two states so developers can tell
+ * whether they have a structural problem (absent) or simply pending translation
+ * work (empty).
+ *
  * @param config - The i18next toolkit configuration object.
  * @param options - Options object, may contain a `detail` property with a locale string.
  * @throws {Error} When unable to extract keys or read translation files

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;AAIpE;;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;AA4BD;;;;;;;;;;;;;GAaG;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;AAIpE;;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"}