Description

Issue: #4792

This PR introduces useTemporal, a new composable that provides a reactive wrapper around the modern Temporal API (TC39 proposal) using the @js-temporal/polyfill package. This implementation addresses the limitations of the legacy Date object by providing:

• 🌍 Robust timezone handling with conversion utilities
• 📅 Support for multiple calendar systems (Gregorian, Islamic, Hebrew, etc.)
• ⚡ Configurable reactive updates
• 🎯 Comprehensive TypeScript support
• 🔧 Rich set of date/time manipulation functions

The implementation includes:

• Full test coverage (index.test.ts)
• Comprehensive documentation (index.md)
• Interactive demo component (demo.vue)
• Two main exports:
  • useTemporal(): Reactive composable
  • createTemporal(): Static utility function

I have:

• Read the Contributing Guidelines
• Read the Pull Request Guidelines
• Verified no similar PR exists
• Included comprehensive tests
• Added detailed documentation
• Created a demo component

Additional context

This implementation is particularly focused on:

1. Type safety: Full TypeScript support with proper Temporal types
2. Flexibility: Support for different timezones and calendar systems
3. Performance: Efficient updates using shallowRef
4. Testing: Comprehensive test coverage including edge cases
5. Documentation: Detailed API documentation with examples

The demo component showcases real-world usage scenarios including:

• World clock functionality
• Calendar system conversion
• Duration-based calculations
• Formatting options