i18next-cli 1.37.1 → 1.38.0

package/README.md

@@ -114,6 +114,33 @@ npx i18next-cli extract [options]
 - `--dry-run`: Does not change any files - useful in combination with `--ci` (for CI/CD)
 - `--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`)
+- `--quiet`: Suppress spinner and non-essential output (for CI or scripting)
+### Spinner and Logger Output Control
+
+All commands that show progress spinners (extract, types, lint, sync) now support:
+
+- `--quiet` flag to silence spinner and non-essential output (for CI, scripting, or log capture)
+- Programmatic logger support: pass a custom logger object to capture output in your own format or stream
+
+**CLI Example:**
+
+```bash
+npx i18next-cli extract --quiet
+```
+
+**Programmatic Example:**
+
+```typescript
+import { runExtractor } from 'i18next-cli';
+const logger = {
+  info: (msg) => myLogStream.write(msg + '\n'),
+  warn: (msg) => myWarnStream.write(msg + '\n'),
+  error: (msg) => myErrStream.write(msg + '\n'),
+};
+await runExtractor(config, { quiet: false }, logger);
+```
+
+If you pass a logger, spinner output and all progress/info messages are routed to your logger instead of the interactive spinner.
 
 **Examples:**
 ```bash

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.37.1'); // This string is replaced with the actual version at build time by rollup
+    .version('1.38.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
@@ -39,6 +39,7 @@ program
     .option('--dry-run', 'Run the extractor without writing any files to disk.')
     .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('-q, --quiet', 'Suppress spinner and output')
     .action(async (options) => {
     try {
         const cfgPath = program.opts().config;
@@ -50,7 +51,8 @@ program
                 isWatchMode: !!options.watch,
                 isDryRun: !!options.dryRun,
                 syncPrimaryWithDefaults: syncPrimary,
-                syncAll: !!options.syncAll
+                syncAll: !!options.syncAll,
+                quiet: !!options.quiet
             });
             if (options.ci && !success) {
                 console.log('✅ No files were updated.');
@@ -114,10 +116,11 @@ program
     .command('types')
     .description('Generate TypeScript definitions from translation resource files.')
     .option('-w, --watch', 'Watch for file changes and re-run the type generator.')
+    .option('-q, --quiet', 'Suppress spinner and output')
     .action(async (options) => {
     const cfgPath = program.opts().config;
     const config$1 = await config.ensureConfig(cfgPath);
-    const run = () => typesGenerator.runTypesGenerator(config$1);
+    const run = () => typesGenerator.runTypesGenerator(config$1, { quiet: !!options.quiet });
     await run();
     if (options.watch) {
         console.log('\nWatching for changes...');
@@ -134,10 +137,11 @@ program
 program
     .command('sync')
     .description('Synchronize secondary language files with the primary language file.')
-    .action(async () => {
+    .option('-q, --quiet', 'Suppress spinner and output')
+    .action(async (options) => {
     const cfgPath = program.opts().config;
     const config$1 = await config.ensureConfig(cfgPath);
-    await syncer.runSyncer(config$1);
+    await syncer.runSyncer(config$1, { quiet: !!options.quiet });
 });
 program
     .command('migrate-config [configPath]')
@@ -153,6 +157,7 @@ program
     .command('lint')
     .description('Find potential issues like hardcoded strings in your codebase.')
     .option('-w, --watch', 'Watch for file changes and re-run the linter.')
+    .option('-q, --quiet', 'Suppress spinner and output')
     .action(async (options) => {
     const cfgPath = program.opts().config;
     const loadAndRunLinter = async () => {
@@ -169,7 +174,7 @@ program
             console.log(chalk.green('Project structure detected successfully!'));
             config$1 = detected;
         }
-        await linter.runLinterCli(config$1);
+        await linter.runLinterCli(config$1, { quiet: !!options.quiet });
     };
     // Run the linter once initially
     await loadAndRunLinter();

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

@@ -1,6 +1,6 @@
 'use strict';
 
-var ora = require('ora');
+var wrapOra = require('../../utils/wrap-ora.js');
 var chalk = require('chalk');
 var core = require('@swc/core');
 var promises = require('node:fs/promises');
@@ -39,7 +39,7 @@ var funnelMsgTracker = require('../../utils/funnel-msg-tracker.js');
  * }
  * ```
  */
-async function runExtractor(config, { isWatchMode = false, isDryRun = false, syncPrimaryWithDefaults = false, syncAll = false } = {}, logger$1 = new logger.ConsoleLogger()) {
+async function runExtractor(config, options = {}, logger$1) {
     config.extract.primaryLanguage ||= config.locales[0] || 'en';
     config.extract.secondaryLanguages ||= config.locales.filter((l) => l !== config?.extract?.primaryLanguage);
     // Ensure default function and component names are set if not provided.
@@ -47,16 +47,21 @@ async function runExtractor(config, { isWatchMode = false, isDryRun = false, syn
     config.extract.transComponents ||= ['Trans'];
     validation.validateExtractorConfig(config);
     const plugins = config.plugins || [];
-    const spinner = ora('Running i18next key extractor...\n').start();
+    const internalLogger = logger$1 ?? new logger.ConsoleLogger();
+    // Only pass logger to spinner if explicitly provided
+    const spinner = wrapOra.createSpinnerLike('Running i18next key extractor...\n', { quiet: !!options.quiet, logger: logger$1 });
     try {
-        const { allKeys, objectKeys } = await keyFinder.findKeys(config, logger$1);
+        const { allKeys, objectKeys } = await keyFinder.findKeys(config, internalLogger);
         spinner.text = `Found ${allKeys.size} unique keys. Updating translation files...`;
-        const results = await translationManager.getTranslations(allKeys, objectKeys, config, { syncPrimaryWithDefaults, syncAll });
+        const results = await translationManager.getTranslations(allKeys, objectKeys, config, {
+            syncPrimaryWithDefaults: options.syncPrimaryWithDefaults,
+            syncAll: options.syncAll
+        });
         let anyFileUpdated = false;
         for (const result of results) {
             if (result.updated) {
                 anyFileUpdated = true;
-                if (!isDryRun) {
+                if (!options.isDryRun) {
                     // prefer explicit outputFormat; otherwise infer from file extension per-file
                     const effectiveFormat = config.extract.outputFormat ?? (result.path.endsWith('.json5') ? 'json5' : 'json');
                     const rawContent = effectiveFormat === 'json5'
@@ -65,7 +70,7 @@ async function runExtractor(config, { isWatchMode = false, isDryRun = false, syn
                     const fileContent = fileUtils.serializeTranslationFile(result.newTranslations, effectiveFormat, config.extract.indentation, rawContent);
                     await promises.mkdir(node_path.dirname(result.path), { recursive: true });
                     await promises.writeFile(result.path, fileContent);
-                    logger$1.info(chalk.green(`Updated: ${result.path}`));
+                    internalLogger.info(chalk.green(`Updated: ${result.path}`));
                 }
             }
         }
@@ -79,7 +84,7 @@ async function runExtractor(config, { isWatchMode = false, isDryRun = false, syn
         spinner.succeed(chalk.bold('Extraction complete!'));
         // Show the funnel message only if files were actually changed.
         if (anyFileUpdated)
-            await printLocizeFunnel();
+            await printLocizeFunnel(logger$1);
         return anyFileUpdated;
     }
     catch (error) {
@@ -229,14 +234,24 @@ async function extract(config, { syncPrimaryWithDefaults = false } = {}) {
  * Prints a promotional message for the locize saveMissing workflow.
  * This message is shown after a successful extraction that resulted in changes.
  */
-async function printLocizeFunnel() {
+async function printLocizeFunnel(logger$1) {
     if (!(await funnelMsgTracker.shouldShowFunnel('extract')))
         return;
-    console.log(chalk.yellow.bold('\n💡 Tip: Tired of running the extractor manually?'));
-    console.log('   Discover a real-time "push" workflow with `saveMissing` and Locize AI,');
-    console.log('   where keys are created and translated automatically as you code.');
-    console.log(`   Learn more: ${chalk.cyan('https://www.locize.com/blog/i18next-savemissing-ai-automation')}`);
-    console.log(`   Watch the video: ${chalk.cyan('https://youtu.be/joPsZghT3wM')}`);
+    const internalLogger = logger$1 ?? new logger.ConsoleLogger();
+    if (typeof internalLogger.info === 'function') {
+        internalLogger.info(chalk.yellow.bold('\n💡 Tip: Tired of running the extractor manually?'));
+        internalLogger.info('   Discover a real-time "push" workflow with `saveMissing` and Locize AI,');
+        internalLogger.info('   where keys are created and translated automatically as you code.');
+        internalLogger.info(`   Learn more: ${chalk.cyan('https://www.locize.com/blog/i18next-savemissing-ai-automation')}`);
+        internalLogger.info(`   Watch the video: ${chalk.cyan('https://youtu.be/joPsZghT3wM')}`);
+    }
+    else {
+        console.log(chalk.yellow.bold('\n💡 Tip: Tired of running the extractor manually?'));
+        console.log('   Discover a real-time "push" workflow with `saveMissing` and Locize AI,');
+        console.log('   where keys are created and translated automatically as you code.');
+        console.log(`   Learn more: ${chalk.cyan('https://www.locize.com/blog/i18next-savemissing-ai-automation')}`);
+        console.log(`   Watch the video: ${chalk.cyan('https://youtu.be/joPsZghT3wM')}`);
+    }
     return funnelMsgTracker.recordFunnelShown('extract');
 }
 

package/dist/cjs/linter.js

@@ -6,7 +6,8 @@ var core = require('@swc/core');
 var node_path = require('node:path');
 var node_events = require('node:events');
 var chalk = require('chalk');
-var ora = require('ora');
+var logger = require('./utils/logger.js');
+var wrapOra = require('./utils/wrap-ora.js');
 
 // Helper to extract interpolation keys from a translation string
 function extractInterpolationKeys(str, config) {
@@ -279,9 +280,10 @@ class Linter extends node_events.EventEmitter {
 async function runLinter(config) {
     return new Linter(config).run();
 }
-async function runLinterCli(config) {
+async function runLinterCli(config, options = {}, logger$1) {
+    const internalLogger = new logger.ConsoleLogger();
     const linter = new Linter(config);
-    const spinner = ora().start();
+    const spinner = wrapOra.createSpinnerLike('', { quiet: !!options.quiet, logger: logger$1 });
     linter.on('progress', (event) => {
         spinner.text = event.message;
     });
@@ -291,9 +293,15 @@ async function runLinterCli(config) {
             spinner.fail(chalk.red.bold(message));
             // Print detailed report after spinner fails
             for (const [file, issues] of Object.entries(files)) {
-                console.log(chalk.yellow(`\n${file}`));
+                if (internalLogger.info)
+                    internalLogger.info(chalk.yellow(`\n${file}`));
+                else
+                    console.log(chalk.yellow(`\n${file}`));
                 issues.forEach(({ text, line }) => {
-                    console.log(`  ${chalk.gray(`${line}:`)} ${chalk.red('Error:')} Found hardcoded string: "${text}"`);
+                    if (typeof internalLogger.info === 'function')
+                        internalLogger.info(`  ${chalk.gray(`${line}:`)} ${chalk.red('Error:')} Found hardcoded string: "${text}"`);
+                    else
+                        console.log(`  ${chalk.gray(`${line}:`)} ${chalk.red('Error:')} Found hardcoded string: "${text}"`);
                 });
             }
             process.exit(1);
@@ -305,7 +313,10 @@ async function runLinterCli(config) {
     catch (error) {
         const wrappedError = linter.wrapError(error);
         spinner.fail(wrappedError.message);
-        console.error(wrappedError);
+        if (internalLogger.error)
+            internalLogger.error(wrappedError);
+        else
+            console.error(wrappedError);
         process.exit(1);
     }
 }

package/dist/cjs/syncer.js

@@ -4,7 +4,8 @@ var chalk = require('chalk');
 var glob = require('glob');
 var promises = require('node:fs/promises');
 var node_path = require('node:path');
-var ora = require('ora');
+var wrapOra = require('./utils/wrap-ora.js');
+var logger = require('./utils/logger.js');
 var defaultValue = require('./utils/default-value.js');
 var fileUtils = require('./utils/file-utils.js');
 var funnelMsgTracker = require('./utils/funnel-msg-tracker.js');
@@ -40,8 +41,9 @@ var nestedObject = require('./utils/nested-object.js');
  * await runSyncer(config)
  * ```
  */
-async function runSyncer(config) {
-    const spinner = ora('Running i18next locale synchronizer...\n').start();
+async function runSyncer(config, options = {}, logger$1) {
+    const internalLogger = logger$1 ?? new logger.ConsoleLogger();
+    const spinner = wrapOra.createSpinnerLike('Running i18next locale synchronizer...\n', { quiet: !!options.quiet, logger: logger$1 });
     try {
         const primaryLanguage = config.extract.primaryLanguage || config.locales[0] || 'en';
         const secondaryLanguages = config.locales.filter((l) => l !== primaryLanguage);
@@ -95,17 +97,23 @@ async function runSyncer(config) {
             }
         }
         spinner.succeed(chalk.bold('Synchronization complete!'));
-        logMessages.forEach(msg => console.log(msg));
+        logMessages.forEach(msg => internalLogger.info ? internalLogger.info(msg) : console.log(msg));
         if (wasAnythingSynced) {
             await printLocizeFunnel();
         }
         else {
-            console.log(chalk.green.bold('\n✅ All locales are already in sync.'));
+            if (typeof internalLogger.info === 'function')
+                internalLogger.info(chalk.green.bold('\n✅ All locales are already in sync.'));
+            else
+                console.log(chalk.green.bold('\n✅ All locales are already in sync.'));
         }
     }
     catch (error) {
         spinner.fail(chalk.red('Synchronization failed.'));
-        console.error(error);
+        if (typeof internalLogger.error === 'function')
+            internalLogger.error(error);
+        else
+            console.error(error);
     }
 }
 async function printLocizeFunnel() {

package/dist/cjs/types-generator.js

@@ -1,8 +1,9 @@
 'use strict';
 
+var logger = require('./utils/logger.js');
 var i18nextResourcesForTs = require('i18next-resources-for-ts');
 var glob = require('glob');
-var ora = require('ora');
+var wrapOra = require('./utils/wrap-ora.js');
 var chalk = require('chalk');
 var promises = require('node:fs/promises');
 var node_path = require('node:path');
@@ -70,8 +71,9 @@ async function loadFile(file) {
  * await runTypesGenerator(config)
  * ```
  */
-async function runTypesGenerator(config) {
-    const spinner = ora('Generating TypeScript types for translations...\n').start();
+async function runTypesGenerator(config, options = {}, logger$1) {
+    const internalLogger = logger$1 ?? new logger.ConsoleLogger();
+    const spinner = wrapOra.createSpinnerLike('Generating TypeScript types for translations...\n', { quiet: !!options.quiet, logger: logger$1 });
     try {
         config.extract.primaryLanguage ||= config.locales[0] || 'en';
         let defaultTypesInputPath = config.extract.output || `locales/${config.extract.primaryLanguage}/*.json`;
@@ -155,11 +157,14 @@ declare module 'i18next' {
             logMessages.push(`  ${chalk.green('✓')} TypeScript definitions written to ${config.types.output || ''}`);
         }
         spinner.succeed(chalk.bold('TypeScript definitions generated successfully.'));
-        logMessages.forEach(msg => console.log(msg));
+        logMessages.forEach(msg => typeof internalLogger.info === 'function' ? internalLogger.info(msg) : console.log(msg));
     }
     catch (error) {
         spinner.fail(chalk.red('Failed to generate TypeScript definitions.'));
-        console.error(error);
+        if (typeof internalLogger.error === 'function')
+            internalLogger.error(error);
+        else
+            console.error(error);
     }
 }
 

package/dist/cjs/utils/wrap-ora.js

@@ -0,0 +1,112 @@
+'use strict';
+
+var ora = require('ora');
+
+/**
+ * Creates a spinner-like object that either:
+ * - is fully silent (quiet mode),
+ * - logs only start/succeed/fail events to a logger (no animation),
+ * - or falls back to ora's default spinner.
+ *
+ * This avoids flooding structured loggers with spinner frames and ensures clean output in CI, Vite, etc.
+ */
+function createSpinnerLike(initialText, options = {}) {
+    const { quiet, logger } = options;
+    let text = initialText;
+    // If interactive (no logger and not quiet), create a single real ora spinner
+    let realSpinner = null;
+    if (!quiet && !logger) {
+        realSpinner = ora({ text }).start();
+    }
+    const self = {
+        get text() { return text; },
+        set text(v) {
+            text = v;
+            if (realSpinner)
+                realSpinner.text = v;
+        },
+        start() { return self; },
+        succeed(msg) {
+            const message = msg ?? text;
+            if (quiet)
+                return;
+            if (logger) {
+                if (typeof logger.info === 'function')
+                    logger.info(message);
+                else if (typeof logger.log === 'function')
+                    logger.log(message);
+                else
+                    process.stderr.write(message + '\n');
+            }
+            else {
+                if (!realSpinner)
+                    realSpinner = ora({ text }).start();
+                realSpinner.succeed(message);
+            }
+        },
+        fail(msg) {
+            const message = msg ?? text;
+            if (quiet)
+                return;
+            if (logger) {
+                if (typeof logger.error === 'function')
+                    logger.error(message);
+                else if (typeof logger.log === 'function')
+                    logger.log(message);
+                else
+                    process.stderr.write(message + '\n');
+            }
+            else {
+                if (!realSpinner)
+                    realSpinner = ora({ text }).start();
+                realSpinner.fail(message);
+            }
+        },
+        warn(msg) {
+            const message = msg ?? text;
+            if (quiet)
+                return;
+            if (logger) {
+                if (typeof logger.warn === 'function')
+                    logger.warn(message);
+                else if (typeof logger.log === 'function')
+                    logger.log(message);
+                else
+                    process.stderr.write(message + '\n');
+            }
+            else {
+                if (!realSpinner)
+                    realSpinner = ora({ text }).start();
+                try {
+                    realSpinner.warn?.(message);
+                }
+                catch {
+                    realSpinner.stop();
+                    process.stderr.write(message + '\n');
+                }
+            }
+        },
+        stop() { if (realSpinner)
+            realSpinner.stop(); },
+        progress(msg) {
+            if (quiet)
+                return;
+            if (logger) {
+                if (typeof logger.info === 'function')
+                    logger.info(msg);
+                else if (typeof logger.log === 'function')
+                    logger.log(msg);
+                else
+                    process.stderr.write(msg + '\n');
+            }
+            else {
+                if (!realSpinner)
+                    realSpinner = ora({ text }).start();
+                realSpinner.text = String(msg);
+            }
+        }
+    };
+    return self;
+}
+
+exports.createSpinnerLike = createSpinnerLike;

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.37.1'); // This string is replaced with the actual version at build time by rollup
+    .version('1.38.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
@@ -37,6 +37,7 @@ program
     .option('--dry-run', 'Run the extractor without writing any files to disk.')
     .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('-q, --quiet', 'Suppress spinner and output')
     .action(async (options) => {
     try {
         const cfgPath = program.opts().config;
@@ -48,7 +49,8 @@ program
                 isWatchMode: !!options.watch,
                 isDryRun: !!options.dryRun,
                 syncPrimaryWithDefaults: syncPrimary,
-                syncAll: !!options.syncAll
+                syncAll: !!options.syncAll,
+                quiet: !!options.quiet
             });
             if (options.ci && !success) {
                 console.log('✅ No files were updated.');
@@ -112,10 +114,11 @@ program
     .command('types')
     .description('Generate TypeScript definitions from translation resource files.')
     .option('-w, --watch', 'Watch for file changes and re-run the type generator.')
+    .option('-q, --quiet', 'Suppress spinner and output')
     .action(async (options) => {
     const cfgPath = program.opts().config;
     const config = await ensureConfig(cfgPath);
-    const run = () => runTypesGenerator(config);
+    const run = () => runTypesGenerator(config, { quiet: !!options.quiet });
     await run();
     if (options.watch) {
         console.log('\nWatching for changes...');
@@ -132,10 +135,11 @@ program
 program
     .command('sync')
     .description('Synchronize secondary language files with the primary language file.')
-    .action(async () => {
+    .option('-q, --quiet', 'Suppress spinner and output')
+    .action(async (options) => {
     const cfgPath = program.opts().config;
     const config = await ensureConfig(cfgPath);
-    await runSyncer(config);
+    await runSyncer(config, { quiet: !!options.quiet });
 });
 program
     .command('migrate-config [configPath]')
@@ -151,6 +155,7 @@ program
     .command('lint')
     .description('Find potential issues like hardcoded strings in your codebase.')
     .option('-w, --watch', 'Watch for file changes and re-run the linter.')
+    .option('-q, --quiet', 'Suppress spinner and output')
     .action(async (options) => {
     const cfgPath = program.opts().config;
     const loadAndRunLinter = async () => {
@@ -167,7 +172,7 @@ program
             console.log(chalk.green('Project structure detected successfully!'));
             config = detected;
         }
-        await runLinterCli(config);
+        await runLinterCli(config, { quiet: !!options.quiet });
     };
     // Run the linter once initially
     await loadAndRunLinter();

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

@@ -1,4 +1,4 @@
-import ora from 'ora';
+import { createSpinnerLike } from '../../utils/wrap-ora.js';
 import chalk from 'chalk';
 import { parse } from '@swc/core';
 import { mkdir, writeFile, readFile } from 'node:fs/promises';
@@ -37,7 +37,7 @@ import { shouldShowFunnel, recordFunnelShown } from '../../utils/funnel-msg-trac
  * }
  * ```
  */
-async function runExtractor(config, { isWatchMode = false, isDryRun = false, syncPrimaryWithDefaults = false, syncAll = false } = {}, logger = new ConsoleLogger()) {
+async function runExtractor(config, options = {}, logger) {
     config.extract.primaryLanguage ||= config.locales[0] || 'en';
     config.extract.secondaryLanguages ||= config.locales.filter((l) => l !== config?.extract?.primaryLanguage);
     // Ensure default function and component names are set if not provided.
@@ -45,16 +45,21 @@ async function runExtractor(config, { isWatchMode = false, isDryRun = false, syn
     config.extract.transComponents ||= ['Trans'];
     validateExtractorConfig(config);
     const plugins = config.plugins || [];
-    const spinner = ora('Running i18next key extractor...\n').start();
+    const internalLogger = logger ?? new ConsoleLogger();
+    // Only pass logger to spinner if explicitly provided
+    const spinner = createSpinnerLike('Running i18next key extractor...\n', { quiet: !!options.quiet, logger });
     try {
-        const { allKeys, objectKeys } = await findKeys(config, logger);
+        const { allKeys, objectKeys } = await findKeys(config, internalLogger);
         spinner.text = `Found ${allKeys.size} unique keys. Updating translation files...`;
-        const results = await getTranslations(allKeys, objectKeys, config, { syncPrimaryWithDefaults, syncAll });
+        const results = await getTranslations(allKeys, objectKeys, config, {
+            syncPrimaryWithDefaults: options.syncPrimaryWithDefaults,
+            syncAll: options.syncAll
+        });
         let anyFileUpdated = false;
         for (const result of results) {
             if (result.updated) {
                 anyFileUpdated = true;
-                if (!isDryRun) {
+                if (!options.isDryRun) {
                     // prefer explicit outputFormat; otherwise infer from file extension per-file
                     const effectiveFormat = config.extract.outputFormat ?? (result.path.endsWith('.json5') ? 'json5' : 'json');
                     const rawContent = effectiveFormat === 'json5'
@@ -63,7 +68,7 @@ async function runExtractor(config, { isWatchMode = false, isDryRun = false, syn
                     const fileContent = serializeTranslationFile(result.newTranslations, effectiveFormat, config.extract.indentation, rawContent);
                     await mkdir(dirname(result.path), { recursive: true });
                     await writeFile(result.path, fileContent);
-                    logger.info(chalk.green(`Updated: ${result.path}`));
+                    internalLogger.info(chalk.green(`Updated: ${result.path}`));
                 }
             }
         }
@@ -77,7 +82,7 @@ async function runExtractor(config, { isWatchMode = false, isDryRun = false, syn
         spinner.succeed(chalk.bold('Extraction complete!'));
         // Show the funnel message only if files were actually changed.
         if (anyFileUpdated)
-            await printLocizeFunnel();
+            await printLocizeFunnel(logger);
         return anyFileUpdated;
     }
     catch (error) {
@@ -227,14 +232,24 @@ async function extract(config, { syncPrimaryWithDefaults = false } = {}) {
  * Prints a promotional message for the locize saveMissing workflow.
  * This message is shown after a successful extraction that resulted in changes.
  */
-async function printLocizeFunnel() {
+async function printLocizeFunnel(logger) {
     if (!(await shouldShowFunnel('extract')))
         return;
-    console.log(chalk.yellow.bold('\n💡 Tip: Tired of running the extractor manually?'));
-    console.log('   Discover a real-time "push" workflow with `saveMissing` and Locize AI,');
-    console.log('   where keys are created and translated automatically as you code.');
-    console.log(`   Learn more: ${chalk.cyan('https://www.locize.com/blog/i18next-savemissing-ai-automation')}`);
-    console.log(`   Watch the video: ${chalk.cyan('https://youtu.be/joPsZghT3wM')}`);
+    const internalLogger = logger ?? new ConsoleLogger();
+    if (typeof internalLogger.info === 'function') {
+        internalLogger.info(chalk.yellow.bold('\n💡 Tip: Tired of running the extractor manually?'));
+        internalLogger.info('   Discover a real-time "push" workflow with `saveMissing` and Locize AI,');
+        internalLogger.info('   where keys are created and translated automatically as you code.');
+        internalLogger.info(`   Learn more: ${chalk.cyan('https://www.locize.com/blog/i18next-savemissing-ai-automation')}`);
+        internalLogger.info(`   Watch the video: ${chalk.cyan('https://youtu.be/joPsZghT3wM')}`);
+    }
+    else {
+        console.log(chalk.yellow.bold('\n💡 Tip: Tired of running the extractor manually?'));
+        console.log('   Discover a real-time "push" workflow with `saveMissing` and Locize AI,');
+        console.log('   where keys are created and translated automatically as you code.');
+        console.log(`   Learn more: ${chalk.cyan('https://www.locize.com/blog/i18next-savemissing-ai-automation')}`);
+        console.log(`   Watch the video: ${chalk.cyan('https://youtu.be/joPsZghT3wM')}`);
+    }
     return recordFunnelShown('extract');
 }
 

package/dist/esm/linter.js

@@ -4,7 +4,8 @@ import { parse } from '@swc/core';
 import { extname } from 'node:path';
 import { EventEmitter } from 'node:events';
 import chalk from 'chalk';
-import ora from 'ora';
+import { ConsoleLogger } from './utils/logger.js';
+import { createSpinnerLike } from './utils/wrap-ora.js';
 
 // Helper to extract interpolation keys from a translation string
 function extractInterpolationKeys(str, config) {
@@ -277,9 +278,10 @@ class Linter extends EventEmitter {
 async function runLinter(config) {
     return new Linter(config).run();
 }
-async function runLinterCli(config) {
+async function runLinterCli(config, options = {}, logger) {
+    const internalLogger = new ConsoleLogger();
     const linter = new Linter(config);
-    const spinner = ora().start();
+    const spinner = createSpinnerLike('', { quiet: !!options.quiet, logger });
     linter.on('progress', (event) => {
         spinner.text = event.message;
     });
@@ -289,9 +291,15 @@ async function runLinterCli(config) {
             spinner.fail(chalk.red.bold(message));
             // Print detailed report after spinner fails
             for (const [file, issues] of Object.entries(files)) {
-                console.log(chalk.yellow(`\n${file}`));
+                if (internalLogger.info)
+                    internalLogger.info(chalk.yellow(`\n${file}`));
+                else
+                    console.log(chalk.yellow(`\n${file}`));
                 issues.forEach(({ text, line }) => {
-                    console.log(`  ${chalk.gray(`${line}:`)} ${chalk.red('Error:')} Found hardcoded string: "${text}"`);
+                    if (typeof internalLogger.info === 'function')
+                        internalLogger.info(`  ${chalk.gray(`${line}:`)} ${chalk.red('Error:')} Found hardcoded string: "${text}"`);
+                    else
+                        console.log(`  ${chalk.gray(`${line}:`)} ${chalk.red('Error:')} Found hardcoded string: "${text}"`);
                 });
             }
             process.exit(1);
@@ -303,7 +311,10 @@ async function runLinterCli(config) {
     catch (error) {
         const wrappedError = linter.wrapError(error);
         spinner.fail(wrappedError.message);
-        console.error(wrappedError);
+        if (internalLogger.error)
+            internalLogger.error(wrappedError);
+        else
+            console.error(wrappedError);
         process.exit(1);
     }
 }

package/dist/esm/syncer.js

@@ -2,7 +2,8 @@ import chalk from 'chalk';
 import { glob } from 'glob';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { basename, resolve, dirname } from 'node:path';
-import ora from 'ora';
+import { createSpinnerLike } from './utils/wrap-ora.js';
+import { ConsoleLogger } from './utils/logger.js';
 import { resolveDefaultValue } from './utils/default-value.js';
 import { getOutputPath, loadTranslationFile, loadRawJson5Content, serializeTranslationFile } from './utils/file-utils.js';
 import { shouldShowFunnel, recordFunnelShown } from './utils/funnel-msg-tracker.js';
@@ -38,8 +39,9 @@ import { getNestedKeys, getNestedValue, setNestedValue } from './utils/nested-ob
  * await runSyncer(config)
  * ```
  */
-async function runSyncer(config) {
-    const spinner = ora('Running i18next locale synchronizer...\n').start();
+async function runSyncer(config, options = {}, logger) {
+    const internalLogger = logger ?? new ConsoleLogger();
+    const spinner = createSpinnerLike('Running i18next locale synchronizer...\n', { quiet: !!options.quiet, logger });
     try {
         const primaryLanguage = config.extract.primaryLanguage || config.locales[0] || 'en';
         const secondaryLanguages = config.locales.filter((l) => l !== primaryLanguage);
@@ -93,17 +95,23 @@ async function runSyncer(config) {
             }
         }
         spinner.succeed(chalk.bold('Synchronization complete!'));
-        logMessages.forEach(msg => console.log(msg));
+        logMessages.forEach(msg => internalLogger.info ? internalLogger.info(msg) : console.log(msg));
         if (wasAnythingSynced) {
             await printLocizeFunnel();
         }
         else {
-            console.log(chalk.green.bold('\n✅ All locales are already in sync.'));
+            if (typeof internalLogger.info === 'function')
+                internalLogger.info(chalk.green.bold('\n✅ All locales are already in sync.'));
+            else
+                console.log(chalk.green.bold('\n✅ All locales are already in sync.'));
         }
     }
     catch (error) {
         spinner.fail(chalk.red('Synchronization failed.'));
-        console.error(error);
+        if (typeof internalLogger.error === 'function')
+            internalLogger.error(error);
+        else
+            console.error(error);
     }
 }
 async function printLocizeFunnel() {

package/dist/esm/types-generator.js

@@ -1,6 +1,7 @@
+import { ConsoleLogger } from './utils/logger.js';
 import { mergeResourcesAsInterface } from 'i18next-resources-for-ts';
 import { glob } from 'glob';
-import ora from 'ora';
+import { createSpinnerLike } from './utils/wrap-ora.js';
 import chalk from 'chalk';
 import { mkdir, writeFile, access, readFile } from 'node:fs/promises';
 import { join, dirname, basename, extname, resolve, relative } from 'node:path';
@@ -68,8 +69,9 @@ async function loadFile(file) {
  * await runTypesGenerator(config)
  * ```
  */
-async function runTypesGenerator(config) {
-    const spinner = ora('Generating TypeScript types for translations...\n').start();
+async function runTypesGenerator(config, options = {}, logger) {
+    const internalLogger = logger ?? new ConsoleLogger();
+    const spinner = createSpinnerLike('Generating TypeScript types for translations...\n', { quiet: !!options.quiet, logger });
     try {
         config.extract.primaryLanguage ||= config.locales[0] || 'en';
         let defaultTypesInputPath = config.extract.output || `locales/${config.extract.primaryLanguage}/*.json`;
@@ -153,11 +155,14 @@ declare module 'i18next' {
             logMessages.push(`  ${chalk.green('✓')} TypeScript definitions written to ${config.types.output || ''}`);
         }
         spinner.succeed(chalk.bold('TypeScript definitions generated successfully.'));
-        logMessages.forEach(msg => console.log(msg));
+        logMessages.forEach(msg => typeof internalLogger.info === 'function' ? internalLogger.info(msg) : console.log(msg));
     }
     catch (error) {
         spinner.fail(chalk.red('Failed to generate TypeScript definitions.'));
-        console.error(error);
+        if (typeof internalLogger.error === 'function')
+            internalLogger.error(error);
+        else
+            console.error(error);
     }
 }
 

package/dist/esm/utils/wrap-ora.js

@@ -0,0 +1,110 @@
+import ora from 'ora';
+
+/**
+ * Creates a spinner-like object that either:
+ * - is fully silent (quiet mode),
+ * - logs only start/succeed/fail events to a logger (no animation),
+ * - or falls back to ora's default spinner.
+ *
+ * This avoids flooding structured loggers with spinner frames and ensures clean output in CI, Vite, etc.
+ */
+function createSpinnerLike(initialText, options = {}) {
+    const { quiet, logger } = options;
+    let text = initialText;
+    // If interactive (no logger and not quiet), create a single real ora spinner
+    let realSpinner = null;
+    if (!quiet && !logger) {
+        realSpinner = ora({ text }).start();
+    }
+    const self = {
+        get text() { return text; },
+        set text(v) {
+            text = v;
+            if (realSpinner)
+                realSpinner.text = v;
+        },
+        start() { return self; },
+        succeed(msg) {
+            const message = msg ?? text;
+            if (quiet)
+                return;
+            if (logger) {
+                if (typeof logger.info === 'function')
+                    logger.info(message);
+                else if (typeof logger.log === 'function')
+                    logger.log(message);
+                else
+                    process.stderr.write(message + '\n');
+            }
+            else {
+                if (!realSpinner)
+                    realSpinner = ora({ text }).start();
+                realSpinner.succeed(message);
+            }
+        },
+        fail(msg) {
+            const message = msg ?? text;
+            if (quiet)
+                return;
+            if (logger) {
+                if (typeof logger.error === 'function')
+                    logger.error(message);
+                else if (typeof logger.log === 'function')
+                    logger.log(message);
+                else
+                    process.stderr.write(message + '\n');
+            }
+            else {
+                if (!realSpinner)
+                    realSpinner = ora({ text }).start();
+                realSpinner.fail(message);
+            }
+        },
+        warn(msg) {
+            const message = msg ?? text;
+            if (quiet)
+                return;
+            if (logger) {
+                if (typeof logger.warn === 'function')
+                    logger.warn(message);
+                else if (typeof logger.log === 'function')
+                    logger.log(message);
+                else
+                    process.stderr.write(message + '\n');
+            }
+            else {
+                if (!realSpinner)
+                    realSpinner = ora({ text }).start();
+                try {
+                    realSpinner.warn?.(message);
+                }
+                catch {
+                    realSpinner.stop();
+                    process.stderr.write(message + '\n');
+                }
+            }
+        },
+        stop() { if (realSpinner)
+            realSpinner.stop(); },
+        progress(msg) {
+            if (quiet)
+                return;
+            if (logger) {
+                if (typeof logger.info === 'function')
+                    logger.info(msg);
+                else if (typeof logger.log === 'function')
+                    logger.log(msg);
+                else
+                    process.stderr.write(msg + '\n');
+            }
+            else {
+                if (!realSpinner)
+                    realSpinner = ora({ text }).start();
+                realSpinner.text = String(msg);
+            }
+        }
+    };
+    return self;
+}
+
+export { createSpinnerLike };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.37.1",
+  "version": "1.38.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;AAkBnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AA+Q7B,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;AAkBnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AAoR7B,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/types/extractor/core/extractor.d.ts

@@ -26,11 +26,12 @@ import { ASTVisitors } from './ast-visitors';
  * }
  * ```
  */
-export declare function runExtractor(config: I18nextToolkitConfig, { isWatchMode, isDryRun, syncPrimaryWithDefaults, syncAll }?: {
+export declare function runExtractor(config: I18nextToolkitConfig, options?: {
     isWatchMode?: boolean;
     isDryRun?: boolean;
     syncPrimaryWithDefaults?: boolean;
     syncAll?: boolean;
+    quiet?: boolean;
 }, logger?: Logger): Promise<boolean>;
 /**
  * Processes an individual source file for translation key extraction.

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;AAKtF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,EACE,WAAmB,EACnB,QAAgB,EAChB,uBAA+B,EAC/B,OAAe,EAChB,GAAE;IACD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,EACN,MAAM,GAAE,MAA4B,GACnC,OAAO,CAAC,OAAO,CAAC,CA8DlB;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,GACnC,OAAO,CAAC,IAAI,CAAC,CAiGf;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;AAKtF,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,CAAA;CACX,EACN,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAkElB;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,GACnC,OAAO,CAAC,IAAI,CAAC,CAiGf;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/linter.d.ts

@@ -65,7 +65,9 @@ export declare function runLinter(config: I18nextToolkitConfig): Promise<{
         [k: string]: HardcodedString[];
     };
 }>;
-export declare function runLinterCli(config: I18nextToolkitConfig): Promise<void>;
+export declare function runLinterCli(config: I18nextToolkitConfig, options?: {
+    quiet?: boolean;
+}, logger?: any): Promise<void>;
 /**
  * Represents a found hardcoded string or interpolation parameter error with its location information.
  */

package/types/linter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAqHnD,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE;QAAC;YACT,OAAO,EAAE,MAAM,CAAC;SACjB;KAAC,CAAC;IACH,IAAI,EAAE;QAAC;YACL,OAAO,EAAE,OAAO,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;SAC1C;KAAC,CAAC;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB,CAAA;AAED,eAAO,MAAM,uBAAuB,UAET,CAAA;AAC3B,eAAO,MAAM,6BAA6B,UAAgN,CAAA;AAK1P,qBAAa,MAAO,SAAQ,YAAY,CAAC,cAAc,CAAC;IACtD,OAAO,CAAC,MAAM,CAAsB;gBAEvB,MAAM,EAAE,oBAAoB;IAKzC,SAAS,CAAE,KAAK,EAAE,OAAO;IAanB,GAAG;;;;;;;CA6FV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB;;;;;;GAE5D;AAED,wBAAsB,YAAY,CAAE,MAAM,EAAE,oBAAoB,iBA4B/D;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAqHnD,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE;QAAC;YACT,OAAO,EAAE,MAAM,CAAC;SACjB;KAAC,CAAC;IACH,IAAI,EAAE;QAAC;YACL,OAAO,EAAE,OAAO,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;SAC1C;KAAC,CAAC;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB,CAAA;AAED,eAAO,MAAM,uBAAuB,UAET,CAAA;AAC3B,eAAO,MAAM,6BAA6B,UAAgN,CAAA;AAK1P,qBAAa,MAAO,SAAQ,YAAY,CAAC,cAAc,CAAC;IACtD,OAAO,CAAC,MAAM,CAAsB;gBAEvB,MAAM,EAAE,oBAAoB;IAKzC,SAAS,CAAE,KAAK,EAAE,OAAO;IAanB,GAAG;;;;;;;CA6FV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB;;;;;;GAE5D;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,EACjC,MAAM,CAAC,EAAE,GAAG,iBAiCb;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd"}

package/types/syncer.d.ts

@@ -29,5 +29,7 @@ import type { I18nextToolkitConfig } from './types';
  * await runSyncer(config)
  * ```
  */
-export declare function runSyncer(config: I18nextToolkitConfig): Promise<void>;
+export declare function runSyncer(config: I18nextToolkitConfig, options?: {
+    quiet?: boolean;
+}, logger?: any): Promise<void>;
 //# sourceMappingURL=syncer.d.ts.map

package/types/syncer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncer.d.ts","sourceRoot":"","sources":["../src/syncer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAMnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,iBAmF5D"}
+{"version":3,"file":"syncer.d.ts","sourceRoot":"","sources":["../src/syncer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAMnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,EACjC,MAAM,CAAC,EAAE,GAAG,iBAuFb"}

package/types/types-generator.d.ts

@@ -25,5 +25,7 @@ import type { I18nextToolkitConfig } from './types';
  * await runTypesGenerator(config)
  * ```
  */
-export declare function runTypesGenerator(config: I18nextToolkitConfig): Promise<void>;
+export declare function runTypesGenerator(config: I18nextToolkitConfig, options?: {
+    quiet?: boolean;
+}, logger?: import('./types').Logger): Promise<void>;
 //# sourceMappingURL=types-generator.d.ts.map

package/types/types-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types-generator.d.ts","sourceRoot":"","sources":["../src/types-generator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAsDnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,iBAAiB,CAAE,MAAM,EAAE,oBAAoB,iBAsGpE"}
+{"version":3,"file":"types-generator.d.ts","sourceRoot":"","sources":["../src/types-generator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAsDnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,EACjC,MAAM,CAAC,EAAE,OAAO,SAAS,EAAE,MAAM,iBAyGlC"}

package/types/utils/wrap-ora.d.ts

@@ -0,0 +1,22 @@
+export interface SpinnerLike {
+    text: string;
+    start(): SpinnerLike;
+    succeed(msg?: string): void;
+    fail(msg?: string): void;
+    warn(msg?: string): void;
+    stop(): void;
+    progress?(msg: string): void;
+}
+/**
+ * Creates a spinner-like object that either:
+ * - is fully silent (quiet mode),
+ * - logs only start/succeed/fail events to a logger (no animation),
+ * - or falls back to ora's default spinner.
+ *
+ * This avoids flooding structured loggers with spinner frames and ensures clean output in CI, Vite, etc.
+ */
+export declare function createSpinnerLike(initialText: string, options?: {
+    quiet?: boolean;
+    logger?: any;
+}): SpinnerLike;
+//# sourceMappingURL=wrap-ora.d.ts.map

package/types/utils/wrap-ora.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-ora.d.ts","sourceRoot":"","sources":["../../src/utils/wrap-ora.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,IAAI,WAAW,CAAA;IACpB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,IAAI,IAAI,CAAA;IACZ,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAO,GAC9C,WAAW,CAoEb"}