@oneluiz/dual-datepicker 3.9.2 → 4.0.0

package/core/preset-registry.d.ts

@@ -1,181 +0,0 @@
-import { RangePresetPlugin } from './range-preset.plugin';
-import * as i0 from "@angular/core";
-/**
- * Preset Registry Service
- *
- * Manages registration and retrieval of date range preset plugins.
- *
- * DESIGN:
- * - Uses Map for O(1) lookups
- * - Immutable getAll() returns copy
- * - Supports plugin override (last registration wins)
- * - Validates plugins before registration
- */
-export declare class PresetRegistry {
-    /**
-     * Internal map of registered presets
-     * Key: preset key (e.g., 'TODAY', 'LAST_7_DAYS')
-     * Value: RangePresetPlugin instance
-     */
-    private readonly presets;
-    /**
-     * Register a date range preset plugin
-     *
-     * If a preset with the same key already exists, it will be overridden.
-     * This is useful for:
-     * - Testing (override built-in presets with mocks)
-     * - Customization (replace default behavior)
-     * - Hot-reload scenarios
-     *
-     * @param plugin - The preset plugin to register
-     * @throws Error if plugin is invalid (missing key or resolve function)
-     *
-     * @example
-     * ```typescript
-     * registry.register({
-     *   key: 'LAST_BUSINESS_WEEK',
-     *   resolve: (clock, adapter) => {
-     *     const now = clock.now();
-     *     const dayOfWeek = adapter.getDayOfWeek(now);
-     *
-     *     // Go back to last Friday
-     *     const daysToLastFriday = dayOfWeek === 0 ? 2 : (dayOfWeek + 2) % 7;
-     *     const lastFriday = adapter.addDays(now, -daysToLastFriday);
-     *
-     *     // Business week: Monday to Friday
-     *     const monday = adapter.addDays(lastFriday, -4);
-     *
-     *     return { start: monday, end: lastFriday };
-     *   }
-     * });
-     * ```
-     */
-    register(plugin: RangePresetPlugin): void;
-    /**
-     * Register multiple preset plugins at once
-     *
-     * Convenience method for bulk registration.
-     * Useful when importing preset packages.
-     *
-     * @param plugins - Array of preset plugins to register
-     *
-     * @example
-     * ```typescript
-     * import { FISCAL_PRESETS } from '@acme/fiscal-presets';
-     *
-     * registry.registerAll(FISCAL_PRESETS);
-     * ```
-     */
-    registerAll(plugins: RangePresetPlugin[]): void;
-    /**
-     * Get a preset plugin by key
-     *
-     * @param key - Preset key (case-insensitive, e.g., 'today' or 'TODAY')
-     * @returns The preset plugin or undefined if not found
-     *
-     * @example
-     * ```typescript
-     * const preset = registry.get('LAST_7_DAYS');
-     * if (preset) {
-     *   const range = preset.resolve(clock, adapter);
-     *   console.log('Range:', range);
-     * }
-     * ```
-     */
-    get(key: string): RangePresetPlugin | undefined;
-    /**
-     * Check if a preset exists in the registry
-     *
-     * @param key - Preset key (case-insensitive)
-     * @returns true if preset exists, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (registry.has('THIS_FISCAL_QUARTER')) {
-     *   store.applyPreset('THIS_FISCAL_QUARTER');
-     * } else {
-     *   console.error('Fiscal quarter preset not registered');
-     * }
-     * ```
-     */
-    has(key: string): boolean;
-    /**
-     * Get all registered preset plugins
-     *
-     * Returns a NEW array (immutable) to prevent external modification.
-     *
-     * @returns Array of all registered preset plugins
-     *
-     * @example
-     * ```typescript
-     * const allPresets = registry.getAll();
-     * console.log('Available presets:');
-     * allPresets.forEach(preset => {
-     *   console.log(`- ${preset.key}`);
-     * });
-     * ```
-     */
-    getAll(): RangePresetPlugin[];
-    /**
-     * Get all preset keys
-     *
-     * Convenience method to list available preset identifiers.
-     *
-     * @returns Array of preset keys (uppercase)
-     *
-     * @example
-     * ```typescript
-     * const keys = registry.getAllKeys();
-     * // ['TODAY', 'YESTERDAY', 'LAST_7_DAYS', 'THIS_MONTH', ...]
-     * ```
-     */
-    getAllKeys(): string[];
-    /**
-     * Get count of registered presets
-     *
-     * @returns Number of registered presets
-     *
-     * @example
-     * ```typescript
-     * console.log(`${registry.count()} presets available`);
-     * ```
-     */
-    count(): number;
-    /**
-     * Unregister a preset plugin
-     *
-     * Useful for:
-     * - Testing cleanup
-     * - Dynamic preset management
-     * - Removing deprecated presets
-     *
-     * @param key - Preset key to remove (case-insensitive)
-     * @returns true if preset was removed, false if it didn't exist
-     *
-     * @example
-     * ```typescript
-     * registry.unregister('MY_TEMPORARY_PRESET');
-     * ```
-     */
-    unregister(key: string): boolean;
-    /**
-     * Clear all registered presets
-     *
-     * ⚠️ USE WITH CAUTION: This removes ALL presets including built-ins.
-     *
-     * Useful for:
-     * - Test teardown
-     * - Complete re-initialization scenarios
-     *
-     * @example
-     * ```typescript
-     * // In test cleanup
-     * afterEach(() => {
-     *   registry.clear();
-     * });
-     * ```
-     */
-    clear(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PresetRegistry, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PresetRegistry>;
-}

package/core/preset.engine.d.ts

@@ -1,124 +0,0 @@
-import * as i0 from "@angular/core";
-/**
- * @deprecated Use RangePresetPlugin from './range-preset.plugin' instead
- * Kept for backward compatibility
- */
-export interface RangePreset {
-    /**
-     * Resolve preset to actual date range
-     * @param now - Current date for deterministic calculation
-     */
-    resolve(now: Date): {
-        start: Date;
-        end: Date;
-    };
-}
-export interface PresetRange {
-    start: string;
-    end: string;
-}
-/**
- * Preset Engine - Plugin-Driven Architecture
- *
- * ARCHITECTURE (v3.6.0):
- * - NO longer contains presets internally
- * - Uses PresetRegistry for plugin management
- * - Injects DateClock for SSR-safe time
- * - Injects DateAdapter for timezone-safe operations
- * - Follows Open/Closed Principle
- *
- * BACKWARD COMPATIBILITY:
- * - Old API unchanged: resolve(), register(), getPresetKeys()
- * - Built-in presets auto-registered via provider
- * - Existing code continues to work
- *
- * EXTENSIBILITY:
- * ```typescript
- * // Register custom preset via registry
- * const registry = inject(PresetRegistry);
- * registry.register({
- *   key: 'MY_PRESET',
- *   resolve: (clock, adapter) => {
- *     const now = clock.now();
- *     return { start: now, end: now };
- *   }
- * });
- *
- * // Use via engine
- * const engine = inject(PresetEngine);
- * const range = engine.resolve('MY_PRESET');
- * ```
- */
-export declare class PresetEngine {
-    private clock;
-    private adapter;
-    private registry;
-    constructor();
-    /**
-     * Register a custom preset
-     *
-     * @deprecated Use PresetRegistry.register() directly for new code
-     * Kept for backward compatibility
-     *
-     * @param key - Preset key (e.g., 'MY_CUSTOM_PRESET')
-     * @param preset - Legacy RangePreset object
-     */
-    register(key: string, preset: RangePreset): void;
-    /**
-     * Resolve a preset to date range
-     *
-     * Plugin Architecture:
-     * 1. Looks up plugin in PresetRegistry
-     * 2. Calls plugin.resolve(clock, adapter)
-     * 3. Returns ISO date range
-     *
-     * SSR Note: Uses injected DateClock for deterministic resolution
-     * Timezone Note: Uses injected DateAdapter for consistent operations
-     *
-     * @param key - Preset key (e.g., 'TODAY', 'LAST_7_DAYS')
-     * @param now - Optional override for current date (defaults to clock.now())
-     * @returns ISO date range or null if preset not found
-     */
-    resolve(key: string, now?: Date): PresetRange | null;
-    /**
-     * Get all available preset keys
-     *
-     * Delegates to PresetRegistry
-     *
-     * @returns Array of registered preset keys
-     */
-    getPresetKeys(): string[];
-    /**
-     * Check if a preset exists
-     *
-     * @param key - Preset key to check
-     * @returns true if preset is registered
-     */
-    hasPreset(key: string): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PresetEngine, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PresetEngine>;
-}
-/**
- * Create a custom preset from a function
- *
- * @deprecated Use RangePresetPlugin interface instead
- * Kept for backward compatibility
- */
-export declare function createPreset(resolver: (now: Date) => {
-    start: Date;
-    end: Date;
-}): RangePreset;
-/**
- * @deprecated Use dependency injection instead:
- * ```typescript
- * private engine = inject(PresetEngine);
- * ```
- *
- * Singleton preset engine instance for backward compatibility
- *
- * WARNING: This singleton uses SystemClock directly and is NOT SSR-safe.
- * For SSR applications, inject PresetEngine and override DATE_CLOCK token.
- *
- * This export will be removed in v4.0.0
- */
-export declare const presetEngine: PresetEngine;

package/core/range-preset.plugin.d.ts

@@ -1,188 +0,0 @@
-/**
- * Range Preset Plugin System
- *
- * Version: 3.6.0
- *
- * Plugin-based architecture for date range presets following Open/Closed Principle.
- *
- * WHY THIS EXISTS:
- * - Enterprise apps need industry-specific presets (fiscal, hotel, logistics)
- * - Presets should be distributable as external packages
- * - Core should NOT know about all possible presets
- * - Users should extend presets without modifying library code
- *
- * ARCHITECTURE:
- * ```
- * RangePresetPlugin (interface) - Contract for all presets
- *     ↓
- * PresetRegistry (service) - Manages plugin registration
- *     ↓
- * PresetEngine (refactored) - Resolves presets via registry
- *     ↓
- * DualDateRangeStore - No changes, backward compatible
- * ```
- *
- * USAGE:
- * ```typescript
- * // Built-in presets work automatically
- * store.applyPreset('LAST_7_DAYS'); // ✅ Works
- *
- * // Register custom preset
- * const registry = inject(PresetRegistry);
- * registry.register({
- *   key: 'THIS_FISCAL_QUARTER',
- *   resolve: (clock, adapter) => {
- *     const now = clock.now();
- *     const fiscalStart = adapter.startOfMonth(now);
- *     const fiscalEnd = adapter.endOfMonth(now);
- *     return { start: fiscalStart, end: fiscalEnd };
- *   }
- * });
- *
- * // Use custom preset
- * store.applyPreset('THIS_FISCAL_QUARTER'); // ✅ Works
- * ```
- *
- * EXTERNAL PACKAGES:
- * ```typescript
- * // @acme/fiscal-presets package
- * export const FISCAL_PRESETS: RangePresetPlugin[] = [
- *   { key: 'FISCAL_Q1', resolve: ... },
- *   { key: 'FISCAL_Q2', resolve: ... }
- * ];
- *
- * // In app
- * FISCAL_PRESETS.forEach(p => registry.register(p));
- * ```
- */
-import { DateClock } from './date-clock';
-import { DateAdapter } from './date-adapter';
-/**
- * Date range returned by preset plugins
- */
-export interface DateRange {
-    /**
-     * Start date of the range (inclusive)
-     */
-    start: Date;
-    /**
-     * End date of the range (inclusive)
-     */
-    end: Date;
-}
-/**
- * Range Preset Plugin Interface
- *
- * All date range presets (built-in or external) implement this interface.
- *
- * DESIGN PRINCIPLES:
- * - **Deterministic**: Given the same clock.now(), always returns same range
- * - **Timezone-safe**: Uses DateAdapter for all date operations
- * - **SSR-compatible**: Uses DateClock injection, no global Date()
- * - **Testable**: Pure function, no side effects
- *
- * EXAMPLE - Built-in preset:
- * ```typescript
- * const todayPreset: RangePresetPlugin = {
- *   key: 'TODAY',
- *   resolve: (clock, adapter) => {
- *     const now = clock.now();
- *     const normalized = adapter.normalize(now);
- *     return { start: normalized, end: normalized };
- *   }
- * };
- * ```
- *
- * EXAMPLE - Custom fiscal preset:
- * ```typescript
- * const fiscalQuarterPreset: RangePresetPlugin = {
- *   key: 'THIS_FISCAL_QUARTER',
- *   resolve: (clock, adapter) => {
- *     const now = clock.now();
- *     const month = adapter.getMonth(now); // 0-11
- *
- *     // Fiscal year starts in April (month 3)
- *     const fiscalMonth = (month + 9) % 12; // Offset to fiscal calendar
- *     const quarterStartMonth = Math.floor(fiscalMonth / 3) * 3;
- *     const adjustedMonth = (quarterStartMonth - 9 + 12) % 12;
- *
- *     const yearOffset = month < 3 ? -1 : 0;
- *     const year = adapter.getYear(now) + yearOffset;
- *
- *     const start = new Date(year, adjustedMonth, 1);
- *     const end = new Date(year, adjustedMonth + 3, 0);
- *
- *     return {
- *       start: adapter.normalize(start),
- *       end: adapter.normalize(end)
- *     };
- *   }
- * };
- * ```
- *
- * EXAMPLE - Hotel industry preset:
- * ```typescript
- * const checkInWeekPreset: RangePresetPlugin = {
- *   key: 'CHECK_IN_WEEK',
- *   resolve: (clock, adapter) => {
- *     const now = clock.now();
- *     // Hotel check-ins are Friday to Friday
- *     const dayOfWeek = adapter.getDayOfWeek(now);
- *     const daysToFriday = dayOfWeek <= 5 ? 5 - dayOfWeek : 7 - dayOfWeek + 5;
- *
- *     const nextFriday = adapter.addDays(now, daysToFriday);
- *     const followingFriday = adapter.addDays(nextFriday, 7);
- *
- *     return { start: nextFriday, end: followingFriday };
- *   }
- * };
- * ```
- */
-export interface RangePresetPlugin {
-    /**
-     * Unique identifier for the preset
-     *
-     * Convention: SCREAMING_SNAKE_CASE
-     *
-     * Examples:
-     * - Built-in: 'TODAY', 'LAST_7_DAYS', 'THIS_MONTH'
-     * - Fiscal: 'FISCAL_Q1', 'FISCAL_YEAR_TO_DATE'
-     * - Hotel: 'CHECK_IN_WEEK', 'NEXT_30_NIGHTS'
-     * - Logistics: 'SHIPPING_WEEK', 'DELIVERY_WINDOW'
-     */
-    key: string;
-    /**
-     * Resolve the date range for this preset
-     *
-     * MUST use:
-     * - `clock.now()` for current time (SSR-safe, deterministic)
-     * - `adapter.*` for all date operations (timezone-safe)
-     *
-     * MUST NOT use:
-     * - `new Date()` directly (breaks SSR determinism)
-     * - `date.toISOString()` (timezone bugs)
-     * - `date.setDate()` (mutates, use adapter.addDays() instead)
-     *
-     * @param clock - Injected DateClock for SSR-safe time access
-     * @param adapter - Injected DateAdapter for timezone-safe operations
-     * @returns Date range with start and end dates (both inclusive)
-     *
-     * @example
-     * ```typescript
-     * resolve: (clock, adapter) => {
-     *   const now = clock.now();
-     *   const start = adapter.addDays(now, -7);
-     *   const end = adapter.normalize(now);
-     *   return { start, end };
-     * }
-     * ```
-     */
-    resolve(clock: DateClock, adapter: DateAdapter): DateRange;
-}
-/**
- * Type guard to check if object is a valid RangePresetPlugin
- *
- * @param obj - Object to check
- * @returns true if object implements RangePresetPlugin interface
- */
-export declare function isRangePresetPlugin(obj: any): obj is RangePresetPlugin;

package/core/range.validator.d.ts

@@ -1,37 +0,0 @@
-/**
- * Pure validation functions for date ranges
- * No dependencies, no side effects - just logic
- * Perfect for SSR, testing, and reusability
- */
-export interface ValidationResult {
-    valid: boolean;
-    error?: string;
-}
-/**
- * Validate that end date is not before start date
- */
-export declare function validateRangeOrder(start: Date | null, end: Date | null): ValidationResult;
-/**
- * Validate that date is within min/max bounds
- */
-export declare function validateDateBounds(date: Date | null, minDate?: Date, maxDate?: Date): ValidationResult;
-/**
- * Validate that a range is within bounds
- */
-export declare function validateRangeBounds(start: Date | null, end: Date | null, minDate?: Date, maxDate?: Date): ValidationResult;
-/**
- * Check if a date is disabled
- */
-export declare function isDateDisabled(date: Date, disabledDates?: Date[] | ((date: Date) => boolean)): boolean;
-/**
- * Apply bounds to a date (clamp it)
- */
-export declare function applyBounds(date: Date, minDate?: Date, maxDate?: Date): Date;
-/**
- * Parse ISO date string to Date object (deterministic)
- */
-export declare function parseISODate(dateStr: string): Date | null;
-/**
- * Format Date to ISO string (YYYY-MM-DD)
- */
-export declare function formatISODate(date: Date | null): string;

package/core/system-clock.d.ts

@@ -1,13 +0,0 @@
-import { DateClock } from './date-clock';
-import * as i0 from "@angular/core";
-export declare class SystemClock implements DateClock {
-    /**
-     * Returns current system time
-     *
-     * This is the standard behavior for client-side applications.
-     * For SSR, override DATE_CLOCK token with a fixed Date.
-     */
-    now(): Date;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SystemClock, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SystemClock>;
-}

package/date-adapter.d.ts

@@ -1,116 +0,0 @@
-import { InjectionToken } from '@angular/core';
-/**
- * Abstract class for date adapters.
- * Allows the component to work with different date libraries (Date, DayJS, date-fns, Luxon, etc.)
- */
-export declare abstract class DateAdapter<T = any> {
-    /**
-     * Parses a value into a date object
-     * @param value - Value to parse (string, number, or date object)
-     * @returns Parsed date object
-     */
-    abstract parse(value: any): T | null;
-    /**
-     * Formats a date object into a string
-     * @param date - Date object to format
-     * @param format - Optional format string
-     * @returns Formatted date string
-     */
-    abstract format(date: T, format?: string): string;
-    /**
-     * Adds days to a date
-     * @param date - Date object
-     * @param days - Number of days to add (can be negative)
-     * @returns New date object
-     */
-    abstract addDays(date: T, days: number): T;
-    /**
-     * Adds months to a date
-     * @param date - Date object
-     * @param months - Number of months to add (can be negative)
-     * @returns New date object
-     */
-    abstract addMonths(date: T, months: number): T;
-    /**
-     * Gets the year from a date
-     * @param date - Date object
-     * @returns Year number
-     */
-    abstract getYear(date: T): number;
-    /**
-     * Gets the month from a date (0-11)
-     * @param date - Date object
-     * @returns Month number (0-11)
-     */
-    abstract getMonth(date: T): number;
-    /**
-     * Gets the day of month from a date
-     * @param date - Date object
-     * @returns Day of month (1-31)
-     */
-    abstract getDate(date: T): number;
-    /**
-     * Gets the day of week from a date (0-6, Sunday = 0)
-     * @param date - Date object
-     * @returns Day of week (0-6)
-     */
-    abstract getDay(date: T): number;
-    /**
-     * Creates a new date object
-     * @param year - Year
-     * @param month - Month (0-11)
-     * @param date - Day of month (1-31)
-     * @returns New date object
-     */
-    abstract createDate(year: number, month: number, date: number): T;
-    /**
-     * Gets today's date
-     * @returns Today's date object
-     */
-    abstract today(): T;
-    /**
-     * Checks if two dates are the same day
-     * @param a - First date
-     * @param b - Second date
-     * @returns True if same day
-     */
-    abstract isSameDay(a: T | null, b: T | null): boolean;
-    /**
-     * Checks if a date is before another
-     * @param a - First date
-     * @param b - Second date
-     * @returns True if a is before b
-     */
-    abstract isBefore(a: T | null, b: T | null): boolean;
-    /**
-     * Checks if a date is after another
-     * @param a - First date
-     * @param b - Second date
-     * @returns True if a is after b
-     */
-    abstract isAfter(a: T | null, b: T | null): boolean;
-    /**
-     * Checks if a date is between two other dates
-     * @param date - Date to check
-     * @param start - Start date
-     * @param end - End date
-     * @returns True if date is between start and end
-     */
-    abstract isBetween(date: T | null, start: T | null, end: T | null): boolean;
-    /**
-     * Clones a date object
-     * @param date - Date to clone
-     * @returns Cloned date object
-     */
-    abstract clone(date: T): T;
-    /**
-     * Checks if a value is a valid date
-     * @param date - Value to check
-     * @returns True if valid date
-     */
-    abstract isValid(date: any): boolean;
-}
-/**
- * Injection token for DateAdapter
- */
-export declare const DATE_ADAPTER: InjectionToken<DateAdapter<any>>;