@spscommerce/ds-react 8.0.0-rc1 → 8.0.1

package/lib/dateRangePicker/SpsDateRangePicker.d.ts

@@ -4,13 +4,15 @@ import type { SpsGlobalPropTypes } from "../prop-types";
 import type { SpsFormFieldMeta } from "../form/hooks/useSpsForm";
 export declare type SpsDateRangePickerProps = React.PropsWithChildren<SpsGlobalPropTypes & {
     disabled?: boolean;
-    formMeta?: SpsFormFieldMeta<SimpleDateRange | DatePreset | undefined>;
+    formMeta?: SpsFormFieldMeta<SimpleDateRange | DatePreset | null | undefined>;
     maxDate?: SimpleDate;
     minDate?: SimpleDate;
-    onChange?: (newDateRange?: SimpleDateRange | DatePreset) => void;
+    onChange?: (newDateRange?: SimpleDateRange | DatePreset | null, preset?: DatePreset["definition"]) => void;
     presets?: DatePreset[];
+    selectedPreset?: string;
+    onPresetChange?: (newPreset?: string) => void;
     value?: SimpleDateRange | DatePreset;
     showTwoMonths?: boolean;
 }> & React.HTMLAttributes<HTMLInputElement>;
 export declare const DEFAULT_PRESETS: DatePreset[];
-export declare function SpsDateRangePicker({ children, className, disabled, formMeta, id, maxDate, minDate, onChange, presets, value, showTwoMonths, "data-testid": testId, ...rest }: SpsDateRangePickerProps): JSX.Element;
+export declare function SpsDateRangePicker({ children, className, disabled, formMeta, id, maxDate, minDate, onChange, presets, selectedPreset: presetProp, onPresetChange, value, showTwoMonths, "data-testid": testId, ...rest }: SpsDateRangePickerProps): JSX.Element;

package/lib/dateTimeRangePicker/SpsDateTimeRangePicker.d.ts

@@ -0,0 +1,17 @@
+import * as React from "react";
+import type { SimpleMomentRange, SimpleDate, DateTimePreset } from "@spscommerce/ds-shared";
+import type { SpsGlobalPropTypes } from "../prop-types";
+import type { SpsFormFieldMeta } from "../form/hooks/useSpsForm";
+export declare type SpsDateTimeRangePickerProps = React.PropsWithChildren<SpsGlobalPropTypes & {
+    disabled?: boolean;
+    formMeta?: SpsFormFieldMeta<SimpleMomentRange | undefined>;
+    maxDate?: SimpleDate;
+    minDate?: SimpleDate;
+    onChange?: (newDateTimeRange?: SimpleMomentRange) => void;
+    presets?: DateTimePreset[];
+    value?: SimpleMomentRange;
+    showTwoMonths?: boolean;
+    twentyFourHour?: boolean;
+}> & React.HTMLAttributes<HTMLInputElement>;
+export declare const DEFAULT_DATETIME_PRESETS: DateTimePreset[];
+export declare function SpsDateTimeRangePicker({ className, disabled, formMeta, id, maxDate, minDate, onChange, presets, value, showTwoMonths, twentyFourHour, "data-testid": testId, }: SpsDateTimeRangePickerProps): JSX.Element;

package/lib/dateTimeRangePicker/SpsDateTimeRangePicker.examples.d.ts

@@ -0,0 +1,2 @@
+import type { DSReactExamples } from "@spscommerce/ds-shared";
+export declare const SpsDateTimeRangePickerExamples: DSReactExamples;

package/lib/dateTimeRangePicker/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./SpsDateTimeRangePicker";
+export * from "./SpsDateTimeRangePicker.examples";

package/lib/datepicker/SpsDatepicker.d.ts

@@ -4,7 +4,7 @@ import type { SpsGlobalPropTypes } from "../prop-types";
 import type { SpsFormFieldMeta } from "../form/hooks/useSpsForm";
 export declare type SpsDatepickerProps = React.PropsWithChildren<SpsGlobalPropTypes & {
     disabled?: boolean;
-    formMeta?: SpsFormFieldMeta<SimpleDate>;
+    formMeta?: SpsFormFieldMeta<SimpleDate | undefined>;
     maxDate?: SimpleDate;
     minDate?: SimpleDate;
     onChange?: (newDate: SimpleDate) => void;

package/lib/datepicker/SpsDatepickerCalendar.d.ts

@@ -3,6 +3,7 @@ import type { SimpleDate, SimpleDateRange } from "@spscommerce/ds-shared";
 import type { SpsGlobalPropTypes } from "../prop-types";
 export declare type SpsDatepickerCalendarProps = React.PropsWithChildren<SpsGlobalPropTypes & {
     selectedRange?: SimpleDateRange;
+    isOpen?: boolean;
     maxDate?: SimpleDate;
     minDate?: SimpleDate;
     onNewSelection: (date: SimpleDate) => void;

package/lib/datepicker/utils.d.ts

@@ -1,23 +1,33 @@
-import type { SimpleDate, SimpleDateRange, DatePreset } from "@spscommerce/ds-shared";
+import type { SimpleDate, SimpleDateRange, DatePreset, DateTimePreset, SimpleMomentRange } from "@spscommerce/ds-shared";
 import type { Moment } from "moment-timezone";
 export declare const FORMAT = "MM/DD/YYYY";
+export declare const FORMAT_WITH_TIME = "MM/DD/YYYY hh:mm A";
+export declare const FORMAT_WITH_TIME_24 = "MM/DD/YYYY HH:mm";
 export declare const FORMAT_PATTERN: RegExp;
 export declare const SYMBOL_DATE_PARSE_ERROR: unique symbol;
 export declare const SimpleDateUtils: Readonly<{
-    createFrom(input: string | Moment): SimpleDate | null;
+    createFrom(input?: string | Moment | null): SimpleDate | null;
+    createMomentFrom(input: string | Moment | SimpleDate): Moment | null;
     createRangeFrom(input: string): SimpleDateRange | null;
-    isValid(date: SimpleDate): boolean | undefined;
+    isValid(date?: SimpleDate | Moment | null): boolean | undefined;
     nullifyInvalidDate(value: any): SimpleDate | null;
-    toMoment(date: SimpleDate): Moment | null;
-    toString(date: SimpleDate): string;
+    toMoment(date?: Moment | SimpleDate | null): Moment | null;
+    toString(date?: Moment | SimpleDate | null): string;
     toStringRange(dateRange: SimpleDateRange): string;
+    toDateTimeString(dateMoment: Moment | null, twentyFourHourFormat?: boolean): string;
+    toDateTimeStringRange(dateRange: SimpleMomentRange, twentyFourHourFormat?: boolean): string;
     create(): SimpleDate;
     isSameDate(d1: SimpleDate, d2: SimpleDate): boolean;
     isSameMonth(d1: SimpleDate, d2: SimpleDate): boolean;
-    isAfter(date: SimpleDate, referenceDate: SimpleDate): boolean | null;
-    isBefore(date: SimpleDate, referenceDate: SimpleDate): boolean | null;
+    isAfter(date: SimpleDate | Moment | null, referenceDate: SimpleDate | Moment | null): boolean | null;
+    isBefore(date: SimpleDate | Moment | null, referenceDate: SimpleDate | Moment | null): boolean | null;
     isInRange(date: SimpleDate, range: SimpleDateRange, inclusive?: boolean): boolean | 0 | null;
     prevMonth(date: SimpleDate): SimpleDate;
     nextMonth(date: SimpleDate): SimpleDate;
     createRangeFromPreset(preset: DatePreset): SimpleDateRange;
+    createDateTimeRangeFromPreset(preset: DateTimePreset): SimpleMomentRange;
+    splitMomentInDateTimeParts(dateMoment?: Moment | null, twentyFourHourFormat?: boolean): [string, string, string | undefined];
+    getCurrentMoment(): Moment;
+    validateTimeString(timeString?: string, twentyFourHourFormat?: boolean): boolean;
+    padIncompleteTimeString(timeString?: string, twentyFourHourFormat?: boolean): string;
 }>;

package/lib/datepicker/validation.d.ts

@@ -1,10 +1,10 @@
-import type { SimpleDate, SimpleDateRange } from "@spscommerce/ds-shared";
-import type { Duration } from "moment-timezone";
+import type { SimpleDate, SimpleDateRange, SimpleMomentRange } from "@spscommerce/ds-shared";
+import type { Duration, Moment } from "moment-timezone";
 import type { SpsValidator, SpsValidatorFactory } from "../form/validation/types";
-export declare const date: SpsValidator<SimpleDate | SimpleDateRange>;
-export declare const dateRange: SpsValidator<SimpleDateRange | Duration>;
+export declare const date: SpsValidator<SimpleDate | SimpleDateRange | Moment | SimpleMomentRange | null>;
+export declare const dateRange: SpsValidator<SimpleDateRange | Duration | SimpleMomentRange>;
 export interface DateConstraintError {
     minExceeded: string | null;
     maxExceeded: string | null;
 }
-export declare const dateConstraint: SpsValidatorFactory<SimpleDate | SimpleDateRange>;
+export declare const dateConstraint: SpsValidatorFactory<SimpleDate | SimpleDateRange | Moment | SimpleMomentRange>;

package/lib/filter-panel/SpsFilterPanelSection.d.ts

@@ -1,11 +1,11 @@
 import * as React from "react";
 import type { SpsGlobalPropTypes } from "../prop-types";
 export declare type SpsFilterPanelSectionProps = React.PropsWithChildren<SpsGlobalPropTypes & {
-    title?: string;
+    title?: string | React.ReactNode;
     expanded?: boolean;
     heightPx?: number;
     heightRem?: number;
     onExpand?: () => void;
     onCollapse?: () => void;
-}> & React.HTMLAttributes<HTMLDivElement>;
+}> & Omit<React.HTMLAttributes<HTMLDivElement>, "title">;
 export declare function SpsFilterPanelSection({ children, className, title, expanded, heightPx, heightRem, onExpand, onCollapse, ...rest }: SpsFilterPanelSectionProps): JSX.Element;

package/lib/form/validation/SpsValidators.d.ts

@@ -12,7 +12,7 @@ export declare const SpsValidators: Readonly<{
     numeric: SpsValidator<string>;
     nonNumeric: SpsValidator<string>;
     OnBlurErrorKeys: Set<string>;
-    date: SpsValidator<import("@spscommerce/ds-shared").SimpleDate | import("@spscommerce/ds-shared").SimpleDateRange>;
-    dateRange: SpsValidator<import("@spscommerce/ds-shared").SimpleDateRange | import("moment").Duration>;
-    dateConstraint: SpsValidatorFactory<import("@spscommerce/ds-shared").SimpleDate | import("@spscommerce/ds-shared").SimpleDateRange>;
+    date: SpsValidator<import("@spscommerce/ds-shared").SimpleDate | import("moment").Moment | import("@spscommerce/ds-shared").SimpleDateRange | import("@spscommerce/ds-shared").SimpleMomentRange | null>;
+    dateRange: SpsValidator<import("@spscommerce/ds-shared").SimpleDateRange | import("@spscommerce/ds-shared").SimpleMomentRange | import("moment").Duration>;
+    dateConstraint: SpsValidatorFactory<import("@spscommerce/ds-shared").SimpleDate | import("moment").Moment | import("@spscommerce/ds-shared").SimpleDateRange | import("@spscommerce/ds-shared").SimpleMomentRange>;
 }>;