i18ntk 4.3.0 → 4.3.1

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.3.1] - 2026-05-31
+
+### Fixed
+- Published tarball now includes `utils/english-placeholder-checker.js`, resolving `MODULE_NOT_FOUND` at startup for `i18ntk-fixer --check-placeholders` and manager option 7.
+- Language-specific CLI entry points (`main/i18ntk-go.js`, `main/i18ntk-java.js`, `main/i18ntk-js.js`, `main/i18ntk-php.js`, `main/i18ntk-py.js`) and their shared `utils/mini-commander.js` dependency are now included in the published package.
+- Removed inconsistent `.js` extension suffixes from require paths in `main/i18ntk-js.js`.
+
 ## [4.3.0] - 2026-05-31
 
 ### Fixed

package/README.md

@@ -1,4 +1,4 @@
-# i18ntk v4.3.0
+# i18ntk v4.3.1
 
 A i18n toolkit - A zero-dependency internationalization toolkit for setup, scanning, analysis, validation, usage tracking, translation completion, automatic JSON locale translation, reporting, and runtime translation loading.
 
@@ -9,7 +9,7 @@ A i18n toolkit - A zero-dependency internationalization toolkit for setup, scann
 [![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/4.3.0)](https://socket.dev/npm/package/i18ntk/overview/4.3.0)
+[![socket](https://socket.dev/api/badge/npm/package/i18ntk/4.3.1)](https://socket.dev/npm/package/i18ntk/overview/4.3.1)
 
 ## Install
 
@@ -30,6 +30,12 @@ Requirements:
 - npm `>=8.0.0`
 - No runtime dependencies
 
+## What's New in 4.3.1
+
+- **FIX**: Published tarball now includes `utils/english-placeholder-checker.js`, resolving `MODULE_NOT_FOUND` at startup for `i18ntk-fixer --check-placeholders` and manager option 7.
+- **FIX**: Language-specific CLI entry points (`i18ntk-go`, `i18ntk-java`, `i18ntk-js`, `i18ntk-php`, `i18ntk-py`) and their shared `utils/mini-commander.js` dependency are now included in the published package.
+- **FIX**: Removed inconsistent `.js` extension suffixes from require paths in `main/i18ntk-js.js`.
+
 ## What's New in 4.3.0
 
 - **AUTO TRANSLATE**: Existing target values like `[AR] What We Offer`, `[AR] Email`, `[zh] Email`, and `[TR] Password` are now treated as untranslated placeholders for the matching target language and are translated from the source text.
@@ -40,7 +46,7 @@ Requirements:
 - **FIX PLACEHOLDERS**: Menu option 7 now runs an English source placeholder audit and reports how many `[LANG] ...` values remain in English locale files. A clean project reports `0`.
 - **SIZING/USAGE**: Usage analysis no longer writes its inferred app source fallback back into the shared locale config, so running usage before sizing no longer makes sizing analyze the wrong directory.
 - **VALIDATION REPORTS**: Validation summary files now include warning and error details, including English-content warning payloads, instead of only totals.
-- **DOCS**: Versioned docs and migration guidance now reflect the current 4.3.0 command surface.
+- **DOCS**: Versioned docs and migration guidance now reflect the current 4.3.1 command surface.
 
 ## What's New in 4.1.0
 
@@ -506,7 +512,7 @@ Example:
 
 ```json
 {
-  "version": "4.3.0",
+  "version": "4.3.1",
   "sourceDir": "./locales",
   "i18nDir": "./locales",
   "outputDir": "./i18ntk-reports",
@@ -568,7 +574,7 @@ The public package manifest includes `readmeFilename: "README.md"`, and the rele
 - [Auto Translate Guide](./docs/auto-translate.md)
 - [Scanner Guide](./docs/scanner-guide.md)
 - [Environment Variables](./docs/environment-variables.md)
-- [Migration Guide v4.3.0](./docs/migration-guide-v4.3.0.md)
+- [Migration Guide v4.3.1](./docs/migration-guide-v4.3.1.md)
 
 ## Security
 

package/main/i18ntk-go.js

@@ -0,0 +1,283 @@
+#!/usr/bin/env node
+
+/**
+ * i18ntk-go.js - Go Language I18n Management Command
+ * 
+ * Supports:
+ * - Standard Go i18n patterns
+ * - go-i18n library
+ * - Custom Go i18n implementations
+ * - Resource file (.json, .toml) management
+ */
+
+const fs = require('fs');
+const path = require('path');
+const SecurityUtils = require('../utils/security');
+const { getConfig, saveConfig } = require('../utils/config-helper');
+const I18nHelper = require('../utils/i18n-helper');
+const SetupEnforcer = require('../utils/setup-enforcer');
+const { program } = require('../utils/mini-commander');
+
+(async () => {
+  try {
+    await SetupEnforcer.checkSetupCompleteAsync();
+  } catch (error) {
+    console.error('Setup check failed:', error.message);
+    process.exit(1);
+  }
+})();
+
+class GoI18nManager {
+  constructor() {
+    this.supportedPatterns = [
+      'T("key")',
+      'Localize("key")',
+      'i18n.T("key")',
+      'tr("key")',
+      'message.Printer.Printf',
+      'i18n.MustLocalize'
+    ];
+    
+    this.fileExtensions = ['.go', '.mod', '.sum'];
+    this.resourceFormats = ['.json', '.toml', '.yaml', '.yml'];
+  }
+
+  async detectFramework(sourceDir) {
+    const goModPath = path.join(sourceDir, 'go.mod');
+    if (SecurityUtils.safeExistsSync(goModPath)) {
+      const content = SecurityUtils.safeReadFileSync(goModPath, sourceDir, 'utf8') || '';
+      
+      if (content.includes('go-i18n')) return 'go-i18n-v2';
+      if (/x\/text\b/.test(content)) return 'golang-text';
+      
+      return 'standard-go';
+    }
+    
+    // Check for Go files
+    const goFiles = this.findFiles(sourceDir, '.go');
+    if (goFiles.length > 0) {
+      return 'standard-go';
+    }
+    
+    return 'generic';
+  }
+
+  async extractTranslations(sourceDir, options = {}) {
+    const framework = await this.detectFramework(sourceDir);
+    const translations = new Set();
+    
+    const goFiles = this.findFiles(sourceDir, '.go');
+    
+    for (const file of goFiles) {
+      const content = SecurityUtils.safeReadFileSync(file, path.dirname(file), 'utf8') || '';
+      
+      // Extract Go i18n patterns
+      const patterns = [
+        /T\("([^"]+)"\)/g,
+        /Localize\("([^"]+)"\)/g,
+        /i18n\.T\("([^"]+)"\)/g,
+        /tr\("([^"]+)"\)/g,
+        /message\.Printer\.Printf\("([^"]+)"/g,
+        /i18n\.MustLocalize\(&i18n\.LocalizeConfig\{MessageID:\s*"([^"]+)"/g
+      ];
+      
+      for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+          translations.add(match[1]);
+        }
+      }
+    }
+    
+    return {
+      framework,
+      translations: Array.from(translations),
+      files: goFiles.length,
+      patterns: this.supportedPatterns
+    };
+  }
+
+  async createLocaleStructure(outputDir, languages = ['en']) {
+    const localesDir = path.join(outputDir, 'locales');
+    
+    for (const lang of languages) {
+      const langDir = path.join(localesDir, lang);
+      fs.mkdirSync(langDir, { recursive: true });
+      
+      // Create Go i18n format files
+      SecurityUtils.safeWriteFileSync(path.join(langDir, 'active.en.toml'), `# Go i18n translations for ${lang}
+[hello]
+other = "Hello, World!"
+
+[items]
+one = "{{.Count}} item"
+other = "{{.Count}} items"
+`);
+      
+      SecurityUtils.safeWriteFileSync(path.join(langDir, 'active.en.json'), JSON.stringify({
+        hello: "Hello, World!",
+        items: {
+          one: "{{.Count}} item",
+          other: "{{.Count}} items"
+        }
+      }, null, 2));
+    }
+    
+    return localesDir;
+  }
+
+  findFiles(dir, extension) {
+    const files = [];
+    
+    function traverse(currentDir) {
+      const items = fs.readdirSync(currentDir);
+      
+      for (const item of items) {
+        const fullPath = path.join(currentDir, item);
+        const stat = fs.statSync(fullPath);
+        
+        if (stat.isDirectory() && !item.startsWith('.') && item !== 'node_modules') {
+          traverse(fullPath);
+        } else if (stat.isFile() && path.extname(item) === extension) {
+          files.push(fullPath);
+        }
+      }
+    }
+    
+    traverse(dir);
+    return files;
+  }
+
+  async generateReport(results, outputDir) {
+    const report = {
+      timestamp: new Date().toISOString(),
+      framework: results.framework,
+      totalTranslations: results.translations.length,
+      translations: results.translations,
+      filesProcessed: results.files,
+      patterns: results.patterns,
+      recommendations: this.getRecommendations(results)
+    };
+    
+    const reportPath = path.join(outputDir, 'i18ntk-go-report.json');
+    SecurityUtils.safeWriteFileSync(reportPath, JSON.stringify(report, null, 2));
+    
+    return reportPath;
+  }
+
+  getRecommendations(results) {
+    const recommendations = [];
+    
+    if (results.translations.length === 0) {
+      recommendations.push('No translations found. Check your Go i18n patterns');
+    }
+    
+    if (results.files === 0) {
+      recommendations.push('No Go files found in source directory');
+    }
+    
+    if (results.framework === 'generic') {
+      recommendations.push('Consider using go-i18n library for better i18n support');
+    }
+    
+    return recommendations;
+  }
+}
+
+// CLI Implementation
+program
+  .name('i18ntk-go')
+  .description('Go language i18n management tool')
+  .version('1.10.1');
+
+program
+  .command('init')
+  .description('Initialize Go i18n structure')
+  .option('-s, --source-dir <dir>', 'Source directory', './')
+  .option('-o, --output-dir <dir>', 'Output directory', './i18ntk-reports')
+  .option('-l, --languages <langs>', 'Languages (comma-separated)', 'en')
+  .action(async (options) => {
+    try {
+      const manager = new GoI18nManager();
+      const languages = options.languages.split(',');
+      
+      const localesDir = await manager.createLocaleStructure(options.outputDir, languages);
+      
+      console.log(`✅ Go i18n structure initialized in: ${localesDir}`);
+      console.log(`📊 Languages: ${languages.join(', ')}`);
+      
+    } catch (error) {
+      console.error('❌ Error initializing Go i18n:', error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('analyze')
+  .description('Analyze Go i18n usage')
+  .option('-s, --source-dir <dir>', 'Source directory', './')
+  .option('-o, --output-dir <dir>', 'Output directory', './i18ntk-reports')
+  .option('--dry-run', 'Preview without making changes')
+  .action(async (options) => {
+    try {
+      SecurityUtils.validatePath(options.sourceDir);
+      
+      const manager = new GoI18nManager();
+      const results = await manager.extractTranslations(options.sourceDir);
+      
+      console.log(`🔍 Framework detected: ${results.framework}`);
+      console.log(`📊 Files processed: ${results.files}`);
+      console.log(`📝 Translations found: ${results.translations.length}`);
+      
+      if (!options.dryRun) {
+        const reportPath = await manager.generateReport(results, options.outputDir);
+        console.log(`📄 Report saved: ${reportPath}`);
+      }
+      
+    } catch (error) {
+      console.error('❌ Error analyzing Go i18n:', error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('extract')
+  .description('Extract Go translations')
+  .option('-s, --source-dir <dir>', 'Source directory', './')
+  .option('-o, --output-dir <dir>', 'Output directory', './locales')
+  .option('-l, --languages <langs>', 'Languages (comma-separated)', 'en')
+  .action(async (options) => {
+    try {
+      SecurityUtils.validatePath(options.sourceDir);
+      
+      const manager = new GoI18nManager();
+      const results = await manager.extractTranslations(options.sourceDir);
+      
+      await manager.createLocaleStructure(options.outputDir, options.languages.split(','));
+      
+      console.log(`✅ Extracted ${results.translations.length} translations`);
+      console.log(`📁 Locale structure created in: ${options.outputDir}`);
+      
+    } catch (error) {
+      console.error('❌ Error extracting Go translations:', error.message);
+      process.exit(1);
+    }
+  });
+
+// Handle uncaught errors
+process.on('uncaughtException', (error) => {
+  console.error('❌ Uncaught exception:', error.message);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason) => {
+  console.error('❌ Unhandled rejection:', reason);
+  process.exit(1);
+});
+
+// Export for programmatic use
+module.exports = { GoI18nManager };
+
+if (require.main === module) {
+  program.parse();
+}