@elliemae/ds-controlled-form 2.4.0 → 2.4.1-rc.11

package/esm/combobox/utils/listHelper.js

@@ -6,6 +6,8 @@ import 'core-js/modules/esnext.iterator.some.js';
 import 'core-js/modules/esnext.async-iterator.find.js';
 import 'core-js/modules/esnext.iterator.find.js';
 import 'core-js/modules/web.dom-collections.iterator.js';
+import 'core-js/modules/esnext.async-iterator.for-each.js';
+import 'core-js/modules/esnext.iterator.for-each.js';
 import { MENU_OPTION_TYPES } from '../constants.js';
 
 const getSelectableOptions = options => options.filter(option => option.type === MENU_OPTION_TYPES.OPTION && !option.disabled);
@@ -30,15 +32,17 @@ const findInCircularList = function (list, from, criteria) {
 
   return from; // return same item
 };
+const getLastValueSelected = selectedValues => {
+  if (Array.isArray(selectedValues)) {
+    return selectedValues[selectedValues.length - 1];
+  }
+
+  return selectedValues;
+};
 const getFirstOption = (options, selectedValues, inputValue) => {
   if (!inputValue) {
-    if (Array.isArray(selectedValues) && selectedValues.length > 0) {
-      return selectedValues[selectedValues.length - 1].dsId;
-    }
-
-    if (selectedValues !== null && selectedValues !== void 0 && selectedValues.dsId) {
-      return selectedValues.dsId;
-    }
+    const lastValue = getLastValueSelected(selectedValues);
+    if (lastValue) return lastValue.dsId;
   }
 
   for (let i = 0; i < options.length; i += 1) if (!['section', 'separator'].includes(options[i].type) && !options[i].disabled) {
@@ -64,12 +68,34 @@ const getSuggestedValueOnChange = (selectedOption, selectedValues) => {
 
   return selectedOption;
 };
-const getLastValueSelected = selectedValues => {
-  if (Array.isArray(selectedValues)) {
-    return selectedValues[selectedValues.length - 1];
+const filterOptions = (inputValue, options) => options.filter(option => option.type === MENU_OPTION_TYPES.OPTION && option.label.toLowerCase().includes(inputValue.toLowerCase()));
+const selectedValuesWithSections = (optionsToParse, multiSelectedValue) => {
+  var _items2;
+
+  const items = [];
+  if (optionsToParse) optionsToParse.forEach(option => {
+    // const isSelectedValue = multiSelectedValue.find((item) => item?.dsId === option.dsId);
+    if (option.type === MENU_OPTION_TYPES.OPTION && isSelected(multiSelectedValue, option)) {
+      items.push(option);
+    }
+
+    if (option.type === MENU_OPTION_TYPES.SECTION) {
+      var _items;
+
+      if (((_items = items[items.length - 1]) === null || _items === void 0 ? void 0 : _items.type) === MENU_OPTION_TYPES.SECTION) {
+        items[items.length - 1] = option;
+      } else {
+        items.push(option);
+      }
+    }
+  });
+
+  if (((_items2 = items[items.length - 1]) === null || _items2 === void 0 ? void 0 : _items2.type) === MENU_OPTION_TYPES.SECTION) {
+    items.pop();
   }
 
-  return selectedValues;
+  return items;
 };
+const getFilteredOptionsSelected = (filteredOption, selectedValues) => filteredOption.filter(option => option.type === MENU_OPTION_TYPES.OPTION && isSelected(selectedValues, option));
 
-export { findInCircularList, getFirstOption, getLastValueSelected, getOptions, getSelectableOptions, getSuggestedValueOnChange, isSelected, isSelectedValueEmpty, isSelectedValueMultiple };
+export { filterOptions, findInCircularList, getFilteredOptionsSelected, getFirstOption, getLastValueSelected, getOptions, getSelectableOptions, getSuggestedValueOnChange, isSelected, isSelectedValueEmpty, isSelectedValueMultiple, selectedValuesWithSections };

package/esm/date-time-picker/ControlledDateTimePickerCTX.js

@@ -1,120 +1,8 @@
-import { createContext, createRef } from 'react';
-import { CONTROLLED_DATE_TIME_PICKER_TYPES } from './ControlledDateTimePickerTypes.js';
+import { createContext } from 'react';
 
-// eslint-disable-next-line @typescript-eslint/no-empty-function
-const noop = () => {};
-
-const defaultReturnFalse = () => false; // const mockedStringStateSetter: React.Dispatch<React.SetStateAction<string>> = noop;
-
-
-const mockedSetLatestInteractionRegion = noop;
-const defaultProps = {
-  // changing default type requires changing default booleans (hideDate, withAnyInputs, etc...) in the context too
-  type: CONTROLLED_DATE_TIME_PICKER_TYPES.DATE_TIME.FULL,
-  dateTime: '',
-  date: '',
-  time: '',
-  onDateChange: noop,
-  onMonthChange: noop,
-  onDayChange: noop,
-  onYearChange: noop,
-  onTimeChange: noop,
-  onHourChange: noop,
-  onMinuteChange: noop,
-  // onSecondsChange: noop,
-  onMeridiemChange: noop,
-  onDateTimeChange: noop,
-  onPickerOpen: noop,
-  onPickerClose: noop,
-  getIsDisabledDay: defaultReturnFalse,
-  getIsOutOfRangeDay: defaultReturnFalse,
-  getIsStartRangeDay: defaultReturnFalse,
-  getIsDayInRange: defaultReturnFalse,
-  getIsEndRangeDay: defaultReturnFalse,
-  getIsDisabledTime: defaultReturnFalse,
-  emptyPickerStartingMonth: undefined,
-  onCalendarOpenFocusedDay: undefined,
-  minutesInterval: 1,
-  isClearable: false,
-  disabled: false,
-  hasError: false,
-  autoFocus: false,
-  preventCloseOnSelection: false,
-  pickerFooterMsg: undefined
-};
-const defaultContext = {
-  props: defaultProps,
-  monthInputRef: /*#__PURE__*/createRef(),
-  dayInputRef: /*#__PURE__*/createRef(),
-  yearInputRef: /*#__PURE__*/createRef(),
-  hourInputRef: /*#__PURE__*/createRef(),
-  minutesInputRef: /*#__PURE__*/createRef(),
-  // secondsInputRef: createRef<HTMLInputElement>(),
-  meridiemInputRef: /*#__PURE__*/createRef(),
-  clearButtonRef: /*#__PURE__*/createRef(),
-  pickerButtonRef: /*#__PURE__*/createRef(),
-  prevYearBtnRef: /*#__PURE__*/createRef(),
-  prevMonthBtnRef: /*#__PURE__*/createRef(),
-  nextMonthBtnRef: /*#__PURE__*/createRef(),
-  nextYearBtnRef: /*#__PURE__*/createRef(),
-  calendarDaysWrapperRef: /*#__PURE__*/createRef(),
-  prevHourBtnRef: /*#__PURE__*/createRef(),
-  currHourBtnRef: /*#__PURE__*/createRef(),
-  nextHourBtnRef: /*#__PURE__*/createRef(),
-  prevMinutesBtnRef: /*#__PURE__*/createRef(),
-  currMinutesBtnRef: /*#__PURE__*/createRef(),
-  nextMinutesBtnRef: /*#__PURE__*/createRef(),
-  prevMeridiemBtnRef: /*#__PURE__*/createRef(),
-  currMeridiemBtnRef: /*#__PURE__*/createRef(),
-  nextMeridiemBtnRef: /*#__PURE__*/createRef(),
-  firstSegmentRef: /*#__PURE__*/createRef(),
-  lastSegmentRef: /*#__PURE__*/createRef(),
-  ariaCurrentValueForInputs: '',
-  dateStringFromProps: '',
-  tempDateString: '__/__/____',
-  // setDateString: mockedStringStateSetter,
-  tempTimeString: '__:__:__ __',
-  // setTimeString: mockedStringStateSetter,
-  handleChangeComposedDateTimeString: noop,
-  handleChangeComposedDateString: noop,
-  handleChangeComposedTimeString: noop,
-  handleChangeMonth: noop,
-  handleChangeDay: noop,
-  handleChangeYear: noop,
-  handleChangeHours: noop,
-  handleChangeMinutes: noop,
-  handleChangeMeridiem: noop,
-  handleClearAll: noop,
-  hideDate: false,
-  hideTime: false,
-  hideDateTimePicker: false,
-  hideDatePicker: true,
-  hideTimePicker: true,
-  withAnyInputs: true,
-  withAnyPicker: true,
-  withClearBtn: false,
-  withAnyRightController: true,
-  isDateSelector: false,
-  isTimeSelector: false,
-  isDateTimeSelector: true,
-  isControllerOnly: false,
-  isWithTimeWheelToo: true,
-  isWithCalendarToo: true,
-  isWithDateInputs: true,
-  isWithDateInputsOnly: false,
-  isWithTimeInputs: true,
-  isWithTimeInputsOnly: false,
-  autoFocusMonthInput: false,
-  autoFocusHourInput: false,
-  autoFocusPrevMonthArrow: false,
-  autoFocusHourTimeWheel: false,
-  shouldPreserveClearableSpace: false,
-  latestInteractionRegion: '',
-  setLatestInteractionRegion: mockedSetLatestInteractionRegion,
-  onGlobalKeyDown: noop
-};
+const defaultContext = {};
 /** Context for cross component communication */
 
 const ControlledDateTimePickerContext = /*#__PURE__*/createContext(defaultContext);
 
-export { ControlledDateTimePickerContext, ControlledDateTimePickerContext as default, defaultProps };
+export { ControlledDateTimePickerContext, ControlledDateTimePickerContext as default };

package/esm/date-time-picker/ControlledDateTimePickerDatatestid.js

@@ -20,9 +20,7 @@ const ControlledDateTimePickerDatatestid = {
     DAY: 'ds-controlled-date-time-picker-calendar-day',
     FOCUSED_DAY: 'ds-controlled-date-time-picker-calendar-focused-day',
     START_RANGE_DAY: 'ds-controlled-date-time-picker-calendar-start-range-day',
-    // <-nuevo
     IN_RANGE_DAY: 'ds-controlled-date-time-picker-calendar-in-range-day',
-    // <-nuevo
     END_RANGE_DAY: 'ds-controlled-date-time-picker-calendar-end-range-day',
     SELECTED_DAY: 'ds-controlled-date-time-picker-calendar-selected-day',
     SELECTED_FOCUSED_DAY: 'ds-controlled-date-time-picker-calendar-selected-focused-day',

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

@@ -0,0 +1,256 @@
+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 { getValidationDateStringMetaInfo } from '../utils/dateHelpers.js';
+import { getValidationTimeStringMetaInfo } from '../utils/timeHelpers.js';
+import { getFormattedDateString, getFormattedTimeString, isEmptyDateStringMask, isEmptyTimeStringMask, isEmptyDateTimeStringMask } from '../utils/stringHelpers.js';
+import { defaultMetaInfo } from '../utils/constants.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 useChangeHandlers = _ref => {
+  let {
+    relevantValues,
+    destructuredValues,
+    propsBasedOnType,
+    DOMRefs
+  } = _ref;
+  const {
+    tempDateString,
+    setTempDateString,
+    tempTimeString,
+    setTimeString
+  } = relevantValues;
+  const {
+    getIsDisabledDay,
+    getIsOutOfRangeDay,
+    appOnDateChange,
+    appOnMonthChange,
+    appOnDayChange,
+    appOnYearChange,
+    getIsDisabledTime,
+    appOnTimeChange,
+    appOnHourChange,
+    appOnMinuteChange,
+    appOnMeridiemChange,
+    appOnDateTimeChange,
+    isDateTime,
+    isDate,
+    isTime
+  } = propsBasedOnType;
+  const {
+    month,
+    day,
+    year,
+    hours,
+    minutes,
+    meridiem
+  } = destructuredValues;
+  const {
+    firstSegmentRef
+  } = DOMRefs;
+  const getDateMetaInfo = useCallback(function () {
+    let newDateString = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
+    let metaInfo = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    const finalDateString = newDateString || tempDateString;
+
+    const finalMetaInfo = _objectSpread(_objectSpread({}, metaInfo), getValidationDateStringMetaInfo(finalDateString, getIsOutOfRangeDay, getIsDisabledDay));
+
+    return finalMetaInfo;
+  }, [tempDateString, getIsDisabledDay, getIsOutOfRangeDay]);
+  const getTimeMetaInfo = useCallback(function () {
+    let newTimeString = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
+    let metaInfo = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    const finalTimeString = newTimeString || tempTimeString;
+
+    const finalMetaInfo = _objectSpread(_objectSpread({}, metaInfo), getValidationTimeStringMetaInfo(finalTimeString, getIsDisabledTime));
+
+    return finalMetaInfo;
+  }, [tempTimeString, getIsDisabledTime]);
+  const handleChangeComposedDateTimeString = useCallback((newDateString, newTimeString, metaInfo) => {
+    const appDateString = isEmptyDateStringMask(newDateString) ? '' : newDateString;
+    const appTimeString = isEmptyTimeStringMask(newTimeString) ? '' : newTimeString;
+    appOnDateChange(appDateString, metaInfo); // don't do this on useEffect to avoid complete chaos
+
+    setTempDateString(newDateString);
+    appOnTimeChange(appTimeString, metaInfo); // don't do this on useEffect to avoid complete chaos
+
+    setTimeString(newTimeString);
+    const newDateTimeString = "".concat(newDateString, " ").concat(newTimeString);
+
+    const newMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, getTimeMetaInfo(newTimeString, metaInfo)), getDateMetaInfo(newDateString, metaInfo)), {}, {
+      newDateString,
+      newTimeString,
+      newDateTimeString
+    });
+
+    const appDateTimeString = isEmptyDateTimeStringMask(newDateTimeString) ? '' : newDateTimeString;
+    appOnDateTimeChange(appDateTimeString, newMetaInfo); // don't do this on useEffect to avoid complete chaos
+  }, [appOnDateChange, setTempDateString, appOnTimeChange, setTimeString, getTimeMetaInfo, getDateMetaInfo, appOnDateTimeChange]);
+  const handleChangeComposedDateString = useCallback((newDateString, metaInfo) => {
+    // if we receive an "empty" mask, we comunicate empty string to the app
+    const appDateString = isEmptyDateStringMask(newDateString) ? '' : newDateString;
+    appOnDateChange(appDateString, metaInfo); // don't do this on useEffect to avoid complete chaos
+
+    setTempDateString(newDateString);
+    const newDateTimeString = "".concat(newDateString, " ").concat(tempTimeString);
+
+    const newMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, getTimeMetaInfo(tempTimeString, metaInfo)), getDateMetaInfo(newDateString, metaInfo)), {}, {
+      newDateString,
+      newTimeString: tempTimeString,
+      newDateTimeString
+    });
+
+    const appDateTimeString = isEmptyDateTimeStringMask(newDateTimeString) ? '' : newDateTimeString;
+    appOnDateTimeChange(appDateTimeString, newMetaInfo); // don't do this on useEffect to avoid complete chaos
+  }, [appOnDateChange, setTempDateString, tempTimeString, getTimeMetaInfo, getDateMetaInfo, appOnDateTimeChange]);
+  const handleChangeComposedTimeString = useCallback((newTimeString, metaInfo) => {
+    const appTimeString = isEmptyTimeStringMask(newTimeString) ? '' : newTimeString;
+    appOnTimeChange(appTimeString, metaInfo); // don't do this on useEffect to avoid complete chaos
+
+    setTimeString(newTimeString);
+    const newDateTimeString = "".concat(tempDateString, " ").concat(newTimeString);
+
+    const newMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, getTimeMetaInfo(newTimeString, metaInfo)), getDateMetaInfo(tempDateString, metaInfo)), {}, {
+      newDateTimeString,
+      newDateString: tempDateString,
+      newTimeString
+    });
+
+    const appDateTimeString = isEmptyDateTimeStringMask(newDateTimeString) ? '' : newDateTimeString;
+    appOnDateTimeChange(appDateTimeString, newMetaInfo); // don't do this on useEffect to avoid complete chaos
+  }, [appOnTimeChange, setTimeString, tempDateString, getTimeMetaInfo, getDateMetaInfo, appOnDateTimeChange]);
+  const handleChangeMonth = useCallback(function (newMonth, e) {
+    let metaInfo = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : defaultMetaInfo;
+    const newDateString = getFormattedDateString({
+      month: newMonth,
+      day,
+      year
+    });
+
+    const finalMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, metaInfo), getValidationDateStringMetaInfo(newDateString, getIsOutOfRangeDay, getIsDisabledDay)), {}, {
+      newDateString
+    });
+
+    appOnMonthChange(newMonth, e, finalMetaInfo);
+    handleChangeComposedDateString(newDateString, finalMetaInfo);
+  }, [day, year, getIsOutOfRangeDay, getIsDisabledDay, appOnMonthChange, handleChangeComposedDateString]);
+  const handleChangeDay = useCallback(function (newDay, e) {
+    let metaInfo = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : defaultMetaInfo;
+    const newDateString = getFormattedDateString({
+      month,
+      day: newDay,
+      year
+    });
+
+    const finalMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, metaInfo), getValidationDateStringMetaInfo(newDateString, getIsOutOfRangeDay, getIsDisabledDay)), {}, {
+      newDateString
+    });
+
+    appOnDayChange(newDay, e, finalMetaInfo);
+    handleChangeComposedDateString(newDateString, finalMetaInfo);
+  }, [month, year, getIsOutOfRangeDay, getIsDisabledDay, appOnDayChange, handleChangeComposedDateString]);
+  const handleChangeYear = useCallback(function (newYear, e) {
+    let metaInfo = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : defaultMetaInfo;
+    const newDateString = getFormattedDateString({
+      month,
+      day,
+      year: newYear
+    });
+
+    const finalMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, metaInfo), getValidationDateStringMetaInfo(newDateString, getIsOutOfRangeDay, getIsDisabledDay)), {}, {
+      newDateString
+    });
+
+    appOnYearChange(newYear, e, finalMetaInfo);
+    handleChangeComposedDateString(newDateString, finalMetaInfo);
+  }, [month, day, getIsOutOfRangeDay, getIsDisabledDay, appOnYearChange, handleChangeComposedDateString]);
+  const handleChangeHours = useCallback(function (newHours, e) {
+    let metaInfo = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : defaultMetaInfo;
+    const newTimeString = getFormattedTimeString({
+      hours: newHours,
+      minutes,
+      // seconds,
+      meridiem
+    });
+
+    const finalMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, metaInfo), getValidationTimeStringMetaInfo(newTimeString, getIsDisabledTime)), {}, {
+      newTimeString
+    });
+
+    appOnHourChange(newHours, e, finalMetaInfo);
+    handleChangeComposedTimeString(newTimeString, finalMetaInfo);
+  }, [minutes, meridiem, getIsDisabledTime, appOnHourChange, handleChangeComposedTimeString]);
+  const handleChangeMinutes = useCallback(function (newMinutes, e) {
+    let metaInfo = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : defaultMetaInfo;
+    const newTimeString = getFormattedTimeString({
+      hours,
+      minutes: newMinutes,
+      meridiem
+    });
+
+    const finalMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, metaInfo), getValidationTimeStringMetaInfo(newTimeString, getIsDisabledTime)), {}, {
+      newTimeString
+    });
+
+    appOnMinuteChange(newMinutes, e, finalMetaInfo);
+    handleChangeComposedTimeString(newTimeString, finalMetaInfo);
+  }, [hours, meridiem, getIsDisabledTime, appOnMinuteChange, handleChangeComposedTimeString]);
+  const handleChangeMeridiem = useCallback(function (newMeridiem, e) {
+    let metaInfo = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : defaultMetaInfo;
+    const newTimeString = getFormattedTimeString({
+      hours,
+      minutes,
+      meridiem: newMeridiem
+    });
+
+    const finalMetaInfo = _objectSpread(_objectSpread(_objectSpread({}, metaInfo), getValidationTimeStringMetaInfo(newTimeString, getIsDisabledTime)), {}, {
+      newTimeString
+    });
+
+    appOnMeridiemChange(newMeridiem, e, finalMetaInfo);
+    handleChangeComposedTimeString(newTimeString, finalMetaInfo);
+  }, [hours, minutes, getIsDisabledTime, appOnMeridiemChange, handleChangeComposedTimeString]);
+  const handleClearAll = useCallback(e => {
+    const metaInfo = {
+      isAutomaticFillTrigger: false,
+      isClearButtonAction: true,
+      newDateString: '',
+      newTimeString: '',
+      newDateTimeString: ''
+    };
+    appOnMonthChange('', e, metaInfo);
+    appOnDayChange('', e, metaInfo);
+    appOnYearChange('', e, metaInfo);
+    appOnHourChange('', e, metaInfo);
+    appOnMinuteChange('', e, metaInfo);
+    appOnMeridiemChange('', e, metaInfo);
+    if (isDateTime) handleChangeComposedDateTimeString('__/__/____', '__:__ __', metaInfo);
+    if (isDate) handleChangeComposedDateString('__/__/____', metaInfo);
+    if (isTime) handleChangeComposedTimeString('__:__ __', metaInfo);
+    setTimeout(() => {
+      var _firstSegmentRef$curr;
+
+      (_firstSegmentRef$curr = firstSegmentRef.current) === null || _firstSegmentRef$curr === void 0 ? void 0 : _firstSegmentRef$curr.focus();
+    });
+  }, [appOnDayChange, appOnHourChange, appOnMeridiemChange, appOnMinuteChange, appOnMonthChange, appOnYearChange, firstSegmentRef, handleChangeComposedDateString, handleChangeComposedDateTimeString, handleChangeComposedTimeString, isDate, isDateTime, isTime]);
+  return useMemo(() => ({
+    handleChangeComposedDateTimeString,
+    handleChangeComposedDateString,
+    handleChangeComposedTimeString,
+    handleChangeMonth,
+    handleChangeDay,
+    handleChangeYear,
+    handleChangeHours,
+    handleChangeMinutes,
+    handleChangeMeridiem,
+    handleClearAll
+  }), [handleChangeComposedDateString, handleChangeComposedDateTimeString, handleChangeComposedTimeString, handleChangeDay, handleChangeHours, handleChangeMeridiem, handleChangeMinutes, handleChangeMonth, handleChangeYear, handleClearAll]);
+};
+
+export { useChangeHandlers };