@carbon/react 1.70.0 → 1.71.0-rc.0

package/es/components/AILabel/index.js

@@ -31,8 +31,8 @@ const AILabelContent = /*#__PURE__*/React__default.forwardRef(function AILabelCo
     item.type?.displayName === 'AILabelActions';
   });
   const aiLabelContentClasses = cx(className, {
-    [`${prefix}--slug-content`]: true,
-    [`${prefix}--slug-content--with-actions`]: hasAILabelActions
+    [`${prefix}--ai-label-content`]: true,
+    [`${prefix}--ai-label-content--with-actions`]: hasAILabelActions
   });
   return /*#__PURE__*/React__default.createElement(ToggletipContent, {
     className: aiLabelContentClasses
@@ -41,11 +41,11 @@ const AILabelContent = /*#__PURE__*/React__default.forwardRef(function AILabelCo
 AILabelContent.displayName = 'AILabelContent';
 AILabelContent.propTypes = {
   /**
-   * Specify the content you want rendered inside the slug ToggleTip
+   * Specify the content you want rendered inside the AILabel ToggleTip
    */
   children: PropTypes.node,
   /**
-   * Specify an optional className to be added to the AI slug callout
+   * Specify an optional className to be added to the AILabel callout
    */
   className: PropTypes.string
 };
@@ -57,7 +57,7 @@ const AILabelActions = /*#__PURE__*/React__default.forwardRef(function AILabelAc
   } = _ref2;
   const prefix = usePrefix();
   const aiLabelActionsClasses = cx(className, {
-    [`${prefix}--slug-actions`]: true
+    [`${prefix}--ai-label-actions`]: true
   });
   return /*#__PURE__*/React__default.createElement(ToggletipActions, {
     className: aiLabelActionsClasses
@@ -66,11 +66,11 @@ const AILabelActions = /*#__PURE__*/React__default.forwardRef(function AILabelAc
 AILabelActions.displayName = 'AILabelActions';
 AILabelActions.propTypes = {
   /**
-   * Specify the content you want rendered inside the slug callout toolbar
+   * Specify the content you want rendered inside the AILabel callout toolbar
    */
   children: PropTypes.node,
   /**
-   * Specify an optional className to be added to the AI slug toolbar
+   * Specify an optional className to be added to the AILabel toolbar
    */
   className: PropTypes.string
 };
@@ -104,14 +104,14 @@ const AILabel = /*#__PURE__*/React__default.forwardRef(function AILabel(_ref3, r
   const prefix = usePrefix();
   const id = useId('AILabel');
   const aiLabelClasses = cx(className, {
-    [`${prefix}--slug`]: true,
-    [`${prefix}--slug--revert`]: revertActive
+    [`${prefix}--ai-label`]: true,
+    [`${prefix}--ai-label--revert`]: revertActive
   });
   const aiLabelButtonClasses = cx({
-    [`${prefix}--slug__button`]: true,
-    [`${prefix}--slug__button--${size}`]: size,
-    [`${prefix}--slug__button--${kind}`]: kind,
-    [`${prefix}--slug__button--inline-with-content`]: kind === 'inline' && (aiTextLabel || textLabel)
+    [`${prefix}--ai-label__button`]: true,
+    [`${prefix}--ai-label__button--${size}`]: size,
+    [`${prefix}--ai-label__button--${kind}`]: kind,
+    [`${prefix}--ai-label__button--inline-with-content`]: kind === 'inline' && (aiTextLabel || textLabel)
   });
   const handleOnRevertClick = evt => {
     if (onRevertClick) {
@@ -135,9 +135,9 @@ const AILabel = /*#__PURE__*/React__default.forwardRef(function AILabel(_ref3, r
     className: aiLabelButtonClasses,
     label: ariaLabelText
   }, /*#__PURE__*/React__default.createElement("span", {
-    className: `${prefix}--slug__text`
+    className: `${prefix}--ai-label__text`
   }, aiText), kind === 'inline' && (aiTextLabel || textLabel) && /*#__PURE__*/React__default.createElement("span", {
-    className: `${prefix}--slug__additional-text`
+    className: `${prefix}--ai-label__additional-text`
   }, aiTextLabel || textLabel)), children));
 });
 AILabel.displayName = 'AILabel';

package/es/components/CodeSnippet/CodeSnippet.d.ts

@@ -6,11 +6,14 @@
  */
 import PropTypes from 'prop-types';
 import { PropsWithChildren } from 'react';
+export type DeprecatedCodeSnippetAlignment = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'left-bottom' | 'left-top' | 'right-bottom' | 'right-top';
+export type NewCodeSnippetAlignmnet = 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'left-end' | 'left-start' | 'right-end' | 'right-start';
+export type CodeSnippetAlignment = DeprecatedCodeSnippetAlignment | NewCodeSnippetAlignmnet;
 export interface CodeSnippetProps {
     /**
      * Specify how the trigger should align with the tooltip
      */
-    align?: 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
+    align?: CodeSnippetAlignment;
     /**
      * **Experimental**: Will attempt to automatically align the tooltip
      */
@@ -106,7 +109,7 @@ declare namespace CodeSnippet {
         /**
          * Specify how the trigger should align with the tooltip
          */
-        align: PropTypes.Requireable<string>;
+        align: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
         /**
          * Specify a label to be read by screen readers on the containing textbox
          * node

package/es/components/CodeSnippet/CodeSnippet.js

@@ -19,12 +19,26 @@ import uniqueId from '../../tools/uniqueId.js';
 import copy from 'copy-to-clipboard';
 import deprecate from '../../prop-types/deprecate.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
 
 const rowHeightInPixels = 16;
 const defaultMaxCollapsedNumberOfRows = 15;
 const defaultMaxExpandedNumberOfRows = 0;
 const defaultMinCollapsedNumberOfRows = 3;
 const defaultMinExpandedNumberOfRows = 16;
+const propMappingFunction = deprecatedValue => {
+  const mapping = {
+    'top-left': 'top-start',
+    'top-right': 'top-end',
+    'bottom-left': 'bottom-start',
+    'bottom-right': 'bottom-end',
+    'left-bottom': 'left-end',
+    'left-top': 'left-start',
+    'right-bottom': 'right-end',
+    'right-top': 'right-start'
+  };
+  return mapping[deprecatedValue];
+};
 function CodeSnippet(_ref) {
   let {
     align = 'bottom',
@@ -232,7 +246,32 @@ CodeSnippet.propTypes = {
   /**
    * Specify how the trigger should align with the tooltip
    */
-  align: PropTypes.oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  align: deprecateValuesWithin(PropTypes.oneOf(['top', 'top-left',
+  // deprecated use top-start instead
+  'top-right',
+  // deprecated use top-end instead
+
+  'bottom', 'bottom-left',
+  // deprecated use bottom-start instead
+  'bottom-right',
+  // deprecated use bottom-end instead
+
+  'left', 'left-bottom',
+  // deprecated use left-end instead
+  'left-top',
+  // deprecated use left-start instead
+
+  'right', 'right-bottom',
+  // deprecated use right-end instead
+  'right-top',
+  // deprecated use right-start instead
+
+  // new values to match floating-ui
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
+  //allowed prop values
+  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
+  //optional mapper function
+  propMappingFunction),
   /**
    * Specify a label to be read by screen readers on the containing textbox
    * node

package/es/components/ComboBox/ComboBox.js

@@ -226,7 +226,6 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
         selectedItem: selectedItemProp,
         prevSelectedItem: prevSelectedItemProp.current
       });
-
       // selectedItem has been updated externally, need to update state and call onChange
       if (inputValue !== currentInputValue) {
         setInputValue(currentInputValue);
@@ -435,30 +434,12 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
       } = _ref4;
       const normalizedInput = inputValue || '';
       setInputValue(normalizedInput);
-      if (selectedItemProp && !inputValue) {
-        // ensure onChange is called when selectedItem is cleared
-        onChange({
-          selectedItem,
-          inputValue: normalizedInput
-        });
-      }
       setHighlightedIndex(indexToHighlight(normalizedInput));
     },
-    onSelectedItemChange(_ref5) {
-      let {
-        selectedItem
-      } = _ref5;
-      // only call onChange if new selection is updated from previous
-      if (!isEqual(selectedItem, selectedItemProp)) {
-        onChange({
-          selectedItem
-        });
-      }
-    },
-    onHighlightedIndexChange: _ref6 => {
+    onHighlightedIndexChange: _ref5 => {
       let {
         highlightedIndex
-      } = _ref6;
+      } = _ref5;
       if (highlightedIndex > -1 && typeof window !== undefined) {
         const itemArray = document.querySelectorAll(`li.${prefix}--list-box__menu-item[role="option"]`);
         const highlightedItem = itemArray[highlightedIndex];
@@ -470,11 +451,27 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
         }
       }
     },
+    onStateChange: _ref6 => {
+      let {
+        type,
+        selectedItem: newSelectedItem
+      } = _ref6;
+      if (type === '__item_click__' && !isEqual(selectedItemProp, newSelectedItem)) {
+        onChange({
+          selectedItem: newSelectedItem
+        });
+      }
+      if (type === '__function_select_item__' || type === '__input_keydown_enter__') {
+        onChange({
+          selectedItem: newSelectedItem
+        });
+      }
+    },
     initialSelectedItem: initialSelectedItem,
     inputId: id,
     stateReducer,
     isItemDisabled(item, _index) {
-      return item.disabled;
+      return item?.disabled;
     },
     ...downshiftProps
   });

package/es/components/ComboButton/index.js

@@ -22,6 +22,7 @@ import { flip, size, useFloating, autoUpdate } from '@floating-ui/react';
 import { hide } from '../../node_modules/@floating-ui/dom/dist/floating-ui.dom.mjs.js';
 import { useFeatureFlag } from '../FeatureFlags/index.js';
 import mergeRefs from '../../tools/mergeRefs.js';
+import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
 
 var _ChevronDown;
 const defaultTranslations = {
@@ -32,6 +33,19 @@ const defaultTranslations = {
  * Message ids that will be passed to translateWithId().
  */
 
+const propMappingFunction = deprecatedValue => {
+  const mapping = {
+    'top-left': 'top-start',
+    'top-right': 'top-end',
+    'bottom-left': 'bottom-start',
+    'bottom-right': 'bottom-end',
+    'left-bottom': 'left-end',
+    'left-top': 'left-start',
+    'right-bottom': 'right-end',
+    'right-top': 'right-start'
+  };
+  return mapping[deprecatedValue];
+};
 function defaultTranslateWithId(messageId) {
   return defaultTranslations[messageId];
 }
@@ -191,7 +205,32 @@ ComboButton.propTypes = {
   /**
    * Specify how the trigger tooltip should be aligned.
    */
-  tooltipAlignment: PropTypes.oneOf(['top', 'top-left', 'top-start', 'top-right', 'top-end', 'bottom', 'bottom-left', 'bottom-start', 'bottom-right', 'bottom-end', 'left', 'right']),
+  tooltipAlignment: deprecateValuesWithin(PropTypes.oneOf(['top', 'top-left',
+  // deprecated use top-start instead
+  'top-right',
+  // deprecated use top-end instead
+
+  'bottom', 'bottom-left',
+  // deprecated use bottom-start instead
+  'bottom-right',
+  // deprecated use bottom-end instead
+
+  'left', 'left-bottom',
+  // deprecated use left-end instead
+  'left-top',
+  // deprecated use left-start instead
+
+  'right', 'right-bottom',
+  // deprecated use right-end instead
+  'right-top',
+  // deprecated use right-start instead
+
+  // new values to match floating-ui
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
+  //allowed prop values
+  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
+  //optional mapper function
+  propMappingFunction),
   /**
    * Optional method that takes in a message id and returns an
    * internationalized string.

package/es/components/ContentSwitcher/ContentSwitcher.d.ts

@@ -38,7 +38,7 @@ export interface ContentSwitcherProps extends Omit<HTMLAttributes<HTMLElement>,
      */
     selectedIndex: number;
     /**
-     * Choose whether or not to automatically change selection on focus
+     * Choose whether or not to automatically change selection on focus when left/right arrow pressed. Defaults to 'automatic'
      */
     selectionMode?: 'automatic' | 'manual';
     /**
@@ -82,7 +82,7 @@ export default class ContentSwitcher extends React.Component<ContentSwitcherProp
          */
         selectedIndex: PropTypes.Requireable<number>;
         /**
-         * Choose whether or not to automatically change selection on focus
+         * Choose whether or not to automatically change selection on focus when left/right arrow pressed. Defaults to 'automatic'
          */
         selectionMode: PropTypes.Requireable<string>;
         /**

package/es/components/ContentSwitcher/ContentSwitcher.js

@@ -163,7 +163,7 @@ _defineProperty(ContentSwitcher, "propTypes", {
    */
   selectedIndex: PropTypes.number,
   /**
-   * Choose whether or not to automatically change selection on focus
+   * Choose whether or not to automatically change selection on focus when left/right arrow pressed. Defaults to 'automatic'
    */
   selectionMode: PropTypes.oneOf(['automatic', 'manual']),
   /**

package/es/components/Copy/Copy.d.ts

@@ -6,11 +6,14 @@
  */
 import PropTypes from 'prop-types';
 import React, { AnimationEventHandler, MouseEventHandler, PropsWithChildren } from 'react';
+export type DeprecatedCopyAlignment = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'left-bottom' | 'left-top' | 'right-bottom' | 'right-top';
+export type NewCopyAlignment = 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'left-end' | 'left-start' | 'right-end' | 'right-start';
+export type CopyAlignment = DeprecatedCopyAlignment | NewCopyAlignment;
 interface CopyProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     /**
      * Specify how the trigger should align with the tooltip
      */
-    align?: 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
+    align?: CopyAlignment;
     /**
      * **Experimental**: Will attempt to automatically align the tooltip
      */
@@ -45,7 +48,7 @@ declare namespace Copy {
         /**
          * Specify how the trigger should align with the tooltip
          */
-        align: PropTypes.Requireable<string>;
+        align: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
         /**
          * **Experimental**: Will attempt to automatically align the tooltip
          */

package/es/components/Copy/Copy.js

@@ -14,7 +14,21 @@ import { composeEventHandlers } from '../../tools/events.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { IconButton } from '../IconButton/index.js';
 import { noopFn } from '../../internal/noopFn.js';
+import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
 
+const propMappingFunction = deprecatedValue => {
+  const mapping = {
+    'top-left': 'top-start',
+    'top-right': 'top-end',
+    'bottom-left': 'bottom-start',
+    'bottom-right': 'bottom-end',
+    'left-bottom': 'left-end',
+    'left-top': 'left-start',
+    'right-bottom': 'right-end',
+    'right-top': 'right-start'
+  };
+  return mapping[deprecatedValue];
+};
 function Copy(_ref) {
   let {
     align = 'bottom',
@@ -66,7 +80,32 @@ Copy.propTypes = {
   /**
    * Specify how the trigger should align with the tooltip
    */
-  align: PropTypes.oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  align: deprecateValuesWithin(PropTypes.oneOf(['top', 'top-left',
+  // deprecated use top-start instead
+  'top-right',
+  // deprecated use top-end instead
+
+  'bottom', 'bottom-left',
+  // deprecated use bottom-start instead
+  'bottom-right',
+  // deprecated use bottom-end instead
+
+  'left', 'left-bottom',
+  // deprecated use left-end instead
+  'left-top',
+  // deprecated use left-start instead
+
+  'right', 'right-bottom',
+  // deprecated use right-end instead
+  'right-top',
+  // deprecated use right-start instead
+
+  // new values to match floating-ui
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
+  //allowed prop values
+  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
+  //optional mapper function
+  propMappingFunction),
   /**
    * **Experimental**: Will attempt to automatically align the tooltip
    */

package/es/components/CopyButton/CopyButton.d.ts

@@ -7,11 +7,14 @@
 import PropTypes from 'prop-types';
 import { MouseEventHandler } from 'react';
 import { ButtonProps } from '../Button';
+export type DeprecatedCopyButtonAlignment = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'left-bottom' | 'left-top' | 'right-bottom' | 'right-top';
+export type NewCopyButtonAlignment = 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'left-end' | 'left-start' | 'right-end' | 'right-start';
+export type CopyButtonAlignment = DeprecatedCopyButtonAlignment | NewCopyButtonAlignment;
 export interface CopyButtonProps extends ButtonProps<'button'> {
     /**
      * Specify how the trigger should align with the tooltip
      */
-    align?: 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
+    align?: CopyButtonAlignment;
     /**
      * **Experimental**: Will attempt to automatically align the tooltip
      */
@@ -46,7 +49,7 @@ declare namespace CopyButton {
         /**
          * Specify how the trigger should align with the tooltip
          */
-        align: PropTypes.Requireable<string>;
+        align: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
         /**
          * **Experimental**: Will attempt to automatically align the tooltip
          */

package/es/components/CopyButton/CopyButton.js

@@ -14,7 +14,21 @@ import Copy from '../Copy/Copy.js';
 import { LayoutConstraint } from '../Layout/index.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { noopFn } from '../../internal/noopFn.js';
+import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
 
+const propMappingFunction = deprecatedValue => {
+  const mapping = {
+    'top-left': 'top-start',
+    'top-right': 'top-end',
+    'bottom-left': 'bottom-start',
+    'bottom-right': 'bottom-end',
+    'left-bottom': 'left-end',
+    'left-top': 'left-start',
+    'right-bottom': 'right-end',
+    'right-top': 'right-start'
+  };
+  return mapping[deprecatedValue];
+};
 function CopyButton(_ref) {
   let {
     align = 'bottom',
@@ -48,7 +62,32 @@ CopyButton.propTypes = {
   /**
    * Specify how the trigger should align with the tooltip
    */
-  align: PropTypes.oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  align: deprecateValuesWithin(PropTypes.oneOf(['top', 'top-left',
+  // deprecated use top-start instead
+  'top-right',
+  // deprecated use top-end instead
+
+  'bottom', 'bottom-left',
+  // deprecated use bottom-start instead
+  'bottom-right',
+  // deprecated use bottom-end instead
+
+  'left', 'left-bottom',
+  // deprecated use left-end instead
+  'left-top',
+  // deprecated use left-start instead
+
+  'right', 'right-bottom',
+  // deprecated use right-end instead
+  'right-top',
+  // deprecated use right-start instead
+
+  // new values to match floating-ui
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
+  //allowed prop values
+  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
+  //optional mapper function
+  propMappingFunction),
   /**
    * **Experimental**: Will attempt to automatically align the tooltip
    */

package/es/components/DataTable/TableSelectRow.js

@@ -30,15 +30,21 @@ const TableSelectRow = _ref => {
   } = _ref;
   const prefix = usePrefix();
   const uniqueNameId = useId();
+  const handleRadioChange = onChange ? (value, name, event) => {
+    // Convert the radio value to boolean for consistency
+    onChange(!!value, name || '', event);
+  } : undefined;
+  const handleCheckboxChange = onChange ? (checked, name, event) => {
+    onChange(checked, name, event);
+  } : undefined;
   const selectionInputProps = {
     id,
     name: name ? name : uniqueNameId,
     onClick: onSelect,
-    onChange,
     checked,
     disabled
   };
-  const InlineInputComponent = radio ? RadioButton : InlineCheckbox;
+  const labelValue = ariaLabel || deprecatedAriaLabel || '';
   const tableSelectRowClasses = cx(`${prefix}--table-column-checkbox`, {
     ...(className && {
       [className]: true
@@ -48,11 +54,13 @@ const TableSelectRow = _ref => {
   return /*#__PURE__*/React__default.createElement("td", {
     className: tableSelectRowClasses,
     "aria-live": "off"
-  }, /*#__PURE__*/React__default.createElement(InlineInputComponent, _extends({}, selectionInputProps, radio && {
-    labelText: ariaLabel || deprecatedAriaLabel,
+  }, radio ? /*#__PURE__*/React__default.createElement(RadioButton, _extends({}, selectionInputProps, {
+    labelText: labelValue,
+    onChange: handleRadioChange,
     hideLabel: true
-  }, !radio && {
-    'aria-label': ariaLabel || deprecatedAriaLabel
+  })) : /*#__PURE__*/React__default.createElement(InlineCheckbox, _extends({}, selectionInputProps, {
+    "aria-label": labelValue,
+    onChange: handleCheckboxChange
   })));
 };
 TableSelectRow.propTypes = {

package/es/components/DataTable/TableToolbarSearch.js

@@ -92,7 +92,7 @@ const TableToolbarSearch = _ref => {
   const onChange = e => {
     setValue(e.target.value);
     if (onChangeProp) {
-      onChangeProp(e);
+      onChangeProp(e, e.target.value);
     }
   };
   const handleOnFocus = event => handleExpand(event, true);

package/es/components/DataTable/stories/examples/TableToolbarFilter.d.ts

@@ -13,7 +13,7 @@ interface TableToolbarFilterProps {
     /**
      * Provide an optional hook that is called each time the input is updated
      */
-    onChange?: (event: '' | ChangeEvent<HTMLInputElement>, value?: string) => void;
+    onChange?: (event: '' | ChangeEvent<HTMLInputElement>) => void;
     /**
      * Provide an function that is called when the apply button is clicked
      */

package/es/components/DatePicker/plugins/fixEventsPlugin.js

@@ -76,7 +76,7 @@ var carbonFlatpickrFixEventsPlugin = config => fp => {
     if (inputTo === target && fp.selectedDates[1]) {
       // Using getTime() enables the ability to more readily compare the date currently
       // selected in the calendar and the date currently in the value of the input
-      const withoutTime = date => date.setHours(0, 0, 0, 0);
+      const withoutTime = date => date?.setHours(0, 0, 0, 0);
       const selectedToDate = withoutTime(new Date(fp.selectedDates[1]));
       const currentValueToDate = withoutTime(parseDateWithFormat(inputTo.value));
 
@@ -88,7 +88,7 @@ var carbonFlatpickrFixEventsPlugin = config => fp => {
         fp.setDate([inputFrom.value, inputTo && inputTo.value], true, fp.config.dateFormat);
       }
     }
-    const isValidDate = date => date.toString() !== 'Invalid Date';
+    const isValidDate = date => date?.toString() !== 'Invalid Date';
     // save end date in calendar inmediately after it's been written down
     if (inputTo === target && fp.selectedDates.length === 1 && inputTo.value) {
       if (isValidDate(parseDateWithFormat(inputTo.value))) {

package/es/components/DatePickerInput/DatePickerInput.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { ReactElementLike, ReactNodeArray } from 'prop-types';
-import React from 'react';
+import React, { ReactNode } from 'react';
 import { ReactAttr } from '../../types/common';
 type ExcludedAttributes = 'value' | 'onChange' | 'locale' | 'children';
 export type ReactNodeLike = ReactElementLike | ReactNodeArray | string | number | boolean | null | undefined;
@@ -19,6 +19,10 @@ export interface DatePickerInputProps extends Omit<ReactAttr<HTMLInputElement>,
      * * `range` - With calendar dropdown and a date range.
      */
     datePickerType?: 'simple' | 'single' | 'range';
+    /**
+     * **Experimental**: Provide a `decorator` component to be rendered inside the `DatePickerInput` component
+     */
+    decorator?: ReactNode;
     /**
      * Specify whether or not the input should be disabled
      */
@@ -77,6 +81,7 @@ export interface DatePickerInputProps extends Omit<ReactAttr<HTMLInputElement>,
      */
     size?: 'sm' | 'md' | 'lg';
     /**
+     * @deprecated please use decorator instead.
      * **Experimental**: Provide a `Slug` component to be rendered inside the `DatePickerInput` component
      */
     slug?: ReactNodeLike;