i18ntk 2.1.0 → 2.2.0

package/README.md

@@ -1,4 +1,4 @@
-# i18ntk v2.1.0
+# i18ntk v2.2.0
 
 Zero-dependency i18n toolkit for initialization, scanning, analysis, validation, usage tracking, and translation completion.
 
@@ -9,7 +9,12 @@ Zero-dependency i18n toolkit for initialization, scanning, analysis, validation,
 [![node](https://img.shields.io/badge/node-%3E%3D16-339933)](https://nodejs.org)
 [![dependencies](https://img.shields.io/badge/dependencies-0-success)](https://www.npmjs.com/package/i18ntk)
 [![license](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
-[![socket](https://socket.dev/api/badge/npm/package/i18ntk/2.1.0)](https://socket.dev/npm/package/i18ntk/overview/2.1.0)
+[![socket](https://socket.dev/api/badge/npm/package/i18ntk/2.2.0)](https://socket.dev/npm/package/i18ntk/overview/2.2.0)
+
+## Upgrade Notice
+
+Versions earlier than `2.2.0` may contain known stability and security issues.
+They are considered unsupported for production use. Upgrade to `2.2.0` or newer.
 
 ## Why i18ntk
 
@@ -100,7 +105,7 @@ Example:
 
 ```json
 {
-  "version": "2.1.0",
+  "version": "2.2.0",
   "sourceDir": "./locales",
   "i18nDir": "./locales",
   "outputDir": "./i18ntk-reports",
@@ -137,9 +142,8 @@ console.log(getLanguage());
 - [Runtime API Guide](docs/runtime.md)
 - [Scanner Guide](docs/scanner-guide.md)
 - [Environment Variables](docs/environment-variables.md)
-- [Migration Guide v2.1.0](docs/migration-guide-v2.1.0.md)
-- [Release Runbook](DEVUPDATE.md)
+- [Migration Guide v2.2.0](docs/migration-guide-v2.2.0.md)
 
 ## License
 
-MIT
+MIT

package/main/i18ntk-analyze.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * I18NTK TRANSLATION ANALYSIS SCRIPT
  * 
@@ -27,7 +27,7 @@ const SetupEnforcer = require('../utils/setup-enforcer');
   }
 })();
 
-loadTranslations( 'en', path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+loadTranslations('en', path.resolve(__dirname, '..', 'ui-locales'));
 
 const PROJECT_ROOT = process.cwd();
 
@@ -67,7 +67,7 @@ class I18nAnalyzer {
       this.config = { ...baseConfig, ...(this.config || {}) };
       
       const uiLanguage = (this.config && this.config.uiLanguage) || 'en';
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
       
       this.sourceDir = this.config.sourceDir;
       this.sourceLanguageDir = path.join(this.sourceDir, this.config.sourceLanguage);
@@ -142,44 +142,44 @@ class I18nAnalyzer {
     }
   }
 
-  // Get all available languages
-  isValidLanguageCode(code) {
-    if (!code || typeof code !== 'string') return false;
-    return /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/i.test(code.trim());
-  }
-
-  isExcludedLanguageDirectory(name) {
-    if (!name || typeof name !== 'string') return true;
-    const lowered = name.toLowerCase();
-    return lowered.startsWith('backup-') || lowered === 'backup' || lowered === 'reports' || lowered === 'i18ntk-reports';
-  }
-
-  getAvailableLanguages() {
-    try {
-      const items = SecurityUtils.safeReaddirSync(this.sourceDir, process.cwd(), { withFileTypes: true });
-      if (!items) {
-        console.error('Error reading source directory: Unable to access directory');
+  // Get all available languages
+  isValidLanguageCode(code) {
+    if (!code || typeof code !== 'string') return false;
+    return /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/i.test(code.trim());
+  }
+
+  isExcludedLanguageDirectory(name) {
+    if (!name || typeof name !== 'string') return true;
+    const lowered = name.toLowerCase();
+    return lowered.startsWith('backup-') || lowered === 'backup' || lowered === 'reports' || lowered === 'i18ntk-reports';
+  }
+
+  getAvailableLanguages() {
+    try {
+      const items = SecurityUtils.safeReaddirSync(this.sourceDir, process.cwd(), { withFileTypes: true });
+      if (!items) {
+        console.error('Error reading source directory: Unable to access directory');
         return [];
       }
       
       const languages = [];
       
       // Check for directory-based structure
-      const directories = items
-        .filter(item => item.isDirectory())
-        .map(item => item.name)
-        .filter(name =>
-          name !== 'node_modules' &&
-          !name.startsWith('.') &&
-          name !== this.config.sourceLanguage &&
-          !this.isExcludedLanguageDirectory(name) &&
-          this.isValidLanguageCode(name)
-        )
-        .filter(name => {
-          const dirPath = path.join(this.sourceDir, name);
-          const dirItems = SecurityUtils.safeReaddirSync(dirPath, process.cwd(), { withFileTypes: true }) || [];
-          return dirItems.some(item => item.isFile() && item.name.endsWith('.json'));
-        });
+      const directories = items
+        .filter(item => item.isDirectory())
+        .map(item => item.name)
+        .filter(name =>
+          name !== 'node_modules' &&
+          !name.startsWith('.') &&
+          name !== this.config.sourceLanguage &&
+          !this.isExcludedLanguageDirectory(name) &&
+          this.isValidLanguageCode(name)
+        )
+        .filter(name => {
+          const dirPath = path.join(this.sourceDir, name);
+          const dirItems = SecurityUtils.safeReaddirSync(dirPath, process.cwd(), { withFileTypes: true }) || [];
+          return dirItems.some(item => item.isFile() && item.name.endsWith('.json'));
+        });
       
       // Check for monolith files (language.json files)
       const files = items
@@ -190,17 +190,17 @@ class I18nAnalyzer {
       languages.push(...directories);
       
       // Add monolith files as languages (without .json extension)
-      const monolithLanguages = files
-        .map(file => file.replace('.json', ''))
-        .filter(lang =>
-          !languages.includes(lang) &&
-          lang !== this.config.sourceLanguage &&
-          !this.isExcludedLanguageDirectory(lang) &&
-          this.isValidLanguageCode(lang)
-        );
-      languages.push(...monolithLanguages);
-
-      return [...new Set(languages)].sort();
+      const monolithLanguages = files
+        .map(file => file.replace('.json', ''))
+        .filter(lang =>
+          !languages.includes(lang) &&
+          lang !== this.config.sourceLanguage &&
+          !this.isExcludedLanguageDirectory(lang) &&
+          this.isValidLanguageCode(lang)
+        );
+      languages.push(...monolithLanguages);
+
+      return [...new Set(languages)].sort();
     } catch (error) {
       console.error('Error reading source directory:', error.message);
       return [];
@@ -712,7 +712,7 @@ try {
         throw new Error(t('analyze.failedToWriteReportFile') || 'Failed to write report file securely');
       }
       
-      return reportPath;
+      return reportPath;
       
     } catch (error) {
       console.error(`Failed to save report for ${language}:`, error.message);
@@ -779,21 +779,21 @@ try {
           console.log(t('analyze.analyzing', { language }) || `\n🔄 Analyzing ${language}...`);
         }
         
-          const analysis = this.analyzeLanguage(language);
-          const report = this.generateLanguageReport(analysis);
-
-          // Save report
-          const reportPath = await this.saveReport(language, report);
-          const processedCount = results.length + 1;
-
-          if (!args.json) {
-            console.log(t('analyze.completed', { language }) || `✅ Analysis completed for ${language}`);
-            console.log(t('analyze.progress', {
-              translated: processedCount,
-              total: languages.length
-            }) || `   Progress: ${processedCount}/${languages.length} languages processed`);
-            console.log(t('analyze.reportSaved', { reportPath }) || `   Report saved: ${reportPath}`);
-          }
+          const analysis = this.analyzeLanguage(language);
+          const report = this.generateLanguageReport(analysis);
+
+          // Save report
+          const reportPath = await this.saveReport(language, report);
+          const processedCount = results.length + 1;
+
+          if (!args.json) {
+            console.log(t('analyze.completed', { language }) || `✅ Analysis completed for ${language}`);
+            console.log(t('analyze.progress', {
+              translated: processedCount,
+              total: languages.length
+            }) || `   Progress: ${processedCount}/${languages.length} languages processed`);
+            console.log(t('analyze.reportSaved', { reportPath }) || `   Report saved: ${reportPath}`);
+          }
         
         results.push({
           language,
@@ -889,7 +889,7 @@ try {
         this.config = { ...baseConfig, ...this.config };
         
         const uiLanguage = this.config.uiLanguage || 'en';
-        loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+        loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
         
         this.sourceDir = this.config.sourceDir;
         this.sourceLanguageDir = path.join(this.sourceDir, this.config.sourceLanguage);

package/main/i18ntk-complete.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * I18NTK TRANSLATION COMPLETION SCRIPT
  * 
@@ -19,15 +19,15 @@ const { loadTranslations, t } = require('../utils/i18n-helper');
 const { getGlobalReadline, closeGlobalReadline } = require('../utils/cli');
 const SetupEnforcer = require('../utils/setup-enforcer');
 
-// Ensure setup is complete before running, except for help output.
-(async () => {
-  const isHelpRequest = process.argv.slice(2).some(arg => arg === '--help' || arg === '-h');
-  if (isHelpRequest) {
-    return;
-  }
-  try {
-    await SetupEnforcer.checkSetupCompleteAsync();
-  } catch (error) {
+// Ensure setup is complete before running, except for help output.
+(async () => {
+  const isHelpRequest = process.argv.slice(2).some(arg => arg === '--help' || arg === '-h');
+  if (isHelpRequest) {
+    return;
+  }
+  try {
+    await SetupEnforcer.checkSetupCompleteAsync();
+  } catch (error) {
     console.error('Setup check failed:', error.message);
     process.exit(1);
   }
@@ -37,7 +37,7 @@ loadTranslations();
 
 
 
-class I18nCompletionTool {
+class I18nCompletionTool {
   constructor(config = {}) {
     this.config = config;
     this.sourceDir = null;
@@ -109,57 +109,57 @@ class I18nCompletionTool {
           parsed.autoTranslate = true;
         } else if (key === 'dry-run') {
           parsed.dryRun = true;
-        } else if (key === 'no-prompt') {
-          parsed.noPrompt = true;
-        } else if (key === 'help' || key === 'h') {
-          parsed.help = true;
-        }
-      }
-    });
+        } else if (key === 'no-prompt') {
+          parsed.noPrompt = true;
+        } else if (key === 'help' || key === 'h') {
+          parsed.help = true;
+        }
+      }
+    });
     
     return parsed;
   }
 
-  // Get all available languages
-  getAvailableLanguages() {
+  // Get all available languages
+  getAvailableLanguages() {
     if (!SecurityUtils.safeExistsSync(this.sourceDir, this.config.projectRoot)) {
       throw new Error(`Source directory not found: ${this.sourceDir}`);
     }
     
     // Check for monolith JSON files (en.json, es.json, etc.)
-    const files = SecurityUtils.safeReaddirSync(this.sourceDir, this.config.projectRoot);
-    const languagesFromFiles = files
-      .filter(file => file.endsWith('.json'))
-      .map(file => path.basename(file, '.json'))
-      .filter(code => this.isValidLanguageCode(code));
-    
-    // Also check for directory-based structure for backward compatibility
-    const directories = SecurityUtils.safeReaddirSync(this.sourceDir, this.config.projectRoot)
-      .filter(item => {
-        if (this.isExcludedLanguageDirectory(item)) return false;
-        if (!this.isValidLanguageCode(item)) return false;
-        const itemPath = path.join(this.sourceDir, item);
-        const stat = SecurityUtils.safeStatSync(itemPath, this.config.projectRoot);
-        if (!stat || !stat.isDirectory()) return false;
-
-        const localeFiles = SecurityUtils.safeReaddirSync(itemPath, this.config.projectRoot)
-          .filter(name => name.endsWith('.json'));
-        return localeFiles.length > 0;
-      });
-    
-    return [...new Set([...languagesFromFiles, ...directories])];
-  }
-
-  isValidLanguageCode(code) {
-    if (!code || typeof code !== 'string') return false;
-    return /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/i.test(code.trim());
-  }
-
-  isExcludedLanguageDirectory(name) {
-    if (!name || typeof name !== 'string') return true;
-    const lowered = name.toLowerCase();
-    return lowered.startsWith('backup-') || lowered === 'backup' || lowered === 'reports' || lowered === 'i18ntk-reports';
-  }
+    const files = SecurityUtils.safeReaddirSync(this.sourceDir, this.config.projectRoot);
+    const languagesFromFiles = files
+      .filter(file => file.endsWith('.json'))
+      .map(file => path.basename(file, '.json'))
+      .filter(code => this.isValidLanguageCode(code));
+    
+    // Also check for directory-based structure for backward compatibility
+    const directories = SecurityUtils.safeReaddirSync(this.sourceDir, this.config.projectRoot)
+      .filter(item => {
+        if (this.isExcludedLanguageDirectory(item)) return false;
+        if (!this.isValidLanguageCode(item)) return false;
+        const itemPath = path.join(this.sourceDir, item);
+        const stat = SecurityUtils.safeStatSync(itemPath, this.config.projectRoot);
+        if (!stat || !stat.isDirectory()) return false;
+
+        const localeFiles = SecurityUtils.safeReaddirSync(itemPath, this.config.projectRoot)
+          .filter(name => name.endsWith('.json'));
+        return localeFiles.length > 0;
+      });
+    
+    return [...new Set([...languagesFromFiles, ...directories])];
+  }
+
+  isValidLanguageCode(code) {
+    if (!code || typeof code !== 'string') return false;
+    return /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/i.test(code.trim());
+  }
+
+  isExcludedLanguageDirectory(name) {
+    if (!name || typeof name !== 'string') return true;
+    const lowered = name.toLowerCase();
+    return lowered.startsWith('backup-') || lowered === 'backup' || lowered === 'reports' || lowered === 'i18ntk-reports';
+  }
 
   // Get all JSON files from a language directory
   getLanguageFiles(language) {
@@ -481,7 +481,8 @@ class I18nCompletionTool {
       this.config = { ...baseConfig, ...(this.config || {}) };
       
       const uiLanguage = (this.config && this.config.uiLanguage) || 'en';
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));this.sourceDir = this.config.sourceDir;
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
+      this.sourceDir = this.config.sourceDir;
       this.sourceLanguageDir = path.join(this.sourceDir, this.config.sourceLanguage);
     } else {
       await this.initialize();
@@ -552,28 +553,28 @@ class I18nCompletionTool {
       console.log(t("complete.languagesProcessed", { languagesProcessed: languages.length }));
       console.log(t("complete.missingKeysAdded", { missingKeysAdded: missingKeys.length }));
       
-      if (!args.dryRun && allChanges.length > 0 && !args.noPrompt) {
-        const rl = this.rl || this.initReadline();
-        const answer = await this.prompt('\n' + t('complete.generateReportPrompt') + ' (Y/N): ');
-        
-        if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
-          await this.generateReport(allChanges, languages);
+      if (!args.dryRun && allChanges.length > 0 && !args.noPrompt) {
+        const rl = this.rl || this.initReadline();
+        const answer = await this.prompt('\n' + t('complete.generateReportPrompt') + ' (Y/N): ');
+        
+        if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
+          await this.generateReport(allChanges, languages);
         }
       }
       
-      if (!args.dryRun) {
-        console.log('\n' + t("complete.nextStepsTitle"));
-        console.log(t("complete.separator"));
-        console.log('1. Run usage analysis:');
-        console.log('   i18ntk --command=usage');
-        console.log('2. Validate translations:');
-        console.log('   i18ntk --command=validate');
-        console.log('3. Analyze translation status:');
-        console.log('   i18ntk --command=analyze');
-        console.log('\n' + t("complete.allKeysAvailable"));
-      } else {
-        console.log('\n' + t("complete.runWithoutDryRun"));
-      }
+      if (!args.dryRun) {
+        console.log('\n' + t("complete.nextStepsTitle"));
+        console.log(t("complete.separator"));
+        console.log('1. Run usage analysis:');
+        console.log('   i18ntk --command=usage');
+        console.log('2. Validate translations:');
+        console.log('   i18ntk --command=validate');
+        console.log('3. Analyze translation status:');
+        console.log('   i18ntk --command=analyze');
+        console.log('\n' + t("complete.allKeysAvailable"));
+      } else {
+        console.log('\n' + t("complete.runWithoutDryRun"));
+      }
       
       // Only prompt when run from the menu (i.e., when a callback or menu context is present)
       if (typeof this.prompt === "function" && args.fromMenu) {
@@ -605,4 +606,4 @@ if (require.main === module) {
   });
 }
 
-module.exports = I18nCompletionTool;
+module.exports = I18nCompletionTool;

package/main/i18ntk-fixer.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * I18NTK TRANSLATION FIXER SCRIPT
@@ -27,7 +27,7 @@ const SetupEnforcer = require('../utils/setup-enforcer');
   }
 })();
 
-loadTranslations('en', path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+loadTranslations('en', path.resolve(__dirname, '..', 'ui-locales'));
 
 class I18nFixer {
   constructor(config = {}) {
@@ -51,7 +51,7 @@ class I18nFixer {
       this.config = { ...baseConfig, ...(this.config || {}) };
 
       const uiLanguage = (this.config && this.config.uiLanguage) || 'en';
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
 
       this.sourceDir = this.config.sourceDir;
       this.outputDir = this.config.outputDir;

package/main/i18ntk-init.js

@@ -1122,7 +1122,7 @@ class I18nInitializer {
       
       try {
         // Import locale optimizer directly
-        const LocaleOptimizer = require('../scripts/locale-optimizer');
+        const LocaleOptimizer = require('../utils/locale-optimizer');
         
         // First run dry run to show current state
         console.log('\n🔍 Running locale optimization preview...');
@@ -1139,12 +1139,12 @@ class I18nInitializer {
           console.log('\n✅ Package optimization completed!');
         } else {
           console.log('\n💡 You can run locale optimization later with:');
-          console.log('   node scripts/locale-optimizer.js --interactive');
+          console.log('   node utils/locale-optimizer.js --interactive');
         }
       } catch (error) {
         console.log('\n⚠️ Could not offer locale optimization:', error.message);
         console.log('\n💡 You can run locale optimization later with:');
-        console.log('   node scripts/locale-optimizer.js --interactive');
+        console.log('   node utils/locale-optimizer.js --interactive');
       }
     } catch (error) {
       console.log('\n⚠️ Could not offer locale optimization:', error.message);
@@ -1178,7 +1178,7 @@ class I18nInitializer {
         // Load translations for UI messages
       const uiLanguage = this.config.uiLanguage || 'en';
       const { loadTranslations } = require('../utils/i18n-helper');
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
       }
       
       // Setup is now handled centrally by config manager
@@ -1261,7 +1261,7 @@ class I18nInitializer {
       // Load translations for UI messages
       const uiLanguage = this.config.uiLanguage || 'en';
       const { loadTranslations } = require('../utils/i18n-helper');
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
       
       // Skip i18n framework check in non-interactive mode
       console.log('Running initialization in non-interactive mode...');

package/main/i18ntk-scanner.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * I18NTK TEXT SCANNER
@@ -47,7 +47,7 @@ class I18nTextScanner {
   }
 
   loadLocale() {
-    const uiLocalesDir = path.join(__dirname, '..', 'resources', 'i18n', 'ui-locales');
+    const uiLocalesDir = path.join(__dirname, '..', 'ui-locales');
     const localeFile = path.join(uiLocalesDir, 'en.json');
 
     try {