i18ntk 1.4.0 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/CHANGELOG.md +61 -1
  2. package/README.md +410 -20
  3. package/locales/de/common.json +17 -20
  4. package/locales/en/common.json +17 -20
  5. package/locales/es/common.json +17 -20
  6. package/locales/fr/common.json +17 -20
  7. package/locales/ru/common.json +17 -20
  8. package/main/i18ntk-manage.js +52 -24
  9. package/package.json +6 -8
  10. package/{dev → scripts}/debug/README.md +9 -5
  11. package/{dev → scripts}/debug/debugger.js +84 -4
  12. package/scripts/prepublish.js +2 -2
  13. package/scripts/validate-all-translations.js +2 -2
  14. package/ui-locales/de/debug.json +5 -5
  15. package/ui-locales/de/init.json +1 -0
  16. package/ui-locales/de/language.json +11 -2
  17. package/ui-locales/de/security.json +2 -1
  18. package/ui-locales/de/sizing.json +1 -0
  19. package/ui-locales/de/usage.json +1 -0
  20. package/ui-locales/en/debug.json +5 -5
  21. package/ui-locales/en/init.json +1 -0
  22. package/ui-locales/en/language.json +11 -2
  23. package/ui-locales/en/security.json +2 -1
  24. package/ui-locales/en/sizing.json +2 -0
  25. package/ui-locales/en/usage.json +1 -0
  26. package/ui-locales/es/debug.json +5 -5
  27. package/ui-locales/es/init.json +1 -0
  28. package/ui-locales/es/language.json +11 -2
  29. package/ui-locales/es/security.json +2 -1
  30. package/ui-locales/es/sizing.json +2 -0
  31. package/ui-locales/es/usage.json +1 -0
  32. package/ui-locales/fr/debug.json +5 -5
  33. package/ui-locales/fr/init.json +1 -0
  34. package/ui-locales/fr/language.json +11 -2
  35. package/ui-locales/fr/security.json +2 -1
  36. package/ui-locales/fr/sizing.json +2 -0
  37. package/ui-locales/fr/usage.json +1 -0
  38. package/ui-locales/ja/debug.json +5 -5
  39. package/ui-locales/ja/init.json +1 -0
  40. package/ui-locales/ja/language.json +11 -2
  41. package/ui-locales/ja/security.json +2 -1
  42. package/ui-locales/ja/sizing.json +3 -0
  43. package/ui-locales/ja/usage.json +1 -0
  44. package/ui-locales/pt/debug.json +5 -5
  45. package/ui-locales/pt/init.json +1 -0
  46. package/ui-locales/pt/language.json +11 -2
  47. package/ui-locales/pt/security.json +2 -1
  48. package/ui-locales/pt/sizing.json +2 -0
  49. package/ui-locales/pt/usage.json +1 -0
  50. package/ui-locales/ru/debug.json +5 -5
  51. package/ui-locales/ru/init.json +1 -0
  52. package/ui-locales/ru/language.json +11 -2
  53. package/ui-locales/ru/security.json +2 -1
  54. package/ui-locales/ru/sizing.json +2 -0
  55. package/ui-locales/ru/usage.json +1 -0
  56. package/ui-locales/zh/debug.json +5 -5
  57. package/ui-locales/zh/init.json +1 -0
  58. package/ui-locales/zh/language.json +11 -2
  59. package/ui-locales/zh/security.json +2 -1
  60. package/ui-locales/zh/sizing.json +2 -0
  61. package/ui-locales/zh/usage.json +1 -0
  62. package/utils/test-complete-system.js +1 -1
  63. package/dev/README.md +0 -37
  64. package/docs/INSTALLATION.md +0 -98
  65. package/docs/PIN_PROTECTION_GUIDE.md +0 -265
  66. package/docs/README.md +0 -111
  67. package/docs/SCRIPT_DIRECTORY_GUIDE.md +0 -278
  68. package/docs/TODO_ROADMAP.md +0 -279
  69. package/docs/TRANSLATION_STATUS.md +0 -67
  70. package/docs/api/API_REFERENCE.md +0 -258
  71. package/docs/api/COMPONENTS.md +0 -492
  72. package/docs/api/CONFIGURATION.md +0 -676
  73. package/docs/api/NPM_PUBLISHING_GUIDE.md +0 -426
  74. package/docs/debug/DEBUG_README.md +0 -30
  75. package/docs/debug/DEBUG_TOOLS.md +0 -152
  76. package/docs/development/AGENTS.md +0 -349
  77. package/docs/development/DEVELOPMENT_RULES.md +0 -165
  78. package/docs/development/DEV_README.md +0 -41
  79. package/docs/release-notes/RELEASE_NOTES_v1.0.0.md +0 -175
  80. package/docs/release-notes/RELEASE_NOTES_v1.0.4.md +0 -153
  81. package/docs/release-notes/RELEASE_NOTES_v1.1.2.md +0 -68
  82. package/docs/release-notes/RELEASE_NOTES_v1.1.5.md +0 -81
  83. package/docs/release-notes/RELEASE_NOTES_v1.4.0.md +0 -115
  84. package/docs/release-notes/RELEASE_NOTES_v1.6.0.md +0 -141
  85. package/docs/release-notes/RELEASE_NOTES_v1.6.1.md +0 -185
  86. package/docs/release-notes/RELEASE_NOTES_v1.6.3.md +0 -199
  87. package/docs/release-notes/v1.3.0.md +0 -162
  88. package/docs/release-notes/v1.3.1.md +0 -136
  89. package/docs/reports/ANALYSIS_README.md +0 -17
  90. package/docs/reports/CONSOLE_MISMATCH_BUG_REPORT_v1.5.0.md +0 -181
  91. package/docs/reports/SIZING_README.md +0 -18
  92. package/docs/reports/SUMMARY_README.md +0 -18
  93. package/docs/reports/TRANSLATION_BUG_REPORT_v1.5.0.md +0 -129
  94. package/docs/reports/USAGE_README.md +0 -18
  95. package/docs/reports/VALIDATION_README.md +0 -18
  96. /package/{dev → scripts}/debug/complete-console-translations.js +0 -0
  97. /package/{dev → scripts}/debug/console-key-checker.js +0 -0
  98. /package/{dev → scripts}/debug/console-translations.js +0 -0
  99. /package/{dev → scripts}/debug/debug-security.js +0 -0
  100. /package/{dev → scripts}/debug/debug-translation.js +0 -0
  101. /package/{dev → scripts}/debug/export-missing-keys.js +0 -0
  102. /package/{dev → scripts}/debug/final-normalize.js +0 -0
  103. /package/{dev → scripts}/debug/find-extra-keys.js +0 -0
  104. /package/{dev → scripts}/debug/normalize-locales.js +0 -0
  105. /package/{dev → scripts}/debug/refactor-locales.js +0 -0
  106. /package/{dev → scripts}/debug/reorder-locales.js +0 -0
  107. /package/{dev → scripts}/debug/replace-hardcoded-console.js +0 -0
@@ -1,141 +0,0 @@
1
- # Release Notes - i18ntk v1.6.0
2
-
3
- **Release Date:** July 28, 2025
4
- **Status:** 🚀 PUBLIC RELEASE READY
5
- **Maintainer:** Vladimir Noskov
6
-
7
- ## 🎉 Major Milestone - Ready for Public Distribution
8
-
9
- Version 1.6.0 represents a significant milestone in the i18ntk project, marking it as **ready for public npm distribution**. This release focuses on comprehensive code quality improvements, modernization, and preparation for widespread adoption.
10
-
11
- ## 📊 Release Statistics
12
-
13
- - **✅ Test Suite:** 25/25 tests passing (100% success rate)
14
- - **🔍 Package Verification:** All verification checks pass
15
- - **📋 Console Statements Analyzed:** 280+ statements catalogued for internationalization
16
- - **🔄 Command Pattern Updates:** 100% migration from old to new patterns
17
- - **📚 Documentation:** Fully synchronized and comprehensive
18
-
19
- ## 🌟 Key Achievements
20
-
21
- ### 🌐 Internationalization Preparation
22
- - **Comprehensive Analysis:** Identified and catalogued:
23
- - 200+ `console.log` statements across 20+ files
24
- - 50+ `console.error` statements across 15+ files
25
- - 30+ `console.warn` statements across 10+ files
26
- - **Translation Ready:** All console output documented for systematic conversion to translation keys
27
- - **Future-Proof:** Foundation laid for complete UI internationalization
28
-
29
- ### 🔄 Command Modernization
30
- - **Pattern Elimination:** Removed all legacy `node 0x-xxx-xxx.js` command patterns
31
- - **Modern Commands:** Updated to consistent `i18ntk` command style
32
- - **Documentation Updates:** All help text and examples use new patterns
33
- - **User Experience:** Cleaner, more intuitive command interface
34
-
35
- ### 🔧 Package Optimization
36
- - **NPM Ready:** Optimized package structure for public distribution
37
- - **Global/Local Support:** Enhanced installation compatibility
38
- - **Size Optimization:** Proper file inclusion/exclusion with `.npmignore`
39
- - **Verification:** Comprehensive package validation system
40
-
41
- ## 📁 Files Modified in This Release
42
-
43
- ### Core Package Files
44
- - `package.json` - Version bump to 1.6.0, enhanced metadata
45
- - `CHANGELOG.md` - Comprehensive release documentation
46
- - `README.md` - Updated version and feature highlights
47
-
48
- ### Command Reference Updates
49
- - `ui-locales/en.json` - Updated help usage examples
50
- - `main/i18ntk-sizing.js` - Modernized command examples
51
- - `settings/settings-cli.js` - Updated CLI usage references
52
-
53
- ### Documentation
54
- - `RELEASE_NOTES_v1.6.0.md` - This comprehensive release documentation
55
-
56
- ## 🔍 Quality Assurance
57
-
58
- ### ✅ Verification Results
59
- ```
60
- 🔍 Package Structure: ✅ PASS
61
- 🔍 Version Consistency: ✅ PASS
62
- 🔍 NPM Configuration: ✅ PASS
63
- 🔍 Test Suite: ✅ 25/25 PASS
64
- 🔍 Documentation: ✅ SYNCHRONIZED
65
- ```
66
-
67
- ### 📋 Test Coverage
68
- - **Core Scripts:** All main i18ntk scripts verified working
69
- - **Translation Consistency:** 573 keys validated across languages
70
- - **Critical Functionality:** All essential features tested
71
- - **Error Handling:** Robust error management verified
72
-
73
- ## 🚀 Ready for Public Release
74
-
75
- ### NPM Publication
76
- The package is now ready for public npm distribution:
77
-
78
- ```bash
79
- npm publish
80
- ```
81
-
82
- ### Installation Methods
83
- **Global Installation (Recommended):**
84
- ```bash
85
- npm install -g i18ntk
86
- ```
87
-
88
- **Local Installation:**
89
- ```bash
90
- npm install i18ntk --save-dev
91
- ```
92
-
93
- ## 🔮 Future Development Roadmap
94
-
95
- ### 🌍 Phase 1: Complete Internationalization
96
- - **Console Translation Implementation:** Convert all identified console statements to use translation keys
97
- - **UI Locales Refactoring:** Implement multi-language object format for translation files
98
- - **Missing Translation Completion:** Address the 30 non-critical missing translation keys
99
-
100
- ### 🔧 Phase 2: Enhanced Features
101
- - **Advanced Debug Tools:** Expand debugging capabilities with more comprehensive analysis
102
- - **Performance Optimization:** Further optimize translation processing for large projects
103
- - **Additional Language Support:** Expand UI language support beyond current 7 languages
104
-
105
- ### 📊 Phase 3: Enterprise Features
106
- - **Advanced Reporting:** Improve report generation with detailed analytics
107
- - **Integration Support:** Enhanced framework integration (React, Vue, Angular)
108
- - **API Expansion:** Extended programmatic API for enterprise use cases
109
-
110
- ## 🎯 Developer Guidelines
111
-
112
- ### For Contributors
113
- 1. **Translation Keys:** Use the catalogued console statements as reference for implementing translation keys
114
- 2. **Command Patterns:** Always use new `i18ntk` command style in documentation and examples
115
- 3. **Testing:** Ensure all changes pass the comprehensive test suite
116
- 4. **Documentation:** Keep all version references synchronized
117
-
118
- ### For Users
119
- 1. **Migration:** Update any scripts using old `node 0x-xxx-xxx.js` patterns to new `i18ntk` commands
120
- 2. **Installation:** Use global installation for best experience
121
- 3. **Feedback:** Report issues and suggestions via GitHub issues
122
-
123
- ## 📞 Support and Community
124
-
125
- - **GitHub Repository:** [i18n-management-toolkit](https://github.com/vladnoskv/i18n-management-toolkit)
126
- - **Issues:** [GitHub Issues](https://github.com/vladnoskv/i18n-management-toolkit/issues)
127
- - **Documentation:** [Complete Docs](./docs/README.md)
128
- - **API Reference:** [API Documentation](./docs/api/API_REFERENCE.md)
129
-
130
- ## 🙏 Acknowledgments
131
-
132
- This release represents months of development, testing, and refinement. Special thanks to:
133
- - The open-source community for feedback and suggestions
134
- - Contributors who helped identify and resolve issues
135
- - Early adopters who provided valuable testing feedback
136
-
137
- ---
138
-
139
- **Ready for the world! 🌍**
140
-
141
- Version 1.6.0 marks i18ntk as a mature, production-ready internationalization toolkit suitable for projects of all sizes. The comprehensive analysis, modernization, and quality assurance work completed in this release ensures a solid foundation for future development and widespread adoption.
@@ -1,185 +0,0 @@
1
- # 🌐 I18N Management Toolkit - Release Notes v1.6.1
2
-
3
- **Release Date:** December 19, 2024
4
- **Version:** 1.6.1
5
- **Status:** ✅ TRANSLATION COMPLETENESS ACHIEVED
6
-
7
- ---
8
-
9
- ## 🎯 Release Overview
10
-
11
- Version 1.6.1 represents a **major milestone** in the I18N Management Toolkit's development, achieving **100% translation key coverage** across all supported languages. This release eliminates the 173 missing translation keys that were present in non-English language files, ensuring complete internationalization support.
12
-
13
- ---
14
-
15
- ## 🌟 Major Achievements
16
-
17
- ### ✅ 100% Translation Coverage
18
- - **FIXED**: 173 missing translation keys in all non-English languages
19
- - **ACHIEVED**: Complete 573/573 key coverage across all 7 supported languages
20
- - **RESULT**: Zero missing translation keys in the entire system
21
-
22
- ### 🌐 Complete Language Support
23
- - 🇺🇸 **English (en)**: 573/573 keys (100%) - Reference language
24
- - 🇩🇪 **German (de)**: 573/573 keys (100%) - Added 173 keys
25
- - 🇪🇸 **Spanish (es)**: 573/573 keys (100%) - Added 173 keys
26
- - 🇫🇷 **French (fr)**: 573/573 keys (100%) - Added 173 keys
27
- - 🇯🇵 **Japanese (ja)**: 573/573 keys (100%) - Added 173 keys
28
- - 🇷🇺 **Russian (ru)**: 573/573 keys (100%) - Added 173 keys
29
- - 🇨🇳 **Chinese (zh)**: 573/573 keys (100%) - Added 173 keys
30
-
31
- ### 🔧 Technical Improvements
32
- - **NEW**: Automated translation key fixing utility (`scripts/fix-missing-translation-keys.js`)
33
- - **ENHANCED**: Smart placeholder generation for missing translations
34
- - **IMPROVED**: Translation consistency validation in test suite
35
- - **ADDED**: Language-specific indicators for translations requiring review
36
-
37
- ---
38
-
39
- ## 📋 Files Modified
40
-
41
- ### Translation Files Updated
42
- - `ui-locales/de.json` - Added 173 missing translation keys
43
- - `ui-locales/es.json` - Added 173 missing translation keys
44
- - `ui-locales/fr.json` - Added 173 missing translation keys
45
- - `ui-locales/ja.json` - Added 173 missing translation keys
46
- - `ui-locales/ru.json` - Added 173 missing translation keys
47
- - `ui-locales/zh.json` - Added 173 missing translation keys
48
-
49
- ### New Utilities
50
- - `scripts/fix-missing-translation-keys.js` - Automated translation key maintenance utility
51
-
52
- ### Documentation Updates
53
- - `package.json` - Version bump to 1.6.1 with updated metadata
54
- - `CHANGELOG.md` - Comprehensive 1.6.1 release documentation
55
- - `README.md` - Updated version and feature highlights
56
- - `RELEASE_NOTES_v1.6.1.md` - This release notes document
57
-
58
- ---
59
-
60
- ## 🛠️ Translation Key Fixing Utility
61
-
62
- ### Features
63
- - **Automated Detection**: Identifies missing translation keys across all language files
64
- - **Smart Placeholders**: Generates language-specific placeholder translations
65
- - **Batch Processing**: Updates all language files in a single operation
66
- - **Progress Reporting**: Detailed progress and summary reports
67
- - **Validation**: Ensures translation key consistency across languages
68
-
69
- ### Usage
70
- ```bash
71
- node scripts/fix-missing-translation-keys.js
72
- ```
73
-
74
- ### Output Example
75
- ```
76
- 🔧 I18N Translation Key Fixer - v1.6.1
77
- ========================================
78
-
79
- 📖 Loading English reference file...
80
- ✅ Found 573 keys in English file
81
-
82
- 🔄 Processing German (de)...
83
- 📊 Current keys: 400
84
- ⚠️ Missing keys: 173
85
- ✅ Added 173 keys to German
86
- 💾 Updated ui-locales/de.json
87
-
88
- 📊 SUMMARY REPORT
89
- ==================
90
- 📖 English reference keys: 573
91
- ➕ Total keys added: 1038
92
- 🌐 Languages processed: 6
93
- ```
94
-
95
- ---
96
-
97
- ## ✅ Quality Assurance
98
-
99
- ### Test Results
100
- - **Tests Passed**: 25/25 (100%)
101
- - **Translation Coverage**: 573/573 keys in all languages (100%)
102
- - **Missing Keys**: 0 across all languages
103
- - **Critical Issues**: None detected
104
- - **Package Verification**: ✅ All checks passed
105
-
106
- ### Validation Output
107
- ```
108
- 🌐 Checking Translation Consistency...
109
- ✅ Found 573 keys in English translations
110
- ✅ de.json: All critical keys present
111
- ✅ es.json: All critical keys present
112
- ✅ fr.json: All critical keys present
113
- ✅ ja.json: All critical keys present
114
- ✅ ru.json: All critical keys present
115
- ✅ zh.json: All critical keys present
116
-
117
- 📊 Overall Status: 🟢 READY
118
- ```
119
-
120
- ---
121
-
122
- ## 🚀 Release Readiness
123
-
124
- ### Package Verification
125
- - ✅ Version consistency across all files (1.6.1)
126
- - ✅ NPM configuration validated
127
- - ✅ All required files present
128
- - ✅ Translation completeness verified
129
- - ✅ Test suite passing (25/25)
130
-
131
- ### Publication Status
132
- **Ready for NPM Publication** 📦
133
-
134
- ```bash
135
- npm publish
136
- ```
137
-
138
- ---
139
-
140
- ## 📊 Impact Analysis
141
-
142
- ### Before v1.6.1
143
- - ❌ 173 missing keys per non-English language
144
- - ⚠️ Incomplete internationalization support
145
- - 🔍 Manual translation key management required
146
-
147
- ### After v1.6.1
148
- - ✅ 100% translation key coverage
149
- - 🌐 Complete internationalization support
150
- - 🔧 Automated translation maintenance tools
151
- - 📊 Enhanced validation and reporting
152
-
153
- ---
154
-
155
- ## 🔮 Next Steps
156
-
157
- ### Immediate (v1.6.2)
158
- - Review and improve placeholder translations
159
- - Replace `[LANG]` prefixed strings with proper translations
160
- - Enhance translation quality for non-English languages
161
-
162
- ### Medium-term (v1.7.x)
163
- - Implement UI-locales structure refactoring
164
- - Add translation quality scoring
165
- - Enhance automated translation suggestions
166
-
167
- ### Long-term (v2.x)
168
- - AI-powered translation assistance
169
- - Real-time translation validation
170
- - Advanced translation analytics
171
-
172
- ---
173
-
174
- ## 🎉 Conclusion
175
-
176
- Version 1.6.1 marks a **significant milestone** in the I18N Management Toolkit's journey toward complete internationalization. With **100% translation key coverage** achieved across all supported languages, the toolkit is now fully prepared for global deployment and provides a solid foundation for future enhancements.
177
-
178
- The addition of automated translation maintenance tools ensures that this level of completeness can be maintained as the project evolves, making the toolkit more robust and developer-friendly.
179
-
180
- **Status: ✅ READY FOR PRODUCTION**
181
-
182
- ---
183
-
184
- *Generated on December 19, 2024*
185
- *I18N Management Toolkit v1.6.1*
@@ -1,199 +0,0 @@
1
- # Release Notes - Version 1.6.3
2
-
3
- **Release Date:** July 27, 2025
4
- **Version:** 1.6.3
5
- **Status:** Stable Release - NPM/Yarn Ready
6
- **Maintainer:** Vladimir Noskov
7
-
8
- ## 🚀 Overview
9
-
10
- Version 1.6.3 represents a **stable, production-ready release** of the I18N Management Toolkit, optimized for npm and yarn distribution. This release focuses on translation file cleanup, quality assurance, and comprehensive documentation updates.
11
-
12
- ## 🌟 Key Highlights
13
-
14
- ### 🧹 Translation File Optimization
15
- - **Removed 42 extra keys** from translation files for cleaner, more maintainable codebase
16
- - **18 extra keys removed** from Spanish (`es.json`) - primarily from `checkUsage` section
17
- - **24 extra keys removed** from Japanese (`ja.json`) - from `hardcodedTexts` and `help` sections
18
- - **Zero extra keys** remaining across all language files
19
-
20
- ### ✅ Quality Assurance Excellence
21
- - **25/25 tests passing** (100% success rate)
22
- - **573/573 translation keys** maintained across all 7 supported languages
23
- - **100% translation coverage** with zero missing keys
24
- - **Dynamic translation verification** confirmed all patterns working correctly
25
-
26
- ### 📦 NPM/Yarn Distribution Ready
27
- - **Package optimization** for stable npm distribution
28
- - **Comprehensive documentation** updated to version 1.6.3
29
- - **Enterprise-grade stability** with robust testing suite
30
- - **Production-ready** with all quality checks passing
31
-
32
- ## 🔧 Technical Improvements
33
-
34
- ### Translation File Cleanup
35
- ```
36
- Removed Extra Keys:
37
- ├── es.json: 18 keys (checkUsage section)
38
- │ ├── checkUsage.reportTitle
39
- │ ├── checkUsage.generated
40
- │ ├── checkUsage.sourceDirectory
41
- │ └── ... (15 more keys)
42
- └── ja.json: 24 keys (hardcodedTexts & help sections)
43
- ├── hardcodedTexts.extraKeys
44
- ├── help.additionalOptions
45
- └── ... (22 more keys)
46
- ```
47
-
48
- ### Dynamic Translation Verification
49
- Verified all dynamic translation patterns are working correctly:
50
- - `{language}` - Language name substitution
51
- - `{fileName}` - File name substitution
52
- - `{fileSize}` - File size substitution
53
- - `{count}` - Count substitution
54
- - `{percentage}` - Percentage substitution
55
- - `{error}` - Error message substitution
56
- - And 50+ additional patterns
57
-
58
- ### Required Hardcoded Text Keys
59
- Confirmed presence and proper translation of critical keys:
60
- - `hardcodedTexts.noSourceFilesFound` - Available in all languages
61
- - `hardcodedTexts.analyzingTranslationCompleteness` - Available in all languages
62
-
63
- ## 📊 Quality Metrics
64
-
65
- ### Test Results
66
- ```
67
- ✅ Passed: 25/25 (100%)
68
- ❌ Failed: 0/25 (0%)
69
- ⚠️ Warnings: 0
70
- 📊 Overall Status: 🟢 READY
71
- ```
72
-
73
- ### Translation Coverage
74
- ```
75
- 🇺🇸 English (en): 573/573 keys (100%)
76
- 🇩🇪 German (de): 573/573 keys (100%)
77
- 🇪🇸 Spanish (es): 573/573 keys (100%)
78
- 🇫🇷 French (fr): 573/573 keys (100%)
79
- 🇯🇵 Japanese (ja): 573/573 keys (100%)
80
- 🇷🇺 Russian (ru): 573/573 keys (100%)
81
- 🇨🇳 Chinese (zh): 573/573 keys (100%)
82
- ```
83
-
84
- ### File Optimization
85
- ```
86
- Extra Keys Removed: 42 total
87
- ├── Spanish (es.json): 18 keys
88
- └── Japanese (ja.json): 24 keys
89
-
90
- Result: 0 extra keys remaining
91
- ```
92
-
93
- ## 📚 Documentation Updates
94
-
95
- ### Updated Files
96
- - `README.md` - Version 1.6.3 with latest features
97
- - `package.json` - Version bump and updated metadata
98
- - `CHANGELOG.md` - Comprehensive 1.6.3 release notes
99
- - `docs/api/API_REFERENCE.md` - Updated to version 1.6.3
100
- - `docs/api/CONFIGURATION.md` - Updated to version 1.6.3
101
- - `RELEASE_NOTES_v1.6.3.md` - This comprehensive release documentation
102
-
103
- ### New Documentation Features
104
- - **Stable Release Documentation** - Complete guide for npm/yarn distribution
105
- - **Quality Assurance Metrics** - Detailed testing and coverage information
106
- - **Translation File Optimization Guide** - Best practices for maintaining clean translation files
107
-
108
- ## 🛠️ Installation & Usage
109
-
110
- ### NPM Installation
111
- ```bash
112
- # Global installation (recommended)
113
- npm install -g i18ntk
114
-
115
- # Local installation
116
- npm install i18ntk --save-dev
117
- ```
118
-
119
- ### Yarn Installation
120
- ```bash
121
- # Global installation
122
- yarn global add i18ntk
123
-
124
- # Local installation
125
- yarn add i18ntk --dev
126
- ```
127
-
128
- ### Quick Start
129
- ```bash
130
- # Initialize i18n setup
131
- i18ntk-init
132
-
133
- # Run main management interface
134
- i18ntk-manage
135
-
136
- # Run automated workflow
137
- i18ntk-autorun
138
-
139
- # Run tests
140
- npm test
141
- ```
142
-
143
- ## 🔄 Migration Guide
144
-
145
- ### From Version 1.6.2 to 1.6.3
146
-
147
- **No breaking changes** - This is a maintenance release focused on cleanup and optimization.
148
-
149
- **Recommended Actions:**
150
- 1. Update to version 1.6.3: `npm update i18ntk`
151
- 2. Run tests to verify: `npm test`
152
- 3. Review updated documentation
153
- 4. No configuration changes required
154
-
155
- ### Compatibility
156
- - **Node.js:** >=16.0.0
157
- - **NPM:** >=7.0.0
158
- - **Yarn:** >=1.22.0
159
- - **React i18next:** >=11.0.0
160
- - **Vue i18n:** >=9.0.0
161
- - **Angular i18n:** >=12.0.0
162
-
163
- ## 🚀 What's Next
164
-
165
- ### Version 1.7.0 (Planned)
166
- - Enhanced debugging capabilities
167
- - Advanced reporting features
168
- - Performance optimizations
169
- - Additional language support
170
- - UI-Locales structure refactoring
171
-
172
- ### Long-term Roadmap
173
- - Multi-language object format for translation keys
174
- - Enhanced AI-powered translation features
175
- - Advanced analytics and insights
176
- - Plugin system for custom extensions
177
-
178
- ## 📞 Support & Resources
179
-
180
- ### Documentation
181
- - **Main Documentation:** [README.md](./README.md)
182
- - **API Reference:** [docs/api/API_REFERENCE.md](./docs/api/API_REFERENCE.md)
183
- - **Configuration Guide:** [docs/api/CONFIGURATION.md](./docs/api/CONFIGURATION.md)
184
- - **Changelog:** [CHANGELOG.md](./CHANGELOG.md)
185
-
186
- ### Community
187
- - **GitHub Repository:** [i18n-management-toolkit](https://github.com/vladnoskv/i18n-management-toolkit)
188
- - **Issues & Bug Reports:** [GitHub Issues](https://github.com/vladnoskv/i18n-management-toolkit/issues)
189
- - **Feature Requests:** [GitHub Discussions](https://github.com/vladnoskv/i18n-management-toolkit/discussions)
190
-
191
- ### Maintainer
192
- - **Name:** Vladimir Noskov
193
- - **GitHub:** [@vladnoskv](https://github.com/vladnoskv)
194
-
195
- ---
196
-
197
- **Thank you for using the I18N Management Toolkit!** 🌍
198
-
199
- This stable release represents weeks of development, testing, and optimization. We're excited to see how it helps streamline your internationalization workflows.
@@ -1,162 +0,0 @@
1
- # i18n Management Toolkit v1.3.0 Release Notes
2
-
3
- ## 🚀 Release Overview
4
-
5
- **Version:** 1.3.0
6
- **Release Date:** August 2, 2025
7
- **Type:** Major Feature Release
8
- **Status:** Current Stable
9
-
10
- This release introduces significant improvements to path resolution and directory configuration, addressing long-standing issues with relative path handling while adding powerful new customization features.
11
-
12
- ## ✨ New Features
13
-
14
- ### 🎯 Per-Script Directory Configuration
15
- - **Individual Directory Control**: Configure different source directories for each script type (`analyze`, `complete`, `init`, `manage`)
16
- - **Flexible Structure**: Use different directory layouts for different purposes
17
- - **CLI Override Support**: Override directories via command-line arguments
18
- - **Backward Compatibility**: Existing configurations continue to work unchanged
19
-
20
- ### 🔧 Fixed Path Resolution Logic
21
- - **Correct Relative Path Handling**: Fixed issue where relative paths were resolved from parent directory instead of project root
22
- - **Consistent Behavior**: All scripts now handle paths consistently
23
- - **Settings Compliance**: Analyzing logic now correctly follows settings configuration
24
- - **Cross-Platform Support**: Improved path resolution across Windows, macOS, and Linux
25
-
26
- ### 🌍 Enhanced Internationalization
27
- - **Continued Language Support**: Maintained full compatibility with existing language configurations
28
- - **Framework Integration**: Enhanced support for React, Vue, Angular, and Next.js applications
29
- - **Locale Validation**: Improved locale code validation and error reporting
30
-
31
- ### ⚙️ Configuration Improvements
32
- - **Custom Directory Overrides**: Override any script directory via CLI arguments
33
- - **Settings CLI Enhancement**: Improved configuration management interface
34
- - **Migration Support**: Built-in tools for upgrading from v1.2.x
35
- - **Validation Tools**: Enhanced configuration validation and error detection
36
-
37
- ## 🐛 Bug Fixes
38
-
39
- ### Path Resolution Issues
40
- - **Fixed**: Relative paths in `sourceDir` and `outputDir` now resolve correctly from project root
41
- - **Fixed**: Scripts no longer use incorrect parent directory as base for relative paths
42
- - **Fixed**: Settings file paths now respect the configured project root
43
-
44
- ### Configuration Issues
45
- - **Fixed**: Settings loading now correctly prioritizes CLI arguments over configuration files
46
- - **Fixed**: Directory auto-detection improved for complex project structures
47
- - **Fixed**: Error messages now provide clearer guidance for configuration issues
48
-
49
- ## 📊 Breaking Changes
50
-
51
- ### ⚠️ Migration Required
52
- While this release maintains backward compatibility, we **strongly recommend** testing on a development branch before production deployment due to path resolution changes.
53
-
54
- ### No Breaking API Changes
55
- - All existing CLI commands work identically
56
- - All existing configuration files are compatible
57
- - All existing directory structures are supported
58
-
59
- ## 🔄 Migration Guide
60
-
61
- ### Step 1: Backup Your Configuration
62
- ```bash
63
- # Backup your current settings
64
- cp .i18ntk-settings.json .i18ntk-settings.json.backup
65
- cp i18ntk.config.js i18ntk.config.js.backup
66
- ```
67
-
68
- ### Step 2: Update to v1.3.0
69
- ```bash
70
- # Update the package
71
- npm update i18n-management-toolkit
72
-
73
- # Or reinstall
74
- npm install --save-dev i18n-management-toolkit@latest
75
- ```
76
-
77
- ### Step 3: Test Configuration
78
- ```bash
79
- # Test your current configuration
80
- npx i18ntk analyze --dry-run
81
- npx i18ntk complete --dry-run
82
- ```
83
-
84
- ### Step 4: Configure Custom Directories (Optional)
85
- ```bash
86
- # Configure custom directories per script type
87
- npx i18ntk init --custom-directories
88
- ```
89
-
90
- ### Step 5: Verify Production Setup
91
- ```bash
92
- # Run comprehensive validation
93
- npx i18ntk validate
94
- ```
95
-
96
- ## 📖 Documentation Updates
97
-
98
- ### New Documentation
99
- - **[Script Directory Guide](../SCRIPT_DIRECTORY_GUIDE.md)** - Complete guide to custom directory configuration
100
- - **[Migration Guide](../SCRIPT_DIRECTORY_GUIDE.md#migration-guide)** - Step-by-step migration instructions
101
- - **[Configuration Examples](../SCRIPT_DIRECTORY_GUIDE.md#usage-examples)** - Real-world configuration examples
102
-
103
- ### Updated Documentation
104
- - **[API Reference](./api/API_REFERENCE.md)** - Updated with new directory configuration options
105
- - **[Configuration Guide](./api/CONFIGURATION.md)** - Enhanced with per-script directory examples
106
- - **[Framework Integration](./frameworks/README.md)** - Updated path resolution examples
107
-
108
- ## 🧪 Testing Recommendations
109
-
110
- ### Before Production Deployment
111
- 1. **Create Development Branch**: Always test on a separate branch first
112
- 2. **Run Dry-Run Commands**: Use `--dry-run` flag to preview changes
113
- 3. **Validate Configuration**: Run `npx i18ntk validate` to check setup
114
- 4. **Test All Scripts**: Verify `analyze`, `complete`, `init`, and `manage` scripts
115
- 5. **Check Path Resolution**: Ensure relative paths work correctly in your environment
116
-
117
- ### Testing Checklist
118
- - [ ] All scripts run without errors
119
- - [ ] Relative paths resolve correctly
120
- - [ ] Custom directory configurations work as expected
121
- - [ ] Existing translations are not affected
122
- - [ ] Configuration validation passes
123
- - [ ] Framework integration tests pass
124
-
125
- ## 🐛 Known Issues
126
-
127
- ### Current Limitations
128
- - **Windows Path Separators**: Some edge cases with mixed path separators on Windows
129
- - **Deep Nested Structures**: Very deep directory structures (>10 levels) may have performance impacts
130
- - **Symbolic Links**: Limited support for symbolic links in directory paths
131
-
132
- ### Future Improvements
133
- - Enhanced symbolic link support
134
- - Performance optimizations for large projects
135
- - Additional framework-specific integrations
136
-
137
- ## 📊 Version Comparison
138
-
139
- | Feature | v1.2.x | v1.3.0 |
140
- |---------|---------|---------|
141
- | Path Resolution | ❌ Incorrect relative paths | ✅ Correct from project root |
142
- | Per-Script Directories | ❌ Not supported | ✅ Fully configurable |
143
- | CLI Overrides | ❌ Limited | ✅ All directories supported |
144
- | Migration Tools | ❌ Manual | ✅ Built-in guides |
145
- | Framework Support | ✅ Basic | ✅ Enhanced |
146
- | Backward Compatibility | ✅ Full | ✅ Full |
147
-
148
- ## 🎉 Acknowledgments
149
-
150
- Special thanks to the community for reporting path resolution issues and providing valuable feedback on directory configuration needs. Your contributions have made this significant improvement possible.
151
-
152
- ## 📞 Support
153
-
154
- - **[Issues](https://github.com/your-repo/i18n-management-toolkit/issues)** - Report bugs or request features
155
- - **[Discussions](https://github.com/your-repo/i18n-management-toolkit/discussions)** - Ask questions or share ideas
156
- - **[Documentation](../README.md)** - Comprehensive guides and examples
157
-
158
- ---
159
-
160
- **Next Release Preview:** v1.4.0 - Enhanced framework integrations and performance optimizations
161
-
162
- **Upgrade Recommendation:** **HIGH** - All users should upgrade to benefit from path resolution fixes and new configuration features.