@oneluiz/dual-datepicker 3.3.0 → 3.4.0

package/README.md

@@ -31,6 +31,7 @@ npm install @oneluiz/dual-datepicker
   - [Disabled Dates](#disabled-dates)
   - [Display Format](#display-format)
   - [Apply/Confirm Button](#applyconfirm-button)
+  - [Time Picker](#time-picker)
   - [Hover Range Preview](#hover-range-preview)
   - [Custom Presets](#custom-presets)
   - [Date Adapter System](#date-adapter-system)
@@ -470,6 +471,109 @@ export class DashboardExample {
 | User control | Automatic | Explicit confirmation |
 | Best for | Simple forms | Dashboards, reports |
 
+---
+
+### Time Picker
+
+**Select precise datetime ranges with optional time picker.** Choose exact start and end times in addition to dates, with support for 12h/24h formats and configurable minute steps.
+
+#### Basic Usage
+
+```typescript
+import { Component } from '@angular/core';
+import { DateRange } from '@oneluiz/dual-datepicker';
+
+@Component({
+  template: `
+    <ngx-dual-datepicker
+      [enableTimePicker]="true"
+      (dateRangeChange)="onDateRangeChange($event)">
+    </ngx-dual-datepicker>
+  `
+})
+export class AppointmentComponent {
+  onDateRangeChange(range: DateRange) {
+    console.log('Start:', range.startDate, 'at', range.startTime);
+    console.log('End:', range.endDate, 'at', range.endTime);
+    // startTime and endTime are in 'HH:mm' format
+  }
+}
+```
+
+#### Configuration Options
+
+```typescript
+// 12-hour format with AM/PM
+<ngx-dual-datepicker
+  [enableTimePicker]="true"
+  timeFormat="12h"
+  defaultStartTime="09:00"
+  defaultEndTime="17:00"
+  (dateRangeChange)="onDateRangeChange($event)">
+</ngx-dual-datepicker>
+
+// 30-minute intervals
+<ngx-dual-datepicker
+  [enableTimePicker]="true"
+  [minuteStep]="30"
+  (dateRangeChange)="onDateRangeChange($event)">
+</ngx-dual-datepicker>
+
+// With Apply button for controlled changes
+<ngx-dual-datepicker
+  [enableTimePicker]="true"
+  [requireApply]="true"
+  (dateRangeChange)="onDateRangeChange($event)">
+</ngx-dual-datepicker>
+```
+
+#### DateRange with Time
+
+When `enableTimePicker` is true, the DateRange includes optional time properties:
+
+```typescript
+interface DateRange {
+  startDate: string;     // 'YYYY-MM-DD'
+  endDate: string;       // 'YYYY-MM-DD'
+  rangeText: string;     // Display text
+  startTime?: string;    // 'HH:mm' or 'HH:mm AM/PM'
+  endTime?: string;      // 'HH:mm' or 'HH:mm AM/PM'
+}
+```
+
+#### Configuration Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `enableTimePicker` | boolean | `false` | Enable time selection |
+| `timeFormat` | `'12h'` \| `'24h'` | `'24h'` | Time display format |
+| `minuteStep` | number | `15` | Minute intervals (1, 5, 15, or 30) |
+| `defaultStartTime` | string | `'00:00'` | Default start time (HH:mm) |
+| `defaultEndTime` | string | `'23:59'` | Default end time (HH:mm) |
+
+#### Perfect Use Cases
+
+- 📅 **Appointment booking systems** - Schedule meetings with exact times
+- 🎫 **Event scheduling** - Create events with start and end times
+- 🏢 **Meeting planners** - Book conference rooms with time slots
+- 📊 **Time-based reporting** - Generate reports for specific time ranges
+- 👥 **Shift management** - Assign work shifts with precise times
+- 🎬 **Reservation systems** - Book resources with time constraints
+
+#### Key Features
+
+- ✅ Optional - disabled by default (backward compatible)
+- ✅ 12h (AM/PM) or 24h time format
+- ✅ Configurable minute steps (1, 5, 15, 30)
+- ✅ Default start/end times support
+- ✅ Works with all themes
+- ✅ Integrates with requireApply mode
+- ✅ Fully accessible with keyboard navigation
+
+**For complete documentation, see [TIME_PICKER.md](TIME_PICKER.md)**
+
+---
+
 ### Hover Range Preview
 
 **Automatic visual feedback while selecting dates.** Provides instant visual preview of the date range when hovering over dates before clicking to confirm.
@@ -759,6 +863,12 @@ spanishLocale: LocaleConfig = {
 | `disabledDates` | `Date[] \| ((date: Date) => boolean)` | `undefined` | Array of dates or function to disable specific dates |
 | `displayFormat` | `string` | `'D MMM'` | Format for displaying dates in input (tokens: YYYY, YY, MMMM, MMM, MM, M, DD, D) |
 | `requireApply` | `boolean` | `false` | Require Apply button confirmation before emitting changes |
+| `enableTimePicker` | `boolean` | `false` | Enable time selection |
+| `timeFormat` | `'12h' \| '24h'` | `'24h'` | Time display format (12-hour with AM/PM or 24-hour) |
+| `minuteStep` | `number` | `15` | Step for minute selector (1, 5, 15, or 30) |
+| `defaultStartTime` | `string` | `'00:00'` | Default start time in HH:mm format |
+| `defaultEndTime` | `string` | `'23:59'` | Default end time in HH:mm format |
+| `theme` | `ThemeType` | `'default'` | Theme preset: 'default', 'bootstrap', 'bulma', 'foundation', 'tailwind', 'custom' |
 | `enableKeyboardNavigation` | `boolean` | `true` | Enable keyboard navigation |
 | `inputBackgroundColor` | `string` | `'#fff'` | Input background color |
 | `inputTextColor` | `string` | `'#495057'` | Input text color |
@@ -809,6 +919,8 @@ interface DateRange {
   startDate: string;   // ISO format: 'YYYY-MM-DD'
   endDate: string;     // ISO format: 'YYYY-MM-DD'
   rangeText: string;   // Display text: 'DD Mon - DD Mon'
+  startTime?: string;  // Optional: 'HH:mm' or 'HH:mm AM/PM' (when enableTimePicker=true)
+  endTime?: string;    // Optional: 'HH:mm' or 'HH:mm AM/PM' (when enableTimePicker=true)
 }
 
 interface MultiDateRange {
@@ -1886,20 +1998,36 @@ export class ExampleComponent {
 
 Recently shipped:
 
+**v3.3.0:**
+- ✅ **Theming System** - Pre-built themes for Bootstrap, Bulma, Foundation, Tailwind CSS, and Custom
+- ✅ **CSS Variables Support** - 13 customizable variables for branding
+- ✅ **Framework Integration** - Match your existing design system seamlessly
+
+**v3.2.0:**
+- ✅ **Hover Range Preview** - Visual feedback before confirming selection
+- ✅ **Apply/Confirm Button** - Require confirmation for enterprise dashboards
+- ✅ **Display Format** - Customize date display (DD/MM/YYYY, MM/DD/YYYY, etc.)
+- ✅ **Disabled Dates** - Block weekends, holidays, or custom logic
+
+**v3.1.0:**
+- ✅ **Complete Keyboard Navigation** - Arrow keys, Enter/Space, Tab, Escape, Home/End, PageUp/Down
+- ✅ **Full Accessibility Audit** - WCAG 2.1 Level AA compliance
+
+**v2.7.0:**
+- ✅ **Multi-range Support** - Select UNLIMITED date ranges (Material CAN'T do this!)
+
 **v2.6.0:**
-- ✅ **Flexible Preset System** - `getValue()` pattern for custom date logic (This month, Last month, Quarter to date, etc.)
+- ✅ **Flexible Preset System** - `getValue()` pattern for custom date logic
 - ✅ **Pre-built Preset Utilities** - CommonPresets for Dashboard, Reporting, Financial, Analytics
-- ✅ **Real Differentiator** - Perfect for ERP, BI, POS, and Reporting systems
 
 **v2.5.0:**
 - ✅ **Date Adapter System** - Support for DayJS, date-fns, Luxon, and custom date libraries
 
-Planned features and improvements:
+Planned features:
 
-- ⬜ **Complete keyboard navigation** - Arrow keys, Enter/Space, Tab, Escape
-- ⬜ **Full accessibility audit** - WCAG 2.1 AA compliance
-- ⬜ **Multi-range support** - Select multiple date ranges
-- ⬜ **Theming system** - Pre-built theme presets
+- ⬜ **Time Picker** - Select date + time ranges
+- ⬜ **Mobile Optimizations** - Enhanced touch gestures and responsive layout
+- ⬜ **Range Shortcuts** - Quick selection buttons (Today, This Week, etc.)
 
 ## 📄 License
 

package/dual-datepicker.component.d.ts

@@ -5,6 +5,8 @@ export interface DateRange {
     startDate: string;
     endDate: string;
     rangeText: string;
+    startTime?: string;
+    endTime?: string;
 }
 export interface MultiDateRange {
     ranges: DateRange[];
@@ -49,6 +51,11 @@ export declare class DualDatepickerComponent implements OnInit, OnChanges, Contr
     disabledDates: Date[] | ((date: Date) => boolean) | undefined;
     displayFormat: string;
     requireApply: boolean;
+    enableTimePicker: boolean;
+    timeFormat: '12h' | '24h';
+    minuteStep: number;
+    defaultStartTime: string;
+    defaultEndTime: string;
     dateRangeChange: EventEmitter<DateRange>;
     dateRangeSelected: EventEmitter<DateRange>;
     multiDateRangeChange: EventEmitter<MultiDateRange>;
@@ -65,6 +72,12 @@ export declare class DualDatepickerComponent implements OnInit, OnChanges, Contr
     pendingStartDate: string;
     pendingEndDate: string;
     hasPendingChanges: import("@angular/core").WritableSignal<boolean>;
+    startHour: number;
+    startMinute: number;
+    endHour: number;
+    endMinute: number;
+    showStartTimePicker: import("@angular/core").WritableSignal<boolean>;
+    showEndTimePicker: import("@angular/core").WritableSignal<boolean>;
     hoverDate: import("@angular/core").WritableSignal<string>;
     selectedRanges: import("@angular/core").WritableSignal<DateRange[]>;
     currentRangeIndex: import("@angular/core").WritableSignal<number>;
@@ -123,10 +136,25 @@ export declare class DualDatepickerComponent implements OnInit, OnChanges, Contr
     private emitMultiChange;
     private emitMultiSelection;
     private getDateRangeValue;
+    toggleStartTimePicker(): void;
+    toggleEndTimePicker(): void;
+    incrementStartHour(): void;
+    decrementStartHour(): void;
+    incrementStartMinute(): void;
+    decrementStartMinute(): void;
+    incrementEndHour(): void;
+    decrementEndHour(): void;
+    incrementEndMinute(): void;
+    decrementEndMinute(): void;
+    formatTime(hour: number, minute: number): string;
+    parseTime(timeString: string): {
+        hour: number;
+        minute: number;
+    };
     writeValue(value: DateRange | null): void;
     registerOnChange(fn: (value: DateRange | null) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DualDatepickerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DualDatepickerComponent, "ngx-dual-datepicker", never, { "placeholder": { "alias": "placeholder"; "required": false; }; "startDate": { "alias": "startDate"; "required": false; }; "endDate": { "alias": "endDate"; "required": false; }; "showPresets": { "alias": "showPresets"; "required": false; }; "showClearButton": { "alias": "showClearButton"; "required": false; }; "multiRange": { "alias": "multiRange"; "required": false; }; "closeOnSelection": { "alias": "closeOnSelection"; "required": false; }; "closeOnPresetSelection": { "alias": "closeOnPresetSelection"; "required": false; }; "closeOnClickOutside": { "alias": "closeOnClickOutside"; "required": false; }; "enableKeyboardNavigation": { "alias": "enableKeyboardNavigation"; "required": false; }; "presets": { "alias": "presets"; "required": false; }; "theme": { "alias": "theme"; "required": false; }; "inputBackgroundColor": { "alias": "inputBackgroundColor"; "required": false; }; "inputTextColor": { "alias": "inputTextColor"; "required": false; }; "inputBorderColor": { "alias": "inputBorderColor"; "required": false; }; "inputBorderColorHover": { "alias": "inputBorderColorHover"; "required": false; }; "inputBorderColorFocus": { "alias": "inputBorderColorFocus"; "required": false; }; "inputPadding": { "alias": "inputPadding"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "disabledDates": { "alias": "disabledDates"; "required": false; }; "displayFormat": { "alias": "displayFormat"; "required": false; }; "requireApply": { "alias": "requireApply"; "required": false; }; }, { "dateRangeChange": "dateRangeChange"; "dateRangeSelected": "dateRangeSelected"; "multiDateRangeChange": "multiDateRangeChange"; "multiDateRangeSelected": "multiDateRangeSelected"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DualDatepickerComponent, "ngx-dual-datepicker", never, { "placeholder": { "alias": "placeholder"; "required": false; }; "startDate": { "alias": "startDate"; "required": false; }; "endDate": { "alias": "endDate"; "required": false; }; "showPresets": { "alias": "showPresets"; "required": false; }; "showClearButton": { "alias": "showClearButton"; "required": false; }; "multiRange": { "alias": "multiRange"; "required": false; }; "closeOnSelection": { "alias": "closeOnSelection"; "required": false; }; "closeOnPresetSelection": { "alias": "closeOnPresetSelection"; "required": false; }; "closeOnClickOutside": { "alias": "closeOnClickOutside"; "required": false; }; "enableKeyboardNavigation": { "alias": "enableKeyboardNavigation"; "required": false; }; "presets": { "alias": "presets"; "required": false; }; "theme": { "alias": "theme"; "required": false; }; "inputBackgroundColor": { "alias": "inputBackgroundColor"; "required": false; }; "inputTextColor": { "alias": "inputTextColor"; "required": false; }; "inputBorderColor": { "alias": "inputBorderColor"; "required": false; }; "inputBorderColorHover": { "alias": "inputBorderColorHover"; "required": false; }; "inputBorderColorFocus": { "alias": "inputBorderColorFocus"; "required": false; }; "inputPadding": { "alias": "inputPadding"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "disabledDates": { "alias": "disabledDates"; "required": false; }; "displayFormat": { "alias": "displayFormat"; "required": false; }; "requireApply": { "alias": "requireApply"; "required": false; }; "enableTimePicker": { "alias": "enableTimePicker"; "required": false; }; "timeFormat": { "alias": "timeFormat"; "required": false; }; "minuteStep": { "alias": "minuteStep"; "required": false; }; "defaultStartTime": { "alias": "defaultStartTime"; "required": false; }; "defaultEndTime": { "alias": "defaultEndTime"; "required": false; }; }, { "dateRangeChange": "dateRangeChange"; "dateRangeSelected": "dateRangeSelected"; "multiDateRangeChange": "multiDateRangeChange"; "multiDateRangeSelected": "multiDateRangeSelected"; }, never, never, true, never>;
 }