i18ntk 1.6.1 → 1.6.3

package/README.md

@@ -2,8 +2,8 @@
 
 ![i18ntk Logo](docs/screenshots/i18ntk-logo-public.PNG)
 
-**Version:** 1.6.0  
-**Last Updated:** 2025-08-08  
+**Version:** 1.6.3 
+**Last Updated:** 2025-08-09  
 **GitHub Repository:** [vladnoskv/i18ntk](https://github.com/vladnoskv/i18ntk)
 
 [![npm](https://img.shields.io/npm/dt/i18ntk.svg)](https://www.npmjs.com/package/i18ntk) [![npm version](https://badge.fury.io/js/i18ntk.svg)](https://badge.fury.io/js/i18ntk) [![Node.js Version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen.svg)](https://nodejs.org/) [![Downloads](https://img.shields.io/npm/dm/i18ntk.svg)](https://www.npmjs.com/package/i18ntk) [![GitHub stars](https://img.shields.io/github/stars/vladnoskv/i18ntk?style=social)](https://github.com/vladnoskv/i18ntk)
@@ -12,7 +12,7 @@
 
 **Framework Support:** Auto-detects popular libraries (React i18next, Vue i18n, i18next, Nuxt i18n, Svelte i18n) or works without a framework. i18ntk manages translation files and validation—it does NOT implement translations on pages.
 
-> **Zero dependencies** | **Optimized smaller package** | **Works with any framework** | **Enterprise-grade security**
+> **Zero dependencies** | **Works with any framework** | **Enterprise-grade security**
 
 > **v1.6.0** - **Ultra-extreme performance improvements to the i18ntk toolkit with 97% speed improvement** ⚡ Under 30ms for 200k keys (vs 1.2 seconds), up to 86% package size reduction, zero runtime dependencies.
 
@@ -20,7 +20,7 @@
 
 ```bash
 # Install globally
-npm install -g i18ntk@1.6.0
+npm i i18ntk
 
 # Interactive setup
 npx i18ntk init
@@ -75,21 +75,21 @@ i18ntk validate --source ./locales
 
 ## 🔧 Configuration
 
-Create `.i18ntk.config.js`:
-
-```javascript
-module.exports = {
-    // All paths are relative to your project root
-  sourceDir: './locales',
-  outputDir: './i18ntk-reports',
-  defaultLanguage: 'en',
-  supportedLanguages: ['en', 'es', 'fr', 'de'],
-  performance: {
-    mode: 'extreme', // extreme | ultra | optimized
-    batchSize: 1000,
-    concurrency: 16
+Configuration is managed through the `settings/i18ntk-config.json` file:
+
+```json
+{
+  "version": "1.6.3",
+  "sourceDir": "./locales",
+  "outputDir": "./i18ntk-reports",
+  "defaultLanguage": "en",
+  "supportedLanguages": ["en", "es", "fr", "de"],
+  "performance": {
+    "mode": "extreme",
+    "batchSize": 1000,
+    "concurrency": 16
   }
-};
+}
 ```
 
 ## 🌍 Language Optimization
@@ -148,15 +148,16 @@ your-project/
 │   ├── en.json
 │   ├── es.json
 │   └── ...
-├── i18ntk-reports/      # Generated reports
-└── .i18ntk.config.js  # Configuration
+├── i18ntk-reports/    # Generated reports
+└── settings/          # Configuration directory
+    └── i18ntk-config.json  # Main configuration file
 ```
 
 ## 🚨 Important Notes
 
 - **Locale files are backed up automatically** before optimization
 - **Use interactive optimizer** for safe locale management
-- **Zero breaking changes** from v1.5.x to v1.6.0
+- **Zero breaking changes** from v1.5.x to v1.6.3
 - **All improvements applied automatically** on update
 
 ## 📞 Support
@@ -168,4 +169,47 @@ your-project/
 
 ---
 
-**Made for the global development community** ❤️
+**Made for the global development community** ❤️
+
+## Migration Guide
+
+### Upgrading from Deprecated Versions
+
+#### From any version < 1.6.3 (DEPRECATED - use latest version)
+1. **Backup your current configuration**:
+   ```bash
+   cp -r ./.i18ntk ./.i18ntk-backup-$(date +%Y%m%d)
+   ```
+
+2. **Install the latest version**:
+   ```bash
+   npm install i18ntk@1.6.3
+   ```
+
+3. **Run configuration migration**:
+   ```bash
+   npx i18ntk@1.6.3 --migrate
+   ```
+
+4. **Verify installation**:
+   ```bash
+   npx i18ntk@1.6.3--validate
+   ```
+
+#### Preserved Features from 1.6.3
+- ✅ Ultra-extreme performance improvements
+- ✅ Enhanced security with PIN protection
+- ✅ Comprehensive backup & recovery
+- ✅ Edge case handling
+- ✅ Memory optimization
+- ✅ Advanced configuration management
+
+#### Breaking Changes
+- **None** - 1.6.3 is fully backward compatible
+
+### Migration Support
+If you encounter issues during migration:
+1. Check the [troubleshooting guide](docs/TROUBLESHOOTING.md)
+2. Open an issue on [GitHub](https://github.com/vladnoskv/i18ntk/issues)
+3. Join our [Discord community](https://discord.gg/i18ntk)
+

package/main/i18ntk-analyze.js

@@ -11,6 +11,7 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
 const { getUnifiedConfig, parseCommonArgs, displayHelp } = require('../utils/config-helper');
 const SecurityUtils = require('../utils/security');
 const AdminCLI = require('../utils/admin-cli');

package/main/i18ntk-autorun.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * i18n Toolkit - Automated Workflow Runner (1.6.0-ready)
+ * i18n Toolkit - Automated Workflow Runner (1.6.3-ready)
  * Executes predefined workflow steps for i18n management.
  * - Deterministic translation loading
  * - Safe config precedence (defaults < constructor < unified/CLI)
@@ -14,6 +14,7 @@ const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
 const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
 const { getUnifiedConfig, parseCommonArgs, displayHelp, ensureInitialized } = require('../utils/config-helper');
 const SecurityUtils = require('../utils/security');
 const configManager = require('../utils/config-manager');

package/main/i18ntk-complete.js

@@ -17,6 +17,7 @@ const { execSync } = require('child_process');
 const SecurityUtils = require('../utils/security');
 const { getUnifiedConfig, parseCommonArgs, displayHelp } = require('../utils/config-helper');
 const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
 
 
 
@@ -411,7 +412,7 @@ class I18nCompletionTool {
     const { fromMenu = false } = options;
     
     SecurityUtils.logSecurityEvent('I18n completion tool started', 'info', { 
-      version: '1.3.7',
+      version: this.config.version,
       nodeVersion: process.version,
       platform: process.platform
     });

package/main/i18ntk-init.js

@@ -19,7 +19,8 @@ const configManager = require('../utils/config-manager');
 const SecurityUtils = require('../utils/security');
 const AdminAuth = require('../utils/admin-auth');
 const UIi18n = require('./i18ntk-ui');
-
+const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
 const { getUnifiedConfig, parseCommonArgs, displayHelp } = require('../utils/config-helper');
 
 // Language configurations with native names

package/main/i18ntk-manage.js

@@ -34,6 +34,9 @@ const I18nSizingAnalyzer = require('./i18ntk-sizing');
 const SettingsCLI = require('../settings/settings-cli');
 const I18nDebugger = require('../scripts/debug/debugger');
 
+const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
+
 // Use unified configuration system
 const { getUnifiedConfig, ensureInitialized, validateSourceDir } = require('../utils/config-helper');
 

package/main/i18ntk-sizing.js

@@ -35,6 +35,7 @@ const fs = require('fs');
 const path = require('path');
 const { performance } = require('perf_hooks');
 const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
 const configManager = require('../utils/config-manager');
 const SecurityUtils = require('../utils/security');
 const { getUnifiedConfig } = require('../utils/config-helper');

package/main/i18ntk-summary.js

@@ -3,6 +3,7 @@
 const fs = require('fs');
 const path = require('path');
 const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
 const { getUnifiedConfig, parseCommonArgs, displayHelp } = require('../utils/config-helper');
 const SecurityUtils = require('../utils/security');
 const AdminCLI = require('../utils/admin-cli');

package/main/i18ntk-usage.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 /**
- * I18N USAGE ANALYSIS TOOLKIT - Version 1.4.3
+ * I18N USAGE ANALYSIS TOOLKIT - Version 1.6.3
  * 
  * This script analyzes source code to find unused translation keys,
  * missing translations, and provides comprehensive translation completeness analysis.
  * 
- * NEW in v1.4.3:
+ * NEW in v1.6.3:
  * - Modular folder structure support
  * - Recursive translation file discovery
  * - NOT_TRANSLATED analysis
@@ -25,6 +25,7 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
 const configManager = require('../utils/config-manager');
 const SecurityUtils = require('../utils/security');
 const AdminCLI = require('../utils/admin-cli');

package/main/i18ntk-validate.js

@@ -38,6 +38,7 @@ if (isUppercase) {
 const fs = require('fs');
 const path = require('path');
 const { loadTranslations, t } = require('../utils/i18n-helper');
+loadTranslations(process.env.I18NTK_LANG || 'en');
 const configManager = require('../utils/config-manager');
 const SecurityUtils = require('../utils/security');
 const AdminCLI = require('../utils/admin-cli');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18ntk",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "i18ntk (i18n Toolkit) - Ultra-extreme performance enterprise-grade internationalization management toolkit with 97% performance improvement (15.38ms for 200k keys), advanced security with PIN protection, comprehensive backup & recovery, and edge case handling for JavaScript/TypeScript projects",
   "keywords": [
     "i18n",
@@ -47,6 +47,11 @@
   "author": "Vladimir Noskov (https://github.com/vladnoskv)",
   "type": "commonjs",
   "main": "main/i18ntk-manage.js",
+  "exports": {
+    ".": "./main/i18ntk-manage.js",
+    "./ui-locales/*": "./ui-locales/*",
+    "./package.json": "./package.json"
+  },
   "bin": {
     "i18ntk": "main/i18ntk-manage.js",
     "i18ntk-init": "main/i18ntk-init.js",
@@ -69,13 +74,19 @@
     "settings/",
     "ui-locales/",
     "LICENSE",
-    "README.md",
-    "!scripts/prepublish.js",
-    "!scripts/test-runner.js",
-    "!scripts/path-utils.test.js",
-    "!scripts/reset-defaults.test.js"
+    "package.json",
+    "README.md"
   ],
+  "sideEffects": false,
   "scripts": {
+    "docs:cleanup-deprecated": "node dev/cleanup-deprecated-notices.js",
+    "i18ntk": "node main/i18ntk-manage.js",
+    "i18ntk:init": "node main/i18ntk-init.js",
+    "i18ntk:analyze": "node main/i18ntk-analyze.js",
+    "i18ntk:validate": "main/i18ntk-validate.js",
+    "i18ntk:usage": "node main/i18ntk-usage.js",
+    "i18ntk:complete": "node main/i18ntk-complete.js",
+    "i18ntk-sizing": "main/i18ntk-sizing.js",
     "start": "node main/i18ntk-manage.js",
     "settings": "node settings/settings-cli.js",
     "i18ntk:doctor": "node main/i18ntk-doctor.js",
@@ -93,7 +104,8 @@
     "summary": "node main/i18ntk-summary.js",
     "full-coverage": "npm run complete && npm run analyze",
     "verify-package": "node dev/verify-package.js",
-    "prepublishOnly": "npm run verify-package && node scripts/prepublish.js",
+    "smoke:pack": "node scripts/smoke-pack.js",
+    "prepublishOnly": "npm run verify-package && npm run smoke:pack",
     "test": "node scripts/test-runner.js",
     "test:all": "node scripts/test-runner.js",
     "test:quick": "node scripts/test-runner.js --quick",
@@ -115,7 +127,13 @@
     "languages:select": "node settings/settings-cli.js",
     "languages:list": "node settings/settings-cli.js --list-languages",
     "languages:status": "node settings/settings-cli.js --language-status",
-    "languages:restore": "echo 'Language restoration - use settings CLI for manual configuration'"
+    "languages:restore": "echo 'Language restoration - use settings CLI for manual configuration'",
+    "version:update": "node scripts/version-updater.js",
+    "version:check": "node scripts/version-checker.js",
+    "version:bump": "node scripts/version-bump.js",
+    "docs:update-versions": "node scripts/update-docs-versions.js",
+    "release:prepare": "npm run version:check && npm run docs:update-versions && npm run prepublishOnly",
+    "deprecate:old-versions": "node scripts/deprecate-versions.js"
   },
   "dependencies": {},
   "engines": {
@@ -126,9 +144,9 @@
   },
   "preferGlobal": true,
   "versionInfo": {
-    "version": "1.6.1",
-    "releaseDate": "08/08/2025",
-    "lastUpdated": "08/08/2025",
+    "version": "1.6.3",
+    "releaseDate": "27/07/2025",
+    "lastUpdated": "09/08/2025",
     "maintainer": "Vladimir Noskov",
     "changelog": "./CHANGELOG.md",
     "documentation": "./README.md",
@@ -146,12 +164,16 @@
     ],
     "breakingChanges": [],
     "deprecations": [
-      "<1.5.0",
       "1.0.x",
       "1.1.x",
       "1.2.x",
       "1.3.x",
-      "1.4.x"
+      "1.4.x",
+      "1.5.x",
+      "1.6.0",
+      "1.6.1",
+      "1.6.2"
+
     ],
     "nextVersion": "1.7.0",
     "supportedNodeVersions": ">=16.0.0",

package/scripts/debug/README.md

@@ -1,34 +1,34 @@
-# Debug Tools
-
-This folder contains debugging tools and utilities for the i18nTK project.
-
-## Debug Scripts
-
-- **debugger.js** - Main debugging script for identifying issues
-- **config-validator.js** - Configuration validation debugger
-- **translation-debugger.js** - Translation-specific debugging tools
-- **performance-profiler.js** - Performance analysis and profiling
-
-## Usage
-
-```bash
-# Run main debugger
-node scripts/debug/debugger.js
-
-# Validate configuration
-node scripts/debug/config-validator.js
-
-# Debug translations
-node scripts/debug/translation-debugger.js
-
-# Profile performance
-node scripts/debug/performance-profiler.js
-```
-
-## Debug Output
-
-Debug logs and reports are saved to `scripts/debug/logs/` with timestamps.
-
-## Version 1.5.0 Update
-
+# Debug Tools
+
+This folder contains debugging tools and utilities for the i18nTK project.
+
+## Debug Scripts
+
+- **debugger.js** - Main debugging script for identifying issues
+- **config-validator.js** - Configuration validation debugger
+- **translation-debugger.js** - Translation-specific debugging tools
+- **performance-profiler.js** - Performance analysis and profiling
+
+## Usage
+
+```bash
+# Run main debugger
+node scripts/debug/debugger.js
+
+# Validate configuration
+node scripts/debug/config-validator.js
+
+# Debug translations
+node scripts/debug/translation-debugger.js
+
+# Profile performance
+node scripts/debug/performance-profiler.js
+```
+
+## Debug Output
+
+Debug logs and reports are saved to `scripts/debug/logs/` with timestamps.
+
+## Version 1.5.0 Update
+
 **Critical Bug Fix**: These debug tools were moved from `/dev/debug/` to `/scripts/debug/` in v1.5.0 to resolve MODULE_NOT_FOUND errors when using `npx i18ntk`.

package/scripts/debug/debug-translation.js

@@ -1,56 +1,56 @@
-const fs = require('fs');
-const path = require('path');
-
-function getAllKeys(obj, prefix = '') {
-    let keys = [];
-    for (const key in obj) {
-        if (typeof obj[key] === 'object' && obj[key] !== null) {
-            keys = keys.concat(getAllKeys(obj[key], prefix ? `${prefix}.${key}` : key));
-        } else {
-            keys.push(prefix ? `${prefix}.${key}` : key);
-        }
-    }
-    return keys;
-}
-
-function loadLanguageData(lang) {
-    const baseDir = './ui-locales';
-    const langDir = path.join(baseDir, lang);
-    const files = fs.readdirSync(langDir).filter(f => f.endsWith('.json'));
-    
-    let langData = {};
-    for (const file of files) {
-        const filePath = path.join(langDir, file);
-        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-        langData = { ...langData, [file.replace('.json', '')]: content };
-    }
-    return langData;
-}
-
-console.log('🔍 Checking translation consistency...\n');
-
-const enData = loadLanguageData('en');
-const zhData = loadLanguageData('zh');
-
-const enKeys = getAllKeys(enData);
-const zhKeys = getAllKeys(zhData);
-
-console.log(`English keys: ${enKeys.length}`);
-console.log(`Chinese keys: ${zhKeys.length}`);
-
-const missingInZh = enKeys.filter(key => !zhKeys.includes(key));
-const extraInZh = zhKeys.filter(key => !enKeys.includes(key));
-
-if (missingInZh.length > 0) {
-    console.log('\n❌ Missing in Chinese:');
-    missingInZh.forEach(key => console.log(`   - ${key}`));
-}
-
-if (extraInZh.length > 0) {
-    console.log('\n⚠️  Extra in Chinese:');
-    extraInZh.forEach(key => console.log(`   - ${key}`));
-}
-
-if (missingInZh.length === 0 && extraInZh.length === 0) {
-    console.log('✅ All translations are consistent!');
+const fs = require('fs');
+const path = require('path');
+
+function getAllKeys(obj, prefix = '') {
+    let keys = [];
+    for (const key in obj) {
+        if (typeof obj[key] === 'object' && obj[key] !== null) {
+            keys = keys.concat(getAllKeys(obj[key], prefix ? `${prefix}.${key}` : key));
+        } else {
+            keys.push(prefix ? `${prefix}.${key}` : key);
+        }
+    }
+    return keys;
+}
+
+function loadLanguageData(lang) {
+    const baseDir = './ui-locales';
+    const langDir = path.join(baseDir, lang);
+    const files = fs.readdirSync(langDir).filter(f => f.endsWith('.json'));
+    
+    let langData = {};
+    for (const file of files) {
+        const filePath = path.join(langDir, file);
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        langData = { ...langData, [file.replace('.json', '')]: content };
+    }
+    return langData;
+}
+
+console.log('🔍 Checking translation consistency...\n');
+
+const enData = loadLanguageData('en');
+const zhData = loadLanguageData('zh');
+
+const enKeys = getAllKeys(enData);
+const zhKeys = getAllKeys(zhData);
+
+console.log(`English keys: ${enKeys.length}`);
+console.log(`Chinese keys: ${zhKeys.length}`);
+
+const missingInZh = enKeys.filter(key => !zhKeys.includes(key));
+const extraInZh = zhKeys.filter(key => !enKeys.includes(key));
+
+if (missingInZh.length > 0) {
+    console.log('\n❌ Missing in Chinese:');
+    missingInZh.forEach(key => console.log(`   - ${key}`));
+}
+
+if (extraInZh.length > 0) {
+    console.log('\n⚠️  Extra in Chinese:');
+    extraInZh.forEach(key => console.log(`   - ${key}`));
+}
+
+if (missingInZh.length === 0 && extraInZh.length === 0) {
+    console.log('✅ All translations are consistent!');
 }