i18next-cli 1.45.0 → 1.46.1

package/README.md

@@ -7,6 +7,10 @@ A unified, high-performance i18next CLI toolchain, powered by SWC.
 
 ---
 
+
+> By default, `i18next-cli` only extracts translation keys from JavaScript and TypeScript files (`.js`, `.jsx`, `.ts`, `.tsx`).
+> To extract from other file types (such as `.pug`, `.vue`, `.svelte`, etc.), you must use or create a plugin. Specifying additional file extensions in the `extract.input` config is not sufficient on its own—plugins are required for non-JS/TS formats. See the [Plugin System](#plugin-system) section for details and examples.
+
 `i18next-cli` is a complete reimagining of the static analysis toolchain for the i18next ecosystem. It consolidates key extraction, type safety generation, locale syncing, linting, and cloud integrations into a single, cohesive, and blazing-fast CLI.
 
 > ### 🚀 Try it Now - Zero Config!
@@ -80,6 +84,7 @@ Get an overview of your project's localization health:
 npx i18next-cli status
 ```
 
+
 ### 3. Extract Translation Keys
 
 ```bash
@@ -336,6 +341,7 @@ The configuration file supports both TypeScript (`.ts`) and JavaScript (`.js`) f
 
 > **💡 No Installation Required?** If you don't want to install `i18next-cli` as a dependency, you can skip the `defineConfig` helper and return a plain JavaScript object or JSON instead. The `defineConfig` function is purely for TypeScript support and doesn't affect functionality.
 
+
 ### Basic Configuration
 
 ```typescript
@@ -351,6 +357,9 @@ export default defineConfig({
 });
 ```
 
+> **❗ Important:**
+> Only `.js`, `.jsx`, `.ts`, and `.tsx` files are extracted by default. If you want to extract from other file types (e.g., `.pug`, `.vue`), you must use or create a plugin. See the [Plugin System](#plugin-system) section for more information.
+
 **Alternative without local installation:**
 
 ```javascript

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.45.0'); // This string is replaced with the actual version at build time by rollup
+    .version('1.46.1'); // 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/parsers/jsx-parser.js

@@ -135,7 +135,13 @@ function extractFromTransComponent(node, config) {
         valuesAttr.value.expression.type === 'ObjectExpression') {
         valuesCountProperty = astUtils.getObjectPropValueExpression(valuesAttr.value.expression, 'count');
     }
-    const hasCount = !!countAttr || !!valuesCountProperty;
+    // Mirror react-i18next v16.4.0: infer count from inline {{ count }} children
+    // when no explicit `count` prop or `values={{ count }}` is present.
+    // The runtime check is `typeof valuesFromChildren.count === 'number'`; at
+    // extraction time we can only inspect the AST shape, so we look for any
+    // ObjectExpression interpolation that declares a `count` key.
+    const hasInlineCount = !countAttr && !valuesCountProperty && childrenHaveInlineCount(node.children);
+    const hasCount = !!countAttr || !!valuesCountProperty || hasInlineCount;
     const tOptionsAttr = node.opening.attributes?.find((attr) => attr.type === 'JSXAttribute' &&
         attr.name.type === 'Identifier' &&
         attr.name.value === 'tOptions');
@@ -385,6 +391,74 @@ function swcChildToReactNode(node) {
 function swcChildrenToReactNodes(children) {
     return children.map(swcChildToReactNode).filter(n => n !== null);
 }
+/**
+ * Unwraps TypeScript type-assertion and parenthesis wrappers from a JSX
+ * expression so callers can inspect the underlying node type.
+ *
+ * Handles:
+ *   `{{ count } as any}`          → TsAsExpression wrapping ObjectExpression
+ *   `{{ count } as TransInterpolation}` → same
+ *   `({{ count }})`               → ParenthesisExpression wrapping ObjectExpression
+ */
+function unwrapJSXExpression(expr) {
+    if (expr.type === 'TsAsExpression' || expr.type === 'TsSatisfiesExpression') {
+        return unwrapJSXExpression(expr.expression);
+    }
+    if (expr.type === 'ParenthesisExpression') {
+        return unwrapJSXExpression(expr.expression);
+    }
+    return expr;
+}
+/**
+ * Recursively walks JSX children to determine whether any interpolation
+ * object contains a `count` property — mirroring the runtime behaviour of
+ * react-i18next v16.4.0's `getValuesFromChildren`.
+ *
+ * This lets the extractor infer `hasCount = true` when a `{{ count }}`
+ * (or `{{ count: expr }}`) interpolation is present in children without an
+ * explicit `count` prop on the `<Trans>` component.
+ *
+ * Matches:
+ *   `{{ count }}`               — shorthand Identifier  (prop.type === 'Identifier')
+ *   `{{ count: someExpr }}`     — KeyValueProperty with Identifier key
+ *   `{{ count } as any}`        — TsAsExpression-wrapped ObjectExpression
+ *   Deeply nested in child JSX elements (e.g. `<strong>{{ count }}</strong>`)
+ *
+ * @param children - The JSX children array to search
+ * @returns `true` when a `count` interpolation is found anywhere in the tree
+ */
+function childrenHaveInlineCount(children) {
+    for (const child of children) {
+        if (child.type === 'JSXExpressionContainer') {
+            const inner = unwrapJSXExpression(child.expression);
+            if (inner.type === 'ObjectExpression') {
+                const hasCount = inner.properties.some(prop => {
+                    if (prop.type === 'KeyValueProperty') {
+                        // { count: expr }
+                        return ((prop.key.type === 'Identifier' || prop.key.type === 'StringLiteral') &&
+                            prop.key.value === 'count');
+                    }
+                    if (prop.type === 'Identifier') {
+                        // shorthand { count }
+                        return prop.value === 'count';
+                    }
+                    return false;
+                });
+                if (hasCount)
+                    return true;
+            }
+        }
+        else if (child.type === 'JSXElement') {
+            if (childrenHaveInlineCount(child.children))
+                return true;
+        }
+        else if (child.type === 'JSXFragment') {
+            if (childrenHaveInlineCount(child.children))
+                return true;
+        }
+    }
+    return false;
+}
 function serializeJSXChildren(children, config) {
     const i18nextOptions = { ...reactI18next.getDefaults() };
     if (config.extract.transKeepBasicHtmlNodesFor) {

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.45.0'); // This string is replaced with the actual version at build time by rollup
+    .version('1.46.1'); // 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/parsers/jsx-parser.js

@@ -133,7 +133,13 @@ function extractFromTransComponent(node, config) {
         valuesAttr.value.expression.type === 'ObjectExpression') {
         valuesCountProperty = getObjectPropValueExpression(valuesAttr.value.expression, 'count');
     }
-    const hasCount = !!countAttr || !!valuesCountProperty;
+    // Mirror react-i18next v16.4.0: infer count from inline {{ count }} children
+    // when no explicit `count` prop or `values={{ count }}` is present.
+    // The runtime check is `typeof valuesFromChildren.count === 'number'`; at
+    // extraction time we can only inspect the AST shape, so we look for any
+    // ObjectExpression interpolation that declares a `count` key.
+    const hasInlineCount = !countAttr && !valuesCountProperty && childrenHaveInlineCount(node.children);
+    const hasCount = !!countAttr || !!valuesCountProperty || hasInlineCount;
     const tOptionsAttr = node.opening.attributes?.find((attr) => attr.type === 'JSXAttribute' &&
         attr.name.type === 'Identifier' &&
         attr.name.value === 'tOptions');
@@ -383,6 +389,74 @@ function swcChildToReactNode(node) {
 function swcChildrenToReactNodes(children) {
     return children.map(swcChildToReactNode).filter(n => n !== null);
 }
+/**
+ * Unwraps TypeScript type-assertion and parenthesis wrappers from a JSX
+ * expression so callers can inspect the underlying node type.
+ *
+ * Handles:
+ *   `{{ count } as any}`          → TsAsExpression wrapping ObjectExpression
+ *   `{{ count } as TransInterpolation}` → same
+ *   `({{ count }})`               → ParenthesisExpression wrapping ObjectExpression
+ */
+function unwrapJSXExpression(expr) {
+    if (expr.type === 'TsAsExpression' || expr.type === 'TsSatisfiesExpression') {
+        return unwrapJSXExpression(expr.expression);
+    }
+    if (expr.type === 'ParenthesisExpression') {
+        return unwrapJSXExpression(expr.expression);
+    }
+    return expr;
+}
+/**
+ * Recursively walks JSX children to determine whether any interpolation
+ * object contains a `count` property — mirroring the runtime behaviour of
+ * react-i18next v16.4.0's `getValuesFromChildren`.
+ *
+ * This lets the extractor infer `hasCount = true` when a `{{ count }}`
+ * (or `{{ count: expr }}`) interpolation is present in children without an
+ * explicit `count` prop on the `<Trans>` component.
+ *
+ * Matches:
+ *   `{{ count }}`               — shorthand Identifier  (prop.type === 'Identifier')
+ *   `{{ count: someExpr }}`     — KeyValueProperty with Identifier key
+ *   `{{ count } as any}`        — TsAsExpression-wrapped ObjectExpression
+ *   Deeply nested in child JSX elements (e.g. `<strong>{{ count }}</strong>`)
+ *
+ * @param children - The JSX children array to search
+ * @returns `true` when a `count` interpolation is found anywhere in the tree
+ */
+function childrenHaveInlineCount(children) {
+    for (const child of children) {
+        if (child.type === 'JSXExpressionContainer') {
+            const inner = unwrapJSXExpression(child.expression);
+            if (inner.type === 'ObjectExpression') {
+                const hasCount = inner.properties.some(prop => {
+                    if (prop.type === 'KeyValueProperty') {
+                        // { count: expr }
+                        return ((prop.key.type === 'Identifier' || prop.key.type === 'StringLiteral') &&
+                            prop.key.value === 'count');
+                    }
+                    if (prop.type === 'Identifier') {
+                        // shorthand { count }
+                        return prop.value === 'count';
+                    }
+                    return false;
+                });
+                if (hasCount)
+                    return true;
+            }
+        }
+        else if (child.type === 'JSXElement') {
+            if (childrenHaveInlineCount(child.children))
+                return true;
+        }
+        else if (child.type === 'JSXFragment') {
+            if (childrenHaveInlineCount(child.children))
+                return true;
+        }
+    }
+    return false;
+}
 function serializeJSXChildren(children, config) {
     const i18nextOptions = { ...getDefaults() };
     if (config.extract.transKeepBasicHtmlNodesFor) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.45.0",
+  "version": "1.46.1",
   "description": "A unified, high-performance i18next CLI.",
   "type": "module",
   "bin": {
@@ -55,7 +55,7 @@
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-terser": "0.4.4",
     "@types/inquirer": "9.0.9",
-    "@types/node": "25.3.0",
+    "@types/node": "25.3.2",
     "@types/react": "19.2.14",
     "@vitest/coverage-v8": "4.0.18",
     "eslint": "9.39.2",
@@ -69,17 +69,17 @@
   },
   "dependencies": {
     "@croct/json5-parser": "0.2.2",
-    "@swc/core": "1.15.11",
+    "@swc/core": "1.15.17",
     "yaml": "2.8.2",
     "chokidar": "5.0.0",
     "commander": "14.0.3",
     "execa": "9.6.1",
     "glob": "13.0.6",
     "i18next-resources-for-ts": "2.0.0",
-    "inquirer": "13.2.5",
+    "inquirer": "13.3.0",
     "jiti": "2.6.1",
     "jsonc-parser": "3.3.1",
-    "minimatch": "10.2.2",
+    "minimatch": "10.2.4",
     "ora": "9.3.0",
     "react": "^19.2.4",
     "react-i18next": "^16.5.4"

package/types/extractor/parsers/jsx-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsx-parser.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/jsx-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAsC,UAAU,EAAkD,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC7J,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAsEvD,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,aAAa,CAAC,EAAE,UAAU,CAAC;IAE3B,qDAAqD;IACrD,kBAAkB,EAAE,MAAM,CAAC;IAE3B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAE/B,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAE/B,kHAAkH;IAClH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,yBAAyB,CAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,GAAG,IAAI,CA2LxH"}
+{"version":3,"file":"jsx-parser.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/jsx-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAsC,UAAU,EAAkD,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC7J,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAsEvD,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,aAAa,CAAC,EAAE,UAAU,CAAC;IAE3B,qDAAqD;IACrD,kBAAkB,EAAE,MAAM,CAAC;IAE3B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAE/B,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAE/B,kHAAkH;IAClH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,yBAAyB,CAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,GAAG,IAAI,CAkMxH"}