@carbon/ibm-products 2.22.0 → 2.24.0

package/es/components/CoachmarkStack/CoachmarkStack.js

@@ -0,0 +1,283 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["children", "className", "onClose", "description", "media", "navLinkLabels", "portalTarget", "closeButtonLabel", "tagline", "theme", "title"];
+/**
+ * Copyright IBM Corp. 2023, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// Import portions of React that are needed.
+import React, { Children, useEffect, useRef, useState, useCallback } from 'react';
+import { createPortal } from 'react-dom';
+
+// Other standard imports.
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import { pkg /*, carbon */ } from '../../settings';
+
+// Carbon and package components we use.
+/* TODO: @import(s) of carbon components and other package components. */
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(pkg.prefix, "--coachmark-stack");
+var componentName = 'CoachmarkStack';
+var elementBlockClass = "".concat(pkg.prefix, "--coachmark-stack-element");
+import { CoachmarkOverlay } from '../Coachmark/CoachmarkOverlay';
+import { CoachmarkStackHome } from './CoachmarkStackHome';
+import { CoachmarkTagline } from '../Coachmark/CoachmarkTagline';
+import { CoachmarkContext } from '../Coachmark/utils/context';
+import { COACHMARK_OVERLAY_KIND } from '../Coachmark/utils/enums';
+var defaults = {
+  onClose: function onClose() {},
+  // Pass through to CoachmarkStackHome
+  theme: 'light'
+};
+
+// NOTE
+// The stack is limited to a depth of two Coachmarks:
+// - a single parent CoachmarkStackHome
+// - a single child Coachmark when stacked
+// The parent will include links to all the children.
+// No child Coachmark will include links to any other child Coachmarks.
+
+/**
+ * Stacked coachmarks are used to call out specific functionality or concepts
+ * within the UI that may not be intuitive but are important for the
+ * user to gain understanding of the product's main value and discover new use cases.
+ * This variant allows the stacking of multiple coachmark overlays to be displayed by interacting with the tagline.
+ */
+export var CoachmarkStack = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
+  var _document$querySelect;
+  var children = _ref.children,
+    className = _ref.className,
+    _ref$onClose = _ref.onClose,
+    onClose = _ref$onClose === void 0 ? defaults.onClose : _ref$onClose,
+    description = _ref.description,
+    media = _ref.media,
+    navLinkLabels = _ref.navLinkLabels,
+    _ref$portalTarget = _ref.portalTarget,
+    portalTarget = _ref$portalTarget === void 0 ? defaults.portalTarget : _ref$portalTarget,
+    closeButtonLabel = _ref.closeButtonLabel,
+    tagline = _ref.tagline,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    title = _ref.title,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
+  var stackHomeRef = useRef();
+  var stackedCoachmarkRefs = useRef([]);
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isOpen = _useState2[0],
+    setIsOpen = _useState2[1];
+  // selectedItemNumber -1 = parent close button was clicked, remove entire stack
+  // selectedItemNumber 0 = (default) the parent is visible, all children are hidden
+  // selectedItemNumber 1+ = a child is visible and stacked atop the parent
+  var _useState3 = useState(0),
+    _useState4 = _slicedToArray(_useState3, 2),
+    selectedItemNumber = _useState4[0],
+    setSelectedItemNumber = _useState4[1];
+  // // The parent height and width values to return to after unstacked
+  var _useState5 = useState(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    parentHeight = _useState6[0],
+    setParentHeight = _useState6[1];
+  // parent height = child height when stacked behind a child that is shorter
+  var childArray = Children.toArray(children);
+  var mountedRef = useRef();
+  // same value as CSS animation speed
+  var delayMs = 240;
+
+  // Unmount or unstack a child
+  var handleClickNavItem = function handleClickNavItem(itemNumber) {
+    setSelectedItemNumber(itemNumber);
+  };
+  var handleClose = useCallback(function (isParentCloseButton) {
+    if (isParentCloseButton) {
+      // Trigger slide-out animation
+      setSelectedItemNumber(-1);
+
+      // Unmount after animation is complete
+      var timer = setTimeout(function () {
+        setIsOpen(false);
+        onClose();
+      }, delayMs);
+      return function () {
+        return clearTimeout(timer);
+      };
+    } else {
+      // Unstack child
+      setSelectedItemNumber(0);
+    }
+  }, [onClose]);
+  var escFunction = useCallback(function (event) {
+    if (event.key === 'Escape') {
+      selectedItemNumber === 0 ? handleClose(true) : handleClose(false);
+    }
+  }, [handleClose, selectedItemNumber]);
+  useEffect(function () {
+    document.addEventListener('keydown', escFunction, false);
+    return function () {
+      document.removeEventListener('keydown', escFunction, false);
+    };
+  }, [escFunction]);
+  var contextValue = {
+    buttonProps: {
+      tabIndex: 0,
+      'aria-expanded': isOpen,
+      onClick: function onClick() {
+        setIsOpen(true);
+      },
+      // Compensate for accidental open/close on double-click.
+      // Only open on double-click.
+      onDoubleClick: function onDoubleClick() {
+        setIsOpen(true);
+      }
+    },
+    closeButtonProps: {
+      onClick: function onClick() {
+        return handleClose(false);
+      }
+    },
+    isOpen: isOpen
+  };
+  useEffect(function () {
+    mountedRef.current = true;
+    return function () {
+      mountedRef.current = false;
+    };
+  }, []);
+  useEffect(function () {
+    setTimeout(function () {
+      if (stackHomeRef.current) {
+        setParentHeight(stackHomeRef.current.clientHeight + 16);
+      }
+    }, 0);
+  }, [stackHomeRef]);
+  useEffect(function () {
+    var targetSelectedItem = selectedItemNumber - 1;
+    if (!parentHeight) {
+      return;
+    }
+    stackHomeRef.current.style.height = "".concat(parentHeight, "px");
+    if (!isOpen || targetSelectedItem < 0) {
+      stackHomeRef.current.focus();
+      return;
+    }
+    var targetHomeHeight = stackedCoachmarkRefs.current[targetSelectedItem].clientHeight;
+    stackHomeRef.current.style.height = "".concat(targetHomeHeight, "px");
+    stackedCoachmarkRefs.current[targetSelectedItem].focus();
+  }, [selectedItemNumber, isOpen, parentHeight]);
+  var wrappedChildren = Children.map(childArray, function (child, idx) {
+    var mountedClass = mountedRef.current ? "".concat(elementBlockClass, "--is-mounted") : '';
+    return /*#__PURE__*/React.createElement(CoachmarkOverlay, {
+      key: idx,
+      ref: function ref(_ref2) {
+        return stackedCoachmarkRefs.current[idx] = _ref2;
+      },
+      kind: COACHMARK_OVERLAY_KIND.STACKED,
+      onClose: function onClose() {
+        return handleClose(false);
+      },
+      theme: theme,
+      fixedIsVisible: false,
+      className: cx(elementBlockClass, mountedClass, idx === selectedItemNumber - 1 && "".concat(elementBlockClass, "--is-visible"), mountedRef.current && "".concat(elementBlockClass, "--is-mounted"))
+    }, child);
+  });
+  return /*#__PURE__*/React.createElement(CoachmarkContext.Provider, {
+    value: contextValue
+  }, /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    className: cx(blockClass, "".concat(pkg.prefix, "--coachmark-overlay--stack"), className),
+    ref: ref
+  }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement(CoachmarkTagline, {
+    title: tagline,
+    onClose: onClose
+  }), /*#__PURE__*/React.createElement(CoachmarkStackHome, {
+    ref: stackHomeRef,
+    className: cx("".concat(pkg.prefix, "--coachmark-overlay"), "".concat(pkg.prefix, "--coachmark-overlay__").concat(theme), elementBlockClass, selectedItemNumber > 0 && "".concat(elementBlockClass, "--is-stacked"), selectedItemNumber > 0 && "".concat(elementBlockClass, "--is-stacked__").concat(theme), isOpen && "".concat(elementBlockClass, "--is-visible"), mountedRef.current && "".concat(elementBlockClass, "--is-mounted")),
+    isOpen: isOpen && selectedItemNumber < 1,
+    description: description,
+    media: media,
+    navLinkLabels: navLinkLabels,
+    onClickNavItem: handleClickNavItem,
+    onClose: function onClose() {
+      handleClose(true);
+    },
+    portalTarget: portalTarget,
+    closeButtonLabel: closeButtonLabel,
+    title: title
+  }), /*#__PURE__*/createPortal(wrappedChildren, portalNode)));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+CoachmarkStack = pkg.checkComponentEnabled(CoachmarkStack, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+CoachmarkStack.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+CoachmarkStack.propTypes = {
+  /**
+   * CoachmarkStack should use a single CoachmarkOverlayElements component as a child.
+   */
+  children: PropTypes.node.isRequired,
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: PropTypes.string,
+  /**
+   * The label for the button that will close the Stack
+   */
+  closeButtonLabel: PropTypes.string,
+  // Pass through to CoachmarkStackHome
+  /**
+   * The description of the Coachmark.
+   */
+  description: PropTypes.node.isRequired,
+  /**
+   * The object describing an image in one of two shapes.
+   *
+   * If a single media element is required, use `{render}`.
+   *
+   * If a stepped animation is required, use `{filePaths}`.
+   *
+   * @see {@link MEDIA_PROP_TYPE}.
+   */
+  media: PropTypes.oneOfType([PropTypes.shape({
+    render: PropTypes.func
+  }), PropTypes.shape({
+    filePaths: PropTypes.arrayOf(PropTypes.string)
+  })]),
+  /**
+   * The labels used to link to the stackable Coachmarks.
+   */
+  navLinkLabels: PropTypes.arrayOf(PropTypes.string).isRequired,
+  /**
+   * Function to call when the CoachmarkStack closes.
+   */
+  onClose: PropTypes.func,
+  /**
+   * Where in the DOM to render the stack.
+   * The default is `document.body`.
+   */
+  portalTarget: PropTypes.string,
+  /**
+   * The tagline title which will be fixed to the bottom right of the window and will serve as the display trigger.
+   */
+  tagline: PropTypes.string.isRequired,
+  /**
+   * Determines the theme of the component.
+   */
+  theme: PropTypes.oneOf(['light', 'dark']),
+  /**
+   * The title of the Coachmark.
+   */
+  title: PropTypes.string.isRequired
+};

package/es/components/CoachmarkStack/CoachmarkStackHome.js

@@ -0,0 +1,192 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["className", "description", "isOpen", "media", "navLinkLabels", "onClickNavItem", "onClose", "portalTarget", "closeButtonLabel", "title"];
+/**
+ * Copyright IBM Corp. 2023, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import React, { forwardRef, useRef, useEffect, useState } from 'react';
+import pconsole from '../../global/js/utils/pconsole';
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { Idea } from '@carbon/icons-react';
+import { Button } from '@carbon/react';
+import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import { pkg /*, carbon */ } from '../../settings';
+import { createPortal } from 'react-dom';
+import { CoachmarkHeader } from '../Coachmark/CoachmarkHeader';
+import { SteppedAnimatedMedia } from '../SteppedAnimatedMedia';
+
+// Carbon and package components we use.
+/* TODO: @import(s) of carbon components and other package components. */
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(pkg.prefix, "--coachmark-stacked-home");
+var overlayClass = "".concat(pkg.prefix, "--coachmark-overlay");
+var componentName = 'CoachmarkStackHome';
+
+/**
+ * DO NOT USE. This component is for the exclusive use
+ * of other Novice to Pro components.
+ */
+export var CoachmarkStackHome = /*#__PURE__*/forwardRef(function (_ref, ref) {
+  var _document$querySelect;
+  var className = _ref.className,
+    description = _ref.description,
+    isOpen = _ref.isOpen,
+    media = _ref.media,
+    navLinkLabels = _ref.navLinkLabels,
+    onClickNavItem = _ref.onClickNavItem,
+    _onClose = _ref.onClose,
+    portalTarget = _ref.portalTarget,
+    closeButtonLabel = _ref.closeButtonLabel,
+    title = _ref.title,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var buttonFocusRef = useRef();
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    linkFocusIndex = _useState2[0],
+    setLinkFocusIndex = _useState2[1];
+  useEffect(function () {
+    setTimeout(function () {
+      if (isOpen && buttonFocusRef.current) {
+        buttonFocusRef.current.focus();
+      }
+    }, 100);
+  }, [isOpen]);
+  if (!navLinkLabels) {
+    return pconsole.warn("".concat(componentName, " is a Novice to Pro internal component and is not intended for general use."));
+  }
+  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
+  return /*#__PURE__*/createPortal( /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    className: cx(blockClass, className),
+    ref: ref,
+    role: "main"
+  }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement(CoachmarkHeader, {
+    onClose: function onClose() {
+      setLinkFocusIndex(0);
+      _onClose();
+    }
+  }), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(overlayClass, "__body")
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "".concat(overlayClass, "-element")
+  }, !media && /*#__PURE__*/React.createElement(Idea, {
+    size: 20,
+    className: "".concat(blockClass, "__icon-idea")
+  }), media && (media.render ? media.render() : /*#__PURE__*/React.createElement(SteppedAnimatedMedia, {
+    className: "".concat(overlayClass, "__element-stepped-media"),
+    filePaths: media.filePaths,
+    playStep: 0
+  })), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(overlayClass, "-element__content")
+  }, title && /*#__PURE__*/React.createElement("h2", {
+    className: "".concat(overlayClass, "-element__title")
+  }, title), description && /*#__PURE__*/React.createElement("p", {
+    className: "".concat(overlayClass, "-element__body")
+  }, description)), /*#__PURE__*/React.createElement("ul", {
+    className: "".concat(blockClass, "__nav-links")
+  }, navLinkLabels.map(function (label, index) {
+    if (index === linkFocusIndex) {
+      return renderNavLink(index, label, buttonFocusRef);
+    } else {
+      return renderNavLink(index, label);
+    }
+  })), closeButtonLabel && /*#__PURE__*/React.createElement("div", {
+    className: "".concat(overlayClass, "__footer")
+  }, /*#__PURE__*/React.createElement(Button, {
+    size: "sm",
+    onClick: function onClick() {
+      setLinkFocusIndex(0);
+      _onClose();
+    }
+  }, closeButtonLabel))))), portalNode);
+  function renderNavLink(index, label) {
+    var ref = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
+    return /*#__PURE__*/React.createElement("li", {
+      key: index
+    }, /*#__PURE__*/React.createElement(Button, {
+      kind: "ghost",
+      size: "sm",
+      onClick: function onClick() {
+        setLinkFocusIndex(index);
+        onClickNavItem(index + 1);
+      },
+      ref: ref
+    }, label));
+  }
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+CoachmarkStackHome = pkg.checkComponentEnabled(CoachmarkStackHome, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+CoachmarkStackHome.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+CoachmarkStackHome.propTypes = {
+  /**
+   * Optional class name for this component.
+   */
+  className: PropTypes.string,
+  /**
+   * The label for the button that will close the stack
+   */
+  closeButtonLabel: PropTypes.string,
+  /**
+   * The description of the Coachmark.
+   */
+  description: PropTypes.node.isRequired,
+  /**
+   * If the stack home is open.
+   */
+  isOpen: PropTypes.bool.isRequired,
+  /**
+   * The object describing an image in one of two shapes.
+   *
+   * If a single media element is required, use `{render}`.
+   *
+   * If a stepped animation is required, use `{filePaths}`.
+   *
+   * @see {@link MEDIA_PROP_TYPE}.
+   */
+  media: PropTypes.oneOfType([PropTypes.shape({
+    render: PropTypes.func
+  }), PropTypes.shape({
+    filePaths: PropTypes.arrayOf(PropTypes.string)
+  })]),
+  /**
+   * The labels used to link to the stackable Coachmarks.
+   */
+  navLinkLabels: PropTypes.arrayOf(PropTypes.string).isRequired,
+  /**
+   * For internal use only by CoachmarkStack and CoachmarkStackHome.
+   */
+  onClickNavItem: PropTypes.func.isRequired,
+  /**
+   * Function to call when the stack closes.
+   */
+  onClose: PropTypes.func.isRequired,
+  /**
+   * By default, the CoachmarkStackHome will be appended to the end of `document.body`.
+   * The CoachmarkStackHome will remain persistent as the user navigates the app until
+   * the user closes the CoachmarkStackHome.
+   *
+   * Alternatively, the app developer can tightly couple the CoachmarkStackHome to a DOM
+   * element or other component by specifying a CSS selector. The CoachmarkStackHome will
+   * remain visible as long as that element remains visible or mounted. When the
+   * element is hidden or component is unmounted, the CoachmarkStackHome will disappear.
+   */
+  portalTarget: PropTypes.string,
+  /**
+   * The title of the Coachmark.
+   */
+  title: PropTypes.string.isRequired
+};

package/es/components/CoachmarkStack/index.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright IBM Corp. 2023, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+export { CoachmarkStack } from './CoachmarkStack';

package/es/components/Datagrid/Datagrid/DatagridHeaderRow.js

@@ -9,7 +9,7 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 /* eslint-disable react/prop-types */
 /**
- * Copyright IBM Corp. 2020, 2023
+ * Copyright IBM Corp. 2020, 2024
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -23,6 +23,7 @@ import { selectionColumnId } from '../common-column-ids';
 import { pkg } from '../../../settings';
 import { handleColumnResizeEndEvent, handleColumnResizingEvent } from './addons/stateReducer';
 import { getNodeTextContent } from '../../../global/js/utils/getNodeTextContent';
+import { ColumnHeaderSlug } from './addons/Slug/ColumnHeaderSlug';
 var blockClass = "".concat(pkg.prefix, "--datagrid");
 var getAccessibilityProps = function getAccessibilityProps(header) {
   var props = {};
@@ -85,7 +86,8 @@ var ResizeHeader = function ResizeHeader(_ref) {
   }));
 };
 var HeaderRow = function HeaderRow(datagridState, headRef, headerGroup) {
-  var resizerAriaLabel = datagridState.resizerAriaLabel;
+  var resizerAriaLabel = datagridState.resizerAriaLabel,
+    isTableSortable = datagridState.isTableSortable;
   // Used to measure the height of the table and uses that value
   // to display a vertical line to indicate the column you are resizing
   useEffect(function () {
@@ -127,6 +129,14 @@ var HeaderRow = function HeaderRow(datagridState, headRef, headerGroup) {
     headerGroupClassName = _headerGroup$getHeade.className,
     role = _headerGroup$getHeade.role,
     headerGroupProps = _objectWithoutProperties(_headerGroup$getHeade, _excluded2);
+  var renderSlug = function renderSlug(slug) {
+    if (isTableSortable) {
+      return;
+    }
+    return /*#__PURE__*/React.createElement(ColumnHeaderSlug, {
+      slug: slug
+    });
+  };
   return /*#__PURE__*/React.createElement(TableRow, _extends({}, headerGroupProps, {
     className: cx("".concat(blockClass, "__head"), headerGroupClassName),
     ref: headRef
@@ -157,10 +167,10 @@ var HeaderRow = function HeaderRow(datagridState, headRef, headerGroup) {
       headerProps = _objectWithoutProperties(_header$getHeaderProp, _excluded3);
     var resizerProps = header === null || header === void 0 || (_header$getResizerPro = header.getResizerProps) === null || _header$getResizerPro === void 0 ? void 0 : _header$getResizerPro.call(header);
     return /*#__PURE__*/React.createElement(TableHeader, _extends({}, headerProps, {
-      className: cx(headerClassName, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "__resizableColumn"), resizerProps), "".concat(blockClass, "__isResizing"), header.isResizing), "".concat(blockClass, "__sortableColumn"), datagridState.isTableSortable && header.id !== 'spacer'), "".concat(blockClass, "__isSorted"), header.isSorted), "".concat(blockClass, "__header-actions-column"), header.isAction)),
+      className: cx(headerClassName, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "__resizableColumn"), resizerProps), "".concat(blockClass, "__isResizing"), header.isResizing), "".concat(blockClass, "__sortableColumn"), datagridState.isTableSortable && header.id !== 'spacer'), "".concat(blockClass, "__isSorted"), header.isSorted), "".concat(blockClass, "__header-actions-column"), header.isAction), "".concat(blockClass, "__with-slug"), header.slug && /*#__PURE__*/React.isValidElement(header.slug))),
       key: header.id,
       "aria-hidden": header.id === 'spacer' && 'true'
-    }, getAccessibilityProps(header)), header.render('Header'), resizerProps && !header.isAction && /*#__PURE__*/React.createElement(ResizeHeader, {
+    }, getAccessibilityProps(header)), header.render('Header'), renderSlug(header.slug), resizerProps && !header.isAction && /*#__PURE__*/React.createElement(ResizeHeader, {
       resizerProps: resizerProps,
       header: header,
       handleOnMouseDownResize: handleOnMouseDownResize,

package/es/components/Datagrid/Datagrid/DatagridSelectAll.js

@@ -44,7 +44,8 @@ var SelectAll = function SelectAll(datagridState) {
     dispatch = datagridState.dispatch,
     rows = datagridState.rows,
     getRowId = datagridState.getRowId,
-    toggleAllRowsSelected = datagridState.toggleAllRowsSelected;
+    toggleAllRowsSelected = datagridState.toggleAllRowsSelected,
+    onAllRowSelect = datagridState.onAllRowSelect;
   var isFirstColumnStickyLeft = ((_columns$ = columns[0]) === null || _columns$ === void 0 ? void 0 : _columns$.sticky) === 'left' && withStickyColumn;
   if (hideSelectAll || radio) {
     return /*#__PURE__*/React.createElement("div", {
@@ -66,6 +67,7 @@ var SelectAll = function SelectAll(datagridState) {
         indeterminate: true
       });
       toggleAllRowsSelected(false);
+      onAllRowSelect === null || onAllRowSelect === void 0 || onAllRowSelect(rows, event);
       return onChange === null || onChange === void 0 ? void 0 : onChange({
         target: {
           checked: false
@@ -78,6 +80,7 @@ var SelectAll = function SelectAll(datagridState) {
       getRowId: getRowId,
       isChecked: event.target.checked
     });
+    onAllRowSelect === null || onAllRowSelect === void 0 || onAllRowSelect(rows, event);
     return onChange === null || onChange === void 0 ? void 0 : onChange(event);
   };
   return /*#__PURE__*/React.createElement("div", {

package/es/components/Datagrid/Datagrid/DraggableElement.js

@@ -44,7 +44,7 @@ var DraggableElement = function DraggableElement(_ref) {
     size: 16
   })), children);
   var style = {
-    transform: CSS.Transform.toString(transform),
+    transform: !disabled ? CSS.Transform.toString(transform) : {},
     transition: transition
   };
   return /*#__PURE__*/React.createElement("li", _extends({

package/es/components/Datagrid/Datagrid/addons/CustomizeColumns/ButtonWrapper.js

@@ -28,7 +28,7 @@ var ButtonWrapper = function ButtonWrapper(_ref) {
       }, props));
     },
     iconDescription: iconTooltipLabel,
-    tooltipPosition: "left",
+    tooltipPosition: "bottom",
     kind: "ghost",
     hasIconOnly: true,
     "test-id": "".concat(blockClass, "__customize-columns-trigger"),

package/es/components/Datagrid/Datagrid/addons/CustomizeColumns/Columns.js

@@ -38,6 +38,9 @@ var Columns = function Columns(_ref) {
       $splice: [[from, 1], [to, 0, fromCol]]
     }));
   }, [columns, setColumnsObject]);
+  var filteredStickyColumn = columns === null || columns === void 0 ? void 0 : columns.filter(function (item) {
+    return !item.sticky;
+  });
   return /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__customize-columns-column-list"),
     ref: listRef
@@ -61,7 +64,7 @@ var Columns = function Columns(_ref) {
     checked: getVisibleColumnsCount() === columns.length,
     indeterminate: getVisibleColumnsCount() < columns.length && getVisibleColumnsCount() > 0,
     onChange: function onChange() {
-      onSelectColumn(columns, getVisibleColumnsCount() !== columns.length);
+      onSelectColumn(filteredStickyColumn, getVisibleColumnsCount() !== columns.length);
     },
     id: "".concat(blockClass, "__customization-column-select-all"),
     labelText: selectAllLabel

package/es/components/Datagrid/Datagrid/addons/CustomizeColumns/CustomizeColumnsTearsheet.js

@@ -90,7 +90,7 @@ var CustomizeColumnsTearsheet = function CustomizeColumnsTearsheet(_ref) {
   };
   var onCheckboxCheck = function onCheckboxCheck(col, value) {
     var changedDefinitions = columnObjects.map(function (definition) {
-      if (Array.isArray(col) && col.indexOf(definition) != null || definition.id === col.id) {
+      if (Array.isArray(col) && col.indexOf(definition) != -1 || definition.id === col.id) {
         return _objectSpread(_objectSpread({}, definition), {}, {
           isVisible: value
         });

package/es/components/Datagrid/Datagrid/addons/Slug/ColumnHeaderSlug.js

@@ -0,0 +1,26 @@
+/**
+ * Copyright IBM Corp. 2024, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import React, { forwardRef, isValidElement } from 'react';
+import PropTypes from 'prop-types';
+export var ColumnHeaderSlug = /*#__PURE__*/forwardRef(function (_ref, ref) {
+  var slug = _ref.slug;
+  if (slug && /*#__PURE__*/isValidElement(slug)) {
+    var normalizedSlug = /*#__PURE__*/React.cloneElement(slug, {
+      size: 'mini',
+      ref: ref
+    });
+    return normalizedSlug;
+  }
+  return;
+});
+ColumnHeaderSlug.propTypes = {
+  /**
+   * Specify the AI slug to be displayed
+   */
+  slug: PropTypes.node
+};

package/es/components/Datagrid/Datagrid.docs-page.js

@@ -104,9 +104,9 @@ export var DocsPage = function DocsPage() {
       }
     }, {
       title: 'Selecting rows',
-      description: "When building a Datagrid that requires selectable rows, use the `useSelectRows` hook.\n- Include `useSelectRows` hook\n- Add `onRowSelect` to the `useDatagrid` hook, this is a callback function called when on a row's selection checkbox onChange, and sends back the row object and the event\n        ",
+      description: "When building a Datagrid that requires selectable rows, use the `useSelectRows` hook.\n- Include `useSelectRows` hook\n- Add `onRowSelect` to the `useDatagrid` hook, this is a callback function called when on a row's selection checkbox onChange, and sends back the row object and the event\n- Add `onAllRowSelect` to the `useDatagrid` hook, this is a callback function called when on all rows selection checkbox onChange, and sends back all rows object and the event\n        ",
       source: {
-        code: "\nconst [data] = useState(makeData(10));\nconst columns = React.useMemo(() => getColumns(data), []);\nconst datagridState = useDatagrid(\n  {\n    columns,\n    data,\n    onRowSelect: (row, event) => console.log(row, event),\n    batchActionMenuButtonLabel: 'More',\n  },\n  useSelectRows\n);\n\nreturn <Datagrid datagridState={datagridState} />;\n          "
+        code: "\nconst [data] = useState(makeData(10));\nconst columns = React.useMemo(() => getColumns(data), []);\nconst datagridState = useDatagrid(\n  {\n    columns,\n    data,\n    onRowSelect: (row, event) => console.log(row, event),\n    onAllRowSelect: (rows, event) => console.log(rows, event),\n    batchActionMenuButtonLabel: 'More',\n  },\n  useSelectRows\n);\n\nreturn <Datagrid datagridState={datagridState} />;\n          "
       }
     }, {
       description: "The select all checkbox can be optionally hidden by settings the `hideSelectAll` property to `true` in the `useDatagrid` hook.",