carconnect-gatherleads-ui-lib 3.1.1 → 3.1.3

package/dist/carconnect-gatherleads-ui-lib.d.ts

@@ -160,7 +160,7 @@ export declare function cn(...inputs: ClassValue[]): string;
  * @param {string} timeZone - The IANA time zone identifier (e.g., 'America/Guayaquil')
  * @return {Date} A new Date object where the local time matches the target time zone
  */
-export declare const convertToTimeZoneDatePicker: (date: Date, timeZone: DateTimeZoneType) => Date;
+export declare const convertToTimeZoneGatherDatePicker: (date: Date, timeZone: DateTimeZoneType) => Date;
 
 /**
  * Helper para crear columnas tipadas con autocompletado completo.
@@ -269,6 +269,24 @@ export declare const deepClone: (obj: any) => any;
  */
 export declare const deepEqual: (obj1: any, obj2: any) => boolean;
 
+/**
+ * Dropdown Gather Calendar component
+ *
+ * @param {DropdownGatherCalendarProps} props - The props for the DropdownGatherCalendar component.
+ * @returns {React.FC<DropdownGatherCalendarProps>} The DropdownGatherCalendar component.
+ */
+export declare const DropdownGatherCalendar: React_2.ForwardRefExoticComponent<DropdownGatherCalendarProps & React_2.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Props for the DropdownGatherCalendar component.
+ */
+export declare interface DropdownGatherCalendarProps {
+    currentMonth: Date;
+    onMonthChange: (date: Date) => void;
+    classNames?: GatherCalendarProps['classNames'];
+    selectProps?: GatherCalendarProps['selectProps'];
+}
+
 /**
  * Tipo unión de todas las configuraciones de campo posibles
  */
@@ -479,7 +497,7 @@ export declare interface GatherBaseCalendarProps {
      * Callback called when the selected date changes.
      * Always returns a DateRange.
      */
-    onSelect?: (date: DateRange | undefined) => void;
+    onSelect?: (date?: DateRange) => void;
     /** Minimum selectable date */
     minDate?: Date;
     /** Maximum selectable date */
@@ -502,6 +520,13 @@ export declare interface GatherBaseCalendarProps {
      * Props specific to the 'dropdown' layout mode.
      */
     selectProps?: GatherCalendarSelectProps;
+    /**
+     * Number of months to display side by side in range mode.
+     * For single mode, this is always 1.
+     * @default 1 for mobile, 2 for desktop (responsive)
+     * Set to 1 to always show a single calendar even in range mode
+     */
+    numberOfMonths?: number;
 }
 
 /**
@@ -609,8 +634,8 @@ export declare interface GatherCalendarProps extends GatherBaseCalendarProps {
     baseProps?: {
         single?: Omit<DayPickerProps, 'selected' | 'onSelect'>;
         range?: {
-            from: Omit<DayPickerProps, 'selected' | 'onSelect'>;
-            to: Omit<DayPickerProps, 'selected' | 'onSelect'>;
+            from?: Omit<DayPickerProps, 'selected' | 'onSelect'>;
+            to?: Omit<DayPickerProps, 'selected' | 'onSelect'>;
         };
     };
 }
@@ -2720,10 +2745,16 @@ export declare const generateValidationRules: (field: FieldConfig) => Validation
  *
  * @return {number[]} An array of years as numbers, sorted from newest to oldest.
  */
-export declare const generateYearsDatePicker: (pastYearsCount?: number, futureYearsCount?: number) => number[];
+export declare const generateYearsGatherDatePicker: (pastYearsCount?: number, futureYearsCount?: number) => number[];
 
 export declare const getAllPaths: (obj: any, prefix?: string) => string[];
 
+/**
+ * Calculates the exact UTC timestamp corresponding to the start (00:00) or end (23:59)
+ * of a specific day in a specific timezone.
+ */
+export declare const getBoundaryGatherDateInTimeZone: (baseDate: Date, timeZone: DateTimeZoneType, isEnd: boolean) => Date;
+
 /**
  * Determina las clases de layout dinámicamente en base al tipo (`grid`, `horizontal`, `stack`, etc).
  */
@@ -2734,6 +2765,32 @@ export declare const getLayoutClasses: (config: FormConfig) => string;
  */
 export declare const getNestedField: (obj: any, path: string) => any;
 
+/**
+ * Normalizes a date to a custom specific time in the target TimeZone.
+ */
+export declare const getNormalizeCustomGatherDate: (date: Date, options: TimeGatherOptions, timeZone?: DateTimeZoneType) => Date | undefined;
+
+/**
+ * Normalizes a date range (Start of Day -> End of Day).
+ */
+export declare const getNormalizeRangeGatherDate: (range: DateRange, timeZone?: DateTimeZoneType) => {
+    from: Date;
+    to: Date;
+} | undefined;
+
+/**
+ * Specific wrapper for Ecuador Range.
+ */
+export declare const getNormalizeToEcuadorRangeGatherDate: (dateRange: DateRange) => {
+    from: Date;
+    to: Date;
+} | undefined;
+
+/**
+ * Wrapper to normalize a single date to Noon (12:00) in Ecuador time.
+ */
+export declare const getNormalizeToNoonEcuadorGatherDate: (date: Date, options?: TimeGatherOptions) => Date | undefined;
+
 /**
  * Ordena los campos en base al array `orderFields` definido en la config.
  */
@@ -2745,7 +2802,13 @@ export declare const getOrderedFields: (fields: FieldConfig[], orderFields?: str
  * @param {DatePickerMode} mode - The mode of the date picker ('single' or 'range').
  * @return {DatePreset[]} An array of default presets.
  */
-export declare const getPresetsDatePicker: (mode?: DatePickerMode) => DatePreset[];
+export declare const getPresetsGatherDatePicker: (mode?: DatePickerMode) => DatePreset[];
+
+/**
+ * Calculates the exact UTC timestamp corresponding to a SPECIFIC time (e.g., 14:30:00)
+ * on a specific day in a specific timezone.
+ */
+export declare const getSpecificGatherTimeInTimeZone: (baseDate: Date, timeZone: DateTimeZoneType, time: TimeGatherOptions) => Date;
 
 /**
  * Tipo de opción para el componente MultiSelect
@@ -2808,6 +2871,21 @@ export declare interface SortConfig {
     direction: 'asc' | 'desc';
 }
 
+/**
+ * Options for time selection in the date picker.
+ * @interface TimeGatherOptions
+ * @property {number} hour - The hour to select.
+ * @property {number} minute - The minute to select.
+ * @property {number} second - The second to select.
+ * @property {number} millisecond - The millisecond to select.
+ */
+export declare type TimeGatherOptions = {
+    hour?: number;
+    minute?: number;
+    second?: number;
+    millisecond?: number;
+};
+
 /**
  * Props para el hook useModal
  */