Roadmap

Planned features and improvements for upcoming releases

🚧

Active Development

This roadmap is subject to change based on community feedback. Want to suggest a feature? Open an issue on GitHub

v3.3.0 - Q1 2026

Code Quality Focus

Remove all `any` typesPlanned

Replace 17 identified `any` usages with proper TypeScript interfaces and type guards for 100% type safety

Remove @internal commentsPlanned

Clean up codebase by removing 56 @internal JSDoc comments that are no longer needed

Modular refactoringPlanned

Continue splitting large manager classes following ConfigManager pattern - extract EventManager, ClockManager, and ValidationManager into focused modules

Constants extractionPlanned

Move magic numbers and strings to dedicated constants files for better maintainability

v4.0.0 - Q2 2026

Major Release - Breaking Changes

New Features

Seconds pickerPlanned

Add optional seconds selection with HH:MM:SS format support

Time range selectionPlanned

Select start and end times with validation and conflict detection

Enhanced keyboard navigationPlanned

Full keyboard control: arrow keys for time adjustment, Tab/Shift+Tab navigation, Enter/Escape shortcuts

Custom time intervalsPlanned

Configure minute/second step intervals (e.g., 15-minute increments)

Breaking Changes (Completed ✅)

✅ Removed deprecated DOM events

Complete removal of timepicker:* DOM events. All users must migrate to EventEmitter API.

❌ document.addEventListener('timepicker:open', ...)
✅ picker.on('open', ...)

Future Plans (v4.1+)

Framework Integrations

Official wrapper libraries for popular frameworks:

ReactVueAngularSvelte

Internationalization

RTL SupportPlanned

Full right-to-left layout support for Arabic, Hebrew, and other RTL languages

Timezone SupportPlanned

Handle different timezones with automatic conversion and display

Locale FormattingPlanned

Automatic time format detection based on user locale (12h vs 24h)

Advanced Customization

Custom Clock FacesPlanned

Plugin system for custom clock face designs and behaviors

Theme BuilderPlanned

Visual theme editor for creating custom color schemes

Animation PresetsPlanned

Predefined animation styles (bounce, slide, fade) with custom timing

Release Schedule

Patch Releases

v3.x.x

Bug fixes and minor improvements - released as needed

Minor Releases

v3.3.0

New features, backward compatible - quarterly schedule

Major Releases

v4.0.0

Breaking changes, major features - yearly with migration guides

Beta Releases

v4.0.0-beta.x

Early access to new features - 1-2 months before major releases

💡

Contribute

Want to help build these features? Check out our Contributing Guide to get started!