@itwin/itwinui-react 1.39.0 → 1.40.0

package/cjs/core/index.d.ts

@@ -48,8 +48,8 @@ export { LabeledSelect } from './LabeledSelect';
 export type { LabeledSelectProps } from './LabeledSelect';
 export { LabeledTextarea } from './LabeledTextarea';
 export type { LabeledTextareaProps } from './LabeledTextarea';
-export { Menu, MenuItem, MenuDivider, MenuExtraContent } from './Menu';
-export type { MenuProps, MenuItemProps, MenuDividerProps, MenuExtraContentProps, } from './Menu';
+export { Menu, MenuItem, MenuDivider, MenuExtraContent, MenuItemSkeleton, } from './Menu';
+export type { MenuProps, MenuItemProps, MenuDividerProps, MenuExtraContentProps, MenuItemSkeletonProps, } from './Menu';
 export { Modal, ModalButtonBar, ModalContent } from './Modal';
 export type { ModalProps, ModalButtonBarProps, ModalContentProps, } from './Modal';
 export { ProgressLinear, ProgressRadial } from './ProgressIndicators';

package/cjs/core/index.js

@@ -3,9 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Modal = exports.MenuExtraContent = exports.MenuDivider = exports.MenuItem = exports.Menu = exports.LabeledTextarea = exports.LabeledSelect = exports.InputGroup = exports.LabeledInput = exports.Label = exports.Input = exports.InformationPanelContent = exports.InformationPanelBody = exports.InformationPanelHeader = exports.InformationPanelWrapper = exports.InformationPanel = exports.HorizontalTab = exports.HorizontalTabs = exports.Tab = exports.VerticalTabs = exports.HeaderLogo = exports.HeaderButton = exports.HeaderBreadcrumbs = exports.Header = exports.Footer = exports.FileUploadTemplate = exports.FileUpload = exports.Fieldset = exports.ExpandableBlock = exports.ErrorPage = exports.DropdownMenu = exports.generateLocalizedStrings = exports.DatePicker = exports.ComboBox = exports.ColorPalette = exports.ColorInputPanel = exports.ColorBuilder = exports.ColorSwatch = exports.ColorPicker = exports.Checkbox = exports.Carousel = exports.ButtonGroup = exports.SplitButton = exports.IdeasButton = exports.IconButton = exports.DropdownButton = exports.Button = exports.Breadcrumbs = exports.Badge = exports.Alert = void 0;
-exports.UserIcon = exports.Text = exports.KbdKeys = exports.Kbd = exports.Code = exports.Blockquote = exports.Title = exports.Subheading = exports.Small = exports.Leading = exports.Headline = exports.Body = exports.Anchor = exports.TreeNodeExpander = exports.TreeNode = exports.Tree = exports.Tooltip = exports.ToggleSwitch = exports.ThemeProvider = exports.toaster = exports.TimePicker = exports.Tile = exports.Textarea = exports.TagContainer = exports.Tag = exports.SelectionColumn = exports.ExpanderColumn = exports.ActionColumn = exports.TablePaginator = exports.EditableCell = exports.DefaultCell = exports.FilterButtonBar = exports.tableFilters = exports.Table = exports.Surface = exports.StatusMessage = exports.Slider = exports.SkipToContentLink = exports.SidenavSubmenuHeader = exports.SidenavSubmenu = exports.SidenavButton = exports.SideNavigation = exports.Select = exports.RadioTileGroup = exports.RadioTile = exports.Radio = exports.ProgressRadial = exports.ProgressLinear = exports.ModalContent = exports.ModalButtonBar = void 0;
-exports.MiddleTextTruncation = exports.ColorValue = exports.useTheme = exports.getUserColor = exports.Wizard = exports.UserIconGroup = void 0;
+exports.MenuItemSkeleton = exports.MenuExtraContent = exports.MenuDivider = exports.MenuItem = exports.Menu = exports.LabeledTextarea = exports.LabeledSelect = exports.InputGroup = exports.LabeledInput = exports.Label = exports.Input = exports.InformationPanelContent = exports.InformationPanelBody = exports.InformationPanelHeader = exports.InformationPanelWrapper = exports.InformationPanel = exports.HorizontalTab = exports.HorizontalTabs = exports.Tab = exports.VerticalTabs = exports.HeaderLogo = exports.HeaderButton = exports.HeaderBreadcrumbs = exports.Header = exports.Footer = exports.FileUploadTemplate = exports.FileUpload = exports.Fieldset = exports.ExpandableBlock = exports.ErrorPage = exports.DropdownMenu = exports.generateLocalizedStrings = exports.DatePicker = exports.ComboBox = exports.ColorPalette = exports.ColorInputPanel = exports.ColorBuilder = exports.ColorSwatch = exports.ColorPicker = exports.Checkbox = exports.Carousel = exports.ButtonGroup = exports.SplitButton = exports.IdeasButton = exports.IconButton = exports.DropdownButton = exports.Button = exports.Breadcrumbs = exports.Badge = exports.Alert = void 0;
+exports.Text = exports.KbdKeys = exports.Kbd = exports.Code = exports.Blockquote = exports.Title = exports.Subheading = exports.Small = exports.Leading = exports.Headline = exports.Body = exports.Anchor = exports.TreeNodeExpander = exports.TreeNode = exports.Tree = exports.Tooltip = exports.ToggleSwitch = exports.ThemeProvider = exports.toaster = exports.TimePicker = exports.Tile = exports.Textarea = exports.TagContainer = exports.Tag = exports.SelectionColumn = exports.ExpanderColumn = exports.ActionColumn = exports.TablePaginator = exports.EditableCell = exports.DefaultCell = exports.FilterButtonBar = exports.tableFilters = exports.Table = exports.Surface = exports.StatusMessage = exports.Slider = exports.SkipToContentLink = exports.SidenavSubmenuHeader = exports.SidenavSubmenu = exports.SidenavButton = exports.SideNavigation = exports.Select = exports.RadioTileGroup = exports.RadioTile = exports.Radio = exports.ProgressRadial = exports.ProgressLinear = exports.ModalContent = exports.ModalButtonBar = exports.Modal = void 0;
+exports.MiddleTextTruncation = exports.ColorValue = exports.useTheme = exports.getUserColor = exports.Wizard = exports.UserIconGroup = exports.UserIcon = void 0;
 /*---------------------------------------------------------------------------------------------
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -85,6 +85,7 @@ Object.defineProperty(exports, "Menu", { enumerable: true, get: function () { re
 Object.defineProperty(exports, "MenuItem", { enumerable: true, get: function () { return Menu_1.MenuItem; } });
 Object.defineProperty(exports, "MenuDivider", { enumerable: true, get: function () { return Menu_1.MenuDivider; } });
 Object.defineProperty(exports, "MenuExtraContent", { enumerable: true, get: function () { return Menu_1.MenuExtraContent; } });
+Object.defineProperty(exports, "MenuItemSkeleton", { enumerable: true, get: function () { return Menu_1.MenuItemSkeleton; } });
 var Modal_1 = require("./Modal");
 Object.defineProperty(exports, "Modal", { enumerable: true, get: function () { return Modal_1.Modal; } });
 Object.defineProperty(exports, "ModalButtonBar", { enumerable: true, get: function () { return Modal_1.ModalButtonBar; } });

package/cjs/core/utils/components/VisuallyHidden.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+export declare type VisuallyHiddenProps = React.ComponentPropsWithRef<'div'>;
+/**
+ * Hides content visually but is still accessible to screen readers.
+ */
+export declare const VisuallyHidden: React.ForwardRefExoticComponent<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | React.RefObject<HTMLDivElement> | null | undefined;
+}, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & React.RefAttributes<HTMLDivElement>>;
+export default VisuallyHidden;

package/cjs/core/utils/components/VisuallyHidden.js

@@ -0,0 +1,44 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VisuallyHidden = void 0;
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+var react_1 = __importDefault(require("react"));
+var classnames_1 = __importDefault(require("classnames"));
+var hooks_1 = require("../hooks");
+/**
+ * Hides content visually but is still accessible to screen readers.
+ */
+exports.VisuallyHidden = react_1.default.forwardRef(function (props, ref) {
+    var className = props.className, rest = __rest(props, ["className"]);
+    (0, hooks_1.useTheme)();
+    return (react_1.default.createElement("div", __assign({ className: (0, classnames_1.default)('iui-visually-hidden', className), ref: ref }, rest)));
+});
+exports.default = exports.VisuallyHidden;

package/cjs/core/utils/components/index.d.ts

@@ -5,3 +5,4 @@ export * from './icons';
 export * from './WithCSSTransition';
 export * from './MiddleTextTruncation';
 export * from './VirtualScroll';
+export * from './VisuallyHidden';

package/cjs/core/utils/components/index.js

@@ -25,3 +25,4 @@ __exportStar(require("./icons"), exports);
 __exportStar(require("./WithCSSTransition"), exports);
 __exportStar(require("./MiddleTextTruncation"), exports);
 __exportStar(require("./VirtualScroll"), exports);
+__exportStar(require("./VisuallyHidden"), exports);

package/cjs/types/react-table-config.d.ts

@@ -46,6 +46,10 @@ declare module 'react-table' {
         };
         isTableResizing?: boolean;
         columnReorderStartIndex: number;
+        sticky: {
+            isScrolledToRight?: boolean;
+            isScrolledToLeft?: boolean;
+        };
     }
     interface ColumnInterface<D extends object = {}> extends UseSortByColumnOptions<D>, UseFiltersColumnOptions<D>, UseResizeColumnsColumnOptions<D> {
         /**
@@ -91,12 +95,17 @@ declare module 'react-table' {
          * @default false
          */
         disableToggleVisibility?: boolean;
+        /**
+         * Side on which column should be sticked to.
+         */
+        sticky?: 'left' | 'right';
     }
     interface ColumnInstance<D extends object = {}> extends UseFiltersColumnProps<D>, UseGroupByColumnProps<D>, UseResizeColumnsColumnProps<D>, UseSortByColumnProps<D> {
         originalWidth: number;
         resizeWidth?: number;
         isResizerVisible?: boolean;
         getDragAndDropProps: () => TableKeyedProps;
+        originalSticky?: 'left' | 'right' | 'none';
     }
     interface Cell<D extends object = {}> extends UseGroupByCellProps<D>, UseRowStateCellProps<D> {
     }

package/esm/core/ComboBox/ComboBox.d.ts

@@ -35,9 +35,10 @@ export declare type ComboBoxProps<T> = {
     dropdownMenuProps?: PopoverProps;
     /**
      * Message shown when no options are available.
+     * If `JSX.Element` is provided, it will be rendered as is and won't be wrapped with `MenuExtraContent`.
      * @default 'No options found'
      */
-    emptyStateMessage?: string;
+    emptyStateMessage?: React.ReactNode;
     /**
      * A custom item renderer can be specified to control the rendering.
      *
@@ -58,6 +59,14 @@ export declare type ComboBoxProps<T> = {
      * @beta
      */
     enableVirtualization?: boolean;
+    /**
+     * Callback fired when dropdown menu is opened.
+     */
+    onShow?: () => void;
+    /**
+     * Callback fired when dropdown menu is closed.
+     */
+    onHide?: () => void;
 } & Pick<InputContainerProps, 'status'> & Omit<CommonProps, 'title'>;
 /**
  * ComboBox component that allows typing a value to filter the options in dropdown list.

package/esm/core/ComboBox/ComboBox.js

@@ -56,8 +56,8 @@ var getOptionId = function (option, idPrefix) {
  * />
  */
 export var ComboBox = function (props) {
-    var _a;
-    var options = props.options, valueProp = props.value, onChange = props.onChange, filterFunction = props.filterFunction, inputProps = props.inputProps, dropdownMenuProps = props.dropdownMenuProps, _b = props.emptyStateMessage, emptyStateMessage = _b === void 0 ? 'No options found' : _b, itemRenderer = props.itemRenderer, _c = props.enableVirtualization, enableVirtualization = _c === void 0 ? false : _c, rest = __rest(props, ["options", "value", "onChange", "filterFunction", "inputProps", "dropdownMenuProps", "emptyStateMessage", "itemRenderer", "enableVirtualization"]);
+    var _a, _b;
+    var options = props.options, valueProp = props.value, onChange = props.onChange, filterFunction = props.filterFunction, inputProps = props.inputProps, dropdownMenuProps = props.dropdownMenuProps, _c = props.emptyStateMessage, emptyStateMessage = _c === void 0 ? 'No options found' : _c, itemRenderer = props.itemRenderer, _d = props.enableVirtualization, enableVirtualization = _d === void 0 ? false : _d, onShow = props.onShow, onHide = props.onHide, rest = __rest(props, ["options", "value", "onChange", "filterFunction", "inputProps", "dropdownMenuProps", "emptyStateMessage", "itemRenderer", "enableVirtualization", "onShow", "onHide"]);
     // Generate a stateful random id if not specified
     var id = React.useState(function () {
         var _a, _b;
@@ -89,12 +89,12 @@ export var ComboBox = function (props) {
         });
     }
     // Reducer where all the component-wide state is stored
-    var _d = React.useReducer(comboBoxReducer, {
+    var _e = React.useReducer(comboBoxReducer, {
         isOpen: false,
         selectedIndex: -1,
         focusedIndex: -1,
-    }), _e = _d[0], isOpen = _e.isOpen, selectedIndex = _e.selectedIndex, focusedIndex = _e.focusedIndex, dispatch = _d[1];
-    React.useEffect(function () {
+    }), _f = _e[0], isOpen = _f.isOpen, selectedIndex = _f.selectedIndex, focusedIndex = _f.focusedIndex, dispatch = _e[1];
+    React.useLayoutEffect(function () {
         var _a, _b;
         // When the dropdown opens
         if (isOpen) {
@@ -113,20 +113,30 @@ export var ComboBox = function (props) {
         }
     }, [isOpen, options, selectedIndex]);
     // Set min-width of menu to be same as input
-    var _f = React.useState(0), minWidth = _f[0], setMinWidth = _f[1];
+    var _g = React.useState(0), minWidth = _g[0], setMinWidth = _g[1];
     React.useEffect(function () {
         if (inputRef.current) {
             setMinWidth(inputRef.current.offsetWidth);
         }
     }, [isOpen]);
-    // Initialize filtered options to the latest value options
-    var _g = React.useState(options), filteredOptions = _g[0], setFilteredOptions = _g[1];
+    // Update filtered options to the latest value options according to input value
+    var _h = React.useState(options), filteredOptions = _h[0], setFilteredOptions = _h[1];
     React.useEffect(function () {
-        setFilteredOptions(options);
+        var _a;
+        if (inputValue) {
+            setFilteredOptions((_a = filterFunction === null || filterFunction === void 0 ? void 0 : filterFunction(options, inputValue)) !== null && _a !== void 0 ? _a : options.filter(function (option) {
+                return option.label.toLowerCase().includes(inputValue.toLowerCase());
+            }));
+        }
+        else {
+            setFilteredOptions(options);
+        }
         dispatch(['focus']);
+        // Only need to call on options update
+        // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [options]);
     // Filter options based on input value
-    var _h = React.useState((_a = inputProps === null || inputProps === void 0 ? void 0 : inputProps.value) !== null && _a !== void 0 ? _a : ''), inputValue = _h[0], setInputValue = _h[1];
+    var _j = React.useState((_b = (_a = inputProps === null || inputProps === void 0 ? void 0 : inputProps.value) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : ''), inputValue = _j[0], setInputValue = _j[1];
     var handleOnInput = React.useCallback(function (event) {
         var _a, _b;
         var value = event.currentTarget.value;
@@ -173,6 +183,7 @@ export var ComboBox = function (props) {
             onClick: function (e) {
                 var _a, _b;
                 dispatch(['select', __originalIndex]);
+                dispatch(['close']);
                 (_b = (_a = customItem.props).onClick) === null || _b === void 0 ? void 0 : _b.call(_a, e);
             },
             // ComboBox.MenuItem handles scrollIntoView, data-iui-index and iui-focused through context
@@ -187,8 +198,13 @@ export var ComboBox = function (props) {
                     el === null || el === void 0 ? void 0 : el.scrollIntoView({ block: 'nearest' });
                 }
             }),
-        })) : (React.createElement(ComboBoxMenuItem, __assign({ key: optionId, id: optionId }, option, { isSelected: selectedIndex === __originalIndex, onClick: function () { return dispatch(['select', __originalIndex]); }, index: __originalIndex, "data-iui-filtered-index": filteredIndex }), option.label));
+        })) : (React.createElement(ComboBoxMenuItem, __assign({ key: optionId, id: optionId }, option, { isSelected: selectedIndex === __originalIndex, onClick: function () {
+                dispatch(['select', __originalIndex]);
+                dispatch(['close']);
+            }, index: __originalIndex, "data-iui-filtered-index": filteredIndex }), option.label));
     }, [enableVirtualization, focusedIndex, id, itemRenderer, selectedIndex]);
+    var emptyContent = React.useMemo(function () { return (React.createElement(React.Fragment, null, React.isValidElement(emptyStateMessage) ? (emptyStateMessage) : (React.createElement(MenuExtraContent, null,
+        React.createElement(Text, { isMuted: true }, emptyStateMessage))))); }, [emptyStateMessage]);
     return (React.createElement(ComboBoxRefsContext.Provider, { value: { inputRef: inputRef, menuRef: menuRef, toggleButtonRef: toggleButtonRef, optionsExtraInfoRef: optionsExtraInfoRef } },
         React.createElement(ComboBoxActionContext.Provider, { value: dispatch },
             React.createElement(ComboBoxStateContext.Provider, { value: {
@@ -203,8 +219,9 @@ export var ComboBox = function (props) {
                 React.createElement(ComboBoxInputContainer, __assign({ disabled: inputProps === null || inputProps === void 0 ? void 0 : inputProps.disabled }, rest),
                     React.createElement(ComboBoxInput, __assign({ value: inputValue }, inputProps, { onChange: handleOnInput })),
                     React.createElement(ComboBoxEndIcon, { disabled: inputProps === null || inputProps === void 0 ? void 0 : inputProps.disabled, isOpen: isOpen })),
-                React.createElement(ComboBoxDropdown, __assign({}, dropdownMenuProps),
-                    React.createElement(ComboBoxMenu, null, filteredOptions.length > 0 && !enableVirtualization ? (filteredOptions.map(getMenuItem)) : (React.createElement(MenuExtraContent, null,
-                        React.createElement(Text, { isMuted: true }, emptyStateMessage)))))))));
+                React.createElement(ComboBoxDropdown, __assign({}, dropdownMenuProps, { onShow: onShow, onHide: onHide }),
+                    React.createElement(ComboBoxMenu, null, filteredOptions.length > 0 && !enableVirtualization
+                        ? filteredOptions.map(getMenuItem)
+                        : emptyContent))))));
 };
 export default ComboBox;

package/esm/core/ComboBox/ComboBoxInput.js

@@ -112,6 +112,7 @@ export var ComboBoxInput = React.forwardRef(function (props, forwardedRef) {
                 event.preventDefault();
                 if (isOpen) {
                     dispatch(['select', focusedIndexRef.current]);
+                    dispatch(['close']);
                 }
                 else {
                     dispatch(['open']);

package/esm/core/ComboBox/helpers.js

@@ -25,7 +25,7 @@ export var comboBoxReducer = function (state, _a) {
             return __assign(__assign({}, state), { isOpen: false });
         }
         case 'select': {
-            return __assign(__assign({}, state), { isOpen: false, selectedIndex: value !== null && value !== void 0 ? value : state.selectedIndex, focusedIndex: value !== null && value !== void 0 ? value : state.focusedIndex });
+            return __assign(__assign({}, state), { selectedIndex: value !== null && value !== void 0 ? value : state.selectedIndex, focusedIndex: value !== null && value !== void 0 ? value : state.focusedIndex });
         }
         case 'focus': {
             return __assign(__assign({}, state), { focusedIndex: (_b = value !== null && value !== void 0 ? value : state.selectedIndex) !== null && _b !== void 0 ? _b : -1 });

package/esm/core/Menu/MenuItemSkeleton.d.ts

@@ -0,0 +1,32 @@
+/// <reference types="react" />
+import { CommonProps } from '../utils';
+import '@itwin/itwinui-css/css/menu.css';
+export declare type MenuItemSkeletonProps = {
+    /**
+     * Flag whether to show skeleton for sub-label.
+     */
+    hasSublabel?: boolean;
+    /**
+     * Flag whether to show skeleton for icon.
+     */
+    hasIcon?: boolean;
+    /**
+     * Skeleton content width.
+     */
+    contentWidth?: string;
+    /**
+     * Translated strings used for accessibility.
+     */
+    translatedStrings?: {
+        /**
+         * Label for loading state. Defaults to "Loading…".
+         * It is only visible for the screen readers.
+         */
+        loading: string;
+    };
+} & CommonProps;
+/**
+ * Menu item that uses skeletons to indicate loading state.
+ */
+export declare const MenuItemSkeleton: (props: MenuItemSkeletonProps) => JSX.Element;
+export default MenuItemSkeleton;

package/esm/core/Menu/MenuItemSkeleton.js

@@ -0,0 +1,46 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import React from 'react';
+import cx from 'classnames';
+import { useTheme, VisuallyHidden } from '../utils';
+import '@itwin/itwinui-css/css/menu.css';
+/**
+ * Menu item that uses skeletons to indicate loading state.
+ */
+export var MenuItemSkeleton = function (props) {
+    var hasSublabel = props.hasSublabel, hasIcon = props.hasIcon, contentWidth = props.contentWidth, _a = props.translatedStrings, translatedStrings = _a === void 0 ? { loading: 'Loading…' } : _a, className = props.className, style = props.style, rest = __rest(props, ["hasSublabel", "hasIcon", "contentWidth", "translatedStrings", "className", "style"]);
+    useTheme();
+    return (React.createElement("li", __assign({ className: cx('iui-menu-item', 'iui-menu-item-skeleton', { 'iui-large': hasSublabel }, className), style: __assign({
+            '--iui-menu-item-content-skeleton-max-width': contentWidth,
+        }, style) }, rest),
+        hasIcon && React.createElement("div", { className: 'iui-icon iui-skeleton', "aria-hidden": true }),
+        React.createElement("span", { className: 'iui-content' },
+            React.createElement("div", { className: 'iui-menu-label iui-skeleton', "aria-hidden": true }),
+            hasSublabel && (React.createElement("div", { className: 'iui-menu-description iui-skeleton', "aria-hidden": true })),
+            React.createElement(VisuallyHidden, null, translatedStrings.loading))));
+};
+export default MenuItemSkeleton;

package/esm/core/Menu/index.d.ts

@@ -6,3 +6,5 @@ export { MenuDivider } from './MenuDivider';
 export type { MenuDividerProps } from './MenuDivider';
 export { MenuExtraContent } from './MenuExtraContent';
 export type { MenuExtraContentProps } from './MenuExtraContent';
+export { MenuItemSkeleton } from './MenuItemSkeleton';
+export type { MenuItemSkeletonProps } from './MenuItemSkeleton';

package/esm/core/Menu/index.js

@@ -6,3 +6,4 @@ export { Menu } from './Menu';
 export { MenuItem } from './MenuItem';
 export { MenuDivider } from './MenuDivider';
 export { MenuExtraContent } from './MenuExtraContent';
+export { MenuItemSkeleton } from './MenuItemSkeleton';

package/esm/core/Table/Table.js

@@ -32,11 +32,11 @@ import { useTheme, useResizeObserver } from '../utils';
 import '@itwin/itwinui-css/css/table.css';
 import SvgSortDown from '@itwin/itwinui-icons-react/cjs/icons/SortDown';
 import SvgSortUp from '@itwin/itwinui-icons-react/cjs/icons/SortUp';
-import { getCellStyle } from './utils';
+import { getCellStyle, getStickyStyle } from './utils';
 import { TableRowMemoized } from './TableRowMemoized';
 import { FilterToggle } from './filters';
 import { customFilterFunctions } from './filters/customFilterFunctions';
-import { useExpanderCell, useSelectionCell, useSubRowFiltering, useSubRowSelection, useResizeColumns, useColumnDragAndDrop, } from './hooks';
+import { useExpanderCell, useSelectionCell, useSubRowFiltering, useSubRowSelection, useResizeColumns, useColumnDragAndDrop, useStickyColumns, } from './hooks';
 import { onExpandHandler, onFilterHandler, onSelectHandler, onSingleSelectHandler, onTableResizeEnd, onTableResizeStart, } from './actionHandlers';
 import VirtualScroll from '../utils/components/VirtualScroll';
 import { SELECTION_CELL_ID } from './columns';
@@ -171,8 +171,8 @@ export var Table = function (props) {
             return getSubRows ? getSubRows(item, index) : item.subRows;
         });
     }, [data, getSubRows]);
-    var instance = useTable(__assign(__assign({ manualPagination: !paginatorRenderer, paginateExpandedRows: false }, props), { columns: columns, defaultColumn: defaultColumn, disableSortBy: !isSortable, stateReducer: tableStateReducer, filterTypes: filterTypes, selectSubRows: selectSubRows, data: data, getSubRows: getSubRows, initialState: __assign({ pageSize: pageSize }, props.initialState) }), useFlexLayout, useResizeColumns(ownerDocument), useFilters, useSubRowFiltering(hasAnySubRows), useSortBy, useExpanded, usePagination, useRowSelect, useSubRowSelection, useExpanderCell(subComponent, expanderCell, isRowDisabled), useSelectionCell(isSelectable, selectionMode, isRowDisabled), useColumnOrder, useColumnDragAndDrop(enableColumnReordering));
-    var getTableProps = instance.getTableProps, rows = instance.rows, headerGroups = instance.headerGroups, getTableBodyProps = instance.getTableBodyProps, prepareRow = instance.prepareRow, state = instance.state, allColumns = instance.allColumns, filteredFlatRows = instance.filteredFlatRows, dispatch = instance.dispatch, page = instance.page, gotoPage = instance.gotoPage, setPageSize = instance.setPageSize, flatHeaders = instance.flatHeaders;
+    var instance = useTable(__assign(__assign({ manualPagination: !paginatorRenderer, paginateExpandedRows: false }, props), { columns: columns, defaultColumn: defaultColumn, disableSortBy: !isSortable, stateReducer: tableStateReducer, filterTypes: filterTypes, selectSubRows: selectSubRows, data: data, getSubRows: getSubRows, initialState: __assign({ pageSize: pageSize }, props.initialState) }), useFlexLayout, useResizeColumns(ownerDocument), useFilters, useSubRowFiltering(hasAnySubRows), useSortBy, useExpanded, usePagination, useRowSelect, useSubRowSelection, useExpanderCell(subComponent, expanderCell, isRowDisabled), useSelectionCell(isSelectable, selectionMode, isRowDisabled), useColumnOrder, useColumnDragAndDrop(enableColumnReordering), useStickyColumns);
+    var getTableProps = instance.getTableProps, rows = instance.rows, headerGroups = instance.headerGroups, getTableBodyProps = instance.getTableBodyProps, prepareRow = instance.prepareRow, state = instance.state, allColumns = instance.allColumns, filteredFlatRows = instance.filteredFlatRows, dispatch = instance.dispatch, page = instance.page, gotoPage = instance.gotoPage, setPageSize = instance.setPageSize, flatHeaders = instance.flatHeaders, visibleColumns = instance.visibleColumns;
     var ariaDataAttributes = Object.entries(rest).reduce(function (result, _a) {
         var key = _a[0], value = _a[1];
         if (key.startsWith('data-') || key.startsWith('aria-')) {
@@ -287,6 +287,30 @@ export var Table = function (props) {
         subComponent,
     ]);
     var virtualizedItemRenderer = React.useCallback(function (index) { return getPreparedRow(index); }, [getPreparedRow]);
+    var updateStickyState = function () {
+        if (!bodyRef.current || flatHeaders.every(function (header) { return !header.sticky; })) {
+            return;
+        }
+        if (bodyRef.current.scrollLeft !== 0) {
+            dispatch({ type: TableActions.setScrolledRight, value: true });
+        }
+        else {
+            dispatch({ type: TableActions.setScrolledRight, value: false });
+        }
+        // If scrolled a bit to the left looking from the right side
+        if (bodyRef.current.scrollLeft !==
+            bodyRef.current.scrollWidth - bodyRef.current.clientWidth) {
+            dispatch({ type: TableActions.setScrolledLeft, value: true });
+        }
+        else {
+            dispatch({ type: TableActions.setScrolledLeft, value: false });
+        }
+    };
+    React.useEffect(function () {
+        updateStickyState();
+        // Call only on init
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
     return (React.createElement(React.Fragment, null,
         React.createElement("div", __assign({ ref: function (element) {
                 setOwnerDocument(element === null || element === void 0 ? void 0 : element.ownerDocument);
@@ -295,7 +319,7 @@ export var Table = function (props) {
                 }
             }, id: id }, getTableProps({
             className: cx('iui-table', (_a = {}, _a["iui-".concat(density)] = density !== 'default', _a), className),
-            style: style,
+            style: __assign({ minWidth: 0 }, style),
         }), ariaDataAttributes),
             React.createElement("div", { className: 'iui-table-header-wrapper', ref: headerRef },
                 React.createElement("div", { className: 'iui-table-header' }, headerGroups.slice(1).map(function (headerGroup) {
@@ -303,9 +327,13 @@ export var Table = function (props) {
                         className: 'iui-row',
                     });
                     return (React.createElement("div", __assign({}, headerGroupProps, { key: headerGroupProps.key }), headerGroup.headers.map(function (column, index) {
-                        var columnProps = column.getHeaderProps(__assign(__assign({}, column.getSortByToggleProps()), { className: cx('iui-cell', { 'iui-actionable': column.canSort }, { 'iui-sorted': column.isSorted }, column.columnClassName), style: getCellStyle(column, !!state.isTableResizing) }));
+                        var columnProps = column.getHeaderProps(__assign(__assign({}, column.getSortByToggleProps()), { className: cx('iui-cell', {
+                                'iui-actionable': column.canSort,
+                                'iui-sorted': column.isSorted,
+                                'iui-cell-sticky': !!column.sticky,
+                            }, column.columnClassName), style: __assign(__assign(__assign({}, getCellStyle(column, !!state.isTableResizing)), getStickyStyle(column, visibleColumns)), { flexWrap: 'unset' }) }));
                         return (React.createElement("div", __assign({}, columnProps, column.getDragAndDropProps(), { key: columnProps.key, title: undefined, ref: function (el) {
-                                if (el && isResizable) {
+                                if (el) {
                                     columnRefs.current[column.id] = el;
                                     column.resizeWidth = el.getBoundingClientRect().width;
                                 }
@@ -320,7 +348,11 @@ export var Table = function (props) {
                                 index !== headerGroup.headers.length - 1 && (React.createElement("div", __assign({}, column.getResizerProps(), { className: 'iui-resizer' }),
                                 React.createElement("div", { className: 'iui-resizer-bar' }))),
                             enableColumnReordering &&
-                                !column.disableReordering && (React.createElement("div", { className: 'iui-reorder-bar' }))));
+                                !column.disableReordering && (React.createElement("div", { className: 'iui-reorder-bar' })),
+                            column.sticky === 'left' &&
+                                state.sticky.isScrolledToRight && (React.createElement("div", { className: 'iui-cell-shadow-right' })),
+                            column.sticky === 'right' &&
+                                state.sticky.isScrolledToLeft && (React.createElement("div", { className: 'iui-cell-shadow-left' }))));
                     })));
                 }))),
             React.createElement("div", __assign({}, getTableBodyProps({
@@ -331,6 +363,7 @@ export var Table = function (props) {
             }), { ref: bodyRef, onScroll: function () {
                     if (headerRef.current && bodyRef.current) {
                         headerRef.current.scrollLeft = bodyRef.current.scrollLeft;
+                        updateStickyState();
                     }
                 }, tabIndex: -1 }),
                 data.length !== 0 && (React.createElement(React.Fragment, null, enableVirtualization ? (React.createElement(VirtualScroll, { itemsLength: page.length, itemRenderer: virtualizedItemRenderer })) : (page.map(function (_, index) { return getPreparedRow(index); })))),

package/esm/core/Table/TableCell.js

@@ -15,7 +15,7 @@ var __assign = (this && this.__assign) || function () {
  *--------------------------------------------------------------------------------------------*/
 import React from 'react';
 import cx from 'classnames';
-import { getCellStyle } from './utils';
+import { getCellStyle, getStickyStyle } from './utils';
 import { SubRowExpander } from './SubRowExpander';
 import { SELECTION_CELL_ID } from './columns';
 import { DefaultCell } from './cells';
@@ -34,8 +34,10 @@ export var TableCell = function (props) {
         };
     };
     var cellElementProps = cell.getCellProps({
-        className: cx('iui-cell', cell.column.cellClassName),
-        style: __assign(__assign({}, getCellStyle(cell.column, !!tableInstance.state.isTableResizing)), getSubRowStyle()),
+        className: cx('iui-cell', cell.column.cellClassName, {
+            'iui-cell-sticky': !!cell.column.sticky,
+        }),
+        style: __assign(__assign(__assign({}, getCellStyle(cell.column, !!tableInstance.state.isTableResizing)), getSubRowStyle()), getStickyStyle(cell.column, tableInstance.visibleColumns)),
     });
     var cellProps = __assign(__assign({}, tableInstance), { cell: cell, row: cell.row, value: cell.value, column: cell.column });
     var cellContent = (React.createElement(React.Fragment, null,
@@ -44,7 +46,12 @@ export var TableCell = function (props) {
     var cellRendererProps = {
         cellElementProps: cellElementProps,
         cellProps: cellProps,
-        children: cellContent,
+        children: (React.createElement(React.Fragment, null,
+            cellContent,
+            cell.column.sticky === 'left' &&
+                tableInstance.state.sticky.isScrolledToRight && (React.createElement("div", { className: 'iui-cell-shadow-right' })),
+            cell.column.sticky === 'right' &&
+                tableInstance.state.sticky.isScrolledToLeft && (React.createElement("div", { className: 'iui-cell-shadow-left' })))),
     };
     return (React.createElement(React.Fragment, null, cell.column.cellRenderer ? (cell.column.cellRenderer(__assign(__assign({}, cellRendererProps), { isDisabled: function () { return isDisabled; } }))) : (React.createElement(DefaultCell, __assign({}, cellRendererProps, { isDisabled: function () { return isDisabled; } })))));
 };

package/esm/core/Table/TableRowMemoized.js

@@ -92,5 +92,9 @@ export var TableRowMemoized = React.memo(TableRow, function (prevProp, nextProp)
         prevProp.tableHasSubRows === nextProp.tableHasSubRows &&
         prevProp.state.columnOrder === nextProp.state.columnOrder &&
         !nextProp.state.columnResizing.isResizingColumn &&
-        prevProp.state.isTableResizing === nextProp.state.isTableResizing;
+        prevProp.state.isTableResizing === nextProp.state.isTableResizing &&
+        prevProp.state.sticky.isScrolledToLeft ===
+            nextProp.state.sticky.isScrolledToLeft &&
+        prevProp.state.sticky.isScrolledToRight ===
+            nextProp.state.sticky.isScrolledToRight;
 });

package/esm/core/Table/actionHandlers/resizeHandler.d.ts

@@ -12,6 +12,10 @@ export declare const onTableResizeStart: <T extends Record<string, unknown>>(sta
         isResizingColumn?: string | undefined;
     };
     columnReorderStartIndex: number;
+    sticky: {
+        isScrolledToRight?: boolean | undefined;
+        isScrolledToLeft?: boolean | undefined;
+    };
     columnOrder: import("react-table").IdType<T>[];
     expanded: Record<import("react-table").IdType<T>, boolean>;
     filters: import("react-table").Filters<T>;
@@ -38,6 +42,10 @@ export declare const onTableResizeEnd: <T extends Record<string, unknown>>(state
     };
     hiddenColumns?: import("react-table").IdType<T>[] | undefined;
     columnReorderStartIndex: number;
+    sticky: {
+        isScrolledToRight?: boolean | undefined;
+        isScrolledToLeft?: boolean | undefined;
+    };
     columnOrder: import("react-table").IdType<T>[];
     expanded: Record<import("react-table").IdType<T>, boolean>;
     filters: import("react-table").Filters<T>;

package/esm/core/Table/actionHandlers/selectHandler.d.ts

@@ -20,6 +20,10 @@ export declare const onSingleSelectHandler: <T extends Record<string, unknown>>(
     };
     isTableResizing?: boolean | undefined;
     columnReorderStartIndex: number;
+    sticky: {
+        isScrolledToRight?: boolean | undefined;
+        isScrolledToLeft?: boolean | undefined;
+    };
     columnOrder: import("react-table").IdType<T>[];
     expanded: Record<import("react-table").IdType<T>, boolean>;
     filters: import("react-table").Filters<T>;

package/esm/core/Table/columns/selectionColumn.js

@@ -49,11 +49,13 @@ export var SelectionColumn = function (props) {
             var getToggleAllRowsSelectedProps = _a.getToggleAllRowsSelectedProps, rows = _a.rows, initialRows = _a.initialRows, state = _a.state;
             var disabled = rows.every(function (row) { return isDisabled === null || isDisabled === void 0 ? void 0 : isDisabled(row.original); });
             var checked = initialRows.every(function (row) { return state.selectedRowIds[row.id] || (isDisabled === null || isDisabled === void 0 ? void 0 : isDisabled(row.original)); });
-            return (React.createElement(Checkbox, __assign({}, getToggleAllRowsSelectedProps(), { style: {}, checked: checked && !disabled, indeterminate: !checked && Object.keys(state.selectedRowIds).length > 0, disabled: disabled })));
+            return (React.createElement(Checkbox, __assign({}, getToggleAllRowsSelectedProps(), { style: {}, title: '' // Removes default title that comes from react-table
+                , checked: checked && !disabled, indeterminate: !checked && Object.keys(state.selectedRowIds).length > 0, disabled: disabled })));
         },
         Cell: function (_a) {
             var row = _a.row;
-            return (React.createElement(Checkbox, __assign({}, row.getToggleRowSelectedProps(), { style: {}, disabled: isDisabled === null || isDisabled === void 0 ? void 0 : isDisabled(row.original), onClick: function (e) { return e.stopPropagation(); } })));
+            return (React.createElement(Checkbox, __assign({}, row.getToggleRowSelectedProps(), { style: {}, title: '' // Removes default title that comes from react-table
+                , disabled: isDisabled === null || isDisabled === void 0 ? void 0 : isDisabled(row.original), onClick: function (e) { return e.stopPropagation(); } })));
         },
         cellRenderer: function (props) { return (React.createElement(DefaultCell, __assign({}, props, { isDisabled: function (rowData) { return !!(isDisabled === null || isDisabled === void 0 ? void 0 : isDisabled(rowData)); } }))); },
     };

package/esm/core/Table/hooks/index.d.ts

@@ -4,3 +4,4 @@ export { useSubRowFiltering } from './useSubRowFiltering';
 export { useSubRowSelection } from './useSubRowSelection';
 export { useResizeColumns } from './useResizeColumns';
 export { useColumnDragAndDrop } from './useColumnDragAndDrop';
+export { useStickyColumns } from './useStickyColumns';

package/esm/core/Table/hooks/index.js

@@ -8,3 +8,4 @@ export { useSubRowFiltering } from './useSubRowFiltering';
 export { useSubRowSelection } from './useSubRowSelection';
 export { useResizeColumns } from './useResizeColumns';
 export { useColumnDragAndDrop } from './useColumnDragAndDrop';
+export { useStickyColumns } from './useStickyColumns';

package/esm/core/Table/hooks/useStickyColumns.d.ts

@@ -0,0 +1,2 @@
+import { Hooks } from 'react-table';
+export declare const useStickyColumns: <T extends Record<string, unknown>>(hooks: Hooks<T>) => void;