i18next-cli 1.46.4 → 1.47.0

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

@@ -336,7 +336,7 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
         return false;
     };
     // Filter nsKeys to only include keys relevant to this language
-    const filteredKeys = nsKeys.filter(({ key, hasCount, isOrdinal }) => {
+    const filteredKeys = nsKeys.filter(({ key, hasCount, isOrdinal, explicitDefault }) => {
         // FIRST: Check if key matches preservePatterns and should be excluded
         if (shouldFilterKey(key)) {
             return false;
@@ -362,14 +362,21 @@ function buildNewTranslationsForNs(nsKeys, existingTranslations, config, locale,
                 return true;
             // Otherwise fall through and check the explicit suffix as before.
         }
+        // i18next supports a special _zero form that is NOT part of CLDR plural
+        // rules. When the key was explicitly extracted (e.g. from a t() call with
+        // `defaultValue_zero`), always include it regardless of the target
+        // language's Intl.PluralRules categories.
+        // See: https://www.i18next.com/translation-function/plurals#special-zero
+        const lastPart = keyParts[keyParts.length - 1];
+        if (lastPart === 'zero' && explicitDefault) {
+            return true;
+        }
         if (isOrdinal && keyParts.includes('ordinal')) {
             // For ordinal plurals: key_context_ordinal_category or key_ordinal_category
-            const lastPart = keyParts[keyParts.length - 1];
             return targetLanguagePluralCategories.has(`ordinal_${lastPart}`);
         }
         else if (hasCount) {
             // For cardinal plurals: key_context_category or key_category
-            const lastPart = keyParts[keyParts.length - 1];
             return targetLanguagePluralCategories.has(lastPart);
         }
         return true;

package/dist/esm/extractor/parsers/call-expression-handler.js

@@ -703,8 +703,16 @@ class CallExpressionHandler {
                     categories.forEach(cat => allPluralCategories.add(cat));
                 }
             }
-            const pluralCategories = Array.from(allPluralCategories).sort();
             const pluralSeparator = this.config.extract.pluralSeparator ?? '_';
+            // i18next supports a special _zero form (not part of CLDR plural rules).
+            // When defaultValue_zero is present in the options, include 'zero' in the
+            // categories so that key_zero is generated with the correct default value.
+            // See: https://www.i18next.com/translation-function/plurals#special-zero
+            const zeroDefault = getObjectPropValue(options, `defaultValue${pluralSeparator}zero`);
+            if (typeof zeroDefault === 'string' && !allPluralCategories.has('zero')) {
+                allPluralCategories.add('zero');
+            }
+            const pluralCategories = Array.from(allPluralCategories).sort();
             // Get all possible default values once at the start
             const defaultValue = getObjectPropValue(options, 'defaultValue');
             const otherDefault = getObjectPropValue(options, `defaultValue${pluralSeparator}other`);

package/dist/esm/extractor/parsers/jsx-handler.js

@@ -364,8 +364,17 @@ class JSXHandler {
                     categories.forEach(cat => allPluralCategories.add(cat));
                 }
             }
-            const pluralCategories = Array.from(allPluralCategories).sort();
             const pluralSeparator = this.config.extract.pluralSeparator ?? '_';
+            // i18next supports a special _zero form (not part of CLDR plural rules).
+            // When defaultValue_zero is present in tOptions, include 'zero' in the
+            // categories so that key_zero is generated with the correct default value.
+            if (optionsNode) {
+                const zeroDefault = getObjectPropValue(optionsNode, `defaultValue${pluralSeparator}zero`);
+                if (typeof zeroDefault === 'string' && !allPluralCategories.has('zero')) {
+                    allPluralCategories.add('zero');
+                }
+            }
+            const pluralCategories = Array.from(allPluralCategories).sort();
             // Get plural-specific default values from tOptions if available
             let otherDefault;
             let ordinalOtherDefault;

package/dist/esm/index.js

@@ -8,3 +8,6 @@ export { runSyncer } from './syncer.js';
 export { runStatus } from './status.js';
 export { runTypesGenerator } from './types-generator.js';
 export { runRenameKey } from './rename-key.js';
+export { runInstrumenter, writeExtractedKeys } from './instrumenter/core/instrumenter.js';
+import './utils/jsx-attributes.js';
+import 'magic-string';

package/dist/esm/init.js

@@ -30,6 +30,39 @@ async function isEsmProject() {
         return true; // Default to ESM if package.json is not found or readable
     }
 }
+/**
+ * Checks whether i18next-cli is listed as a local dependency of the current project.
+ * When running via `npx` without a local install, `defineConfig` would not be available
+ * at runtime, so the generated config should fall back to a plain object export.
+ *
+ * @returns Promise resolving to true if i18next-cli is in dependencies or devDependencies
+ */
+async function isCliLocallyInstalled() {
+    try {
+        const packageJsonPath = resolve(process.cwd(), 'package.json');
+        const content = await readFile(packageJsonPath, 'utf-8');
+        const packageJson = JSON.parse(content);
+        const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+        return !!deps['i18next-cli'];
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Checks whether the project uses TypeScript by looking for a tsconfig.json.
+ *
+ * @returns Promise resolving to true if tsconfig.json exists in the project root
+ */
+async function isTypeScriptProject() {
+    try {
+        await readFile(resolve(process.cwd(), 'tsconfig.json'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Interactive setup wizard for creating a new i18next-cli configuration file.
  *
@@ -74,12 +107,17 @@ async function runInit() {
     if (detectedConfig && typeof detectedConfig.extract?.output === 'function') {
         delete detectedConfig.extract.output;
     }
+    // Detect whether the project uses TypeScript to set the preferred default
+    const projectUsesTs = await isTypeScriptProject();
+    const tsChoice = 'TypeScript (i18next.config.ts)';
+    const jsChoice = 'JavaScript (i18next.config.js)';
+    const fileTypeChoices = projectUsesTs ? [tsChoice, jsChoice] : [jsChoice, tsChoice];
     const answers = await inquirer.prompt([
         {
             type: 'select',
             name: 'fileType',
             message: 'What kind of configuration file do you want?',
-            choices: ['TypeScript (i18next.config.ts)', 'JavaScript (i18next.config.js)'],
+            choices: fileTypeChoices,
         },
         {
             type: 'input',
@@ -146,23 +184,41 @@ async function runInit() {
         // Fallback
         return JSON.stringify(value);
     }
+    const isLocallyInstalled = await isCliLocallyInstalled();
     let fileContent = '';
-    if (isTypeScript) {
-        fileContent = `import { defineConfig } from 'i18next-cli';
+    if (isLocallyInstalled) {
+        // i18next-cli is a local dependency — use defineConfig for type-safety
+        if (isTypeScript) {
+            fileContent = `import { defineConfig } from 'i18next-cli'
 
-export default defineConfig(${toJs(configObject)});`;
-    }
-    else if (isEsm) {
-        fileContent = `import { defineConfig } from 'i18next-cli';
+export default defineConfig(${toJs(configObject)})`;
+        }
+        else if (isEsm) {
+            fileContent = `import { defineConfig } from 'i18next-cli'
 
 /** @type {import('i18next-cli').I18nextToolkitConfig} */
-export default defineConfig(${toJs(configObject)});`;
-    }
-    else { // CJS
-        fileContent = `const { defineConfig } = require('i18next-cli');
+export default defineConfig(${toJs(configObject)})`;
+        }
+        else { // CJS
+            fileContent = `const { defineConfig } = require('i18next-cli')
 
 /** @type {import('i18next-cli').I18nextToolkitConfig} */
-module.exports = defineConfig(${toJs(configObject)});`;
+module.exports = defineConfig(${toJs(configObject)})`;
+        }
+    }
+    else {
+        // i18next-cli is not locally installed (e.g. npx) — plain config object
+        if (isTypeScript) {
+            fileContent = `export default ${toJs(configObject)}`;
+        }
+        else if (isEsm) {
+            fileContent = `/** @type {import('i18next-cli').I18nextToolkitConfig} */
+export default ${toJs(configObject)}`;
+        }
+        else { // CJS
+            fileContent = `/** @type {import('i18next-cli').I18nextToolkitConfig} */
+module.exports = ${toJs(configObject)}`;
+        }
     }
     const outputPath = resolve(process.cwd(), fileName);
     await writeFile(outputPath, fileContent.trim());