i18next-cli 1.46.3 → 1.46.4

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.46.3'); // This string is replaced with the actual version at build time by rollup
+    .version('1.46.4'); // This string is replaced with the actual version at build time by rollup
 // new: global config override option
 program.option('-c, --config <path>', 'Path to i18next-cli config file (overrides detection)');
 program

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

@@ -57,7 +57,8 @@ async function runExtractor(config, options = {}) {
         spinner.text = `Found ${allKeys.size} unique keys. Updating translation files...`;
         const results = await translationManager.getTranslations(allKeys, objectKeys, config, {
             syncPrimaryWithDefaults: options.syncPrimaryWithDefaults,
-            syncAll: options.syncAll
+            syncAll: options.syncAll,
+            logger: options.logger
         });
         let anyFileUpdated = false;
         for (const result of results) {

package/dist/cjs/extractor/core/translation-manager.js

@@ -5,6 +5,7 @@ var glob = require('glob');
 var nestedObject = require('../../utils/nested-object.js');
 var fileUtils = require('../../utils/file-utils.js');
 var defaultValue = require('../../utils/default-value.js');
+var logger = require('../../utils/logger.js');
 
 // used for natural language check
 const chars = [' ', ',', '?', '!', ';'];
@@ -208,7 +209,7 @@ function sortObject(obj, config, customSort) {
  * A helper function to build a new translation object for a single namespace.
  * This centralizes the core logic of merging keys.
  */
-function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, namespace, preservePatterns = [], objectKeys = new Set(), syncPrimaryWithDefaults = false, syncAll = false) {
+function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, namespace, preservePatterns = [], objectKeys = new Set(), syncPrimaryWithDefaults = false, syncAll = false, logger$1 = new logger.ConsoleLogger()) {
     const { keySeparator = '.', sort = true, removeUnusedKeys = true, primaryLanguage, defaultValue: emptyDefaultValue = '', pluralSeparator = '_', contextSeparator = '_', preserveContextVariants = false, } = config.extract;
     const nsSep = typeof config.extract.nsSeparator === 'string' ? config.extract.nsSeparator : ':';
     // Keep the raw configured defaultValue so we can distinguish:
@@ -694,13 +695,13 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
         // that was already written by a different extracted key, e.g.:
         //   t("a.b")   => sets a.b = string
         //   t("a.b.c") => tries to descend into a.b which is already a string
-        // In that situation we skip the conflicting key and emit a console.error so
+        // In that situation we skip the conflicting key and emit a log error so
         // developers see the problem immediately — a skipped key becomes a missing
         // translation at runtime.
         if (separator && typeof separator === 'string') {
             const conflictingPath = findNestingConflict(newTranslations, key, separator);
             if (conflictingPath !== null) {
-                console.error(`[i18next-toolkit] Nesting conflict: key "${key}" conflicts with existing key "${conflictingPath}". ` +
+                logger$1.error(`Nesting conflict: key "${key}" conflicts with existing key "${conflictingPath}". ` +
                     `"${key}" will be skipped — fix the overlapping key paths in your source code to avoid missing translations at runtime.`);
                 continue;
             }
@@ -784,7 +785,7 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
  * // Results contain update status and new/existing translations for each locale.
  * ```
  */
-async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaults = false, syncAll = false } = {}) {
+async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaults = false, syncAll = false, logger: logger$1 = new logger.ConsoleLogger() } = {}) {
     config.extract.primaryLanguage ||= config.locales[0] || 'en';
     config.extract.secondaryLanguages ||= config.locales.filter((l) => l !== config?.extract?.primaryLanguage);
     const patternsToPreserve = [...(config.extract.preservePatterns || [])];
@@ -872,12 +873,12 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
                 const nsKeys = keysByNS.get(nsKey) || [];
                 if (nsKey === NO_NS_TOKEN) {
                     // keys without namespace -> merged into top-level of the merged file
-                    const built = buildNewTranslationsForNs(nsKeys, existingMergedFile, config, locale, undefined, preservePatterns, objectKeys, syncPrimaryWithDefaults);
+                    const built = buildNewTranslationsForNs(nsKeys, existingMergedFile, config, locale, undefined, preservePatterns, objectKeys, syncPrimaryWithDefaults, undefined, logger$1);
                     Object.assign(newMergedTranslations, built);
                 }
                 else {
                     const existingTranslations = existingMergedFile[nsKey] || {};
-                    newMergedTranslations[nsKey] = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, nsKey, preservePatterns, objectKeys, syncPrimaryWithDefaults);
+                    newMergedTranslations[nsKey] = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, nsKey, preservePatterns, objectKeys, syncPrimaryWithDefaults, undefined, logger$1);
                 }
             }
             // Preserve ignored namespaces as-is from the existing merged file
@@ -915,7 +916,7 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
                 const outputPath = fileUtils.getOutputPath(config.extract.output, locale, ns);
                 const fullPath = node_path.resolve(process.cwd(), outputPath);
                 const existingTranslations = await fileUtils.loadTranslationFile(fullPath) || {};
-                const newTranslations = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, ns, preservePatterns, objectKeys, syncPrimaryWithDefaults, syncAll);
+                const newTranslations = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, ns, preservePatterns, objectKeys, syncPrimaryWithDefaults, syncAll, logger$1);
                 const oldContent = JSON.stringify(existingTranslations, null, indentation);
                 const newContent = JSON.stringify(newTranslations, null, indentation);
                 // Push one result per namespace file

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.46.3'); // This string is replaced with the actual version at build time by rollup
+    .version('1.46.4'); // This string is replaced with the actual version at build time by rollup
 // new: global config override option
 program.option('-c, --config <path>', 'Path to i18next-cli config file (overrides detection)');
 program

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

@@ -55,7 +55,8 @@ async function runExtractor(config, options = {}) {
         spinner.text = `Found ${allKeys.size} unique keys. Updating translation files...`;
         const results = await getTranslations(allKeys, objectKeys, config, {
             syncPrimaryWithDefaults: options.syncPrimaryWithDefaults,
-            syncAll: options.syncAll
+            syncAll: options.syncAll,
+            logger: options.logger
         });
         let anyFileUpdated = false;
         for (const result of results) {

package/dist/esm/extractor/core/translation-manager.js

@@ -3,6 +3,7 @@ import { glob } from 'glob';
 import { getNestedKeys, getNestedValue, setNestedValue } from '../../utils/nested-object.js';
 import { getOutputPath, loadTranslationFile } from '../../utils/file-utils.js';
 import { resolveDefaultValue } from '../../utils/default-value.js';
+import { ConsoleLogger } from '../../utils/logger.js';
 
 // used for natural language check
 const chars = [' ', ',', '?', '!', ';'];
@@ -206,7 +207,7 @@ function sortObject(obj, config, customSort) {
  * A helper function to build a new translation object for a single namespace.
  * This centralizes the core logic of merging keys.
  */
-function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, namespace, preservePatterns = [], objectKeys = new Set(), syncPrimaryWithDefaults = false, syncAll = false) {
+function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, namespace, preservePatterns = [], objectKeys = new Set(), syncPrimaryWithDefaults = false, syncAll = false, logger = new ConsoleLogger()) {
     const { keySeparator = '.', sort = true, removeUnusedKeys = true, primaryLanguage, defaultValue: emptyDefaultValue = '', pluralSeparator = '_', contextSeparator = '_', preserveContextVariants = false, } = config.extract;
     const nsSep = typeof config.extract.nsSeparator === 'string' ? config.extract.nsSeparator : ':';
     // Keep the raw configured defaultValue so we can distinguish:
@@ -692,13 +693,13 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
         // that was already written by a different extracted key, e.g.:
         //   t("a.b")   => sets a.b = string
         //   t("a.b.c") => tries to descend into a.b which is already a string
-        // In that situation we skip the conflicting key and emit a console.error so
+        // In that situation we skip the conflicting key and emit a log error so
         // developers see the problem immediately — a skipped key becomes a missing
         // translation at runtime.
         if (separator && typeof separator === 'string') {
             const conflictingPath = findNestingConflict(newTranslations, key, separator);
             if (conflictingPath !== null) {
-                console.error(`[i18next-toolkit] Nesting conflict: key "${key}" conflicts with existing key "${conflictingPath}". ` +
+                logger.error(`Nesting conflict: key "${key}" conflicts with existing key "${conflictingPath}". ` +
                     `"${key}" will be skipped — fix the overlapping key paths in your source code to avoid missing translations at runtime.`);
                 continue;
             }
@@ -782,7 +783,7 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
  * // Results contain update status and new/existing translations for each locale.
  * ```
  */
-async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaults = false, syncAll = false } = {}) {
+async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaults = false, syncAll = false, logger = new ConsoleLogger() } = {}) {
     config.extract.primaryLanguage ||= config.locales[0] || 'en';
     config.extract.secondaryLanguages ||= config.locales.filter((l) => l !== config?.extract?.primaryLanguage);
     const patternsToPreserve = [...(config.extract.preservePatterns || [])];
@@ -870,12 +871,12 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
                 const nsKeys = keysByNS.get(nsKey) || [];
                 if (nsKey === NO_NS_TOKEN) {
                     // keys without namespace -> merged into top-level of the merged file
-                    const built = buildNewTranslationsForNs(nsKeys, existingMergedFile, config, locale, undefined, preservePatterns, objectKeys, syncPrimaryWithDefaults);
+                    const built = buildNewTranslationsForNs(nsKeys, existingMergedFile, config, locale, undefined, preservePatterns, objectKeys, syncPrimaryWithDefaults, undefined, logger);
                     Object.assign(newMergedTranslations, built);
                 }
                 else {
                     const existingTranslations = existingMergedFile[nsKey] || {};
-                    newMergedTranslations[nsKey] = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, nsKey, preservePatterns, objectKeys, syncPrimaryWithDefaults);
+                    newMergedTranslations[nsKey] = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, nsKey, preservePatterns, objectKeys, syncPrimaryWithDefaults, undefined, logger);
                 }
             }
             // Preserve ignored namespaces as-is from the existing merged file
@@ -913,7 +914,7 @@ async function getTranslations(keys, objectKeys, config, { syncPrimaryWithDefaul
                 const outputPath = getOutputPath(config.extract.output, locale, ns);
                 const fullPath = resolve(process.cwd(), outputPath);
                 const existingTranslations = await loadTranslationFile(fullPath) || {};
-                const newTranslations = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, ns, preservePatterns, objectKeys, syncPrimaryWithDefaults, syncAll);
+                const newTranslations = buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale, ns, preservePatterns, objectKeys, syncPrimaryWithDefaults, syncAll, logger);
                 const oldContent = JSON.stringify(existingTranslations, null, indentation);
                 const newContent = JSON.stringify(newTranslations, null, indentation);
                 // Push one result per namespace file

package/package.json

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

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,MAAM,aAAa,CAAA;AAMtF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK5C;;;;;;;;;;;;;;;;;;;;;;;;;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,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAsE1D;AAED;;;;;;;;;;;;;;;;;;;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,CA8Gf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,OAAO,CAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,uBAA+B,EAAE,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,sDAO3I"}
+{"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,MAAM,aAAa,CAAA;AAMtF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK5C;;;;;;;;;;;;;;;;;;;;;;;;;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,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAuE1D;AAED;;;;;;;;;;;;;;;;;;;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,CA8Gf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,OAAO,CAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,uBAA+B,EAAE,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,sDAO3I"}

package/types/extractor/core/translation-manager.d.ts

@@ -1,4 +1,4 @@
-import { TranslationResult, ExtractedKey, I18nextToolkitConfig } from '../../types';
+import { TranslationResult, ExtractedKey, I18nextToolkitConfig, Logger } from '../../types';
 /**
  * Processes extracted translation keys and generates translation files for all configured locales.
  *
@@ -28,8 +28,9 @@ import { TranslationResult, ExtractedKey, I18nextToolkitConfig } from '../../typ
  * // Results contain update status and new/existing translations for each locale.
  * ```
  */
-export declare function getTranslations(keys: Map<string, ExtractedKey>, objectKeys: Set<string>, config: I18nextToolkitConfig, { syncPrimaryWithDefaults, syncAll }?: {
+export declare function getTranslations(keys: Map<string, ExtractedKey>, objectKeys: Set<string>, config: I18nextToolkitConfig, { syncPrimaryWithDefaults, syncAll, logger }?: {
     syncPrimaryWithDefaults?: boolean;
     syncAll?: boolean;
+    logger?: Logger;
 }): Promise<TranslationResult[]>;
 //# sourceMappingURL=translation-manager.d.ts.map

package/types/extractor/core/translation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translation-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/translation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AA82BnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,MAAM,EAAE,oBAAoB,EAC5B,EACE,uBAA+B,EAC/B,OAAe,EAChB,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;CACb,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA8J9B"}
+{"version":3,"file":"translation-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/translation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAg3B3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,MAAM,EAAE,oBAAoB,EAC5B,EACE,uBAA+B,EAC/B,OAAe,EACf,MAA4B,EAC7B,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA8J9B"}