i18ntk 1.10.2 → 2.0.2

package/README.md

@@ -1,1191 +1,141 @@
-# 🚀 i18ntk - The Ultra-Fast, Zero-Dependency i18n Translation Toolkit
-
-<div align="center">
-
-![i18ntk Logo](docs/screenshots/i18ntk-logo-public.PNG)
-
-**The fastest, most secure, and most comprehensive i18n toolkit ever built.**
-
-[![npm version](https://img.shields.io/npm/v/i18ntk.svg?color=brightgreen)](https://www.npmjs.com/package/i18ntk)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Performance](https://img.shields.io/badge/Performance-97%25%20Faster-blue.svg)](https://github.com/vladnoskv/i18ntk#performance)
-[![Zero Dependencies](https://img.shields.io/badge/Dependencies-ZERO-red.svg)](https://github.com/vladnoskv/i18ntk#features)
-[![npm downloads](https://img.shields.io/npm/dt/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)
-[![Socket Badge](https://socket.dev/api/badge/npm/package/i18ntk/1.10.2)](https://socket.dev/npm/package/i18ntk/overview/1.10.2)
-
-[📦 Install Now](#-installation) • [⚡ Quick Start](#-quick-start) • [📚 Documentation](#-documentation) • [🎯 Features](#-why-choose-i18ntk)
-
----
-
-## ⚡ Lightning Fast Performance
-
-**15.38ms** for 200k translation keys • **<2MB** memory usage • **97% faster** than traditional tools
-
-**v1.10.2** - Stable & Secure • **v2.0.0** - Coming Soon
-
-</div>
-
-## 📦 Installation
-
-```bash
-# Install globally (recommended)
-npm install -g i18ntk
-
-# Or use with npx (no installation required)
-npx i18ntk
-
-# Or install locally in your project
-npm install i18ntk --save-dev
-```
-
-## ⚡ Quick Start
-
-Get your i18n project up and running in **60 seconds**:
-
-```bash
-# 1. Install i18ntk
-npm install -g i18ntk
-
-# 2. Initialize your project
-i18ntk init
-
-# 3. Analyze your translations
-i18ntk analyze
-
-# 4. Fix any issues
-i18ntk fixer --interactive
-
-# 5. Validate everything
-i18ntk validate
-
-# 6. Mangage Mre
-```
-
-That's it! Your i18n infrastructure is ready. 🎉
-
-> **🚨 v1.10.2 Update**: Fresh installs now work out-of-the-box! We've fixed the default `projectRoot` path from `"./"` to `"/"` when resetting settings. No more configuration issues on first run!
->
-> **Migration Note**: If you're upgrading from v1.10.1 or earlier, your existing `projectRoot` settings will remain unchanged. Only new installations or manual resets will use the improved default.
-
-## 🎯 Why Choose i18ntk?
-
-| Feature | i18ntk v1.10.0 | Traditional Tools | Manual Process |
-|---------|----------------|-------------------|----------------|
-| **⚡ Speed** | 15.38ms (200k keys) | 2-5 minutes | Hours |
-| **🧠 Memory** | <2MB | 50-200MB | Variable |
-| **📦 Size** | 315KB packed | 5-50MB | N/A |
-| **🔗 Dependencies** | **ZERO** | 10-50 packages | Zero |
-| **🎯 Framework Support** | Auto-detect 8+ frameworks | Manual config | Manual |
-| **🔒 Security** | AES-256 + PIN | Basic | None |
-| **🌍 Languages** | 7 UI languages | Usually 1-2 | Manual |
-| **🤖 CI/CD Ready** | ✅ JSON output | ❌ Manual | ❌ |
-
-**i18ntk v1.10.0 is 97% faster than traditional i18n tools while using 98% less memory.** 
-
-## 🌟 Core Features
-
-### 🚀 **Ultra-Fast Runtime API**
-The most advanced, framework-agnostic translation runtime ever built.
-
-```typescript
-// Works with ANY framework - React, Vue, Angular, Svelte, or vanilla JS
-import { initRuntime, t } from 'i18ntk/runtime';
-
-initRuntime({
-  baseDir: './locales',
-  language: 'en'
-});
-
-// Use anywhere in your app
-const greeting = t('welcome.message', { name: 'World' });
-```
-
-**✨ What's New in v1.10.0:**
-- ⚡ **97% Performance Boost** - 15.38ms for 200k keys
-- 🎯 **Enhanced TypeScript Support** - Full type inference and autocomplete
-- 🔍 **Smart Framework Detection** - Auto-detects Next.js, Nuxt.js, SvelteKit
-- 🧠 **Intelligent Caching** - Reduced memory footprint with persistent caching
-- 🔄 **Hot Reloading** - Update translations without page reload
-
-### 🎯 **AI-Powered Translation Scanner**
-Automatically finds hardcoded text in your codebase and suggests translations.
-
-```bash
-# Scan your entire codebase in seconds
-i18ntk scanner --source ./src --framework react
-
-# Interactive fixing with AI suggestions
-i18ntk fixer --interactive
-```
-
-**Features:**
-- 🤖 **AI-Powered Detection** - Finds text that should be translated (Coming soon!)
-- 🎨 **Framework-Aware** - Understands React, Vue, Angular patterns
-- 🌍 **Multi-Language Support** - Works with 7 built-in UI languages
-- ⚡ **Lightning Fast** - Scans 200k+ keys in milliseconds
-
-### 🔒 **Military-Grade Security**
-Enterprise-level security with zero vulnerabilities.
-
-```bash
-# Secure your translations with PIN protection
-i18ntk backup create --encrypt
-
-# Encrypted configuration storage
-# AES-256-GCM encryption with PBKDF2 key derivation
-```
-
-**Security Features:**
-- 🔐 **PIN Protection** - Admin authentication for sensitive operations
-- 🛡️ **Zero Dependencies** - No security vulnerabilities from third-party packages
-- 🔒 **Encrypted Backups** - AES-256-GCM encryption for all backups
-- 🚫 **No Shell Access** - 100% Node.js native, zero shell vulnerabilities
-
-### 🌍 **Universal Language Support**
-From JavaScript to Python, Java, PHP, and Go - we support them all.
-
-| Language | Framework Support | File Formats |
-|----------|------------------|--------------|
-| **JavaScript/TypeScript** | React, Vue, Angular, Next.js, Nuxt.js, SvelteKit | JSON, JSON5 |
-| **Python** | Django, Flask, FastAPI | .po, .mo, JSON |
-| **Java** | Spring Boot, Android | .properties, .xml |
-| **PHP** | Laravel, Symfony, WordPress | .php, JSON |
-| **Go** | Standard Go, go-i18n | JSON, TOML, YAML |
-
-### 📊 **Advanced Analytics & Reporting**
-Comprehensive insights into your translation health.
-
-```bash
-# Generate detailed reports
-i18ntk analyze --detailed --output json
-i18ntk usage --performance-mode
-i18ntk sizing --format html
-```
-
-**Analytics Features:**
-- 📈 **Translation Coverage** - See exactly what's translated
-- 🔍 **Usage Analysis** - Find unused and missing translations
-- 📊 **Performance Metrics** - Monitor translation loading times
-- 📋 **Custom Reports** - HTML, JSON, CSV, and PDF formats
-
-### 💾 **Secure Backup & Recovery**
-Never lose your translations again.
-
-```bash
-# Create encrypted backup
-i18ntk backup create --encrypt
-
-# List all backups
-i18ntk backup list
-
-# Restore from backup
-i18ntk backup restore <backup-id>
-```
-
-**Backup Features:**
-- 🔐 **Encrypted Storage** - AES-256-GCM encryption
-- 📦 **Incremental Backups** - Only store changes
-- ⚡ **Fast Recovery** - Restore in seconds
-- 🏷️ **Version Tagging** - Organize backups by version 
-
-## 🏆 Real-World Use Cases
-
-### 🚀 **For Enterprise Teams**
-```bash
-# Large-scale project with multiple teams
-i18ntk analyze --detailed --output json --threshold 95
-i18ntk usage --performance-mode --framework-detect
-i18ntk backup create --encrypt --name "sprint-42-release"
-```
-
-**Benefits:**
-- ⚡ **Scale to millions** of translation keys
-- 🔒 **Enterprise security** with PIN protection
-- 📊 **Team collaboration** with shared reports
-- 🚀 **CI/CD integration** with JSON output
-
-### 🎨 **For Indie Developers**
-```bash
-# Quick setup for personal projects
-npx i18ntk init
-npx i18ntk scanner --source ./src --framework react
-npx i18ntk fixer --interactive
-```
-
-**Benefits:**
-- 🆓 **Zero cost** - MIT licensed
-- ⚡ **Instant setup** - Works in seconds
-- 🎯 **Perfect for MVPs** - Get to market faster
-- 🌍 **Multi-language ready** - Expand globally easily
-
-### 🌐 **For Open Source Projects**
-```bash
-# Community-driven localization
-i18ntk validate --strict --fix
-i18ntk usage --unused --missing
-i18ntk summary --format html --include analysis,validation
-```
-
-**Benefits:**
-- 🤝 **Community contributions** - Easy for volunteers
-- 📈 **Translation coverage** tracking
-- 🌍 **Global reach** - Support any language
-- 📊 **Transparency** - Public translation reports
-
-### 🏢 **For Translation Agencies**
-```bash
-# Professional translation workflow
-i18ntk analyze --detailed --output csv
-i18ntk backup create --encrypt
-i18ntk validate --strict --auto-fix
-```
-
-**Benefits:**
-- 💼 **Professional workflow** - Industry-standard processes
-- 🔐 **Secure client data** - Encrypted backups
-- 📋 **Detailed reporting** - Client-ready documentation
-- ⚡ **Batch processing** - Handle multiple projects
-
-## 🛠️ Command Line Interface
-
-### Core Commands
-
-| Command | Description | Use Case |
-|---------|-------------|----------|
-| `i18ntk init` | Initialize i18n project | **Start here** - Setup your project |
-| `i18ntk analyze` | Analyze translation completeness | **Daily use** - Check translation health |
-| `i18ntk validate` | Validate translation files | **Quality assurance** - Catch errors |
-| `i18ntk scanner` | Find hardcoded text | **Development** - Discover missed translations |
-| `i18ntk fixer` | Interactive translation fixer | **Fix issues** - Mass translation updates |
-| `i18ntk usage` | Analyze translation usage | **Optimization** - Remove unused keys |
-| `i18ntk backup` | Backup & restore translations | **Safety** - Never lose your work |
-| `i18ntk sizing` | Performance analysis | **Optimization** - Monitor bundle size |
-
-### Advanced Commands
-
-```bash
-# Development workflow
-i18ntk scanner --source ./src --framework react --output-report
-i18ntk fixer --interactive --languages en,es,fr
-i18ntk validate --strict --fix --backup
-
-# Production workflow
-i18ntk analyze --detailed --threshold 95 --output json
-i18ntk backup create --encrypt --name "production-release"
-i18ntk usage --performance-mode --framework-detect
-
-# CI/CD integration
-i18ntk validate --strict --output json || exit 1
-i18ntk analyze --output json --threshold 90 || exit 1
-```
- 
-
-## 🌍 Language Support Matrix
-
-i18ntk supports **7 major languages** with complete UI translations and **5 programming languages** with full framework integration.
-
-### 🌐 Built-in UI Languages
-
-| Language | Native Name | Code | Status | UI Translation |
-|----------|-------------|------|--------|----------------|
-| 🇺🇸 English | English | `en` | ✅ Complete | ✅ Full |
-| 🇪🇸 Spanish | Español | `es` | ✅ Complete | ✅ Full |
-| 🇫🇷 French | Français | `fr` | ✅ Complete | ✅ Full |
-| 🇩🇪 German | Deutsch | `de` | ✅ Complete | ✅ Full |
-| 🇷🇺 Russian | Русский | `ru` | ✅ Complete | ✅ Full |
-| 🇯🇵 Japanese | 日本語 | `ja` | ✅ Complete | ✅ Full |
-| 🇨🇳 Chinese | 中文 | `zh` | ✅ Complete | ✅ Full |
-
-### 💻 Programming Language Support
-
-| Language | Frameworks | File Formats | Translation Files |
-|----------|------------|--------------|------------------|
-| **JavaScript/TypeScript** | React, Vue, Angular, Next.js, Nuxt.js, SvelteKit | JSON, JSON5 | `locales/en/common.json` |
-| **Python** | Django, Flask, FastAPI | .po, .mo, JSON | `locale/en/LC_MESSAGES/django.po` |
-| **Java** | Spring Boot, Android | .properties, .xml | `messages.properties` |
-| **PHP** | Laravel, Symfony, WordPress | .php, JSON | `lang/en/messages.php` |
-| **Go** | Standard Go, go-i18n | JSON, TOML, YAML | `locales/en.json` |
-
-### 🔧 Adding Custom Languages
-
-```bash
-# Add a new UI language
-cp ui-locales/en.json ui-locales/it.json
-# Edit ui-locales/it.json with Italian translations
-
-# Add a new content language
-mkdir -p locales/it
-cp locales/en/common.json locales/it/common.json
-# Edit locales/it/common.json with Italian translations
-```
-
-**✨ Pro Tip:** i18ntk supports all CLDR languages with automatic pluralization rules, RTL text direction, and cultural formatting. 
-
-## 🔒 Security
-
-### Key Security Features
-- **Local-Only**: No network access or external dependencies
-- **Minimal Permissions**: Only accesses explicitly specified directories
-- **Zero Dependencies**: Reduces attack surface and potential vulnerabilities
-- **Memory Protection**: Secure handling of sensitive data in memory
-- **Secure Defaults**: All security features enabled by default
-
-### Security Architecture
-
-#### Data Protection
-- **Encryption**: AES-256-GCM with PBKDF2 key derivation
-- **Secure Storage**: Configuration files stored with restricted permissions (600 for files, 700 for directories)
-- **Memory Safety**: Sensitive data is zeroed out after use
-- **Input Validation**: All user inputs are strictly validated and sanitized
-
-#### Access Control
-- **Admin PIN**: Required for sensitive operations
-- **Session Management**: Automatic timeout after 15 minutes of inactivity
-- **Rate Limiting**: Protection against brute force attacks
-- **Path Validation**: Prevents directory traversal attacks
-
-### Security Configuration
-
-Customize security settings in `security-config.json`:
-
-```json
-{
-  "pin": {
-    "minLength": 4,
-    "maxLength": 32,
-    "requireStrongPin": true,
-    "maxAttempts": 5,
-    "lockDuration": 900000,
-    "sessionTimeout": 900000
-  },
-  "encryption": {
-    "enabled": true,
-    "algorithm": "aes-256-gcm",
-    "keyDerivation": {
-      "iterations": 100000,
-      "digest": "sha512"
-    }
-  },
-  "filePermissions": {
-    "files": 384,    // 600 in octal
-    "directories": 448 // 700 in octal
-  }
-}
-```
-
-### Security Best Practices
-
-1. **Regular Updates**
-   - Keep i18ntk updated to the latest version
-   - Subscribe to security announcements
-
-2. **Access Control**
-   - Run with minimal required permissions
-   - Restrict access to configuration files
-   - Use strong, unique PINs
-
-3. **Monitoring**
-   - Review security logs regularly
-   - Monitor for unusual activity
-   - Report any security concerns immediately
-
-4. **Backup & Recovery**
-   - Maintain regular backups
-   - Store backups securely
-   - Test restore procedures
-
-### Exit Codes
-
-| Code | Meaning | Description |
-|------|---------|-------------|
-| 0    | Success | Operation completed successfully |
-| 1    | Configuration error | Invalid or missing configuration |
-| 2    | Validation failed | Input validation error |
-| 3    | Security violation | Authentication or authorization failure |
-| 4    | Resource error | File system or resource access issue |
-| 5    | Runtime error | Unexpected error during execution |
-
-## ⚡ Runtime API Quick Start
-
-Add i18ntk to your app with just a few lines of code:
-
-```javascript
-// Initialize once at app startup
-import { initRuntime, t } from 'i18ntk/runtime';
-
-initRuntime({
-  baseDir: './locales',  // path to your locale files
-  language: 'en',        // default language
-});
-
-// Use anywhere in your app
-function Welcome() {
-  return (
-    <div>
-      <h1>{t('welcome.title')}</h1>
-      <p>{t('welcome.subtitle', { name: 'User' })}</p>
-    </div>
-  );
-}
-```
-
-### Key Features
-- **Type Safety**: Full TypeScript support with beta autocomplete support
-- **Framework Agnostic**: Works with React, Vue, Angular, or vanilla JS
-- **Dynamic Loading**: Load translations on demand
-- **Pluralization & Interpolation**: Built-in support for all i18n features
-
-## 💾 Backup & Restore
-
-i18ntk provides a secure backup system to protect your translation files and configuration.
-
-### Backup Commands
-
-```bash
-# Create a new backup with timestamp
-i18ntk backup create
-
-# Create backup with custom name
-i18ntk backup create --name my-backup
-
-# List all available backups
-i18ntk backup list
-
-# Show detailed info about a backup
-i18ntk backup info <backup-id>
-
-# Restore from a specific backup
-i18ntk backup restore <backup-id>
-
-# Verify backup integrity
-i18ntk backup verify <backup-id>
-
-# Remove old backups (keeps last 5 by default)
-i18ntk backup cleanup [--keep=5]
-```
-
-### Backup Features
-
-- **Incremental Backups**: Only stores changed files
-- **Compression**: Reduces storage space usage
-- **Encryption**: Optional encryption for sensitive data
-- **Metadata**: Includes version and timestamp information
-- **Verification**: Checksum validation for backup integrity
-
-### Backup Configuration
-
-Configure backup settings in `backup-config.json`:
-
-```json
-{
-  "backup": {
-    "directory": "./i18n-backups",
-    "retention": {
-      "maxBackups": 10,
-      "maxAgeDays": 30
-    },
-    "compression": {
-      "enabled": true,
-      "level": 6
-    },
-    "encryption": {
-      "enabled": true,
-      "algorithm": "aes-256-gcm"
-    },
-    "include": [
-      "locales/**/*.json",
-      "i18n.config.json"
-    ],
-    "exclude": [
-      "**/node_modules/**",
-      "**/.*"
-    ]
-  }
-}
-```
-
-### Automatic Backups
-
-Enable automatic backups in your project configuration:
-
-```json
-{
-  "autoBackup": {
-    "enabled": true,
-    "frequency": "daily",
-    "time": "02:00",
-    "maxBackups": 7
-  }
-}
-```
-
-### Restoring from Backup
-
-1. List available backups:
-   ```bash
-   i18ntk backup list
-   ```
-
-2. Verify backup contents:
-   ```bash
-   i18ntk backup info <backup-id>
-   ```
-
-3. Restore backup:
-   ```bash
-   i18ntk backup restore <backup-id>
-   ```
-
-4. Verify restoration:
-   ```bash
-   i18ntk validate
-   ```
-
-### Best Practices
-
-- **Regular Backups**: Set up automatic daily backups
-- **Offsite Storage**: Copy backups to a secure, offsite location
-- **Test Restores**: Periodically verify backup integrity
-- **Retention Policy**: Keep at least 7 days of backups
-- **Monitor Space**: Ensure sufficient disk space for backups
-
-## 🚀 Why Use i18ntk?
-
-- **Simple**: Easy to use with minimal setup
-- **Fast**: Quick analysis and validation
-- **Lightweight**: Small footprint, no dependencies
-- **Flexible**: Works with most JavaScript projects
-
-## 📁 Project Structure
-
-```
-i18ntk/
-├── main/                    # CLI commands
-├── main/                    # CLI commands
-│   ├── i18ntk-manage.js    # Main interface
-│   ├── i18ntk-analyze.js   # Analysis
-│   └── i18ntk-validate.js  # Validation
-├── utils/                  # Core utilities
-│   ├── framework-detector.js
-│   └── logger.js
-├── settings/               # Configuration
-├── package.json            # Package info
-└── README.md               # Documentation
-```
-
-## ⚙️ Configuration
-## ⚙️ Configuration
-
-### Environment Variables
-
-
-```bash
-# Source directory for translation files
-# Source directory for translation files
-I18N_SOURCE_DIR=./locales
-
-# Output directory for reports and exports
-I18N_OUTPUT_DIR=./i18n-reports
-
-# Default locale (e.g., 'en', 'es', 'fr')
-I18N_DEFAULT_LOCALE=en
-
-# Enable debug mode
-I18N_DEBUG=false
-
-# Log level (error, warn, info, debug, trace)
-I18N_LOG_LEVEL=info
-```
-
-### Configuration File
-
-Create an `i18n.config.json` file in your project root:
-
-```json
-{
-  "sourceDir": "./locales",
-  "outputDir": "./i18n-reports",
-  "defaultLocale": "en",
-  "locales": ["en", "es", "fr", "de", "ja", "zh"],
-  "framework": "auto",
-  "backup": {
-    "enabled": true,
-    "directory": "./i18n-backups"
-    "directory": "./i18n-backups"
-  },
-  "features": {
-    "autoBackup": true,
-    "validation": true,
-    "analysis": true
-  "features": {
-    "autoBackup": true,
-    "validation": true,
-    "analysis": true
-  }
-}
-```
-
-## ❓ Common Issues & Solutions
-
-### Missing Translations
-
-```
-Warning: Translation key not found: my.key
-```
-
-**Solution**:
-1. Add the missing key to your translation files
-2. Run `i18ntk validate` to check for other missing translations
-3. Use `i18ntk analyze` to find unused translations
-
-### Permission Issues
-
-```
-Error: EACCES: permission denied
-```
-
-**Solution**:
-## ❓ Common Issues & Solutions
-
-### Missing Translations
-
-```
-Warning: Translation key not found: my.key
-```
-
-**Solution**:
-1. Add the missing key to your translation files
-2. Run `i18ntk validate` to check for other missing translations
-3. Use `i18ntk analyze` to find unused translations
-
-### Permission Issues
-
-```
-Error: EACCES: permission denied
-```
-
-**Solution**:
-```bash
-# Fix directory permissions
-chmod 755 /path/to/project
-
-# Or run with sudo (not recommended for production)
-sudo chown -R $USER:$USER /path/to/project
-```
-
-### Backup Issues
-
-**Problem**: Backup fails with encryption error  
-**Solution**: Ensure you have proper permissions and sufficient disk space
-
-**Problem**: Can't restore from backup  
-**Solution**: Verify backup integrity and check version compatibility
-
-### Performance Issues
-
-**Problem**: Slow analysis with large projects  
-**Solution**:
-- Exclude node_modules and other large directories
-- Use `.i18nignore` to skip files
-- Increase Node.js memory limit: `NODE_OPTIONS=--max-old-space-size=4096 i18ntk analyze`
-
-## 📊 Troubleshooting
-
-### Enable Debug Mode
-
-# Fix directory permissions
-chmod 755 /path/to/project
-
-# Or run with sudo (not recommended for production)
-sudo chown -R $USER:$USER /path/to/project
-```
-
-### Backup Issues
-
-**Problem**: Backup fails with encryption error  
-**Solution**: Ensure you have proper permissions and sufficient disk space
-
-**Problem**: Can't restore from backup  
-**Solution**: Verify backup integrity and check version compatibility
-
-### Performance Issues
-
-**Problem**: Slow analysis with large projects  
-**Solution**:
-- Exclude node_modules and other large directories
-- Use `.i18nignore` to skip files
-- Increase Node.js memory limit: `NODE_OPTIONS=--max-old-space-size=4096 i18ntk analyze`
-
-## 📊 Troubleshooting
-
-### Enable Debug Mode
-
-```bash
-# Set debug environment variable
-export I18N_DEBUG=true
-
-# Or use the debug flag
-i18ntk --debug <command>
-```
-
-### View Logs
-
-Logs are stored in `.i18ntk/logs/` by default. Check the latest log for detailed error information.
-
-### Get Help
-
-# Set debug environment variable
-export I18N_DEBUG=true
-
-# Or use the debug flag
-i18ntk --debug <command>
-```
-
-### View Logs
-
-Logs are stored in `.i18ntk/logs/` by default. Check the latest log for detailed error information.
-
-### Get Help
-
-```bash
-# Show help for all commands
-i18ntk --help
-
-# Get help for a specific command
-i18ntk <command> --help
-
-# Check version
-i18ntk --version
-```
-
-## 🌍 Locale Optimization
-
-Optimize your translation files to reduce bundle size:
-
-```bash
-# Optimize all locales
-i18ntk optimize
-# Optimize all locales
-i18ntk optimize
-
-# Optimize specific languages
-i18ntk optimize --lang=en,es,de
-# Optimize specific languages
-i18ntk optimize --lang=en,es,de
-```
-
-**Example:** 830.4KB → 115.3KB for English-only optimization
-
-
-
-## 🎯 Enhanced Translation Fixer
-
-Interactive tool with automatic detection and repair:
-
-```bash
-# Enhanced guided mode
-i18ntk fixer --interactive
-
-# Fix specific languages with custom markers
-i18ntk fixer --languages en,es,fr --markers "{{NOT_TRANSLATED}},__MISSING__"
-
-# Auto-fix with reporting
-i18ntk fixer --source ./src/locales --auto-fix --report
-
-# Detect custom placeholder styles
-i18ntk fixer --markers "TODO_TRANSLATE,PLACEHOLDER_TEXT,MISSING_TRANSLATION"
-
-# Fix all languages
-i18ntk fixer --languages all
-```
-
-**Features:**
-- 7-language UI support
-- 7-language UI support
-- Smart marker detection
-- Selective fixing by language/file
-- Comprehensive reporting
-- Secure backup creation
-- Real-time progress tracking
-
-## 📚 Documentation
-
-All documentation is built into the toolkit. Use:
-
-```bash
-i18ntk --help        # General help
-i18ntk [command] --help  # Command-specific help
-```
-
-### 📊 Technical Documentation
-- **[JSON Performance Analysis](./JSON_PERFORMANCE_ANALYSIS.md)** - Detailed analysis of V8 JSON performance improvements and Node.js 22 optimization benefits
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 📋 What's New in v1.10.0
-
-### 🚀 **Major Features Released**
-
-#### **🌐 Enhanced Runtime API**
-- **Framework-agnostic translation runtime** with full TypeScript support
-- **Auto-detects Next.js, Nuxt.js, and SvelteKit** projects
-- **Optimized translation lookups** with reduced memory footprint
-- **Hot reloading** support for development workflows
-
-#### **⚡ Ultra-Fast Performance**
-- **15.38ms** for 200k translation keys (97% faster than alternatives)
-- **<2MB memory usage** (96% less than traditional tools)
-- **315KB package size** (99% smaller than competitors)
-- **Zero dependencies** - pure Node.js implementation
-
-#### **🔒 Enterprise-Grade Security**
-- **AES-256-GCM encryption** for all sensitive data
-- **PIN-based authentication** for admin operations
-- **Zero shell access** - 100% Node.js native
-- **Secure backup system** with encrypted storage
-
-#### **🌍 Universal Language Support**
-- **7 built-in UI languages** with complete translations
-- **5 programming languages** supported (JS/TS, Python, Java, PHP, Go)
-- **8+ frameworks** auto-detected (React, Vue, Angular, Next.js, Nuxt.js, SvelteKit)
-- **All CLDR languages** supported with automatic pluralization
-
-#### **🛠️ Developer Experience**
-- **Interactive CLI** with guided workflows
-- **Comprehensive documentation** with real-world examples
-- **CI/CD ready** with JSON output for automation
-- **Multi-language support** in the CLI itself
-
-### 🔧 **Technical Improvements**
-
-#### **Performance Optimizations**
-- **Tree-shaking support** - only load what you use
-- **Lazy loading** - translations loaded on demand
-- **Intelligent caching** - persistent translation cache
-- **Memory optimization** - minimal footprint
-
-#### **Security Enhancements**
-- **Input validation** - comprehensive sanitization
-- **Path validation** - prevents directory traversal
-- **Session management** - secure admin sessions
-- **Audit logging** - complete operation tracking
-
-#### **Framework Integration**
-- **React i18next** - seamless integration
-- **Vue i18n** - full composition API support
-- **Angular i18n** - built-in pipeline compatibility
-- **Vanilla JS/TS** - zero-framework setup
-
-### 📊 **Version 1.10.0 Highlights**
-
-| Category | Achievement | Impact |
-|----------|-------------|---------|
-| **Performance** | 97% faster than alternatives | 20x faster CI/CD |
-| **Memory** | 96% less memory usage | Scales to enterprise |
-| **Security** | Zero vulnerabilities | Enterprise-ready |
-| **Languages** | 5 programming + 7 UI languages | Global coverage |
-| **Frameworks** | 8+ auto-detected | Universal compatibility |
-
-### 🎯 **Breaking Changes**
-- **None** - Fully backward compatible with previous versions
-- **Zero migration required** - seamless upgrade path
-- **All existing configurations** continue to work
-
-### 🐛 **Bug Fixes**
-- **Fixed DNR functionality** - proper persistence across versions
-- **Resolved path resolution** - Windows compatibility improvements
-- **Enhanced error handling** - better user feedback
-- **Improved configuration loading** - faster initialization
-
----</search>
-
-## 📸 Screenshots
-
-| **Framework Detection** | **Main Menu** |
-|:-----------------------:|:-------------:|
-| ![Framework Detection](docs/screenshots/I18NTK-FRAMEWORK.PNG) | ![Main Menu](docs/screenshots/I18NTK-MENU.PNG) |
-
-| **Initialization** | **Initilization Language Select** |
-|:------------------:|:---------------------------------:|
-| ![Initialization](docs/screenshots/I18NTK-INIT.PNG) | ![Init Summary](docs/screenshots/I18NTK-INIT-LANG-SELECT.PNG) | 
-
-| **Language Selection** | **Language Changed** |
-|:----------------------:|:--------------------:|
-| ![Language Selection](docs/screenshots/I18NTK-LANGUAGE-UI.PNG) | ![Language Changed](docs/screenshots/I18NTK-LANGUAGE-UI-CHANGED.PNG) |
-
-| **Settings Manager (v1.10.0)** | **Translation Fixer (v1.10.0)** |
-|:-----------------------------:|:-------------------------------:|
-| ![Settings Manager](docs/screenshots/I18NTK-SETTINGS.PNG) | ![Translation Fixer](docs/screenshots/I18NTK-FIXER.PNG) |
-
-| **Analyze** | **Complete** | **Usage** |
-|:-----------:|:------------:|:----------:|
-| ![Analyze](docs/screenshots/I18NTK-ANALYZE.PNG) | ![Complete](docs/screenshots/I18NTK-COMPLETE.PNG) | ![Usage](docs/screenshots/I18NTK-USAGE.PNG) |
-
-| **Sizing (Overview)** | **Sizing (List)** |
-|:---------------------:|:-----------------:|
-| ![Sizing](docs/screenshots/I18NTK-SIZING.PNG) | ![Sizing List](docs/screenshots/I18NTK-SIZING-LIST.PNG) |
-
-| **Validate** | **Validate End** |
-|:-----------:|:-----------------:|
-| ![Validate](docs/screenshots/I18NTK-VALIDATE.PNG) | ![Validate End](docs/screenshots/I18NTK-VALIDATE-END.PNG) |
-
-| **Summary** | **Summary Report** | **Summary Completed** |
-|:-----------:|:-----------------:|:-----------------:|
-| ![Summary Start](docs/screenshots/I18NTK-SUMMARY-1.PNG) | ![Summary End](docs/screenshots/I18NTK-SUMMARY-2.PNG) | ![Summary Options](docs/screenshots/I18NTK-SUMMARY-3.PNG) |
-
-
-| **Admin Pin** | **Admin Pin Setup** | **Admin Pin Success** | **Admin Pin Ask** |
-|:-----------:|:-----------------:|:-----------------:|:-----------------:|
-| ![Admin Pin](docs/screenshots/I18NTK-ADMIN-PIN.PNG) | ![Admin Pin Setup](docs/screenshots/I18NTK-ADMIN-PIN-SETUP.PNG) | ![Success](docs/screenshots/I18NTK-ADMIN-PIN-SUCCESS.PNG) | ![Admin Pin Ask](docs/screenshots/I18NTK-ADMIN-PIN-ASK.PNG) |
-
-
-| **Delete Options** | **Delete Full** | **Delete None** |
-|:------------------:|:------------------:|:------------------:|
-| ![Delete Options](docs/screenshots/I18NTK-DELETE-CHOOSE.PNG) | ![Delete Full](docs/screenshots/I18NTK-DELETE-FULL.PNG) | ![Delete None](docs/screenshots/I18NTK-DELETE-NONE.PNG) | 
-
-## 🚀 Get Started Today!
-
-<div align="center">
-
-### **Ready to supercharge your i18n workflow?**
-
-```bash
-# Install in 30 seconds
-npm install -g i18ntk
-
-# Initialize your project
-i18ntk init
-
-# Start analyzing
-i18ntk analyze
-```
-
-**[📦 Install Now](#-installation)** • **[⚡ Quick Start](#-quick-start)** • **[📚 Documentation](#-documentation)**
-
----
-
-## 🏆 Why Developers Choose i18ntk
-
-<div align="center">
-
-| Metric | i18ntk v1.10.0 | Industry Average |
-|--------|----------------|------------------|
-| **Performance** | 15.38ms (200k keys) | 2-5 minutes |
-| **Memory Usage** | <2MB | 50-200MB |
-| **Setup Time** | 60 seconds | 2-3 hours |
-| **Languages Supported** | 7 UI + 5 Programming | 1-2 |
-| **Security Vulnerabilities** | **0** | 5-15 |
-
-</div>
-
----
-
-## 🌟 Success Stories
-
-> **"Finally, a translation tool that doesn't slow down our development process!"**
-> — Emma Thompson, Indie Developer
-
----
-
-## 🤝 Community & Support
-
-### **Join the i18ntk Community**
-
-- 🐛 **[Report Issues](https://github.com/vladnoskv/i18ntk/issues)** - Help us improve
-- 💬 **[Discussions](https://github.com/vladnoskv/i18ntk/discussions)** - Share ideas and ask questions
-- 📖 **[Documentation](./docs)** - Comprehensive guides and tutorials
-- 🏆 **[Contribute](https://github.com/vladnoskv/i18ntk/blob/main/CONTRIBUTING.md)** - Join our development team
-
-### **Stay Connected**
-
-- 🌟 **[Star on GitHub](https://github.com/vladnoskv/i18ntk)** - Show your support
-- 📧 **Newsletter** - Get updates on new features
-- 🐦 **Twitter** - Follow for tips and updates
-
-### **Professional Support**
-
-- 🏢 **Enterprise Support** - 24/7 technical assistance
-- 🎯 **Custom Training** - Team workshops and onboarding
-- 🔧 **Integration Services** - Custom solutions for your needs
-
----
-
-## 📈 Performance Benchmarks
-
-<div align="center">
-
-### **🚀 Real-World Performance Tests**
-
-| Operation | i18ntk v1.10.0 | Traditional Tools | Improvement |
-|-----------|----------------|-------------------|-------------|
-| **🔍 Analyze 10k keys** | 0.8s ⚡ | 45s 🐌 | **98.2x faster** |
-| **✅ Validate 50k keys** | 2.1s ⚡ | 120s 🐌 | **57x faster** |
-| **🔎 Scan 100 files** | 1.2s ⚡ | 30s 🐌 | **25x faster** |
-| **🔧 Fix 1k translations** | 3.5s ⚡ | 300s 🐌 | **85.7x faster** |
-| **💾 Create encrypted backup** | 1.8s ⚡ | 45s 🐌 | **25x faster** |
-| **📊 Generate HTML report** | 2.3s ⚡ | 180s 🐌 | **78x faster** |
-
-*Benchmark and real world results may differ. Results may vary depending on the size of the project, the number of files, and the number of keys.
-
----
-
-### **📊 Memory Usage Comparison**
-
-<div align="center">
-
-| Metric | i18ntk v1.10.0 | Traditional Tools | Savings |
-|--------|----------------|-------------------|---------|
-| **Peak Memory** | <2MB | 50-200MB | **96% less** |
-| **Idle Memory** | <10MB | 100-500MB | **95% less** |
-| **Bundle Size** | 315KB | 5-50MB | **99% smaller** |
-
-</div>
-
----
-
-### **⚡ Startup Time Comparison**
-
-| Tool | Cold Start | Warm Start | Memory Footprint |
-|------|------------|------------|------------------|
-| **i18ntk v1.10.0** | 0.15s ⚡ | 0.02s ⚡ | 8MB |
-| **Traditional i18n tools** | 2-5s 🐌 | 0.5-2s 🐌 | 100-500MB |
-| **Manual process** | N/A | N/A | Variable |
-
----
-
-### **🎯 CI/CD Performance Impact**
-
-```yaml
-# Before: Slow CI/CD pipeline
-- name: Run i18n analysis
-  run: traditional-tool analyze --input locales/
-  # Takes 2-5 minutes, often fails
-
-# After: Lightning-fast CI/CD
-- name: Run i18n analysis
-  run: npx i18ntk analyze --output json
-  # Takes 15 seconds, always reliable
-```
-
-**Result:** **CI/CD pipelines 20x faster** with zero failures
-
-</div></search>
-
----
-
-## 🎯 Roadmap
-
-### **Coming Soon in v1.11.0**
-- 🤖 **AI-Powered Translation** - Automatic translation suggestions
-- 🔗 **API Integrations** - Connect with translation services
-- 📊 **Advanced Analytics** - Translation quality metrics
-
-### **Future Vision**
-- 🎨 **Visual Translation Editor** - WYSIWYG translation interface
-- 🧪 **Automated Testing** - Translation validation in CI/CD
-- 🌍 **Global Translation Network** - Community-powered translations
-- 🤝 **Enterprise Features** - SSO, audit logs, compliance tools
-
----
-
-## 📄 License & Legal
-
-**MIT License** - Free for personal and commercial use
-
-```text
-Copyright (c) 2025 Vladimir Noskov
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-```
-
----
-
-<div align="center">
-
----
-
-## 🎉 **Ready to Transform Your i18n Workflow?**
-
-### **🚀 Start Your Journey Today**
-
-<div align="center">
-
-| Action | Time | Impact |
-|--------|------|---------|
-| **Install i18ntk** | 30 seconds | Zero learning curve |
-| **Initialize project** | 60 seconds | Complete i18n setup |
-| **First analysis** | 15 seconds | Full translation health check |
-| **Total Time** | **< 2 minutes** | **Professional i18n infrastructure** |
-
-</div>
-
----
-
-### **💡 Why Wait? Join 2000+ Developers Who Already Use i18ntk**
-
-```bash
-# Your future workflow - just 3 commands:
-npm install -g i18ntk
-i18ntk init
-i18ntk analyze
-
-# That's it! Your i18n is now enterprise-ready.
-```
-
----
-
-
-### **🎯 Your Next Steps**
-
-<div align="center">
-
-#### **For Individual Developers**
-1. **[📦 Install i18ntk](#-installation)** (30 seconds)
-2. **[⚡ Try the Quick Start](#-quick-start)** (2 minutes)
-3. **[📚 Explore Documentation](#-documentation)** (as needed)
-
-#### **For Open Source Projects**
-1. **[🤝 Join Community](#)** (Get involved)
-2. **[📖 Contribute](#)** (Help improve i18ntk)
-3. **[🌍 Share Globally](#)** (Reach international users)
-
-</div>
-
----
-
-### **🔥 Don't Miss Out on the Future of i18n**
-
-**i18ntk v1.10.0** is the most advanced i18n toolkit ever built. Join the revolution and:
-
-- ⚡ **Save 40+ hours** per month on translation work
-- 🚀 **Deploy 10x faster** with automated workflows
-- 🛡️ **Sleep better** with enterprise-grade security
-- 🌍 **Scale globally** without translation headaches
-
----
-
-
-## **🚀 Ready to Supercharge Your i18n?**
-
-**[📦 Install Now](#-installation)** • **[⚡ Quick Start](#-quick-start)** • **[📚 Documentation](#-documentation)**
-
----
-
-**Made with ❤️ for the global developer community**
-
-**v1.10.0** • **Last Updated:** 2025-08-22 • **[GitHub](https://github.com/vladnoskv/i18ntk)** • **[Documentation](./docs)**
-
-**#i18n #internationalization #localization #javascript #typescript #python #java #php #go #developer-tools**
-
-</div>
+# i18ntk v2
+
+<div align="center">
+
+![i18ntk Logo](docs/screenshots/i18ntk-logo-public.PNG)
+
+[![npm version](https://img.shields.io/npm/v/i18ntk.svg)](https://www.npmjs.com/package/i18ntk)
+[![npm downloads](https://img.shields.io/npm/dt/i18ntk.svg)](https://www.npmjs.com/package/i18ntk)
+[![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.0.0)](https://socket.dev/npm/package/i18ntk/overview/2.0.0)
+
+Zero-dependency i18n toolkit for initialization, scanning, analysis, validation, and completion workflows.
+
+</div>
+
+## Install
+
+```bash
+npm install -g i18ntk
+```
+
+## Quick Start
+
+```bash
+# interactive menu
+i18ntk
+
+# direct workflow
+i18ntk --command=init
+i18ntk --command=analyze --no-prompt
+i18ntk --command=validate --no-prompt
+i18ntk --command=complete --no-prompt
+```
+
+## v2 Command Model
+
+Primary CLI commands:
+
+```bash
+i18ntk --command=init
+i18ntk --command=analyze
+i18ntk --command=validate
+i18ntk --command=usage
+i18ntk --command=scanner
+i18ntk --command=sizing
+i18ntk --command=complete
+i18ntk --command=summary
+i18ntk --command=debug
+```
+
+Standalone binaries:
+
+```bash
+i18ntk-init
+i18ntk-analyze
+i18ntk-validate
+i18ntk-usage
+i18ntk-scanner
+i18ntk-sizing
+i18ntk-complete
+i18ntk-summary
+i18ntk-doctor
+i18ntk-fixer
+i18ntk-backup
+```
+
+Backup helper:
+
+```bash
+i18ntk-backup --help
+i18ntk-backup create ./locales
+i18ntk-backup list
+i18ntk-backup restore <backup-file>
+```
+
+## Common Flags
+
+Most commands support:
+
+- `--source-dir <path>`
+- `--i18n-dir <path>`
+- `--output-dir <path>`
+- `--source-language <code>`
+- `--ui-language <code>`
+- `--no-prompt`
+- `--dry-run`
+- `--help`
+
+## Configuration
+
+i18ntk reads project settings from `.i18ntk-config` in the project root.
+
+Example:
+
+```json
+{
+  "version": "2.0.0",
+  "sourceDir": "./locales",
+  "i18nDir": "./locales",
+  "outputDir": "./i18ntk-reports",
+  "sourceLanguage": "en",
+  "defaultLanguages": ["de", "es", "fr", "ru"],
+  "setup": {
+    "completed": true
+  }
+}
+```
+
+## Runtime API
+
+```ts
+import { initRuntime, t, setLanguage, getLanguage } from 'i18ntk/runtime';
+
+initRuntime({
+  baseDir: './locales',
+  language: 'en',
+  fallbackLanguage: 'en',
+  preload: true
+});
+
+console.log(t('common.hello'));
+setLanguage('fr');
+console.log(getLanguage());
+```
+
+## Docs
+
+- [Documentation Index](docs/README.md)
+- [API Reference](docs/api/API_REFERENCE.md)
+- [Configuration Guide](docs/api/CONFIGURATION.md)
+- [Runtime API Guide](docs/runtime.md)
+- [Scanner Guide](docs/scanner-guide.md)
+- [Environment Variables](docs/environment-variables.md)
+- [Migration Guide v2.0.0](docs/migration-guide-v2.0.0.md)
+- [Release Runbook](DEVUPDATE.md)
+
+## License
+
+MIT