i18ntk 4.2.2 → 4.3.1

package/CHANGELOG.md

@@ -5,10 +5,22 @@ 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.2.2] - 2026-05-31
+## [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
 - Auto Translate now treats single-word uppercase target-language placeholders such as `[AR] Email` and `[AR] Password` as untranslated target values, matching the existing multi-word `[AR] What We Offer` detection.
+- Auto Translate now treats bracketed target-language placeholders case-insensitively, so `[zh] Email` and `[TR] Password` are both retried for the matching target language.
+- Managed Auto Translate now checks every selected source file for a target language before reporting leftover failures, instead of stopping after the first failed file.
+- Auto Translate no longer fails a run when a provider legitimately returns a short all-caps acronym or code unchanged, such as `XP`.
+- Manager option 7 and `i18ntk-fixer --check-placeholders` now run an English source placeholder audit, reporting any `[LANG] ...` values left in English locale files; a clean project reports `0` placeholders.
+- The management command router no longer prints a generic operation-success message when a command returns `{ success: false }`.
 
 ## [4.2.1] - 2026-05-31
 

package/README.md

@@ -1,4 +1,4 @@
-# i18ntk v4.2.2
+# 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.2.2)](https://socket.dev/npm/package/i18ntk/overview/4.2.2)
+[![socket](https://socket.dev/api/badge/npm/package/i18ntk/4.3.1)](https://socket.dev/npm/package/i18ntk/overview/4.3.1)
 
 ## Install
 
@@ -30,14 +30,23 @@ Requirements:
 - npm `>=8.0.0`
 - No runtime dependencies
 
-## What's New in 4.2.2
+## What's New in 4.3.1
 
-- **AUTO TRANSLATE**: Existing target values like `[AR] What We Offer`, `[AR] Email`, and `[AR] Password` are now treated as untranslated placeholders for the matching target language and are translated from the source text.
+- **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.
 - **AUTO TRANSLATE**: Before writing each output file, Auto Translate now performs a final leftover check and retries any placeholder-prefixed or source-copy values once.
 - **AUTO TRANSLATE**: If leftovers remain after the final retry, the command warns, includes them in the report, recommends rerunning Auto Translate, and exits with validation failure instead of reporting a clean completion.
+- **AUTO TRANSLATE**: Managed Auto Translate now checks every selected source file for a target language before reporting leftovers, so one failed file does not prevent the rest from being audited.
+- **AUTO TRANSLATE**: Short all-caps acronyms and codes such as `XP` are allowed to remain unchanged instead of failing the final leftover check.
+- **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.2.2 command surface.
+- **DOCS**: Versioned docs and migration guidance now reflect the current 4.3.1 command surface.
 
 ## What's New in 4.1.0
 
@@ -144,7 +153,7 @@ Note: manager route `i18ntk --command=backup` is disabled in current builds. Use
 | `i18ntk --command=translate` / `i18ntk-translate` | Auto-translates locale JSON using configured provider behavior. | Missing, empty, untranslated-marker, source-copy, likely-English, or visibly corrupt target values by default. | Target locale JSON files and translation reports. Existing translated values are kept unless `--translate-all` is used. |
 | `i18ntk --command=sizing` / `i18ntk-sizing` | Estimates translated string length expansion and layout risk. | Text length, expansion ratios, placeholder-bearing strings. | Sizing report. Does not edit locale files. |
 | `i18ntk --command=summary` / `i18ntk-summary` | Shows project translation status. | Configured locales, reports, completeness status. | Console/report output only. |
-| `i18ntk-fixer` | Fixes placeholder and missing-marker issues. | Placeholder corruption, missing translation markers, configured language files. | Locale JSON files when fixes are applied. Use dry-run options where available before bulk edits. |
+| `i18ntk-fixer` | Fixes placeholder and missing-marker issues, and can audit English source files with `--check-placeholders`. | Placeholder corruption, missing translation markers, configured language files, `[LANG] ...` leftovers in English locales. | Locale JSON files when fixes are applied. Use dry-run options where available before bulk edits. |
 | `i18ntk-backup` | Creates, verifies, restores, and cleans locale backups. | Locale JSON files and backup manifests. | Backup archives/manifests, or restored locale files when using restore. |
 
 ## Common Options
@@ -503,7 +512,7 @@ Example:
 
 ```json
 {
-  "version": "4.2.2",
+  "version": "4.3.1",
   "sourceDir": "./locales",
   "i18nDir": "./locales",
   "outputDir": "./i18ntk-reports",
@@ -565,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.2.2](./docs/migration-guide-v4.2.2.md)
+- [Migration Guide v4.3.1](./docs/migration-guide-v4.3.1.md)
 
 ## Security
 

package/main/i18ntk-fixer.js

@@ -13,9 +13,10 @@ const fs = require('fs');
 const SecurityUtils = require('../utils/security');
 const cliHelper = require('../utils/cli-helper');
 const { loadTranslations, t } = require('../utils/i18n-helper');
-const { getUnifiedConfig, parseCommonArgs, displayHelp } = require('../utils/config-helper');
-const JsonOutput = require('../utils/json-output');
-const SetupEnforcer = require('../utils/setup-enforcer');
+const { getUnifiedConfig, parseCommonArgs, displayHelp } = require('../utils/config-helper');
+const JsonOutput = require('../utils/json-output');
+const SetupEnforcer = require('../utils/setup-enforcer');
+const FixerCommand = require('./manage/commands/FixerCommand');
 
 // Ensure setup is complete before running
 (async () => {
@@ -94,13 +95,17 @@ class I18nFixer {
     }
   }
 
-  async run() {
-    await this.initialize();
-    console.log(t('fixer.running'));
-    // Placeholder for actual fixing logic
-    console.log(t('fixer.completed'));
-  }
-}
+  async run(options = {}) {
+    const command = new FixerCommand(this.config, null);
+    const result = await command.execute(options);
+
+    if (result && result.success === false) {
+      throw new Error(result.error || 'Fixer command failed');
+    }
+
+    return result;
+  }
+}
 
 module.exports = I18nFixer;
 
@@ -110,4 +115,4 @@ if (require.main === module) {
     console.error('I18n Fixer failed:', error);
     process.exit(1);
   });
-}
+}

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();
+}