@oneluiz/dual-datepicker 3.9.3 → 4.0.1

package/core/date-clock.d.ts

@@ -1,82 +0,0 @@
-/**
- * Date Clock Abstraction for SSR-Safe Date Resolution
- *
- * Problem:
- * Presets like "Last 7 Days" or "This Month" use new Date() which causes:
- * - SSR hydration mismatch
- * - Server renders "2026-02-14", client renders "2026-02-15"
- * - Different filters in dashboards
- * - Different queries in ERP/BI
- * - Cache inconsistency
- *
- * Solution:
- * Inject a DateClock to control time deterministically:
- *
- * Server (SSR):
- * provide(DATE_CLOCK, {
- *   useValue: { now: () => new Date('2026-02-21T00:00:00Z') }
- * })
- *
- * Client (Browser):
- * Uses SystemClock by default (new Date())
- *
- * Testing:
- * provide(DATE_CLOCK, {
- *   useValue: { now: () => new Date('2026-01-15T10:30:00Z') }
- * })
- *
- * Architecture:
- * - PresetEngine receives DateClock via DI
- * - All preset calculations use clock.now() instead of new Date()
- * - Deterministic: Same clock.now() → Same preset result
- * - SSR-compatible: Server and client resolve identical ranges
- */
-import { InjectionToken } from '@angular/core';
-/**
- * Clock abstraction for deterministic date resolution
- *
- * Use cases:
- * - SSR: Ensure server and client generate identical presets
- * - Testing: Control time for predictable test results
- * - Replay: Reproduce exact user state from past sessions
- * - Demo: Freeze time for reproducible demos
- */
-export interface DateClock {
-    /**
-     * Get current date/time
-     *
-     * Default implementation returns new Date()
-     * Override for SSR, testing, or time-travel scenarios
-     */
-    now(): Date;
-}
-/**
- * Injection token for DateClock
- *
- * Usage:
- * ```typescript
- * // Default (uses SystemClock)
- * bootstrapApplication(AppComponent);
- *
- * // SSR Override
- * bootstrapApplication(AppComponent, {
- *   providers: [
- *     {
- *       provide: DATE_CLOCK,
- *       useValue: { now: () => new Date('2026-02-21T00:00:00Z') }
- *     }
- *   ]
- * });
- *
- * // Testing Override
- * TestBed.configureTestingModule({
- *   providers: [
- *     {
- *       provide: DATE_CLOCK,
- *       useValue: { now: () => new Date('2026-01-15T12:00:00Z') }
- *     }
- *   ]
- * });
- * ```
- */
-export declare const DATE_CLOCK: InjectionToken<DateClock>;

package/core/dual-date-range.store.d.ts

@@ -1,113 +0,0 @@
-import * as i0 from "@angular/core";
-export interface DateRangeState {
-    start: string;
-    end: string;
-    startTime?: string;
-    endTime?: string;
-}
-export interface DateRangeConfig {
-    minDate?: Date;
-    maxDate?: Date;
-    disabledDates?: Date[] | ((date: Date) => boolean);
-    enableTimePicker?: boolean;
-    defaultStartTime?: string;
-    defaultEndTime?: string;
-}
-export declare class DualDateRangeStore {
-    private presetEngine;
-    private clock;
-    private adapter;
-    constructor();
-    private config;
-    private _startDate;
-    private _endDate;
-    private _leftMonth;
-    private _rightMonth;
-    private _selectingStart;
-    private _startTime;
-    private _endTime;
-    private _pendingStart;
-    private _pendingEnd;
-    private _hasPendingChanges;
-    readonly startDate: import("@angular/core").Signal<Date>;
-    readonly endDate: import("@angular/core").Signal<Date>;
-    readonly leftMonth: import("@angular/core").Signal<Date>;
-    readonly rightMonth: import("@angular/core").Signal<Date>;
-    readonly selectingStart: import("@angular/core").Signal<boolean>;
-    readonly startTime: import("@angular/core").Signal<string>;
-    readonly endTime: import("@angular/core").Signal<string>;
-    readonly hasPendingChanges: import("@angular/core").Signal<boolean>;
-    readonly range: import("@angular/core").Signal<DateRangeState>;
-    readonly isValid: import("@angular/core").Signal<boolean>;
-    readonly rangeText: import("@angular/core").Signal<string>;
-    /**
-     * Configure the store
-     */
-    configure(config: Partial<DateRangeConfig>): void;
-    /**
-     * Set start date (with validation)
-     */
-    setStart(date: Date | string | null): void;
-    /**
-     * Set end date (with validation)
-     */
-    setEnd(date: Date | string | null): void;
-    /**
-     * Set complete range at once
-     */
-    setRange(start: Date | string | null, end: Date | string | null): void;
-    /**
-     * Set pending selection (for requireApply mode)
-     */
-    setPendingStart(date: Date | string | null): void;
-    setPendingEnd(date: Date | string | null): void;
-    /**
-     * Apply pending changes
-     */
-    applyPending(): void;
-    /**
-     * Cancel pending changes
-     */
-    cancelPending(): void;
-    private clearPending;
-    /**
-     * Reset to empty state
-     */
-    reset(): void;
-    /**
-     * Apply a preset by key
-     *
-     * SSR-Safe: Uses injected DateClock for deterministic resolution
-     *
-     * @param presetKey - Preset identifier (e.g., 'TODAY', 'LAST_7_DAYS')
-     * @param now - Optional date override (defaults to clock.now())
-     */
-    applyPreset(presetKey: string, now?: Date): void;
-    /**
-     * Navigate left calendar month
-     */
-    setLeftMonth(date: Date): void;
-    /**
-     * Navigate right calendar month
-     */
-    setRightMonth(date: Date): void;
-    /**
-     * Set time values
-     */
-    setStartTime(time: string): void;
-    setEndTime(time: string): void;
-    /**
-     * Get current state as snapshot
-     */
-    getSnapshot(): DateRangeState;
-    /**
-     * Load state from snapshot
-     */
-    loadSnapshot(snapshot: DateRangeState): void;
-    private parseDate;
-    private getNextMonth;
-    private getPreviousMonth;
-    private formatDateShort;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DualDateRangeStore, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<DualDateRangeStore>;
-}

package/core/index.d.ts

@@ -1,33 +0,0 @@
-/**
- * Core headless date range logic
- *
- * v3.6.0: Plugin Architecture
- * - RangePresetPlugin interface for extensible presets
- * - PresetRegistry for plugin management
- * - Built-in presets as plugins
- * - Provider functions for custom presets
- *
- * v3.7.0: Calendar Grid Cache
- * - CalendarGridFactory for deterministic grid generation
- * - CalendarGridCache with LRU memoization
- * - Separates grid structure from decorations for performance
- *
- * v3.8.0: Range Highlight Cache
- * - RangeHighlighter for decoration logic (pure computation)
- * - RangeHighlighterCache with LRU (48 grids)
- * - Eliminates redundant decoration recomputations
- *
- * Import from here for clean barrel exports
- */
-export * from './dual-date-range.store';
-export * from './preset.engine';
-export * from './range.validator';
-export * from './date-clock';
-export * from './system-clock';
-export * from './date-adapter';
-export * from './native-date-adapter';
-export * from './range-preset.plugin';
-export * from './preset-registry';
-export * from './built-in-presets';
-export * from './preset-providers';
-export * from './calendar-grid';

package/core/native-date-adapter.d.ts

@@ -1,152 +0,0 @@
-import { DateAdapter } from './date-adapter';
-import * as i0 from "@angular/core";
-export declare class NativeDateAdapter implements DateAdapter {
-    /**
-     * Normalize date to start of day (00:00:00.000) in local timezone
-     *
-     * This is the foundation of timezone-safe operations.
-     * All other methods use normalized dates for comparisons.
-     */
-    normalize(date: Date): Date;
-    /**
-     * Check if two dates are the same calendar day
-     *
-     * Implementation: Compare YYYY-MM-DD components directly
-     * Avoids timezone issues from valueOf() comparisons
-     */
-    isSameDay(a: Date, b: Date): boolean;
-    /**
-     * Check if date A is before date B (calendar day level)
-     *
-     * Implementation: Compare normalized dates using valueOf()
-     */
-    isBeforeDay(a: Date, b: Date): boolean;
-    /**
-     * Check if date A is after date B (calendar day level)
-     *
-     * Implementation: Compare normalized dates using valueOf()
-     */
-    isAfterDay(a: Date, b: Date): boolean;
-    /**
-     * Add days to a date
-     *
-     * Implementation: Use setDate() which handles month rollover automatically
-     *
-     * Example:
-     * Jan 31 + 3 days → Feb 3 ✅
-     * Feb 28 + 1 day → Mar 1 ✅ (non-leap year)
-     */
-    addDays(date: Date, days: number): Date;
-    /**
-     * Add months to a date
-     *
-     * CRITICAL: Handles month overflow correctly
-     *
-     * Algorithm:
-     * 1. Add months using setMonth()
-     * 2. If day-of-month changed (overflow), set to last day of target month
-     *
-     * Examples:
-     * - Jan 31 + 1 month → Feb 28 (or Feb 29 in leap year) ✅
-     * - Jan 31 + 2 months → Mar 31 ✅
-     * - Mar 31 + 1 month → Apr 30 ✅
-     * - Dec 31 + 1 month → Jan 31 (next year) ✅
-     */
-    addMonths(date: Date, months: number): Date;
-    /**
-     * Get start of day (00:00:00.000)
-     *
-     * Alias for normalize() with explicit intent
-     */
-    startOfDay(date: Date): Date;
-    /**
-     * Get end of day (23:59:59.999)
-     *
-     * Useful for inclusive range queries
-     */
-    endOfDay(date: Date): Date;
-    /**
-     * Get first day of month (00:00:00.000)
-     */
-    startOfMonth(date: Date): Date;
-    /**
-     * Get last day of month (23:59:59.999)
-     *
-     * Algorithm: Go to 1st of next month, subtract 1 day
-     */
-    endOfMonth(date: Date): Date;
-    /**
-     * Get year (4-digit)
-     */
-    getYear(date: Date): number;
-    /**
-     * Get month (0-11)
-     */
-    getMonth(date: Date): number;
-    /**
-     * Get day of month (1-31)
-     */
-    getDate(date: Date): number;
-    /**
-     * Get day of week (0-6, Sunday=0)
-     */
-    getDay(date: Date): number;
-    /**
-     * Convert Date to ISO date string (YYYY-MM-DD)
-     *
-     * CRITICAL: DO NOT use toISOString() - it converts to UTC!
-     *
-     * Manual construction ensures local timezone is preserved:
-     *
-     * Example problem with toISOString():
-     * ```
-     * // Local timezone: GMT-6 (CST)
-     * const date = new Date('2026-02-21T23:00:00'); // 11 PM Feb 21 local
-     *
-     * // WRONG ❌
-     * date.toISOString().split('T')[0]
-     * // Returns "2026-02-22" (converted to UTC = Feb 22 05:00 AM)
-     *
-     * // CORRECT ✅
-     * toISODate(date)
-     * // Returns "2026-02-21" (local date preserved)
-     * ```
-     *
-     * Implementation: Build YYYY-MM-DD manually from local date components
-     */
-    toISODate(date: Date): string;
-    /**
-     * Parse ISO date string (YYYY-MM-DD) to Date
-     *
-     * CRITICAL: DO NOT use new Date(isoString) - may parse as UTC!
-     *
-     * Example problem with Date constructor:
-     * ```
-     * // Local timezone: GMT-6 (CST)
-     *
-     * // WRONG ❌
-     * new Date('2026-02-21')
-     * // Parsed as UTC: 2026-02-21T00:00:00Z
-     * // In local timezone: Feb 20, 2026 6:00 PM (previous day!)
-     *
-     * // CORRECT ✅
-     * parseISODate('2026-02-21')
-     * // Returns: 2026-02-21T00:00:00 local time
-     * ```
-     *
-     * Implementation: Parse components and construct Date in local timezone
-     */
-    parseISODate(isoDate: string): Date | null;
-    /**
-     * Get week start day for locale
-     *
-     * Default: Sunday (0) for most locales
-     * Monday (1) for Europe, ISO 8601
-     *
-     * Implementation: Simple locale detection
-     * For advanced needs, use Intl.Locale or external library
-     */
-    getWeekStart(locale?: string): 0 | 1 | 2 | 3 | 4 | 5 | 6;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateAdapter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<NativeDateAdapter>;
-}

package/core/preset-providers.d.ts

@@ -1,176 +0,0 @@
-/**
- * Provider Functions for Built-in Presets
- *
- * Version: 3.6.0
- *
- * Automatic registration of built-in date range presets.
- * These providers ensure backward compatibility by auto-registering
- * all standard presets (TODAY, LAST_7_DAYS, THIS_MONTH, etc.)
- *
- * USAGE IN LIBRARY (Internal):
- * Built-in presets are registered automatically via Angular providers.
- * Library consumers don't need to do anything.
- *
- * USAGE IN APP (Custom Presets):
- * ```typescript
- * // app.config.ts
- * export const appConfig: ApplicationConfig = {
- *   providers: [
- *     // ... other providers
- *     provideCustomPresets([
- *       {
- *         key: 'THIS_FISCAL_QUARTER',
- *         resolve: (clock, adapter) => {
- *           const now = clock.now();
- *           // ... fiscal logic
- *           return { start, end };
- *         }
- *       }
- *     ])
- *   ]
- * };
- * ```
- */
-import { EnvironmentProviders } from '@angular/core';
-import { RangePresetPlugin } from './range-preset.plugin';
-/**
- * Provide built-in date range presets
- *
- * This provider is automatically included in the library's root providers.
- * Library consumers don't need to add this manually.
- *
- * @returns EnvironmentProviders for built-in presets
- *
- * @internal
- */
-export declare function provideBuiltInPresets(): EnvironmentProviders;
-/**
- * Provide custom date range presets
- *
- * Use this to register your own industry-specific presets:
- * - Fiscal presets
- * - Hotel/hospitality presets
- * - Logistics presets
- * - Custom business logic
- *
- * @param presets - Array of custom RangePresetPlugin implementations
- * @returns EnvironmentProviders for custom presets
- *
- * @example
- * ```typescript
- * // Fiscal presets
- * const FISCAL_PRESETS: RangePresetPlugin[] = [
- *   {
- *     key: 'THIS_FISCAL_QUARTER',
- *     resolve: (clock, adapter) => {
- *       const now = clock.now();
- *       const month = adapter.getMonth(now);
- *
- *       // Fiscal year starts April (month 3)
- *       const fiscalMonth = (month + 9) % 12;
- *       const quarterStart = Math.floor(fiscalMonth / 3) * 3;
- *       const calendarMonth = (quarterStart - 9 + 12) % 12;
- *
- *       const year = adapter.getYear(now);
- *       const fiscalYear = month < 3 ? year - 1 : year;
- *
- *       const start = new Date(fiscalYear, calendarMonth, 1);
- *       const end = new Date(fiscalYear, calendarMonth + 3, 0);
- *
- *       return {
- *         start: adapter.normalize(start),
- *         end: adapter.normalize(end)
- *       };
- *     }
- *   },
- *   {
- *     key: 'FISCAL_YEAR_TO_DATE',
- *     resolve: (clock, adapter) => {
- *       const now = clock.now();
- *       const month = adapter.getMonth(now);
- *       const year = adapter.getYear(now);
- *
- *       // Fiscal year starts April 1
- *       const fiscalYearStart = month >= 3
- *         ? new Date(year, 3, 1)
- *         : new Date(year - 1, 3, 1);
- *
- *       return {
- *         start: adapter.normalize(fiscalYearStart),
- *         end: adapter.normalize(now)
- *       };
- *     }
- *   }
- * ];
- *
- * // In app.config.ts
- * export const appConfig: ApplicationConfig = {
- *   providers: [
- *     provideCustomPresets(FISCAL_PRESETS)
- *   ]
- * };
- *
- * // Use in components
- * store.applyPreset('THIS_FISCAL_QUARTER');
- * store.applyPreset('FISCAL_YEAR_TO_DATE');
- * ```
- *
- * @example
- * ```typescript
- * // Hotel presets
- * const HOTEL_PRESETS: RangePresetPlugin[] = [
- *   {
- *     key: 'CHECK_IN_WEEK',
- *     resolve: (clock, adapter) => {
- *       const now = clock.now();
- *       const dayOfWeek = adapter.getDayOfWeek(now);
- *
- *       // Check-in week: Friday to Friday
- *       const daysToNextFriday = dayOfWeek <= 5
- *         ? 5 - dayOfWeek
- *         : 7 - dayOfWeek + 5;
- *
- *       const nextFriday = adapter.addDays(now, daysToNextFriday);
- *       const followingFriday = adapter.addDays(nextFriday, 7);
- *
- *       return { start: nextFriday, end: followingFriday };
- *     }
- *   },
- *   {
- *     key: 'NEXT_30_NIGHTS',
- *     resolve: (clock, adapter) => {
- *       const now = clock.now();
- *       const tomorrow = adapter.addDays(now, 1);
- *       const end = adapter.addDays(tomorrow, 30);
- *       return { start: tomorrow, end };
- *     }
- *   }
- * ];
- *
- * providers: [provideCustomPresets(HOTEL_PRESETS)]
- * ```
- */
-export declare function provideCustomPresets(presets: RangePresetPlugin[]): EnvironmentProviders;
-/**
- * Provide preset package
- *
- * Convenience function for external preset packages.
- *
- * @param packageName - Name of the preset package (for logging)
- * @param presets - Array of presets from the package
- * @returns EnvironmentProviders
- *
- * @example
- * ```typescript
- * // @acme/fiscal-presets package
- * export function provideFiscalPresets(): EnvironmentProviders {
- *   return providePresetPackage('@acme/fiscal-presets', FISCAL_PRESETS);
- * }
- *
- * // In app
- * import { provideFiscalPresets } from '@acme/fiscal-presets';
- *
- * providers: [provideFiscalPresets()]
- * ```
- */
-export declare function providePresetPackage(packageName: string, presets: RangePresetPlugin[]): EnvironmentProviders;