i18ntk 1.4.0 → 1.4.2

package/docs/release-notes/RELEASE_NOTES_v1.0.0.md

@@ -1,175 +0,0 @@
-# Release Notes - Version 1.0.0 (DEPRECATED - Use 1.1.5)
-
-**Release Date:** July 27, 2025  
-**Version:** 1.0.0 (DEPRECATED - All versions below 1.1.5 contain bugs)  
-**Status:** 🎉 First Stable Release  
-**Distribution:** NPM/Yarn Ready  
-
----
-
-## ⚠️ DEPRECATED VERSION
-
-**All versions below 1.1.5 are deprecated due to bugs. Please upgrade to 1.1.5 immediately.**
-
-Version 1.0.0 was the first stable release of the I18N Management Toolkit (i18ntk), a comprehensive internationalization management system for JavaScript/TypeScript projects.
-
-## 🌟 What's New in 1.0.0
-
-### 🚀 Complete CLI Suite
-- **Enterprise-grade** internationalization management
-- **Multi-language support** for 6+ languages (English, Spanish, French, German, Russian, Japanese, Chinese)
-- **Advanced analysis** and reporting capabilities
-- **Quality assurance** tools with comprehensive validation
-- **Automated workflows** for translation management
-
-### 🛠️ Key Features
-- **Translation Management**: Complete CRUD operations for translation keys
-- **Quality Metrics**: 100% test coverage with zero missing keys
-- **Framework Support**: React i18next, Vue i18n, and more
-- **Report Generation**: Comprehensive analysis and validation reports
-- **CLI Commands**: 15+ powerful commands for all i18n needs
-- **Configuration**: Flexible setup with environment variables and config files
-
-### 📊 Production Ready
-- ✅ **25/25 tests passing** (100% success rate)
-- ✅ **573/573 translation keys** (100% coverage)
-- ✅ **Zero extra keys** - clean and optimized
-- ✅ **Dynamic translations** verified and working
-- ✅ **Enterprise-grade** documentation
-
-## 🔧 Installation
-
-### NPM
-```bash
-npm install -g i18ntk
-```
-
-### Yarn
-```bash
-yarn global add i18ntk
-```
-
-### Verify Installation
-```bash
-i18ntk --version  # Should show 1.1.5
-i18ntk --help     # Show available commands
-```
-
-## 🚀 Quick Start
-
-```bash
-# Initialize your project
-i18ntk init
-
-# Analyze translation completeness
-i18ntk analyze
-
-# Validate translation files
-i18ntk validate
-
-# Generate comprehensive reports
-i18ntk report
-
-# Check translation usage
-i18ntk usage
-```
-
-## 📋 Available Commands
-
-| Command | Description | Example |
-|---------|-------------|----------|
-| `i18ntk init` | Initialize i18n project | `i18ntk init --framework react-i18next` |
-| `i18ntk analyze` | Analyze translation completeness | `i18ntk analyze --detailed` |
-| `i18ntk validate` | Validate translation files | `i18ntk validate --strict` |
-| `i18ntk usage` | Check translation key usage | `i18ntk usage --unused` |
-| `i18ntk report` | Generate analysis reports | `i18ntk report --format html` |
-| `i18ntk complete` | Complete missing translations | `i18ntk complete --target es` |
-| `i18ntk settings` | Manage configuration | `i18ntk settings --show` |
-| `i18ntk debug` | Debug translation issues | `i18ntk debug --verbose` |
-
-## 🌍 Supported Languages
-
-- **English (en)** - Primary language
-- **Spanish (es)** - Complete translation
-- **French (fr)** - Complete translation
-- **German (de)** - Complete translation
-- **Russian (ru)** - Complete translation
-- **Japanese (ja)** - Complete translation
-- **Chinese (zh)** - Complete translation
-
-## 📚 Documentation
-
-### Core Documentation
-- **[Installation Guide](../INSTALLATION.md)** - Detailed setup instructions
-- **[API Reference](../api/API_REFERENCE.md)** - Complete command documentation
-- **[Configuration Guide](../api/CONFIGURATION.md)** - Setup and customization
-- **[NPM Publishing Guide](../api/NPM_PUBLISHING_GUIDE.md)** - Publishing workflow
-
-### Getting Started
-1. **[Quick Start Guide](../../README.md#-quick-start)** - Get up and running in minutes
-2. **[Configuration Setup](../api/CONFIGURATION.md)** - Customize for your project
-3. **[Command Reference](../api/API_REFERENCE.md)** - Learn all available commands
-
-## 🔄 Migration Guide
-
-### From Development Versions (0.x.x-dev)
-
-If you were using development versions (0.5.0-dev through 0.6.3-dev), upgrading to 1.0.0 is seamless:
-
-```bash
-# Uninstall old development version
-npm uninstall -g i18ntk
-
-# Install stable 1.1.5
-npm install -g i18ntk
-
-# Verify installation
-i18ntk --version  # Should show 1.1.5
-```
-
-**No breaking changes** - all commands and configurations remain compatible.
-
-## 🛡️ Quality Assurance
-
-### Test Results
-```
-✅ Tests Passing: 25/25 (100%)
-✅ Translation Coverage: 573/573 keys (100%)
-✅ Extra Keys: 0 (Clean)
-✅ Dynamic Translations: Working
-✅ Framework Support: Verified
-```
-
-### Security Features
-- **Input validation** for all commands
-- **Safe file operations** with backup support
-- **Environment variable** protection
-- **Error handling** with graceful degradation
-
-## 🎯 What's Next
-
-### Planned Features
-- **AI-powered translations** integration
-- **Real-time collaboration** tools
-- **Advanced analytics** dashboard
-- **Plugin ecosystem** for extensibility
-- **Cloud synchronization** capabilities
-
-### Community
-- **GitHub Repository**: [i18n-management-toolkit](https://github.com/vladnoskv/i18n-management-toolkit)
-- **Issues & Support**: [GitHub Issues](https://github.com/vladnoskv/i18n-management-toolkit/issues)
-- **Documentation**: [Complete Docs](../README.md)
-
-## 🙏 Acknowledgments
-
-Thank you to everyone who contributed to making this first stable release possible. Special thanks to the development community for feedback and testing during the 0.x.x-dev series.
-
-## 📄 License
-
-MIT License - see [LICENSE](../../LICENSE) for details.
-
----
-
-**🎉 Welcome to the stable era of i18ntk! Version 1.0.0 is ready for production use.**
-
-**Happy internationalizing! 🌍**

package/docs/release-notes/RELEASE_NOTES_v1.0.4.md

@@ -1,153 +0,0 @@
-# Release Notes - i18ntk v1.0.4 (DEPRECATED - Use 1.1.5)
-
-**Release Date:** January 27, 2025  
-**Release Type:** Patch Release 🔧  
-**Status:** Critical Translation System Fixes
-
-## 🎯 Overview
-
-⚠️ **DEPRECATED VERSION** - This version contains known bugs. Please upgrade to v1.1.5 immediately.
-
-Version 1.0.4 was a critical patch release that addressed significant translation system issues discovered in previous versions.
-
-## 🔧 Critical Translation System Fixes
-
-### 🐛 Major Bug Fixes
-
-#### Translation System Initialization
-- **Fixed**: Translation system initialization issues causing "Translation not found" errors
-- **Enhanced**: Auto-loading of English translations when `t()` function is first called
-- **Added**: `isInitialized` flag to prevent redundant translation loading
-- **Improved**: Translation system robustness across all modules
-
-#### Dynamic Value Replacement
-- **Fixed**: Template placeholders not being replaced with actual values in validation summary
-- **Resolved**: Issues with `{{langs}}`, `{{lang}}`, `{count}`, and `{{percentage}}` placeholders
-- **Corrected**: Parameter name mismatches between translation function calls and template placeholders
-- **Enhanced**: Full support for all template placeholder formats
-
-#### Security Configuration
-- **Added**: `uiLanguage` to allowed security configuration keys
-- **Resolved**: "Security: Unknown config key: uiLanguage" warnings
-- **Improved**: Security validation to include all valid configuration options
-
-### 🔍 Specific Issues Resolved
-
-1. **Translation Not Found Error**
-   - **Issue**: `Translation not found for key: hardcodedTexts.securityUnknownConfigKey`
-   - **Root Cause**: Translation system not initialized when security module was loaded
-   - **Solution**: Added auto-initialization in `i18n-helper.js` `t()` function
-
-2. **Dynamic Value Replacement**
-   - **Issue**: Template placeholders like `{{langs}}`, `{{lang}}`, `{count}` not replaced
-   - **Root Cause**: Parameter name mismatches in `i18ntk-validate.js`
-   - **Solution**: Corrected parameter names to match template expectations
-     - `languages` → `langs`
-     - `language` → `lang`
-     - `*Count` parameters → `count`
-     - `translationPercentage` → `percentage`
-
-3. **Security Configuration Warnings**
-   - **Issue**: `uiLanguage` flagged as unknown configuration key
-   - **Root Cause**: Missing from allowed keys list in security validation
-   - **Solution**: Added `uiLanguage` to `allowedKeys` array in `security.js`
-
-## 📁 Files Modified
-
-### Core Translation System
-- `utils/i18n-helper.js`
-  - Added auto-initialization of translations in `t()` function
-  - Added `isInitialized` flag for proper state management
-  - Enhanced `loadTranslations()` to set initialization flag
-
-### Validation System
-- `main/i18ntk-validate.js`
-  - Fixed parameter name mismatches in translation calls
-  - Corrected template placeholder alignment
-  - Enhanced dynamic value replacement
-
-### Security System
-- `utils/security.js`
-  - Added `uiLanguage` to allowed configuration keys
-  - Improved security validation coverage
-
-### Documentation
-- `package.json` - Updated version to 1.1.5
-- `CHANGELOG.md` - Added comprehensive v1.1.5 release notes
-- `README.md` - Updated to reflect latest fixes and improvements
-
-## ✅ Quality Assurance
-
-### Testing Results
-- **Translation Errors**: ✅ Resolved - No more "Translation not found" errors
-- **Dynamic Values**: ✅ Working - All template placeholders properly replaced
-- **Security Warnings**: ✅ Fixed - No more unknown configuration key warnings
-- **Validation Scripts**: ✅ Operational - All tools run without translation errors
-
-### Verification Commands
-```bash
-# Test validation with proper dynamic values
-node main/i18ntk-validate.js --source-dir=./locales
-
-# Verify no translation errors
-node main/i18ntk-analyze.js --help
-
-# Check security configuration
-node main/i18ntk-manage.js
-```
-
-## 🚀 Upgrade Instructions
-
-### For Global Installation
-```bash
-npm update -g i18ntk
-```
-
-### For Local Installation
-```bash
-npm update i18ntk
-```
-
-### Verification
-```bash
-i18ntk --version  # Should show 1.1.5
-i18ntk-validate --help  # Should exit properly without errors
-```
-
-## 🔄 Breaking Changes
-
-**None** - This is a patch release with no breaking changes. All existing functionality remains compatible.
-
-## 🎯 Impact
-
-### Before v1.0.4
-- Translation errors in console output
-- Dynamic values not replaced in validation summary
-- Security warnings for valid configuration
-- Inconsistent translation system behavior
-
-### After v1.1.5
-- ✅ Clean console output without translation errors
-- ✅ Proper dynamic value replacement in all outputs
-- ✅ No security warnings for valid configurations
-- ✅ Robust and reliable translation system
-
-## 📋 Next Steps
-
-After upgrading to v1.1.5:
-1. Run your existing i18n workflows to verify improvements
-2. Check that all dynamic values display correctly
-3. Confirm no translation errors in console output
-4. Update any custom scripts that may depend on the fixed behavior
-
-## 🆘 Support
-
-If you encounter any issues with v1.1.5:
-- Check the [troubleshooting guide](../debug/DEBUG_TOOLS.md)
-- Review the [configuration documentation](../api/CONFIGURATION.md)
-- Report issues on [GitHub Issues](https://github.com/vladnoskv/i18n-management-toolkit/issues)
-
----
-
-**Previous Release:** [v1.0.3](./RELEASE_NOTES_v1.0.3.md)  
-**Full Changelog:** [CHANGELOG.md](../../CHANGELOG.md)

package/docs/release-notes/RELEASE_NOTES_v1.1.2.md

@@ -1,68 +0,0 @@
-**Release Date:** July 27, 2024
-**Version:** 1.1.2 (DEPRECATED - Please upgrade to 1.1.5)
-**Type:** Patch Release 🩹
-
-## Overview
-
-⚠️ **DEPRECATED VERSION** - This version contains known bugs. Please upgrade to v1.1.5 immediately.
-
-Version 1.1.2 was a patch release focused on enhancing the CLI experience by enabling direct command execution and resolving a critical bug related to `user-config.json` access post switch to use i18ntk-config.json instead.
-
-## 🚀 Enhanced CLI Experience
-
-### Direct Command Execution
-- **Improved**: Enabled direct execution of commands (e.g., `i18ntk usage`, `i18ntk workflow`) from the command line, bypassing the interactive menu for specified commands.
-- **Benefit**: Streamlines automation and integration into CI/CD pipelines, providing a more flexible and efficient workflow.
-
-## 🐛 Bug Fixes & Improvements
-
-### `user-config.json` Error Resolution
-- **Fixed**: Resolved "Cannot access 'commandArg' before initialization" error and "Missing required file/directory: ./settings/user-config.json" error.
-- **Root Cause**: The issue stemmed from incorrect argument handling in `i18ntk-manage.js` and an outdated global `i18ntk` installation attempting to access a non-existent `user-config.json`.
-- **Solution**: Modified `i18ntk-manage.js` to correctly initialize `commandToExecute` and prioritize the `--command=` argument. Ensured the local, up-to-date version of `i18ntk` is used, which correctly utilizes `i18ntk-config.json`.
-
-## ✅ Validation Results
-
-### CLI Command Execution
-- **Confirmed**: `i18ntk analyze` and `i18ntk workflow` now execute successfully without the `user-config.json` error, utilizing the correct `i18ntk-config.json`.
-- **Verified**: Direct commands like `i18ntk usage` and `i18ntk validate` now execute as expected without launching the interactive menu.
-
-## 🔄 Migration Guide
-
-### For Existing Users
-- **No Breaking Changes**: This patch release introduces no breaking changes.
-- **Improved Experience**: Direct command execution simplifies scripting and automation.
-- **Bug Fix**: The `user-config.json` error is resolved, ensuring smoother operation.
-
-### For New Users
-- **Installation**: Standard installation process via npm.
-- **Usage**: All commands work as documented, with the added flexibility of direct execution.
-
-## 🚀 Getting Started
-
-```bash
-# Install globally
-npm install -g i18ntk@1.1.5
-
-# Or update existing installation
-npm update -g i18ntk
-
-# Verify installation
-i18ntk --version
-
-# Start using the improved toolkit
-i18ntk
-```
-
-## 📞 Support
-
-If you encounter any issues with this release:
-
-1. Check the updated documentation.
-2. Review the changelog for detailed changes.
-3. Report issues through the project's issue tracker.
-4. Refer to the comprehensive help system: `i18ntk --help`
-
---- 
-
-**Thank you for using i18ntk!** This patch release further refines the toolkit for a more robust and user-friendly experience.

package/docs/release-notes/RELEASE_NOTES_v1.1.5.md

@@ -1,81 +0,0 @@
-# Release Notes - i18ntk v1.1.5
-
-**Release Date:** August 2, 2025  
-**Version:** 1.1.5  
-**Type:** Documentation & Metadata Update 📚
-**Status:** Production Ready ✅
-
-## 🎯 Overview
-
-Version 1.1.5 is a maintenance release focused on comprehensive documentation updates, npm metadata cleanup, and community milestone celebration. This release marks the completion of our initial development phase and provides a stable foundation for future enhancements.
-
-## 🚀 What's New in 1.1.5
-
-### 📚 Documentation Enhancements
-- **Complete Documentation Overhaul**: All documentation files updated to reflect v1.1.5
-- **Version Consistency**: Eliminated version discrepancies across all docs
-- **Repository Links**: Updated all links to point to the main repository: `https://github.com/vladnoskv/i18n-management-toolkit-main`
-
-### 🎉 Community Milestones
-- **200+ Downloads**: Celebrated 200+ downloads in the first week! 🎊
-- **Bug Resolution**: Most functional issues resolved based on community feedback
-- **Stability Focus**: Emphasis on production-ready stability
-
-### ⚠️ Deprecation Notices
-- **All Previous Versions**: v1.0.0 - v1.1.4 are now deprecated due to bugs
-- **Upgrade Path**: Direct upgrade to v1.1.5 recommended for all users
-- **Migration**: Seamless upgrade process with no breaking changes
-
-### 📦 Package Metadata Updates
-- **NPM Registry**: Updated package metadata and descriptions
-- **Repository URL**: Fixed repository links across all documentation
-- **Version Consistency**: Ensured all files reference v1.1.5
-
-## 🔧 Installation
-
-### Fresh Installation
-```bash
-# Install globally
-npm install -g i18ntk@1.1.5
-
-# Verify installation
-i18ntk --version  # Should show 1.1.5
-```
-
-### Upgrade from Previous Versions
-```bash
-# Remove old version
-npm uninstall -g i18ntk
-
-# Install latest version
-npm install -g i18ntk@1.1.5
-
-# Verify upgrade
-i18ntk --version  # Should show 1.1.5
-```
-
-## 📋 Changes Summary
-
-| Component | Status |
-|-----------|--------|
-| Core Functionality | ✅ Production Ready |
-| Documentation | ✅ Complete v1.1.5 |
-| CLI Experience | ✅ Enhanced |
-| Translation System | ✅ 95% Complete |
-| NPM Metadata | ✅ Updated |
-| Repository Links | ✅ Fixed |
-
-## 🙏 Thank You
-
-Special thanks to our community for achieving 200+ downloads in the first week! Your feedback and support have been invaluable in making i18ntk production-ready.
-
-## 🔗 Links
-
-- **Main Repository**: https://github.com/vladnoskv/i18n-management-toolkit-main
-- **NPM Package**: https://www.npmjs.com/package/i18ntk
-- **Documentation**: [Full Documentation](../README.md)
-- **Issues**: [Report Issues](https://github.com/vladnoskv/i18n-management-toolkit-main/issues)
-
----
-
-**Ready for production use! Upgrade to v1.1.5 today.**

package/docs/release-notes/RELEASE_NOTES_v1.4.0.md

@@ -1,115 +0,0 @@
-# 🎉 i18ntk v1.4.0 Release Notes
-
-**Release Date:** January 2025  
-**Version:** 1.4.0  
-**Milestone:** 700+ Downloads! 🚀
-
-## 🌟 Major Highlights
-
-### 🇵🇹 Portuguese Language Support - **NEW!**
-- **Complete Portuguese (Português) translation support** - our 8th language!
-- **100% coverage** across all UI components, error messages, and help content
-- **Professional translations** for all 1,551+ translation keys
-- **Native Portuguese UI experience** with culturally appropriate terminology
-
-### 🔄 UI Language Switching - **RESTORED**
-- **Re-enabled** the "Change UI Language" option in the main menu
-- **Full 8-language support** including the new Portuguese option
-- **Seamless runtime switching** between all supported languages
-- **Enhanced language selection menu** with flags and native names
-
-### 🧪 Test Framework Improvements
-- **Fixed translation detection** for Portuguese language files
-- **Enhanced validation system** now properly recognizes Portuguese translations
-- **Improved consistency checking** across all 8 supported languages
-- **Comprehensive test coverage** for the new Portuguese locale
-
-## 📊 Language Support Matrix
-
-| Language | Code | Status | Coverage |
-|----------|------|--------|----------|
-| English | en | ✅ Complete | 100% |
-| German | de | ✅ Complete | 100% |
-| Spanish | es | ✅ Complete | 100% |
-| French | fr | ✅ Complete | 100% |
-| Russian | ru | ✅ Complete | 100% |
-| Japanese | ja | ✅ Complete | 100% |
-| Chinese | zh | ✅ Complete | 100% |
-| **Portuguese** | **pt** | **🆕 NEW** | **100%** |
-
-## 🔧 Technical Improvements
-
-### Translation Infrastructure
-- **Modular translation structure** properly validated for Portuguese
-- **Consistent key mapping** across all language files
-- **Enhanced validation scripts** for Portuguese-specific checks
-- **Improved error reporting** for translation consistency issues
-
-### CLI Enhancements
-- **Updated language selection** in interactive prompts
-- **Enhanced settings management** with Portuguese support
-- **Improved help documentation** with Portuguese translations
-- **Better error messages** in Portuguese for debugging
-
-## 📈 Download Milestone
-
-🎊 **700+ Downloads Celebration!**  
-This release marks a significant milestone with over 700 downloads. Thank you to our growing community of developers worldwide!
-
-## 🐛 Bug Fixes
-
-- **Fixed:** Test scripts now properly detect Portuguese translation files
-- **Fixed:** Language switching functionality fully restored
-- **Fixed:** Translation consistency validation for Portuguese locale
-- **Fixed:** UI language menu now correctly displays all 8 languages
-
-## 📚 Documentation Updates
-
-- **README.md** updated to reflect v1.4.0 and 8-language support
-- **API documentation** updated with Portuguese language examples
-- **Installation guide** includes Portuguese setup instructions
-- **Configuration docs** updated for new language options
-
-## 🚀 Getting Started
-
-### New Installation
-```bash
-npm install -g i18ntk@latest
-```
-
-### Upgrade from v1.3.x
-```bash
-npm update -g i18ntk
-```
-
-### Try Portuguese Language
-```bash
-i18ntk --language=pt
-```
-
-## 🔄 Migration Guide
-
-### From v1.3.x to v1.4.0
-- **No breaking changes** - fully backward compatible
-- **Automatic Portuguese detection** if system language is Portuguese
-- **Enhanced language switching** in interactive mode
-- **All existing configurations remain valid**
-
-## 🎯 What's Next
-
-- **Framework integrations** (React, Vue, Angular enhancements)
-- **Performance optimizations** for large translation files
-- **Additional language support** based on community feedback
-- **Enhanced debugging tools** for translation workflows
-
-## 🙏 Community & Support
-
-**700+ downloads strong!** Thank you for being part of the i18ntk journey.
-
-- **GitHub Issues:** [Report bugs or request features](https://github.com/vladnoskv/i18n-management-toolkit-main/issues)
-- **Discussions:** [Join our community discussions](https://github.com/vladnoskv/i18n-management-toolkit-main/discussions)
-- **Documentation:** [Comprehensive guides and API reference](https://github.com/vladnoskv/i18n-management-toolkit-main#readme)
-
----
-
-**Happy internationalizing with Portuguese support! 🇧🇷🇵🇹**