i18next-cli 1.66.0 → 1.66.2

package/README.md

@@ -1433,6 +1433,43 @@ button:
 
 > **💡 Note:** Both `.yaml` and `.yml` extensions are supported and preserved. The `outputFormat: 'yaml'` option is optional when using these extensions - the format is automatically inferred from the file extension.
 
+### Code-Splitting Translations (one namespace per route)
+
+A common concern with runtime i18n is "you ship every language and every namespace to the client". You don't have to: the i18next runtime loads translations **per namespace, per language**, so namespace granularity is your code-splitting boundary. The runtime core itself is ~13.5 kB gzipped; what grows with your app is translation payload, and that is entirely controlled by how you slice namespaces.
+
+The recipe:
+
+1. **One namespace per route/feature** — scope keys via `useTranslation('checkout')`, `t('checkout:title')`, or the `ns` option. The extractor detects the namespace from your code and writes one file per namespace and language:
+
+```typescript
+export default defineConfig({
+  locales: ['en', 'de'],
+  extract: {
+    input: 'src/**/*.{ts,tsx}',
+    output: 'src/locales/{{language}}/{{namespace}}.json',
+  }
+});
+```
+
+2. **Lazy-load namespaces with dynamic imports** — each namespace + language pair becomes its own chunk that the bundler code-splits automatically:
+
+```javascript
+import i18next from 'i18next';
+import resourcesToBackend from 'i18next-resources-to-backend';
+
+i18next
+  .use(resourcesToBackend((lng, ns) => import(`./locales/${lng}/${ns}.json`)))
+  .init({
+    fallbackLng: 'en',
+    defaultNS: 'app',
+    ns: ['app'], // only the app-shell namespace loads upfront
+  });
+```
+
+3. **Load on demand** — `useTranslation('checkout')` (react-i18next) or `i18next.loadNamespaces('checkout')` fetches exactly that chunk when the route renders. The initial payload contains only the namespaces the entry route uses, in the active language; other languages transfer nothing until switched to.
+
+Prefer not to bundle translations at all? Serve the same per-namespace files from any static host/CDN via [`i18next-http-backend`](https://github.com/i18next/i18next-http-backend), or directly from the Locize CDN via [`i18next-locize-backend`](https://github.com/locize/i18next-locize-backend) — same wire profile, plus translation updates without redeploying.
+
 ### Merging Namespaces
 
 You can also combine all namespaces into a single file per language. This is useful for reducing the number of network requests in some application setups.

package/dist/cjs/cli.js

@@ -37,7 +37,7 @@ const program = new commander.Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.66.0'); // This string is replaced with the actual version at build time by rollup
+    .version('1.66.2'); // 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

@@ -266,6 +266,8 @@ function extractFromTransComponent(node, config) {
         if (!keyExpression)
             return null;
     }
+    if (!keyExpression && !serialized.trim())
+        return null;
     // If no explicit defaults provided and we have a processed key, use it as default value
     // This matches the behavior of other similar tests in the codebase
     if (!defaultsAttr && processedKeyValue && !serialized.trim()) {

package/dist/cjs/utils/logger.js

@@ -23,14 +23,31 @@ class ConsoleLogger {
      * Logs a warning message to the console.
      *
      * @param message - The warning message to log
+     * @param more - Optional additional detail (e.g. a caught error). Forwarded to
+     *   `console.warn` so thrown errors surfaced by plugin hooks are not swallowed.
      */
-    warn(message) { console.warn(message); }
+    warn(message, more) {
+        if (more === undefined) {
+            console.warn(message);
+        }
+        else {
+            console.warn(message, more);
+        }
+    }
     /**
      * Logs an error message to the console.
      *
      * @param message - The error message to log
+     * @param more - Optional additional detail (e.g. a caught error).
      */
-    error(message) { console.error(message); }
+    error(message, more) {
+        if (more === undefined) {
+            console.error(message);
+        }
+        else {
+            console.error(message, more);
+        }
+    }
 }
 
 exports.ConsoleLogger = ConsoleLogger;

package/dist/esm/cli.js

@@ -31,7 +31,7 @@ const program = new Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.66.0'); // This string is replaced with the actual version at build time by rollup
+    .version('1.66.2'); // 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

@@ -263,6 +263,8 @@ function extractFromTransComponent(node, config) {
         if (!keyExpression)
             return null;
     }
+    if (!keyExpression && !serialized.trim())
+        return null;
     // If no explicit defaults provided and we have a processed key, use it as default value
     // This matches the behavior of other similar tests in the codebase
     if (!defaultsAttr && processedKeyValue && !serialized.trim()) {

package/dist/esm/utils/logger.js

@@ -21,14 +21,31 @@ class ConsoleLogger {
      * Logs a warning message to the console.
      *
      * @param message - The warning message to log
+     * @param more - Optional additional detail (e.g. a caught error). Forwarded to
+     *   `console.warn` so thrown errors surfaced by plugin hooks are not swallowed.
      */
-    warn(message) { console.warn(message); }
+    warn(message, more) {
+        if (more === undefined) {
+            console.warn(message);
+        }
+        else {
+            console.warn(message, more);
+        }
+    }
     /**
      * Logs an error message to the console.
      *
      * @param message - The error message to log
+     * @param more - Optional additional detail (e.g. a caught error).
      */
-    error(message) { console.error(message); }
+    error(message, more) {
+        if (more === undefined) {
+            console.error(message);
+        }
+        else {
+            console.error(message, more);
+        }
+    }
 }
 
 export { ConsoleLogger };

package/package.json

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

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,gBAAgB,CAAA;AAkH1D,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"}
+{"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,gBAAgB,CAAA;AAkH1D,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,CAoMxH"}

package/types/utils/logger.d.ts

@@ -22,13 +22,16 @@ export declare class ConsoleLogger implements Logger {
      * Logs a warning message to the console.
      *
      * @param message - The warning message to log
+     * @param more - Optional additional detail (e.g. a caught error). Forwarded to
+     *   `console.warn` so thrown errors surfaced by plugin hooks are not swallowed.
      */
-    warn(message: string): void;
+    warn(message: string, more?: unknown): void;
     /**
      * Logs an error message to the console.
      *
      * @param message - The error message to log
+     * @param more - Optional additional detail (e.g. a caught error).
      */
-    error(message: string): void;
+    error(message: unknown, more?: unknown): void;
 }
 //# sourceMappingURL=logger.d.ts.map

package/types/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C;;;;OAIG;IACH,IAAI,CAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE5B;;;;OAIG;IACH,IAAI,CAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE5B;;;;OAIG;IACH,KAAK,CAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAC9B"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C;;;;OAIG;IACH,IAAI,CAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE5B;;;;;;OAMG;IACH,IAAI,CAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;;;;OAKG;IACH,KAAK,CAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;CAG/C"}