i18next-cli 1.42.11 → 1.43.0

package/README.md

@@ -170,6 +170,7 @@ Displays a health check of your project's translation status. Can run without a
 
 **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.
 
 **Usage Examples:**
 
@@ -185,6 +186,12 @@ npx i18next-cli status --namespace common
 
 # Get a detailed report for the 'de' locale, showing only the 'common' namespace
 npx i18next-cli status de --namespace common
+
+# Show only the untranslated keys for the 'de' locale
+npx i18next-cli status de --hide-translated
+
+# Combine options to see only missing translations in a specific namespace
+npx i18next-cli status de --namespace common --hide-translated
 ```
 
 The detailed view provides a rich, at-a-glance summary for each namespace, followed by a list of every key and its translation status.

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.42.11'); // This string is replaced with the actual version at build time by rollup
+    .version('1.43.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
@@ -96,6 +96,7 @@ program
     .command('status [locale]')
     .description('Display translation status. Provide a locale for a detailed key-by-key view.')
     .option('-n, --namespace <ns>', 'Filter the status report by a specific namespace')
+    .option('--hide-translated', 'Hide already translated keys in the detailed view')
     .action(async (locale, options) => {
     const cfgPath = program.opts().config;
     let config$1 = await config.loadConfig(cfgPath);
@@ -110,7 +111,7 @@ program
         console.log(node_util.styleText('green', 'Project structure detected successfully!'));
         config$1 = detected;
     }
-    await status.runStatus(config$1, { detail: locale, namespace: options.namespace });
+    await status.runStatus(config$1, { detail: locale, namespace: options.namespace, hideTranslated: !!options.hideTranslated });
 });
 program
     .command('types')

package/dist/cjs/extractor/parsers/ast-utils.js

@@ -161,16 +161,23 @@ function isSimpleTemplateLiteral(literal) {
  *
  * @param object - Object expression to search
  * @param propName - Property name to find
+ * @param identifierResolver - callback to resolve Identifier type values when needed
  * @returns String value if found, empty string if property exists but isn't a string, undefined if not found
  *
  * @private
  */
-function getObjectPropValue(object, propName) {
+function getObjectPropValue(object, propName, identifierResolver) {
     const prop = getObjectProperty(object, propName);
     if (prop?.type === 'KeyValueProperty') {
         const val = prop.value;
         if (val.type === 'StringLiteral')
             return val.value;
+        if (val.type === 'Identifier') {
+            if (identifierResolver) {
+                return identifierResolver(val.value);
+            }
+            return '';
+        }
         if (val.type === 'TemplateLiteral' && isSimpleTemplateLiteral(val))
             return val.quasis[0].cooked;
         if (val.type === 'BooleanLiteral')

package/dist/cjs/extractor/parsers/scope-manager.js

@@ -322,14 +322,10 @@ class ScopeManager {
             kpArg = kpArgIndex === -1 ? undefined : callExpr.arguments?.[kpArgIndex]?.expression;
         }
         if (kpArg?.type === 'ObjectExpression') {
-            const kp = astUtils.getObjectPropValue(kpArg, 'keyPrefix');
+            const kp = astUtils.getObjectPropValue(kpArg, 'keyPrefix', this.resolveSimpleStringIdentifier.bind(this));
             if (typeof kp === 'string') {
                 keyPrefix = kp;
             }
-            else if (kp && typeof kp === 'object' && kp.type === 'Identifier') {
-                // ← FIX B: resolve { keyPrefix: I18N_PREFIX } where the value is an Identifier
-                keyPrefix = this.resolveSimpleStringIdentifier(kp.value);
-            }
         }
         else if (kpArg?.type === 'StringLiteral') {
             keyPrefix = kpArg.value;

package/dist/cjs/status.js

@@ -218,7 +218,7 @@ async function generateStatusReport(config) {
  */
 async function displayStatusReport(report, config, options) {
     if (options.detail) {
-        await displayDetailedLocaleReport(report, config, options.detail, options.namespace);
+        await displayDetailedLocaleReport(report, config, options.detail, options.namespace, options.hideTranslated);
     }
     else if (options.namespace) {
         await displayNamespaceSummaryReport(report, config, options.namespace);
@@ -240,8 +240,9 @@ async function displayStatusReport(report, config, options) {
  * @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
  */
-async function displayDetailedLocaleReport(report, config, locale, namespaceFilter) {
+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;
@@ -265,7 +266,8 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
             continue;
         console.log(node_util.styleText(['cyan', 'bold'], `\nNamespace: ${ns}`));
         printProgressBar('Namespace Progress', nsData.translatedKeys, nsData.totalKeys);
-        nsData.keyDetails.forEach(({ key, isTranslated }) => {
+        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}`);
         });

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.42.11'); // This string is replaced with the actual version at build time by rollup
+    .version('1.43.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
@@ -94,6 +94,7 @@ program
     .command('status [locale]')
     .description('Display translation status. Provide a locale for a detailed key-by-key view.')
     .option('-n, --namespace <ns>', 'Filter the status report by a specific namespace')
+    .option('--hide-translated', 'Hide already translated keys in the detailed view')
     .action(async (locale, options) => {
     const cfgPath = program.opts().config;
     let config = await loadConfig(cfgPath);
@@ -108,7 +109,7 @@ program
         console.log(styleText('green', 'Project structure detected successfully!'));
         config = detected;
     }
-    await runStatus(config, { detail: locale, namespace: options.namespace });
+    await runStatus(config, { detail: locale, namespace: options.namespace, hideTranslated: !!options.hideTranslated });
 });
 program
     .command('types')

package/dist/esm/extractor/parsers/ast-utils.js

@@ -159,16 +159,23 @@ function isSimpleTemplateLiteral(literal) {
  *
  * @param object - Object expression to search
  * @param propName - Property name to find
+ * @param identifierResolver - callback to resolve Identifier type values when needed
  * @returns String value if found, empty string if property exists but isn't a string, undefined if not found
  *
  * @private
  */
-function getObjectPropValue(object, propName) {
+function getObjectPropValue(object, propName, identifierResolver) {
     const prop = getObjectProperty(object, propName);
     if (prop?.type === 'KeyValueProperty') {
         const val = prop.value;
         if (val.type === 'StringLiteral')
             return val.value;
+        if (val.type === 'Identifier') {
+            if (identifierResolver) {
+                return identifierResolver(val.value);
+            }
+            return '';
+        }
         if (val.type === 'TemplateLiteral' && isSimpleTemplateLiteral(val))
             return val.quasis[0].cooked;
         if (val.type === 'BooleanLiteral')

package/dist/esm/extractor/parsers/scope-manager.js

@@ -320,14 +320,10 @@ class ScopeManager {
             kpArg = kpArgIndex === -1 ? undefined : callExpr.arguments?.[kpArgIndex]?.expression;
         }
         if (kpArg?.type === 'ObjectExpression') {
-            const kp = getObjectPropValue(kpArg, 'keyPrefix');
+            const kp = getObjectPropValue(kpArg, 'keyPrefix', this.resolveSimpleStringIdentifier.bind(this));
             if (typeof kp === 'string') {
                 keyPrefix = kp;
             }
-            else if (kp && typeof kp === 'object' && kp.type === 'Identifier') {
-                // ← FIX B: resolve { keyPrefix: I18N_PREFIX } where the value is an Identifier
-                keyPrefix = this.resolveSimpleStringIdentifier(kp.value);
-            }
         }
         else if (kpArg?.type === 'StringLiteral') {
             keyPrefix = kpArg.value;

package/dist/esm/status.js

@@ -216,7 +216,7 @@ async function generateStatusReport(config) {
  */
 async function displayStatusReport(report, config, options) {
     if (options.detail) {
-        await displayDetailedLocaleReport(report, config, options.detail, options.namespace);
+        await displayDetailedLocaleReport(report, config, options.detail, options.namespace, options.hideTranslated);
     }
     else if (options.namespace) {
         await displayNamespaceSummaryReport(report, config, options.namespace);
@@ -238,8 +238,9 @@ async function displayStatusReport(report, config, options) {
  * @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
  */
-async function displayDetailedLocaleReport(report, config, locale, namespaceFilter) {
+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;
@@ -263,7 +264,8 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
             continue;
         console.log(styleText(['cyan', 'bold'], `\nNamespace: ${ns}`));
         printProgressBar('Namespace Progress', nsData.translatedKeys, nsData.totalKeys);
-        nsData.keyDetails.forEach(({ key, isTranslated }) => {
+        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}`);
         });

package/package.json

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

package/types/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAkBnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AAoR7B,OAAO,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAkBnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AAqR7B,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/types/extractor/parsers/ast-utils.d.ts

@@ -76,6 +76,7 @@ export declare function getObjectPropValueExpression(object: ObjectExpression, p
  * @private
  */
 export declare function isSimpleTemplateLiteral(literal: TemplateLiteral): boolean;
+type IdentifierResolver = (name: string) => string | boolean | number | undefined;
 /**
  * Extracts string value from object property.
  *
@@ -84,9 +85,11 @@ export declare function isSimpleTemplateLiteral(literal: TemplateLiteral): boole
  *
  * @param object - Object expression to search
  * @param propName - Property name to find
+ * @param identifierResolver - callback to resolve Identifier type values when needed
  * @returns String value if found, empty string if property exists but isn't a string, undefined if not found
  *
  * @private
  */
-export declare function getObjectPropValue(object: ObjectExpression, propName: string): string | boolean | number | undefined;
+export declare function getObjectPropValue(object: ObjectExpression, propName: string, identifierResolver?: IdentifierResolver): string | boolean | number | undefined;
+export {};
 //# sourceMappingURL=ast-utils.d.ts.map

package/types/extractor/parsers/ast-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast-utils.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/ast-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAc,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE1F;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA0BhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQhH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qDAU5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAKhH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAYrH"}
+{"version":3,"file":"ast-utils.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/ast-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAc,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE1F;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA0BhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQhH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qDAU5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAKhH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAE1E;AAED,KAAK,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAEjF;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAkB9J"}

package/types/extractor/parsers/scope-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/scope-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAmC,MAAM,WAAW,CAAA;AACpF,OAAO,KAAK,EAAE,SAAS,EAA4B,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAG5F,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,KAAK,CAAqE;IAGlF,OAAO,CAAC,eAAe,CAAiC;gBAE3C,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC;IAI1D;;;;;;OAMG;IACI,KAAK,IAAK,IAAI;IAMrB;;;OAGG;IACH,UAAU,IAAK,IAAI;IAInB;;;OAGG;IACH,SAAS,IAAK,IAAI;IAIlB;;;;;;OAMG;IACH,aAAa,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAUnD;;;;;;OAMG;IACH,eAAe,CAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAkBrD,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACI,6BAA6B,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvE;;;;;;;;;;OAUG;IACH,wBAAwB,CAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAuDzD;;;;;;;;OAQG;IACH,OAAO,CAAC,+BAA+B;IAsGvC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,8BAA8B;IA8EtC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;IAoBjC;;;;;;;;;OASG;IACH,OAAO,CAAC,qCAAqC;CAuB9C"}
+{"version":3,"file":"scope-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/scope-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAmC,MAAM,WAAW,CAAA;AACpF,OAAO,KAAK,EAAE,SAAS,EAA4B,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAG5F,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,KAAK,CAAqE;IAGlF,OAAO,CAAC,eAAe,CAAiC;gBAE3C,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC;IAI1D;;;;;;OAMG;IACI,KAAK,IAAK,IAAI;IAMrB;;;OAGG;IACH,UAAU,IAAK,IAAI;IAInB;;;OAGG;IACH,SAAS,IAAK,IAAI;IAIlB;;;;;;OAMG;IACH,aAAa,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAUnD;;;;;;OAMG;IACH,eAAe,CAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAkBrD,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACI,6BAA6B,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvE;;;;;;;;;;OAUG;IACH,wBAAwB,CAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAuDzD;;;;;;;;OAQG;IACH,OAAO,CAAC,+BAA+B;IAsGvC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,8BAA8B;IA+EtC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;IAoBjC;;;;;;;;;OASG;IACH,OAAO,CAAC,qCAAqC;CAuB9C"}

package/types/status.d.ts

@@ -7,6 +7,8 @@ interface StatusOptions {
     detail?: string;
     /** Namespace to filter the report by */
     namespace?: string;
+    /** When true, only untranslated keys are shown in the detailed view */
+    hideTranslated?: boolean;
 }
 /**
  * Runs a health check on the project's i18next translations and displays a status report.

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,SAAS,CAAA;AAIjE;;GAEG;AACH,UAAU,aAAa;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;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,SAAS,CAAA;AAIjE;;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"}