@carbon/ibm-products 2.3.2 → 2.4.1

package/lib/components/Datagrid/Extensions/ExpandableRow/ExpandableRow.docs-page.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DocsPage = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _StoryDocsPage = require("../../../../global/js/utils/StoryDocsPage");
+var DocsPage = function DocsPage() {
+  return /*#__PURE__*/_react.default.createElement(_StoryDocsPage.StoryDocsPage, {
+    blocks: [{
+      description: "The `Datagrid` supports expandable rows with the use of the `useExpandedRow` hook.",
+      source: {
+        language: 'jsx',
+        code: "\nimport { Datagrid, useDatagrid, useExpandedRow } from '@carbon/ibm-products';\n\nconst App = () => {\n  const columns = React.useMemo(() => defaultHeader, []); // These are the columns that will be used by the datagrid\n  const [data] = useState(makeData(10)); // This is the data that will be rendered by the datagrid\n\n  const expansionRenderer = ({ row }) => {\n    return <div>Content for row index: {row.id}</div>;\n  };\n\n  const datagridState = useDatagrid(\n    {\n      columns,\n      data,\n      ExpandedRowContentComponent: expansionRenderer,\n    },\n    useExpandedRow\n  );\n\n  return <Datagrid datagridState={datagridState} />;\n};\n          "
+      }
+    }]
+  });
+};
+exports.DocsPage = DocsPage;

package/lib/components/Datagrid/Extensions/Filtering/Filtering.docs-page.js

@@ -0,0 +1,65 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DocsPage = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _StoryDocsPage = require("../../../../global/js/utils/StoryDocsPage");
+var DocsPage = function DocsPage() {
+  return /*#__PURE__*/_react.default.createElement(_StoryDocsPage.StoryDocsPage, {
+    blocks: [{
+      title: 'Filtering',
+      description: "Table filtering allows a user to add or remove data items from a data table by selecting or clearing predefined attributes. Filters can help a user find something they're looking for, view available options within a certain set of criteria, and decide between many options. These guidelines are an extension of [Carbon's filter documentation](https://carbondesignsystem.com/patterns/filtering/).\n        "
+    }, {
+      description: "Filtering results in a table is a different type of action from searching. While both actions can help the user narrow results down, searching is meant to help the user find a specific result, whereas filtering allows users to trim results according to its attributes."
+    }, {
+      description: "Applied filters can affect both the data that is visible in the table and also data that might not be displayed in the columns available in the table. Filter options can be displayed in many form components, including dropdowns, text inputs, checkboxes, radio buttons, and date range pickers."
+    }, {
+      description: "[Check out the Guidance here.](https://pages.github.ibm.com/cdai-design/pal/components/data-table/filters/)"
+    }, {
+      subTitle: 'Preparing your column headers'
+    }, {
+      description: 'To utilize filtering, you have to add some extra properties into your headers that are going to be filtered.'
+    }, {
+      description: "Two things you need to do is:\n- Specify a `filter` to use (unless it's text match which is default)\n- (Optional) Render the component with the `Cell` property to display the right information. Use this if the data you send into the table isn't how you want to display it, for example like Dates. See the example for `passwordStrength` below.\n        "
+    }, {
+      description: "For example; here we are specifying that the `joined` header column should be filtered using a `filter: 'date'`, and render the cell using it's value and converting it to string. (Since the value of joined is a date object, react isn't going to allow you to render it as jsx so we have to convert it to string)",
+      source: {
+        code: "\n{\n  Header: 'Joined',\n  accessor: 'joined',\n  filter: 'date',\n  Cell: ({ cell: { value } }) => <span>{value.toLocaleDateString()}</span>,\n},\n          "
+      }
+    }, {
+      description: "The different types of filters are:\n- text (default)\n- date\n- number\n- checkbox\n- radio\n- dropdown\n        ",
+      source: {
+        code: "\nconst columns = [\n  {\n    Header: 'Row Index',\n    accessor: (row, i) => i,\n    sticky: 'left',\n    id: 'rowIndex', // id is required when accessor is a function.\n  },\n  {\n    Header: 'First Name',\n    accessor: 'firstName',\n  },\n  {\n    Header: 'Last Name',\n    accessor: 'lastName',\n  },\n  {\n    Header: 'Age',\n    accessor: 'age',\n    width: 50,\n  },\n  {\n    Header: 'Visits',\n    accessor: 'visits',\n    filter: 'number',\n    width: 60,\n  },\n  {\n    Header: 'Status',\n    accessor: 'status',\n    filter: 'dropdown',\n  },\n  // Shows the date filter example\n  {\n    Header: 'Joined',\n    accessor: 'joined',\n    filter: 'date',\n    Cell: ({ cell: { value } }) => <span>{value.toLocaleDateString()}</span>,\n  },\n  // Shows the checkbox filter example\n  {\n    Header: 'Password strength',\n    accessor: 'passwordStrength',\n    filter: 'checkbox',\n    Cell: ({ cell: { value } }) => {\n      const iconProps = {\n        size: 'sm',\n        theme: 'light',\n        kind: value,\n        iconDescription: value,\n      };\n\n      return (\n        <span\n          style={{\n            display: 'flex',\n            justifyContent: 'center',\n            alignItems: 'center',\n          }}\n        >\n          <StatusIcon {...iconProps} />\n          {iconProps.iconDescription}\n        </span>\n      );\n    },\n  },\n  // Shows the checkbox filter example\n  {\n    Header: 'Role',\n    accessor: 'role',\n    filter: 'radio',\n  },\n];\n          "
+      }
+    }, {
+      subTitle: 'Store you data into state, this can also come from an API',
+      source: {
+        code: "\nconst [data] = useState([\n  {\n    activeSince: new Date('09/26/81'),\n    age: 41,\n    firstName: 'Joel',\n    lastName: 'Miller',\n    passwordStrength: 'normal',\n    role: 'developer',\n    visits: '81',\n  },\n  {\n    activeSince: new Date('08/30/97'),\n    age: 19,\n    firstName: 'Ellie',\n    lastName: 'N/A',\n    passwordStrength: 'critical',\n    role: 'designer',\n    visits: '7',\n  },\n  {\n    activeSince: new Date('01/26/03'),\n    age: 39,\n    firstName: 'Tommy',\n    lastName: 'Miller',\n    passwordStrength: 'minor-warning',\n    role: 'researcher',\n    visits: '25',\n  },\n]);\n          "
+      }
+    }, {
+      subTitle: 'Create your filters for flyout variant',
+      description: "To add filters to the flyout, you have to pass in an array of filters. These filters will be converted to it's respective component. Each filters has 3 important props, `type`, `column`, `props`.\n- `type`: the type of filter (this should be the same `filter` property in the headers)\n- `column`: the column that it should be filtered on\n- `props`: the props for the components needed to render the filter.\n\nPlease refer to all the available filters that you can use below.\n        ",
+      source: {
+        code: "\nconst filters = [\n  {\n    type: 'date',\n    column: 'joined',\n    props: {\n      DatePicker: {\n        datePickerType: 'range',\n        // Add any other Carbon DatePicker props here\n      },\n      DatePickerInput: {\n        start: {\n          id: 'date-picker-input-id-start',\n          placeholder: 'mm/dd/yyyy',\n          labelText: 'Joined start date',\n          // Add any other Carbon DatePickerInput props here\n        },\n        end: {\n          id: 'date-picker-input-id-end',\n          placeholder: 'mm/dd/yyyy',\n          labelText: 'Joined end date',\n          // Add any other Carbon DatePickerInput props here\n        },\n      },\n    },\n  },\n  {\n    type: 'number',\n    column: 'visits',\n    props: {\n      NumberInput: {\n        min: 0,\n        id: 'visits-number-input',\n        invalidText: 'A valid value is required',\n        label: 'Visits',\n        placeholder: 'Type a number amount of visits',\n        // Add any other Carbon NumberInput props here\n      },\n    },\n  },\n  {\n    type: 'checkbox',\n    column: 'passwordStrength',\n    props: {\n      FormGroup: {\n        legendText: 'Password strength',\n        // Add any other Carbon FormGroup props here\n      },\n      Checkbox: [\n        {\n          id: 'normal',\n          labelText: 'Normal',\n          value: 'normal',\n          // Add any other Carbon Checkbox props here\n        },\n        {\n          id: 'minor-warning',\n          labelText: 'Minor warning',\n          value: 'minor-warning',\n          // Add any other Carbon Checkbox props here\n        },\n        {\n          id: 'critical',\n          labelText: 'Critical',\n          value: 'critical',\n          // Add any other Carbon Checkbox props here\n        },\n      ],\n    },\n  },\n  {\n    type: 'radio',\n    column: 'role',\n    props: {\n      FormGroup: {\n        legendText: 'Role',\n        // Add any other Carbon FormGroup props here\n      },\n      RadioButtonGroup: {\n        orientation: 'vertical',\n        legend: 'Role legend',\n        name: 'role-radio-button-group',\n        // Add any other Carbon RadioButtonGroup props here\n      },\n      RadioButton: [\n        {\n          id: 'developer',\n          labelText: 'Developer',\n          value: 'developer',\n          // Add any other Carbon RadioButton props here\n        },\n        {\n          id: 'designer',\n          labelText: 'Designer',\n          value: 'designer',\n          // Add any other Carbon RadioButton props here\n        },\n        {\n          id: 'researcher',\n          labelText: 'Researcher',\n          value: 'researcher',\n          // Add any other Carbon RadioButton props here\n        },\n      ],\n    },\n  },\n  {\n    type: 'dropdown',\n    column: 'status',\n    props: {\n      Dropdown: {\n        id: 'marital-status-dropdown',\n        ariaLabel: 'Marital status dropdown',\n        items: ['relationship', 'complicated', 'single'],\n        label: 'Marital status',\n        titleText: 'Marital status',\n        // Add any other Carbon Dropdown props here\n      },\n    },\n  },\n];\n          "
+      }
+    }, {
+      subTitle: 'Create your filters for panel variant',
+      description: 'Filter panel coming soon.'
+    }, {
+      subTitle: 'Putting it all together',
+      source: {
+        code: "\nimport { Datagrid, useDatagrid, useFiltering } from '@carbon/ibm-products';\n\nconst App = () => {\n  const columns = [...];\n  const [data] = useState([...]);\n  const filters = [...];\n\n\n  const datagridState = useDatagrid(\n    {\n      columns,\n      data,\n      filterProps: {\n        variation: 'flyout', // default\n        updateMethod: 'batch', // default\n        primaryActionLabel: 'Apply', // default\n        secondaryActionLabel: 'Cancel', // default\n        flyoutIconDescription: 'Open filters', // default\n        shouldClickOutsideToClose: false, // default\n        filters,\n      },\n      DatagridActions,\n      batchActions: true,\n      toolbarBatchActions: getBatchActions(),\n    },\n    useFiltering\n  );\n\n  return <Datagrid datagridState={datagridState} />;\n};\n          "
+      }
+    }, {
+      subTitle: "`filterProps` types",
+      source: {
+        language: 'json',
+        code: "\nfilterProps: {\n  /** The variation of filtering */\n  variation: 'flyout'|'panel',\n  /** The update method in which to filter, instant automatically\n      applies the filters, batch the user has to click apply */\n  updateMethod: 'batch'|'instant',\n  /** Text for primary action button, default is 'Apply' */\n  primaryActionLabel: string,\n  /** Text for secondary action button, default is 'Cancel' */\n  secondaryActionLabel: string,\n  /** Text for flyout icon description */\n  flyoutIconDescription: string,\n  /** Array of objects to render filters in flyout */\n  filters: object[]\n}\n          "
+      }
+    }]
+  });
+};
+exports.DocsPage = DocsPage;

package/lib/components/Datagrid/Extensions/RowActionButtons/RowActionButtons.docs-page.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DocsPage = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _StoryDocsPage = require("../../../../global/js/utils/StoryDocsPage");
+var DocsPage = function DocsPage() {
+  return /*#__PURE__*/_react.default.createElement(_StoryDocsPage.StoryDocsPage, {
+    blocks: [{
+      title: 'Actions column',
+      description: "This will add row actions (if more than two actions are provided an OverflowMenu component will be used) to the cells on the column marked with `isAction: true`. Each action button callback will include the actionId and the row object.\n- Include useActionsColumn hook\n- Add `isAction = true` to the column object in which you which to add the overflow menu actions\n- Add `rowActions = []` array to the props\n  - `rowActions[].id` for callback to identify the action is called\n  - `rowActions[].onClick(actionId: string, row: Row, event: ClickEvent)` callback on menuitem clicked. [Row properties](https://react-table.tanstack.com/docs/api/useTable#row-properties)\n  - `rowActions[].shouldHideMenuItem(row: Row)` callback to hide this menuitem. [Row properties](https://react-table.tanstack.com/docs/api/useTable#row-properties)\n  - `rowActions[].shouldDisableMenuItem(row: Row)` callback to disable this menuitem. [Row properties](https://react-table.tanstack.com/docs/api/useTable#row-properties)\n    - This will override `rowActions[].disabled` (from Carbon) because `shouldDisableMenuItem` is more specific to the row.\n  - each action object can take all the props from OverflowMenuItem props, see [carbon docs](https://react.carbondesignsystem.com/?path=/docs/components-overflowmenu--default#overflowmenu)\n        ",
+      source: {
+        code: "\nconst columns = [\n  // other columns\n  {\n    Header: '',\n    accessor: 'actions',\n    isAction: true,\n  },\n];\nconst onActionClick = (actionId, row, event) => {};\nconst datagridState = useDatagrid(\n  {\n    columns,\n    data,\n    rowActions: [\n      {\n        id: 'edit',\n        itemText: 'Edit',\n        onClick: onActionClick,\n      },\n      {\n        id: 'hidden',\n        itemText: 'Hidden item',\n        onClick: onActionClick,\n        shouldHideMenuItem: () => true,\n      },\n      {\n        id: 'delete',\n        itemText: 'Delete',\n        hasDivider: true,\n        isDelete: true,\n        onClick: onActionClick,\n      },\n    ],\n  },\n  useActionsColumn\n);\n\nreturn <Datagrid datagridState={datagridState} />;"
+      }
+    }]
+  });
+};
+exports.DocsPage = DocsPage;

package/lib/components/Datagrid/utils/DatagridActions.js

@@ -134,7 +134,7 @@ var DatagridActions = function DatagridActions(datagridState) {
     hasDivider: true,
     requireTitle: true
   }))) : !mobileToolbar ? /*#__PURE__*/_react2.default.createElement(_react.TableToolbarContent, null, renderFilterPanelButton(), /*#__PURE__*/_react2.default.createElement(_react.TableToolbarSearch, {
-    size: "xl",
+    size: "lg",
     id: "columnSearch",
     persistent: true,
     placeHolderText: searchForAColumn,

package/lib/components/Datagrid/utils/getArgTypes.js

@@ -52,6 +52,10 @@ var ARG_TYPES = {
     control: 'select',
     options: ['sm', 'lg']
   },
+  isFetching: {
+    control: 'radio',
+    options: [true, false]
+  },
   useDenseHeader: {
     control: {
       type: 'radio'

package/lib/components/EditUpdateCards/EditUpdateCards.js

@@ -14,7 +14,7 @@ var _classnames = _interopRequireDefault(require("classnames"));
 var _devtools = require("../../global/js/utils/devtools");
 var _settings = require("../../settings");
 var _ProductiveCard = require("../ProductiveCard");
-var _excluded = ["actionIcons", "actionsPlacement", "className", "description", "editChildren", "editMode", "label", "previewChildren", "title", "titleSize"];
+var _excluded = ["actionIcons", "actionsPlacement", "className", "description", "editChildren", "editMode", "label", "onPrimaryButtonClick", "onSecondaryButtonClick", "previewChildren", "title", "titleSize", "primaryButtonIcon", "primaryButtonText", "secondaryButtonIcon", "secondaryButtonText"];
 /**
  * Copyright IBM Corp. 2022, 2022
  *
@@ -59,12 +59,30 @@ var EditUpdateCards = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     editChildren = _ref.editChildren,
     editMode = _ref.editMode,
     label = _ref.label,
+    onPrimaryButtonClick = _ref.onPrimaryButtonClick,
+    onSecondaryButtonClick = _ref.onSecondaryButtonClick,
     previewChildren = _ref.previewChildren,
     title = _ref.title,
     titleSize = _ref.titleSize,
+    primaryButtonIcon = _ref.primaryButtonIcon,
+    primaryButtonText = _ref.primaryButtonText,
+    secondaryButtonIcon = _ref.secondaryButtonIcon,
+    secondaryButtonText = _ref.secondaryButtonText,
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
-  // const [editMode, setEditMode] = useState(false);
+  // const [editCardMode, setEditCardMode] = useState(editMode);
 
+  var conditionalProps = {
+    onPrimaryButtonClick: onPrimaryButtonClick,
+    onSecondaryButtonClick: onSecondaryButtonClick,
+    primaryButtonIcon: primaryButtonIcon,
+    primaryButtonKind: 'ghost',
+    primaryButtonPlacement: 'top',
+    primaryButtonText: primaryButtonText,
+    secondaryButtonIcon: secondaryButtonIcon,
+    secondaryButtonKind: 'ghost',
+    secondaryButtonPlacement: 'top',
+    secondaryButtonText: secondaryButtonText
+  };
   return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
     className: (0, _classnames.default)(blockClass,
     // Apply the block class to the main HTML element
@@ -73,7 +91,7 @@ var EditUpdateCards = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     (0, _defineProperty2.default)({}, "".concat(blockClass, "__actions-bottom"), actionsPlacement === 'bottom')),
     ref: ref,
     role: "main"
-  }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement(_ProductiveCard.ProductiveCard, {
+  }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement(_ProductiveCard.ProductiveCard, (0, _extends2.default)({
     actionIcons: actionIcons,
     actionsPlacement: actionsPlacement,
     className: className,
@@ -81,7 +99,7 @@ var EditUpdateCards = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     label: label,
     title: title,
     titleSize: titleSize
-  }, editMode === false && /*#__PURE__*/_react.default.createElement("div", null, previewChildren), editMode && /*#__PURE__*/_react.default.createElement("div", null, editChildren)));
+  }, editMode && conditionalProps), editMode === false && /*#__PURE__*/_react.default.createElement("div", null, previewChildren), editMode && /*#__PURE__*/_react.default.createElement("div", null, editChildren)));
 });
 
 // Return a placeholder if not released and not enabled by feature flag
@@ -131,10 +149,54 @@ EditUpdateCards.propTypes = {
    * Optional label for the top of the card
    */
   label: _propTypes.default.string,
+  /**
+   * Function that's called from the primary button or action icon
+   */
+  onPrimaryButtonClick: _propTypes.default.func,
+  /**
+   * Function that's called from the secondary button or action icon
+   */
+  onSecondaryButtonClick: _propTypes.default.func,
   /**
    * Preview mode children
    */
   previewChildren: _propTypes.default.node,
+  /**
+   * Optional prop to allow overriding the icon rendering. Can be a React component class
+   */
+  primaryButtonIcon: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
+  /**
+   * Establishes the kind of button displayed for the primary button
+   */
+  primaryButtonKind: _propTypes.default.oneOf(['primary', 'ghost']),
+  /**
+   * Determines if the primary button is on the top or bottom of the card
+   */
+  primaryButtonPlacement: _propTypes.default.oneOf(['top', 'bottom']),
+  /**
+   * The text that's displayed in the primary button
+   */
+  primaryButtonText: _propTypes.default.string,
+  /**
+   * Optionally specify an href for your Button to become an <a> element
+   */
+  secondaryButtonHref: _propTypes.default.string,
+  /**
+   * Optional prop to allow overriding the icon rendering. Can be a React component class
+   */
+  secondaryButtonIcon: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
+  /**
+   * Establishes the kind of button displayed for the secondary button
+   */
+  secondaryButtonKind: _propTypes.default.oneOf(['secondary', 'ghost']),
+  /**
+   * Determines if the secondary button is on the top or bottom of the card
+   */
+  secondaryButtonPlacement: _propTypes.default.oneOf(['top', 'bottom']),
+  /**
+   * The text that's displayed in the secondary button
+   */
+  secondaryButtonText: _propTypes.default.string,
   /**
    * Title that's displayed at the top of the card
    */

package/lib/components/FilterSummary/FilterSummary.js

@@ -27,13 +27,16 @@ var FilterSummary = /*#__PURE__*/_react2.default.forwardRef(function (_ref, ref)
     _ref$clearFilters = _ref.clearFilters,
     clearFilters = _ref$clearFilters === void 0 ? function () {} : _ref$clearFilters,
     _ref$filters = _ref.filters,
-    filters = _ref$filters === void 0 ? [] : _ref$filters;
+    filters = _ref$filters === void 0 ? [] : _ref$filters,
+    _ref$renderLabel = _ref.renderLabel,
+    renderLabel = _ref$renderLabel === void 0 ? null : _ref$renderLabel;
   var tagFilters = filters.map(function (_ref2) {
+    var _renderLabel;
     var key = _ref2.key,
       value = _ref2.value;
     return {
       type: 'gray',
-      label: "".concat(key, ": ").concat(value)
+      label: (_renderLabel = renderLabel === null || renderLabel === void 0 ? void 0 : renderLabel(key, value)) !== null && _renderLabel !== void 0 ? _renderLabel : "".concat(key, ": ").concat(value)
     };
   });
   return /*#__PURE__*/_react2.default.createElement("div", {
@@ -57,7 +60,8 @@ FilterSummary.propTypes = {
   className: _propTypes.default.string,
   clearFilters: _propTypes.default.func.isRequired,
   clearFiltersText: _propTypes.default.string,
-  filters: _propTypes.default.arrayOf(_propTypes.default.object).isRequired
+  filters: _propTypes.default.arrayOf(_propTypes.default.object).isRequired,
+  renderLabel: _propTypes.default.func
 };
 var _default = FilterSummary;
 exports.default = _default;

package/lib/components/OptionsTile/OptionsTile.js

@@ -233,7 +233,14 @@ var OptionsTile = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   })), isExpandable ? /*#__PURE__*/_react.default.createElement("details", {
     open: isOpen,
     ref: detailsRef
-  }, /*#__PURE__*/_react.default.createElement("summary", {
+  },
+  /*#__PURE__*/
+  /* summary should not be considered non-interactive
+   * https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/issues/656
+   * https://github.com/A11yance/axobject-query/issues/319
+   */
+  /* eslint-disable jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions */
+  _react.default.createElement("summary", {
     className: "".concat(blockClass, "__header"),
     onClick: toggle
   }, /*#__PURE__*/_react.default.createElement(_icons.ChevronDown, {

package/lib/components/ProductiveCard/ProductiveCard.js

@@ -35,7 +35,7 @@ var ProductiveCard = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
   var _ref$actionsPlacement = _ref.actionsPlacement,
     actionsPlacement = _ref$actionsPlacement === void 0 ? defaults.actionsPlacement : _ref$actionsPlacement,
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
-  var validProps = (0, _propsHelper.prepareProps)(rest, ['media', 'mediaPosition', 'onSecondaryButtonClick', 'pictogram', 'primaryButtonClick', 'productive', 'secondaryButtonKind', 'secondaryButtonText']);
+  var validProps = (0, _propsHelper.prepareProps)(rest, ['media', 'mediaPosition', 'pictogram', 'primaryButtonClick', 'productive', 'secondaryButtonKind']);
   return /*#__PURE__*/_react.default.createElement(_Card.Card, (0, _extends2.default)({}, _objectSpread(_objectSpread({}, validProps), {}, {
     actionsPlacement: actionsPlacement,
     ref: ref
@@ -91,6 +91,10 @@ ProductiveCard.propTypes = {
    * Function that's called from the primary button or action icon
    */
   onPrimaryButtonClick: _propTypes.default.func,
+  /**
+   * Function that's called from the secondary button or action icon
+   */
+  onSecondaryButtonClick: _propTypes.default.func,
   /**
    * Use an overflow menu instead of action icons. Refer to design documentation for implementation guidelines
    */
@@ -120,6 +124,22 @@ ProductiveCard.propTypes = {
    * The text that's displayed in the primary button
    */
   primaryButtonText: _propTypes.default.node,
+  /**
+   * Optionally specify an href for your Button to become an <a> element
+   */
+  secondaryButtonHref: _propTypes.default.string,
+  /**
+   * Optional prop to allow overriding the icon rendering. Can be a React component class
+   */
+  secondaryButtonIcon: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
+  /**
+   * Determines if the secondary button is on the top or bottom of the card
+   */
+  secondaryButtonPlacement: _propTypes.default.oneOf(['top', 'bottom']),
+  /**
+   * The text that's displayed in the secondary button
+   */
+  secondaryButtonText: _propTypes.default.node,
   /**
    * Title that's displayed at the top of the card
    */

package/lib/global/js/utils/StoryDocsPage.js

@@ -30,7 +30,7 @@ var CustomBlocks = function CustomBlocks(_ref) {
       key: "block-index--".concat(index)
     }, block.title && /*#__PURE__*/_react.default.createElement("h3", {
       id: (0, _changeCase.paramCase)(block.title)
-    }, block.title), block.subTitle && /*#__PURE__*/_react.default.createElement("h4", null, block.subTitle), block.description && typeof block.description === 'string' ? /*#__PURE__*/_react.default.createElement(_blocks.Description, null, block.description) : block.description, block.story && /*#__PURE__*/_react.default.createElement(_blocks.Canvas, {
+    }, block.title), block.subTitle && /*#__PURE__*/_react.default.createElement("h4", null, block.subTitle), block.image, block.description && typeof block.description === 'string' ? /*#__PURE__*/_react.default.createElement(_blocks.Description, null, block.description) : block.description, block.story && /*#__PURE__*/_react.default.createElement(_blocks.Canvas, {
       of: block.story
     }), block.source && /*#__PURE__*/_react.default.createElement(_blocks.Source, source));
   });
@@ -201,6 +201,10 @@ StoryDocsPage.propTypes = {
      * Optional description, strings treated as markdown.
      */
     description: _propTypes.default.node,
+    /**
+     * Optional block image
+     */
+    image: _propTypes.default.node,
     /**
      * Story imported from story file
      */
@@ -210,7 +214,7 @@ StoryDocsPage.propTypes = {
      * default language `jsx`
      */
     source: _propTypes.default.shape({
-      language: _propTypes.default.oneOf('javascript', 'css', 'jsx'),
+      language: _propTypes.default.oneOf('javascript', 'css', 'jsx', 'json'),
       code: _propTypes.default.string
     })
   })),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/ibm-products",
   "description": "Carbon for IBM Products",
-  "version": "2.3.2",
+  "version": "2.4.1",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -54,27 +54,27 @@
     "upgrade-dependencies": "npm-check-updates -u --dep dev,peer,prod --color --reject '/(carbon|^react$|^react-dom$|^chalk$|^react-dnd|^namor)/'"
   },
   "devDependencies": {
-    "@babel/cli": "^7.21.5",
-    "@babel/core": "^7.22.1",
-    "babel-preset-ibm-cloud-cognitive": "^0.14.36",
+    "@babel/cli": "^7.22.5",
+    "@babel/core": "^7.22.5",
+    "babel-preset-ibm-cloud-cognitive": "^0.14.37",
     "chalk": "^4.1.2",
     "change-case": "^4.1.2",
     "copyfiles": "^2.4.1",
     "cross-env": "^7.0.3",
     "fs-extra": "^11.1.1",
-    "glob": "^10.2.6",
+    "glob": "^10.3.1",
     "jest": "^29.5.0",
-    "jest-config-ibm-cloud-cognitive": "^0.24.23",
+    "jest-config-ibm-cloud-cognitive": "^0.24.24",
     "jest-environment-jsdom": "^29.5.0",
     "namor": "^1.1.2",
-    "npm-check-updates": "^16.10.12",
+    "npm-check-updates": "^16.10.13",
     "npm-run-all": "^4.1.5",
     "rimraf": "^5.0.1",
-    "sass": "^1.62.1",
+    "sass": "^1.63.6",
     "yargs": "^17.7.2"
   },
   "dependencies": {
-    "@babel/runtime": "^7.22.3",
+    "@babel/runtime": "^7.22.5",
     "@carbon/telemetry": "^0.1.0",
     "framer-motion": "^6.5.1 < 7",
     "immutability-helper": "^3.1.1",
@@ -85,14 +85,14 @@
     "react-window": "^1.8.9"
   },
   "peerDependencies": {
-    "@carbon/grid": "^11.15.0",
-    "@carbon/layout": "^11.15.0",
-    "@carbon/motion": "^11.12.0",
-    "@carbon/react": "^1.31.3",
-    "@carbon/themes": "^11.20.0",
-    "@carbon/type": "^11.19.0",
+    "@carbon/grid": "^11.16.1",
+    "@carbon/layout": "^11.16.1",
+    "@carbon/motion": "^11.13.1",
+    "@carbon/react": "^1.33.2",
+    "@carbon/themes": "^11.21.1",
+    "@carbon/type": "^11.20.1",
     "react": "^16.8.6 || ^17.0.1",
     "react-dom": "^16.8.6 || ^17.0.1"
   },
-  "gitHead": "d10acc630bdeb946d794ea2430d5df1ebf650c14"
+  "gitHead": "3e735167a2cc5e2a7e2f87069c4ae1bc31ce0736"
 }

package/scss/components/Datagrid/_datagrid.scss

@@ -7,6 +7,7 @@
 
 // Standard imports.
 @use '@carbon/styles/scss/spacing' as *;
+@use '@carbon/styles/scss/theme' as *;
 @use '../../global/styles/project-settings' as c4p-settings;
 @use '../../global/styles/mixins';
 
@@ -33,19 +34,25 @@ $block-class: #{c4p-settings.$pkg-prefix}--datagrid;
   :global(.#{c4p-settings.$carbon-prefix}--checkbox) {
     display: none;
   }
+}
 
-  .#{c4p-settings.$carbon-prefix}--overflow-menu-options
-    > .#{c4p-settings.$pkg-prefix}--datagrid__row-size-dropdown {
-    left: $spacing-01;
-    width: 112px;
-  }
+.#{$block-class}
+  .#{c4p-settings.$pkg-prefix}--datagrid__row-size-options-container
+  .#{c4p-settings.$carbon-prefix}--popover-container
+  .#{c4p-settings.$carbon-prefix}--btn--icon-only {
+  display: flex;
+  width: $spacing-09;
+  height: $spacing-09;
+  align-items: center;
+  justify-content: center;
+  padding-top: 0;
 }
 
-.#{$block-class}__datagridWrap
-  .#{c4p-settings.$carbon-prefix}--overflow-menu-options
-  > .#{c4p-settings.$pkg-prefix}--datagrid__row-size-dropdown {
-  left: $spacing-01;
-  width: 112px;
+.#{$block-class}
+  .#{c4p-settings.$pkg-prefix}--datagrid__row-size-options-container
+  .#{c4p-settings.$pkg-prefix}--datagrid__row-size-dropdown {
+  padding: $spacing-05;
+  background-color: $layer;
 }
 
 .#{$block-class}__datagridWrap-simple {

package/scss/components/Datagrid/_storybook-styles.scss

@@ -54,6 +54,11 @@ $block-class: #{c4p-settings.$pkg-prefix}--datagrid;
   padding-bottom: $spacing-06;
 }
 
+.#{$block-class}__side-panel-link {
+  padding-top: $spacing-01;
+  padding-bottom: $spacing-06;
+}
+
 .#{$block-class}__side-panel-section-inner {
   display: flex;
   padding: $spacing-01 0;

package/scss/components/EditUpdateCards/_edit-update-cards.scss

@@ -31,6 +31,9 @@ $block-class: #{c4p-settings.$pkg-prefix}--edit-update-cards;
     .#{c4p-settings.$pkg-prefix}--card__header,
     .#{c4p-settings.$pkg-prefix}--card__footer {
       button {
+        // stylelint-disable-next-line carbon/theme-token-use
+        color: $white-0;
+
         &:hover {
           // stylelint-disable-next-line carbon/theme-token-use
           background-color: $blue-60-hover;
@@ -54,12 +57,14 @@ $block-class: #{c4p-settings.$pkg-prefix}--edit-update-cards;
         }
       }
     }
+
     .#{c4p-settings.$pkg-prefix}--card__footer {
       // stylelint-disable-next-line carbon/theme-token-use
       background-color: $blue-60;
       // stylelint-disable-next-line carbon/theme-token-use
       color: $white-0;
     }
+
     .#{c4p-settings.$pkg-prefix}--loading {
       animation-duration: $duration-slow-02;
       animation-fill-mode: forwards;
@@ -71,7 +76,12 @@ $block-class: #{c4p-settings.$pkg-prefix}--edit-update-cards;
         background-color: transparent;
       }
     }
+
+    .#{c4p-settings.$pkg-prefix}--card__header-container {
+      align-items: center;
+    }
   }
+
   &:not(.#{$block-class}__actions-bottom) {
     &##{$block-class}--edit {
       .#{c4p-settings.$pkg-prefix}--card__header {

package/scss/components/FilterSummary/_storybook-styles.scss

@@ -4,6 +4,8 @@
 // This source code is licensed under the Apache-2.0 license found in the
 // LICENSE file in the root directory of this source tree.
 //
+@use '../../global/styles/display-box' as *;
+
 #root {
   width: 100%;
 }

package/scss/components/ProductiveCard/_productive-card.scss

@@ -77,6 +77,21 @@ $block-class: #{c4p-settings.$pkg-prefix}--card;
       &::before {
         opacity: 0;
       }
+
+      + .#{$block-class}__actions-header-ghost-button {
+        /* stylelint-disable-next-line max-nesting-depth */
+        &::before {
+          opacity: 0;
+        }
+      }
+    }
+
+    /* stylelint-disable-next-line max-nesting-depth */
+    &:first-child:not(:last-child) {
+      /* stylelint-disable-next-line max-nesting-depth */
+      &::before {
+        display: none;
+      }
     }
   }
 

package/scss/components/Tearsheet/_tearsheet.scss

@@ -127,6 +127,12 @@ $motion-duration: $duration-moderate-02;
     width: 100%;
   }
 
+  &.#{$block-class}--wide
+    .#{$pkg-prefix}--action-set
+    .#{$pkg-prefix}--action-set__action-button.#{$pkg-prefix}--action-set__action-button--expressive {
+    height: $spacing-11;
+  }
+
   @include breakpoint(md) {
     &.#{$block-class}--wide .#{$block-class}__container {
       width: calc(100% - (2 * #{$spacing-10}));