@elliemae/ds-controlled-form 2.4.1-rc.6 → 2.4.1

package/esm/date-time-picker/config/useGetFlags.js

@@ -0,0 +1,165 @@
+import 'core-js/modules/esnext.async-iterator.filter.js';
+import 'core-js/modules/esnext.iterator.constructor.js';
+import 'core-js/modules/esnext.iterator.filter.js';
+import 'core-js/modules/esnext.async-iterator.for-each.js';
+import 'core-js/modules/esnext.iterator.for-each.js';
+import _defineProperty from '@babel/runtime/helpers/esm/defineProperty';
+import { useMemo } from 'react';
+import { CONTROLLED_DATE_TIME_PICKER_TYPES } from '../ControlledDateTimePickerTypes.js';
+import { getIsDateTime, getIsDate } from '../utils/typeGuards.js';
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+const getDateTimeFlags = props => {
+  const {
+    type,
+    isClearable,
+    dateTime,
+    autoFocus
+  } = props;
+  const constants = {
+    hideDatePicker: true,
+    hideTimePicker: true,
+    isDateSelector: false,
+    isTimeSelector: false,
+    isDateTimeSelector: true,
+    isWithDateInputsOnly: false,
+    isWithTimeInputsOnly: false,
+    autoFocusHourInput: false,
+    autoFocusHourTimeWheel: false
+  };
+  const withAnyInputs = type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.FULL || type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.INPUTS;
+  const hideDateTimePicker = type !== CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.FULL && type !== CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.PICKER && type !== CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.CONTROLLER_ONLY;
+  const isControllerOnly = type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.CONTROLLER_ONLY;
+  const withAnyPicker = !hideDateTimePicker;
+  const withClearBtn = withAnyInputs && isClearable && dateTime !== '' && dateTime !== '__/__/____ __:__ __';
+  const shouldPreserveClearableSpace = isClearable && withAnyInputs;
+
+  const finalFlags = _objectSpread({
+    hideDate: !withAnyInputs,
+    hideTime: !withAnyInputs,
+    hideDateTimePicker,
+    isControllerOnly,
+    isWithTimeWheelToo: !hideDateTimePicker,
+    isWithCalendarToo: !hideDateTimePicker,
+    withAnyInputs,
+    withAnyPicker,
+    withClearBtn,
+    isWithDateInputs: withAnyInputs,
+    isWithTimeInputs: withAnyInputs,
+    autoFocusMonthInput: withAnyInputs && autoFocus,
+    autoFocusPrevMonthArrow: isControllerOnly && autoFocus,
+    shouldPreserveClearableSpace,
+    withAnyRightController: withAnyPicker || withClearBtn || shouldPreserveClearableSpace
+  }, constants);
+
+  return finalFlags;
+};
+
+const getDateFlags = props => {
+  const {
+    type,
+    isClearable,
+    date,
+    autoFocus
+  } = props;
+  const constants = {
+    isDateSelector: true,
+    hideTime: true,
+    hideDateTimePicker: true,
+    hideTimePicker: true,
+    isTimeSelector: false,
+    isDateTimeSelector: false,
+    isWithCalendarToo: false,
+    isWithTimeWheelToo: false,
+    isWithTimeInputs: false,
+    isWithTimeInputsOnly: false,
+    autoFocusHourTimeWheel: false,
+    autoFocusHourInput: false
+  };
+  const withAnyInputs = type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.FULL || type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.INPUTS;
+  const hideDatePicker = type !== CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.FULL && type !== CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.PICKER && type !== CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.CONTROLLER_ONLY;
+  const isControllerOnly = type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.CONTROLLER_ONLY;
+  const withAnyPicker = !hideDatePicker;
+  const withClearBtn = withAnyInputs && isClearable && date !== '' && date !== '__/__/____';
+  const shouldPreserveClearableSpace = isClearable && withAnyInputs;
+
+  const finalFlags = _objectSpread({
+    hideDate: !withAnyInputs,
+    hideDatePicker,
+    isControllerOnly,
+    withAnyInputs,
+    withAnyPicker,
+    withClearBtn,
+    isWithDateInputs: withAnyInputs,
+    isWithDateInputsOnly: withAnyInputs,
+    autoFocusMonthInput: withAnyInputs && autoFocus,
+    autoFocusPrevMonthArrow: isControllerOnly && autoFocus,
+    shouldPreserveClearableSpace,
+    withAnyRightController: withAnyPicker || withClearBtn || shouldPreserveClearableSpace
+  }, constants);
+
+  return finalFlags;
+};
+
+const getTimeFlags = props => {
+  const {
+    type,
+    isClearable,
+    time,
+    autoFocus
+  } = props;
+  const constants = {
+    hideDate: true,
+    hideDateTimePicker: true,
+    hideDatePicker: true,
+    isDateSelector: false,
+    isDateTimeSelector: false,
+    isWithDateInputs: false,
+    isWithDateInputsOnly: false,
+    isTimeSelector: true,
+    isWithTimeWheelToo: false,
+    isWithCalendarToo: false,
+    autoFocusMonthInput: false,
+    autoFocusPrevMonthArrow: false
+  };
+  const withAnyInputs = type === CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.FULL || type === CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.INPUTS;
+  const hideTimePicker = type !== CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.FULL && type !== CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.PICKER && type !== CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.CONTROLLER_ONLY;
+  const isControllerOnly = type === CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.CONTROLLER_ONLY;
+  const withClearBtn = withAnyInputs && isClearable && time !== '' && time !== '__:__ __';
+  const shouldPreserveClearableSpace = isClearable && withAnyInputs;
+  const withAnyPicker = !hideTimePicker;
+
+  const finalFlags = _objectSpread({
+    hideTime: !withAnyInputs,
+    hideTimePicker,
+    isControllerOnly,
+    withAnyInputs,
+    withAnyPicker,
+    withClearBtn,
+    isWithTimeInputs: withAnyInputs,
+    isWithTimeInputsOnly: withAnyInputs,
+    autoFocusHourInput: withAnyInputs && autoFocus,
+    autoFocusHourTimeWheel: isControllerOnly && autoFocus,
+    shouldPreserveClearableSpace,
+    withAnyRightController: withAnyPicker || withClearBtn || shouldPreserveClearableSpace
+  }, constants);
+
+  return finalFlags;
+};
+
+const useGetFlags = props => useMemo(() => {
+  if (getIsDateTime(props)) {
+    return getDateTimeFlags(props);
+  }
+
+  if (getIsDate(props)) {
+    return getDateFlags(props);
+  }
+
+  return getTimeFlags(props);
+}, [props]);
+
+export { useGetFlags };

package/esm/date-time-picker/config/useGetPropsBasedOnType.js

@@ -0,0 +1,97 @@
+import { useMemo } from 'react';
+import { getIsDateTime, getIsDate, getIsTime } from '../utils/typeGuards.js';
+
+/* eslint-disable max-lines */
+
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+const noop = () => {};
+
+const defaultReturnFalse = () => false;
+
+const useGetPropsBasedOnType = propsWithDefaults => {
+  const isDateTime = getIsDateTime(propsWithDefaults);
+  const isDate = getIsDate(propsWithDefaults);
+  const isTime = getIsTime(propsWithDefaults);
+  /* -------------------------- -------------- --------------------------*/
+
+  /* -------------------------- DATE OPTIONALS --------------------------*/
+
+  /* -------------------------- -------------- --------------------------*/
+
+  const getIsDisabledDay = (isDateTime || isDate) && propsWithDefaults.getIsDisabledDay ? propsWithDefaults.getIsDisabledDay : defaultReturnFalse;
+  const getIsOutOfRangeDay = (isDateTime || isDate) && propsWithDefaults.getIsOutOfRangeDay ? propsWithDefaults.getIsOutOfRangeDay : defaultReturnFalse;
+  const appOnMonthChange = (isDateTime || isDate) && propsWithDefaults.onMonthChange ? propsWithDefaults.onMonthChange : noop;
+  const appOnDayChange = (isDateTime || isDate) && propsWithDefaults.onDayChange ? propsWithDefaults.onDayChange : noop;
+  const appOnYearChange = (isDateTime || isDate) && propsWithDefaults.onYearChange ? propsWithDefaults.onYearChange : noop;
+  const emptyPickerStartingMonthDefault = "".concat(new Date().getMonth() + 1, "/__/").concat(new Date().getFullYear());
+  const emptyPickerStartingMonth = (isDateTime || isDate) && propsWithDefaults.emptyPickerStartingMonth ? propsWithDefaults.emptyPickerStartingMonth : emptyPickerStartingMonthDefault;
+  const onCalendarOpenFocusedDay = (isDateTime || isDate) && propsWithDefaults.onCalendarOpenFocusedDay ? propsWithDefaults.onCalendarOpenFocusedDay : undefined;
+  /* -------------------------- -------------- --------------------------*/
+
+  /* -------------------------- TIME OPTIONALS --------------------------*/
+
+  /* -------------------------- -------------- --------------------------*/
+
+  const getIsDisabledTime = (isDateTime || isTime) && propsWithDefaults.getIsDisabledTime ? propsWithDefaults.getIsDisabledTime : defaultReturnFalse;
+  const appOnHourChange = (isDateTime || isTime) && propsWithDefaults.onHourChange ? propsWithDefaults.onHourChange : noop;
+  const appOnMinuteChange = (isDateTime || isTime) && propsWithDefaults.onMinuteChange ? propsWithDefaults.onMinuteChange : noop;
+  const appOnMeridiemChange = (isDateTime || isTime) && propsWithDefaults.onMeridiemChange ? propsWithDefaults.onMeridiemChange : noop;
+  const minutesInterval = (isDateTime || isTime) && propsWithDefaults.minutesInterval ? propsWithDefaults.minutesInterval : 1;
+  const onTimeWheelOpenStartingTime = (isDateTime || isTime) && propsWithDefaults.onTimeWheelOpenStartingTime ? propsWithDefaults.onTimeWheelOpenStartingTime : '01:00 AM';
+  /* --------- ------------------------------------ ---------------------*/
+
+  /* --------- SPECIFIC REQUIRED DATETIME OPTIONALS ---------------------*/
+
+  /* --------- ------------------------------------ ---------------------*/
+
+  const appOnDateChange = (isDateTime || isDate) && propsWithDefaults.onDateChange ? propsWithDefaults.onDateChange : noop;
+  const appOnTimeChange = (isDateTime || isTime) && propsWithDefaults.onTimeChange ? propsWithDefaults.onTimeChange : noop;
+  /* ---------------------- ---------------------- ----------------------*/
+
+  /* ---------------------- DATE-RELATED OPTIONALS ----------------------*/
+
+  /* ---------------------- ---------------------- ----------------------*/
+
+  const getIsStartRangeDay = (isDateTime || isDate) && propsWithDefaults.getIsStartRangeDay ? propsWithDefaults.getIsStartRangeDay : noop;
+  const getIsDayInRange = (isDateTime || isDate) && propsWithDefaults.getIsDayInRange ? propsWithDefaults.getIsDayInRange : noop;
+  const getIsEndRangeDay = (isDateTime || isDate) && propsWithDefaults.getIsEndRangeDay ? propsWithDefaults.getIsEndRangeDay : noop;
+  /* --------------------- ----------------------- ------------------------*/
+
+  /* --------------------- TYPE SPECIFIC REQUIREDS ------------------------*/
+
+  /* --------------------- ----------------------- ------------------------*/
+
+  const appDate = isDate ? propsWithDefaults.date : '';
+  const appTime = isTime ? propsWithDefaults.time : '';
+  const appDateTime = isDateTime ? propsWithDefaults.dateTime : '';
+  const appOnDateTimeChange = isDateTime ? propsWithDefaults.onDateTimeChange : noop;
+  return useMemo(() => ({
+    getIsDisabledDay,
+    getIsOutOfRangeDay,
+    getIsStartRangeDay,
+    getIsDayInRange,
+    getIsEndRangeDay,
+    appOnDateChange,
+    appOnMonthChange,
+    appOnDayChange,
+    appOnYearChange,
+    appDate,
+    getIsDisabledTime,
+    appOnTimeChange,
+    appOnHourChange,
+    appOnMinuteChange,
+    appOnMeridiemChange,
+    appTime,
+    appDateTime,
+    appOnDateTimeChange,
+    emptyPickerStartingMonth,
+    onCalendarOpenFocusedDay,
+    minutesInterval,
+    onTimeWheelOpenStartingTime,
+    isDate,
+    isTime,
+    isDateTime
+  }), [getIsDisabledDay, getIsOutOfRangeDay, getIsStartRangeDay, getIsDayInRange, getIsEndRangeDay, appOnDateChange, appOnMonthChange, appOnDayChange, appOnYearChange, appDate, getIsDisabledTime, appOnTimeChange, appOnHourChange, appOnMinuteChange, appOnMeridiemChange, appTime, appDateTime, appOnDateTimeChange, emptyPickerStartingMonth, onCalendarOpenFocusedDay, minutesInterval, onTimeWheelOpenStartingTime, isDate, isTime, isDateTime]);
+};
+
+export { useGetPropsBasedOnType };

package/esm/date-time-picker/config/useGetPropsWithDefault.js

@@ -1,7 +1,6 @@
 import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';
-import { defaultProps } from '../ControlledDateTimePickerCTX.js';
+import { defaultProps } from '../propTypes.js';
 
-// we have to merge the "default" nested default values with what the user gives us...
 const useGetDatePickerWithDefaultsProps = props => useMemoMergePropsWithDefault(props, defaultProps);
 
 export { useGetDatePickerWithDefaultsProps };

package/esm/date-time-picker/config/useGetReferences.js

@@ -0,0 +1,82 @@
+import { useRef, useMemo } from 'react';
+
+/* eslint-disable complexity */
+const useGetReferences = _ref => {
+  let {
+    isWithDateInputs,
+    isWithTimeInputs,
+    withAnyPicker,
+    withClearBtn
+  } = _ref;
+  // refs are used for "auto-advance" feature
+  const monthInputRef = useRef(null);
+  const dayInputRef = useRef(null);
+  const yearInputRef = useRef(null);
+  const hourInputRef = useRef(null);
+  const minutesInputRef = useRef(null);
+  const meridiemInputRef = useRef(null);
+  const clearButtonRef = useRef(null);
+  const pickerButtonRef = useRef(null);
+  const prevYearBtnRef = useRef(null);
+  const prevMonthBtnRef = useRef(null);
+  const nextMonthBtnRef = useRef(null);
+  const nextYearBtnRef = useRef(null);
+  const calendarDaysWrapperRef = useRef(null);
+  const prevHourBtnRef = useRef(null);
+  const currHourBtnRef = useRef(null);
+  const nextHourBtnRef = useRef(null);
+  const prevMinutesBtnRef = useRef(null);
+  const currMinutesBtnRef = useRef(null);
+  const nextMinutesBtnRef = useRef(null);
+  const prevMeridiemBtnRef = useRef(null);
+  const currMeridiemBtnRef = useRef(null);
+  const nextMeridiemBtnRef = useRef(null);
+  let firstSegmentRef = useRef(null);
+  if (isWithDateInputs) firstSegmentRef = monthInputRef;else if (isWithTimeInputs) firstSegmentRef = hourInputRef;else if (withAnyPicker) firstSegmentRef = pickerButtonRef; // we need some non-ref to force refresh of the hooks dependencies when using firstSegmentRef
+
+  const firstFragmentRefUpdateDeps = useMemo(() => ({
+    isWithDateInputs,
+    isWithTimeInputs,
+    withAnyPicker
+  }), [isWithDateInputs, isWithTimeInputs, withAnyPicker]);
+  let lastSegmentRef = useRef(null);
+  if (withAnyPicker) lastSegmentRef = pickerButtonRef;else if (withClearBtn) lastSegmentRef = clearButtonRef;else if (isWithTimeInputs) lastSegmentRef = meridiemInputRef;else if (isWithDateInputs) lastSegmentRef = yearInputRef; // we need some non-ref to force refresh of the hooks dependencies when using lastSegmentRef
+
+  const lastFragmentRefUpdateDeps = useMemo(() => ({
+    withAnyPicker,
+    withClearBtn,
+    isWithTimeInputs,
+    isWithDateInputs
+  }), [isWithDateInputs, isWithTimeInputs, withAnyPicker, withClearBtn]);
+  return useMemo(() => ({
+    monthInputRef,
+    dayInputRef,
+    yearInputRef,
+    hourInputRef,
+    minutesInputRef,
+    meridiemInputRef,
+    clearButtonRef,
+    pickerButtonRef,
+    prevYearBtnRef,
+    prevMonthBtnRef,
+    nextMonthBtnRef,
+    nextYearBtnRef,
+    calendarDaysWrapperRef,
+    prevHourBtnRef,
+    currHourBtnRef,
+    nextHourBtnRef,
+    prevMinutesBtnRef,
+    currMinutesBtnRef,
+    nextMinutesBtnRef,
+    prevMeridiemBtnRef,
+    currMeridiemBtnRef,
+    nextMeridiemBtnRef,
+    firstSegmentRef,
+    lastSegmentRef,
+    firstFragmentRefUpdateDeps,
+    lastFragmentRefUpdateDeps
+  }), [firstFragmentRefUpdateDeps, lastFragmentRefUpdateDeps] // if we remove this last/first segment won't work
+  );
+};
+
+export { useGetReferences };

package/esm/date-time-picker/config/useGlobalKeyHandlers.js

@@ -0,0 +1,98 @@
+import 'core-js/modules/esnext.async-iterator.filter.js';
+import 'core-js/modules/esnext.iterator.constructor.js';
+import 'core-js/modules/esnext.iterator.filter.js';
+import 'core-js/modules/esnext.async-iterator.for-each.js';
+import 'core-js/modules/esnext.iterator.for-each.js';
+import _defineProperty from '@babel/runtime/helpers/esm/defineProperty';
+import { useCallback, useMemo } from 'react';
+import { getDateStringFromDay, getTimeStringFromDay, getValidationDateStringMetaInfo } from '../utils/dateHelpers.js';
+import { getValidationTimeStringMetaInfo } from '../utils/timeHelpers.js';
+import { deconstructValuesFromDateString, deconstructValuesFromTimeString } from '../utils/stringHelpers.js';
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+const useGlobalKeyHandlers = _ref => {
+  let {
+    propsBasedOnType,
+    changeHandlers,
+    DOMRefs,
+    flags
+  } = _ref;
+  const {
+    getIsOutOfRangeDay,
+    getIsDisabledDay,
+    getIsDisabledTime,
+    appOnMonthChange,
+    appOnDayChange,
+    appOnYearChange,
+    appOnHourChange,
+    appOnMinuteChange,
+    appOnMeridiemChange
+  } = propsBasedOnType;
+  const {
+    handleChangeComposedDateTimeString,
+    handleClearAll
+  } = changeHandlers;
+  const {
+    lastSegmentRef,
+    clearButtonRef
+  } = DOMRefs;
+  const {
+    shouldPreserveClearableSpace
+  } = flags;
+  const onFillWithCurrentDateKeys = useCallback(function (e) {
+    let metaInfo = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+      isAutomaticFillTrigger: true
+    };
+    const now = new Date();
+    const nowDateString = getDateStringFromDay(now);
+    const nowTimeString = getTimeStringFromDay(now);
+
+    const finalMetaInfo = _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, metaInfo), getValidationDateStringMetaInfo(nowDateString, getIsOutOfRangeDay, getIsDisabledDay)), getValidationTimeStringMetaInfo(nowTimeString, getIsDisabledTime)), {}, {
+      newDateString: nowDateString
+    });
+
+    const {
+      month,
+      day,
+      year
+    } = deconstructValuesFromDateString(nowDateString);
+    appOnMonthChange(month, e, metaInfo);
+    appOnDayChange(day, e, metaInfo);
+    appOnYearChange(year, e, metaInfo);
+    const {
+      hours,
+      minutes,
+      meridiem
+    } = deconstructValuesFromTimeString(nowTimeString);
+    appOnHourChange(hours, e, metaInfo);
+    appOnMinuteChange(minutes, e, metaInfo);
+    appOnMeridiemChange(meridiem, e, metaInfo);
+    handleChangeComposedDateTimeString(nowDateString, nowTimeString, finalMetaInfo);
+    setTimeout(() => {
+      var _clearButtonRef$curre, _lastSegmentRef$curre;
+
+      if (shouldPreserveClearableSpace) (_clearButtonRef$curre = clearButtonRef.current) === null || _clearButtonRef$curre === void 0 ? void 0 : _clearButtonRef$curre.focus();else (_lastSegmentRef$curre = lastSegmentRef.current) === null || _lastSegmentRef$curre === void 0 ? void 0 : _lastSegmentRef$curre.focus();
+    });
+  }, [appOnDayChange, appOnHourChange, appOnMeridiemChange, appOnMinuteChange, appOnMonthChange, appOnYearChange, clearButtonRef, getIsDisabledDay, getIsDisabledTime, getIsOutOfRangeDay, handleChangeComposedDateTimeString, lastSegmentRef, shouldPreserveClearableSpace]);
+  const onGlobalKeyDown = useCallback(e => {
+    const {
+      key,
+      ctrlKey,
+      metaKey
+    } = e;
+
+    if ((ctrlKey || metaKey) && key === ';') {
+      onFillWithCurrentDateKeys(e);
+    }
+
+    if ((ctrlKey || metaKey) && (key === 'Delete' || key === 'Backspace')) handleClearAll(e);
+  }, [handleClearAll, onFillWithCurrentDateKeys]);
+  return useMemo(() => ({
+    onFillWithCurrentDateKeys,
+    onGlobalKeyDown
+  }), [onFillWithCurrentDateKeys, onGlobalKeyDown]);
+};
+
+export { useGlobalKeyHandlers };

package/esm/date-time-picker/config/useRelevantValueFromProps.js

@@ -0,0 +1,35 @@
+import 'core-js/modules/web.dom-collections.iterator.js';
+import { useMemo, useState } from 'react';
+import { getIsDateTime, getIsDate, getIsTime } from '../utils/typeGuards.js';
+import { dateTimeToDate, dateTimeToTime } from '../utils/stringHelpers.js';
+
+const useRelevantValueFromProps = props => {
+  const dateStringFromProps = useMemo(() => {
+    if (getIsDateTime(props)) return props.dateTime !== '' ? dateTimeToDate(props.dateTime) : '__/__/____';
+    if (getIsDate(props)) return props.date !== '' ? props.date : '__/__/____';
+    return '__/__/____';
+  }, [props]);
+  const timeStringFromProps = useMemo(() => {
+    if (getIsDateTime(props)) return props.dateTime !== '' ? dateTimeToTime(props.dateTime) : '__:__ __';
+    if (getIsTime(props)) return props.time !== '' ? props.time : '__:__ __';
+    return '__:__ __';
+  }, [props]); // don't use tempDateString to trigger useEffect for onDateChange
+  // that is an anti-pattern and leads to a lot of issue
+  // if you don't believe me, check date-time-picker v1 which is doing it
+
+  const [tempDateString, setTempDateString] = useState(dateStringFromProps); // don't use tempTimeString to trigger useEffect for onTimeChange
+  // that is an anti-pattern and leads to a lot of issue
+  // if you don't believe me, check date-time-picker v1 which is doing it
+
+  const [tempTimeString, setTimeString] = useState(timeStringFromProps);
+  return useMemo(() => ({
+    dateStringFromProps,
+    timeStringFromProps,
+    tempDateString,
+    setTempDateString,
+    tempTimeString,
+    setTimeString
+  }), [dateStringFromProps, tempDateString, tempTimeString, timeStringFromProps]);
+};
+
+export { useRelevantValueFromProps };

package/esm/date-time-picker/config/useValidateProps.js

@@ -1,8 +1,8 @@
-import { CONTROLLED_DATE_TIME_PICKER_TYPES } from '../ControlledDateTimePickerTypes.js';
 import { deconstructValuesFromDateString, isValidDateString, dateTimeToDate, isValidTimeString, dateTimeToTime } from '../utils/stringHelpers.js';
 import { convertToPositiveNumberIfPossible } from '../utils/numberHelpers.js';
+import { getIsDateTime, getIsDate, getIsTime } from '../utils/typeGuards.js';
 
-/* eslint-disable max-len */
+/* eslint-disable max-statements */
 const PREPEND = "ControlledDateTimePicker:\n  Invalid configuration detected::\n  \n    ";
 const NOT_A_DEFECT = ''; // '\n\n\t\tThis is not a defect, please check\n\n\t\thttps://qa.dimsum.rd.elliemae.io/?path=/story/components-desktop-components-d-controlledform-date-time-picker--basic\n\n\t\tfor instructions on how to use the component correctly\n\n';
 
@@ -21,15 +21,15 @@ const throwInvalidTimerror = invalidValue => {
 };
 
 const throwUncontrolledDateError = (date, onDateChange) => {
-  throw new Error("".concat(PREPEND, "you are trying to use a date selector while providing a non-string \"date\" or providing a non-function to \"onDateChange\"\n  the full-controlled pattern must be used\n\tcheck https://reactjs.org/docs/forms.html#controlled-components for more informations\n\n  Received:\n    ").concat(date, "(").concat(typeof date, ")\n    ").concat(onDateChange, "(").concat(typeof onDateChange, ")\n  ").concat(NOT_A_DEFECT));
+  throw new Error("".concat(PREPEND, "you are trying to use a date selector while providing a non-string \"date\" or providing a non-function to \"onDateChange\"\n  the full-controlled pattern must be used\n\tcheck https://reactjs.org/docs/forms.html#controlled-components for more informations\n\n  Received:\n    date: ").concat(date, "(").concat(typeof date, ")\n    onDateChange: (").concat(typeof onDateChange, ")\n  ").concat(NOT_A_DEFECT));
 };
 
 const throwUncontrolledTimeError = (time, onTimeChange) => {
-  throw new Error("".concat(PREPEND, "you are trying to use a time selector while providing a non-string \"time\" or providing a non-function to \"onTimeChange\"\n  the full-controlled pattern must be used\n\tcheck https://reactjs.org/docs/forms.html#controlled-components for more informations\n\n  Received:\n    ").concat(time, "(").concat(typeof time, ")\n    ").concat(onTimeChange, "(").concat(typeof onTimeChange, ")\n  ").concat(NOT_A_DEFECT));
+  throw new Error("".concat(PREPEND, "you are trying to use a time selector while providing a non-string \"time\" or providing a non-function to \"onTimeChange\"\n  the full-controlled pattern must be used\n\tcheck https://reactjs.org/docs/forms.html#controlled-components for more informations\n\n  Received:\n    time: ").concat(time, "(").concat(typeof time, ")\n    onTimeChange: (").concat(typeof onTimeChange, ")\n  ").concat(NOT_A_DEFECT));
 };
 
 const throwUncontrolledDateTimeError = (dateTime, onDateTimeChange) => {
-  throw new Error("".concat(PREPEND, "you are trying to use a date-time selector while providing a non-string \"dateTime\" or providing a non-function to \"onDateTimeChange\"\n  the full-controlled pattern must be used\n\tcheck https://reactjs.org/docs/forms.html#controlled-components for more informations\n\n  Received:\n    ").concat(dateTime, "(").concat(typeof dateTime, ")\n    ").concat(onDateTimeChange, "(").concat(typeof onDateTimeChange, ")\n  ").concat(NOT_A_DEFECT));
+  throw new Error("".concat(PREPEND, "you are trying to use a date-time selector while providing a non-string \"dateTime\" or providing a non-function to \"onDateTimeChange\"\n  the full-controlled pattern must be used\n\tcheck https://reactjs.org/docs/forms.html#controlled-components for more informations\n\n  Received:\n    dateTime: ").concat(dateTime, "(").concat(typeof dateTime, ")\n    onDateTimeChange: (").concat(typeof onDateTimeChange, ")\n  ").concat(NOT_A_DEFECT));
 };
 
 const throwInvalidEmptyPickerStartingMonthError = emptyPickerStartingMonth => {
@@ -41,55 +41,60 @@ const throwInvalidOnCalendarOpenFocusedDayError = onCalendarOpenFocusedDay => {
 };
 
 const useValidateProps = props => {
-  const {
-    type,
-    dateTime,
-    date,
-    time,
-    onDateChange,
-    onTimeChange,
-    onDateTimeChange,
-    emptyPickerStartingMonth,
-    onCalendarOpenFocusedDay
-  } = props;
-  const isDateSelector = type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.FULL || type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.INPUTS || type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE.PICKER;
-  const isTimeSelector = type === CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.FULL || type === CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.INPUTS || type === CONTROLLED_DATE_TIME_PICKER_TYPES.TIME.PICKER;
-  const isDateTimeSelector = type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.FULL || type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.INPUTS || type === CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.PICKER; // validate generic use-cases
-
-  if (emptyPickerStartingMonth) {
+  // validate date-related props
+  if (getIsDateTime(props) || getIsDate(props)) {
     const {
-      month: stringMonthVal,
-      year: stringYearVal
-    } = deconstructValuesFromDateString(emptyPickerStartingMonth);
-    const monthNum = convertToPositiveNumberIfPossible(stringMonthVal);
-    const yearNum = convertToPositiveNumberIfPossible(stringYearVal);
-    if (monthNum <= 0 || monthNum >= 13 || yearNum <= 0 || yearNum > 9999) throwInvalidEmptyPickerStartingMonthError(emptyPickerStartingMonth);
-  }
-
-  if (onCalendarOpenFocusedDay) {
-    const {
-      month: stringMonthVal,
-      day: stringDayVal,
-      year: stringYearVal
-    } = deconstructValuesFromDateString(onCalendarOpenFocusedDay);
-    const monthNum = convertToPositiveNumberIfPossible(stringMonthVal);
-    const dayNum = convertToPositiveNumberIfPossible(stringDayVal);
-    const yearNum = convertToPositiveNumberIfPossible(stringYearVal);
-    if (monthNum <= 0 || monthNum >= 13 || dayNum <= 0 || dayNum >= 31 || yearNum <= 0 || yearNum > 9999) throwInvalidOnCalendarOpenFocusedDayError(onCalendarOpenFocusedDay);
+      emptyPickerStartingMonth,
+      onCalendarOpenFocusedDay
+    } = props; // validate generic use-cases
+
+    if (emptyPickerStartingMonth) {
+      const {
+        month: stringMonthVal,
+        year: stringYearVal
+      } = deconstructValuesFromDateString(emptyPickerStartingMonth);
+      const monthNum = convertToPositiveNumberIfPossible(stringMonthVal);
+      const yearNum = convertToPositiveNumberIfPossible(stringYearVal);
+      if (monthNum <= 0 || monthNum >= 13 || yearNum <= 0 || yearNum > 9999) throwInvalidEmptyPickerStartingMonthError(emptyPickerStartingMonth);
+    }
+
+    if (onCalendarOpenFocusedDay) {
+      const {
+        month: stringMonthVal,
+        day: stringDayVal,
+        year: stringYearVal
+      } = deconstructValuesFromDateString(onCalendarOpenFocusedDay);
+      const monthNum = convertToPositiveNumberIfPossible(stringMonthVal);
+      const dayNum = convertToPositiveNumberIfPossible(stringDayVal);
+      const yearNum = convertToPositiveNumberIfPossible(stringYearVal);
+      if (monthNum <= 0 || monthNum >= 13 || dayNum <= 0 || dayNum >= 31 || yearNum <= 0 || yearNum > 9999) throwInvalidOnCalendarOpenFocusedDayError(onCalendarOpenFocusedDay);
+    }
   } // validate full datetime cases
 
 
-  if (isDateTimeSelector) {
+  if (getIsDateTime(props)) {
+    const {
+      dateTime,
+      onDateTimeChange
+    } = props;
     if (typeof dateTime !== 'string' || typeof onDateTimeChange !== 'function') throwUncontrolledDateTimeError(dateTime, onDateTimeChange);else if (!isValidDateString(dateTimeToDate(dateTime)) || !isValidTimeString(dateTimeToTime(dateTime))) throwInvalidDateTimeError(dateTimeToTime(dateTime));
   } // validate date-only cases
 
 
-  if (isDateSelector) {
+  if (getIsDate(props)) {
+    const {
+      date,
+      onDateChange
+    } = props;
     if (typeof date !== 'string' || typeof onDateChange !== 'function') throwUncontrolledDateError(date, onDateChange);else if (!isValidDateString(date)) throwInvalidDaterror(date);
   } // validate time-only cases
 
 
-  if (isTimeSelector) {
+  if (getIsTime(props)) {
+    const {
+      time,
+      onTimeChange
+    } = props;
     if (typeof time !== 'string' || typeof onTimeChange !== 'function') throwUncontrolledTimeError(time, onTimeChange);else if (!isValidTimeString(time)) throwInvalidTimerror(time);
   }
 };