i18next-cli 1.57.0 → 1.58.0

package/README.md

@@ -143,6 +143,7 @@ npx i18next-cli extract [options]
 - `--sync-primary`: Sync primary language values with default values from code
 - `--sync-all`: Sync primary language values with default values from code AND clear synced keys in all other locales (implies `--sync-primary`)
 - `--trust-derived`: When used with `--sync-primary` or `--sync-all`, also trust defaults inferred from keys such as `t('Hello')` or `keyPrefix`-derived values. This keeps the default sync behavior strict unless you opt in.
+- `--with-types`: After extraction (and on every re-run in `--watch` mode), regenerate the TypeScript definitions whenever translation files changed. Avoids the need to run `extract -w` and `types -w` as two separate processes.
 - `--quiet`: Suppress spinner and non-essential output (for CI or scripting)
 
 ### Spinner and Logger Output Control
@@ -194,6 +195,9 @@ npx i18next-cli extract --sync-all --trust-derived
 
 # Combine options for optimal development workflow
 npx i18next-cli extract --sync-primary --watch
+
+# Keep TypeScript definitions in sync from a single process (no separate `types -w` needed)
+npx i18next-cli extract --watch --with-types
 ```
 
 ### `status [locale]`

package/dist/cjs/cli.js

@@ -32,7 +32,7 @@ const program = new commander.Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.57.0'); // This string is replaced with the actual version at build time by rollup
+    .version('1.58.0'); // 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
@@ -44,6 +44,7 @@ program
     .option('--sync-primary', 'Sync primary language values with default values from code.')
     .option('--sync-all', 'Sync primary language values with default values from code AND clear synced keys in all other locales.')
     .option('--trust-derived', 'When used with --sync-primary or --sync-all, also trust defaults inferred from keys (including keyPrefix-derived values).')
+    .option('--with-types', 'After extraction, regenerate TypeScript definitions (runs the types generator) when translation files changed.')
     .option('-q, --quiet', 'Suppress spinner and output')
     .action(async (options) => {
     try {
@@ -72,6 +73,11 @@ program
             if (hasErrors && !options.watch) {
                 process.exit(1);
             }
+            // Re-generate TypeScript definitions in the same process so consumers
+            // don't have to wire a second watcher (avoids the chokidar mid-write race).
+            if (options.withTypes && anyFileUpdated && !options.dryRun) {
+                await typesGenerator.runTypesGenerator(config$1, { quiet: !!options.quiet });
+            }
             return anyFileUpdated;
         };
         // Run the extractor once initially
@@ -138,7 +144,12 @@ program
         const expandedTypes = await expandGlobs(config$1.types?.input || []);
         const ignoredTypes = [...toArray(config$1.extract?.ignore)].filter(Boolean);
         const watchTypes = expandedTypes.filter(f => !ignoredTypes.some(g => minimatch.minimatch(f, g, { dot: true })));
-        const watcher = chokidar.watch(watchTypes, { persistent: true });
+        // awaitWriteFinish avoids triggering mid-write when another process (e.g. `extract -w`)
+        // is rewriting the same translation files. See i18next/i18next-cli#257.
+        const watcher = chokidar.watch(watchTypes, {
+            persistent: true,
+            awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 },
+        });
         watcher.on('change', path => {
             console.log(`\nFile changed: ${path}`);
             run();

package/dist/esm/cli.js

@@ -30,7 +30,7 @@ const program = new Command();
 program
     .name('i18next-cli')
     .description('A unified, high-performance i18next CLI.')
-    .version('1.57.0'); // This string is replaced with the actual version at build time by rollup
+    .version('1.58.0'); // 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
@@ -42,6 +42,7 @@ program
     .option('--sync-primary', 'Sync primary language values with default values from code.')
     .option('--sync-all', 'Sync primary language values with default values from code AND clear synced keys in all other locales.')
     .option('--trust-derived', 'When used with --sync-primary or --sync-all, also trust defaults inferred from keys (including keyPrefix-derived values).')
+    .option('--with-types', 'After extraction, regenerate TypeScript definitions (runs the types generator) when translation files changed.')
     .option('-q, --quiet', 'Suppress spinner and output')
     .action(async (options) => {
     try {
@@ -70,6 +71,11 @@ program
             if (hasErrors && !options.watch) {
                 process.exit(1);
             }
+            // Re-generate TypeScript definitions in the same process so consumers
+            // don't have to wire a second watcher (avoids the chokidar mid-write race).
+            if (options.withTypes && anyFileUpdated && !options.dryRun) {
+                await runTypesGenerator(config, { quiet: !!options.quiet });
+            }
             return anyFileUpdated;
         };
         // Run the extractor once initially
@@ -136,7 +142,12 @@ program
         const expandedTypes = await expandGlobs(config.types?.input || []);
         const ignoredTypes = [...toArray(config.extract?.ignore)].filter(Boolean);
         const watchTypes = expandedTypes.filter(f => !ignoredTypes.some(g => minimatch(f, g, { dot: true })));
-        const watcher = chokidar.watch(watchTypes, { persistent: true });
+        // awaitWriteFinish avoids triggering mid-write when another process (e.g. `extract -w`)
+        // is rewriting the same translation files. See i18next/i18next-cli#257.
+        const watcher = chokidar.watch(watchTypes, {
+            persistent: true,
+            awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 },
+        });
         watcher.on('change', path => {
             console.log(`\nFile changed: ${path}`);
             run();

package/package.json

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

package/types/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoBnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AAkZ7B,OAAO,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoBnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AA8Z7B,OAAO,EAAE,OAAO,EAAE,CAAA"}