@oneluiz/dual-datepicker 3.9.2 → 4.0.0

package/fesm2022/oneluiz-dual-datepicker.mjs

@@ -1,134 +1,9 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, Injectable, inject, signal, computed, Inject, EventEmitter, effect, APP_INITIALIZER, forwardRef, HostListener, Output, Input, Component, makeEnvironmentProviders } from '@angular/core';
+import { InjectionToken, Injectable, inject, signal, computed, makeEnvironmentProviders, APP_INITIALIZER, Inject, EventEmitter, effect, forwardRef, HostListener, Output, Input, Component } from '@angular/core';
 import * as i1 from '@angular/common';
 import { CommonModule } from '@angular/common';
 import { FormsModule, ReactiveFormsModule, NG_VALUE_ACCESSOR } from '@angular/forms';
 
-/**
- * Abstract class for date adapters.
- * Allows the component to work with different date libraries (Date, DayJS, date-fns, Luxon, etc.)
- */
-class DateAdapter {
-}
-/**
- * Injection token for DateAdapter
- */
-const DATE_ADAPTER$1 = new InjectionToken('DATE_ADAPTER');
-
-/**
- * Date adapter implementation for native JavaScript Date objects
- * This is the default adapter used by the component
- */
-let NativeDateAdapter$1 = class NativeDateAdapter extends DateAdapter {
-    parse(value) {
-        if (!value)
-            return null;
-        if (value instanceof Date) {
-            return new Date(value);
-        }
-        if (typeof value === 'string' || typeof value === 'number') {
-            // Fix timezone issues: parse YYYY-MM-DD as local date, not UTC
-            if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(value)) {
-                const [year, month, day] = value.split('-').map(Number);
-                return new Date(year, month - 1, day);
-            }
-            const date = new Date(value);
-            return this.isValid(date) ? date : null;
-        }
-        return null;
-    }
-    format(date, format = 'YYYY-MM-DD') {
-        if (!this.isValid(date))
-            return '';
-        const year = date.getFullYear();
-        const month = String(date.getMonth() + 1).padStart(2, '0');
-        const day = String(date.getDate()).padStart(2, '0');
-        // Simple format implementation
-        switch (format) {
-            case 'YYYY-MM-DD':
-                return `${year}-${month}-${day}`;
-            case 'MM/DD/YYYY':
-                return `${month}/${day}/${year}`;
-            case 'DD/MM/YYYY':
-                return `${day}/${month}/${year}`;
-            default:
-                return `${year}-${month}-${day}`;
-        }
-    }
-    addDays(date, days) {
-        const result = this.clone(date);
-        result.setDate(result.getDate() + days);
-        return result;
-    }
-    addMonths(date, months) {
-        const result = this.clone(date);
-        result.setMonth(result.getMonth() + months);
-        return result;
-    }
-    getYear(date) {
-        return date.getFullYear();
-    }
-    getMonth(date) {
-        return date.getMonth();
-    }
-    getDate(date) {
-        return date.getDate();
-    }
-    getDay(date) {
-        return date.getDay();
-    }
-    createDate(year, month, date) {
-        return new Date(year, month, date);
-    }
-    today() {
-        return new Date();
-    }
-    isSameDay(a, b) {
-        if (!a || !b)
-            return false;
-        if (!this.isValid(a) || !this.isValid(b))
-            return false;
-        return (a.getFullYear() === b.getFullYear() &&
-            a.getMonth() === b.getMonth() &&
-            a.getDate() === b.getDate());
-    }
-    isBefore(a, b) {
-        if (!a || !b)
-            return false;
-        if (!this.isValid(a) || !this.isValid(b))
-            return false;
-        return a.getTime() < b.getTime();
-    }
-    isAfter(a, b) {
-        if (!a || !b)
-            return false;
-        if (!this.isValid(a) || !this.isValid(b))
-            return false;
-        return a.getTime() > b.getTime();
-    }
-    isBetween(date, start, end) {
-        if (!date || !start || !end)
-            return false;
-        if (!this.isValid(date) || !this.isValid(start) || !this.isValid(end))
-            return false;
-        const dateTime = date.getTime();
-        const startTime = start.getTime();
-        const endTime = end.getTime();
-        return dateTime >= startTime && dateTime <= endTime;
-    }
-    clone(date) {
-        return new Date(date.getTime());
-    }
-    isValid(date) {
-        return date instanceof Date && !isNaN(date.getTime());
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: NativeDateAdapter, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: NativeDateAdapter });
-};
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: NativeDateAdapter$1, decorators: [{
-            type: Injectable
-        }] });
-
 /**
  * Pure validation functions for date ranges
  * No dependencies, no side effects - just logic
@@ -1817,281 +1692,528 @@ const BUILT_IN_PRESETS = [
 ];
 
 /**
- * Calendar Grid Types
+ * 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.)
  *
- * Defines the structure for memoized calendar month grids.
- * Separates base grid structure (cacheable) from decorations (dynamic).
+ * 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 };
+ *         }
+ *       }
+ *     ])
+ *   ]
+ * };
+ * ```
  */
-
 /**
- * Calendar Grid Factory
+ * Initializer function that registers built-in presets
  *
- * Generates calendar month grids using DateAdapter for deterministic,
- * timezone-safe date operations.
+ * Runs at application startup (APP_INITIALIZER)
  *
- * Grid structure:
- * - Always 6 weeks x 7 days (42 cells) for layout stability
- * - Includes padding days from previous/next month
- * - No decorations (selected, disabled, etc.) - those are applied separately
+ * @param registry - PresetRegistry instance
+ * @returns Initialization function
  */
-class CalendarGridFactory {
-    adapter;
-    constructor(adapter) {
-        this.adapter = adapter;
-    }
-    /**
-     * Create a calendar grid for a given month
-     *
-     * @param monthDate - Any date within the target month (will be normalized to start of month)
-     * @param weekStart - First day of week (0 = Sunday, 1 = Monday, etc.)
-     * @param locale - Locale identifier (optional, for future use)
-     * @returns CalendarGrid - 6 weeks x 7 days grid
-     */
-    createGrid(monthDate, weekStart = 0, locale) {
-        // Normalize to start of month
-        const year = this.adapter.getYear(monthDate);
-        const month = this.adapter.getMonth(monthDate);
-        const firstDayOfMonth = new Date(year, month, 1);
-        const normalizedFirst = this.adapter.normalize(firstDayOfMonth);
-        // Get days in month (day 0 of next month = last day of current month)
-        const lastDayOfMonth = new Date(year, month + 1, 0);
-        const daysInMonth = this.adapter.getDate(lastDayOfMonth);
-        // Get first day of week offset
-        const firstDayOfWeek = this.adapter.getDay(normalizedFirst);
-        const offset = this.calculateOffset(firstDayOfWeek, weekStart);
-        // Generate 42 cells (6 weeks x 7 days)
-        const cells = [];
-        let currentDate = this.adapter.addDays(normalizedFirst, -offset);
-        for (let i = 0; i < 42; i++) {
-            const cellDate = this.adapter.normalize(currentDate);
-            const cellYear = this.adapter.getYear(cellDate);
-            const cellMonth = this.adapter.getMonth(cellDate);
-            const cellDay = this.adapter.getDate(cellDate);
-            const cellDayOfWeek = this.adapter.getDay(cellDate);
-            cells.push({
-                date: cellDate,
-                inCurrentMonth: cellYear === year && cellMonth === month,
-                iso: this.adapter.toISODate(cellDate),
-                day: cellDay,
-                month: cellMonth,
-                year: cellYear,
-                dayOfWeek: cellDayOfWeek
-            });
-            currentDate = this.adapter.addDays(currentDate, 1);
-        }
-        // Split into weeks
-        const weeks = [];
-        for (let i = 0; i < 6; i++) {
-            weeks.push(cells.slice(i * 7, (i + 1) * 7));
-        }
-        return {
-            month: { year, month },
-            weekStart,
-            locale,
-            weeks,
-            cells
-        };
-    }
-    /**
-     * Calculate offset (number of padding days from previous month)
-     *
-     * @param firstDayOfWeek - Day of week for first day of month (0-6)
-     * @param weekStart - Desired week start (0-6)
-     * @returns Number of padding days needed
-     */
-    calculateOffset(firstDayOfWeek, weekStart) {
-        let offset = firstDayOfWeek - weekStart;
-        if (offset < 0) {
-            offset += 7;
+function initializeBuiltInPresets(registry) {
+    return () => {
+        // Register all built-in presets
+        BUILT_IN_PRESETS.forEach(preset => {
+            registry.register(preset);
+        });
+        // Log registration for debugging (can be removed in production)
+        if (typeof console !== 'undefined' && console.debug) {
+            console.debug(`[ng-dual-datepicker] Registered ${BUILT_IN_PRESETS.length} built-in presets:`, BUILT_IN_PRESETS.map(p => p.key).join(', '));
         }
-        return offset;
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridFactory, deps: [{ token: DATE_ADAPTER }], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridFactory, providedIn: 'root' });
+    };
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridFactory, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }], ctorParameters: () => [{ type: undefined, decorators: [{
-                    type: Inject,
-                    args: [DATE_ADAPTER]
-                }] }] });
-
 /**
- * Cache Configuration
+ * Provide built-in date range presets
  *
- * Centralized cache limits for memory safety.
+ * This provider is automatically included in the library's root providers.
+ * Library consumers don't need to add this manually.
  *
- * @module core/calendar-grid/cache.config
- * @version 3.9.2
+ * @returns EnvironmentProviders for built-in presets
+ *
+ * @internal
  */
+function provideBuiltInPresets() {
+    return makeEnvironmentProviders([
+        {
+            provide: APP_INITIALIZER,
+            multi: true,
+            useFactory: initializeBuiltInPresets,
+            deps: [PresetRegistry]
+        }
+    ]);
+}
 /**
- * Maximum cache entries before FIFO eviction
+ * Provide custom date range presets
  *
- * Applied to both:
- * - CalendarGridCache: Raw month grids
- * - RangeHighlighterCache: Decorated grids
+ * Use this to register your own industry-specific presets:
+ * - Fiscal presets
+ * - Hotel/hospitality presets
+ * - Logistics presets
+ * - Custom business logic
  *
- * Memory footprint:
- * - CalendarGrid (raw): ~10KB each
- * - DecoratedGrid: ~15KB each
- * - Total worst case: (10KB + 15KB) × 48 = ~1.2MB
+ * @param presets - Array of custom RangePresetPlugin implementations
+ * @returns EnvironmentProviders for custom presets
  *
- * Coverage:
- * - 48 months = 4 years of navigation
- * - Sufficient for long-running sessions
+ * @example
+ * ```typescript
+ * // Fiscal presets
+ * const FISCAL_PRESETS: RangePresetPlugin[] = [
+ *   {
+ *     key: 'THIS_FISCAL_QUARTER',
+ *     resolve: (clock, adapter) => {
+ *       const now = clock.now();
+ *       const month = adapter.getMonth(now);
  *
- * Critical for:
- * - ERP systems (invoice date selection)
- * - BI dashboards (date range filters)
- * - Hotel reservation systems (availability calendars)
- * - Point-of-sale systems (report generation)
+ *       // Fiscal year starts April (month 3)
+ *       const fiscalMonth = (month + 9) % 12;
+ *       const quarterStart = Math.floor(fiscalMonth / 3) * 3;
+ *       const calendarMonth = (quarterStart - 9 + 12) % 12;
  *
- * @constant
- * @since v3.9.2
+ *       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)]
+ * ```
  */
-const MAX_CACHE_ENTRIES = 48;
-
+function provideCustomPresets(presets) {
+    return makeEnvironmentProviders([
+        {
+            provide: APP_INITIALIZER,
+            multi: true,
+            useFactory: (registry) => {
+                return () => {
+                    presets.forEach(preset => {
+                        registry.register(preset);
+                    });
+                    if (typeof console !== 'undefined' && console.debug) {
+                        console.debug(`[ng-dual-datepicker] Registered ${presets.length} custom presets:`, presets.map(p => p.key).join(', '));
+                    }
+                };
+            },
+            deps: [PresetRegistry]
+        }
+    ]);
+}
 /**
- * Calendar Grid Cache
+ * Provide preset package
  *
- * LRU cache for calendar month grids to avoid recomputing the same month grid
- * multiple times when only decorations (selected dates, hover, etc.) change.
+ * Convenience function for external preset packages.
  *
- * Strategy:
- * - Key: year-month-weekStart-locale
- * - LRU eviction (least recently used) when limit is reached
- * - Default limit: 48 months (covers 2 years of navigation)
+ * @param packageName - Name of the preset package (for logging)
+ * @param presets - Array of presets from the package
+ * @returns EnvironmentProviders
  *
- * Performance impact:
- * - Eliminates ~90% of grid recalculations in typical usage
- * - Memory footprint: ~10KB per cached month (negligible)
+ * @example
+ * ```typescript
+ * // @acme/fiscal-presets package
+ * export function provideFiscalPresets(): EnvironmentProviders {
+ *   return providePresetPackage('@acme/fiscal-presets', FISCAL_PRESETS);
+ * }
  *
- * Memory safety (v3.9.2):
- * - MAX_CACHE_ENTRIES prevents unbounded growth in long-running sessions
- * - Critical for: ERP, BI dashboards, hotel reservation systems
- * - FIFO eviction when limit exceeded
+ * // In app
+ * import { provideFiscalPresets } from '@acme/fiscal-presets';
+ *
+ * providers: [provideFiscalPresets()]
+ * ```
  */
-class CalendarGridCache {
-    factory;
-    cache = new Map();
-    maxSize = MAX_CACHE_ENTRIES;
-    constructor(factory) {
-        this.factory = factory;
-    }
-    /**
-     * Get or create a calendar grid
-     *
-     * @param monthDate - Any date within the target month
-     * @param weekStart - First day of week (0 = Sunday, 1 = Monday, etc.)
-     * @param locale - Locale identifier (optional)
-     * @returns CalendarGrid - cached or newly created
-     */
-    get(monthDate, weekStart = 0, locale) {
-        const key = this.buildKey(monthDate, weekStart, locale);
-        // Check cache
-        const cached = this.cache.get(key);
-        if (cached) {
-            // Move to end (LRU)
-            this.cache.delete(key);
-            this.cache.set(key, cached);
-            return cached;
-        }
-        // Generate new grid
-        const grid = this.factory.createGrid(monthDate, weekStart, locale);
-        // Store in cache
-        this.cache.set(key, grid);
-        // Evict oldest if over limit (LRU)
-        if (this.cache.size > this.maxSize) {
-            const firstKey = this.cache.keys().next().value;
-            this.cache.delete(firstKey);
+function providePresetPackage(packageName, presets) {
+    return makeEnvironmentProviders([
+        {
+            provide: APP_INITIALIZER,
+            multi: true,
+            useFactory: (registry) => {
+                return () => {
+                    presets.forEach(preset => {
+                        registry.register(preset);
+                    });
+                    if (typeof console !== 'undefined' && console.debug) {
+                        console.debug(`[${packageName}] Registered ${presets.length} presets:`, presets.map(p => p.key).join(', '));
+                    }
+                };
+            },
+            deps: [PresetRegistry]
         }
-        return grid;
-    }
-    /**
-     * Build cache key from month parameters
-     *
-     * Format: "year-month-weekStart-locale"
-     * Example: "2026-1-0-en" (Feb 2026, Sunday start, English)
-     */
-    buildKey(monthDate, weekStart, locale) {
-        const year = monthDate.getFullYear();
-        const month = monthDate.getMonth();
-        return `${year}-${month}-${weekStart}${locale ? '-' + locale : ''}`;
-    }
-    /**
-     * Clear entire cache (for testing or manual reset)
-     */
-    clear() {
-        this.cache.clear();
-    }
-    /**
-     * Get cache size (for debugging/testing)
-     */
-    size() {
-        return this.cache.size;
-    }
-    /**
-     * Check if a specific month is cached
-     */
-    has(monthDate, weekStart = 0, locale) {
-        const key = this.buildKey(monthDate, weekStart, locale);
-        return this.cache.has(key);
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridCache, deps: [{ token: CalendarGridFactory }], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridCache, providedIn: 'root' });
+    ]);
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridCache, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }], ctorParameters: () => [{ type: CalendarGridFactory }] });
 
 /**
- * Range Highlighter Types
+ * PUBLIC API for @oneluiz/dual-datepicker
  *
- * Type definitions for calendar cell decorations with range highlighting.
- * Used by RangeHighlighter to cache decorated grids and avoid recomputations.
+ * This file defines the stable public API contract.
+ * Exports from this barrel are guaranteed to follow semantic versioning.
  *
- * @module core/calendar-grid/range-highlighter.types
- * @version 3.8.0
+ * @public
+ * @packageDocumentation
+ * @module @oneluiz/dual-datepicker/core
+ * @since v4.0.0
  */
-
+// ============================================================================
+// HEADLESS STORE
+// ============================================================================
 /**
- * Range Highlighter Service
+ * DualDateRangeStore - Signal-based headless date range store
  *
- * Decorates calendar grids with range highlights, hover previews, and disabled states.
- * Pure computation layer - no caching (see RangeHighlighterCache for memoization).
+ * Core reactive store for managing date range state without UI dependencies.
+ * Perfect for SSR, global state, and custom UI implementations.
  *
- * @module core/calendar-grid/range-highlighter
- * @version 3.8.0
+ * @public
+ * @since v3.5.0
  */
+
 /**
- * Range Highlighter
- *
- * Applies decorations to calendar grids:
- * - isSelectedStart, isSelectedEnd (range boundaries)
- * - isInRange (cells within selected range)
- * - isInHoverRange (hover preview)
- * - isDisabled (constraints, custom predicates)
+ * Calendar Grid Factory
  *
- * Design:
- * - Pure functions (same input = same output)
- * - Uses DateAdapter for all date operations (SSR-safe)
- * - No side effects, no state
- * - Fast (~1ms for 42 cells on mobile)
+ * Generates calendar month grids using DateAdapter for deterministic,
+ * timezone-safe date operations.
  *
- * Usage:
- * ```typescript
- * const grid = calendarGridCache.get(monthDate, 0);
- * const decorated = rangeHighlighter.decorate(grid, {
- *   start: startDate,
- *   end: endDate,
- *   hoverDate: '2026-01-20',
- *   disabledDates: [...]
- * });
- * ```
+ * Grid structure:
+ * - Always 6 weeks x 7 days (42 cells) for layout stability
+ * - Includes padding days from previous/next month
+ * - No decorations (selected, disabled, etc.) - those are applied separately
  */
-class RangeHighlighter {
+class CalendarGridFactory {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    /**
+     * Create a calendar grid for a given month
+     *
+     * @param monthDate - Any date within the target month (will be normalized to start of month)
+     * @param weekStart - First day of week (0 = Sunday, 1 = Monday, etc.)
+     * @param locale - Locale identifier (optional, for future use)
+     * @returns CalendarGrid - 6 weeks x 7 days grid
+     */
+    createGrid(monthDate, weekStart = 0, locale) {
+        // Normalize to start of month
+        const year = this.adapter.getYear(monthDate);
+        const month = this.adapter.getMonth(monthDate);
+        const firstDayOfMonth = new Date(year, month, 1);
+        const normalizedFirst = this.adapter.normalize(firstDayOfMonth);
+        // Get days in month (day 0 of next month = last day of current month)
+        const lastDayOfMonth = new Date(year, month + 1, 0);
+        const daysInMonth = this.adapter.getDate(lastDayOfMonth);
+        // Get first day of week offset
+        const firstDayOfWeek = this.adapter.getDay(normalizedFirst);
+        const offset = this.calculateOffset(firstDayOfWeek, weekStart);
+        // Generate 42 cells (6 weeks x 7 days)
+        const cells = [];
+        let currentDate = this.adapter.addDays(normalizedFirst, -offset);
+        for (let i = 0; i < 42; i++) {
+            const cellDate = this.adapter.normalize(currentDate);
+            const cellYear = this.adapter.getYear(cellDate);
+            const cellMonth = this.adapter.getMonth(cellDate);
+            const cellDay = this.adapter.getDate(cellDate);
+            const cellDayOfWeek = this.adapter.getDay(cellDate);
+            cells.push({
+                date: cellDate,
+                inCurrentMonth: cellYear === year && cellMonth === month,
+                iso: this.adapter.toISODate(cellDate),
+                day: cellDay,
+                month: cellMonth,
+                year: cellYear,
+                dayOfWeek: cellDayOfWeek
+            });
+            currentDate = this.adapter.addDays(currentDate, 1);
+        }
+        // Split into weeks
+        const weeks = [];
+        for (let i = 0; i < 6; i++) {
+            weeks.push(cells.slice(i * 7, (i + 1) * 7));
+        }
+        return {
+            month: { year, month },
+            weekStart,
+            locale,
+            weeks,
+            cells
+        };
+    }
+    /**
+     * Calculate offset (number of padding days from previous month)
+     *
+     * @param firstDayOfWeek - Day of week for first day of month (0-6)
+     * @param weekStart - Desired week start (0-6)
+     * @returns Number of padding days needed
+     */
+    calculateOffset(firstDayOfWeek, weekStart) {
+        let offset = firstDayOfWeek - weekStart;
+        if (offset < 0) {
+            offset += 7;
+        }
+        return offset;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridFactory, deps: [{ token: DATE_ADAPTER }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridFactory, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridFactory, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: undefined, decorators: [{
+                    type: Inject,
+                    args: [DATE_ADAPTER]
+                }] }] });
+
+/**
+ * Cache Configuration
+ *
+ * Centralized cache limits for memory safety.
+ *
+ * @module core/calendar-grid/cache.config
+ * @version 3.9.2
+ */
+/**
+ * Maximum cache entries before FIFO eviction
+ *
+ * Applied to both:
+ * - CalendarGridCache: Raw month grids
+ * - RangeHighlighterCache: Decorated grids
+ *
+ * Memory footprint:
+ * - CalendarGrid (raw): ~10KB each
+ * - DecoratedGrid: ~15KB each
+ * - Total worst case: (10KB + 15KB) × 48 = ~1.2MB
+ *
+ * Coverage:
+ * - 48 months = 4 years of navigation
+ * - Sufficient for long-running sessions
+ *
+ * Critical for:
+ * - ERP systems (invoice date selection)
+ * - BI dashboards (date range filters)
+ * - Hotel reservation systems (availability calendars)
+ * - Point-of-sale systems (report generation)
+ *
+ * @constant
+ * @since v3.9.2
+ */
+const MAX_CACHE_ENTRIES = 48;
+
+/**
+ * Calendar Grid Cache
+ *
+ * LRU cache for calendar month grids to avoid recomputing the same month grid
+ * multiple times when only decorations (selected dates, hover, etc.) change.
+ *
+ * Strategy:
+ * - Key: year-month-weekStart-locale
+ * - LRU eviction (least recently used) when limit is reached
+ * - Default limit: 48 months (covers 2 years of navigation)
+ *
+ * Performance impact:
+ * - Eliminates ~90% of grid recalculations in typical usage
+ * - Memory footprint: ~10KB per cached month (negligible)
+ *
+ * Memory safety (v3.9.2):
+ * - MAX_CACHE_ENTRIES prevents unbounded growth in long-running sessions
+ * - Critical for: ERP, BI dashboards, hotel reservation systems
+ * - FIFO eviction when limit exceeded
+ */
+class CalendarGridCache {
+    factory;
+    cache = new Map();
+    maxSize = MAX_CACHE_ENTRIES;
+    constructor(factory) {
+        this.factory = factory;
+    }
+    /**
+     * Get or create a calendar grid
+     *
+     * @param monthDate - Any date within the target month
+     * @param weekStart - First day of week (0 = Sunday, 1 = Monday, etc.)
+     * @param locale - Locale identifier (optional)
+     * @returns CalendarGrid - cached or newly created
+     */
+    get(monthDate, weekStart = 0, locale) {
+        const key = this.buildKey(monthDate, weekStart, locale);
+        // Check cache
+        const cached = this.cache.get(key);
+        if (cached) {
+            // Move to end (LRU)
+            this.cache.delete(key);
+            this.cache.set(key, cached);
+            return cached;
+        }
+        // Generate new grid
+        const grid = this.factory.createGrid(monthDate, weekStart, locale);
+        // Store in cache
+        this.cache.set(key, grid);
+        // Evict oldest if over limit (LRU)
+        if (this.cache.size > this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            this.cache.delete(firstKey);
+        }
+        return grid;
+    }
+    /**
+     * Build cache key from month parameters
+     *
+     * Format: "year-month-weekStart-locale"
+     * Example: "2026-1-0-en" (Feb 2026, Sunday start, English)
+     */
+    buildKey(monthDate, weekStart, locale) {
+        const year = monthDate.getFullYear();
+        const month = monthDate.getMonth();
+        return `${year}-${month}-${weekStart}${locale ? '-' + locale : ''}`;
+    }
+    /**
+     * Clear entire cache (for testing or manual reset)
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache size (for debugging/testing)
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Check if a specific month is cached
+     */
+    has(monthDate, weekStart = 0, locale) {
+        const key = this.buildKey(monthDate, weekStart, locale);
+        return this.cache.has(key);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridCache, deps: [{ token: CalendarGridFactory }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridCache, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: CalendarGridCache, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: CalendarGridFactory }] });
+
+/**
+ * Range Highlighter Service
+ *
+ * Decorates calendar grids with range highlights, hover previews, and disabled states.
+ * Pure computation layer - no caching (see RangeHighlighterCache for memoization).
+ *
+ * @module core/calendar-grid/range-highlighter
+ * @version 3.8.0
+ */
+/**
+ * Range Highlighter
+ *
+ * Applies decorations to calendar grids:
+ * - isSelectedStart, isSelectedEnd (range boundaries)
+ * - isInRange (cells within selected range)
+ * - isInHoverRange (hover preview)
+ * - isDisabled (constraints, custom predicates)
+ *
+ * Design:
+ * - Pure functions (same input = same output)
+ * - Uses DateAdapter for all date operations (SSR-safe)
+ * - No side effects, no state
+ * - Fast (~1ms for 42 cells on mobile)
+ *
+ * Usage:
+ * ```typescript
+ * const grid = calendarGridCache.get(monthDate, 0);
+ * const decorated = rangeHighlighter.decorate(grid, {
+ *   start: startDate,
+ *   end: endDate,
+ *   hoverDate: '2026-01-20',
+ *   disabledDates: [...]
+ * });
+ * ```
+ */
+class RangeHighlighter {
     adapter;
     constructor(adapter) {
         this.adapter = adapter;
@@ -2433,16 +2555,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImpo
                     args: [DATE_ADAPTER]
                 }] }] });
 
-/**
- * Virtual Weeks Types
- *
- * Type definitions for windowed week rendering (virtual scrolling).
- * Reduces DOM nodes by rendering only visible weeks instead of full month.
- *
- * @module core/calendar-grid/virtual-weeks.types
- * @version 3.9.0
- */
-
 /**
  * Virtual Weeks Logic (Pure Functions)
  *
@@ -2593,51 +2705,110 @@ function isVirtualWeeksEnabled(windowSize, totalWeeks) {
 }
 
 /**
- * Calendar Grid Module
- *
- * Performance-optimized calendar month grid generation with memoization.
- *
- * v3.7.0: Grid Structure Cache
- * - CalendarGridFactory for deterministic 42-cell grids
- * - CalendarGridCache with LRU (24 months)
+ * Fixed Clock for Deterministic Testing
  *
- * v3.8.0: Range Highlight Cache
- * - RangeHighlighter for decoration logic
- * - RangeHighlighterCache with LRU (48 grids)
- * - Separates grid structure from decorations
- *
- * v3.9.0: Virtual Weeks (Windowed Rendering)
- * - Virtual-weeks logic for reduced DOM complexity
- * - Render only visible weeks (configurable window)
- * - ~50% reduction in DOM nodes with windowSize=3
- *
- * v3.9.2: Cache Bounds (Memory Safety)
- * - MAX_CACHE_ENTRIES = 48 prevents unbounded growth
- * - FIFO eviction for long-running sessions
- * - Critical for ERP, BI, hotel systems
+ * Implements DateClock interface with a fixed date.
  *
  * Usage:
  * ```typescript
- * constructor(
- *   private gridCache: CalendarGridCache,
- *   private highlighterCache: RangeHighlighterCache
- * ) {}
- *
- * const grid = this.gridCache.get(monthDate, weekStart);
- * const decorated = this.highlighterCache.get(grid, {
- *   start, end, hoverDate, disabledDates
- * });
- *
- * // Optional: Windowed rendering (v3.9.0+)
- * const windowSize = 3; // Render only 3 weeks
- * const visibleWeeks = getVisibleWeeks(
- *   decorated.weeks,
- *   weekStartIndex,
- *   windowSize
- * );
- * // decorated.cells[0].iso => '2026-02-01'
- * // decorated.cells[0].isInRange => true
+ * const clock = new FixedClock(new Date(2026, 1, 21)); // Feb 21, 2026
+ * const now = clock.now(); // Always returns Feb 21, 2026 (cloned)
  * ```
+ *
+ * Why clone?
+ * - Prevents test pollution if consumer mutates the returned date
+ * - Each call to now() returns a fresh Date instance
+ */
+class FixedClock {
+    fixedDate;
+    constructor(fixedDate) {
+        this.fixedDate = fixedDate;
+    }
+    /**
+     * Returns a cloned copy of the fixed date
+     *
+     * Cloning prevents test pollution from mutations
+     */
+    now() {
+        return new Date(this.fixedDate);
+    }
+}
+
+/**
+ * Date Test Helpers
+ *
+ * Utilities for creating deterministic dates in tests.
+ */
+/**
+ * Create a Date in local timezone
+ *
+ * @param year - Full year (e.g., 2026)
+ * @param month - Month 1-12 (natural notation)
+ * @param day - Day of month 1-31
+ * @returns Date at 00:00:00.000 local time
+ *
+ * @example
+ * makeDate(2026, 2, 21) // Feb 21, 2026 00:00:00.000
+ */
+function makeDate(year, month, day) {
+    return new Date(year, month - 1, day); // month-1 because Date uses 0-indexed months
+}
+/**
+ * Create ISO date string (YYYY-MM-DD)
+ *
+ * @param year - Full year (e.g., 2026)
+ * @param month - Month 1-12 (natural notation)
+ * @param day - Day of month 1-31
+ * @returns ISO date string
+ *
+ * @example
+ * iso(2026, 2, 21) // '2026-02-21'
+ */
+function iso(year, month, day) {
+    const y = String(year).padStart(4, '0');
+    const m = String(month).padStart(2, '0');
+    const d = String(day).padStart(2, '0');
+    return `${y}-${m}-${d}`;
+}
+/**
+ * Compare two dates for equality (ignoring time)
+ *
+ * @param a - First date
+ * @param b - Second date
+ * @returns true if same calendar day
+ */
+function isSameCalendarDay(a, b) {
+    return (a.getFullYear() === b.getFullYear() &&
+        a.getMonth() === b.getMonth() &&
+        a.getDate() === b.getDate());
+}
+
+/**
+ * Testing Utilities
+ *
+ * Helpers for deterministic date range testing.
+ */
+
+/**
+ * INTERNAL API for @oneluiz/dual-datepicker
+ *
+ * This file exports implementation details required by the component itself.
+ * These exports are NOT part of the public API and may change without notice.
+ *
+ * ⚠️ DO NOT import from this file in your application code.
+ * ⚠️ Use the public API from '@oneluiz/dual-datepicker/core' instead.
+ *
+ * @internal
+ * @packageDocumentation
+ * @since v4.0.0
+ */
+/**
+ * CalendarGridFactory - Deterministic grid generation
+ *
+ * Creates normalized 42-cell grids (6 weeks × 7 days).
+ * Pure function approach with no side effects.
+ *
+ * @internal
  */
 
 class DualDatepickerComponent {
@@ -2645,7 +2816,7 @@ class DualDatepickerComponent {
     placeholder = 'Select date range';
     set startDate(value) {
         if (value) {
-            const date = this.dateAdapter.parse(value);
+            const date = this.dateAdapter.parseISODate(value);
             if (date)
                 this.rangeStore.setStart(date);
         }
@@ -2656,7 +2827,7 @@ class DualDatepickerComponent {
     }
     set endDate(value) {
         if (value) {
-            const date = this.dateAdapter.parse(value);
+            const date = this.dateAdapter.parseISODate(value);
             if (date)
                 this.rangeStore.setEnd(date);
         }
@@ -2713,7 +2884,7 @@ class DualDatepickerComponent {
     multiDateRangeChange = new EventEmitter();
     multiDateRangeSelected = new EventEmitter();
     // Date adapter injection
-    dateAdapter = inject(DATE_ADAPTER$1);
+    dateAdapter = inject(DATE_ADAPTER);
     // Calendar grid cache (v3.7.0+) - memoizes month grid generation
     gridCache = inject(CalendarGridCache);
     // Range highlighter cache (v3.8.0+) - memoizes decorations
@@ -2722,8 +2893,8 @@ class DualDatepickerComponent {
     rangeStore = inject(DualDateRangeStore);
     // UI-only signals
     showDatePicker = signal(false);
-    currentMonth = signal(this.dateAdapter.today());
-    previousMonth = signal(this.dateAdapter.today());
+    currentMonth = signal(this.dateAdapter.normalize(new Date()));
+    previousMonth = signal(this.dateAdapter.normalize(new Date()));
     currentMonthDays = signal([]);
     previousMonthDays = signal([]);
     isDisabled = signal(false);
@@ -2936,7 +3107,7 @@ class DualDatepickerComponent {
             }
             else {
                 // startDate is not visible, focus on today if visible
-                const today = this.dateAdapter.format(this.dateAdapter.today(), 'yyyy-MM-dd');
+                const today = this.dateAdapter.toISODate(this.dateAdapter.normalize(new Date()));
                 const inCurrMonth = this.isDateInMonth(today, this.currentMonth());
                 if (inCurrMonth) {
                     this.focusedDay.set({ date: today, monthIndex: 1 });
@@ -2958,7 +3129,7 @@ class DualDatepickerComponent {
             }
             else {
                 // endDate is not visible, focus on today if visible
-                const today = this.dateAdapter.format(this.dateAdapter.today(), 'yyyy-MM-dd');
+                const today = this.dateAdapter.toISODate(this.dateAdapter.normalize(new Date()));
                 const inCurrMonth = this.isDateInMonth(today, this.currentMonth());
                 if (inCurrMonth) {
                     this.focusedDay.set({ date: today, monthIndex: 1 });
@@ -2974,7 +3145,7 @@ class DualDatepickerComponent {
         }
         else {
             // Focus on today if visible, otherwise first day of current month
-            const today = this.dateAdapter.format(this.dateAdapter.today(), 'yyyy-MM-dd');
+            const today = this.dateAdapter.toISODate(this.dateAdapter.normalize(new Date()));
             const inCurrMonth = this.isDateInMonth(today, this.currentMonth());
             if (inCurrMonth) {
                 this.focusedDay.set({ date: today, monthIndex: 1 });
@@ -2990,7 +3161,7 @@ class DualDatepickerComponent {
         }
     }
     isDateInMonth(dateStr, monthDate) {
-        const date = this.dateAdapter.parse(dateStr);
+        const date = this.dateAdapter.parseISODate(dateStr);
         if (!date)
             return false;
         const year = this.dateAdapter.getYear(date);
@@ -3005,7 +3176,7 @@ class DualDatepickerComponent {
             this.initializeFocus();
             return;
         }
-        const currentDate = this.dateAdapter.parse(focused.date);
+        const currentDate = this.dateAdapter.parseISODate(focused.date);
         if (!currentDate)
             return;
         const newDate = this.dateAdapter.addDays(currentDate, direction);
@@ -3042,7 +3213,7 @@ class DualDatepickerComponent {
             this.initializeFocus();
             return;
         }
-        const currentDate = this.dateAdapter.parse(focused.date);
+        const currentDate = this.dateAdapter.parseISODate(focused.date);
         if (!currentDate)
             return;
         const newDate = this.dateAdapter.addDays(currentDate, direction * 7); // Move by week
@@ -3093,17 +3264,17 @@ class DualDatepickerComponent {
             this.initializeFocus();
             return;
         }
-        const currentDate = this.dateAdapter.parse(focused.date);
+        const currentDate = this.dateAdapter.parseISODate(focused.date);
         if (!currentDate)
             return;
         const currentYear = this.dateAdapter.getYear(currentDate);
         const currentMonth = this.dateAdapter.getMonth(currentDate);
         const currentDay = this.dateAdapter.getDate(currentDate);
-        const newDate = this.dateAdapter.createDate(currentYear + direction, currentMonth, currentDay);
+        const newDate = this.dateAdapter.normalize(new Date(currentYear + direction, currentMonth, currentDay));
         const newDateStr = this.formatDate(newDate);
         // Update months to show the new year
-        this.currentMonth.set(this.dateAdapter.createDate(currentYear + direction, currentMonth, 1));
-        this.previousMonth.set(this.dateAdapter.createDate(currentYear + direction, currentMonth - 1, 1));
+        this.currentMonth.set(this.dateAdapter.normalize(new Date(currentYear + direction, currentMonth, 1)));
+        this.previousMonth.set(this.dateAdapter.normalize(new Date(currentYear + direction, currentMonth - 1, 1)));
         this.generateCalendars();
         const inPrevMonth = this.isDateInMonth(newDateStr, this.previousMonth());
         this.focusedDay.set({
@@ -3153,12 +3324,12 @@ class DualDatepickerComponent {
         });
         // Initialize dates in store if provided
         if (this.startDate) {
-            const date = this.dateAdapter.parse(this.startDate);
+            const date = this.dateAdapter.parseISODate(this.startDate);
             if (date)
                 this.rangeStore.setStart(date);
         }
         if (this.endDate) {
-            const date = this.dateAdapter.parse(this.endDate);
+            const date = this.dateAdapter.parseISODate(this.endDate);
             if (date)
                 this.rangeStore.setEnd(date);
         }
@@ -3170,12 +3341,12 @@ class DualDatepickerComponent {
         if (changes['startDate'] || changes['endDate']) {
             // Sync with store
             if (changes['startDate'] && this.startDate) {
-                const date = this.dateAdapter.parse(this.startDate);
+                const date = this.dateAdapter.parseISODate(this.startDate);
                 if (date)
                     this.rangeStore.setStart(date);
             }
             if (changes['endDate'] && this.endDate) {
-                const date = this.dateAdapter.parse(this.endDate);
+                const date = this.dateAdapter.parseISODate(this.endDate);
                 if (date)
                     this.rangeStore.setEnd(date);
             }
@@ -3203,7 +3374,7 @@ class DualDatepickerComponent {
     formatDateDisplay(dateStr) {
         if (!dateStr)
             return '';
-        const date = this.dateAdapter.parse(dateStr);
+        const date = this.dateAdapter.parseISODate(dateStr);
         if (!date)
             return '';
         const year = this.dateAdapter.getYear(date);
@@ -3238,7 +3409,7 @@ class DualDatepickerComponent {
             const currentMonthValue = this.currentMonth();
             const year = this.dateAdapter.getYear(currentMonthValue);
             const month = this.dateAdapter.getMonth(currentMonthValue);
-            const previousMonthDate = this.dateAdapter.createDate(year, month - 1, 1);
+            const previousMonthDate = this.dateAdapter.normalize(new Date(year, month - 1, 1));
             this.previousMonth.set(previousMonthDate);
             this.generateCalendars();
             // Initialize keyboard focus only if keyboard navigation is enabled
@@ -3456,7 +3627,7 @@ class DualDatepickerComponent {
     selectDay(dayObj) {
         if (!dayObj.isCurrentMonth || this.isDisabled() || dayObj.isDisabled)
             return;
-        const selectedDate = this.dateAdapter.parse(dayObj.date);
+        const selectedDate = this.dateAdapter.parseISODate(dayObj.date);
         if (!selectedDate)
             return;
         if (this.multiRange) {
@@ -3568,11 +3739,11 @@ class DualDatepickerComponent {
         const currentMonthValue = this.currentMonth();
         const year = this.dateAdapter.getYear(currentMonthValue);
         const month = this.dateAdapter.getMonth(currentMonthValue);
-        const newCurrentMonth = this.dateAdapter.createDate(year, month + direction, 1);
+        const newCurrentMonth = this.dateAdapter.normalize(new Date(year, month + direction, 1));
         this.currentMonth.set(newCurrentMonth);
         const newYear = this.dateAdapter.getYear(newCurrentMonth);
         const newMonth = this.dateAdapter.getMonth(newCurrentMonth);
-        const newPreviousMonth = this.dateAdapter.createDate(newYear, newMonth - 1, 1);
+        const newPreviousMonth = this.dateAdapter.normalize(new Date(newYear, newMonth - 1, 1));
         this.previousMonth.set(newPreviousMonth);
         this.generateCalendars();
     }
@@ -3589,8 +3760,8 @@ class DualDatepickerComponent {
             return;
         }
         const range = preset.getValue();
-        const startDate = this.dateAdapter.parse(range.start);
-        const endDate = this.dateAdapter.parse(range.end);
+        const startDate = this.dateAdapter.parseISODate(range.start);
+        const endDate = this.dateAdapter.parseISODate(range.end);
         if (startDate && endDate) {
             this.rangeStore.setRange(startDate, endDate);
         }
@@ -3829,8 +4000,8 @@ class DualDatepickerComponent {
                 multi: true
             },
             {
-                provide: DATE_ADAPTER$1,
-                useClass: NativeDateAdapter$1
+                provide: DATE_ADAPTER,
+                useClass: NativeDateAdapter
             },
             {
                 provide: APP_INITIALIZER,
@@ -3854,8 +4025,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImpo
                             multi: true
                         },
                         {
-                            provide: DATE_ADAPTER$1,
-                            useClass: NativeDateAdapter$1
+                            provide: DATE_ADAPTER,
+                            useClass: NativeDateAdapter
                         },
                         {
                             provide: APP_INITIALIZER,
@@ -3942,550 +4113,33 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImpo
             }] } });
 
 /**
- * Utility functions for creating common date range presets
- * Perfect for dashboards, reporting, POS, BI apps, and ERP systems
- */
-/**
- * Format a date as YYYY-MM-DD string
- */
-function formatDate(date) {
-    const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, '0');
-    const day = String(date.getDate()).padStart(2, '0');
-    return `${year}-${month}-${day}`;
-}
-/**
- * Get the start of today
- */
-function getToday() {
-    const today = new Date();
-    return {
-        start: formatDate(today),
-        end: formatDate(today)
-    };
-}
-/**
- * Get yesterday's date range
- */
-function getYesterday() {
-    const yesterday = new Date();
-    yesterday.setDate(yesterday.getDate() - 1);
-    return {
-        start: formatDate(yesterday),
-        end: formatDate(yesterday)
-    };
-}
-/**
- * Get last N days (including today)
- */
-function getLastNDays(days) {
-    const end = new Date();
-    const start = new Date();
-    start.setDate(start.getDate() - days + 1);
-    return {
-        start: formatDate(start),
-        end: formatDate(end)
-    };
-}
-/**
- * Get this week (Monday to Sunday)
- */
-function getThisWeek() {
-    const today = new Date();
-    const dayOfWeek = today.getDay();
-    const start = new Date(today);
-    // Adjust to Monday (1) as first day of week
-    const daysToMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
-    start.setDate(start.getDate() - daysToMonday);
-    const end = new Date(start);
-    end.setDate(end.getDate() + 6);
-    return {
-        start: formatDate(start),
-        end: formatDate(end)
-    };
-}
-/**
- * Get last week (Monday to Sunday)
- */
-function getLastWeek() {
-    const today = new Date();
-    const dayOfWeek = today.getDay();
-    const daysToMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
-    const lastMonday = new Date(today);
-    lastMonday.setDate(lastMonday.getDate() - daysToMonday - 7);
-    const lastSunday = new Date(lastMonday);
-    lastSunday.setDate(lastSunday.getDate() + 6);
-    return {
-        start: formatDate(lastMonday),
-        end: formatDate(lastSunday)
-    };
-}
-/**
- * Get this month (1st to last day)
- */
-function getThisMonth() {
-    const today = new Date();
-    const start = new Date(today.getFullYear(), today.getMonth(), 1);
-    const end = new Date(today.getFullYear(), today.getMonth() + 1, 0);
-    return {
-        start: formatDate(start),
-        end: formatDate(end)
-    };
-}
-/**
- * Get last month (1st to last day)
- */
-function getLastMonth() {
-    const today = new Date();
-    const start = new Date(today.getFullYear(), today.getMonth() - 1, 1);
-    const end = new Date(today.getFullYear(), today.getMonth(), 0);
-    return {
-        start: formatDate(start),
-        end: formatDate(end)
-    };
-}
-/**
- * Get month to date (1st of current month to today)
- */
-function getMonthToDate() {
-    const today = new Date();
-    const start = new Date(today.getFullYear(), today.getMonth(), 1);
-    return {
-        start: formatDate(start),
-        end: formatDate(today)
-    };
-}
-/**
- * Get this quarter (Q1, Q2, Q3, or Q4)
- */
-function getThisQuarter() {
-    const today = new Date();
-    const currentMonth = today.getMonth();
-    const quarterStartMonth = Math.floor(currentMonth / 3) * 3;
-    const start = new Date(today.getFullYear(), quarterStartMonth, 1);
-    const end = new Date(today.getFullYear(), quarterStartMonth + 3, 0);
-    return {
-        start: formatDate(start),
-        end: formatDate(end)
-    };
-}
-/**
- * Get last quarter
- */
-function getLastQuarter() {
-    const today = new Date();
-    const currentMonth = today.getMonth();
-    const lastQuarterStartMonth = Math.floor(currentMonth / 3) * 3 - 3;
-    const start = new Date(today.getFullYear(), lastQuarterStartMonth, 1);
-    const end = new Date(today.getFullYear(), lastQuarterStartMonth + 3, 0);
-    return {
-        start: formatDate(start),
-        end: formatDate(end)
-    };
-}
-/**
- * Get quarter to date (start of current quarter to today)
- */
-function getQuarterToDate() {
-    const today = new Date();
-    const currentMonth = today.getMonth();
-    const quarterStartMonth = Math.floor(currentMonth / 3) * 3;
-    const start = new Date(today.getFullYear(), quarterStartMonth, 1);
-    return {
-        start: formatDate(start),
-        end: formatDate(today)
-    };
-}
-/**
- * Get this year (January 1 to December 31)
- */
-function getThisYear() {
-    const today = new Date();
-    const start = new Date(today.getFullYear(), 0, 1);
-    const end = new Date(today.getFullYear(), 11, 31);
-    return {
-        start: formatDate(start),
-        end: formatDate(end)
-    };
-}
-/**
- * Get last year
- */
-function getLastYear() {
-    const today = new Date();
-    const start = new Date(today.getFullYear() - 1, 0, 1);
-    const end = new Date(today.getFullYear() - 1, 11, 31);
-    return {
-        start: formatDate(start),
-        end: formatDate(end)
-    };
-}
-/**
- * Get year to date (January 1 to today)
- */
-function getYearToDate() {
-    const today = new Date();
-    const start = new Date(today.getFullYear(), 0, 1);
-    return {
-        start: formatDate(start),
-        end: formatDate(today)
-    };
-}
-/**
- * Get last N months (including current partial month)
- */
-function getLastNMonths(months) {
-    const today = new Date();
-    const start = new Date(today);
-    start.setMonth(start.getMonth() - months);
-    return {
-        start: formatDate(start),
-        end: formatDate(today)
-    };
-}
-/**
- * Get last N years
- */
-function getLastNYears(years) {
-    const today = new Date();
-    const start = new Date(today);
-    start.setFullYear(start.getFullYear() - years);
-    return {
-        start: formatDate(start),
-        end: formatDate(today)
-    };
-}
-/**
- * Pre-built preset configurations for common use cases
- * Import and use these directly in your component
- */
-const CommonPresets = {
-    /**
-     * Dashboard presets - Perfect for analytics dashboards
-     */
-    dashboard: [
-        { label: 'Today', getValue: getToday },
-        { label: 'Yesterday', getValue: getYesterday },
-        { label: 'Last 7 days', getValue: () => getLastNDays(7) },
-        { label: 'Last 30 days', getValue: () => getLastNDays(30) },
-        { label: 'This month', getValue: getThisMonth },
-        { label: 'Last month', getValue: getLastMonth }
-    ],
-    /**
-     * Reporting presets - Perfect for business reporting
-     */
-    reporting: [
-        { label: 'Today', getValue: getToday },
-        { label: 'This week', getValue: getThisWeek },
-        { label: 'Last week', getValue: getLastWeek },
-        { label: 'This month', getValue: getThisMonth },
-        { label: 'Last month', getValue: getLastMonth },
-        { label: 'This quarter', getValue: getThisQuarter },
-        { label: 'Last quarter', getValue: getLastQuarter }
-    ],
-    /**
-     * Financial presets - Perfect for ERP and accounting systems
-     */
-    financial: [
-        { label: 'Month to date', getValue: getMonthToDate },
-        { label: 'Quarter to date', getValue: getQuarterToDate },
-        { label: 'Year to date', getValue: getYearToDate },
-        { label: 'Last month', getValue: getLastMonth },
-        { label: 'Last quarter', getValue: getLastQuarter },
-        { label: 'Last year', getValue: getLastYear }
-    ],
-    /**
-     * Analytics presets - Perfect for BI and data analysis
-     */
-    analytics: [
-        { label: 'Last 7 days', getValue: () => getLastNDays(7) },
-        { label: 'Last 14 days', getValue: () => getLastNDays(14) },
-        { label: 'Last 30 days', getValue: () => getLastNDays(30) },
-        { label: 'Last 60 days', getValue: () => getLastNDays(60) },
-        { label: 'Last 90 days', getValue: () => getLastNDays(90) },
-        { label: 'Last 180 days', getValue: () => getLastNDays(180) },
-        { label: 'Last 365 days', getValue: () => getLastNDays(365) }
-    ],
-    /**
-     * Simple presets - Basic common ranges
-     */
-    simple: [
-        { label: 'Today', getValue: getToday },
-        { label: 'Last 7 days', getValue: () => getLastNDays(7) },
-        { label: 'Last 30 days', getValue: () => getLastNDays(30) },
-        { label: 'This year', getValue: getThisYear }
-    ]
-};
-
-/**
- * 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 };
- *         }
- *       }
- *     ])
- *   ]
- * };
- * ```
- */
-/**
- * Initializer function that registers built-in presets
- *
- * Runs at application startup (APP_INITIALIZER)
- *
- * @param registry - PresetRegistry instance
- * @returns Initialization function
- */
-function initializeBuiltInPresets(registry) {
-    return () => {
-        // Register all built-in presets
-        BUILT_IN_PRESETS.forEach(preset => {
-            registry.register(preset);
-        });
-        // Log registration for debugging (can be removed in production)
-        if (typeof console !== 'undefined' && console.debug) {
-            console.debug(`[ng-dual-datepicker] Registered ${BUILT_IN_PRESETS.length} built-in presets:`, BUILT_IN_PRESETS.map(p => p.key).join(', '));
-        }
-    };
-}
-/**
- * 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
- */
-function provideBuiltInPresets() {
-    return makeEnvironmentProviders([
-        {
-            provide: APP_INITIALIZER,
-            multi: true,
-            useFactory: initializeBuiltInPresets,
-            deps: [PresetRegistry]
-        }
-    ]);
-}
-/**
- * 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)]
- * ```
- */
-function provideCustomPresets(presets) {
-    return makeEnvironmentProviders([
-        {
-            provide: APP_INITIALIZER,
-            multi: true,
-            useFactory: (registry) => {
-                return () => {
-                    presets.forEach(preset => {
-                        registry.register(preset);
-                    });
-                    if (typeof console !== 'undefined' && console.debug) {
-                        console.debug(`[ng-dual-datepicker] Registered ${presets.length} custom presets:`, presets.map(p => p.key).join(', '));
-                    }
-                };
-            },
-            deps: [PresetRegistry]
-        }
-    ]);
-}
-/**
- * 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);
- * }
+ * Public API Surface of @oneluiz/dual-datepicker
  *
- * // In app
- * import { provideFiscalPresets } from '@acme/fiscal-presets';
+ * v4.0.0: Formalized Public API
+ * - Only stable, documented APIs are exported
+ * - Internal implementation details removed
+ * - Backward compatibility maintained where possible
  *
- * providers: [provideFiscalPresets()]
- * ```
+ * @public
+ * @packageDocumentation
+ * @module @oneluiz/dual-datepicker
  */
-function providePresetPackage(packageName, presets) {
-    return makeEnvironmentProviders([
-        {
-            provide: APP_INITIALIZER,
-            multi: true,
-            useFactory: (registry) => {
-                return () => {
-                    presets.forEach(preset => {
-                        registry.register(preset);
-                    });
-                    if (typeof console !== 'undefined' && console.debug) {
-                        console.debug(`[${packageName}] Registered ${presets.length} presets:`, presets.map(p => p.key).join(', '));
-                    }
-                };
-            },
-            deps: [PresetRegistry]
-        }
-    ]);
-}
-
+// ============================================================================
+// UI COMPONENT
+// ============================================================================
 /**
- * Core headless date range logic
+ * DualDatepickerComponent - Main Angular component
  *
- * v3.6.0: Plugin Architecture
- * - RangePresetPlugin interface for extensible presets
- * - PresetRegistry for plugin management
- * - Built-in presets as plugins
- * - Provider functions for custom presets
+ * Standalone component for dual-calendar date range selection.
+ * Supports reactive forms, signals, themes, and extensive customization.
  *
- * 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
- */
-
-/**
- * Public API Surface of @oneluiz/dual-datepicker
+ * @public
+ * @since v1.0.0
  */
 
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { BUILT_IN_PRESETS, CalendarGridCache, CalendarGridFactory, CommonPresets, DATE_ADAPTER$1 as DATE_ADAPTER, DATE_CLOCK, DateAdapter, DualDateRangeStore, DualDatepickerComponent, LAST_14_DAYS_PRESET, LAST_30_DAYS_PRESET, LAST_60_DAYS_PRESET, LAST_7_DAYS_PRESET, LAST_90_DAYS_PRESET, LAST_MONTH_PRESET, LAST_QUARTER_PRESET, LAST_WEEK_PRESET, LAST_YEAR_PRESET, MAX_CACHE_ENTRIES, MONTH_TO_DATE_PRESET, NativeDateAdapter$1 as NativeDateAdapter, PresetEngine, PresetRegistry, QUARTER_TO_DATE_PRESET, RangeHighlighter, RangeHighlighterCache, SystemClock, THIS_MONTH_PRESET, THIS_QUARTER_PRESET, THIS_WEEK_PRESET, THIS_YEAR_PRESET, TODAY_PRESET, YEAR_TO_DATE_PRESET, YESTERDAY_PRESET, applyBounds, clampWeekStart, createPreset, formatISODate, getLastMonth, getLastNDays, getLastNMonths, getLastNYears, getLastQuarter, getLastWeek, getLastYear, getMonthToDate, getQuarterToDate, getThisMonth, getThisQuarter, getThisWeek, getThisYear, getToday, getVirtualWeekWindow, getVisibleWeeks, getYearToDate, getYesterday, isDateDisabled, isRangePresetPlugin, isVirtualWeeksEnabled, navigateWeekWindow, parseISODate, presetEngine, provideBuiltInPresets, provideCustomPresets, providePresetPackage, validateDateBounds, validateRangeBounds, validateRangeOrder };
+export { BUILT_IN_PRESETS, DATE_ADAPTER, DualDateRangeStore, DualDatepickerComponent, LAST_30_DAYS_PRESET, LAST_7_DAYS_PRESET, LAST_MONTH_PRESET, LAST_WEEK_PRESET, LAST_YEAR_PRESET, NativeDateAdapter, PresetEngine, PresetRegistry, THIS_MONTH_PRESET, THIS_WEEK_PRESET, THIS_YEAR_PRESET, TODAY_PRESET, YESTERDAY_PRESET, applyBounds, isDateDisabled, provideCustomPresets, providePresetPackage, validateRangeOrder };
 //# sourceMappingURL=oneluiz-dual-datepicker.mjs.map