impact-nova 2.5.6 → 2.5.8

package/dist/components/forms/date-picker/date-picker.types.d.ts

@@ -1,7 +1,20 @@
 import { InputProps } from '../input/input.types';
-import { MonthSelection, MonthRange, WeekSelection, WeekRange } from '../../data-display/calendar';
+import { MonthRange, MonthSelection, QuarterRange, QuarterSelection, WeekRange, WeekSelection, YearRange, YearSelection, YoYComparison } from '../../data-display/calendar';
 import { DateRange } from 'react-day-picker';
-export interface DatePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+import { FiscalCalendarConfig, Granularity } from '../../../lib/fiscal-calendar';
+export interface FiscalPickerProps {
+    calendarKind?: "gregorian" | "fiscal";
+    fiscalMode?: "basic" | "advanced" | "custom";
+    granularity?: Granularity;
+    fiscalMonthPattern?: number[];
+    fiscalYearStartMonth?: number;
+    fiscalConfig?: FiscalCalendarConfig;
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    showPresets?: boolean;
+    comparison?: "prior-fy";
+    onComparisonChange?: (value: YoYComparison | undefined) => void;
+}
+export interface DatePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: Date;
     onChange?: (date: Date | undefined) => void;
     format?: string;
@@ -14,7 +27,7 @@ export interface DatePickerProps extends Omit<InputProps, 'value' | 'onChange' |
     /** Which day the week starts on. 0 = Sunday, 1 = Monday, etc. */
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
 }
-export interface DateRangePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+export interface DateRangePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: DateRange;
     onChange?: (range: DateRange | undefined) => void;
     format?: string;
@@ -25,10 +38,13 @@ export interface DateRangePickerProps extends Omit<InputProps, 'value' | 'onChan
     startMonth?: Date;
     endMonth?: Date;
     showFooter?: boolean;
+    /** Date selection mode. Default: "range". */
+    mode?: "range" | "multi-range";
+    onRangesChange?: (ranges: DateRange[] | undefined) => void;
     /** Which day the week starts on. 0 = Sunday, 1 = Monday, etc. */
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
 }
-export interface MonthPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+export interface MonthPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: MonthSelection;
     onChange?: (month: MonthSelection | undefined) => void;
     placeholder?: string;
@@ -38,7 +54,7 @@ export interface MonthPickerProps extends Omit<InputProps, 'value' | 'onChange'
     endMonth?: Date;
     showFooter?: boolean;
 }
-export interface MonthRangePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+export interface MonthRangePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: MonthRange;
     onChange?: (range: MonthRange | undefined) => void;
     placeholder?: string;
@@ -49,7 +65,7 @@ export interface MonthRangePickerProps extends Omit<InputProps, 'value' | 'onCha
     showFooter?: boolean;
     displayFormat?: "MM/YYYY" | "YYYY/MM";
 }
-export interface WeekPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+export interface WeekPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: WeekSelection;
     onChange?: (week: WeekSelection | undefined) => void;
     format?: string;
@@ -59,19 +75,8 @@ export interface WeekPickerProps extends Omit<InputProps, 'value' | 'onChange' |
     startMonth?: Date;
     endMonth?: Date;
     showFooter?: boolean;
-    /** Whether to use standard calendar weeks or fiscal weeks. Default: "calendar" */
-    calendarType?: "calendar" | "fiscal";
-    /** Only relevant when calendarType="fiscal". Default: "basic" */
-    fiscalMode?: "basic" | "advanced" | "custom";
-    /** What a click selects. "fiscalMonth" only applies with fiscalMode="advanced"|"custom". Default: "week" */
-    selectionMode?: "week" | "fiscalMonth";
-    /** Array of 12 week-counts per fiscal month, e.g. [4,4,5,4,4,5,4,4,5,4,4,5]. Required for fiscalMode="custom", optional for "advanced" (defaults to 4-4-5). */
-    fiscalMonthPattern?: number[];
-    /** 1-based month where the fiscal year starts. Default: 1 (January) */
-    fiscalYearStartMonth?: number;
-    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
 }
-export interface WeekRangePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+export interface WeekRangePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: WeekRange;
     onChange?: (range: WeekRange | undefined) => void;
     format?: string;
@@ -81,19 +86,8 @@ export interface WeekRangePickerProps extends Omit<InputProps, 'value' | 'onChan
     startMonth?: Date;
     endMonth?: Date;
     showFooter?: boolean;
-    /** Whether to use standard calendar weeks or fiscal weeks. Default: "calendar" */
-    calendarType?: "calendar" | "fiscal";
-    /** Only relevant when calendarType="fiscal". Default: "basic" */
-    fiscalMode?: "basic" | "advanced" | "custom";
-    /** What a click selects. "fiscalMonth" only applies with fiscalMode="advanced"|"custom". Default: "week" */
-    selectionMode?: "week" | "fiscalMonth";
-    /** Array of 12 week-counts per fiscal month, e.g. [4,4,5,4,4,5,4,4,5,4,4,5]. Required for fiscalMode="custom", optional for "advanced" (defaults to 4-4-5). */
-    fiscalMonthPattern?: number[];
-    /** 1-based month where the fiscal year starts. Default: 1 (January) */
-    fiscalYearStartMonth?: number;
-    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
 }
-export interface MultiDatePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+export interface MultiDatePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: Date[];
     onChange?: (dates: Date[] | undefined) => void;
     format?: string;
@@ -104,7 +98,7 @@ export interface MultiDatePickerProps extends Omit<InputProps, 'value' | 'onChan
     endMonth?: Date;
     showFooter?: boolean;
 }
-export interface MultiMonthPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+export interface MultiMonthPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: MonthSelection[];
     onChange?: (months: MonthSelection[] | undefined) => void;
     placeholder?: string;
@@ -114,7 +108,7 @@ export interface MultiMonthPickerProps extends Omit<InputProps, 'value' | 'onCha
     endMonth?: Date;
     showFooter?: boolean;
 }
-export interface MultiWeekPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'> {
+export interface MultiWeekPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
     value?: WeekSelection[];
     onChange?: (weeks: WeekSelection[] | undefined) => void;
     format?: string;
@@ -124,15 +118,68 @@ export interface MultiWeekPickerProps extends Omit<InputProps, 'value' | 'onChan
     startMonth?: Date;
     endMonth?: Date;
     showFooter?: boolean;
-    /** Whether to use standard calendar weeks or fiscal weeks. Default: "calendar" */
-    calendarType?: "calendar" | "fiscal";
-    /** Only relevant when calendarType="fiscal". Default: "basic" */
-    fiscalMode?: "basic" | "advanced" | "custom";
-    /** What a click selects. "fiscalMonth" selects an entire fiscal month block. Default: "week" */
-    selectionMode?: "week" | "fiscalMonth";
-    /** Array of 12 week-counts per fiscal month. Required for fiscalMode="custom", optional for "advanced". */
-    fiscalMonthPattern?: number[];
-    /** 1-based month where the fiscal year starts. Default: 1 (January) */
-    fiscalYearStartMonth?: number;
-    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+}
+export interface QuarterPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
+    value?: QuarterSelection;
+    onChange?: (quarter: QuarterSelection | undefined) => void;
+    placeholder?: string;
+    minDate?: Date;
+    maxDate?: Date;
+    startMonth?: Date;
+    endMonth?: Date;
+    showFooter?: boolean;
+}
+export interface QuarterRangePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
+    value?: QuarterRange;
+    onChange?: (range: QuarterRange | undefined) => void;
+    placeholder?: string;
+    minDate?: Date;
+    maxDate?: Date;
+    startMonth?: Date;
+    endMonth?: Date;
+    showFooter?: boolean;
+}
+export interface YearPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
+    value?: YearSelection;
+    onChange?: (year: YearSelection | undefined) => void;
+    placeholder?: string;
+    minDate?: Date;
+    maxDate?: Date;
+    startMonth?: Date;
+    endMonth?: Date;
+    showFooter?: boolean;
+    /** Show civil/FY start–end under year cells. Default false. */
+    showIntervalCaption?: boolean;
+}
+export interface YearRangePickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
+    value?: YearRange;
+    onChange?: (range: YearRange | undefined) => void;
+    placeholder?: string;
+    minDate?: Date;
+    maxDate?: Date;
+    startMonth?: Date;
+    endMonth?: Date;
+    showFooter?: boolean;
+    showIntervalCaption?: boolean;
+}
+export interface MultiQuarterPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
+    value?: QuarterSelection[];
+    onChange?: (quarters: QuarterSelection[] | undefined) => void;
+    placeholder?: string;
+    minDate?: Date;
+    maxDate?: Date;
+    startMonth?: Date;
+    endMonth?: Date;
+    showFooter?: boolean;
+}
+export interface MultiYearPickerProps extends Omit<InputProps, 'value' | 'onChange' | 'type' | 'suffix' | 'suffixClick'>, FiscalPickerProps {
+    value?: YearSelection[];
+    onChange?: (years: YearSelection[] | undefined) => void;
+    placeholder?: string;
+    minDate?: Date;
+    maxDate?: Date;
+    startMonth?: Date;
+    endMonth?: Date;
+    showFooter?: boolean;
+    showIntervalCaption?: boolean;
 }