i18next-cli 1.34.0 → 1.34.1

package/dist/esm/cli.js

@@ -1,2 +1,270 @@
 #!/usr/bin/env node
-import{Command as o}from"commander";import e from"chokidar";import{glob as t}from"glob";import{minimatch as n}from"minimatch";import i from"chalk";import{ensureConfig as r,loadConfig as a}from"./config.js";import{detectConfig as c}from"./heuristic-config.js";import{runExtractor as s}from"./extractor/core/extractor.js";import"react";import"react-i18next";import"node:path";import"node:fs/promises";import"jiti";import"@croct/json5-parser";import{runTypesGenerator as l}from"./types-generator.js";import{runSyncer as p}from"./syncer.js";import{runMigrator as d}from"./migrator.js";import{runInit as f}from"./init.js";import{runLinterCli as m}from"./linter.js";import{runStatus as u}from"./status.js";import{runLocizeSync as y,runLocizeDownload as g,runLocizeMigrate as h}from"./locize.js";import{runRenameKey as w}from"./rename-key.js";const x=new o;x.name("i18next-cli").description("A unified, high-performance i18next CLI.").version("1.34.0"),x.option("-c, --config <path>","Path to i18next-cli config file (overrides detection)"),x.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 o=>{try{const t=x.opts().config,i=await r(t),a=async()=>{const e=!!o.syncPrimary||!!o.syncAll,t=await s(i,{isWatchMode:!!o.watch,isDryRun:!!o.dryRun,syncPrimaryWithDefaults:e,syncAll:!!o.syncAll});return o.ci&&!t?(console.log("✅ No files were updated."),process.exit(0)):o.ci&&t&&(console.error("❌ Some files were updated. This should not happen in CI mode."),process.exit(1)),t};if(await a(),o.watch){console.log("\nWatching for changes...");const o=await z(i.extract.input),t=j(i.extract.ignore),r=v(i.extract.output),c=[...t,...r].filter(Boolean),s=o.filter(o=>!c.some(e=>n(o,e,{dot:!0})));e.watch(s,{ignored:/node_modules/,persistent:!0}).on("change",o=>{console.log(`\nFile changed: ${o}`),a()})}}catch(o){console.error("Error running extractor:",o),process.exit(1)}}),x.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(o,e)=>{const t=x.opts().config;let n=await a(t);if(!n){console.log(i.blue("No config file found. Attempting to detect project structure..."));const o=await c();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!")),n=o}await u(n,{detail:o,namespace:e.namespace})}),x.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 o=>{const t=x.opts().config,i=await r(t),a=()=>l(i);if(await a(),o.watch){console.log("\nWatching for changes...");const o=await z(i.types?.input||[]),t=[...j(i.extract?.ignore)].filter(Boolean),r=o.filter(o=>!t.some(e=>n(o,e,{dot:!0})));e.watch(r,{persistent:!0}).on("change",o=>{console.log(`\nFile changed: ${o}`),a()})}}),x.command("sync").description("Synchronize secondary language files with the primary language file.").action(async()=>{const o=x.opts().config,e=await r(o);await p(e)}),x.command("migrate-config [configPath]").description("Migrate a legacy i18next-parser.config.js to the new format.").action(async o=>{await d(o)}),x.command("init").description("Create a new i18next.config.ts/js file with an interactive setup wizard.").action(f),x.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 o=>{const t=x.opts().config,r=async()=>{let o=await a(t);if(!o){console.log(i.blue("No config file found. Attempting to detect project structure..."));const e=await c();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!")),o=e}await m(o)};if(await r(),o.watch){console.log("\nWatching for changes...");const o=await a(t);if(o?.extract?.input){const t=await z(o.extract.input),i=[...j(o.extract.ignore),...v(o.extract.output)].filter(Boolean),a=t.filter(o=>!i.some(e=>n(o,e,{dot:!0})));e.watch(a,{ignored:/node_modules/,persistent:!0}).on("change",o=>{console.log(`\nFile changed: ${o}`),r()})}}}),x.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 o=>{const e=x.opts().config,t=await r(e);await y(t,o)}),x.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 o=>{const e=x.opts().config,t=await r(e);await g(t,o)}),x.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 o=>{const e=x.opts().config,t=await r(e);await h(t,o)}),x.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(o,e,t)=>{try{const n=x.opts().config,a=await r(n),c=await w(a,o,e,t);c.success||(c.conflicts&&(console.error(i.red("\n❌ Conflicts detected:")),c.conflicts.forEach(o=>console.error(`   - ${o}`))),c.error&&console.error(i.red(`\n❌ ${c.error}`)),process.exit(1));0===c.sourceFiles.reduce((o,e)=>o+e.changes,0)&&console.log(i.yellow(`\n⚠️  No usages found for "${o}"`))}catch(o){console.error(i.red("Error renaming key:"),o),process.exit(1)}}),x.parse(process.argv);const j=o=>Array.isArray(o)?o:o?[o]:[],v=o=>o&&"string"==typeof o?[o.replace(/\{\{[^}]+\}\}/g,"*")]:[],z=async(o=[])=>{const e=j(o),n=await Promise.all(e.map(o=>t(o||"",{nodir:!0})));return Array.from(new Set(n.flat()))};export{x as program};
+import { Command } from 'commander';
+import chokidar from 'chokidar';
+import { glob } from 'glob';
+import { minimatch } from 'minimatch';
+import chalk from 'chalk';
+import { ensureConfig, loadConfig } from './config.js';
+import { detectConfig } from './heuristic-config.js';
+import { runExtractor } from './extractor/core/extractor.js';
+import 'react';
+import 'react-i18next';
+import 'node:path';
+import 'node:fs/promises';
+import 'jiti';
+import '@croct/json5-parser';
+import { runTypesGenerator } from './types-generator.js';
+import { runSyncer } from './syncer.js';
+import { runMigrator } from './migrator.js';
+import { runInit } from './init.js';
+import { runLinterCli } from './linter.js';
+import { runStatus } from './status.js';
+import { runLocizeSync, runLocizeDownload, runLocizeMigrate } from './locize.js';
+import { runRenameKey } from './rename-key.js';
+
+const program = new 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 = await ensureConfig(cfgPath);
+        const runExtract = async () => {
+            // --sync-all implies sync-primary behavior
+            const syncPrimary = !!options.syncPrimary || !!options.syncAll;
+            const success = await runExtractor(config, {
+                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.extract.input);
+            // build ignore list (configured + derived from output template)
+            const configuredIgnore = toArray(config.extract.ignore);
+            const derivedIgnore = deriveOutputIgnore(config.extract.output);
+            const ignoreGlobs = [...configuredIgnore, ...derivedIgnore].filter(Boolean);
+            // filter expanded files by ignore globs
+            const watchFiles = expanded.filter(f => !ignoreGlobs.some(g => 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 = await loadConfig(cfgPath);
+    if (!config) {
+        console.log(chalk.blue('No config file found. Attempting to detect project structure...'));
+        const detected = await 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 = detected;
+    }
+    await runStatus(config, { 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 = await ensureConfig(cfgPath);
+    const run = () => runTypesGenerator(config);
+    await run();
+    if (options.watch) {
+        console.log('\nWatching for changes...');
+        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 });
+        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 = await ensureConfig(cfgPath);
+    await runSyncer(config);
+});
+program
+    .command('migrate-config [configPath]')
+    .description('Migrate a legacy i18next-parser.config.js to the new format.')
+    .action(async (configPath) => {
+    await runMigrator(configPath);
+});
+program
+    .command('init')
+    .description('Create a new i18next.config.ts/js file with an interactive setup wizard.')
+    .action(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 = await loadConfig(cfgPath);
+        if (!config) {
+            console.log(chalk.blue('No config file found. Attempting to detect project structure...'));
+            const detected = await 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 = detected;
+        }
+        await runLinterCli(config);
+    };
+    // 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 = await loadConfig(cfgPath);
+        if (config?.extract?.input) {
+            const expandedLint = await expandGlobs(config.extract.input);
+            const configuredIgnore2 = toArray(config.extract.ignore);
+            const derivedIgnore2 = deriveOutputIgnore(config.extract.output);
+            const ignoredLint = [...configuredIgnore2, ...derivedIgnore2].filter(Boolean);
+            const watchLint = expandedLint.filter(f => !ignoredLint.some(g => 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 = await ensureConfig(cfgPath);
+    await runLocizeSync(config, 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 = await ensureConfig(cfgPath);
+    await runLocizeDownload(config, 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 = await ensureConfig(cfgPath);
+    await runLocizeMigrate(config, 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 = await ensureConfig(cfgPath);
+        const result = await runRenameKey(config, 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(p || '', { nodir: true })));
+    return Array.from(new Set(sets.flat()));
+};
+
+export { program };

package/dist/esm/config.js

@@ -1 +1,206 @@
-import{resolve as r,join as t,dirname as o}from"node:path";import{pathToFileURL as n}from"node:url";import{access as e,readFile as i}from"node:fs/promises";import{createJiti as a}from"jiti";import{parse as c}from"jsonc-parser";import s from"inquirer";import f from"chalk";import{runInit as l}from"./init.js";import{ConsoleLogger as u}from"./utils/logger.js";const p=["i18next.config.ts","i18next.config.js","i18next.config.mjs","i18next.config.cjs"];function m(r){return r}async function d(t,o=new u){const i=await async function(t){if(t){const o=r(process.cwd(),t);try{return await e(o),o}catch{return null}}for(const t of p){const o=r(process.cwd(),t);try{return await e(o),o}catch{}}return null}(t);if(!i)return t&&o.error(`Error: Config file not found at "${t}"`),null;try{let r;if(i.endsWith(".ts")){const t=await w(),o=a(process.cwd(),{alias:t,interopDefault:!1}),n=await o.import(i,{default:!0});r=n}else{const t=n(i).href,o=await import(`${t}?t=${Date.now()}`);r=o.default}return r?(r.extract||={},r.extract.primaryLanguage||=r.locales[0]||"en",r.extract.secondaryLanguages||=r.locales.filter(t=>t!==r.extract.primaryLanguage),r):(o.error(`Error: No default export found in ${i}`),null)}catch(r){return o.error(`Error loading configuration from ${i}`),o.error(r),null}}async function g(r,t=new u){let o=await d(r,t);if(o)return o;const{shouldInit:n}=await s.prompt([{type:"confirm",name:"shouldInit",message:f.yellow("Configuration file not found. Would you like to create one now?"),default:!0}]);if(n){if(await l(),t.info(f.green("Configuration created. Resuming command...")),o=await d(r,t),o)return o;t.error(f.red("Error: Failed to load configuration after creation. Please try running the command again.")),process.exit(1)}else t.info("Operation cancelled. Please create a configuration file to proceed."),process.exit(0)}async function w(){try{const n=await async function(){let r=process.cwd();for(;;){const n=t(r,"tsconfig.json");try{return await e(n),n}catch{const t=o(r);if(t===r)return null;r=t}}}();if(!n)return{};const a=await i(n,"utf-8"),s=c(a),f=s.compilerOptions?.paths,l=s.compilerOptions?.baseUrl||".";if(!f)return{};const u={};for(const[t,o]of Object.entries(f))if(Array.isArray(o)&&o.length>0){const n=t.replace("/*",""),e=r(process.cwd(),l,o[0].replace("/*",""));u[n]=e}return u}catch(r){return{}}}export{m as defineConfig,g as ensureConfig,w as getTsConfigAliases,d as loadConfig};
+import { resolve, join, dirname } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { access, readFile } from 'node:fs/promises';
+import { createJiti } from 'jiti';
+import { parse } from 'jsonc-parser';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { runInit } from './init.js';
+import { ConsoleLogger } from './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 = resolve(process.cwd(), configPath);
+        try {
+            await access(resolved);
+            return resolved;
+        }
+        catch {
+            return null;
+        }
+    }
+    for (const file of CONFIG_FILES) {
+        const fullPath = resolve(process.cwd(), file);
+        try {
+            await 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 = new ConsoleLogger()) {
+    const configPathFound = await findConfigFile(configPath);
+    if (!configPathFound) {
+        if (configPath) {
+            logger.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 = createJiti(process.cwd(), {
+                alias: aliases,
+                interopDefault: false,
+            });
+            const configModule = await jiti.import(configPathFound, { default: true });
+            config = configModule;
+        }
+        else {
+            const configUrl = pathToFileURL(configPathFound).href;
+            const configModule = await import(`${configUrl}?t=${Date.now()}`);
+            config = configModule.default;
+        }
+        if (!config) {
+            logger.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.error(`Error loading configuration from ${configPathFound}`);
+        logger.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 = new ConsoleLogger()) {
+    let config = await loadConfig(configPath, logger);
+    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 runInit(); // Run the interactive setup wizard (keeps existing behavior)
+        logger.info(chalk.green('Configuration created. Resuming command...'));
+        config = await loadConfig(configPath, logger); // Try loading the newly created config
+        if (config) {
+            return config;
+        }
+        else {
+            logger.error(chalk.red('Error: Failed to load configuration after creation. Please try running the command again.'));
+            process.exit(1);
+        }
+    }
+    else {
+        logger.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 = join(currentDir, 'tsconfig.json');
+        try {
+            await access(tsConfigPath);
+            return tsConfigPath;
+        }
+        catch {
+            // File not found, move to parent directory
+            const parentDir = 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 readFile(tsConfigPath, 'utf-8');
+        const tsConfig = 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 = 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 {};
+    }
+}
+
+export { defineConfig, ensureConfig, getTsConfigAliases, loadConfig };