@carbon/ibm-products 2.3.1 → 2.4.0

package/lib/components/Datagrid/Extensions/ColumnCustomization/ColumnCustomization.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: 'Customizing columns',
+      description: "Customizing columns allows user to reorder and hide certain columns of the datagrid. Consuming component can use the provided callback to save/update according to their persistent strategy.\n- Include `useCustomizeColumns` and `useColumnOrder` hooks (required)\n  - `useColumnOrder` comes from `react-table` but is exported by `@carbon/ibm-products` to be used alongside `useCustomizeColumns`.\n- Implement `options.DatagridActions` component\n  - this component will have props: `datagridState`\n  - render `datagridState.CustomizeColumnsButton` component wherever makes sense.\n- Options available to set:\n  - `options.initialState.hiddenColumns: Array<ColumnId: String>`\n    - Array of column ids that will be hidden after initial render\n    - [react-table doc](https://react-table.tanstack.com/docs/api/useTable#table-options)\n  - `options.initialState.columnOrder: Array<ColumnId: String>`\n    - Order of the columns. Any column ids not in this array will be ordered by their position in the `options.columns`\n    - [react-table doc](https://react-table.tanstack.com/docs/api/useColumnOrder#table-options)\n  - `options.customizeColumnsProps.onSaveColumnPrefs`\n    - type: `Function(Columns: Array<{ColumnId: String, isVisible: Boolean}>) => void`\n    - Callback function when 'Save' button clicked on the narrow tearsheet. It allows consumer to preserve the updated column preference. This output can also be used to compute the `hiddenColumns` and `columnOrder`\n  - Reset to default (optional)\n    - There is a reset to default button on the modal. It will use the `options.columns` as the default. If there are columns should be hidden by default, denote them with property: `isVisible: false` (undefined will be treated as `true`).\n        ",
+      source: {
+        code: "\nconst columns = React.useMemo(() => defaultHeader, []);\nconst [data] = useState(makeData(10));\nconst DatagridActions = (datagridState) => (\n  <TableToolbarContent>\n    <TableToolbarSearch ... />\n    <Button ... />\n    <datagridState.CustomizeColumnsButton />\n  </TableToolbarContent>\n)\nconst datagridState = useDatagrid(\n  {\n    columns,\n    data,\n    initialState: {\n      hiddenColumns: ['age'],\n      columnOrder: [],\n    },\n    customizeColumnsProps: {\n      onSaveColumnPrefs: (newColDefs) => {\n        console.log(newColDefs);\n      },\n    },\n    DatagridActions,\n  },\n  useCustomizeColumns,\n  useColumnOrder,\n);\n\nreturn (\n  <Datagrid datagridState={datagridState} />\n);\n          "
+      }
+    }]
+  });
+};
+exports.DocsPage = DocsPage;

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

@@ -0,0 +1,55 @@
+"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 _EditableCell = require("./EditableCell.stories");
+var DocsPage = function DocsPage() {
+  return /*#__PURE__*/_react.default.createElement(_StoryDocsPage.StoryDocsPage, {
+    blocks: [{
+      description: "The `Datagrid` supports inline editing when used with the `useEditableCell` hook (previously named `useInlineEdit` in v1) and columns are provided the required configuration. The four data types supported are strings, numbers, dates, and\n        selection (dropdown)."
+    }, {
+      description: "Below are example column configurations for the supported inline edit data types:\n        \nDefault/string:\n        ",
+      source: {
+        language: 'json',
+        code: "\n  {\n    Header: 'First Name',\n    accessor: 'firstName',\n    inlineEdit: {\n      type: 'text',\n      // required for including validation, this is used to set the invalid prop internally\n      validator: (n) => n.length >= 40,\n      // These props are passed to the Carbon component used for inline editing, in this case the TextInput\n      inputProps: {\n        invalidText: 'Invalid text, character count must be less than 40',\n      },\n    },\n  }\n          "
+      }
+    }, {
+      description: 'Number',
+      source: {
+        language: 'json',
+        code: "\n{\n  Header: 'Age',\n  accessor: 'age',\n  width: 120,\n  inlineEdit: {\n    // required for including validation, this is used to set the invalid prop internally\n    validator: (n) => n && n < 18,\n    type: 'number',\n    // These props are passed to the Carbon component used for inline editing, in this case NumberInput\n    inputProps: {\n      invalidText: 'Invalid number, must be 18 or greater',\n    },\n  },\n},\n          "
+      }
+    }, {
+      description: 'Date',
+      source: {
+        language: 'json',
+        code: "\n{\n  Header: 'Active since',\n  accessor: 'activeSince',\n  inlineEdit: {\n    type: 'date',\n    inputProps: {\n      // optionally pass props here to be passed through to Carbon's DatePicker component\n      onChange: (newDateObj, cell) => {\n        console.log(newDateObj, cell);\n      },\n      labelText: 'Change active since date',\n      // optionally pass props here to be passed through to Carbon's DatePickerInput component\n      datePickerInputProps: {\n        labelText: 'Change active since date',\n      },\n    },\n  },\n},\n          "
+      }
+    }, {
+      description: 'Selection',
+      source: {
+        language: 'json',
+        code: "\n{\n  Header: 'Chart type',\n  accessor: 'chartType',\n  inlineEdit: {\n    type: 'selection',\n    inputProps: {\n      // These props are passed to the Carbon component used for inline editing\n      items: [\n        {\n          id: 'option-0',\n          icon: ChartColumnFloating16,\n          text: 'Column Chart',\n        },\n        {\n          id: 'option-1',\n          icon: ChartBubble16,\n          text: 'Bubble Chart',\n        },\n        {\n          id: 'option-2',\n          icon: ChartVennDiagram16,\n          text: 'Venn Diagram',\n        },\n      ],\n      onChange: (item) => {\n        console.log(item);\n      },\n    },\n  },\n},\n          "
+      }
+    }, {
+      description: "Using the column structure outlined above, along with the use of the `useEditableCell` hook (previously named `useInlineEdit` in v1), the `Datagrid` will support inline editing. See example below:",
+      source: {
+        code: "\nimport { Datagrid, useDatagrid, useEditableCell } from '@carbon/ibm-products';\nconst App = () => {\n  const [data, setData] = useState(makeData(10));\n  const columns = React.useMemo(() => getInlineEditColumns(), []); // These columns follow the inline edit column configuration detailed above\n  const datagridState = useDatagrid(\n    {\n      columns,\n      data,\n      onDataUpdate: setData,\n    },\n    useEditableCell\n  );\n  return <Datagrid datagridState={datagridState} />;\n};\n          "
+      },
+      story: _EditableCell.EditableCellUsageStory
+    }, {
+      title: 'Using deprecated useInlineEdit hook',
+      description: "At this time, it is possible to still use the deprecated `useInlineEdit` hook but requires setting a feature flag. See example below:",
+      source: {
+        code: "\nimport {\n  Datagrid,\n  useDatagrid,\n  useInlineEdit,\n  pkg,\n} from '@carbon/ibm-products';\n\nconst MyInlineEditDatagrid = () => {\n  pkg.feature['Datagrid.useInlineEdit'] = true;\n  const [data, setData] = useState(gridData);\n  const datagridState = useDatagrid(\n    {\n      columns,\n      data,\n      onDataUpdate: setData,\n    },\n    useInlineEdit\n  );\n  return <Datagrid datagridState={datagridState} />;\n};\n          "
+      },
+      story: _EditableCell.InlineEditUsageStory
+    }]
+  });
+};
+exports.DocsPage = DocsPage;

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/EditSidePanel/EditSidePanel.js

@@ -16,6 +16,7 @@ var _settings = require("../../settings");
 var _react2 = require("@carbon/react");
 var _SidePanel = require("../SidePanel");
 require("../../global/js/utils/props-helper");
+var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
 var _excluded = ["children", "className", "disableSubmit", "formTitle", "formDescription", "onRequestClose", "onRequestSubmit", "open", "placement", "primaryButtonText", "secondaryButtonText", "selectorPrimaryFocus", "selectorPageContent", "size", "slideIn", "subtitle", "title"];
 /**
  * Copyright IBM Corp. 2021, 2021
@@ -78,6 +79,7 @@ var EditSidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref)
     onClick: onRequestClose,
     kind: 'secondary'
   }];
+  var formTitleId = (0, _uuidv.default)();
   return /*#__PURE__*/_react.default.createElement(_SidePanel.SidePanel, (0, _extends2.default)({}, rest, _objectSpread({
     open: open,
     ref: ref,
@@ -95,11 +97,13 @@ var EditSidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref)
     preventCloseOnClickOutside: true,
     actions: actions
   }), formTitle && /*#__PURE__*/_react.default.createElement("h3", {
+    id: formTitleId,
     className: "".concat(blockClass, "__form-title-text ").concat(blockClass, "__content-text")
   }, formTitle), formDescription && /*#__PURE__*/_react.default.createElement("p", {
     className: "".concat(blockClass, "__form-description-text ").concat(blockClass, "__content-text")
   }, formDescription), /*#__PURE__*/_react.default.createElement(_react2.Form, {
-    className: "".concat(blockClass, "__form")
+    className: "".concat(blockClass, "__form"),
+    "aria-labelledby": formTitleId
   }, children));
 });
 
@@ -135,7 +139,7 @@ EditSidePanel.propTypes = {
   /**
    * Specifies a required field that provides a title for a form
    */
-  formTitle: _propTypes.default.node,
+  formTitle: _propTypes.default.node.isRequired,
   /**
    * Specifies an optional handler which is called when the CreateSidePanel
    * is closed.

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/Tearsheet/TearsheetShell.js

@@ -270,7 +270,8 @@ var TearsheetShell = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref)
       actions: actions,
       buttonSize: wide ? '2xl' : null,
       className: "".concat(bc, "__buttons"),
-      size: wide ? '2xl' : 'lg'
+      size: wide ? '2xl' : 'lg',
+      "aria-hidden": !open
     })))), /*#__PURE__*/_react.default.createElement("div", {
       className: "".concat(bc, "__resize-detector"),
       ref: resizer

package/lib/global/js/hooks/useResizeObserver.js

@@ -60,7 +60,7 @@ var useResizeObserver = function useResizeObserver(ref, callback) {
       observer = null;
     };
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [ref]);
+  }, [ref.current]);
   return {
     width: width,
     height: height

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.1",
+  "version": "2.4.0",
   "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": "65c475a4fc38ce8ba3cc285e9f646df8d4bc2499"
+  "gitHead": "ce43460f28f908aeb8ec4bfb2c501dd457d11a58"
 }

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/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%;
 }