i18next-cli 1.33.5 → 1.34.1

package/dist/cjs/status.js

@@ -1 +1,336 @@
-"use strict";var e=require("chalk"),t=require("ora"),a=require("node:path"),o=require("./extractor/core/key-finder.js"),s=require("./utils/nested-object.js"),n=require("./utils/file-utils.js"),l=require("./utils/funnel-msg-tracker.js");function r(t,a,o){const s=o>0?Math.round(a/o*100):100,n=c(s);console.log(`${e.bold(t)}: ${n} ${s}% (${a}/${o})`)}function c(t){const a=Math.floor(t/100*20),o=20-a;return`[${e.green("".padStart(a,"■"))}${"".padStart(o,"□")}]`}async function i(){if(await l.shouldShowFunnel("status"))return console.log(e.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 ${e.cyan("npx i18next-cli locize-migrate")} to get started.`),l.recordFunnelShown("status")}exports.runStatus=async function(l,u={}){l.extract.primaryLanguage||=l.locales[0]||"en",l.extract.secondaryLanguages||=l.locales.filter(e=>e!==l?.extract?.primaryLanguage);const d=t("Analyzing project localization status...\n").start();try{const t=await async function(e){e.extract.primaryLanguage||=e.locales[0]||"en",e.extract.secondaryLanguages||=e.locales.filter(t=>t!==e?.extract?.primaryLanguage);const{allKeys:t}=await o.findKeys(e),{secondaryLanguages:l,keySeparator:r=".",defaultNS:c="translation",mergeNamespaces:i=!1,pluralSeparator:u="_"}=e.extract,d=new Map;for(const e of t.values()){const t=e.ns||c||"translation";d.has(t)||d.set(t,[]),d.get(t).push(e)}const y={totalBaseKeys:t.size,keysByNs:d,locales:new Map};for(const t of l){let o=0,l=0;const g=new Map,f=i?await n.loadTranslationFile(a.resolve(process.cwd(),n.getOutputPath(e.extract.output,t,!1===c?"translation":c||"translation")))||{}:null;for(const[c,y]of d.entries()){const d=i?f?.[c]??f??{}:await n.loadTranslationFile(a.resolve(process.cwd(),n.getOutputPath(e.extract.output,t,c)))||{};let p=0,$=0;const m=[],h=(e,t)=>{try{const a=t?"ordinal":"cardinal";return new Intl.PluralRules(e,{type:a}).resolvedOptions().pluralCategories}catch(e){return new Intl.PluralRules("en",{type:t?"ordinal":"cardinal"}).resolvedOptions().pluralCategories}};for(const{key:e,hasCount:a,isOrdinal:o,isExpandedPlural:n}of y)if(a)if(n){const a=e.split(u),o=a[a.length-1],n=a.length>=2&&"ordinal"===a[a.length-2],l=n?a[a.length-1]:o;if(h(t,n).includes(l)){$++;const t=!!s.getNestedValue(d,e,r??".");t&&p++,m.push({key:e,isTranslated:t})}}else{const a=h(t,o||!1);for(const t of a){$++;const a=o?`${e}${u}ordinal${u}${t}`:`${e}${u}${t}`,n=!!s.getNestedValue(d,a,r??".");n&&p++,m.push({key:a,isTranslated:n})}}else{$++;const t=!!s.getNestedValue(d,e,r??".");t&&p++,m.push({key:e,isTranslated:t})}g.set(c,{totalKeys:$,translatedKeys:p,keyDetails:m}),o+=p,l+=$}y.locales.set(t,{totalKeys:l,totalTranslated:o,namespaces:g})}return y}(l);d.succeed("Analysis complete."),await async function(t,a,o){o.detail?await async function(t,a,o,s){if(o===a.extract.primaryLanguage)return void console.log(e.yellow(`Locale "${o}" is the primary language. All keys are considered present.`));if(!a.locales.includes(o))return void console.error(e.red(`Error: Locale "${o}" is not defined in your configuration.`));const n=t.locales.get(o);if(!n)return void console.error(e.red(`Error: Locale "${o}" is not a valid secondary language.`));console.log(e.bold(`\nKey Status for "${e.cyan(o)}":`));const l=n.totalKeys;r("Overall",n.totalTranslated,l);const c=s?[s]:Array.from(n.namespaces.keys()).sort();for(const t of c){const a=n.namespaces.get(t);a&&(console.log(e.cyan.bold(`\nNamespace: ${t}`)),r("Namespace Progress",a.translatedKeys,a.totalKeys),a.keyDetails.forEach(({key:t,isTranslated:a})=>{const o=a?e.green("✓"):e.red("✗");console.log(`  ${o} ${t}`)}))}const u=l-n.totalTranslated;u>0?console.log(e.yellow.bold(`\nSummary: Found ${u} missing translations for "${o}".`)):console.log(e.green.bold(`\nSummary: 🎉 All keys are translated for "${o}".`));await i()}(t,a,o.detail,o.namespace):o.namespace?await async function(t,a,o){const s=t.keysByNs.get(o);if(!s)return void console.error(e.red(`Error: Namespace "${o}" was not found in your source code.`));console.log(e.cyan.bold(`\nStatus for Namespace: "${o}"`)),console.log("------------------------");for(const[e,a]of t.locales.entries()){const t=a.namespaces.get(o);if(t){const a=t.totalKeys>0?Math.round(t.translatedKeys/t.totalKeys*100):100,o=c(a);console.log(`- ${e}: ${o} ${a}% (${t.translatedKeys}/${t.totalKeys} keys)`)}}await i()}(t,0,o.namespace):await async function(t,a){const{primaryLanguage:o}=a.extract;console.log(e.cyan.bold("\ni18next Project Status")),console.log("------------------------"),console.log(`🔑 Keys Found:         ${e.bold(t.totalBaseKeys)}`),console.log(`📚 Namespaces Found:   ${e.bold(t.keysByNs.size)}`),console.log(`🌍 Locales:            ${e.bold(a.locales.join(", "))}`),console.log(`✅ Primary Language:   ${e.bold(o)}`),console.log("\nTranslation Progress:");for(const[e,a]of t.locales.entries()){const t=a.totalKeys>0?Math.round(a.totalTranslated/a.totalKeys*100):100,o=c(t);console.log(`- ${e}: ${o} ${t}% (${a.totalTranslated}/${a.totalKeys} keys)`)}await i()}(t,a)}(t,l,u);let y=!1;for(const[,e]of t.locales.entries())if(e.totalTranslated<e.totalKeys){y=!0;break}y&&(d.fail("Error: Missing translations detected."),process.exit(1))}catch(e){d.fail("Failed to generate status report."),console.error(e)}};
+'use strict';
+
+var chalk = require('chalk');
+var ora = require('ora');
+var node_path = require('node:path');
+var keyFinder = require('./extractor/core/key-finder.js');
+var nestedObject = require('./utils/nested-object.js');
+var fileUtils = require('./utils/file-utils.js');
+var funnelMsgTracker = require('./utils/funnel-msg-tracker.js');
+
+/**
+ * Runs a health check on the project's i18next translations and displays a status report.
+ *
+ * This command provides a high-level overview of the localization status by:
+ * 1. Extracting all keys from the source code using the core extractor.
+ * 2. Reading all existing translation files for each locale.
+ * 3. Calculating the translation completeness for each secondary language against the primary.
+ * 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.
+ *
+ * @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
+ */
+async function runStatus(config, options = {}) {
+    config.extract.primaryLanguage ||= config.locales[0] || 'en';
+    config.extract.secondaryLanguages ||= config.locales.filter((l) => l !== config?.extract?.primaryLanguage);
+    const spinner = ora('Analyzing project localization status...\n').start();
+    try {
+        const report = await generateStatusReport(config);
+        spinner.succeed('Analysis complete.');
+        await displayStatusReport(report, config, options);
+        let hasMissing = false;
+        for (const [, localeData] of report.locales.entries()) {
+            if (localeData.totalTranslated < localeData.totalKeys) {
+                hasMissing = true;
+                break;
+            }
+        }
+        if (hasMissing) {
+            spinner.fail('Error: Missing translations detected.');
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        spinner.fail('Failed to generate status report.');
+        console.error(error);
+    }
+}
+/**
+ * Gathers all translation data and compiles it into a structured report.
+ *
+ * This function:
+ * - Extracts all keys from source code using the configured extractor
+ * - Groups keys by namespace
+ * - Reads translation files for each secondary language
+ * - Compares extracted keys against existing translations
+ * - Compiles translation statistics for each locale and namespace
+ *
+ * @param config - The i18next toolkit configuration object
+ * @returns Promise that resolves to a complete status report
+ * @throws {Error} When key extraction fails or configuration is invalid
+ */
+async function generateStatusReport(config) {
+    config.extract.primaryLanguage ||= config.locales[0] || 'en';
+    config.extract.secondaryLanguages ||= config.locales.filter((l) => l !== config?.extract?.primaryLanguage);
+    const { allKeys: allExtractedKeys } = await keyFinder.findKeys(config);
+    const { secondaryLanguages, keySeparator = '.', defaultNS = 'translation', mergeNamespaces = false, pluralSeparator = '_' } = config.extract;
+    const keysByNs = new Map();
+    for (const key of allExtractedKeys.values()) {
+        const ns = key.ns || defaultNS || 'translation';
+        if (!keysByNs.has(ns))
+            keysByNs.set(ns, []);
+        keysByNs.get(ns).push(key);
+    }
+    const report = {
+        totalBaseKeys: allExtractedKeys.size,
+        keysByNs,
+        locales: new Map(),
+    };
+    for (const locale of secondaryLanguages) {
+        let totalTranslatedForLocale = 0;
+        let totalKeysForLocale = 0;
+        const namespaces = new Map();
+        const mergedTranslations = mergeNamespaces
+            // When merging namespaces we need to load the combined translation file.
+            // The combined file lives under the regular output pattern and must include a namespace.
+            // If defaultNS is explicitly false, fall back to the conventional "translation" file name.
+            ? await fileUtils.loadTranslationFile(node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, locale, (defaultNS === false ? 'translation' : (defaultNS || 'translation'))))) || {}
+            : null;
+        for (const [ns, keysInNs] of keysByNs.entries()) {
+            const translationsForNs = mergeNamespaces
+                // If mergedTranslations is a flat object (no nested namespace) prefer the root object
+                // when mergedTranslations[ns] is missing.
+                ? (mergedTranslations?.[ns] ?? mergedTranslations ?? {})
+                : await fileUtils.loadTranslationFile(node_path.resolve(process.cwd(), fileUtils.getOutputPath(config.extract.output, locale, ns))) || {};
+            let translatedInNs = 0;
+            let totalInNs = 0;
+            const keyDetails = [];
+            // Get the plural categories for THIS specific locale
+            const getLocalePluralCategories = (locale, isOrdinal) => {
+                try {
+                    const type = isOrdinal ? 'ordinal' : 'cardinal';
+                    const pluralRules = new Intl.PluralRules(locale, { type });
+                    return pluralRules.resolvedOptions().pluralCategories;
+                }
+                catch (e) {
+                    // Fallback to English if locale is invalid
+                    const fallbackRules = new Intl.PluralRules('en', { type: isOrdinal ? 'ordinal' : 'cardinal' });
+                    return fallbackRules.resolvedOptions().pluralCategories;
+                }
+            };
+            for (const { key: baseKey, hasCount, isOrdinal, isExpandedPlural } of keysInNs) {
+                if (hasCount) {
+                    if (isExpandedPlural) {
+                        // This is an already-expanded plural variant key (e.g., key_one, key_other)
+                        // Check if this specific variant is needed for the target locale
+                        const keyParts = baseKey.split(pluralSeparator);
+                        const lastPart = keyParts[keyParts.length - 1];
+                        // Determine if this is an ordinal or cardinal plural
+                        const isOrdinalVariant = keyParts.length >= 2 && keyParts[keyParts.length - 2] === 'ordinal';
+                        const category = isOrdinalVariant ? keyParts[keyParts.length - 1] : lastPart;
+                        // Get the plural categories for this locale
+                        const localePluralCategories = getLocalePluralCategories(locale, isOrdinalVariant);
+                        // Only count this key if it's a plural form used by this locale
+                        if (localePluralCategories.includes(category)) {
+                            totalInNs++;
+                            const value = nestedObject.getNestedValue(translationsForNs, baseKey, keySeparator ?? '.');
+                            const isTranslated = !!value;
+                            if (isTranslated)
+                                translatedInNs++;
+                            keyDetails.push({ key: baseKey, isTranslated });
+                        }
+                    }
+                    else {
+                        // This is a base plural key without expanded variants
+                        // Expand it according to THIS locale's plural rules
+                        const localePluralCategories = getLocalePluralCategories(locale, isOrdinal || false);
+                        for (const category of localePluralCategories) {
+                            totalInNs++;
+                            const pluralKey = isOrdinal
+                                ? `${baseKey}${pluralSeparator}ordinal${pluralSeparator}${category}`
+                                : `${baseKey}${pluralSeparator}${category}`;
+                            const value = nestedObject.getNestedValue(translationsForNs, pluralKey, keySeparator ?? '.');
+                            const isTranslated = !!value;
+                            if (isTranslated)
+                                translatedInNs++;
+                            keyDetails.push({ key: pluralKey, isTranslated });
+                        }
+                    }
+                }
+                else {
+                    // It's a simple key
+                    totalInNs++;
+                    const value = nestedObject.getNestedValue(translationsForNs, baseKey, keySeparator ?? '.');
+                    const isTranslated = !!value;
+                    if (isTranslated)
+                        translatedInNs++;
+                    keyDetails.push({ key: baseKey, isTranslated });
+                }
+            }
+            namespaces.set(ns, { totalKeys: totalInNs, translatedKeys: translatedInNs, keyDetails });
+            totalTranslatedForLocale += translatedInNs;
+            totalKeysForLocale += totalInNs;
+        }
+        report.locales.set(locale, { totalKeys: totalKeysForLocale, totalTranslated: totalTranslatedForLocale, namespaces });
+    }
+    return report;
+}
+/**
+ * Main display router that calls the appropriate display function based on options.
+ *
+ * Routes to one of three display modes:
+ * - Detailed locale report: Shows per-key status for a specific locale
+ * - Namespace summary: Shows translation progress for all locales in a specific namespace
+ * - Overall summary: Shows high-level statistics across all locales and namespaces
+ *
+ * @param report - The generated status report data
+ * @param config - The i18next toolkit configuration object
+ * @param options - Display options determining which report type to show
+ */
+async function displayStatusReport(report, config, options) {
+    if (options.detail) {
+        await displayDetailedLocaleReport(report, config, options.detail, options.namespace);
+    }
+    else if (options.namespace) {
+        await displayNamespaceSummaryReport(report, config, options.namespace);
+    }
+    else {
+        await displayOverallSummaryReport(report, config);
+    }
+}
+/**
+ * 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
+ */
+async function displayDetailedLocaleReport(report, config, locale, namespaceFilter) {
+    if (locale === config.extract.primaryLanguage) {
+        console.log(chalk.yellow(`Locale "${locale}" is the primary language. All keys are considered present.`));
+        return;
+    }
+    if (!config.locales.includes(locale)) {
+        console.error(chalk.red(`Error: Locale "${locale}" is not defined in your configuration.`));
+        return;
+    }
+    const localeData = report.locales.get(locale);
+    if (!localeData) {
+        console.error(chalk.red(`Error: Locale "${locale}" is not a valid secondary language.`));
+        return;
+    }
+    console.log(chalk.bold(`\nKey Status for "${chalk.cyan(locale)}":`));
+    const totalKeysForLocale = localeData.totalKeys;
+    printProgressBar('Overall', localeData.totalTranslated, totalKeysForLocale);
+    const namespacesToDisplay = namespaceFilter ? [namespaceFilter] : Array.from(localeData.namespaces.keys()).sort();
+    for (const ns of namespacesToDisplay) {
+        const nsData = localeData.namespaces.get(ns);
+        if (!nsData)
+            continue;
+        console.log(chalk.cyan.bold(`\nNamespace: ${ns}`));
+        printProgressBar('Namespace Progress', nsData.translatedKeys, nsData.totalKeys);
+        nsData.keyDetails.forEach(({ key, isTranslated }) => {
+            const icon = isTranslated ? chalk.green('✓') : chalk.red('✗');
+            console.log(`  ${icon} ${key}`);
+        });
+    }
+    const missingCount = totalKeysForLocale - localeData.totalTranslated;
+    if (missingCount > 0) {
+        console.log(chalk.yellow.bold(`\nSummary: Found ${missingCount} missing translations for "${locale}".`));
+    }
+    else {
+        console.log(chalk.green.bold(`\nSummary: 🎉 All keys are translated for "${locale}".`));
+    }
+    await printLocizeFunnel();
+}
+/**
+ * Displays a summary report filtered by a single namespace.
+ *
+ * Shows translation progress for the specified namespace across all secondary locales,
+ * including percentage completion and translated/total key counts.
+ *
+ * @param report - The generated status report data
+ * @param config - The i18next toolkit configuration object
+ * @param namespace - The namespace to display summary for
+ */
+async function displayNamespaceSummaryReport(report, config, namespace) {
+    const nsData = report.keysByNs.get(namespace);
+    if (!nsData) {
+        console.error(chalk.red(`Error: Namespace "${namespace}" was not found in your source code.`));
+        return;
+    }
+    console.log(chalk.cyan.bold(`\nStatus for Namespace: "${namespace}"`));
+    console.log('------------------------');
+    for (const [locale, localeData] of report.locales.entries()) {
+        const nsLocaleData = localeData.namespaces.get(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)`);
+        }
+    }
+    await printLocizeFunnel();
+}
+/**
+ * Displays the default, high-level summary report for all locales.
+ *
+ * Shows:
+ * - Project overview (total keys, locales, primary language)
+ * - Translation progress for each secondary locale with progress bars
+ * - Promotional message for locize service
+ *
+ * @param report - The generated status report data
+ * @param config - The i18next toolkit configuration object
+ */
+async function displayOverallSummaryReport(report, config) {
+    const { primaryLanguage } = config.extract;
+    console.log(chalk.cyan.bold('\ni18next Project Status'));
+    console.log('------------------------');
+    console.log(`🔑 Keys Found:         ${chalk.bold(report.totalBaseKeys)}`);
+    console.log(`📚 Namespaces Found:   ${chalk.bold(report.keysByNs.size)}`);
+    console.log(`🌍 Locales:            ${chalk.bold(config.locales.join(', '))}`);
+    console.log(`✅ Primary Language:   ${chalk.bold(primaryLanguage)}`);
+    console.log('\nTranslation Progress:');
+    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)`);
+    }
+    await printLocizeFunnel();
+}
+/**
+ * Prints a formatted progress bar with label, percentage, and counts.
+ *
+ * @param label - The label to display before the progress bar
+ * @param current - The current count (translated keys)
+ * @param total - The total count (all keys)
+ */
+function printProgressBar(label, current, total) {
+    const percentage = total > 0 ? Math.round((current / total) * 100) : 100;
+    const bar = generateProgressBarText(percentage);
+    console.log(`${chalk.bold(label)}: ${bar} ${percentage}% (${current}/${total})`);
+}
+/**
+ * Generates a visual progress bar string based on percentage completion.
+ *
+ * Creates a 20-character progress bar using filled (■) and empty (□) squares,
+ * with the filled portion colored green.
+ *
+ * @param percentage - The completion percentage (0-100)
+ * @returns A formatted progress bar string with colors
+ */
+function generateProgressBarText(percentage) {
+    const totalBars = 20;
+    const filledBars = Math.floor((percentage / 100) * totalBars);
+    const emptyBars = totalBars - filledBars;
+    return `[${chalk.green(''.padStart(filledBars, '■'))}${''.padStart(emptyBars, '□')}]`;
+}
+async function printLocizeFunnel() {
+    if (!(await funnelMsgTracker.shouldShowFunnel('status')))
+        return;
+    console.log(chalk.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 ${chalk.cyan('npx i18next-cli locize-migrate')} to get started.`);
+    return funnelMsgTracker.recordFunnelShown('status');
+}
+
+exports.runStatus = runStatus;

package/dist/cjs/syncer.js

@@ -1 +1,120 @@
-"use strict";var e=require("chalk"),t=require("glob"),o=require("node:fs/promises"),n=require("node:path"),r=require("ora"),a=require("./utils/default-value.js"),l=require("./utils/file-utils.js"),i=require("./utils/funnel-msg-tracker.js"),s=require("./utils/nested-object.js");exports.runSyncer=async function(c){const u=r("Running i18next locale synchronizer...\n").start();try{const r=c.extract.primaryLanguage||c.locales[0]||"en",d=c.locales.filter(e=>e!==r),{output:f,keySeparator:y=".",outputFormat:g="json",indentation:h=2,defaultValue:p=""}=c.extract,w=[];let m=!1;const S=l.getOutputPath(f,r,"*"),j=await t.glob(S);if(0===j.length)return void u.warn(`No translation files found for primary language "${r}". Nothing to sync.`);for(const t of j){const r=n.basename(t).split(".")[0],i=await l.loadTranslationFile(t);if(!i){w.push(`  ${e.yellow("-")} Could not read primary file: ${t}`);continue}const u=s.getNestedKeys(i,y??".");for(const t of d){const d=l.getOutputPath(f,t,r),S=n.resolve(process.cwd(),d),j=await l.loadTranslationFile(S)||{},q={};for(const e of u){const o=s.getNestedValue(i,e,y??"."),n=s.getNestedValue(j,e,y??".")??a.resolveDefaultValue(p,e,r,t,o);s.setNestedValue(q,e,n,y??".")}const v=JSON.stringify(j);if(JSON.stringify(q)!==v){m=!0;const t=c.extract.outputFormat??(S.endsWith(".json5")?"json5":g),r="json5"===t?await l.loadRawJson5Content(S)??void 0:void 0,a=l.serializeTranslationFile(q,t,h,r);await o.mkdir(n.dirname(S),{recursive:!0}),await o.writeFile(S,a),w.push(`  ${e.green("✓")} Synchronized: ${d}`)}else w.push(`  ${e.gray("-")} Already in sync: ${d}`)}}u.succeed(e.bold("Synchronization complete!")),w.forEach(e=>console.log(e)),m?await async function(){if(!await i.shouldShowFunnel("syncer"))return;return console.log(e.green.bold("\n✅ Sync complete.")),console.log(e.yellow("🚀 Ready to collaborate with translators? Move your files to the cloud.")),console.log(`   Get started with the official TMS for i18next: ${e.cyan("npx i18next-cli locize-migrate")}`),i.recordFunnelShown("syncer")}():console.log(e.green.bold("\n✅ All locales are already in sync."))}catch(t){u.fail(e.red("Synchronization failed.")),console.error(t)}};
+'use strict';
+
+var chalk = require('chalk');
+var glob = require('glob');
+var promises = require('node:fs/promises');
+var node_path = require('node:path');
+var ora = require('ora');
+var defaultValue = require('./utils/default-value.js');
+var fileUtils = require('./utils/file-utils.js');
+var funnelMsgTracker = require('./utils/funnel-msg-tracker.js');
+var nestedObject = require('./utils/nested-object.js');
+
+/**
+ * Synchronizes translation files across different locales by ensuring all secondary
+ * language files contain the same keys as the primary language file.
+ *
+ * This function:
+ * 1. Reads the primary language translation file
+ * 2. Extracts all translation keys from the primary file
+ * 3. For each secondary language:
+ *    - Preserves existing translations
+ *    - Adds missing keys with empty values or configured default
+ *    - Removes keys that no longer exist in primary
+ * 4. Only writes files that have changes
+ *
+ * @param config - The i18next toolkit configuration object
+ *
+ * @example
+ * ```typescript
+ * // Configuration
+ * const config = {
+ *   locales: ['en', 'de', 'fr'],
+ *   extract: {
+ *     output: 'locales/{{language}}/{{namespace}}.json',
+ *     defaultNS: 'translation'
+ *     defaultValue: '[MISSING]'
+ *   }
+ * }
+ *
+ * await runSyncer(config)
+ * ```
+ */
+async function runSyncer(config) {
+    const spinner = ora('Running i18next locale synchronizer...\n').start();
+    try {
+        const primaryLanguage = config.extract.primaryLanguage || config.locales[0] || 'en';
+        const secondaryLanguages = config.locales.filter((l) => l !== primaryLanguage);
+        const { output, keySeparator = '.', outputFormat = 'json', indentation = 2, defaultValue: defaultValue$1 = '', } = config.extract;
+        const logMessages = [];
+        let wasAnythingSynced = false;
+        // 1. Find all namespace files for the primary language
+        const primaryNsPattern = fileUtils.getOutputPath(output, primaryLanguage, '*');
+        const primaryNsFiles = await glob.glob(primaryNsPattern);
+        if (primaryNsFiles.length === 0) {
+            spinner.warn(`No translation files found for primary language "${primaryLanguage}". Nothing to sync.`);
+            return;
+        }
+        // 2. Loop through each primary namespace file
+        for (const primaryPath of primaryNsFiles) {
+            const ns = node_path.basename(primaryPath).split('.')[0];
+            const primaryTranslations = await fileUtils.loadTranslationFile(primaryPath);
+            if (!primaryTranslations) {
+                logMessages.push(`  ${chalk.yellow('-')} Could not read primary file: ${primaryPath}`);
+                continue;
+            }
+            const primaryKeys = nestedObject.getNestedKeys(primaryTranslations, keySeparator ?? '.');
+            // 3. For each secondary language, sync the current namespace
+            for (const lang of secondaryLanguages) {
+                const secondaryPath = fileUtils.getOutputPath(output, lang, ns);
+                const fullSecondaryPath = node_path.resolve(process.cwd(), secondaryPath);
+                const existingSecondaryTranslations = await fileUtils.loadTranslationFile(fullSecondaryPath) || {};
+                const newSecondaryTranslations = {};
+                for (const key of primaryKeys) {
+                    const primaryValue = nestedObject.getNestedValue(primaryTranslations, key, keySeparator ?? '.');
+                    const existingValue = nestedObject.getNestedValue(existingSecondaryTranslations, key, keySeparator ?? '.');
+                    // Use the resolved default value if no existing value
+                    const valueToSet = existingValue ?? defaultValue.resolveDefaultValue(defaultValue$1, key, ns, lang, primaryValue);
+                    nestedObject.setNestedValue(newSecondaryTranslations, key, valueToSet, keySeparator ?? '.');
+                }
+                // Use JSON.stringify for a reliable object comparison, regardless of format
+                const oldContent = JSON.stringify(existingSecondaryTranslations);
+                const newContent = JSON.stringify(newSecondaryTranslations);
+                if (newContent !== oldContent) {
+                    wasAnythingSynced = true;
+                    const perFileFormat = config.extract.outputFormat ?? (fullSecondaryPath.endsWith('.json5') ? 'json5' : outputFormat);
+                    const raw = perFileFormat === 'json5' ? (await fileUtils.loadRawJson5Content(fullSecondaryPath)) ?? undefined : undefined;
+                    const serializedContent = fileUtils.serializeTranslationFile(newSecondaryTranslations, perFileFormat, indentation, raw);
+                    await promises.mkdir(node_path.dirname(fullSecondaryPath), { recursive: true });
+                    await promises.writeFile(fullSecondaryPath, serializedContent);
+                    logMessages.push(`  ${chalk.green('✓')} Synchronized: ${secondaryPath}`);
+                }
+                else {
+                    logMessages.push(`  ${chalk.gray('-')} Already in sync: ${secondaryPath}`);
+                }
+            }
+        }
+        spinner.succeed(chalk.bold('Synchronization complete!'));
+        logMessages.forEach(msg => console.log(msg));
+        if (wasAnythingSynced) {
+            await printLocizeFunnel();
+        }
+        else {
+            console.log(chalk.green.bold('\n✅ All locales are already in sync.'));
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Synchronization failed.'));
+        console.error(error);
+    }
+}
+async function printLocizeFunnel() {
+    if (!(await funnelMsgTracker.shouldShowFunnel('syncer')))
+        return;
+    console.log(chalk.green.bold('\n✅ Sync complete.'));
+    console.log(chalk.yellow('🚀 Ready to collaborate with translators? Move your files to the cloud.'));
+    console.log(`   Get started with the official TMS for i18next: ${chalk.cyan('npx i18next-cli locize-migrate')}`);
+    return funnelMsgTracker.recordFunnelShown('syncer');
+}
+
+exports.runSyncer = runSyncer;

package/dist/cjs/types-generator.js

@@ -1 +1,165 @@
-"use strict";var e=require("i18next-resources-for-ts"),t=require("glob"),s=require("ora"),r=require("chalk"),n=require("node:fs/promises"),o=require("node:path"),i=require("@swc/core"),a=require("./utils/file-utils.js"),c=require("node:vm");async function p(e){const t=o.extname(e);if([".ts",".mts",".cts",".js",".mjs",".cjs"].includes(t)){const t=await n.readFile(e,"utf-8"),{code:s}=await i.transform(t,{filename:e,jsc:{parser:{syntax:"typescript"},target:"es2018"},module:{type:"commonjs"}}),r={},o={exports:r},a=c.createContext({exports:r,module:o,require:e=>require(e),console:console,process:process});new c.Script(s,{filename:e}).runInContext(a);return a.module.exports?.default||a.module.exports}const s=await n.readFile(e,"utf-8");return JSON.parse(s)}exports.runTypesGenerator=async function(i){const c=s("Generating TypeScript types for translations...\n").start();try{i.extract.primaryLanguage||=i.locales[0]||"en";let s=i.extract.output||`locales/${i.extract.primaryLanguage}/*.json`;if(s=a.getOutputPath(s,i.extract.primaryLanguage||"en","*"),i.types||(i.types={input:s,output:"src/@types/i18next.d.ts"}),void 0===i.types.input&&(i.types.input=s),i.types.output||(i.types.output="src/@types/i18next.d.ts"),i.types.resourcesFile||(i.types.resourcesFile=o.join(o.dirname(i.types?.output),"resources.d.ts")),!i.types?.input||i.types?.input.length<0)return void console.log("No input defined!");const u=await t.glob(i.types?.input||[],{cwd:process.cwd()}),l=[];for(const e of u){const t=o.basename(e,o.extname(e)),s=await p(e);if(i.extract?.mergeNamespaces&&s&&"object"==typeof s){const t=Object.keys(s),n=t.filter(e=>s[e]&&"object"==typeof s[e]);if(n.length>0){for(const e of n)l.push({name:e,resources:s[e]});const o=t.filter(e=>!s[e]||"object"!=typeof s[e]);o.length>0&&console.warn(r.yellow(`Warning: The file ${e} contains top-level keys that are not objects (${o.join(", ")}). When 'mergeNamespaces' is enabled, top-level keys are treated as namespaces. These keys will be ignored.`));continue}}l.push({name:t,resources:s})}const d=[],y=i.types?.enableSelector||!1,f=i.types?.indentation??i.extract.indentation??2,m=`// This file is automatically generated by i18next-cli. Do not edit manually.\n${e.mergeResourcesAsInterface(l,{optimize:!!y,indentation:f})}`,g=o.resolve(process.cwd(),i.types?.output||""),w=o.resolve(process.cwd(),i.types.resourcesFile);let x;await n.mkdir(o.dirname(w),{recursive:!0}),await n.writeFile(w,m),d.push(`  ${r.green("✓")} Resources interface written to ${i.types.resourcesFile}`);try{await n.access(g),x=!0}catch(e){x=!1}if(!x){const e=o.relative(o.dirname(g),w).replace(/\\/g,"/").replace(/\.d\.ts$/,""),t=`// This file is automatically generated by i18next-cli, because it was not existing. You can edit it based on your needs: https://www.i18next.com/overview/typescript#custom-type-options\nimport Resources from './${e}';\n\ndeclare module 'i18next' {\n  interface CustomTypeOptions {\n    enableSelector: ${"string"==typeof y?`"${y}"`:y};\n    defaultNS: ${!1===i.extract.defaultNS?"false":`'${i.extract.defaultNS||"translation"}'`};\n    resources: Resources;\n  }\n}`;await n.mkdir(o.dirname(g),{recursive:!0}),await n.writeFile(g,t),d.push(`  ${r.green("✓")} TypeScript definitions written to ${i.types.output||""}`)}c.succeed(r.bold("TypeScript definitions generated successfully.")),d.forEach(e=>console.log(e))}catch(e){c.fail(r.red("Failed to generate TypeScript definitions.")),console.error(e)}};
+'use strict';
+
+var i18nextResourcesForTs = require('i18next-resources-for-ts');
+var glob = require('glob');
+var ora = require('ora');
+var chalk = require('chalk');
+var promises = require('node:fs/promises');
+var node_path = require('node:path');
+var core = require('@swc/core');
+var fileUtils = require('./utils/file-utils.js');
+var vm = require('node:vm');
+
+async function loadFile(file) {
+    const ext = node_path.extname(file);
+    if (['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'].includes(ext)) {
+        const content = await promises.readFile(file, 'utf-8');
+        const { code } = await core.transform(content, {
+            filename: file,
+            jsc: {
+                parser: {
+                    syntax: 'typescript',
+                },
+                target: 'es2018'
+            },
+            module: {
+                type: 'commonjs'
+            }
+        });
+        const exports = {};
+        const module = { exports };
+        const context = vm.createContext({
+            exports,
+            module,
+            require: (id) => require(id),
+            console,
+            process
+        });
+        const script = new vm.Script(code, { filename: file });
+        script.runInContext(context);
+        // @ts-ignore
+        const exported = context.module.exports?.default || context.module.exports;
+        return exported;
+    }
+    const content = await promises.readFile(file, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Generates TypeScript type definitions for i18next translations.
+ *
+ * This function:
+ * 1. Reads translation files based on the input glob patterns
+ * 2. Generates TypeScript interfaces using i18next-resources-for-ts
+ * 3. Creates separate resources.d.ts and main i18next.d.ts files
+ * 4. Handles namespace detection from filenames
+ * 5. Supports type-safe selector API when enabled
+ *
+ * @param config - The i18next toolkit configuration object
+ *
+ * @example
+ * ```typescript
+ * // Configuration
+ * const config = {
+ *   types: {
+ *     input: ['locales/en/*.json'],
+ *     output: 'src/types/i18next.d.ts',
+ *     enableSelector: true
+ *   }
+ * }
+ *
+ * await runTypesGenerator(config)
+ * ```
+ */
+async function runTypesGenerator(config) {
+    const spinner = ora('Generating TypeScript types for translations...\n').start();
+    try {
+        config.extract.primaryLanguage ||= config.locales[0] || 'en';
+        let defaultTypesInputPath = config.extract.output || `locales/${config.extract.primaryLanguage}/*.json`;
+        defaultTypesInputPath = fileUtils.getOutputPath(defaultTypesInputPath, config.extract.primaryLanguage || 'en', '*');
+        if (!config.types)
+            config.types = { input: defaultTypesInputPath, output: 'src/@types/i18next.d.ts' };
+        if (config.types.input === undefined)
+            config.types.input = defaultTypesInputPath;
+        if (!config.types.output)
+            config.types.output = 'src/@types/i18next.d.ts';
+        if (!config.types.resourcesFile)
+            config.types.resourcesFile = node_path.join(node_path.dirname(config.types?.output), 'resources.d.ts');
+        if (!config.types?.input || config.types?.input.length < 0) {
+            console.log('No input defined!');
+            return;
+        }
+        const resourceFiles = await glob.glob(config.types?.input || [], {
+            cwd: process.cwd(),
+        });
+        const resources = [];
+        for (const file of resourceFiles) {
+            const namespace = node_path.basename(file, node_path.extname(file));
+            const parsedContent = await loadFile(file);
+            // If mergeNamespaces is used, a single file can contain multiple namespaces
+            // (e.g. { "translation": { ... }, "common": { ... } } in a per-language file).
+            // In that case, expose each top-level key as a namespace entry so the type
+            // generator will produce top-level namespace interfaces (not a language wrapper).
+            if (config.extract?.mergeNamespaces && parsedContent && typeof parsedContent === 'object') {
+                const keys = Object.keys(parsedContent);
+                const objectKeys = keys.filter(k => parsedContent[k] && typeof parsedContent[k] === 'object');
+                // If we have at least one object and we are in mergeNamespaces mode, assume it's a merged file
+                if (objectKeys.length > 0) {
+                    for (const nsName of objectKeys) {
+                        resources.push({ name: nsName, resources: parsedContent[nsName] });
+                    }
+                    const nonObjectKeys = keys.filter(k => !parsedContent[k] || typeof parsedContent[k] !== 'object');
+                    if (nonObjectKeys.length > 0) {
+                        console.warn(chalk.yellow(`Warning: The file ${file} contains top-level keys that are not objects (${nonObjectKeys.join(', ')}). When 'mergeNamespaces' is enabled, top-level keys are treated as namespaces. These keys will be ignored.`));
+                    }
+                    continue;
+                }
+            }
+            resources.push({ name: namespace, resources: parsedContent });
+        }
+        const logMessages = [];
+        const enableSelector = config.types?.enableSelector || false;
+        const indentation = config.types?.indentation ?? config.extract.indentation ?? 2;
+        const interfaceDefinition = `// This file is automatically generated by i18next-cli. Do not edit manually.
+${i18nextResourcesForTs.mergeResourcesAsInterface(resources, { optimize: !!enableSelector, indentation })}`;
+        const outputPath = node_path.resolve(process.cwd(), config.types?.output || '');
+        const resourcesOutputPath = node_path.resolve(process.cwd(), config.types.resourcesFile);
+        await promises.mkdir(node_path.dirname(resourcesOutputPath), { recursive: true });
+        await promises.writeFile(resourcesOutputPath, interfaceDefinition);
+        logMessages.push(`  ${chalk.green('✓')} Resources interface written to ${config.types.resourcesFile}`);
+        let outputPathExists;
+        try {
+            await promises.access(outputPath);
+            outputPathExists = true;
+        }
+        catch (e) {
+            outputPathExists = false;
+        }
+        if (!outputPathExists) {
+            // The main output file will now import from the resources file
+            const importPath = node_path.relative(node_path.dirname(outputPath), resourcesOutputPath)
+                .replace(/\\/g, '/').replace(/\.d\.ts$/, ''); // Make it a valid module path
+            const defaultNS = config.extract.defaultNS === false ? 'false' : `'${config.extract.defaultNS || 'translation'}'`;
+            const fileContent = `// This file is automatically generated by i18next-cli, because it was not existing. You can edit it based on your needs: https://www.i18next.com/overview/typescript#custom-type-options
+import Resources from './${importPath}';
+
+declare module 'i18next' {
+  interface CustomTypeOptions {
+    enableSelector: ${typeof enableSelector === 'string' ? `"${enableSelector}"` : enableSelector};
+    defaultNS: ${defaultNS};
+    resources: Resources;
+  }
+}`;
+            await promises.mkdir(node_path.dirname(outputPath), { recursive: true });
+            await promises.writeFile(outputPath, fileContent);
+            logMessages.push(`  ${chalk.green('✓')} TypeScript definitions written to ${config.types.output || ''}`);
+        }
+        spinner.succeed(chalk.bold('TypeScript definitions generated successfully.'));
+        logMessages.forEach(msg => console.log(msg));
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to generate TypeScript definitions.'));
+        console.error(error);
+    }
+}
+
+exports.runTypesGenerator = runTypesGenerator;