i18ntk 4.5.3 → 4.6.0

package/main/i18ntk-scanner.js

@@ -22,6 +22,7 @@ const { getUnifiedConfig, displayHelp } = require('../utils/config-helper');
 const { loadTranslations } = require('../utils/i18n-helper');
 const SecurityUtils = require('../utils/security');
 const SetupEnforcer = require('../utils/setup-enforcer');
+const { detectProjectFramework, getFrameworkPatterns, getFrameworkSuggestions, SCANNER_EXTENSIONS, WRAPPER_SKIP_PATTERNS, getExcludeDirs } = require('../utils/framework-detector');
 
 // Ensure setup is complete before running
 (async () => {
@@ -133,6 +134,8 @@ class I18nTextScanner {
 
         switch (key) {
           case 'source-dir':
+          case 'code-dir':
+          case 'source-code-dir':
             parsed.sourceDir = value || '';
             if (value === args[i + 1]) i++;
             break;
@@ -167,6 +170,7 @@ class I18nTextScanner {
             parsed.includeTests = true;
             break;
           case 'source-language':
+          case 'source-locale':
             parsed.sourceLanguage = value || '';
             if (value === args[i + 1]) i++;
             break;
@@ -222,11 +226,26 @@ class I18nTextScanner {
       const packageJson = SecurityUtils.safeParseJSON(packageJsonContent);
       const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
 
+      if (deps.next || deps['next-intl'] || deps['next-i18next']) return 'next';
       if (deps.react || deps['react-dom']) return 'react';
       if (deps.vue || deps['vue-router']) return 'vue';
       if (deps['@angular/core'] || deps.angular) return 'angular';
-      if (deps.next) return 'next';
       if (deps.svelte) return 'svelte';
+      if (deps.astro || deps['astro-i18next'] || deps['@astrojs/i18n']) return 'astro';
+      if (deps['@remix-run/react'] || deps['remix-i18next']) return 'remix';
+      if (deps.gatsby || deps['gatsby-plugin-react-i18next']) return 'gatsby';
+      if (deps['@builder.io/qwik'] || deps['qwik-speak']) return 'qwik';
+      if (deps['solid-js'] || deps['@solid-primitives/i18n']) return 'solid';
+      if (deps['ember-source'] || deps['ember-intl']) return 'ember';
+      if (deps.nuxt || deps['@nuxtjs/i18n']) return 'nuxt';
+
+      // Check for Rust project
+      const cargoTomlPath = path.join(projectRoot, 'Cargo.toml');
+      if (SecurityUtils.safeExistsSync(cargoTomlPath, projectRoot)) return 'rust';
+
+      // Check for Go project
+      const goModPath = path.join(projectRoot, 'go.mod');
+      if (SecurityUtils.safeExistsSync(goModPath, projectRoot)) return 'go';
 
       return 'vanilla';
     } catch (error) {
@@ -252,57 +271,110 @@ class I18nTextScanner {
 
     const frameworkSpecific = {
       react: [
-        // React specific patterns - enhanced for i18next detection
         /children:\s*["']([^"']{2,99})["']/g,
         /dangerouslySetInnerHTML={{\s*__html:\s*["']([^"']{2,99})["']/g,
-        // JSX text content without translation
         />([^<{][^<>{]*[^}>])</g,
-        // Button text
         /<button[^>]*>([^<]{2,99})<\/button>/g,
-        // Span text
-        /<span[^>]*>([^<]{2,99})<\/span>/g
+        /<span[^>]*>([^<]{2,99})<\/span>/g,
+        /<(?:FormattedMessage|Trans)[\s\S]*?\b(?:id|defaultMessage|i18nKey)\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g,
+        /<(?:FormattedMessage|Trans)[\s\S]*?\b(?:id|defaultMessage|i18nKey)\s*=\s*\{[']\s*([^'}]+\.[^'}]+)\s*[']/g
       ],
       vue: [
-        // Vue specific patterns - enhanced for vue-i18n detection
         /v-text=["']([^"']{2,99})["']/g,
         /v-html=["']([^"']{2,99})["']/g,
-        // Vue template text
         />([^<{][^<>{]*[^}>])</g,
-        // Button text
         /<button[^>]*>([^<]{2,99})<\/button>/g,
-        // Span text
-        /<span[^>]*>([^<]{2,99})<\/span>/g
+        /<span[^>]*>([^<]{2,99})<\/span>/g,
+        /\$t\(["']([^"']{2,99})["']\)/g,
+        /v-t=["']([^"']{2,99})["']/g
       ],
       angular: [
-        // Angular specific patterns - enhanced for ngx-translate detection
         /\[innerHTML\]=["']([^"']{2,99})["']/g,
         /\[textContent\]=["']([^"']{2,99})["']/g,
-        // Angular template text
         />([^<{][^<>{]*[^}>])</g,
-        // Button text
         /<button[^>]*>([^<]{2,99})<\/button>/g,
-        // Span text
-        /<span[^>]*>([^<]{2,99})<\/span>/g
+        /<span[^>]*>([^<]{2,99})<\/span>/g,
+        /i18n=["']([^"']{2,99})["']/g,
+        /\[attr\.title\]=["']([^"']{2,99})["']/g
+      ],
+      next: [
+        /children:\s*["']([^"']{2,99})["']/g,
+        />([^<{][^<>{]*[^}>])</g,
+        /<button[^>]*>([^<]{2,99})<\/button>/g,
+        /<(?:FormattedMessage|Trans)[\s\S]*?\b(?:id|defaultMessage|i18nKey)\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g
+      ],
+      svelte: [
+        />([^<{][^<>{]*[^}>])</g,
+        /<button[^>]*>([^<]{2,99})<\/button>/g,
+        /\$_\(["']([^"']{2,99})["']\)/g,
+        /t\.set\(["']([^"']{2,99})["']/g,
+        /\{#if[^}]*\}([^<]{2,99})\{\/if\}/g
+      ],
+      astro: [
+        />([^<{][^<>{]*[^}>])</g,
+        /<button[^>]*>([^<]{2,99})<\/button>/g,
+        /t\(["']([^"']{2,99})["']\)/g
+      ],
+      remix: [
+        /children:\s*["']([^"']{2,99})["']/g,
+        />([^<{][^<>{]*[^}>])</g,
+        /<button[^>]*>([^<]{2,99})<\/button>/g,
+        /<(?:FormattedMessage|Trans)[\s\S]*?\b(?:id|defaultMessage|i18nKey)\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g
+      ],
+      qwik: [
+        />([^<{][^<>{]*[^}>])</g,
+        /<button[^>]*>([^<]{2,99})<\/button>/g,
+        /t\(["']([^"']{2,99})["']\)/g,
+        /useTranslate\(\)/g
+      ],
+      solid: [
+        />([^<{][^<>{]*[^}>])</g,
+        /<button[^>]*>([^<]{2,99})<\/button>/g,
+        /t\(["']([^"']{2,99})["']\)/g,
+        /useI18n\(\)\.t\(["']([^"']{2,99})["']\)/g
+      ],
+      ember: [
+        />([^<{][^<>{]*[^}>])</g,
+        /\{\{t\s+["']([^"']{2,99})["']\s*\}\}/g,
+        /\{\{intl\.t\s+["']([^"']{2,99})["']\s*\}\}/g
+      ],
+      gatsby: [
+        /children:\s*["']([^"']{2,99})["']/g,
+        />([^<{][^<>{]*[^}>])</g,
+        /<(?:Trans)[\s\S]*?\bi18nKey\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g
       ],
       django: [
-        // Django template patterns
         /\{\%\s*trans\s+["']([^"']{2,99})["']\s*%\}/g,
         /\{\%\s*blocktrans\s*%\}([^%]{2,99})\{\%\s*endblocktrans\s*%\}/g,
         /{{\s*_["']([^"']{2,99})["']\s*}}/g,
         /{{\s*gettext\(["']([^"']{2,99})["']\)\s*}}/g
       ],
       flask: [
-        // Flask/Jinja2 template patterns
         /\{\{\s*_["']([^"']{2,99})["']\s*}}/g,
         /\{\{\s*gettext\(["']([^"']{2,99})["']\)\s*}}/g,
         /\{\{\s*lazy_gettext\(["']([^"']{2,99})["']\)\s*}}/g
       ],
       python: [
-        // Python source patterns
         /gettext\(["']([^"']{2,99})["']\)/g,
         /_\(["']([^"']{2,99})["']\)/g,
         /gettext_lazy\(["']([^"']{2,99})["']\)/g,
         /lazy_gettext\(["']([^"']{2,99})["']\)/g
+      ],
+      rust: [
+        /bundle\.get_message\(\s*["']([^"']{2,99})["']\)/g,
+        /\.get_message\s*\(\s*["']([^"']{2,99})["']\)/g,
+        /ts!\s*\(\s*["']([^"']{2,99})["']/g,
+        /fluent!\s*\(\s*["']([^"']{2,99})["']/g
+      ],
+      go: [
+        /i18n\.Translate\([^,]+,\s*["']([^"']{2,99})["']\)/g,
+        /i18n\.NewMessage\([^,]+,\s*["']([^"']{2,99})["']\)/g,
+        /t\.Get\([^,]+,\s*["']([^"']{2,99})["']\)/g
+      ],
+      vanilla: [
+        /t\(["']([^"']{2,99})["']\)/g,
+        /i18n\.t\(["']([^"']{2,99})["']\)/g,
+        /translate\(["']([^"']{2,99})["']\)/g
       ]
     };
 
@@ -515,7 +587,7 @@ class I18nTextScanner {
       key: `ui.${key}`,
       original: text,
       translationKey: `t('ui.${key}')`,
-      frameworkSpecific: this.getFrameworkSpecific(text)
+      frameworkSpecific: getFrameworkSuggestions(this.framework, text)
     };
   }
 
@@ -523,16 +595,51 @@ class I18nTextScanner {
     const frameworks = {
       react: {
         hook: `const { t } = useTranslation();`,
-        usage: `{t('ui.${text.toLowerCase().replace(/[^a-z0-9\s]/g, '').replace(/\s+/g, '_')}')}`,
-        component: `<Trans i18nKey="ui.${text.toLowerCase().replace(/[^a-z0-9\s]/g, '').replace(/\s+/g, '_')}">${text}</Trans>`
+        usage: `{t('ui.${this._keySnippet(text)}')}`,
+        component: `<Trans i18nKey="ui.${this._keySnippet(text)}">${text}</Trans>`
+      },
+      next: {
+        hook: `const t = useTranslations();`,
+        usage: `{t('ui.${this._keySnippet(text)}')}`,
+        component: `<Trans i18nKey="ui.${this._keySnippet(text)}">${text}</Trans>`
       },
       vue: {
-        directive: `{{ $t('ui.${text.toLowerCase().replace(/[^a-z0-9\s]/g, '').replace(/\s+/g, '_')}') }}`,
-        method: `this.$t('ui.${text.toLowerCase().replace(/[^a-z0-9\s]/g, '').replace(/\s+/g, '_')}')`
+        directive: `{{ $t('ui.${this._keySnippet(text)}') }}`,
+        method: `this.$t('ui.${this._keySnippet(text)}')`
       },
       angular: {
         pipe: `{{ '${text}' | translate }}`,
-        service: `this.translateService.instant('ui.${text.toLowerCase().replace(/[^a-z0-9\s]/g, '').replace(/\s+/g, '_')}')`
+        service: `this.translateService.instant('ui.${this._keySnippet(text)}')`
+      },
+      svelte: {
+        store: `$_(('ui.${this._keySnippet(text)}'))`,
+        method: `t.set('ui.${this._keySnippet(text)}', '${text}')`
+      },
+      astro: {
+        import: `import { t } from 'astro-i18next';`,
+        usage: `{t('ui.${this._keySnippet(text)}')}`
+      },
+      remix: {
+        hook: `const { t } = useTranslation();`,
+        usage: `{t('ui.${this._keySnippet(text)}')}`,
+        server: `export const handle = i18next.handle;`
+      },
+      qwik: {
+        hook: `const t = useTranslate();`,
+        usage: `{t('ui.${this._keySnippet(text)}')}`
+      },
+      solid: {
+        hook: `const [t] = useI18n();`,
+        usage: `{t('ui.${this._keySnippet(text)}')}`
+      },
+      ember: {
+        template: `{{t 'ui.${this._keySnippet(text)}'}}`,
+        helper: `this.intl.t('ui.${this._keySnippet(text)}')`
+      },
+      gatsby: {
+        hook: `const { t } = useTranslation();`,
+        usage: `{t('ui.${this._keySnippet(text)}')}`,
+        plugin: `'gatsby-plugin-react-i18next'`
       },
       django: {
         template: `{% trans '${text}' %}`,
@@ -549,14 +656,29 @@ class I18nTextScanner {
         underscore: `from gettext import gettext as _\n_('${text}')`,
         lazy: `from gettext import gettext_lazy as _\n_('${text}')`
       },
+      rust: {
+        fluent: `bundle.get_message("ui_${this._keySnippet(text)}")`,
+        gettext: `gettext("ui_${this._keySnippet(text)}")`
+      },
+      go: {
+        translate: `i18n.Translate("ui_${this._keySnippet(text)}")`,
+        message: `i18n.NewMessage("ui_${this._keySnippet(text)}")`
+      },
       vanilla: {
-        generic: `t('ui.${text.toLowerCase().replace(/[^a-z0-9\s]/g, '').replace(/\s+/g, '_')}')`
+        generic: `t('ui.${this._keySnippet(text)}')`
       }
     };
 
     return frameworks[this.framework] || frameworks.vanilla;
   }
 
+  _keySnippet(text) {
+    return text.toLowerCase()
+      .replace(/[^a-z0-9\s]/g, '')
+      .replace(/\s+/g, '_')
+      .substring(0, 40);
+  }
+
   async scanDirectory(dir, options = {}) {
     const {
       patterns = [],
@@ -571,7 +693,7 @@ class I18nTextScanner {
     }
 
     const allResults = [];
-    const extensions = ['.js', '.jsx', '.ts', '.tsx', '.vue', '.html', '.svelte', '.py', '.pyx', '.pyi'];
+    const extensions = [...SCANNER_EXTENSIONS];
 
     const scanRecursive = (currentDir) => {
       const items = SecurityUtils.safeReaddirSync(currentDir, path.dirname(currentDir), { withFileTypes: true });
@@ -733,7 +855,7 @@ class I18nTextScanner {
     } else if (fwPref && fwPref !== 'auto') {
       this.framework = fwPref;
     } else if (fwDetectEnabled) {
-      const detected = this.detectFramework(process.cwd());
+      const detected = detectProjectFramework(process.cwd());
       this.framework = detected || fwFallback;
     } else {
       this.framework = fwFallback;
@@ -759,7 +881,7 @@ class I18nTextScanner {
     console.log(this.t('scanner.starting', { framework: this.framework }));
     console.log(this.t('scanner.sourceDirectory', { sourceDir: this.sourceDir }));
 
-    const patterns = this.getFrameworkPatterns(this.framework);
+    const patterns = getFrameworkPatterns(this.framework);
     const exclusions = this.config.exclude || ['node_modules', '.git', 'dist', 'build'];
     const minLength = this.config.minLength || 3;
     const maxLength = this.config.maxLength || 100;

package/main/i18ntk-sizing.js

@@ -1141,7 +1141,7 @@ Generated: ${new Date().toISOString()}
         const key = keyValueMatch[1];
         const value = keyValueMatch[2];
         
-        if (key === 'source-dir' || key === 's') {
+        if (key === 'source-dir' || key === 'locales-dir' || key === 'i18n-dir' || key === 's') {
           options['source-dir'] = value;
           options.s = value;
           options.sourceDirExplicit = true;
@@ -1162,7 +1162,7 @@ Generated: ${new Date().toISOString()}
             options.threshold = numValue;
             options.t = numValue;
           }
-        } else if (key === 'source-language') {
+        } else if (key === 'source-language' || key === 'source-locale') {
           options['source-language'] = value;
         } else if (key === 'detailed' || key === 'd') {
           options.detailed = value.toLowerCase() !== 'false';
@@ -1184,7 +1184,7 @@ Generated: ${new Date().toISOString()}
         const key = match[1];
         const nextArg = args[i + 1];
         
-        if (key === 'source-dir' || key === 's') {
+        if (key === 'source-dir' || key === 'locales-dir' || key === 'i18n-dir' || key === 's') {
           options['source-dir'] = nextArg || options['source-dir'];
           options.s = options['source-dir'];
           options.sourceDirExplicit = true;
@@ -1216,7 +1216,7 @@ Generated: ${new Date().toISOString()}
             options.t = value;
           }
           if (nextArg && !nextArg.startsWith('-') && !isNaN(parseInt(nextArg))) i++;
-        } else if (key === 'source-language') {
+        } else if (key === 'source-language' || key === 'source-locale') {
           options['source-language'] = nextArg || options['source-language'];
           if (nextArg && !nextArg.startsWith('-')) i++;
         } else if (key === 'detailed' || key === 'd') {
@@ -1257,12 +1257,15 @@ I18NTK Sizing Analysis Tool
 Usage: i18ntk-sizing [options]
 
 Options:
-  -s, --source-dir <dir>      Source directory containing translation files (default: ./locales)
+  -s, --locales-dir <dir>     Locale directory containing translation files (default: ./locales)
+  --i18n-dir <dir>            Alias for --locales-dir
+  --source-dir <dir>          Legacy alias for --locales-dir
   -l, --languages <langs>     Comma-separated list of languages to analyze
   -o, --output-report         Generate detailed sizing report (default: true)
   -f, --format <format>       Output format: json, csv, table (default: table)
   -t, --threshold <number>    Size difference threshold for warnings (%) (default: 50)
-  --source-language <code>    Source language baseline for comparisons (default: en)
+  --source-locale <code>      Source locale baseline for comparisons (default: en)
+  --source-language <code>    Legacy alias for --source-locale
   -d, --detailed              Generate detailed report with more information
   --detailed-keys             Show detailed key-level analysis
   --predict-expansion         Predict UI layout expansion risk per language

package/main/i18ntk-summary.js

@@ -56,11 +56,14 @@ class I18nSummaryReporter {
       const uiLanguage = this.config.uiLanguage || 'en';
       loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
 
-      this.sourceDir = this.config.sourceDir;
-
-      // Validate source directory
-      const { validateSourceDir } = require('../utils/config-helper');
-      validateSourceDir(this.sourceDir, 'i18ntk-summary');
+      this.sourceDir = this.config.localesDir || this.config.i18nDir || this.config.sourceDir;
+      this.config.sourceDir = this.sourceDir;
+
+      if (!SecurityUtils.safeExistsSync(this.sourceDir, process.cwd())) {
+        const err = new Error(`Locale directory not found: ${this.sourceDir}`);
+        err.exitCode = 2;
+        throw err;
+      }
     } catch (error) {
       console.error(`Error initializing summary reporter: ${error.message}`);
       throw error;
@@ -523,7 +526,10 @@ class I18nSummaryReporter {
     report.push(t('summary.languagesCount', {count: this.stats.languages.length}));
     report.push(t('summary.totalFiles', {count: this.stats.totalFiles}));
     report.push(t('summary.totalKeys', {count: this.stats.totalKeys}));
-    report.push(t('summary.avgKeysPerLanguage', {count: Math.round(this.stats.totalKeys / this.stats.languages.length)}));
+    const averageKeysPerLanguage = this.stats.languages.length > 0
+      ? Math.round(this.stats.totalKeys / this.stats.languages.length)
+      : 0;
+    report.push(t('summary.avgKeysPerLanguage', {count: averageKeysPerLanguage}));
     
     // Calculate total size
     const totalSize = Object.values(this.stats.folderSizes).reduce((sum, size) => sum + size, 0);
@@ -666,8 +672,13 @@ class I18nSummaryReporter {
         }
         report.push('');
       }
-    } else {
-      report.push(t('summary.noIssuesFound'));
+    } else if (this.stats.languages.length === 0) {
+      report.push('⚠️  NO LOCALE LANGUAGES FOUND');
+      report.push('='.repeat(30));
+      report.push('No locale language files or directories were found in the selected locale root.');
+      report.push('');
+    } else {
+      report.push(t('summary.noIssuesFound'));
       report.push('='.repeat(30));
       report.push(t('summary.allFilesConsistent'));
       report.push('');
@@ -795,13 +806,20 @@ class I18nSummaryReporter {
     const args = process.argv.slice(2);
     const parsed = {};
     
-    args.forEach(arg => {
-      if (arg.startsWith('--')) {
-        const [key, value] = arg.substring(2).split('=');
-        if (key === 'source-dir') {
-          parsed.sourceDir = value;
-        } else if (key === 'source-language') {
-          parsed.sourceLanguage = value;
+    for (let i = 0; i < args.length; i++) {
+      const arg = args[i];
+      if (arg.startsWith('--')) {
+        const [key, rawValue] = arg.substring(2).split('=');
+        const value = rawValue !== undefined
+          ? rawValue
+          : (args[i + 1] && !args[i + 1].startsWith('--') ? args[++i] : true);
+        if (key === 'source-dir' || key === 'locales-dir' || key === 'i18n-dir') {
+          parsed.sourceDir = value;
+          parsed.i18nDir = value;
+        } else if (key === 'source-language' || key === 'source-locale') {
+          parsed.sourceLanguage = value;
+        } else if (key === 'code-dir' || key === 'source-code-dir') {
+          parsed.codeDir = value;
         } else if (key === 'output-file') {
           parsed.outputFile = value;
         } else if (key === 'verbose') {
@@ -813,10 +831,10 @@ class I18nSummaryReporter {
         } else if (key === 'no-prompt') {
           parsed.noPrompt = true;
         } else if (key === 'help') {
-          parsed.help = true;
-        }
-      }
-    });
+          parsed.help = true;
+        }
+      }
+    }
     
     return parsed;
   }
@@ -827,14 +845,16 @@ class I18nSummaryReporter {
     const { fromMenu = false, noPrompt = false } = options;
     
     // Always use unified configuration to respect settings
-    const baseConfig = await getUnifiedConfig('summary', args);
-    this.config = { ...this.config, ...baseConfig };
+    const baseConfig = await getUnifiedConfig('summary', args);
+    this.config = { ...this.config, ...baseConfig };
     
     const uiLanguage = this.config.uiLanguage || 'en';
     loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
-    if (!this.config.sourceDir) {
-      this.config.sourceDir = this.detectI18nDirectory();
-    }
+    if (!this.config.sourceDir) {
+      this.config.sourceDir = this.detectI18nDirectory();
+    }
+    this.config.sourceDir = this.config.localesDir || this.config.i18nDir || this.config.sourceDir;
+    this.sourceDir = this.config.sourceDir;
     
     if (!fromMenu) {
       // Check admin authentication for sensitive operations (only when called directly)
@@ -866,10 +886,10 @@ class I18nSummaryReporter {
       }
       
       // Validate source directory exists
-      if (!SecurityUtils.safeExistsSync(this.config.sourceDir, this.config.sourceDir)) {
-        console.error(t('summary.sourceDirectoryDoesNotExist', { sourceDir: this.config.sourceDir }));
-        process.exit(1);
-      }
+      if (!SecurityUtils.safeExistsSync(this.config.sourceDir, process.cwd())) {
+        console.error(t('summary.sourceDirectoryDoesNotExist', { sourceDir: this.config.sourceDir }));
+        process.exit(2);
+      }
     }
     
     console.log(t('summary.i18nSummaryReportGenerator'));
@@ -992,17 +1012,19 @@ class I18nSummaryReporter {
       
       if (totalIssues > 0) {
         console.log(t('summary.foundIssues', {count: totalIssues}));
-      } else {
-        console.log(t('summary.noIssuesConsole'));
-      }
+      } else if (this.stats.languages.length === 0) {
+        console.log('⚠️  No locale languages found in the selected locale root.');
+      } else {
+        console.log(t('summary.noIssuesConsole'));
+      }
       
     } catch (error) {
       console.error(t('summary.errorDuringAnalysis', { error: error.message }));
       if (args.verbose) {
         console.error(error.stack);
       }
-      process.exit(1);
-    }
+      process.exit(error.exitCode || 1);
+    }
     process.exit(0);
   }
 }
@@ -1014,10 +1036,10 @@ if (require.main === module) {
     await reporter.initialize();
     await reporter.run();
   }
-  main().catch(error => {
-    console.error('Error in i18ntk-summary:', error.message);
-    process.exit(1);
-  });
-}
+  main().catch(error => {
+    console.error('Error in i18ntk-summary:', error.message);
+    process.exit(error.exitCode || 1);
+  });
+}
 
-module.exports = I18nSummaryReporter;
+module.exports = I18nSummaryReporter;

package/main/i18ntk-usage.js

@@ -46,6 +46,7 @@ const JsonOutput = require('../utils/json-output');
 const SetupEnforcer = require('../utils/setup-enforcer');
 const { resolveUsageSourceDir } = require('../utils/usage-source');
 const { analyzeSourceForUsageInsights } = require('../utils/usage-insights');
+const { isInteractive } = require('../utils/prompt-helper');
 
 // Ensure setup is complete before running
 (async () => {
@@ -207,9 +208,10 @@ class I18nUsageAnalyzer {
 
   // Normalize CLI arguments to handle both camelCase and hyphenated flags
   normalizeArgs(a) {
-    return {
-      sourceDir: a.sourceDir ?? a['source-dir'],
-      i18nDir: a.i18nDir ?? a['i18n-dir'],
+    return {
+      sourceDir: a.sourceDir ?? a['source-dir'] ?? a['code-dir'] ?? a['source-code-dir'],
+      i18nDir: a.i18nDir ?? a['i18n-dir'] ?? a['locales-dir'],
+      sourceLanguage: a.sourceLanguage ?? a['source-language'] ?? a['source-locale'],
       outputReport: a.outputReport ?? a['output-report'],
       outputDir: a.outputDir ?? a['output-dir'],
       uiLanguage: a.uiLanguage ?? a['ui-language'],
@@ -231,11 +233,18 @@ class I18nUsageAnalyzer {
     const args = process.argv.slice(2);
     const parsed = {};
     
-    for (const arg of args) {
-      if (arg.startsWith('--')) {
-        const [key, value] = arg.substring(2).split('=');
-        if (value !== undefined) {
-          parsed[key] = value;
+    for (let i = 0; i < args.length; i++) {
+      const arg = args[i];
+      if (arg.startsWith('--')) {
+        let [key, value] = arg.substring(2).split('=');
+        if (value === undefined && args[i + 1] && !args[i + 1].startsWith('-')) {
+          value = args[++i];
+        }
+        if (key === 'code-dir' || key === 'source-code-dir') key = 'source-dir';
+        if (key === 'locales-dir') key = 'i18n-dir';
+        if (key === 'source-locale') key = 'source-language';
+        if (value !== undefined) {
+          parsed[key] = value;
         } else {
           parsed[key] = true;
         }
@@ -513,11 +522,15 @@ class I18nUsageAnalyzer {
         this.sourceDir = path.resolve(args.sourceDir);
       }
       
-      if (args.i18nDir) {
-        this.config.i18nDir = args.i18nDir;
-        this.i18nDir = path.resolve(args.i18nDir);
-        this.sourceLanguageDir = path.join(this.i18nDir, this.config.sourceLanguage);
-      }
+      if (args.i18nDir) {
+        this.config.i18nDir = args.i18nDir;
+        this.i18nDir = path.resolve(args.i18nDir);
+        this.sourceLanguageDir = path.join(this.i18nDir, this.config.sourceLanguage);
+      }
+      if (args.sourceLanguage) {
+        this.config.sourceLanguage = args.sourceLanguage;
+        this.sourceLanguageDir = path.join(this.i18nDir, this.config.sourceLanguage);
+      }
       
       if (this.sourceDir || this.i18nDir) {
         await configManager.updateConfig({
@@ -722,9 +735,9 @@ class I18nUsageAnalyzer {
       
       console.log('\n' + t('usage.analysisCompletedSuccessfully'));
     
-      if (require.main === module && !args.noPrompt) {
-        await this.prompt('\nPress Enter to continue...');
-      }
+      if (require.main === module && isInteractive(args)) {
+        await this.prompt('\nPress Enter to continue...');
+      }
       this.closeReadline();
       
     } catch (error) {