i18ntk 1.4.0 → 1.4.2

package/docs/api/NPM_PUBLISHING_GUIDE.md

@@ -1,426 +0,0 @@
-# NPM Publishing Guide - I18N Management Toolkit
-
-**Version:** 1.1.5  
-**Release Date:** July 27, 2025  
-**Status:** Ready for Stable NPM/Yarn Release  
-**Maintainer:** Vladimir Noskov  
-
-## 📦 Package Overview
-
-The I18N Management Toolkit (i18ntk) is now ready for stable distribution on NPM and Yarn registries. This guide covers the complete publishing process and package management.
-
-### Package Details
-- **Package Name:** `i18ntk`
-- **Current Version:** 1.1.5
-- **License:** MIT
-- **Repository:** [GitHub](https://github.com/vladnoskv/i18n-management-toolkit)
-- **Maintainer:** Vladimir Noskov <vladnoskv@gmail.com>
-
-## ✅ Pre-Publishing Checklist
-
-### 🧪 Quality Assurance
-- [x] **All tests passing:** 25/25 tests (100%)
-- [x] **Translation coverage:** 573/573 keys (100%)
-- [x] **Zero extra keys:** Production-ready quality
-- [x] **Dynamic translations:** Verified working
-- [x] **Documentation:** Updated to v1.1.5
-- [x] **Package verification:** `npm run verify-package` passes
-
-### 📋 Package Configuration
-- [x] **package.json:** Updated to v1.1.5
-- [x] **Version info:** All metadata current
-- [x] **Dependencies:** Properly configured
-- [x] **Scripts:** All commands working
-- [x] **Files array:** Optimized for distribution
-- [x] **Keywords:** SEO optimized
-
-### 📚 Documentation
-- [x] **README.md:** Updated with v1.1.5 stable release features
-- [x] **CHANGELOG.md:** Complete version history
-- [x] **API_REFERENCE.md:** Current API documentation
-- [x] **INSTALLATION.md:** Comprehensive setup guide
-- [x] **RELEASE_NOTES_v1.1.5.md:** Latest stable release notes
-
-## 🚀 Publishing Process
-
-### 1. Final Verification
-
-```bash
-# Run comprehensive tests
-npm test
-
-# Verify package configuration
-npm run verify-package
-
-# Check package contents
-npm pack --dry-run
-
-# Validate package.json
-npm doctor
-```
-
-### 2. Version Management
-
-```bash
-# Current version should be 1.1.5
-npm version --no-git-tag-version
-
-# If version needs updating:
-# npm version patch --no-git-tag-version  # 1.1.5 -> 1.1.6
-# npm version minor --no-git-tag-version  # 1.1.5 -> 1.2.0
-# npm version major --no-git-tag-version  # 1.1.5 -> 2.0.0
-```
-
-### 3. Build and Package
-
-```bash
-# Clean any temporary files
-npm run clean  # if available
-
-# Create package tarball for inspection
-npm pack
-
-# Inspect the created tarball
-tar -tzf i18ntk-1.1.5.tgz
-```
-
-### 4. NPM Registry Login
-
-```bash
-# Login to NPM (if not already logged in)
-npm login
-
-# Verify login
-npm whoami
-
-# Check registry
-npm config get registry
-```
-
-### 5. Publish to NPM
-
-```bash
-# Publish as public package
-npm publish --access public
-
-# For beta/alpha releases (if needed):
-# npm publish --tag beta
-# npm publish --tag alpha
-```
-
-### 6. Verify Publication
-
-```bash
-# Check if package is available
-npm view i18ntk
-
-# Check specific version
-npm view i18ntk@1.1.5
-
-# Test installation
-npm install -g i18ntk@1.1.5
-```
-
-## 📊 Package Configuration Details
-
-### package.json Key Sections
-
-#### Basic Information
-```json
-{
-  "name": "i18ntk",
-  "version": "1.1.5"
-  "description": "Enterprise-grade internationalization management toolkit",
-  "main": "main/i18ntk-manage.js",
-  "license": "MIT",
-  "preferGlobal": true
-}
-```
-
-#### Binary Commands
-```json
-{
-  "bin": {
-    "i18ntk": "./main/i18ntk-manage.js"
-  }
-}
-```
-
-#### Files for Distribution
-```json
-{
-  "files": [
-    "*.js",
-    "main/",
-    "utils/",
-    "scripts/",
-    "ui-locales/",
-    "locales/",
-    "docs/",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ]
-}
-```
-
-#### Keywords for Discovery
-```json
-{
-  "keywords": [
-    "i18n",
-    "internationalization",
-    "localization",
-    "translation",
-    "management",
-    "toolkit",
-    "javascript",
-    "typescript",
-    "react",
-    "vue",
-    "angular",
-    "cli",
-    "automation",
-    "validation",
-    "analysis",
-    "enterprise"
-  ]
-}
-```
-
-## 🔧 Distribution Optimization
-
-### .npmignore Configuration
-
-The package includes an optimized `.npmignore` file:
-
-```
-# Development files
-dev/
-*.log
-.DS_Store
-node_modules/
-
-# Test files
-test-report.json
-i18ntk-reports/
-backups/
-
-# Git files
-.git/
-.gitignore
-
-# IDE files
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# Temporary files
-tmp/
-temp/
-*.tmp
-```
-
-### Package Size Optimization
-
-```bash
-# Check package size
-npm pack --dry-run
-
-# Analyze what's included
-npx bundlesize
-
-# Expected package size: ~2-5MB
-```
-
-## 🌍 Global vs Local Installation
-
-### Global Installation (Recommended)
-```bash
-# Users install globally
-npm install -g i18ntk
-
-# Commands available system-wide
-i18ntk-manage
-i18ntk-init
-i18ntk-analyze
-```
-
-### Local Installation
-```bash
-# Users install locally
-npm install i18ntk --save-dev
-
-# Use with npx
-npx i18ntk-manage
-npx i18ntk-init
-
-# Or with npm scripts
-npm run i18ntk
-```
-
-## 📈 Post-Publishing Tasks
-
-### 1. Update Documentation
-- [ ] Update GitHub README with NPM installation instructions
-- [ ] Create GitHub release with release notes
-- [ ] Update documentation links
-- [ ] Announce on relevant platforms
-
-### 2. Monitor Package
-```bash
-# Check download statistics
-npm view i18ntk
-
-# Monitor for issues
-# Check GitHub issues
-# Monitor NPM package page
-```
-
-### 3. Version Tagging
-```bash
-# Tag the release in Git
-git tag v1.0.0
-git push origin v1.0.0
-
-# Create GitHub release
-# Use RELEASE_NOTES_v1.0.0.md content
-```
-
-## 🔄 Update Process
-
-### For Future Releases
-
-1. **Update version in package.json**
-2. **Update CHANGELOG.md**
-3. **Update README.md**
-4. **Run tests: `npm test`**
-5. **Verify package: `npm run verify-package`**
-6. **Publish: `npm publish`**
-7. **Tag release in Git**
-8. **Update documentation**
-
-### Semantic Versioning
-
-- **Patch (1.6.3 → 1.6.4):** Bug fixes, documentation updates
-- **Minor (1.6.3 → 1.7.0):** New features, non-breaking changes
-- **Major (1.6.3 → 2.0.0):** Breaking changes
-
-## 🛡️ Security Considerations
-
-### NPM Security
-```bash
-# Enable 2FA for NPM account
-npm profile enable-2fa auth-and-writes
-
-# Check for vulnerabilities
-npm audit
-
-# Fix vulnerabilities
-npm audit fix
-```
-
-### Package Security
-- No sensitive data in package
-- Secure dependency management
-- Regular security updates
-- Proper access controls
-
-## 📊 Success Metrics
-
-### Installation Success
-- [ ] Package installs without errors
-- [ ] All commands work correctly
-- [ ] Tests pass after installation
-- [ ] Documentation is accessible
-
-### User Experience
-- [ ] Clear installation instructions
-- [ ] Comprehensive documentation
-- [ ] Working examples
-- [ ] Responsive support
-
-### Technical Metrics
-- [ ] Package size optimized
-- [ ] Fast installation
-- [ ] Cross-platform compatibility
-- [ ] Dependency management
-
-## 🆘 Troubleshooting
-
-### Common Publishing Issues
-
-#### Authentication Errors
-```bash
-# Re-login to NPM
-npm logout
-npm login
-```
-
-#### Version Conflicts
-```bash
-# Check existing versions
-npm view i18ntk versions --json
-
-# Increment version if needed
-npm version patch
-```
-
-#### Package Size Issues
-```bash
-# Check what's being included
-npm pack --dry-run
-
-# Update .npmignore if needed
-```
-
-### Post-Publishing Issues
-
-#### Installation Problems
-- Check Node.js version compatibility
-- Verify package.json bin paths
-- Test on different platforms
-
-#### Command Not Found
-- Verify global installation
-- Check PATH configuration
-- Test binary permissions
-
-## 📞 Support & Maintenance
-
-### Ongoing Maintenance
-- Monitor GitHub issues
-- Respond to user questions
-- Regular security updates
-- Performance improvements
-
-### Community Engagement
-- Respond to issues promptly
-- Accept quality pull requests
-- Maintain documentation
-- Provide examples and tutorials
-
----
-
-## 🎉 Ready for Release!
-
-**Version 1.0.0 is the first stable release, fully prepared for NPM/Yarn distribution.**
-
-### Final Checklist
-- [x] All tests passing (25/25)
-- [x] Documentation complete and updated
-- [x] Package optimized for distribution
-- [x] Security considerations addressed
-- [x] Installation guide created
-- [x] Release notes prepared
-- [x] Quality assurance completed
-
-**Execute the publishing process when ready!** 🚀
-
----
-
-**Maintainer:** Vladimir Noskov  
-**Email:** vladnoskv@gmail.com  
-**GitHub:** [@vladnoskv](https://github.com/vladnoskv)  
-**Package:** [i18ntk on NPM](https://www.npmjs.com/package/i18ntk)

package/docs/debug/DEBUG_README.md

@@ -1,30 +0,0 @@
-# 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 dev/debug/debugger.js
-
-# Validate configuration
-node dev/debug/config-validator.js
-
-# Debug translations
-node dev/debug/translation-debugger.js
-
-# Profile performance
-node dev/debug/performance-profiler.js
-```
-
-## Debug Output
-
-Debug logs and reports are saved to `dev/debug/logs/` with timestamps.

package/docs/debug/DEBUG_TOOLS.md

@@ -1,152 +0,0 @@
-# i18ntk Debug Tools
-
-**Version:** 1.4.0 (04/08/2025)
-
-## Overview
-
-Comprehensive debugging toolkit for i18ntk - diagnose issues, analyze performance, and maintain translation quality.
-
-## Core Debug Tools
-
-### System Debugger
-```bash
-npm run i18ntk:debug                    # Full system debug
-npm run i18ntk:debug -- --verbose       # Verbose output
-npm run i18ntk:debug -- --performance   # Performance analysis
-```
-
-**Features:**
-- System diagnostics
-- Performance analysis
-- Memory usage monitoring
-- Configuration validation
-- Dependency checking
-
-### Console Tools
-
-#### Key Validation
-```bash
-node dev/debug/console-key-checker.js
-```
-
-**Features:**
-- Console message key validation
-- Missing key detection
-- Unused key identification
-- Format validation
-
-#### Translation Manager
-```bash
-node dev/debug/console-translations.js
-```
-
-**Features:**
-- Dynamic console message translation
-- Language switching
-- Message formatting
-- Fallback handling
-
-#### Complete Coverage
-```bash
-node dev/debug/complete-console-translations.js
-```
-
-**Features:**
-- Scan console messages
-- Identify untranslated messages
-- Auto-complete translations
-- Batch processing
-
-### Code Transformation
-
-#### Replace Hardcoded Messages
-```bash
-node dev/debug/replace-hardcoded-console.js
-```
-
-**Transforms:**
-```javascript
-// Before
-console.log('Analysis complete');
-
-// After
-console.log(this.ui.t('analysis.complete'));
-```
-
-### Data Export
-
-#### Export Missing Keys
-```bash
-node dev/debug/export-missing-keys.js --format=csv --output=missing-keys.csv
-node dev/debug/export-missing-keys.js --format=json --language=es
-node dev/debug/export-missing-keys.js --format=xliff --all-languages
-```
-
-**Supported formats:**
-- JSON
-- CSV
-- XLSX
-- XLIFF
-- PO files
-
-## Usage Examples
-
-### Basic Debugging
-```javascript
-const { I18nManager } = require('i18n-management-toolkit');
-
-const manager = new I18nManager();
-const debug = await manager.debug();
-console.log(debug.summary);
-```
-
-### Performance Analysis
-```javascript
-const analyzer = new PerformanceAnalyzer();
-const metrics = await analyzer.analyze();
-console.log(`Memory: ${metrics.memoryUsage}MB`);
-console.log(`Time: ${metrics.analysisTime}ms`);
-```
-
-### Key Validation
-```javascript
-const checker = new ConsoleKeyChecker();
-const results = await checker.validateConsoleKeys();
-console.log(`Missing: ${results.missing.length}`);
-console.log(`Unused: ${results.unused.length}`);
-```
-
-## Quick Commands
-
-| Command | Purpose |
-|---------|---------|
-| `npm run i18ntk:debug` | Full system diagnostics |
-| `node dev/debug/console-key-checker.js` | Validate console keys |
-| `node dev/debug/complete-console-translations.js` | Ensure 100% coverage |
-| `node dev/debug/export-missing-keys.js --format=csv` | Export missing keys |
-
-## Output Examples
-
-### Debug Report
-```
-🔍 i18ntk Debug Analysis
-========================
-✅ Configuration: Valid
-✅ Dependencies: All installed
-⚠️  Memory Usage: 85%
-❌ Missing Keys: 15 found
-
-📊 Performance
-- Startup: 1.2s
-- Analysis: 3.4s
-- Memory: 156MB
-```
-
-### Key Validation
-```
-🔍 Scanning console messages...
-📁 Found 156 console messages
-✅ Translated: 145
-❌ Missing: 11
-🔧 Auto-completed: 11
-```