i18next-cli 1.34.0 → 1.34.1

package/README.md

@@ -1120,7 +1120,7 @@ This programmatic API gives you the same power as the CLI but with full control
 
 A translation management system built around the i18next ecosystem - [locize.com](https://www.locize.com).
 
-![locize](https://cdn.prod.website-files.com/67a323e323a50df7f24f0a6f/67b8bbb29365c3a3c21c0898_github_locize.png)
+![locize](https://www.locize.com/img/ads/github_locize.png)
 
 With using [locize](https://locize.com/?utm_source=i18next_readme&utm_medium=github) you directly support the future of i18next.
 

package/dist/cjs/cli.js

@@ -1,2 +1,272 @@
 #!/usr/bin/env node
-"use strict";var e=require("commander"),o=require("chokidar"),t=require("glob"),n=require("minimatch"),i=require("chalk"),r=require("./config.js"),a=require("./heuristic-config.js"),c=require("./extractor/core/extractor.js");require("react"),require("react-i18next"),require("node:path"),require("node:fs/promises"),require("jiti"),require("@croct/json5-parser");var s=require("./types-generator.js"),l=require("./syncer.js"),u=require("./migrator.js"),d=require("./init.js"),p=require("./linter.js"),g=require("./status.js"),f=require("./locize.js"),y=require("./rename-key.js");const h=new e.Command;h.name("i18next-cli").description("A unified, high-performance i18next CLI.").version("1.34.0"),h.option("-c, --config <path>","Path to i18next-cli config file (overrides detection)"),h.command("extract").description("Extract translation keys from source files and update resource files.").option("-w, --watch","Watch for file changes and re-run the extractor.").option("--ci","Exit with a non-zero status code if any files are updated.").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.").action(async e=>{try{const t=h.opts().config,i=await r.ensureConfig(t),a=async()=>{const o=!!e.syncPrimary||!!e.syncAll,t=await c.runExtractor(i,{isWatchMode:!!e.watch,isDryRun:!!e.dryRun,syncPrimaryWithDefaults:o,syncAll:!!e.syncAll});return e.ci&&!t?(console.log("✅ No files were updated."),process.exit(0)):e.ci&&t&&(console.error("❌ Some files were updated. This should not happen in CI mode."),process.exit(1)),t};if(await a(),e.watch){console.log("\nWatching for changes...");const e=await x(i.extract.input),t=m(i.extract.ignore),r=w(i.extract.output),c=[...t,...r].filter(Boolean),s=e.filter(e=>!c.some(o=>n.minimatch(e,o,{dot:!0})));o.watch(s,{ignored:/node_modules/,persistent:!0}).on("change",e=>{console.log(`\nFile changed: ${e}`),a()})}}catch(e){console.error("Error running extractor:",e),process.exit(1)}}),h.command("status [locale]").description("Display translation status. Provide a locale for a detailed key-by-key view.").option("-n, --namespace <ns>","Filter the status report by a specific namespace").action(async(e,o)=>{const t=h.opts().config;let n=await r.loadConfig(t);if(!n){console.log(i.blue("No config file found. Attempting to detect project structure..."));const e=await a.detectConfig();e||(console.error(i.red("Could not automatically detect your project structure.")),console.log(`Please create a config file first by running: ${i.cyan("npx i18next-cli init")}`),process.exit(1)),console.log(i.green("Project structure detected successfully!")),n=e}await g.runStatus(n,{detail:e,namespace:o.namespace})}),h.command("types").description("Generate TypeScript definitions from translation resource files.").option("-w, --watch","Watch for file changes and re-run the type generator.").action(async e=>{const t=h.opts().config,i=await r.ensureConfig(t),a=()=>s.runTypesGenerator(i);if(await a(),e.watch){console.log("\nWatching for changes...");const e=await x(i.types?.input||[]),t=[...m(i.extract?.ignore)].filter(Boolean),r=e.filter(e=>!t.some(o=>n.minimatch(e,o,{dot:!0})));o.watch(r,{persistent:!0}).on("change",e=>{console.log(`\nFile changed: ${e}`),a()})}}),h.command("sync").description("Synchronize secondary language files with the primary language file.").action(async()=>{const e=h.opts().config,o=await r.ensureConfig(e);await l.runSyncer(o)}),h.command("migrate-config [configPath]").description("Migrate a legacy i18next-parser.config.js to the new format.").action(async e=>{await u.runMigrator(e)}),h.command("init").description("Create a new i18next.config.ts/js file with an interactive setup wizard.").action(d.runInit),h.command("lint").description("Find potential issues like hardcoded strings in your codebase.").option("-w, --watch","Watch for file changes and re-run the linter.").action(async e=>{const t=h.opts().config,c=async()=>{let e=await r.loadConfig(t);if(!e){console.log(i.blue("No config file found. Attempting to detect project structure..."));const o=await a.detectConfig();o||(console.error(i.red("Could not automatically detect your project structure.")),console.log(`Please create a config file first by running: ${i.cyan("npx i18next-cli init")}`),process.exit(1)),console.log(i.green("Project structure detected successfully!")),e=o}await p.runLinterCli(e)};if(await c(),e.watch){console.log("\nWatching for changes...");const e=await r.loadConfig(t);if(e?.extract?.input){const t=await x(e.extract.input),i=[...m(e.extract.ignore),...w(e.extract.output)].filter(Boolean),r=t.filter(e=>!i.some(o=>n.minimatch(e,o,{dot:!0})));o.watch(r,{ignored:/node_modules/,persistent:!0}).on("change",e=>{console.log(`\nFile changed: ${e}`),c()})}}}),h.command("locize-sync").description("Synchronize local translations with your locize project.").option("--update-values","Update values of existing translations on locize.").option("--src-lng-only","Check for changes in source language only.").option("--compare-mtime","Compare modification times when syncing.").option("--dry-run","Run the command without making any changes.").option("--cdn-type <standard|pro>","Specify the cdn endpoint that should be used (depends on which cdn type you've in your locize project)").action(async e=>{const o=h.opts().config,t=await r.ensureConfig(o);await f.runLocizeSync(t,e)}),h.command("locize-download").description("Download all translations from your locize project.").option("--cdn-type <standard|pro>","Specify the cdn endpoint that should be used (depends on which cdn type you've in your locize project)").action(async e=>{const o=h.opts().config,t=await r.ensureConfig(o);await f.runLocizeDownload(t,e)}),h.command("locize-migrate").description("Migrate local translation files to a new locize project.").option("--cdn-type <standard|pro>","Specify the cdn endpoint that should be used (depends on which cdn type you've in your locize project)").action(async e=>{const o=h.opts().config,t=await r.ensureConfig(o);await f.runLocizeMigrate(t,e)}),h.command("rename-key <oldKey> <newKey>").description("Rename a translation key across all source files and translation files.").option("--dry-run","Preview changes without modifying files").action(async(e,o,t)=>{try{const n=h.opts().config,a=await r.ensureConfig(n),c=await y.runRenameKey(a,e,o,t);c.success||(c.conflicts&&(console.error(i.red("\n❌ Conflicts detected:")),c.conflicts.forEach(e=>console.error(`   - ${e}`))),c.error&&console.error(i.red(`\n❌ ${c.error}`)),process.exit(1));0===c.sourceFiles.reduce((e,o)=>e+o.changes,0)&&console.log(i.yellow(`\n⚠️  No usages found for "${e}"`))}catch(e){console.error(i.red("Error renaming key:"),e),process.exit(1)}}),h.parse(process.argv);const m=e=>Array.isArray(e)?e:e?[e]:[],w=e=>e&&"string"==typeof e?[e.replace(/\{\{[^}]+\}\}/g,"*")]:[],x=async(e=[])=>{const o=m(e),n=await Promise.all(o.map(e=>t.glob(e||"",{nodir:!0})));return Array.from(new Set(n.flat()))};exports.program=h;
+'use strict';
+
+var commander = require('commander');
+var chokidar = require('chokidar');
+var glob = require('glob');
+var minimatch = require('minimatch');
+var chalk = require('chalk');
+var config = require('./config.js');
+var heuristicConfig = require('./heuristic-config.js');
+var extractor = require('./extractor/core/extractor.js');
+require('react');
+require('react-i18next');
+require('node:path');
+require('node:fs/promises');
+require('jiti');
+require('@croct/json5-parser');
+var typesGenerator = require('./types-generator.js');
+var syncer = require('./syncer.js');
+var migrator = require('./migrator.js');
+var init = require('./init.js');
+var linter = require('./linter.js');
+var status = require('./status.js');
+var locize = require('./locize.js');
+var renameKey = require('./rename-key.js');
+
+const program = new commander.Command();
+program
+    .name('i18next-cli')
+    .description('A unified, high-performance i18next CLI.')
+    .version('1.34.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
+    .command('extract')
+    .description('Extract translation keys from source files and update resource files.')
+    .option('-w, --watch', 'Watch for file changes and re-run the extractor.')
+    .option('--ci', 'Exit with a non-zero status code if any files are updated.')
+    .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.')
+    .action(async (options) => {
+    try {
+        const cfgPath = program.opts().config;
+        const config$1 = await config.ensureConfig(cfgPath);
+        const runExtract = async () => {
+            // --sync-all implies sync-primary behavior
+            const syncPrimary = !!options.syncPrimary || !!options.syncAll;
+            const success = await extractor.runExtractor(config$1, {
+                isWatchMode: !!options.watch,
+                isDryRun: !!options.dryRun,
+                syncPrimaryWithDefaults: syncPrimary,
+                syncAll: !!options.syncAll
+            });
+            if (options.ci && !success) {
+                console.log('✅ No files were updated.');
+                process.exit(0);
+            }
+            else if (options.ci && success) {
+                console.error('❌ Some files were updated. This should not happen in CI mode.');
+                process.exit(1);
+            }
+            return success;
+        };
+        // Run the extractor once initially
+        await runExtract();
+        // If in watch mode, set up the chokidar watcher
+        if (options.watch) {
+            console.log('\nWatching for changes...');
+            // expand configured input globs (keep original behavior for detection)
+            const expanded = await expandGlobs(config$1.extract.input);
+            // build ignore list (configured + derived from output template)
+            const configuredIgnore = toArray(config$1.extract.ignore);
+            const derivedIgnore = deriveOutputIgnore(config$1.extract.output);
+            const ignoreGlobs = [...configuredIgnore, ...derivedIgnore].filter(Boolean);
+            // filter expanded files by ignore globs
+            const watchFiles = expanded.filter(f => !ignoreGlobs.some(g => minimatch.minimatch(f, g, { dot: true })));
+            const watcher = chokidar.watch(watchFiles, {
+                ignored: /node_modules/,
+                persistent: true,
+            });
+            watcher.on('change', path => {
+                console.log(`\nFile changed: ${path}`);
+                runExtract();
+            });
+        }
+    }
+    catch (error) {
+        console.error('Error running extractor:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('status [locale]')
+    .description('Display translation status. Provide a locale for a detailed key-by-key view.')
+    .option('-n, --namespace <ns>', 'Filter the status report by a specific namespace')
+    .action(async (locale, options) => {
+    const cfgPath = program.opts().config;
+    let config$1 = await config.loadConfig(cfgPath);
+    if (!config$1) {
+        console.log(chalk.blue('No config file found. Attempting to detect project structure...'));
+        const detected = await heuristicConfig.detectConfig();
+        if (!detected) {
+            console.error(chalk.red('Could not automatically detect your project structure.'));
+            console.log(`Please create a config file first by running: ${chalk.cyan('npx i18next-cli init')}`);
+            process.exit(1);
+        }
+        console.log(chalk.green('Project structure detected successfully!'));
+        config$1 = detected;
+    }
+    await status.runStatus(config$1, { detail: locale, namespace: options.namespace });
+});
+program
+    .command('types')
+    .description('Generate TypeScript definitions from translation resource files.')
+    .option('-w, --watch', 'Watch for file changes and re-run the type generator.')
+    .action(async (options) => {
+    const cfgPath = program.opts().config;
+    const config$1 = await config.ensureConfig(cfgPath);
+    const run = () => typesGenerator.runTypesGenerator(config$1);
+    await run();
+    if (options.watch) {
+        console.log('\nWatching for changes...');
+        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 });
+        watcher.on('change', path => {
+            console.log(`\nFile changed: ${path}`);
+            run();
+        });
+    }
+});
+program
+    .command('sync')
+    .description('Synchronize secondary language files with the primary language file.')
+    .action(async () => {
+    const cfgPath = program.opts().config;
+    const config$1 = await config.ensureConfig(cfgPath);
+    await syncer.runSyncer(config$1);
+});
+program
+    .command('migrate-config [configPath]')
+    .description('Migrate a legacy i18next-parser.config.js to the new format.')
+    .action(async (configPath) => {
+    await migrator.runMigrator(configPath);
+});
+program
+    .command('init')
+    .description('Create a new i18next.config.ts/js file with an interactive setup wizard.')
+    .action(init.runInit);
+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.')
+    .action(async (options) => {
+    const cfgPath = program.opts().config;
+    const loadAndRunLinter = async () => {
+        // The existing logic for loading the config or detecting it is now inside this function
+        let config$1 = await config.loadConfig(cfgPath);
+        if (!config$1) {
+            console.log(chalk.blue('No config file found. Attempting to detect project structure...'));
+            const detected = await heuristicConfig.detectConfig();
+            if (!detected) {
+                console.error(chalk.red('Could not automatically detect your project structure.'));
+                console.log(`Please create a config file first by running: ${chalk.cyan('npx i18next-cli init')}`);
+                process.exit(1);
+            }
+            console.log(chalk.green('Project structure detected successfully!'));
+            config$1 = detected;
+        }
+        await linter.runLinterCli(config$1);
+    };
+    // Run the linter once initially
+    await loadAndRunLinter();
+    // If in watch mode, set up the chokidar watcher
+    if (options.watch) {
+        console.log('\nWatching for changes...');
+        // Re-load the config to get the correct input paths for the watcher
+        const config$1 = await config.loadConfig(cfgPath);
+        if (config$1?.extract?.input) {
+            const expandedLint = await expandGlobs(config$1.extract.input);
+            const configuredIgnore2 = toArray(config$1.extract.ignore);
+            const derivedIgnore2 = deriveOutputIgnore(config$1.extract.output);
+            const ignoredLint = [...configuredIgnore2, ...derivedIgnore2].filter(Boolean);
+            const watchLint = expandedLint.filter(f => !ignoredLint.some(g => minimatch.minimatch(f, g, { dot: true })));
+            const watcher = chokidar.watch(watchLint, {
+                ignored: /node_modules/,
+                persistent: true,
+            });
+            watcher.on('change', path => {
+                console.log(`\nFile changed: ${path}`);
+                loadAndRunLinter(); // Re-run on change
+            });
+        }
+    }
+});
+program
+    .command('locize-sync')
+    .description('Synchronize local translations with your locize project.')
+    .option('--update-values', 'Update values of existing translations on locize.')
+    .option('--src-lng-only', 'Check for changes in source language only.')
+    .option('--compare-mtime', 'Compare modification times when syncing.')
+    .option('--dry-run', 'Run the command without making any changes.')
+    .option('--cdn-type <standard|pro>', 'Specify the cdn endpoint that should be used (depends on which cdn type you\'ve in your locize project)')
+    .action(async (options) => {
+    const cfgPath = program.opts().config;
+    const config$1 = await config.ensureConfig(cfgPath);
+    await locize.runLocizeSync(config$1, options);
+});
+program
+    .command('locize-download')
+    .description('Download all translations from your locize project.')
+    .option('--cdn-type <standard|pro>', 'Specify the cdn endpoint that should be used (depends on which cdn type you\'ve in your locize project)')
+    .action(async (options) => {
+    const cfgPath = program.opts().config;
+    const config$1 = await config.ensureConfig(cfgPath);
+    await locize.runLocizeDownload(config$1, options);
+});
+program
+    .command('locize-migrate')
+    .description('Migrate local translation files to a new locize project.')
+    .option('--cdn-type <standard|pro>', 'Specify the cdn endpoint that should be used (depends on which cdn type you\'ve in your locize project)')
+    .action(async (options) => {
+    const cfgPath = program.opts().config;
+    const config$1 = await config.ensureConfig(cfgPath);
+    await locize.runLocizeMigrate(config$1, options);
+});
+program
+    .command('rename-key <oldKey> <newKey>')
+    .description('Rename a translation key across all source files and translation files.')
+    .option('--dry-run', 'Preview changes without modifying files')
+    .action(async (oldKey, newKey, options) => {
+    try {
+        const cfgPath = program.opts().config;
+        const config$1 = await config.ensureConfig(cfgPath);
+        const result = await renameKey.runRenameKey(config$1, oldKey, newKey, options);
+        if (!result.success) {
+            if (result.conflicts) {
+                console.error(chalk.red('\n❌ Conflicts detected:'));
+                result.conflicts.forEach(c => console.error(`   - ${c}`));
+            }
+            if (result.error) {
+                console.error(chalk.red(`\n❌ ${result.error}`));
+            }
+            process.exit(1);
+        }
+        const totalChanges = result.sourceFiles.reduce((sum, f) => sum + f.changes, 0);
+        if (totalChanges === 0) {
+            console.log(chalk.yellow(`\n⚠️  No usages found for "${oldKey}"`));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error renaming key:'), error);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+const toArray = (v) => Array.isArray(v) ? v : (v ? [v] : []);
+const deriveOutputIgnore = (output) => {
+    if (!output || typeof output !== 'string')
+        return [];
+    return [output.replace(/\{\{[^}]+\}\}/g, '*')];
+};
+// helper to expand one or many glob patterns
+const expandGlobs = async (patterns = []) => {
+    const arr = toArray(patterns);
+    const sets = await Promise.all(arr.map(p => glob.glob(p || '', { nodir: true })));
+    return Array.from(new Set(sets.flat()));
+};
+
+exports.program = program;

package/dist/cjs/config.js

@@ -1 +1,211 @@
-"use strict";var e=require("node:path"),r=require("node:url"),t=require("node:fs/promises"),n=require("jiti"),o=require("jsonc-parser"),i=require("inquirer"),a=require("chalk"),s=require("./init.js"),c=require("./utils/logger.js");const u=["i18next.config.ts","i18next.config.js","i18next.config.mjs","i18next.config.cjs"];async function l(o,i=new c.ConsoleLogger){const a=await async function(r){if(r){const n=e.resolve(process.cwd(),r);try{return await t.access(n),n}catch{return null}}for(const r of u){const n=e.resolve(process.cwd(),r);try{return await t.access(n),n}catch{}}return null}(o);if(!a)return o&&i.error(`Error: Config file not found at "${o}"`),null;try{let e;if(a.endsWith(".ts")){const r=await f(),t=n.createJiti(process.cwd(),{alias:r,interopDefault:!1}),o=await t.import(a,{default:!0});e=o}else{const t=r.pathToFileURL(a).href,n=await import(`${t}?t=${Date.now()}`);e=n.default}return e?(e.extract||={},e.extract.primaryLanguage||=e.locales[0]||"en",e.extract.secondaryLanguages||=e.locales.filter(r=>r!==e.extract.primaryLanguage),e):(i.error(`Error: No default export found in ${a}`),null)}catch(e){return i.error(`Error loading configuration from ${a}`),i.error(e),null}}async function f(){try{const r=await async function(){let r=process.cwd();for(;;){const n=e.join(r,"tsconfig.json");try{return await t.access(n),n}catch{const t=e.dirname(r);if(t===r)return null;r=t}}}();if(!r)return{};const n=await t.readFile(r,"utf-8"),i=o.parse(n),a=i.compilerOptions?.paths,s=i.compilerOptions?.baseUrl||".";if(!a)return{};const c={};for(const[r,t]of Object.entries(a))if(Array.isArray(t)&&t.length>0){const n=r.replace("/*",""),o=e.resolve(process.cwd(),s,t[0].replace("/*",""));c[n]=o}return c}catch(e){return{}}}exports.defineConfig=function(e){return e},exports.ensureConfig=async function(e,r=new c.ConsoleLogger){let t=await l(e,r);if(t)return t;const{shouldInit:n}=await i.prompt([{type:"confirm",name:"shouldInit",message:a.yellow("Configuration file not found. Would you like to create one now?"),default:!0}]);if(n){if(await s.runInit(),r.info(a.green("Configuration created. Resuming command...")),t=await l(e,r),t)return t;r.error(a.red("Error: Failed to load configuration after creation. Please try running the command again.")),process.exit(1)}else r.info("Operation cancelled. Please create a configuration file to proceed."),process.exit(0)},exports.getTsConfigAliases=f,exports.loadConfig=l;
+'use strict';
+
+var node_path = require('node:path');
+var node_url = require('node:url');
+var promises = require('node:fs/promises');
+var jiti = require('jiti');
+var jsoncParser = require('jsonc-parser');
+var inquirer = require('inquirer');
+var chalk = require('chalk');
+var init = require('./init.js');
+var logger = require('./utils/logger.js');
+
+/**
+ * List of supported configuration file names in order of precedence
+ */
+const CONFIG_FILES = [
+    'i18next.config.ts',
+    'i18next.config.js',
+    'i18next.config.mjs',
+    'i18next.config.cjs',
+];
+/**
+ * A helper function for defining the i18next-cli config with type-safety.
+ *
+ * @param config - The configuration object to define
+ * @returns The same configuration object with type safety
+ *
+ * @example
+ * ```typescript
+ * export default defineConfig({
+ *   locales: ['en', 'de'],
+ *   extract: {
+ *     input: 'src',
+ *     output: 'locales/{{language}}/{{namespace}}.json'
+ *   }
+ * })
+ * ```
+ */
+function defineConfig(config) {
+    return config;
+}
+/**
+ * Helper function to find the first existing config file in the current working directory.
+ * Searches for files in the order defined by CONFIG_FILES.
+ *
+ * @returns Promise that resolves to the full path of the found config file, or null if none found
+ */
+async function findConfigFile(configPath) {
+    if (configPath) {
+        // Allow relative or absolute path provided by the user
+        const resolved = node_path.resolve(process.cwd(), configPath);
+        try {
+            await promises.access(resolved);
+            return resolved;
+        }
+        catch {
+            return null;
+        }
+    }
+    for (const file of CONFIG_FILES) {
+        const fullPath = node_path.resolve(process.cwd(), file);
+        try {
+            await promises.access(fullPath);
+            return fullPath;
+        }
+        catch {
+            // File doesn't exist, continue to the next one
+        }
+    }
+    return null;
+}
+/**
+ * Loads and validates the i18next toolkit configuration from the project root or a provided path.
+ *
+ * @param configPath - Optional explicit path to a config file (relative to cwd or absolute)
+ * @param logger - Optional logger instance
+ */
+async function loadConfig(configPath, logger$1 = new logger.ConsoleLogger()) {
+    const configPathFound = await findConfigFile(configPath);
+    if (!configPathFound) {
+        if (configPath) {
+            logger$1.error(`Error: Config file not found at "${configPath}"`);
+        }
+        // QUIETLY RETURN NULL: The caller will handle the "not found" case.
+        return null;
+    }
+    try {
+        let config;
+        // Use jiti for TypeScript files, native import for JavaScript
+        if (configPathFound.endsWith('.ts')) {
+            const aliases = await getTsConfigAliases();
+            const jiti$1 = jiti.createJiti(process.cwd(), {
+                alias: aliases,
+                interopDefault: false,
+            });
+            const configModule = await jiti$1.import(configPathFound, { default: true });
+            config = configModule;
+        }
+        else {
+            const configUrl = node_url.pathToFileURL(configPathFound).href;
+            const configModule = await import(`${configUrl}?t=${Date.now()}`);
+            config = configModule.default;
+        }
+        if (!config) {
+            logger$1.error(`Error: No default export found in ${configPathFound}`);
+            return null;
+        }
+        // Set default sync options
+        config.extract ||= {};
+        config.extract.primaryLanguage ||= config.locales[0] || 'en';
+        config.extract.secondaryLanguages ||= config.locales.filter((l) => l !== config.extract.primaryLanguage);
+        return config;
+    }
+    catch (error) {
+        logger$1.error(`Error loading configuration from ${configPathFound}`);
+        logger$1.error(error);
+        return null;
+    }
+}
+/**
+ * Ensures a configuration exists, prompting the user to create one if necessary.
+ * Accepts an optional configPath which will be used when loading the config.
+ */
+async function ensureConfig(configPath, logger$1 = new logger.ConsoleLogger()) {
+    let config = await loadConfig(configPath, logger$1);
+    if (config) {
+        return config;
+    }
+    // No config found, so we prompt the user.
+    const { shouldInit } = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'shouldInit',
+            message: chalk.yellow('Configuration file not found. Would you like to create one now?'),
+            default: true,
+        }]);
+    if (shouldInit) {
+        await init.runInit(); // Run the interactive setup wizard (keeps existing behavior)
+        logger$1.info(chalk.green('Configuration created. Resuming command...'));
+        config = await loadConfig(configPath, logger$1); // Try loading the newly created config
+        if (config) {
+            return config;
+        }
+        else {
+            logger$1.error(chalk.red('Error: Failed to load configuration after creation. Please try running the command again.'));
+            process.exit(1);
+        }
+    }
+    else {
+        logger$1.info('Operation cancelled. Please create a configuration file to proceed.');
+        process.exit(0);
+    }
+}
+/**
+ * Searches upwards from the current directory to find the tsconfig.json file.
+ * @returns The full path to the tsconfig.json file, or null if not found.
+ */
+async function findTsConfigFile() {
+    let currentDir = process.cwd();
+    while (true) {
+        const tsConfigPath = node_path.join(currentDir, 'tsconfig.json');
+        try {
+            await promises.access(tsConfigPath);
+            return tsConfigPath;
+        }
+        catch {
+            // File not found, move to parent directory
+            const parentDir = node_path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                // Reached the root of the file system
+                return null;
+            }
+            currentDir = parentDir;
+        }
+    }
+}
+/**
+ * Parses the project's tsconfig.json to extract path aliases for jiti.
+ * @returns A record of aliases for jiti's configuration.
+ */
+async function getTsConfigAliases() {
+    try {
+        const tsConfigPath = await findTsConfigFile();
+        if (!tsConfigPath)
+            return {};
+        const tsConfigStr = await promises.readFile(tsConfigPath, 'utf-8');
+        const tsConfig = jsoncParser.parse(tsConfigStr);
+        const paths = tsConfig.compilerOptions?.paths;
+        const baseUrl = tsConfig.compilerOptions?.baseUrl || '.';
+        if (!paths)
+            return {};
+        const aliases = {};
+        for (const [alias, aliasPaths] of Object.entries(paths)) {
+            if (Array.isArray(aliasPaths) && aliasPaths.length > 0) {
+                // Convert "@/*": ["./src/*"] to "@": "./src"
+                const key = alias.replace('/*', '');
+                const value = node_path.resolve(process.cwd(), baseUrl, aliasPaths[0].replace('/*', ''));
+                aliases[key] = value;
+            }
+        }
+        return aliases;
+    }
+    catch (e) {
+        // Return empty if tsconfig doesn't exist or fails to parse
+        return {};
+    }
+}
+
+exports.defineConfig = defineConfig;
+exports.ensureConfig = ensureConfig;
+exports.getTsConfigAliases = getTsConfigAliases;
+exports.loadConfig = loadConfig;