@itwin/itwinui-react 3.17.4 → 3.18.1

package/cjs/core/SearchBox/SearchBox.js

@@ -116,11 +116,15 @@ const SearchBoxCollapsedState = ({ children }) => {
     children ?? _react.createElement(SearchBoxExpandButton, null),
   );
 };
+if ('development' === process.env.NODE_ENV)
+  SearchBoxCollapsedState.displayName = 'SearchBox.CollapsedState';
 const SearchBoxExpandedState = ({ children }) => {
   let { isExpanded, expandable } = (0, _index.useSafeContext)(SearchBoxContext);
   if (expandable && !isExpanded) return null;
   return _react.createElement(_react.Fragment, null, children);
 };
+if ('development' === process.env.NODE_ENV)
+  SearchBoxExpandedState.displayName = 'SearchBox.ExpandedState';
 const SearchBoxIcon = _react.forwardRef((props, ref) => {
   let { className, children, ...rest } = props;
   return _react.createElement(
@@ -134,6 +138,8 @@ const SearchBoxIcon = _react.forwardRef((props, ref) => {
     children ?? _react.createElement(_index.SvgSearch, null),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SearchBoxIcon.displayName = 'SearchBox.Icon';
 const SearchBoxInput = _react.forwardRef((props, ref) => {
   let { className, id: idProp, ...rest } = props;
   let { inputId, setInputId, isDisabled, inputRef } = (0,
@@ -152,6 +158,8 @@ const SearchBoxInput = _react.forwardRef((props, ref) => {
     ...rest,
   });
 });
+if ('development' === process.env.NODE_ENV)
+  SearchBoxInput.displayName = 'SearchBox.Input';
 const SearchBoxButton = _react.forwardRef((props, ref) => {
   let { children, ...rest } = props;
   let { size: sizeContext, isDisabled } = (0, _index.useSafeContext)(
@@ -168,6 +176,8 @@ const SearchBoxButton = _react.forwardRef((props, ref) => {
     children ?? _react.createElement(_index.SvgSearch, null),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SearchBoxButton.displayName = 'SearchBox.Button';
 const SearchBoxCollapseButton = _react.forwardRef((props, ref) => {
   let { children, onClick: onClickProp, ...rest } = props;
   let {
@@ -188,6 +198,8 @@ const SearchBoxCollapseButton = _react.forwardRef((props, ref) => {
     children ?? _react.createElement(_index.SvgCloseSmall, null),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SearchBoxCollapseButton.displayName = 'SearchBox.CollapseButton';
 const SearchBoxExpandButton = _react.forwardRef((props, ref) => {
   let { children, onClick: onClickProp, ...rest } = props;
   let {
@@ -210,6 +222,8 @@ const SearchBoxExpandButton = _react.forwardRef((props, ref) => {
     children ?? _react.createElement(_index.SvgSearch, null),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SearchBoxExpandButton.displayName = 'SearchBox.ExpandButton';
 const SearchBox = Object.assign(SearchBoxComponent, {
   Icon: SearchBoxIcon,
   Input: SearchBoxInput,
@@ -219,3 +233,4 @@ const SearchBox = Object.assign(SearchBoxComponent, {
   ExpandedState: SearchBoxExpandedState,
   CollapsedState: SearchBoxCollapsedState,
 });
+if ('development' === process.env.NODE_ENV) SearchBox.displayName = 'SearchBox';

package/cjs/core/Select/Select.js

@@ -30,6 +30,7 @@ const Select = _react.forwardRef((props, forwardedRef) => {
     ref: forwardedRef,
   });
 });
+if ('development' === process.env.NODE_ENV) Select.displayName = 'Select';
 const NativeSelect = _react.forwardRef((props, forwardedRef) => {
   let {
     triggerProps,
@@ -140,6 +141,36 @@ const CustomSelect = _react.forwardRef((props, forwardedRef) => {
     });
     popoverProps?.onVisibleChange?.(false);
   }, [popoverProps]);
+  let handleOptionSelection = _react.useCallback(
+    (option, { isSelected = false } = {}) => {
+      if (isSingleOnChange(onChangeRef.current, multiple)) {
+        setUncontrolledValue(option.value);
+        onChangeRef.current?.(option.value);
+        hide();
+      } else {
+        setUncontrolledValue((prev) =>
+          isSelected
+            ? prev?.filter((i) => option.value !== i)
+            : [...(prev ?? []), option.value],
+        );
+        onChangeRef.current?.(option.value, isSelected ? 'removed' : 'added');
+      }
+      if (isMultipleEnabled(value, multiple)) {
+        let prevSelectedValue = value || [];
+        let newSelectedValue = isSelected
+          ? prevSelectedValue.filter((i) => option.value !== i)
+          : [...prevSelectedValue, option.value];
+        setLiveRegionSelection(
+          options
+            .filter((i) => newSelectedValue.includes(i.value))
+            .map((item) => item.label)
+            .filter(Boolean)
+            .join(', '),
+        );
+      }
+    },
+    [hide, multiple, onChangeRef, options, value],
+  );
   let menuItems = _react.useMemo(
     () =>
       options.map((option, index) => {
@@ -165,34 +196,9 @@ const CustomSelect = _react.forwardRef((props, forwardedRef) => {
             : null,
           onClick: () => {
             if (option.disabled) return;
-            if (isSingleOnChange(onChangeRef.current, multiple)) {
-              setUncontrolledValue(option.value);
-              onChangeRef.current?.(option.value);
-              hide();
-            } else {
-              setUncontrolledValue((prev) =>
-                isSelected
-                  ? prev?.filter((i) => option.value !== i)
-                  : [...(prev ?? []), option.value],
-              );
-              onChangeRef.current?.(
-                option.value,
-                isSelected ? 'removed' : 'added',
-              );
-            }
-            if (isMultipleEnabled(value, multiple)) {
-              let prevSelectedValue = value || [];
-              let newSelectedValue = isSelected
-                ? prevSelectedValue.filter((i) => option.value !== i)
-                : [...prevSelectedValue, option.value];
-              setLiveRegionSelection(
-                options
-                  .filter((i) => newSelectedValue.includes(i.value))
-                  .map((item) => item.label)
-                  .filter(Boolean)
-                  .join(', '),
-              );
-            }
+            handleOptionSelection(option, {
+              isSelected,
+            });
           },
           ref: (el) => {
             if (isSelected && !multiple)
@@ -205,7 +211,7 @@ const CustomSelect = _react.forwardRef((props, forwardedRef) => {
           ...menuItem.props,
         });
       }),
-    [hide, itemRenderer, multiple, onChangeRef, options, value],
+    [handleOptionSelection, itemRenderer, multiple, options, value],
   );
   let selectedItems = _react.useMemo(() => {
     if (null == value) return;
@@ -222,12 +228,18 @@ const CustomSelect = _react.forwardRef((props, forwardedRef) => {
     return index >= 0 ? index : 0;
   }, [options, value]);
   let tagRenderer = _react.useCallback(
-    (item) =>
+    (option) =>
       _react.createElement(_SelectTag.SelectTag, {
-        key: item.label,
-        label: item.label,
+        key: option.label,
+        label: option.label,
+        onRemove: () => {
+          handleOptionSelection(option, {
+            isSelected: true,
+          });
+          selectRef.current?.focus();
+        },
       }),
-    [],
+    [handleOptionSelection],
   );
   let popover = (0, _Popover.usePopover)({
     visible: isOpen,
@@ -281,6 +293,7 @@ const CustomSelect = _react.forwardRef((props, forwardedRef) => {
             },
             triggerProps?.className,
           ),
+          'data-iui-multi': multiple,
         },
         (!selectedItems || 0 === selectedItems.length) &&
           _react.createElement(
@@ -292,10 +305,8 @@ const CustomSelect = _react.forwardRef((props, forwardedRef) => {
             placeholder,
           ),
         isMultipleEnabled(selectedItems, multiple)
-          ? _react.createElement(MultipleSelectButton, {
-              selectedItems: selectedItems,
-              selectedItemsRenderer: selectedItemRenderer,
-              tagRenderer: tagRenderer,
+          ? _react.createElement(_index.AutoclearingHiddenLiveRegion, {
+              text: liveRegionSelection,
             })
           : _react.createElement(SingleSelectButton, {
               selectedItem: selectedItems,
@@ -306,9 +317,12 @@ const CustomSelect = _react.forwardRef((props, forwardedRef) => {
         disabled: disabled,
         isOpen: isOpen,
       }),
-      multiple
-        ? _react.createElement(_index.AutoclearingHiddenLiveRegion, {
-            text: liveRegionSelection,
+      isMultipleEnabled(selectedItems, multiple)
+        ? _react.createElement(MultipleSelectButton, {
+            selectedItems: selectedItems,
+            selectedItemsRenderer: selectedItemRenderer,
+            tagRenderer: tagRenderer,
+            size: 'small' === size ? 'small' : void 0,
           })
         : null,
     ),
@@ -411,6 +425,7 @@ const MultipleSelectButton = ({
   selectedItems,
   selectedItemsRenderer,
   tagRenderer,
+  size,
 }) => {
   let selectedItemsElements = _react.useMemo(() => {
     if (!selectedItems) return [];
@@ -420,19 +435,18 @@ const MultipleSelectButton = ({
     _react.Fragment,
     null,
     selectedItems &&
-      selectedItemsRenderer &&
-      selectedItemsRenderer(selectedItems),
-    selectedItems &&
-      !selectedItemsRenderer &&
       _react.createElement(
         _index.Box,
         {
           as: 'span',
           className: 'iui-content',
         },
-        _react.createElement(_SelectTagContainer.SelectTagContainer, {
-          tags: selectedItemsElements,
-        }),
+        selectedItemsRenderer
+          ? selectedItemsRenderer(selectedItems)
+          : _react.createElement(_SelectTagContainer.SelectTagContainer, {
+              tags: selectedItemsElements,
+              'data-iui-size': size,
+            }),
       ),
   );
 };

package/cjs/core/Select/SelectTag.js

@@ -26,6 +26,7 @@ const SelectTag = _react.forwardRef((props, forwardedRef) => {
       },
       removeButtonProps: {
         className: 'iui-select-tag-button',
+        'aria-label': `Deselect ${label}`,
       },
       ref: forwardedRef,
       ...rest,

package/cjs/core/SideNavigation/SideNavigation.d.ts

@@ -52,7 +52,7 @@ type SideNavigationProps = {
     /**
      * Passes props for SideNav wrapper.
      */
-    wrapperProps?: React.ComponentProps<'div'>;
+    wrapperProps?: React.ComponentProps<'nav'>;
     /**
      * Passes props for SideNav content.
      */
@@ -68,6 +68,10 @@ type SideNavigationProps = {
 };
 /**
  * Left side navigation menu component.
+ *
+ * Renders a `<nav>` landmark, which can be labelled using `wrapperProps['aria-labelledby']`
+ * or `wrapperProps['aria-label']`.
+ *
  * @example
  * <SideNavigation
  *   items={[

package/cjs/core/SideNavigation/SideNavigation.js

@@ -70,6 +70,7 @@ const SideNavigation = _react.forwardRef((props, forwardedRef) => {
     _react.createElement(
       _index.Box,
       {
+        as: 'nav',
         ...wrapperProps,
         className: (0, _classnames.default)(
           'iui-side-navigation-wrapper',
@@ -85,7 +86,6 @@ const SideNavigation = _react.forwardRef((props, forwardedRef) => {
         _react.createElement(
           _index.Box,
           {
-            as: 'div',
             className: (0, _classnames.default)(
               'iui-side-navigation',
               {
@@ -139,3 +139,5 @@ const SideNavigation = _react.forwardRef((props, forwardedRef) => {
     ),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SideNavigation.displayName = 'SideNavigation';

package/cjs/core/SideNavigation/SidenavButton.js

@@ -58,3 +58,5 @@ const SidenavButton = _react.forwardRef((props, ref) => {
         sidenavButton,
       );
 });
+if ('development' === process.env.NODE_ENV)
+  SidenavButton.displayName = 'SidenavButton';

package/cjs/core/SideNavigation/SidenavSubmenu.js

@@ -36,3 +36,5 @@ const SidenavSubmenu = _react.forwardRef((props, ref) => {
     ),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SidenavSubmenu.displayName = 'SidenavSubmenu';

package/cjs/core/SideNavigation/SidenavSubmenuHeader.js

@@ -44,3 +44,5 @@ const SidenavSubmenuHeader = _react.forwardRef((props, forwardedRef) => {
       ),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SidenavSubmenuHeader.displayName = 'SidenavSubmenuHeader';

package/cjs/core/SkipToContentLink/SkipToContentLink.js

@@ -31,3 +31,5 @@ const SkipToContentLink = _react.forwardRef((props, ref) => {
     children,
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SkipToContentLink.displayName = 'SkipToContentLink';

package/cjs/core/Slider/Slider.js

@@ -381,3 +381,4 @@ const Slider = _react.forwardRef((props, ref) => {
       ),
   );
 });
+if ('development' === process.env.NODE_ENV) Slider.displayName = 'Slider';

package/cjs/core/StatusMessage/StatusMessage.js

@@ -49,3 +49,5 @@ const StatusMessage = _react.forwardRef((props, ref) => {
     _react.createElement(_index.Box, contentProps, children),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  StatusMessage.displayName = 'StatusMessage';

package/cjs/core/Stepper/Stepper.js

@@ -106,3 +106,4 @@ const Stepper = _react.forwardRef((props, ref) => {
       ),
   );
 });
+if ('development' === process.env.NODE_ENV) Stepper.displayName = 'Stepper';

package/cjs/core/Stepper/WorkflowDiagram.js

@@ -44,3 +44,5 @@ const WorkflowDiagram = _react.forwardRef((props, ref) => {
     ),
   );
 });
+if ('development' === process.env.NODE_ENV)
+  WorkflowDiagram.displayName = 'WorkflowDiagram';

package/cjs/core/Surface/Surface.js

@@ -53,6 +53,8 @@ const SurfaceHeader = _react.forwardRef((props, ref) => {
     children,
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SurfaceHeader.displayName = 'Surface.Header';
 const SurfaceBody = _react.forwardRef((props, ref) => {
   let { children, className, isPadded = false, ...rest } = props;
   let { setHasLayout } = (0, _index.useSafeContext)(SurfaceContext);
@@ -70,6 +72,8 @@ const SurfaceBody = _react.forwardRef((props, ref) => {
     children,
   );
 });
+if ('development' === process.env.NODE_ENV)
+  SurfaceBody.displayName = 'Surface.Body';
 const Surface = Object.assign(
   _react.forwardRef((props, ref) => {
     let {
@@ -111,4 +115,7 @@ const Surface = Object.assign(
     Body: SurfaceBody,
   },
 );
+if ('development' === process.env.NODE_ENV) Surface.displayName = 'Surface';
 const SurfaceContext = _react.createContext(void 0);
+if ('development' === process.env.NODE_ENV)
+  SurfaceContext.displayName = 'SurfaceContext';

package/cjs/core/Table/ColumnHeader.js

@@ -102,26 +102,26 @@ const ColumnHeader = _react.forwardRef((props, forwardedRef) => {
     _react.createElement(
       _react.Fragment,
       null,
-      _react.createElement(
-        _index.ShadowRoot,
-        null,
-        'string' == typeof column.Header
-          ? _react.createElement(
+      'string' == typeof column.Header
+        ? _react.createElement(
+            _index.ShadowRoot,
+            null,
+            _react.createElement(
               _index.LineClamp,
               null,
               _react.createElement('slot', null),
-            )
-          : _react.createElement('slot', null),
-        _react.createElement('slot', {
-          name: 'actions',
-        }),
-        _react.createElement('slot', {
-          name: 'resizers',
-        }),
-        _react.createElement('slot', {
-          name: 'shadows',
-        }),
-      ),
+            ),
+            _react.createElement('slot', {
+              name: 'actions',
+            }),
+            _react.createElement('slot', {
+              name: 'resizers',
+            }),
+            _react.createElement('slot', {
+              name: 'shadows',
+            }),
+          )
+        : null,
       column.render('Header'),
       (showFilterButton(column) || showSortButton(column)) &&
         _react.createElement(

package/cjs/core/Table/Table.d.ts

@@ -44,7 +44,7 @@ export type TablePaginatorRendererProps = {
  * Table props.
  * columns and data must be memoized.
  */
-export type TableProps<T extends Record<string, unknown> = Record<string, unknown>> = Omit<TableOptions<T>, 'disableSortBy'> & {
+export type TableProps<T extends Record<string, unknown> = Record<string, unknown>> = Omit<TableOptions<T>, 'disableSortBy'> & Omit<React.ComponentPropsWithoutRef<'div'>, 'role' | 'onSelect'> & {
     /**
      * Flag whether data is loading.
      * @default false
@@ -203,6 +203,13 @@ export type TableProps<T extends Record<string, unknown> = Record<string, unknow
      * Passes custom props to Table body.
      */
     bodyProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the `role="table"` element within the wrapper.
+     *
+     * If `tableProps` or `role` is passed to `Table`, all ARIA attributes passed to `Table` will be passed to the wrapper.
+     * Else, all ARIA attributes will be passed to the inner element with `role="table"`.
+     */
+    tableProps?: React.ComponentProps<'div'>;
     /**
      * Passes custom props to empty table.
      */
@@ -231,9 +238,28 @@ export type TableProps<T extends Record<string, unknown> = Record<string, unknow
      * />
      */
     scrollToRow?: (rows: Row<T>[], data: T[]) => number;
+    /**
+     * Caption for the table.
+     *
+     * Although optional for backward compatibility, it is **recommended** to use it for accessibility purposes.
+     *
+     * @default "Table"
+     */
+    caption?: string;
+    /**
+     * If `tableProps` or `role` is passed to `Table`, all ARIA attributes passed to `Table` will be passed to the wrapper.
+     * Else, all ARIA attributes will be passed to the inner element with `role="table"`.
+     */
+    role?: React.AriaRole;
 } & Omit<CommonProps, 'title'>;
 /**
  * Table based on [react-table](https://react-table.tanstack.com/docs/api/overview).
+ *
+ * **Note**: If `tableProps` or `role` is passed to `Table`, all ARIA attributes passed to `Table` will be passed to the wrapper.
+ * Else, all ARIA attributes will be passed to the inner element with `role="table"`.
+ *
+ * ---
+ *
  * @example
  * const columns = React.useMemo(() => [
  *   {