@oneluiz/dual-datepicker 3.5.1 → 3.6.0

package/core/built-in-presets.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Built-in Date Range Preset Plugins
+ *
+ * Version: 3.6.0
+ *
+ * Standard presets provided by the library.
+ * All presets use DateClock and DateAdapter for SSR-safety and timezone-safety.
+ *
+ * PRESETS INCLUDED:
+ * - TODAY, YESTERDAY
+ * - LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_60_DAYS, LAST_90_DAYS
+ * - THIS_WEEK, LAST_WEEK
+ * - THIS_MONTH, LAST_MONTH, MONTH_TO_DATE
+ * - THIS_QUARTER, LAST_QUARTER, QUARTER_TO_DATE
+ * - THIS_YEAR, LAST_YEAR, YEAR_TO_DATE
+ */
+import { RangePresetPlugin } from './range-preset.plugin';
+/**
+ * TODAY - Current day
+ */
+export declare const TODAY_PRESET: RangePresetPlugin;
+/**
+ * YESTERDAY - Previous day
+ */
+export declare const YESTERDAY_PRESET: RangePresetPlugin;
+/**
+ * LAST_7_DAYS - Last 7 days including today
+ */
+export declare const LAST_7_DAYS_PRESET: RangePresetPlugin;
+/**
+ * LAST_14_DAYS - Last 14 days including today
+ */
+export declare const LAST_14_DAYS_PRESET: RangePresetPlugin;
+/**
+ * LAST_30_DAYS - Last 30 days including today
+ */
+export declare const LAST_30_DAYS_PRESET: RangePresetPlugin;
+/**
+ * LAST_60_DAYS - Last 60 days including today
+ */
+export declare const LAST_60_DAYS_PRESET: RangePresetPlugin;
+/**
+ * LAST_90_DAYS - Last 90 days including today
+ */
+export declare const LAST_90_DAYS_PRESET: RangePresetPlugin;
+/**
+ * THIS_WEEK - Current week (Monday to Sunday)
+ */
+export declare const THIS_WEEK_PRESET: RangePresetPlugin;
+/**
+ * LAST_WEEK - Previous week (Monday to Sunday)
+ */
+export declare const LAST_WEEK_PRESET: RangePresetPlugin;
+/**
+ * THIS_MONTH - Current calendar month (1st to last day)
+ */
+export declare const THIS_MONTH_PRESET: RangePresetPlugin;
+/**
+ * LAST_MONTH - Previous calendar month
+ */
+export declare const LAST_MONTH_PRESET: RangePresetPlugin;
+/**
+ * MONTH_TO_DATE - From start of current month to today
+ */
+export declare const MONTH_TO_DATE_PRESET: RangePresetPlugin;
+/**
+ * THIS_QUARTER - Current quarter (Q1: Jan-Mar, Q2: Apr-Jun, Q3: Jul-Sep, Q4: Oct-Dec)
+ */
+export declare const THIS_QUARTER_PRESET: RangePresetPlugin;
+/**
+ * LAST_QUARTER - Previous quarter
+ */
+export declare const LAST_QUARTER_PRESET: RangePresetPlugin;
+/**
+ * QUARTER_TO_DATE - From start of current quarter to today
+ */
+export declare const QUARTER_TO_DATE_PRESET: RangePresetPlugin;
+/**
+ * THIS_YEAR - Current calendar year (Jan 1 to Dec 31)
+ */
+export declare const THIS_YEAR_PRESET: RangePresetPlugin;
+/**
+ * LAST_YEAR - Previous calendar year
+ */
+export declare const LAST_YEAR_PRESET: RangePresetPlugin;
+/**
+ * YEAR_TO_DATE - From start of current year to today
+ */
+export declare const YEAR_TO_DATE_PRESET: RangePresetPlugin;
+/**
+ * All built-in presets as an array
+ *
+ * Use this to register all built-in presets at once:
+ * ```typescript
+ * BUILT_IN_PRESETS.forEach(preset => registry.register(preset));
+ * ```
+ */
+export declare const BUILT_IN_PRESETS: RangePresetPlugin[];

package/core/index.d.ts

@@ -1,5 +1,12 @@
 /**
  * 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
+ *
  * Import from here for clean barrel exports
  */
 export * from './dual-date-range.store';
@@ -9,3 +16,7 @@ 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';

package/core/preset-providers.d.ts

@@ -0,0 +1,176 @@
+/**
+ * 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;

package/core/preset-registry.d.ts

@@ -0,0 +1,181 @@
+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,4 +1,8 @@
 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
@@ -14,59 +18,91 @@ export interface PresetRange {
     end: string;
 }
 /**
- * Registry of built-in presets
- * Can be extended by consumers
+ * Preset Engine - Plugin-Driven Architecture
  *
- * SSR-Safe Architecture:
- * - Injects DateClock via DI
- * - All presets use clock.now() instead of new Date()
- * - Deterministic: same clock.now() → same preset
- * - Override DATE_CLOCK token in SSR to ensure consistency
+ * 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
  *
- * Timezone-Safe Architecture:
- * - Injects DateAdapter via DI
- * - All date operations use adapter methods
- * - Prevents timezone bugs in cross-timezone scenarios
- * - Override DATE_ADAPTER for Luxon/DayJS/custom implementations
+ * 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 presets;
     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
      *
-     * SSR Note: Uses injected DateClock for deterministic resolution
-     * Timezone Note: Uses injected DateAdapter for consistent date operations
+     * Plugin Architecture:
+     * 1. Looks up plugin in PresetRegistry
+     * 2. Calls plugin.resolve(clock, adapter)
+     * 3. Returns ISO date range
      *
-     * Override tokens in SSR scenarios:
-     * - DATE_CLOCK: Control current time
-     * - DATE_ADAPTER: Control date operations (e.g., Luxon for timezone support)
+     * 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[];
     /**
-     * Register all built-in presets
+     * Check if a preset exists
      *
-     * All presets now use DateAdapter for timezone-safe operations
+     * @param key - Preset key to check
+     * @returns true if preset is registered
      */
-    private registerBuiltInPresets;
+    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;