i18next-cli 1.72.2 → 1.72.4

package/README.md

@@ -609,6 +609,8 @@ The command walks through six steps:
 npx skills add i18next/i18next-cli
 ```
 
+[![skills.sh installs](https://www.skills.sh/b/i18next/i18next-cli)](https://www.skills.sh/i18next/i18next-cli)
+
 Then just ask it to *"add i18n to this project"*. See [`skills/i18next-localization`](./skills/i18next-localization/SKILL.md) — it ships in this repo, so it stays version-matched to the commands it drives.
 
 **Agent prompt:** the same flow is also available as a copy-paste prompt for AI coding agents (Claude Code, Cursor, …):

package/dist/cjs/cli.js

@@ -37,7 +37,8 @@ const program = new commander.Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.72.2'); // This string is replaced with the actual version at build time by rollup
+    .version('1.72.4') // This string is replaced with the actual version at build time by rollup
+    .addHelpText('after', '\nUsing an AI coding agent? Install the i18next-localization skill: npx skills add i18next/i18next-cli\n');
 // new: global config override option
 program.option('-c, --config <path>', 'Path to i18next-cli config file (overrides detection)');
 program

package/dist/cjs/extractor/core/extractor.js

@@ -13,8 +13,10 @@ var commentParser = require('../parsers/comment-parser.js');
 var astUtils = require('../parsers/ast-utils.js');
 var logger = require('../../utils/logger.js');
 var fileUtils = require('../../utils/file-utils.js');
-var funnelMsgTracker = require('../../utils/funnel-msg-tracker.js');
+var locizeFunnel = require('../../utils/locize-funnel.js');
+var nestedObject = require('../../utils/nested-object.js');
 
+const LOCIZE_SIGNUP_URL = 'https://www.locize.app/register?from=i18next_cli__extract';
 /**
  * Main extractor function that runs the complete key extraction and file generation process.
  *
@@ -91,8 +93,16 @@ async function runExtractor(config, options = {}) {
             : node_util.styleText('bold', 'Extraction complete!');
         spinner.succeed(completionMessage);
         // Show the funnel message only if files were actually changed.
-        if (anyFileUpdated && !options.isDryRun && !options.quiet)
-            await printLocizeFunnel(options.logger);
+        if (anyFileUpdated && !options.isDryRun && !options.quiet) {
+            const keySeparator = config.extract.keySeparator ?? '.';
+            const countEmpty = (obj) => nestedObject.getNestedKeys(obj, keySeparator).filter(key => nestedObject.getNestedValue(obj, key, keySeparator) === '').length;
+            const gaps = (config.extract.secondaryLanguages ?? []).map(locale => ({
+                locale,
+                untranslated: results.filter(r => r.locale === locale).reduce((sum, r) => sum + countEmpty(r.newTranslations), 0)
+            }));
+            const log = typeof internalLogger.info === 'function' ? (msg) => internalLogger.info(msg) : undefined;
+            await locizeFunnel.printUntranslatedFunnel('extract', gaps, LOCIZE_SIGNUP_URL, log);
+        }
         return { anyFileUpdated, hasErrors: fileErrors.length > 0, results };
     }
     catch (error) {
@@ -383,33 +393,6 @@ async function extract(config, { syncPrimaryWithDefaults = false } = {}) {
     const { allKeys, objectKeys } = await keyFinder.findKeys(config);
     return translationManager.getTranslations(allKeys, objectKeys, config, { syncPrimaryWithDefaults });
 }
-/**
- * Prints a promotional message for the locize saveMissing workflow.
- * This message is shown after a successful extraction that resulted in changes.
- */
-async function printLocizeFunnel(logger$1) {
-    if (!(await funnelMsgTracker.shouldShowFunnel('extract')))
-        return;
-    const internalLogger = logger$1 ?? new logger.ConsoleLogger();
-    const lines = [
-        node_util.styleText(['yellow', 'bold'], '\n💡 Tip: Tired of running the extractor manually?'),
-        '   Discover a real-time "push" workflow with `saveMissing` and Locize AI/MT,',
-        '   where keys are created and translated automatically as you code.',
-        `   Learn more: ${node_util.styleText('cyan', 'https://www.locize.com/blog/i18next-savemissing-ai-automation')}`,
-        `   Watch the video: ${node_util.styleText('cyan', 'https://youtu.be/joPsZghT3wM')}`,
-        '',
-        '   You can also sync your extracted translations to Locize:',
-        `     ${node_util.styleText('cyan', 'npx i18next-cli locize-sync')}      – upload/sync translations to Locize`,
-        `     ${node_util.styleText('cyan', 'npx i18next-cli locize-migrate')}   – migrate local translations to Locize`,
-        '   Or import them manually via the Locize UI, API, or locize-cli.',
-    ];
-    const log = typeof internalLogger.info === 'function'
-        ? (msg) => internalLogger.info(msg)
-        : (msg) => console.log(msg);
-    for (const line of lines)
-        log(line);
-    return funnelMsgTracker.recordFunnelShown('extract');
-}
 
 exports.extract = extract;
 exports.preScanFile = preScanFile;

package/dist/cjs/status.js

@@ -13,11 +13,13 @@ var nesting = require('./utils/nesting.js');
 var contextVariants = require('./utils/context-variants.js');
 require('node:module');
 var funnelMsgTracker = require('./utils/funnel-msg-tracker.js');
+var locizeFunnel = require('./utils/locize-funnel.js');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var ora__default = /*#__PURE__*/_interopDefault(ora);
 
+const LOCIZE_SIGNUP_URL = 'https://www.locize.app/register?from=i18next_cli__status';
 function globToRegex(glob) {
     const escaped = glob.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
     return new RegExp(`^${escaped.replace(/\*/g, '.*')}$`);
@@ -693,7 +695,11 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
     else {
         console.log(node_util.styleText(['green', 'bold'], `\nSummary: 🎉 All keys are translated for "${locale}".`));
     }
-    await printLocizeFunnel();
+    // Untranslated keys in a secondary locale are the gap Locize fills; absent
+    // keys in the primary language are an `extract` problem (handled above).
+    const nsData = namespaceFilter ? localeData.namespaces.get(namespaceFilter) : undefined;
+    const untranslated = nsData ? nsData.totalKeys - nsData.translatedKeys : missingCount;
+    await locizeFunnel.printUntranslatedFunnel('status', isPrimary ? [] : [{ locale, untranslated }], LOCIZE_SIGNUP_URL);
 }
 /**
  * Displays a summary report filtered by a single namespace.
@@ -728,7 +734,11 @@ async function displayNamespaceSummaryReport(report, config, namespace) {
         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();
+    const gaps = Array.from(report.locales, ([locale, localeData]) => {
+        const nsLocaleData = localeData.namespaces.get(namespace);
+        return { locale, untranslated: nsLocaleData ? nsLocaleData.totalKeys - nsLocaleData.translatedKeys : 0 };
+    });
+    await locizeFunnel.printUntranslatedFunnel('status', gaps, LOCIZE_SIGNUP_URL);
 }
 /**
  * Displays the default, high-level summary report for all locales.
@@ -762,7 +772,8 @@ async function displayOverallSummaryReport(report, config) {
         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();
+    const gaps = Array.from(report.locales, ([locale, localeData]) => ({ locale, untranslated: localeData.totalKeys - localeData.totalTranslated }));
+    await locizeFunnel.printUntranslatedFunnel('status', gaps, LOCIZE_SIGNUP_URL);
 }
 /**
  * Prints a formatted progress bar with label, percentage, and counts.
@@ -872,14 +883,6 @@ async function runUnusedReport(config, options = {}) {
         process.exit(1);
     }
 }
-async function printLocizeFunnel() {
-    if (!(await funnelMsgTracker.shouldShowFunnel('status')))
-        return;
-    console.log(node_util.styleText(['yellow', 'bold'], '\n✨ Take your localization to the next level!'));
-    console.log('Manage translations with your team in the cloud with Locize => https://www.locize.com/docs/getting-started');
-    console.log(`Run ${node_util.styleText('cyan', 'npx i18next-cli locize-migrate')} to get started.`);
-    return funnelMsgTracker.recordFunnelShown('status');
-}
 
 exports.runStatus = runStatus;
 exports.runUnusedReport = runUnusedReport;

package/dist/cjs/syncer.js

@@ -8,11 +8,12 @@ var wrapOra = require('./utils/wrap-ora.js');
 var logger = require('./utils/logger.js');
 var defaultValue = require('./utils/default-value.js');
 var fileUtils = require('./utils/file-utils.js');
-var funnelMsgTracker = require('./utils/funnel-msg-tracker.js');
+var locizeFunnel = require('./utils/locize-funnel.js');
 var nestedObject = require('./utils/nested-object.js');
 var pluralRules = require('./utils/plural-rules.js');
 var gitChangedKeys = require('./utils/git-changed-keys.js');
 
+const LOCIZE_SIGNUP_URL = 'https://www.locize.app/register?from=i18next_cli__sync';
 /**
  * Synchronizes translation files across different locales by ensuring all secondary
  * language files contain the same keys as the primary language file.
@@ -56,6 +57,8 @@ async function runSyncer(config, options = {}) {
         const { output, keySeparator = '.', outputFormat = 'json', indentation = 2, defaultValue: defaultValue$1 = '', } = config.extract;
         const logMessages = [];
         let wasAnythingSynced = false;
+        // Keys still empty after the sync, per secondary locale (the funnel line's gap)
+        const untranslatedByLocale = {};
         // 1. Find all namespace files for the primary language
         const primaryNsPatternRaw = fileUtils.getOutputPath(output, primaryLanguage, '*');
         // Ensure glob receives POSIX-style separators so pattern matching works cross-platform (Windows -> backslashes)
@@ -216,6 +219,8 @@ async function runSyncer(config, options = {}) {
                         nestedObject.setNestedValue(newSecondaryTranslations, key, valueToSet, keySeparator ?? '.');
                     }
                 }
+                untranslatedByLocale[lang] = (untranslatedByLocale[lang] ?? 0) + nestedObject.getNestedKeys(newSecondaryTranslations, keySeparator ?? '.')
+                    .filter(key => nestedObject.getNestedValue(newSecondaryTranslations, key, keySeparator ?? '.') === '').length;
                 // Use JSON.stringify for a reliable object comparison, regardless of format
                 const oldContent = JSON.stringify(existingSecondaryTranslations);
                 const newContent = JSON.stringify(newSecondaryTranslations);
@@ -236,7 +241,8 @@ async function runSyncer(config, options = {}) {
         spinner.succeed(node_util.styleText('bold', 'Synchronization complete!'));
         logMessages.forEach(msg => internalLogger.info ? internalLogger.info(msg) : console.log(msg));
         if (wasAnythingSynced && !options.quiet) {
-            await printLocizeFunnel();
+            const gaps = Object.entries(untranslatedByLocale).map(([locale, untranslated]) => ({ locale, untranslated }));
+            await locizeFunnel.printUntranslatedFunnel('syncer', gaps, LOCIZE_SIGNUP_URL);
         }
         else if (!wasAnythingSynced) {
             if (typeof internalLogger.info === 'function')
@@ -253,13 +259,5 @@ async function runSyncer(config, options = {}) {
             console.error(error);
     }
 }
-async function printLocizeFunnel() {
-    if (!(await funnelMsgTracker.shouldShowFunnel('syncer')))
-        return;
-    console.log(node_util.styleText(['green', 'bold'], '\n✅ Sync complete.'));
-    console.log(node_util.styleText('yellow', '🚀 Ready to collaborate with translators? Move your files to the cloud.'));
-    console.log(`   Get started with the official TMS for i18next: ${node_util.styleText('cyan', 'npx i18next-cli locize-migrate')}`);
-    return funnelMsgTracker.recordFunnelShown('syncer');
-}
 
 exports.runSyncer = runSyncer;

package/dist/cjs/utils/locize-funnel.js

@@ -0,0 +1,29 @@
+'use strict';
+
+var node_util = require('node:util');
+var funnelMsgTracker = require('./funnel-msg-tracker.js');
+
+/**
+ * Prints the one-line Locize funnel for commands that have just reported
+ * untranslated keys: the gap, the one command that fills it, and the
+ * register link tagged `?from=i18next_cli__<command>` so registrations stay
+ * attributable per command.
+ *
+ * Prints nothing when there is no gap, and is gated like every other funnel
+ * message (never in CI/non-TTY, once per 24h per `funnelKey`).
+ */
+async function printUntranslatedFunnel(funnelKey, gaps, signupUrl, log = console.log) {
+    const open = gaps.filter(g => g.untranslated > 0);
+    const total = open.reduce((sum, g) => sum + g.untranslated, 0);
+    if (total === 0)
+        return;
+    if (!(await funnelMsgTracker.shouldShowFunnel(funnelKey)))
+        return;
+    const where = open.length === 1
+        ? `in ${open[0].locale}`
+        : `(${open.map(g => `${g.locale} ${g.untranslated}`).join(', ')})`;
+    log(`\n💡 ${total} untranslated key${total === 1 ? '' : 's'} ${where}. Translate them with AI in one command: ${node_util.styleText('cyan', 'npx i18next-cli localize')} (sign up: ${signupUrl})`);
+    return funnelMsgTracker.recordFunnelShown(funnelKey);
+}
+
+exports.printUntranslatedFunnel = printUntranslatedFunnel;

package/dist/esm/cli.js

@@ -31,7 +31,8 @@ const program = new Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.72.2'); // This string is replaced with the actual version at build time by rollup
+    .version('1.72.4') // This string is replaced with the actual version at build time by rollup
+    .addHelpText('after', '\nUsing an AI coding agent? Install the i18next-localization skill: npx skills add i18next/i18next-cli\n');
 // new: global config override option
 program.option('-c, --config <path>', 'Path to i18next-cli config file (overrides detection)');
 program

package/dist/esm/extractor/core/extractor.js

@@ -11,8 +11,10 @@ import { extractKeysFromComments } from '../parsers/comment-parser.js';
 import { normalizeSpansToCharIndices } from '../parsers/ast-utils.js';
 import { ConsoleLogger } from '../../utils/logger.js';
 import { inferFormatFromPath, loadRawJson5Content, serializeTranslationFile } from '../../utils/file-utils.js';
-import { shouldShowFunnel, recordFunnelShown } from '../../utils/funnel-msg-tracker.js';
+import { printUntranslatedFunnel } from '../../utils/locize-funnel.js';
+import { getNestedKeys, getNestedValue } from '../../utils/nested-object.js';
 
+const LOCIZE_SIGNUP_URL = 'https://www.locize.app/register?from=i18next_cli__extract';
 /**
  * Main extractor function that runs the complete key extraction and file generation process.
  *
@@ -89,8 +91,16 @@ async function runExtractor(config, options = {}) {
             : styleText('bold', 'Extraction complete!');
         spinner.succeed(completionMessage);
         // Show the funnel message only if files were actually changed.
-        if (anyFileUpdated && !options.isDryRun && !options.quiet)
-            await printLocizeFunnel(options.logger);
+        if (anyFileUpdated && !options.isDryRun && !options.quiet) {
+            const keySeparator = config.extract.keySeparator ?? '.';
+            const countEmpty = (obj) => getNestedKeys(obj, keySeparator).filter(key => getNestedValue(obj, key, keySeparator) === '').length;
+            const gaps = (config.extract.secondaryLanguages ?? []).map(locale => ({
+                locale,
+                untranslated: results.filter(r => r.locale === locale).reduce((sum, r) => sum + countEmpty(r.newTranslations), 0)
+            }));
+            const log = typeof internalLogger.info === 'function' ? (msg) => internalLogger.info(msg) : undefined;
+            await printUntranslatedFunnel('extract', gaps, LOCIZE_SIGNUP_URL, log);
+        }
         return { anyFileUpdated, hasErrors: fileErrors.length > 0, results };
     }
     catch (error) {
@@ -381,32 +391,5 @@ async function extract(config, { syncPrimaryWithDefaults = false } = {}) {
     const { allKeys, objectKeys } = await findKeys(config);
     return getTranslations(allKeys, objectKeys, config, { syncPrimaryWithDefaults });
 }
-/**
- * Prints a promotional message for the locize saveMissing workflow.
- * This message is shown after a successful extraction that resulted in changes.
- */
-async function printLocizeFunnel(logger) {
-    if (!(await shouldShowFunnel('extract')))
-        return;
-    const internalLogger = logger ?? new ConsoleLogger();
-    const lines = [
-        styleText(['yellow', 'bold'], '\n💡 Tip: Tired of running the extractor manually?'),
-        '   Discover a real-time "push" workflow with `saveMissing` and Locize AI/MT,',
-        '   where keys are created and translated automatically as you code.',
-        `   Learn more: ${styleText('cyan', 'https://www.locize.com/blog/i18next-savemissing-ai-automation')}`,
-        `   Watch the video: ${styleText('cyan', 'https://youtu.be/joPsZghT3wM')}`,
-        '',
-        '   You can also sync your extracted translations to Locize:',
-        `     ${styleText('cyan', 'npx i18next-cli locize-sync')}      – upload/sync translations to Locize`,
-        `     ${styleText('cyan', 'npx i18next-cli locize-migrate')}   – migrate local translations to Locize`,
-        '   Or import them manually via the Locize UI, API, or locize-cli.',
-    ];
-    const log = typeof internalLogger.info === 'function'
-        ? (msg) => internalLogger.info(msg)
-        : (msg) => console.log(msg);
-    for (const line of lines)
-        log(line);
-    return recordFunnelShown('extract');
-}
 
 export { extract, preScanFile, processFile, runExtractor };

package/dist/esm/status.js

@@ -11,7 +11,9 @@ import { parseNestedReferences } from './utils/nesting.js';
 import { isContextVariantOfAcceptingKey } from './utils/context-variants.js';
 import 'node:module';
 import { shouldShowFunnel, recordFunnelShown } from './utils/funnel-msg-tracker.js';
+import { printUntranslatedFunnel } from './utils/locize-funnel.js';
 
+const LOCIZE_SIGNUP_URL = 'https://www.locize.app/register?from=i18next_cli__status';
 function globToRegex(glob) {
     const escaped = glob.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
     return new RegExp(`^${escaped.replace(/\*/g, '.*')}$`);
@@ -687,7 +689,11 @@ async function displayDetailedLocaleReport(report, config, locale, namespaceFilt
     else {
         console.log(styleText(['green', 'bold'], `\nSummary: 🎉 All keys are translated for "${locale}".`));
     }
-    await printLocizeFunnel();
+    // Untranslated keys in a secondary locale are the gap Locize fills; absent
+    // keys in the primary language are an `extract` problem (handled above).
+    const nsData = namespaceFilter ? localeData.namespaces.get(namespaceFilter) : undefined;
+    const untranslated = nsData ? nsData.totalKeys - nsData.translatedKeys : missingCount;
+    await printUntranslatedFunnel('status', isPrimary ? [] : [{ locale, untranslated }], LOCIZE_SIGNUP_URL);
 }
 /**
  * Displays a summary report filtered by a single namespace.
@@ -722,7 +728,11 @@ async function displayNamespaceSummaryReport(report, config, namespace) {
         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();
+    const gaps = Array.from(report.locales, ([locale, localeData]) => {
+        const nsLocaleData = localeData.namespaces.get(namespace);
+        return { locale, untranslated: nsLocaleData ? nsLocaleData.totalKeys - nsLocaleData.translatedKeys : 0 };
+    });
+    await printUntranslatedFunnel('status', gaps, LOCIZE_SIGNUP_URL);
 }
 /**
  * Displays the default, high-level summary report for all locales.
@@ -756,7 +766,8 @@ async function displayOverallSummaryReport(report, config) {
         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();
+    const gaps = Array.from(report.locales, ([locale, localeData]) => ({ locale, untranslated: localeData.totalKeys - localeData.totalTranslated }));
+    await printUntranslatedFunnel('status', gaps, LOCIZE_SIGNUP_URL);
 }
 /**
  * Prints a formatted progress bar with label, percentage, and counts.
@@ -866,13 +877,5 @@ async function runUnusedReport(config, options = {}) {
         process.exit(1);
     }
 }
-async function printLocizeFunnel() {
-    if (!(await shouldShowFunnel('status')))
-        return;
-    console.log(styleText(['yellow', 'bold'], '\n✨ Take your localization to the next level!'));
-    console.log('Manage translations with your team in the cloud with Locize => https://www.locize.com/docs/getting-started');
-    console.log(`Run ${styleText('cyan', 'npx i18next-cli locize-migrate')} to get started.`);
-    return recordFunnelShown('status');
-}
 
 export { runStatus, runUnusedReport };

package/dist/esm/syncer.js

@@ -6,11 +6,12 @@ import { createSpinnerLike } from './utils/wrap-ora.js';
 import { ConsoleLogger } from './utils/logger.js';
 import { resolveDefaultValue } from './utils/default-value.js';
 import { getOutputPath, loadTranslationFile, inferFormatFromPath, loadRawJson5Content, serializeTranslationFile } from './utils/file-utils.js';
-import { shouldShowFunnel, recordFunnelShown } from './utils/funnel-msg-tracker.js';
+import { printUntranslatedFunnel } from './utils/locize-funnel.js';
 import { getNestedKeys, getNestedValue, setNestedValue } from './utils/nested-object.js';
 import { safePluralRules } from './utils/plural-rules.js';
 import { resolveGitCompareRef, readFileAtRef, parseTranslationContent, makeChangedKeyMatcher } from './utils/git-changed-keys.js';
 
+const LOCIZE_SIGNUP_URL = 'https://www.locize.app/register?from=i18next_cli__sync';
 /**
  * Synchronizes translation files across different locales by ensuring all secondary
  * language files contain the same keys as the primary language file.
@@ -54,6 +55,8 @@ async function runSyncer(config, options = {}) {
         const { output, keySeparator = '.', outputFormat = 'json', indentation = 2, defaultValue = '', } = config.extract;
         const logMessages = [];
         let wasAnythingSynced = false;
+        // Keys still empty after the sync, per secondary locale (the funnel line's gap)
+        const untranslatedByLocale = {};
         // 1. Find all namespace files for the primary language
         const primaryNsPatternRaw = getOutputPath(output, primaryLanguage, '*');
         // Ensure glob receives POSIX-style separators so pattern matching works cross-platform (Windows -> backslashes)
@@ -214,6 +217,8 @@ async function runSyncer(config, options = {}) {
                         setNestedValue(newSecondaryTranslations, key, valueToSet, keySeparator ?? '.');
                     }
                 }
+                untranslatedByLocale[lang] = (untranslatedByLocale[lang] ?? 0) + getNestedKeys(newSecondaryTranslations, keySeparator ?? '.')
+                    .filter(key => getNestedValue(newSecondaryTranslations, key, keySeparator ?? '.') === '').length;
                 // Use JSON.stringify for a reliable object comparison, regardless of format
                 const oldContent = JSON.stringify(existingSecondaryTranslations);
                 const newContent = JSON.stringify(newSecondaryTranslations);
@@ -234,7 +239,8 @@ async function runSyncer(config, options = {}) {
         spinner.succeed(styleText('bold', 'Synchronization complete!'));
         logMessages.forEach(msg => internalLogger.info ? internalLogger.info(msg) : console.log(msg));
         if (wasAnythingSynced && !options.quiet) {
-            await printLocizeFunnel();
+            const gaps = Object.entries(untranslatedByLocale).map(([locale, untranslated]) => ({ locale, untranslated }));
+            await printUntranslatedFunnel('syncer', gaps, LOCIZE_SIGNUP_URL);
         }
         else if (!wasAnythingSynced) {
             if (typeof internalLogger.info === 'function')
@@ -251,13 +257,5 @@ async function runSyncer(config, options = {}) {
             console.error(error);
     }
 }
-async function printLocizeFunnel() {
-    if (!(await shouldShowFunnel('syncer')))
-        return;
-    console.log(styleText(['green', 'bold'], '\n✅ Sync complete.'));
-    console.log(styleText('yellow', '🚀 Ready to collaborate with translators? Move your files to the cloud.'));
-    console.log(`   Get started with the official TMS for i18next: ${styleText('cyan', 'npx i18next-cli locize-migrate')}`);
-    return recordFunnelShown('syncer');
-}
 
 export { runSyncer };

package/dist/esm/utils/locize-funnel.js

@@ -0,0 +1,27 @@
+import { styleText } from 'node:util';
+import { shouldShowFunnel, recordFunnelShown } from './funnel-msg-tracker.js';
+
+/**
+ * Prints the one-line Locize funnel for commands that have just reported
+ * untranslated keys: the gap, the one command that fills it, and the
+ * register link tagged `?from=i18next_cli__<command>` so registrations stay
+ * attributable per command.
+ *
+ * Prints nothing when there is no gap, and is gated like every other funnel
+ * message (never in CI/non-TTY, once per 24h per `funnelKey`).
+ */
+async function printUntranslatedFunnel(funnelKey, gaps, signupUrl, log = console.log) {
+    const open = gaps.filter(g => g.untranslated > 0);
+    const total = open.reduce((sum, g) => sum + g.untranslated, 0);
+    if (total === 0)
+        return;
+    if (!(await shouldShowFunnel(funnelKey)))
+        return;
+    const where = open.length === 1
+        ? `in ${open[0].locale}`
+        : `(${open.map(g => `${g.locale} ${g.untranslated}`).join(', ')})`;
+    log(`\n💡 ${total} untranslated key${total === 1 ? '' : 's'} ${where}. Translate them with AI in one command: ${styleText('cyan', 'npx i18next-cli localize')} (sign up: ${signupUrl})`);
+    return recordFunnelShown(funnelKey);
+}
+
+export { printUntranslatedFunnel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.72.2",
+  "version": "1.72.4",
   "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;AAqBnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AA0d7B,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;AAqBnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AA2d7B,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/types/extractor/core/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/extractor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAO5G,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAK/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAwExF;AAwBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,MAAM,GAAE,MAA4B,EACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAiJf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,MAAM,GAAE,MAA4B,EACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,uBAA+B,EAAE,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAO1K"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/extractor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAO5G,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAQ/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAiFxF;AAwBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,MAAM,GAAE,MAA4B,EACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAiJf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,MAAM,GAAE,MAA4B,EACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,uBAA+B,EAAE,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAO1K"}

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,EAAmC,MAAM,YAAY,CAAA;AAYvF;;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;AAyHD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAoDzF;AA4pBD;;GAEG;AACH,UAAU,aAAa;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAuE/F"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAmC,MAAM,YAAY,CAAA;AAevF;;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;AAyHD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAoDzF;AAqqBD;;GAEG;AACH,UAAU,aAAa;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAuE/F"}

package/types/syncer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncer.d.ts","sourceRoot":"","sources":["../src/syncer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAQ9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,iBA2NzF"}
+{"version":3,"file":"syncer.d.ts","sourceRoot":"","sources":["../src/syncer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAU9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,iBAiOzF"}

package/types/utils/locize-funnel.d.ts

@@ -0,0 +1,16 @@
+/** Untranslated-key count for one secondary locale. */
+export interface LocaleGap {
+    locale: string;
+    untranslated: number;
+}
+/**
+ * Prints the one-line Locize funnel for commands that have just reported
+ * untranslated keys: the gap, the one command that fills it, and the
+ * register link tagged `?from=i18next_cli__<command>` so registrations stay
+ * attributable per command.
+ *
+ * Prints nothing when there is no gap, and is gated like every other funnel
+ * message (never in CI/non-TTY, once per 24h per `funnelKey`).
+ */
+export declare function printUntranslatedFunnel(funnelKey: string, gaps: LocaleGap[], signupUrl: string, log?: (msg: string) => void): Promise<void>;
+//# sourceMappingURL=locize-funnel.d.ts.map

package/types/utils/locize-funnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locize-funnel.d.ts","sourceRoot":"","sources":["../../src/utils/locize-funnel.ts"],"names":[],"mappings":"AAGA,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAkB,GACvC,OAAO,CAAC,IAAI,CAAC,CAYf"}