Changelog

All notable changes to React TimePicker Arc are documented here. This project follows semantic versioning to ensure backward compatibility and clear upgrade paths for developers.

Each version includes detailed information about new features, improvements, bug fixes, and any breaking changes that may affect your implementation.

Version 2.0.0

Latest

Released: September 5, 2025

🎉 Major Features

•Added ClockPicker component with visual clock interface
•Introduced standalone Clock component for display purposes
•Enhanced export system with named exports alongside default export
•Unified API across all components for consistent developer experience

🆕 New Components

ClockPicker

Interactive visual clock interface for intuitive time selection with hour and minute hands.

Clock

Display-only clock component for showing current time or static time values.

📦 Export Structure Changes

Enhanced export system providing both named and default exports for better flexibility:

✅ New (v2.0.0)

⚠️ Previous (v1.0.0)

⚠️ Breaking Changes

None in this release! Version 2.0.0 maintains full backward compatibility with v1.0.0.

All existing TimePicker implementations will continue to work without any code changes. The major version bump reflects the significant new functionality rather than breaking changes.

🚀 Migration Guide

Upgrading from v1.0.0 to v2.0.0 requires no code changes for existing implementations:

Step 1: Update Package

Step 2: Optional - Switch to Named Exports

Step 3: Explore New Components

✨ Improvements

•Enhanced TypeScript definitions for better IDE support
•Improved tree-shaking support with named exports
•Enhanced documentation and examples
•Optimized bundle size for individual component imports

Version 1.0.0

Initial Release

Released: Initial Launch

🎯 Initial Features

•TimePicker component with dropdown interface
•Support for 12-hour and 24-hour time formats
•Optional seconds display functionality
•AM/PM toggle for 12-hour format
•Multiple return types (string, Date, timestamp)
•Customizable styling through classNames prop
•Positioning options (top, bottom, left, right, center)
•Built-in validation and error handling
•Custom icons support
•TypeScript support with comprehensive type definitions

📖 v1.0.0 Usage

The initial release provided a solid foundation with default export:

Why Upgrade to v2.0.0?

Enhanced User Experience

ClockPicker provides an intuitive visual interface that many users find more natural than dropdown selection, especially on touch devices.

Better Developer Experience

Named exports enable better tree-shaking, improved IDE autocomplete, and cleaner import statements in larger applications.

Flexible Implementation

Choose between TimePicker for quick selection or ClockPicker for visual interaction, or use Clock component for display-only scenarios.

Zero Breaking Changes

Upgrade with confidence knowing your existing code will continue to work exactly as before, while gaining access to new functionality.

Component Comparison

Understanding when to use each component in v2.0.0:

Component	Interface	Best For	Since Version
TimePicker	Dropdown lists	Forms, quick selection	v1.0.0
ClockPicker	Visual clock	Touch devices, intuitive UX	v2.0.0
Clock	Display only	Dashboards, time display	v2.0.0

Future Roadmap

Planned features and improvements for upcoming versions:

v2.1.0 (Planned)

•Enhanced accessibility features (ARIA improvements)
•Additional theme presets and styling options
•Performance optimizations for large lists

v2.2.0 (Under Consideration)

•Time range picker component
•Internationalization (i18n) support
•Custom time step intervals

Next Steps

Now that you have explored the changelog, consider visiting these resources to further enhance your understanding and implementation:

← Installation

Learn how to install the package and set up the components in your project.

Timpicker Overview →

Dive into the full API reference and customization options for the TimePicker component.