chore: release v1.0.0; update CHANGELOG and README for stable release; refactor tests to use new localizer structure

Author: iqbalhasandev

CHANGELOG.md

@@ -2,69 +2,128 @@
 
 All notable changes to `@devwizard/laravel-localizer-react` will be documented in this file.
 
-## v0.0.4 - 2025-11-09
+## v1.0.0 - 2025-11-09
 
-@beta
+### 🎉 Initial Stable Release
 
-## v0.0.1 - 2025-11-09
+This is the first stable release of Laravel Localizer React, providing seamless integration between Laravel translations and React applications.
 
-### 🎉 Initial Beta Release
+### ✨ Features
 
-- **useTranslation Hook**: React hook for accessing Laravel translations
-  
-  - `__()` - Main translation function with replacements and fallback
-  - `trans()` - Alias for `__()`
-  - `lang()` - Alias for `__()`
+#### useLocalizer Hook
+
+A powerful React hook for accessing Laravel translations with full TypeScript support:
+
+- **Translation Functions**
+  - `__()` - Main translation function with placeholder replacement and fallback support
+  - `trans()` - Alias for `__()` (Laravel compatibility)
+  - `lang()` - Alias for `__()` (Laravel compatibility)
   - `has()` - Check if translation key exists
-  - `choice()` - Pluralization support
-  - `locale` - Current locale code
-  - `dir` - Text direction (ltr/rtl)
-  - `availableLocales` - Available locales with metadata
+  - `choice()` - Pluralization support with replacement variables
+
+- **Locale Information**
+  - `locale` - Current locale code (e.g., 'en', 'fr')
+  - `dir` - Text direction ('ltr' or 'rtl')
+  - `availableLocales` - Available locales with metadata (label, flag, direction)
   - `translations` - All translations for current locale
-  
-- **Vite Plugin**: Automatic TypeScript generation
-  
-  - Watches `lang/**` directory for changes
-  - Debounced regeneration (300ms)
-  - Runs `php artisan localizer:generate --all` automatically
-  - Zero configuration required
-  
-- **TypeScript Support**: Full type safety
-  
-  - Comprehensive interfaces for all types
-  - IntelliSense support in IDEs
-  - Strict mode compatible
-  
-- **Inertia.js Integration**: Seamless integration with Inertia.js
-  
-  - Works with both Inertia v1 and v2
-  - Supports React 18 and 19
-  - Automatic page props detection
-  
-
-### 📚 Documentation
-
-- Comprehensive README with usage examples
-- API documentation with TypeScript interfaces
-- Migration guide from v1 to v2
 
-### 🧪 Testing
+#### Placeholder Replacement
+
+- Supports both `:placeholder` and `{placeholder}` formats
+- Multiple placeholders in single string
+- Numeric and string replacements
+- Nested placeholder support
+
+#### Pluralization
+
+- Laravel-compatible pluralization format
+- Support for zero, one, and many forms
+- Placeholder replacement in pluralized strings
+- Custom count-based rules
+
+#### Vite Plugin
+
+Automatic TypeScript generation with hot module replacement:
+
+- Watches language files for changes
+- Non-blocking command execution
+- Configurable watch patterns
+- Debug logging option
+- Integrates with Laravel Artisan commands
+
+#### Inertia.js Integration
+
+Seamless integration with Inertia.js:
+
+- Automatic locale detection from page props
+- Reactive locale updates
+- Shared locale data
+- RTL support via page props
+
+### 🎯 TypeScript Support
 
-- Jest configuration
-- Comprehensive test suite with 100% coverage
-- Testing Library for React components
-- ESM module support
+- Full type definitions
+- IntelliSense support in IDEs
+- Type-safe placeholder replacements
+- Strict mode compatible
+- Exported types for custom implementations
 
-### 🛠️ Development Tools
+### 🧪 Testing
 
-- ESLint configuration with TypeScript and React rules
-- Prettier for code formatting
-- tsup for building and bundling
-- GitHub Actions for CI/CD
+- Comprehensive test suite with Jest
+- React Testing Library integration
+- 100% code coverage
+- Mock Inertia.js integration
+- Example test patterns
 
 ### 📦 Package Configuration
 
-- ESM-only distribution
+- ESM-only distribution (modern bundlers)
 - Tree-shakeable exports
-- Proper package.json exports field
-- Peer dependencies: React 18+, Inertia v1/v2, Vite 5+
+- Separate entry points for hook and Vite plugin
+- Proper peer dependencies
+- Side-effect free
+
+### 🔧 Build System
+
+- Built with tsup for optimal bundling
+- Source maps for debugging
+- Minified production builds
+- Declaration files included
+
+### � Documentation
+
+- Complete README with examples
+- API reference
+- Setup guide
+- Integration examples
+- TypeScript usage patterns
+
+### 🔗 Dependencies
+
+- React 18 or 19 (peer dependency)
+- Inertia.js v1 or v2 (peer dependency)
+- Vite 5+ (peer dependency for plugin)
+- `minimatch` for pattern matching in Vite plugin
+
+### ⚡ Performance
+
+- Memoized translation lookups
+- Cached locale data
+- Optimized re-renders
+- Lazy evaluation
+
+### 🎨 Developer Experience
+
+- Hot module replacement in development
+- Automatic regeneration on file changes
+- Clear error messages
+- Debug mode for troubleshooting
+
+### 📝 Requirements
+
+- Node.js 16+
+- React 18+
+- Inertia.js v1 or v2
+- Laravel Localizer backend package
+