ngxsmk-datepicker 1.4.16 → 1.5.0

package/index.d.ts

@@ -2,73 +2,302 @@ import * as i0 from '@angular/core';
 import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 
+/**
+ * Type-safe definitions for ngxsmk-datepicker
+ * Provides strict typing and generic safety for all datepicker configurations
+ */
+/**
+ * Supported datepicker selection modes
+ */
+type DatepickerMode = 'single' | 'range' | 'multiple';
+/**
+ * Generic date input that supports multiple formats
+ * - Native Date object
+ * - ISO 8601 string
+ * - Unix timestamp (number)
+ * - Moment.js objects
+ * - Day.js objects
+ * - date-fns objects
+ */
+type DateInput = Date | string | number | {
+    toDate: () => Date;
+    _isAMomentObject?: boolean;
+} | {
+    $d: Date;
+} | {
+    toISOString: () => string;
+};
+/**
+ * Date range tuple with start and end dates
+ */
+type DateRangeTuple = readonly [DateInput, DateInput];
+/**
+ * Object representation of a date range
+ */
+interface DateRangeObject {
+    readonly start: Date;
+    readonly end: Date;
+}
+/**
+ * Named date ranges for quick selection
+ */
+type DateRanges = Readonly<Record<string, DateRangeTuple>>;
+/**
+ * Mode-specific datepicker values with strict typing
+ */
+type DatepickerValueByMode<T extends DatepickerMode> = T extends 'single' ? Date | null : T extends 'range' ? DateRangeObject | null : T extends 'multiple' ? readonly Date[] | null : never;
+/**
+ * Generic datepicker value (when mode is not known at compile time)
+ */
+type DatepickerValue = Date | DateRangeObject | Date[] | null;
+/**
+ * Holiday provider interface for custom holiday definitions
+ */
+interface HolidayProvider {
+    /**
+     * Check if a given date is a holiday
+     * @param date - Date to check (normalized to start of day)
+     * @returns true if date is a holiday
+     */
+    isHoliday(date: Date): boolean;
+    /**
+     * Get holiday label/name for a given date
+     * @param date - Date to check
+     * @returns Holiday label or null if not a holiday
+     */
+    getHolidayLabel?(date: Date): string | null;
+    /**
+     * Get all holidays for a given year
+     * @param year - Year to get holidays for
+     * @returns Array of holiday dates
+     */
+    getHolidays?(year: number): readonly Date[];
+}
+/**
+ * Highlighted date configuration
+ */
+interface HighlightedDate {
+    readonly date: Date;
+    readonly color: string;
+    readonly label?: string;
+    readonly tooltip?: string;
+}
+/**
+ * Time preset for quick time selection
+ */
+interface TimePreset {
+    readonly label: string;
+    readonly hour: number;
+    readonly minute: number;
+}
+/**
+ * Quick selection button configuration
+ */
+interface QuickButton<T extends DatepickerMode = 'single'> {
+    readonly label: string;
+    getValue(): DatepickerValueByMode<T>;
+}
+/**
+ * Date filter function for custom validation
+ */
+type DateFilter = (date: Date) => boolean;
+/**
+ * Datepicker action event types
+ */
+type DatepickerActionType = 'select' | 'clear' | 'cancel' | 'apply' | 'open' | 'close' | 'monthChange' | 'yearChange';
+/**
+ * Datepicker action event payload
+ */
+interface DatepickerAction<T extends DatepickerMode = DatepickerMode> {
+    readonly type: DatepickerActionType;
+    readonly value?: DatepickerValueByMode<T>;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Min/Max time configuration
+ */
+interface TimeConstraints {
+    readonly hour: number;
+    readonly minute: number;
+}
+/**
+ * Custom error messages configuration
+ */
+interface DatepickerErrorMessages {
+    readonly required?: string;
+    readonly minDate?: string;
+    readonly maxDate?: string;
+    readonly invalidDate?: string;
+    readonly minDays?: string;
+    readonly maxDays?: string;
+    readonly disabledDate?: string;
+}
+/**
+ * Datepicker theme type
+ */
+type DatepickerTheme = 'light' | 'dark' | 'auto';
+/**
+ * Select option for dropdowns
+ */
+interface SelectOption<T = number | string> {
+    readonly label: string;
+    readonly value: T;
+    readonly disabled?: boolean;
+}
+/**
+ * Calendar day cell data
+ */
+interface CalendarDay {
+    readonly date: Date;
+    readonly isCurrentMonth: boolean;
+    readonly isToday: boolean;
+    readonly isWeekend: boolean;
+    readonly isDisabled: boolean;
+    readonly isSelected: boolean;
+    readonly isInRange: boolean;
+    readonly isHoliday: boolean;
+    readonly holidayLabel?: string;
+    readonly highlightColor?: string;
+    readonly highlightLabel?: string;
+}
+/**
+ * Type guard to check if value is a single date
+ */
+declare function isSingleDate(value: DatepickerValue): value is Date;
+/**
+ * Type guard to check if value is a date range
+ */
+declare function isDateRange(value: DatepickerValue): value is DateRangeObject;
+/**
+ * Type guard to check if value is multiple dates
+ */
+declare function isMultipleDates(value: DatepickerValue): value is Date[];
+/**
+ * Type guard to check if date input is a Date object
+ */
+declare function isNativeDate(input: DateInput): input is Date;
+/**
+ * Type guard to check if date input is a string
+ */
+declare function isDateString(input: DateInput): input is string;
+/**
+ * Type guard to check if date input is a number (timestamp)
+ */
+declare function isTimestamp(input: DateInput): input is number;
+/**
+ * Datepicker configuration options (for future use)
+ */
+interface DatepickerConfig<T extends DatepickerMode = 'single'> {
+    readonly mode: T;
+    readonly locale?: string;
+    readonly theme?: DatepickerTheme;
+    readonly inline?: boolean;
+    readonly showTime?: boolean;
+    readonly minDate?: DateInput | null;
+    readonly maxDate?: DateInput | null;
+    readonly disabledDates?: readonly DateInput[];
+    readonly isInvalidDate?: DateFilter;
+    readonly holidayProvider?: HolidayProvider;
+    readonly highlightedDates?: readonly HighlightedDate[];
+    readonly ranges?: DateRanges;
+    readonly placeholder?: string;
+    readonly disabled?: boolean;
+}
+/**
+ * Validation result type
+ */
+interface ValidationResult {
+    readonly valid: boolean;
+    readonly error?: string;
+    readonly errorCode?: string;
+}
+/**
+ * Validation result
+ */
+interface ValidationResult {
+    readonly valid: boolean;
+    readonly error?: string;
+    readonly errorCode?: string;
+}
+/**
+ * Export type for datepicker data
+ */
+type ExportFormat = 'json' | 'csv' | 'ical';
+/**
+ * Export data structure
+ */
+interface ExportData {
+    readonly format: ExportFormat;
+    readonly data: string;
+    readonly timestamp: number;
+}
+
 /**
  * Date utility functions for ngxsmk-datepicker
  * Extracted to improve tree-shaking and reduce bundle size
  */
+
+/**
+ * Get start of day (00:00:00.000)
+ */
 declare function getStartOfDay(d: Date): Date;
+/**
+ * Get end of day (23:59:59.999)
+ */
 declare function getEndOfDay(d: Date): Date;
+/**
+ * Add months to a date
+ */
 declare function addMonths(d: Date, months: number): Date;
+/**
+ * Subtract days from a date
+ */
 declare function subtractDays(d: Date, days: number): Date;
+/**
+ * Get start of month
+ */
 declare function getStartOfMonth(d: Date): Date;
+/**
+ * Get end of month
+ */
 declare function getEndOfMonth(d: Date): Date;
+/**
+ * Check if two dates are on the same day
+ */
 declare function isSameDay(d1: Date | null, d2: Date | null): boolean;
-declare function normalizeDate(date: DateInput | null): Date | null;
-type DateInput = Date | string | {
-    toDate: () => Date;
-    _isAMomentObject?: boolean;
-    $d?: Date;
-};
+/**
+ * Normalize various date input formats to Date object
+ * Supports:
+ * - Date objects
+ * - ISO strings
+ * - Unix timestamps
+ * - Moment.js objects
+ * - Day.js objects
+ */
+declare function normalizeDate(date: DateInput | null | undefined): Date | null;
 
 /**
  * Calendar utility functions for ngxsmk-datepicker
  * Optimized for performance and tree-shaking
  */
 
-interface HolidayProvider {
-    /**
-     * Returns true if the given date is a holiday.
-     * The date passed will be at the start of the day (00:00:00).
-     */
-    isHoliday(date: Date): boolean;
-    /**
-     * Optional: Returns a label or reason for the holiday.
-     */
-    getHolidayLabel?(date: Date): string | null;
-}
 interface DateRange {
     [key: string]: [DateInput, DateInput];
 }
-type DatepickerValue = Date | {
-    start: Date;
-    end: Date;
-} | Date[] | null;
 /**
  * Generate month options for dropdown
  */
-declare function generateMonthOptions(locale: string, year: number): {
-    label: string;
-    value: number;
-}[];
+declare function generateMonthOptions(locale: string, year: number): SelectOption<number>[];
 /**
  * Generate year options for dropdown
  */
-declare function generateYearOptions(currentYear: number, range?: number): {
-    label: string;
-    value: number;
-}[];
+declare function generateYearOptions(currentYear: number, range?: number): SelectOption<number>[];
 /**
  * Generate time options for hour/minute dropdowns
  */
 declare function generateTimeOptions(minuteInterval?: number): {
-    hourOptions: {
-        label: string;
-        value: number;
-    }[];
-    minuteOptions: {
-        label: string;
-        value: number;
-    }[];
+    hourOptions: SelectOption<number>[];
+    minuteOptions: SelectOption<number>[];
 };
 /**
  * Generate week days for calendar header
@@ -252,5 +481,185 @@ declare class CustomSelectComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<CustomSelectComponent, "ngxsmk-custom-select", never, { "options": { "alias": "options"; "required": false; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
-export { CustomSelectComponent, NgxsmkDatepickerComponent, addMonths, generateMonthOptions, generateTimeOptions, generateWeekDays, generateYearOptions, get24Hour, getEndOfDay, getEndOfMonth, getFirstDayOfWeek, getStartOfDay, getStartOfMonth, isSameDay, normalizeDate, processDateRanges, subtractDays, update12HourState };
-export type { DateInput, DateRange, DatepickerValue, HolidayProvider };
+/**
+ * Performance utilities for ngxsmk-datepicker
+ * Optimized for minimal bundle size and tree-shaking
+ */
+declare const createDateComparator: () => (d1: Date | null, d2: Date | null) => boolean;
+
+/**
+ * Week utilities for ngxsmk-datepicker
+ * Lazy-loaded to reduce initial bundle size
+ */
+/**
+ * Get ISO week number
+ */
+declare function getISOWeek(date: Date): number;
+/**
+ * Get week of month
+ */
+declare function getWeekOfMonth(date: Date): number;
+/**
+ * Get date range for a week
+ */
+declare function getWeekRange(date: Date, firstDayOfWeek?: number): {
+    start: Date;
+    end: Date;
+};
+
+/**
+ * Format utilities for ngxsmk-datepicker
+ * Lazy-loaded to reduce initial bundle size
+ */
+/**
+ * Format date with custom format string
+ */
+declare function formatDate(date: Date, format: string, locale?: string): string;
+/**
+ * Parse date from string with format
+ */
+declare function parseDate(dateStr: string, _format?: string): Date | null;
+
+/**
+ * Validation utilities for ngxsmk-datepicker
+ * Lazy-loaded to reduce initial bundle size
+ */
+
+/**
+ * Validate date range
+ */
+declare function validateDateRange(start: Date | null, end: Date | null, minDate?: Date | null, maxDate?: Date | null): ValidationResult;
+/**
+ * Validate min/max days in range
+ */
+declare function validateMinMaxDays(start: Date | null, end: Date | null, minDays?: number, maxDays?: number): ValidationResult;
+/**
+ * Validate working days
+ */
+declare function validateWorkingDays(date: Date, workingDays?: number[]): ValidationResult;
+
+/**
+ * Timezone utilities for ngxsmk-datepicker
+ * Lazy-loaded to reduce initial bundle size
+ */
+/**
+ * Convert date to specific timezone
+ */
+declare function convertToTimezone(date: Date, timezone: string): Date;
+/**
+ * Get timezone offset in minutes
+ */
+declare function getTimezoneOffset(timezone: string): number;
+
+/**
+ * Export/Import utilities for ngxsmk-datepicker
+ * Lazy-loaded to reduce initial bundle size
+ */
+
+/**
+ * Export dates to JSON format
+ */
+declare function exportToJSON(value: DatepickerValue): string;
+/**
+ * Export dates to CSV format
+ */
+declare function exportToCSV(value: DatepickerValue): string;
+/**
+ * Export dates to iCal format
+ */
+declare function exportToICal(value: DatepickerValue, title?: string): string;
+/**
+ * Import dates from JSON format
+ */
+declare function importFromJSON(json: string): DatepickerValue;
+/**
+ * Import dates from CSV format
+ */
+declare function importFromCSV(csv: string): Date[] | null;
+
+/**
+ * Lazy-loaded features for ngxsmk-datepicker
+ * These features are loaded on-demand to reduce initial bundle size
+ */
+/**
+ * Export/Import Feature
+ * Dynamically loaded when export functionality is used
+ */
+declare function loadExportFeature(): Promise<{
+    exportToJSON: typeof exportToJSON;
+    exportToCSV: typeof exportToCSV;
+    exportToICal: typeof exportToICal;
+    importFromJSON: typeof importFromJSON;
+    importFromCSV: typeof importFromCSV;
+}>;
+/**
+ * Timezone Feature
+ * Dynamically loaded when timezone conversion is needed
+ */
+declare function loadTimezoneFeature(): Promise<{
+    convertToTimezone: typeof convertToTimezone;
+    getTimezoneOffset: typeof getTimezoneOffset;
+}>;
+/**
+ * Validation Feature
+ * Dynamically loaded when advanced validation is needed
+ */
+declare function loadValidationFeature(): Promise<{
+    validateDateRange: typeof validateDateRange;
+    validateMinMaxDays: typeof validateMinMaxDays;
+    validateWorkingDays: typeof validateWorkingDays;
+}>;
+/**
+ * Format Feature
+ * Dynamically loaded when custom formatting is needed
+ */
+declare function loadFormatFeature(): Promise<{
+    formatDate: typeof formatDate;
+    parseDate: typeof parseDate;
+}>;
+/**
+ * Week Utilities Feature
+ * Dynamically loaded when week-related calculations are needed
+ */
+declare function loadWeekFeature(): Promise<{
+    getISOWeek: typeof getISOWeek;
+    getWeekOfMonth: typeof getWeekOfMonth;
+    getWeekRange: typeof getWeekRange;
+}>;
+/**
+ * Locale Data Loader
+ * Dynamically loads locale-specific data
+ */
+declare function loadLocaleData(locale: string): Promise<{
+    locale: string;
+    loaded: boolean;
+    weekStart: number;
+}>;
+/**
+ * Feature flags for lazy loading
+ */
+declare const LAZY_FEATURES: {
+    readonly EXPORT: "export";
+    readonly TIMEZONE: "timezone";
+    readonly VALIDATION: "validation";
+    readonly FORMAT: "format";
+    readonly WEEK: "week";
+    readonly LOCALE: "locale";
+};
+type LazyFeature = typeof LAZY_FEATURES[keyof typeof LAZY_FEATURES];
+declare function loadFeature(feature: LazyFeature): Promise<any>;
+/**
+ * Preload specific features
+ */
+declare function preloadFeatures(features: LazyFeature[]): Promise<any[]>;
+/**
+ * Check if feature is loaded
+ */
+declare function isFeatureLoaded(feature: LazyFeature): boolean;
+/**
+ * Clear feature cache (useful for testing or memory management)
+ */
+declare function clearFeatureCache(): void;
+
+export { CustomSelectComponent, LAZY_FEATURES, NgxsmkDatepickerComponent, addMonths, clearFeatureCache, createDateComparator, generateMonthOptions, generateTimeOptions, generateWeekDays, generateYearOptions, get24Hour, getEndOfDay, getEndOfMonth, getFirstDayOfWeek, getStartOfDay, getStartOfMonth, isDateRange, isDateString, isFeatureLoaded, isMultipleDates, isNativeDate, isSameDay, isSingleDate, isTimestamp, loadExportFeature, loadFeature, loadFormatFeature, loadLocaleData, loadTimezoneFeature, loadValidationFeature, loadWeekFeature, normalizeDate, preloadFeatures, processDateRanges, subtractDays, update12HourState };
+export type { CalendarDay, DateFilter, DateInput, DateRange, DateRangeObject, DateRangeTuple, DateRanges, DatepickerAction, DatepickerActionType, DatepickerConfig, DatepickerErrorMessages, DatepickerMode, DatepickerTheme, DatepickerValue, DatepickerValueByMode, ExportData, ExportFormat, HighlightedDate, HolidayProvider, LazyFeature, QuickButton, SelectOption, TimeConstraints, TimePreset, ValidationResult };

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "ngxsmk-datepicker",
-  "version": "1.4.16",
+  "version": "1.5.0",
   "author": {
     "name": "Sachin Dilshan",
     "url": "https://www.linkedin.com/in/sachindilshan/"
   },
   "peerDependencies": {
-    "@angular/common": ">=17.0.0",
-    "@angular/core": ">=17.0.0",
-    "@angular/forms": ">=17.0.0"
+    "@angular/common": ">=17.0.0 <22.0.0",
+    "@angular/core": ">=17.0.0 <22.0.0",
+    "@angular/forms": ">=17.0.0 <22.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"
@@ -18,7 +18,7 @@
   "es2022": "fesm2022/ngxsmk-datepicker.mjs",
   "esm2022": "fesm2022/ngxsmk-datepicker.mjs",
   "types": "index.d.ts",
-  "typings": "index.d.ts",
+  "typings": "types/ngxsmk-datepicker.d.ts",
   "homepage": "https://github.com/toozuuu/ngxsmk-datepicker#readme",
   "repository": {
     "type": "git",
@@ -43,7 +43,11 @@
     "date-range-picker",
     "calendar",
     "standalone-component",
+    "angular-17",
+    "angular-18",
+    "angular-19",
     "angular-20",
+    "angular-21",
     "typescript",
     "date-selection",
     "i18n",
@@ -53,7 +57,7 @@
     ".": {
       "import": "./fesm2022/ngxsmk-datepicker.mjs",
       "require": "./fesm2022/ngxsmk-datepicker.mjs",
-      "types": "./index.d.ts",
+      "types": "./types/ngxsmk-datepicker.d.ts",
       "default": "./fesm2022/ngxsmk-datepicker.mjs"
     },
     "./package.json": {