i18ntk 1.6.1 → 1.6.2

package/README.md

@@ -2,12 +2,14 @@
 
 ![i18ntk Logo](docs/screenshots/i18ntk-logo-public.PNG)
 
-**Version:** 1.6.0  
-**Last Updated:** 2025-08-08  
+**Version:** 1.6.2 
+**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)
 
+> **🚨 Latest Update (v1.6.2)**: Critical npm package installation bug resolved from 1.6.0 and 1.6.1.
+
 **🚀 The fastest way to manage translations across any framework or vanilla JavaScript projects**
 
 **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.
@@ -75,21 +77,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.2",
+  "sourceDir": "./locales",
+  "outputDir": "./i18ntk-reports",
+  "defaultLanguage": "en",
+  "supportedLanguages": ["en", "es", "fr", "de"],
+  "performance": {
+    "mode": "extreme",
+    "batchSize": 1000,
+    "concurrency": 16
   }
-};
+}
 ```
 
 ## 🌍 Language Optimization
@@ -148,8 +150,9 @@ 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

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

@@ -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');
 
 
 

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

@@ -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.2",
   "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",
@@ -69,11 +69,7 @@
     "settings/",
     "ui-locales/",
     "LICENSE",
-    "README.md",
-    "!scripts/prepublish.js",
-    "!scripts/test-runner.js",
-    "!scripts/path-utils.test.js",
-    "!scripts/reset-defaults.test.js"
+    "README.md"
   ],
   "scripts": {
     "start": "node main/i18ntk-manage.js",
@@ -93,7 +89,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",

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!');
 }

package/scripts/export-translations.js

@@ -1,84 +1,84 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const { loadTranslations, t } = require('../utils/i18n-helper');
-
-// Load translations
-loadTranslations('en');
-
-// Configuration
-const SOURCE_DIR = path.join(__dirname, '..', 'ui-locales');
-const TARGET_LANGUAGES = ['de', 'fr', 'es', 'ru', 'ja', 'zh'];
-
-function createLanguageTemplate(lang) {
-  const langDir = path.join(SOURCE_DIR, lang);
-  
-  if (!fs.existsSync(langDir)) {
-    fs.mkdirSync(langDir, { recursive: true });
-    console.log(t('exportTranslations.createdDirectory', { dir: langDir }));
-  }
-  
-  const enDir = path.join(SOURCE_DIR, 'en');
-  const enFiles = fs.readdirSync(enDir).filter(file => file.endsWith('.json'));
-  
-  console.log(t('exportTranslations.foundFiles', { count: enFiles.length }));
-  enFiles.forEach(file => {
-    console.log(`  - ${file}`);
-  });
-  
-  enFiles.forEach(file => {
-    const sourceFile = path.join(enDir, file);
-    const targetFile = path.join(langDir, file);
-    
-    if (!fs.existsSync(targetFile)) {
-      const sourceContent = JSON.parse(fs.readFileSync(sourceFile, 'utf8'));
-      const templateContent = createTemplateFromEnglish(sourceContent);
-      fs.writeFileSync(targetFile, JSON.stringify(templateContent, null, 2));
-      console.log(t('exportTranslations.createdTemplate', { lang, file }));
-    } else {
-      console.log(t('exportTranslations.skippedExisting', { lang, file }));
-    }
-  });
-}
-
-function createTemplateFromEnglish(obj) {
-  if (typeof obj === 'string') {
-    return '⚠️ TRANSLATION NEEDED ⚠️';
-  } else if (typeof obj === 'object' && obj !== null) {
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-      result[key] = createTemplateFromEnglish(value);
-    }
-    return result;
-  }
-  return obj;
-}
-
-function main() {
-  console.log(`\n${t('exportTranslations.title')}\n`);
-  console.log(t('exportTranslations.creatingTemplates', { count: TARGET_LANGUAGES.length }));
-  console.log();
-  
-  TARGET_LANGUAGES.forEach(lang => {
-    createLanguageTemplate(lang);
-  });
-  
-  const enFiles = fs.readdirSync(path.join(SOURCE_DIR, 'en')).filter(file => file.endsWith('.json'));
-  
-  console.log(`\n${t('exportTranslations.summary')}`);
-  console.log(t('exportTranslations.summaryLanguages', { count: TARGET_LANGUAGES.length }));
-  console.log(t('exportTranslations.summaryFilesPerLanguage', { count: enFiles.length }));
-  console.log(t('exportTranslations.summaryTotalFiles', { count: TARGET_LANGUAGES.length * enFiles.length }));
-  
-  console.log(`\n${t('exportTranslations.success')}`);
-  console.log(t('exportTranslations.location', { dir: SOURCE_DIR }));
-  console.log(t('exportTranslations.nextSteps'));
-  console.log();
-}
-
-if (require.main === module) {
-  main();
-}
-
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { loadTranslations, t } = require('../utils/i18n-helper');
+
+// Load translations
+loadTranslations('en');
+
+// Configuration
+const SOURCE_DIR = path.join(__dirname, '..', 'ui-locales');
+const TARGET_LANGUAGES = ['de', 'fr', 'es', 'ru', 'ja', 'zh'];
+
+function createLanguageTemplate(lang) {
+  const langDir = path.join(SOURCE_DIR, lang);
+  
+  if (!fs.existsSync(langDir)) {
+    fs.mkdirSync(langDir, { recursive: true });
+    console.log(t('exportTranslations.createdDirectory', { dir: langDir }));
+  }
+  
+  const enDir = path.join(SOURCE_DIR, 'en');
+  const enFiles = fs.readdirSync(enDir).filter(file => file.endsWith('.json'));
+  
+  console.log(t('exportTranslations.foundFiles', { count: enFiles.length }));
+  enFiles.forEach(file => {
+    console.log(`  - ${file}`);
+  });
+  
+  enFiles.forEach(file => {
+    const sourceFile = path.join(enDir, file);
+    const targetFile = path.join(langDir, file);
+    
+    if (!fs.existsSync(targetFile)) {
+      const sourceContent = JSON.parse(fs.readFileSync(sourceFile, 'utf8'));
+      const templateContent = createTemplateFromEnglish(sourceContent);
+      fs.writeFileSync(targetFile, JSON.stringify(templateContent, null, 2));
+      console.log(t('exportTranslations.createdTemplate', { lang, file }));
+    } else {
+      console.log(t('exportTranslations.skippedExisting', { lang, file }));
+    }
+  });
+}
+
+function createTemplateFromEnglish(obj) {
+  if (typeof obj === 'string') {
+    return '⚠️ TRANSLATION NEEDED ⚠️';
+  } else if (typeof obj === 'object' && obj !== null) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      result[key] = createTemplateFromEnglish(value);
+    }
+    return result;
+  }
+  return obj;
+}
+
+function main() {
+  console.log(`\n${t('exportTranslations.title')}\n`);
+  console.log(t('exportTranslations.creatingTemplates', { count: TARGET_LANGUAGES.length }));
+  console.log();
+  
+  TARGET_LANGUAGES.forEach(lang => {
+    createLanguageTemplate(lang);
+  });
+  
+  const enFiles = fs.readdirSync(path.join(SOURCE_DIR, 'en')).filter(file => file.endsWith('.json'));
+  
+  console.log(`\n${t('exportTranslations.summary')}`);
+  console.log(t('exportTranslations.summaryLanguages', { count: TARGET_LANGUAGES.length }));
+  console.log(t('exportTranslations.summaryFilesPerLanguage', { count: enFiles.length }));
+  console.log(t('exportTranslations.summaryTotalFiles', { count: TARGET_LANGUAGES.length * enFiles.length }));
+  
+  console.log(`\n${t('exportTranslations.success')}`);
+  console.log(t('exportTranslations.location', { dir: SOURCE_DIR }));
+  console.log(t('exportTranslations.nextSteps'));
+  console.log();
+}
+
+if (require.main === module) {
+  main();
+}
+
 module.exports = { createLanguageTemplate };