@itwin/itwinui-react 1.39.0 → 1.41.0

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

@@ -20,6 +20,7 @@ export declare const TableRow: <T extends Record<string, unknown>>(props: {
     tableHasSubRows: boolean;
     tableInstance: TableInstance<T>;
     expanderCell?: ((cellProps: CellProps<T, any>) => React.ReactNode) | undefined;
+    bodyRef: HTMLDivElement | null;
 }) => JSX.Element;
 export declare const TableRowMemoized: <T extends Record<string, unknown>>(props: {
     row: Row<T>;
@@ -35,4 +36,5 @@ export declare const TableRowMemoized: <T extends Record<string, unknown>>(props
     tableHasSubRows: boolean;
     tableInstance: TableInstance<T>;
     expanderCell?: ((cellProps: CellProps<T, any>) => React.ReactNode) | undefined;
+    bodyRef: HTMLDivElement | null;
 }) => JSX.Element;

package/cjs/core/Table/TableRowMemoized.js

@@ -30,14 +30,25 @@ var TableCell_1 = require("./TableCell");
  * When adding new features check whether it changes state that affects row. If it does then add equality check to `React.memo`.
  */
 var TableRow = function (props) {
-    var row = props.row, rowProps = props.rowProps, isLast = props.isLast, onRowInViewport = props.onRowInViewport, onBottomReached = props.onBottomReached, intersectionMargin = props.intersectionMargin, onClick = props.onClick, subComponent = props.subComponent, isDisabled = props.isDisabled, tableHasSubRows = props.tableHasSubRows, tableInstance = props.tableInstance, expanderCell = props.expanderCell;
+    var row = props.row, rowProps = props.rowProps, isLast = props.isLast, onRowInViewport = props.onRowInViewport, onBottomReached = props.onBottomReached, intersectionMargin = props.intersectionMargin, onClick = props.onClick, subComponent = props.subComponent, isDisabled = props.isDisabled, tableHasSubRows = props.tableHasSubRows, tableInstance = props.tableInstance, expanderCell = props.expanderCell, bodyRef = props.bodyRef;
     var onIntersect = react_1.default.useCallback(function () {
         var _a, _b;
         (_a = onRowInViewport.current) === null || _a === void 0 ? void 0 : _a.call(onRowInViewport, row.original);
         isLast && ((_b = onBottomReached.current) === null || _b === void 0 ? void 0 : _b.call(onBottomReached));
     }, [isLast, onBottomReached, onRowInViewport, row.original]);
-    var rowRef = (0, utils_1.useIntersection)(onIntersect, {
+    var intersectionRoot = react_1.default.useMemo(function () {
+        var _a, _b;
+        var isTableBodyScrollable = ((_a = bodyRef === null || bodyRef === void 0 ? void 0 : bodyRef.scrollHeight) !== null && _a !== void 0 ? _a : 0) > ((_b = bodyRef === null || bodyRef === void 0 ? void 0 : bodyRef.offsetHeight) !== null && _b !== void 0 ? _b : 0);
+        // If table body is scrollable, make it the intersection root
+        if (isTableBodyScrollable) {
+            return bodyRef;
+        }
+        // Otherwise, make the viewport the intersection root
+        return undefined;
+    }, [bodyRef]);
+    var intersectionRef = (0, utils_1.useIntersection)(onIntersect, {
         rootMargin: "".concat(intersectionMargin, "px"),
+        root: intersectionRoot,
     });
     var userRowProps = rowProps === null || rowProps === void 0 ? void 0 : rowProps(row);
     var mergedProps = __assign(__assign(__assign({}, row.getRowProps({ style: { flex: "0 0 auto", minWidth: '100%' } })), userRowProps), {
@@ -47,7 +58,7 @@ var TableRow = function (props) {
             'iui-disabled': isDisabled,
         }, userRowProps === null || userRowProps === void 0 ? void 0 : userRowProps.className),
     });
-    var refs = (0, utils_1.useMergedRefs)(rowRef, mergedProps.ref);
+    var refs = (0, utils_1.useMergedRefs)(intersectionRef, mergedProps.ref);
     return (react_1.default.createElement(react_1.default.Fragment, null,
         react_1.default.createElement("div", __assign({}, mergedProps, { ref: refs, onClick: function (event) {
                 var _a;
@@ -97,7 +108,12 @@ exports.TableRowMemoized = react_1.default.memo(exports.TableRow, function (prev
         prevProp.rowProps === nextProp.rowProps &&
         prevProp.expanderCell === nextProp.expanderCell &&
         prevProp.tableHasSubRows === nextProp.tableHasSubRows &&
+        prevProp.bodyRef === nextProp.bodyRef &&
         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/cjs/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/cjs/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/cjs/core/Table/cells/EditableCell.js

@@ -31,6 +31,7 @@ exports.EditableCell = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 var react_1 = __importDefault(require("react"));
+var utils_1 = require("../../utils");
 /**
  * Editable cell.
  * It should be passed to `cellRenderer`.
@@ -53,8 +54,9 @@ var EditableCell = function (props) {
     react_1.default.useEffect(function () {
         setValue(sanitizeString(cellProps.value));
     }, [cellProps.value]);
-    var _b = react_1.default.useState(false), isDirty = _b[0], setIsDirty = _b[1];
-    return (react_1.default.createElement("div", __assign({}, cellElementProps, { contentEditable: true, suppressContentEditableWarning: true }, rest, { onInput: function (e) {
+    var _b = react_1.default.useState((0, utils_1.getRandomValue)(10)), key = _b[0], setKey = _b[1];
+    var _c = react_1.default.useState(false), isDirty = _c[0], setIsDirty = _c[1];
+    return (react_1.default.createElement("div", __assign({}, cellElementProps, { contentEditable: true, suppressContentEditableWarning: true, key: key }, rest, { onInput: function (e) {
             var _a;
             setValue(sanitizeString(e.target.innerText));
             setIsDirty(true);
@@ -65,6 +67,9 @@ var EditableCell = function (props) {
                 onCellEdit(cellProps.column.id, value, cellProps.row.original);
             }
             (_a = props.onBlur) === null || _a === void 0 ? void 0 : _a.call(props, e);
+            // Prevents error when text is cleared.
+            // New key makes React to reattach with the DOM so it won't complain about deleted text node.
+            setKey((0, utils_1.getRandomValue)(10));
         }, onKeyDown: function (e) {
             var _a;
             // Prevents from adding HTML elements (div, br) inside a cell on Enter press

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

@@ -55,11 +55,13 @@ 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_1.default.createElement(Checkbox_1.Checkbox, __assign({}, getToggleAllRowsSelectedProps(), { style: {}, checked: checked && !disabled, indeterminate: !checked && Object.keys(state.selectedRowIds).length > 0, disabled: disabled })));
+            return (react_1.default.createElement(Checkbox_1.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_1.default.createElement(Checkbox_1.Checkbox, __assign({}, row.getToggleRowSelectedProps(), { style: {}, disabled: isDisabled === null || isDisabled === void 0 ? void 0 : isDisabled(row.original), onClick: function (e) { return e.stopPropagation(); } })));
+            return (react_1.default.createElement(Checkbox_1.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_1.default.createElement(cells_1.DefaultCell, __assign({}, props, { isDisabled: function (rowData) { return !!(isDisabled === null || isDisabled === void 0 ? void 0 : isDisabled(rowData)); } }))); },
     };

package/cjs/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/cjs/core/Table/hooks/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useColumnDragAndDrop = exports.useResizeColumns = exports.useSubRowSelection = exports.useSubRowFiltering = exports.useSelectionCell = exports.useExpanderCell = void 0;
+exports.useStickyColumns = exports.useColumnDragAndDrop = exports.useResizeColumns = exports.useSubRowSelection = exports.useSubRowFiltering = exports.useSelectionCell = exports.useExpanderCell = void 0;
 /*---------------------------------------------------------------------------------------------
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -17,3 +17,5 @@ var useResizeColumns_1 = require("./useResizeColumns");
 Object.defineProperty(exports, "useResizeColumns", { enumerable: true, get: function () { return useResizeColumns_1.useResizeColumns; } });
 var useColumnDragAndDrop_1 = require("./useColumnDragAndDrop");
 Object.defineProperty(exports, "useColumnDragAndDrop", { enumerable: true, get: function () { return useColumnDragAndDrop_1.useColumnDragAndDrop; } });
+var useStickyColumns_1 = require("./useStickyColumns");
+Object.defineProperty(exports, "useStickyColumns", { enumerable: true, get: function () { return useStickyColumns_1.useStickyColumns; } });

package/cjs/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;

package/cjs/core/Table/hooks/useStickyColumns.js

@@ -0,0 +1,84 @@
+"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 __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStickyColumns = 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_table_1 = require("react-table");
+react_table_1.actions.setScrolledLeft = 'setScrolledLeft';
+react_table_1.actions.setScrolledRight = 'setScrolledRight';
+var useStickyColumns = function (hooks) {
+    hooks.stateReducers.push(reducer);
+    hooks.useInstance.push(useInstance);
+};
+exports.useStickyColumns = useStickyColumns;
+var reducer = function (newState, action) {
+    var _a, _b;
+    if (action.type === react_table_1.actions.init) {
+        return __assign(__assign({}, newState), { sticky: {} });
+    }
+    if (action.type === react_table_1.actions.setScrolledLeft &&
+        ((_a = newState.sticky) === null || _a === void 0 ? void 0 : _a.isScrolledToLeft) !== action.value // Prevents unnecessary re-render
+    ) {
+        return __assign(__assign({}, newState), { sticky: __assign(__assign({}, newState.sticky), { isScrolledToLeft: action.value }) });
+    }
+    if (action.type === react_table_1.actions.setScrolledRight &&
+        ((_b = newState.sticky) === null || _b === void 0 ? void 0 : _b.isScrolledToRight) !== action.value // Prevents unnecessary re-render
+    ) {
+        return __assign(__assign({}, newState), { sticky: __assign(__assign({}, newState.sticky), { isScrolledToRight: action.value }) });
+    }
+    return newState;
+};
+var useInstance = function (instance) {
+    var flatHeaders = instance.flatHeaders;
+    // Edge case. Saving original sticky state in case sticky columns are reordered.
+    flatHeaders.forEach(function (header) {
+        var _a;
+        if (!header.originalSticky) {
+            header.originalSticky = (_a = header.sticky) !== null && _a !== void 0 ? _a : 'none';
+        }
+        header.sticky =
+            header.originalSticky === 'none' ? undefined : header.originalSticky;
+    });
+    // If there is a column that is sticked to the left, make every column prior to that sticky too.
+    var hasLeftStickyColumn = false;
+    __spreadArray([], flatHeaders, true).reverse().forEach(function (header) {
+        if (header.sticky === 'left') {
+            hasLeftStickyColumn = true;
+        }
+        if (hasLeftStickyColumn) {
+            header.sticky = 'left';
+        }
+    });
+    // If there is a column that is sticked to the right, make every column after to that sticky too.
+    var hasRightStickyColumn = false;
+    flatHeaders.forEach(function (header) {
+        if (header.sticky === 'right') {
+            hasRightStickyColumn = true;
+        }
+        if (hasRightStickyColumn) {
+            header.sticky = 'right';
+        }
+    });
+};

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

@@ -1,2 +1,3 @@
 import { ColumnInstance } from 'react-table';
 export declare const getCellStyle: <T extends Record<string, unknown>>(column: ColumnInstance<T>, isTableResizing: boolean) => React.CSSProperties | undefined;
+export declare const getStickyStyle: <T extends Record<string, unknown>>(column: ColumnInstance<T>, columnList: ColumnInstance<T>[]) => React.CSSProperties;

package/cjs/core/Table/utils.js

@@ -1,6 +1,15 @@
 "use strict";
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCellStyle = void 0;
+exports.getStickyStyle = exports.getCellStyle = void 0;
 var getCellStyle = function (column, isTableResizing) {
     var style = {};
     style.flex = "1 1 145px";
@@ -24,3 +33,29 @@ var getCellStyle = function (column, isTableResizing) {
     return style;
 };
 exports.getCellStyle = getCellStyle;
+var getStickyStyle = function (column, columnList) {
+    if (!column.sticky) {
+        return {};
+    }
+    var left = 0;
+    for (var _i = 0, columnList_1 = columnList; _i < columnList_1.length; _i++) {
+        var col = columnList_1[_i];
+        if (col.id === column.id) {
+            break;
+        }
+        left += Number(col.width || col.resizeWidth || 0);
+    }
+    var right = 0;
+    for (var _a = 0, _b = __spreadArray([], columnList, true).reverse(); _a < _b.length; _a++) {
+        var col = _b[_a];
+        if (col.id === column.id) {
+            break;
+        }
+        right += Number(col.width || col.resizeWidth || 0);
+    }
+    return {
+        '--iui-table-sticky-left': column.sticky === 'left' ? "".concat(left, "px") : undefined,
+        '--iui-table-sticky-right': column.sticky === 'right' ? "".concat(right, "px") : undefined,
+    };
+};
+exports.getStickyStyle = getStickyStyle;

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

@@ -291,11 +291,11 @@ var useVirtualization = function (props) {
         updateVirtualScroll();
     }, [scrollContainerHeight, updateVirtualScroll]);
     return {
-        outerProps: __assign({ style: __assign({ overflow: 'hidden', minHeight: itemsLength > 1
+        outerProps: __assign({ style: __assign({ minHeight: itemsLength > 1
                     ? Math.max(itemsLength - 2, 0) * childHeight.current.middle +
                         childHeight.current.first +
                         childHeight.current.last
-                    : childHeight.current.middle, width: '100%' }, style) }, rest),
+                    : childHeight.current.middle, minWidth: '100%' }, style) }, rest),
         innerProps: {
             style: { willChange: 'transform' },
             ref: (0, hooks_1.mergeRefs)(parentRef), // convert object ref to callback ref for better types

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;
@@ -68,6 +68,7 @@ export var ComboBox = function (props) {
     var inputRef = React.useRef(null);
     var menuRef = React.useRef(null);
     var toggleButtonRef = React.useRef(null);
+    var mounted = React.useRef(false);
     // Latest value of the onChange prop
     var onChangeProp = React.useRef(onChange);
     React.useEffect(function () {
@@ -89,12 +90,14 @@ 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,
+        selectedIndex: valueProp
+            ? options.findIndex(function (option) { return option.value === valueProp; })
+            : -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 +116,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;
@@ -150,14 +163,14 @@ export var ComboBox = function (props) {
     // Call user-defined onChange when the value actually changes
     React.useEffect(function () {
         var _a, _b;
-        if (selectedIndex != undefined && selectedIndex >= 0) {
-            var value = (_a = options[selectedIndex]) === null || _a === void 0 ? void 0 : _a.value;
-            if (value === valueProp) {
-                return;
-            }
-            (_b = onChangeProp.current) === null || _b === void 0 ? void 0 : _b.call(onChangeProp, value);
+        // Prevent user-defined onChange to be called on mount
+        if (!mounted.current) {
+            mounted.current = true;
+            return;
         }
-    }, [options, selectedIndex, valueProp]);
+        var value = (_a = options[selectedIndex]) === null || _a === void 0 ? void 0 : _a.value;
+        (_b = onChangeProp.current) === null || _b === void 0 ? void 0 : _b.call(onChangeProp, value);
+    }, [options, selectedIndex]);
     var getMenuItem = React.useCallback(function (option, filteredIndex) {
         var optionId = getOptionId(option, id);
         var __originalIndex = optionsExtraInfoRef.current[optionId].__originalIndex;
@@ -173,6 +186,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 +201,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 +222,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;