@carbon/ibm-products 2.52.0 → 2.53.0

package/lib/components/TagOverflow/TagOverflowModal.d.ts

@@ -11,6 +11,10 @@ interface TagOverflowModalProps {
     className?: string;
     modalAriaLabel?: string;
     onClose?: () => void;
+    onTagClose?: (params: {
+        label: string;
+        id: any;
+    }) => void;
     open?: boolean;
     overflowType?: 'default' | 'tag';
     portalTarget?: ReactNode;
@@ -19,13 +23,14 @@ interface TagOverflowModalProps {
     title?: string;
 }
 export declare const TagOverflowModal: {
-    ({ allTags, className, title, modalAriaLabel, onClose, open, overflowType, portalTarget: portalTargetIn, searchLabel, searchPlaceholder, ...rest }: TagOverflowModalProps): any;
+    ({ allTags, className, title, modalAriaLabel, onClose, onTagClose, open, overflowType, portalTarget: portalTargetIn, searchLabel, searchPlaceholder, ...rest }: TagOverflowModalProps): any;
     propTypes: {
         allTags: PropTypes.Requireable<(PropTypes.InferProps<{
             label: PropTypes.Validator<string>;
         }> | null | undefined)[]>;
         className: PropTypes.Requireable<string>;
         onClose: PropTypes.Requireable<(...args: any[]) => any>;
+        onTagClose: PropTypes.Requireable<(...args: any[]) => any>;
         open: PropTypes.Requireable<boolean>;
         overflowType: PropTypes.Requireable<string>;
         portalTarget: PropTypes.Requireable<PropTypes.ReactNodeLike>;

package/lib/components/TagOverflow/TagOverflowModal.js

@@ -16,7 +16,7 @@ var settings = require('../../settings.js');
 var propsHelper = require('../../global/js/utils/props-helper.js');
 var usePortalTarget = require('../../global/js/hooks/usePortalTarget.js');
 
-var _excluded = ["allTags", "className", "title", "modalAriaLabel", "onClose", "open", "overflowType", "portalTarget", "searchLabel", "searchPlaceholder"];
+var _excluded = ["allTags", "className", "title", "modalAriaLabel", "onClose", "onTagClose", "open", "overflowType", "portalTarget", "searchLabel", "searchPlaceholder"];
 var componentName = 'TagOverflowModal';
 var blockClass = "".concat(settings.pkg.prefix, "--tag-overflow-modal");
 
@@ -34,6 +34,7 @@ var TagOverflowModal = function TagOverflowModal(_ref) {
     _ref$modalAriaLabel = _ref.modalAriaLabel,
     modalAriaLabel = _ref$modalAriaLabel === void 0 ? defaults.modalAriaLabel : _ref$modalAriaLabel,
     onClose = _ref.onClose,
+    onTagClose = _ref.onTagClose,
     open = _ref.open,
     overflowType = _ref.overflowType,
     portalTargetIn = _ref.portalTarget,
@@ -84,11 +85,20 @@ var TagOverflowModal = function TagOverflowModal(_ref) {
   }, getFilteredItems().map(function (_ref2) {
     var label = _ref2.label,
       id = _ref2.id,
-      filter = _ref2.filter;
-    var isFilterable = overflowType === 'tag' ? filter : false;
-    return /*#__PURE__*/React.createElement(react.Tag, {
+      filter = _ref2.filter,
+      onClose = _ref2.onClose;
+    var isFilterable = overflowType === 'tag' && (typeof onClose === 'function' || filter);
+    return isFilterable ? /*#__PURE__*/React.createElement(react.DismissibleTag, {
       key: id,
-      filter: isFilterable
+      text: label,
+      onClose: function onClose() {
+        return onTagClose === null || onTagClose === void 0 ? void 0 : onTagClose({
+          label: label,
+          id: id
+        });
+      }
+    }) : /*#__PURE__*/React.createElement(react.Tag, {
+      key: id
     }, label);
   }), /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__fade")
@@ -100,6 +110,7 @@ TagOverflowModal.propTypes = {
   }))),
   className: index.default.string,
   onClose: index.default.func,
+  onTagClose: index.default.func,
   open: index.default.bool,
   overflowType: index.default.oneOf(['default', 'tag']),
   portalTarget: index.default.node,

package/lib/components/TagOverflow/TagOverflowPopover.js

@@ -90,17 +90,25 @@ var TagOverflowPopover = /*#__PURE__*/React.forwardRef(function (props, ref) {
       _onClose = _ref.onClose,
       other = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded2);
     var typeValue = overflowType === 'tag' ? 'high-contrast' : tagType;
-    var isFilterable = overflowType === 'tag' ? filter : false;
+    var isFilterable = overflowType === 'tag' && (typeof _onClose === 'function' || filter);
+    var tag;
+    if (isFilterable) {
+      tag = /*#__PURE__*/React.createElement(react.DismissibleTag, _rollupPluginBabelHelpers.extends({}, other, {
+        onClose: function onClose() {
+          return _onClose === null || _onClose === void 0 ? void 0 : _onClose();
+        },
+        type: typeValue,
+        text: label
+      }));
+    } else {
+      tag = /*#__PURE__*/React.createElement(react.Tag, _rollupPluginBabelHelpers.extends({}, other, {
+        type: typeValue
+      }), label);
+    }
     return /*#__PURE__*/React.createElement("li", {
       className: cx("".concat(blockClass, "__tag-item"), _rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty({}, "".concat(blockClass, "__tag-item--default"), overflowType === 'default'), "".concat(blockClass, "__tag-item--tag"), overflowType === 'tag')),
       key: id
-    }, overflowType === 'tag' ? /*#__PURE__*/React.createElement(react.Tag, _rollupPluginBabelHelpers.extends({}, other, {
-      onClose: function onClose() {
-        return _onClose === null || _onClose === void 0 ? void 0 : _onClose();
-      },
-      type: typeValue,
-      filter: isFilterable
-    }), label) : label);
+    }, overflowType === 'tag' ? tag : label);
   })), ((_overflowTags$length = overflowTags === null || overflowTags === void 0 ? void 0 : overflowTags.length) !== null && _overflowTags$length !== void 0 ? _overflowTags$length : 0) > (allTagsModalSearchThreshold !== null && allTagsModalSearchThreshold !== void 0 ? allTagsModalSearchThreshold : 0) && /*#__PURE__*/React.createElement(react.Link, {
     className: "".concat(blockClass, "__show-all-tags-link"),
     href: "",

package/lib/components/TagSet/TagSet.d.ts

@@ -6,6 +6,10 @@ type OverflowType = 'default' | 'tag';
 type TagType = {
     label: string;
     type?: keyof typeof tagTypes;
+    /**
+     * @deprecated Use the `onClose` function instead to render as a DismissibleTag
+     */
+    filter?: boolean;
 } & TagBaseProps;
 export interface TagSetProps extends PropsWithChildren {
     /**

package/lib/components/TagSet/TagSet.js

@@ -20,8 +20,8 @@ var settings = require('../../settings.js');
 var useResizeObserver = require('../../global/js/hooks/useResizeObserver.js');
 
 var _excluded = ["align", "allTagsModalTarget", "className", "maxVisible", "multiline", "overflowAutoAlign", "overflowAlign", "overflowClassName", "overflowType", "allTagsModalAriaLabel", "allTagsModalTitle", "allTagsModalSearchLabel", "allTagsModalSearchPlaceholderText", "showAllTagsLabel", "onOverflowClick", "tags", "containingElementRef", "measurementOffset", "onOverflowTagChange"],
-  _excluded2 = ["label", "id"],
-  _excluded3 = ["label", "onClose"];
+  _excluded2 = ["label", "id", "filter", "onClose"],
+  _excluded3 = ["label", "onClose", "filter"];
 var componentName = 'TagSet';
 var blockClass = "".concat(settings.pkg.prefix, "--tag-set");
 var allTagsModalSearchThreshold = 10;
@@ -110,6 +110,8 @@ exports.TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     setHiddenSizingTags(tags && tags.length > 0 ? tags.map(function (_ref2, index) {
       var label = _ref2.label,
         id = _ref2.id,
+        filter = _ref2.filter,
+        onClose = _ref2.onClose,
         other = _rollupPluginBabelHelpers.objectWithoutProperties(_ref2, _excluded2);
       return /*#__PURE__*/React.createElement("div", {
         key: index,
@@ -119,7 +121,10 @@ exports.TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
             newSizingTags[index] = el;
           }
         }
-      }, /*#__PURE__*/React.createElement(react.Tag, _rollupPluginBabelHelpers.extends({}, other, {
+      }, typeof onClose === 'function' || filter ? /*#__PURE__*/React.createElement(react.DismissibleTag, _rollupPluginBabelHelpers.extends({}, other, {
+        "data-original-id": id,
+        text: label
+      })) : /*#__PURE__*/React.createElement(react.Tag, _rollupPluginBabelHelpers.extends({}, other, {
         // ensure id is not duplicated
         "data-original-id": id
       }), label));
@@ -138,15 +143,22 @@ exports.TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     var newDisplayedTags = tags && tags.length > 0 ? tags.map(function (_ref3, index) {
       var label = _ref3.label,
         _onClose = _ref3.onClose,
+        filter = _ref3.filter,
         other = _rollupPluginBabelHelpers.objectWithoutProperties(_ref3, _excluded3);
       if (index == tags.length - 1 && other.size) {
         size = other.size;
       }
+      if (typeof _onClose === 'function' || filter) {
+        return /*#__PURE__*/React.createElement(react.DismissibleTag, _rollupPluginBabelHelpers.extends({}, other, {
+          key: "displayed-tag-".concat(index),
+          onClose: function onClose() {
+            return handleTagOnClose(_onClose, index);
+          },
+          text: label
+        }));
+      }
       return /*#__PURE__*/React.createElement(react.Tag, _rollupPluginBabelHelpers.extends({}, other, {
-        key: "displayed-tag-".concat(index),
-        onClose: function onClose() {
-          return handleTagOnClose(_onClose, index);
-        }
+        key: "displayed-tag-".concat(index)
       }), label);
     }) : [];
 

package/lib/components/TagSet/TagSetModal.js

@@ -98,7 +98,6 @@ var TagSetModal = function TagSetModal(_ref) {
     var label = _ref2.label,
       other = _rollupPluginBabelHelpers.objectWithoutProperties(_ref2, _excluded2);
     return /*#__PURE__*/React.createElement(react.Tag, _rollupPluginBabelHelpers.extends({}, other, {
-      filter: false,
       key: "all-tags-".concat(index)
     }), label);
   }), /*#__PURE__*/React.createElement("div", {

package/lib/components/Tearsheet/TearsheetShell.d.ts

@@ -10,6 +10,11 @@ import PropTypes from 'prop-types';
 import { type ButtonProps } from '@carbon/react';
 interface TearsheetShellProps extends PropsWithChildren {
     actions?: ButtonProps<'button'>[];
+    /**
+     * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency,
+     * accountability, and explainability at the UI level.
+     */
+    aiLabel?: ReactNode;
     ariaLabel?: string;
     /**
      * An optional class or classes to be added to the outermost element.
@@ -96,15 +101,15 @@ interface TearsheetShellProps extends PropsWithChildren {
      * Specifies the width of the tearsheet, 'narrow' or 'wide'.
      */
     size: 'narrow' | 'wide';
-    /**
-     *  **Experimental:** Provide a `Slug` component to be rendered inside the `Tearsheet` component
-     */
-    slug?: ReactNode;
     /**
      * The main title of the tearsheet, displayed in the header area.
      */
     title?: ReactNode;
     verticalPosition?: 'normal' | 'lower';
+    /**
+     * @deprecated Property replaced by `aiLabel`
+     */
+    slug?: ReactNode;
 }
 export type CloseIconDescriptionTypes = {
     hasCloseIcon?: false;
@@ -126,6 +131,10 @@ export declare const tearsheetHasCloseIcon: (actions: any, hasCloseIcon: any) =>
 export declare const TearsheetShell: React.ForwardRefExoticComponent<(TearsheetShellProps & CloseIconDescriptionTypes) & React.RefAttributes<HTMLDivElement>>;
 export declare const portalType: PropTypes.Requireable<object>;
 export declare const deprecatedProps: {
+    /**
+     *  @deprecated Property replaced by `aiLabel`
+     */
+    slug: (props: any, propName: any, comp: any, loc: any, propFullName: any, secret: any) => any;
     /**
      * **Deprecated**
      *

package/lib/components/Tearsheet/TearsheetShell.js

@@ -15,6 +15,7 @@ var cx = require('classnames');
 var settings = require('../../settings.js');
 var pconsole = require('../../global/js/utils/pconsole.js');
 var getNodeTextContent = require('../../global/js/utils/getNodeTextContent.js');
+var propsHelper = require('../../global/js/utils/props-helper.js');
 var react = require('@carbon/react');
 var ActionSet = require('../ActionSet/ActionSet.js');
 var Wrap = require('../../global/js/utils/Wrap.js');
@@ -22,7 +23,7 @@ var usePortalTarget = require('../../global/js/hooks/usePortalTarget.js');
 var useFocus = require('../../global/js/hooks/useFocus.js');
 var usePreviousValue = require('../../global/js/hooks/usePreviousValue.js');
 
-var _excluded = ["actions", "ariaLabel", "children", "className", "closeIconDescription", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "selectorsFloatingMenus", "size", "slug", "title", "verticalPosition", "launcherButtonRef"];
+var _excluded = ["actions", "aiLabel", "ariaLabel", "children", "className", "closeIconDescription", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "selectorsFloatingMenus", "size", "slug", "title", "verticalPosition", "launcherButtonRef"];
 
 // The block part of our conventional BEM class names (bc__E--M).
 var bc = "".concat(settings.pkg.prefix, "--tearsheet");
@@ -65,6 +66,7 @@ var tearsheetHasCloseIcon = function tearsheetHasCloseIcon(actions, hasCloseIcon
  * */
 var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var actions = _ref.actions,
+    aiLabel = _ref.aiLabel,
     ariaLabel = _ref.ariaLabel,
     children = _ref.children,
     className = _ref.className,
@@ -84,7 +86,7 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _ref$selectorsFloatin = _ref.selectorsFloatingMenus,
     selectorsFloatingMenus = _ref$selectorsFloatin === void 0 ? [] : _ref$selectorsFloatin,
     size = _ref.size,
-    slug = _ref.slug,
+    deprecated_slug = _ref.slug,
     title = _ref.title,
     verticalPosition = _ref.verticalPosition,
     launcherButtonRef = _ref.launcherButtonRef,
@@ -92,7 +94,7 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var carbonPrefix = react.usePrefix();
   var bcModalHeader = "".concat(carbonPrefix, "--modal-header");
   var renderPortalUse = usePortalTarget.usePortalTarget(portalTargetIn);
-  var localRef = React.useRef();
+  var localRef = React.useRef(undefined);
   var resizer = React.useRef(null);
   var modalBodyRef = React.useRef(null);
   var modalRef = ref || localRef;
@@ -123,7 +125,7 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     setPosition = _useState4[1];
 
   // Keep a record of the previous value of depth.
-  var prevDepth = React.useRef();
+  var prevDepth = React.useRef(undefined);
   React.useEffect(function () {
     prevDepth.current = depth;
   });
@@ -161,15 +163,21 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   React.useEffect(function () {
     if (open) {
       // Focusing the first element or selectorPrimaryFocus element
-      setTimeout(function () {
-        if (selectorPrimaryFocus) {
-          return specifiedElement === null || specifiedElement === void 0 ? void 0 : specifiedElement.focus();
+      if (selectorPrimaryFocus && useFocus.getSpecificElement(modalRef === null || modalRef === void 0 ? void 0 : modalRef.current, selectorPrimaryFocus)) {
+        var _window2;
+        var specifiedEl = useFocus.getSpecificElement(modalRef === null || modalRef === void 0 ? void 0 : modalRef.current, selectorPrimaryFocus);
+        if (specifiedEl && ((_window2 = window) === null || _window2 === void 0 || (_window2 = _window2.getComputedStyle(specifiedEl)) === null || _window2 === void 0 ? void 0 : _window2.display) !== 'none') {
+          setTimeout(function () {
+            return specifiedEl.focus();
+          }, 0);
+          return;
         }
-        firstElement === null || firstElement === void 0 || firstElement.focus();
+      }
+      setTimeout(function () {
+        return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
       }, 0);
     }
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [open]);
+  }, [firstElement, modalRef, open, selectorPrimaryFocus]);
   React.useEffect(function () {
     if (prevOpen && !open && launcherButtonRef) {
       setTimeout(function () {
@@ -254,15 +262,13 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       return _rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty({}, "--".concat(bc, "--stacking-scale-factor-single"), (width - 32) / width), "--".concat(bc, "--stacking-scale-factor-double"), (width - 64) / width);
     };
     return renderPortalUse( /*#__PURE__*/React.createElement(react.unstable_FeatureFlags, {
-      flags: {
-        'enable-experimental-focus-wrap-without-sentinels': true
-      }
+      enableExperimentalFocusWrapWithoutSentinels: true
     }, /*#__PURE__*/React.createElement(react.ComposedModal, _rollupPluginBabelHelpers.extends({}, rest, {
       "aria-label": ariaLabel || getNodeTextContent.getNodeTextContent(title),
-      className: cx(bc, className, _rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty({}, "".concat(bc, "--stacked-").concat(position, "-of-").concat(depth),
+      className: cx(bc, className, _rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty({}, "".concat(bc, "--stacked-").concat(position, "-of-").concat(depth),
       // Don't apply this on the initial open of a single tearsheet.
-      depth > 1 || depth === 1 && ((_prevDepth$current = prevDepth === null || prevDepth === void 0 ? void 0 : prevDepth.current) !== null && _prevDepth$current !== void 0 ? _prevDepth$current : 0) > 1), "".concat(bc, "--wide"), wide), "".concat(bc, "--narrow"), !wide), "".concat(bc, "--has-slug"), slug), "".concat(bc, "--has-close"), effectiveHasCloseIcon)),
-      slug: slug,
+      depth > 1 || depth === 1 && ((_prevDepth$current = prevDepth === null || prevDepth === void 0 ? void 0 : prevDepth.current) !== null && _prevDepth$current !== void 0 ? _prevDepth$current : 0) > 1), "".concat(bc, "--wide"), wide), "".concat(bc, "--narrow"), !wide), "".concat(bc, "--has-slug"), deprecated_slug), "".concat(bc, "--has-ai-label"), aiLabel), "".concat(bc, "--has-close"), effectiveHasCloseIcon)),
+      slug: aiLabel || deprecated_slug,
       style: setScaleValues(),
       containerClassName: cx("".concat(bc, "__container"), _rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty({}, "".concat(bc, "__container--lower"), verticalPosition === 'lower'), "".concat(bc, "__container--mixed-size-stacking"), !areAllSameSizeVariant())),
       onClose: onClose,
@@ -340,6 +346,10 @@ var portalType = typeof Element === 'undefined' ? index.default.object :
 // eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
 index.default.instanceOf(Element);
 var deprecatedProps = {
+  /**
+   *  @deprecated Property replaced by `aiLabel`
+   */
+  slug: propsHelper.deprecateProp(index.default.node, 'Property replaced by `aiLabel`'),
   /**
    * **Deprecated**
    *
@@ -384,6 +394,11 @@ TearsheetShell.propTypes = _rollupPluginBabelHelpers.objectSpread2({
     /**@ts-ignore*/
     onClick: react.Button.propTypes.onClick
   }))),
+  /**
+   * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency,
+   * accountability, and explainability at the UI level.
+   */
+  aiLabel: index.default.oneOfType([index.default.node, index.default.bool]),
   /**
    * The main content of the tearsheet.
    */
@@ -490,10 +505,6 @@ TearsheetShell.propTypes = _rollupPluginBabelHelpers.objectSpread2({
    */
   /**@ts-ignore*/
   size: index.default.oneOf(['narrow', 'wide']).isRequired,
-  /**
-   *  **Experimental:** Provide a `Slug` component to be rendered inside the `Tearsheet` component
-   */
-  slug: index.default.node,
   /**
    * The main title of the tearsheet, displayed in the header area.
    */

package/lib/components/Toolbar/Toolbar.js

@@ -27,7 +27,7 @@ exports.Toolbar = /*#__PURE__*/React.forwardRef(function (_ref, r) {
     className = _ref.className,
     vertical = _ref.vertical,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
-  var focusableElements = React.useRef();
+  var focusableElements = React.useRef(undefined);
   var getFocusableElements$1 = React.useCallback(function () {
     return focusableElements.current;
   }, [focusableElements]);

package/lib/components/TooltipTrigger/TooltipTrigger.d.ts

@@ -2,7 +2,7 @@ export function TooltipTrigger({ children, className, ...rest }: {
     [x: string]: any;
     children: any;
     className: any;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;
 export namespace TooltipTrigger {
     export { componentName as displayName };
     export namespace propTypes {
@@ -10,6 +10,7 @@ export namespace TooltipTrigger {
         let className: PropTypes.Requireable<string>;
     }
 }
+import React from 'react';
 declare const componentName: "TooltipTrigger";
 import PropTypes from 'prop-types';
 export {};

package/lib/components/TruncatedList/TruncatedList.js

@@ -69,7 +69,7 @@ exports.TruncatedList = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _useState4 = _rollupPluginBabelHelpers.slicedToArray(_useState3, 2),
     listHeight = _useState4[0],
     setListHeight = _useState4[1];
-  var listRef = React.useRef();
+  var listRef = React.useRef(undefined);
   var handleToggle = function handleToggle() {
     setIsCollapsed(function (prev) {
       return !prev;

package/lib/components/_Canary/Canary.d.ts

@@ -2,11 +2,12 @@ export function Canary({ className, componentName, ...rest }: {
     [x: string]: any;
     className: any;
     componentName: any;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;
 export namespace Canary {
     namespace propTypes {
         let className: PropTypes.Requireable<string>;
         let componentName: PropTypes.Validator<string>;
     }
 }
+import React from 'react';
 import PropTypes from 'prop-types';

package/lib/global/js/hooks/usePreviousValue.js

@@ -15,7 +15,7 @@ var React = require('react');
  * @returns {T | undefined} - The previous value of the same type, or undefined if there is none
  */
 var usePreviousValue = function usePreviousValue(value) {
-  var ref = React.useRef();
+  var ref = React.useRef(undefined);
   React.useEffect(function () {
     ref.current = value;
   });