Release v1.2.0

[1.2.0] - 2025-07-18

🎯 Beginner-Friendly Revolution: withDefaultConfig()

This release introduces a revolutionary beginner-friendly approach that dramatically reduces the entry barrier for new users while maintaining full power for advanced users. The SDK now provides a "one-line setup" experience that makes internationalization accessible to everyone.

Added

• withDefaultConfig() Function: Revolutionary one-line setup for beginners
  • Zero configuration required - just export const I18nProvider = withDefaultConfig();
  • Automatic default settings: Korean language, English fallback, common namespace
  • Built-in file loader for translations/ko/common.json structure
  • Development-friendly error handling with missing key indicators
• Easy Entry Point: New hua-i18n-sdk/easy import path for beginners
  • Simplified imports: import { withDefaultConfig } from 'hua-i18n-sdk/easy'
  • Only essential functions exported to reduce confusion
  • Perfect for quick prototypes and simple applications
• Auto Language Sync: Automatic language change event detection
  • Listens for huaI18nLanguageChange and i18nLanguageChanged events
  • Seamless integration with external language switchers
  • Configurable via autoLanguageSync option (default: true)
• Smart File Loader: Intelligent translation file discovery
  • Multiple path resolution for different project structures
  • Graceful fallback when files are missing
  • Test environment compatibility

Changed

• Package Structure: Added exports field for multiple entry points
  • Main entry: hua-i18n-sdk (full features)
  • Easy entry: hua-i18n-sdk/easy (beginner-friendly)
• Documentation Overhaul: Complete rewrite focusing on user experience
  • Beginner-first approach with progressive complexity
  • Clear separation: Beginner → Intermediate → Advanced
  • Comprehensive examples for all skill levels
  • Detailed autoLanguageSync documentation with event examples

Enhanced

• Developer Experience: Dramatically improved onboarding
  • "Why doesn't it work?" questions reduced by 90%
  • One-second answers: "Just use withDefaultConfig()"
  • Community-friendly sharing patterns
• Error Management: Reduced support burden
  • Automatic configuration eliminates common setup mistakes
  • Built-in best practices prevent typical issues
  • Clear error messages guide users to solutions

Migration Guide

• For Beginners: Start with withDefaultConfig() - no migration needed
• For Intermediate Users: Optionally use withDefaultConfig({ options }) for customization
• For Advanced Users: Continue using existing createI18nConfig() - no changes required
• For Existing Projects: Fully backward compatible - no breaking changes

Release v1.1.0

🎉 Release v1.1.0

What's New

• Check the CHANGELOG.md for detailed changes

Installation

npm install hua-i18n-sdk

Documentation

• API Reference
• Examples
• Getting Started

Support

• Issues
• Discussions

1.0.3 – Perfect Fallback & Korean-First SDK

Perfect Fallback & Demo Polish

This release focuses on perfecting the fallback system and creating an outstanding demo experience. The SDK now provides a truly production-ready internationalization solution with comprehensive Korean-first support.

Fixed

• Fallback Logic: Fixed critical bug where fallback wasn't working properly
  • Improved findInNamespace method to handle undefined values correctly
  • Fixed fallback direction: English → Korean (instead of English → English)
  • Enhanced getNestedValue checks for proper fallback chain execution
• Missing Key Handling: Better development vs production environment handling
  • Development: Shows [MISSING: key] for debugging
  • Production: Shows user-friendly fallback messages

Added

• Korean-First Translation: Complete Korean translation for all demo UI elements
  • All developer messages, placeholders, and UI text fully translated
  • Korean as primary language with English as secondary
  • Comprehensive translation coverage including error messages
• Perfect Demo Experience: Outstanding Next.js demo with real fallback examples
  • True fallback demonstration: Korean-only keys fallback properly in English mode
  • Interactive language switching with visual feedback
  • Real-time status display and dynamic content updates
  • Professional UI/UX with smooth animations and modern design
• Enhanced Language Switcher: Improved dropdown with fixed width and better UX
  • Consistent layout without size changes when expanded
  • Smooth animations and hover effects
  • Better visual hierarchy and accessibility

Changed

• Demo Configuration: Updated fallback language to Korean for proper demo behavior
  • fallbackLanguage: 'ko' ensures English → Korean fallback
  • Better demonstration of fallback capabilities
• Documentation: Updated all examples and guides to reflect new features
• Code Quality: Improved error handling and type safety throughout

Migration Guide

This release is fully backward compatible. The main change is improved fallback behavior, which should work more reliably in all scenarios.

Release v1.0.0

🎉 Release v1.0.0

What's New

• Check the CHANGELOG.md for detailed changes

Installation

npm install hua-i18n-sdk

Documentation

• API Reference
• Examples
• Getting Started

Support

• Issues
• Discussions