@itwin/itwinui-react 1.44.0 → 1.46.0

package/cjs/core/utils/hooks/useDragAndDrop.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDragAndDrop = 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 functions_1 = require("../functions");
+var useEventListener_1 = require("./useEventListener");
+var useResizeObserver_1 = require("./useResizeObserver");
+var getContainerRect = function (containerRef) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    var containerRect = (_a = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
+    return {
+        top: (_b = containerRect === null || containerRect === void 0 ? void 0 : containerRect.top) !== null && _b !== void 0 ? _b : 0,
+        right: (_e = (_c = containerRect === null || containerRect === void 0 ? void 0 : containerRect.right) !== null && _c !== void 0 ? _c : (_d = (0, functions_1.getWindow)()) === null || _d === void 0 ? void 0 : _d.innerWidth) !== null && _e !== void 0 ? _e : 0,
+        bottom: (_h = (_f = containerRect === null || containerRect === void 0 ? void 0 : containerRect.bottom) !== null && _f !== void 0 ? _f : (_g = (0, functions_1.getWindow)()) === null || _g === void 0 ? void 0 : _g.innerHeight) !== null && _h !== void 0 ? _h : 0,
+        left: (_j = containerRect === null || containerRect === void 0 ? void 0 : containerRect.left) !== null && _j !== void 0 ? _j : 0,
+    };
+};
+/**
+ * Helper hook that handles elements drag logic.
+ * @param elementRef Element ref that is draggable.
+ * @param containerRect Bounding rectangle of container element that element can't go outside. If not passed window is used as a container.
+ * @returns
+ * `onPointerDown` - handler that is called when pointer is down and handles all the dragging logic.
+ * `transform` - current transform of the element, it is used to preserve drag position when element visibility is being toggled.
+ */
+var useDragAndDrop = function (elementRef, containerRef, enabled) {
+    if (enabled === void 0) { enabled = true; }
+    var grabOffsetX = react_1.default.useRef(0);
+    var grabOffsetY = react_1.default.useRef(0);
+    var translateX = react_1.default.useRef();
+    var translateY = react_1.default.useRef();
+    var containerRectRef = react_1.default.useRef(getContainerRect(containerRef));
+    var adjustTransform = react_1.default.useCallback(function () {
+        var _a;
+        if (!elementRef.current || !enabled) {
+            return;
+        }
+        var _b = (_a = elementRef.current) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect(), top = _b.top, right = _b.right, bottom = _b.bottom, left = _b.left;
+        var _c = (0, functions_1.getTranslateValues)(elementRef.current), newTranslateX = _c[0], newTranslateY = _c[1];
+        containerRectRef.current = getContainerRect(containerRef);
+        if (bottom > containerRectRef.current.bottom) {
+            newTranslateY -= bottom - containerRectRef.current.bottom;
+        }
+        if (top < containerRectRef.current.top) {
+            newTranslateY += containerRectRef.current.top - top;
+        }
+        if (right > containerRectRef.current.right) {
+            newTranslateX -= right - containerRectRef.current.right;
+        }
+        if (left < containerRectRef.current.left) {
+            newTranslateX += containerRectRef.current.left - left;
+        }
+        translateX.current = newTranslateX;
+        translateY.current = newTranslateY;
+        elementRef.current.style.transform = "translate(".concat(newTranslateX, "px, ").concat(newTranslateY, "px)");
+    }, [containerRef, elementRef, enabled]);
+    var _a = (0, useResizeObserver_1.useResizeObserver)(adjustTransform), resizeRef = _a[0], resizeObserver = _a[1];
+    resizeRef(containerRef === null || containerRef === void 0 ? void 0 : containerRef.current);
+    react_1.default.useEffect(function () {
+        return function () {
+            resizeObserver === null || resizeObserver === void 0 ? void 0 : resizeObserver.disconnect();
+        };
+    }, [resizeObserver]);
+    (0, useEventListener_1.useEventListener)('resize', function () {
+        adjustTransform();
+        if (translateX.current != null && translateY.current != null) {
+            setTransform("translate(".concat(translateX.current, "px, ").concat(translateY.current, "px)"));
+        }
+    }, (0, functions_1.getWindow)());
+    var _b = react_1.default.useState(''), transform = _b[0], setTransform = _b[1];
+    var onPointerMove = react_1.default.useRef(function (event) {
+        if (!elementRef.current) {
+            return;
+        }
+        var newTranslateX = event.clientX - grabOffsetX.current;
+        var newTranslateY = event.clientY - grabOffsetY.current;
+        elementRef.current.style.transform = "translate(".concat(newTranslateX, "px, ").concat(newTranslateY, "px)");
+        adjustTransform();
+    });
+    var originalUserSelect = react_1.default.useRef('');
+    var onPointerDown = react_1.default.useCallback(function (e) {
+        if (!elementRef.current || e.button !== 0 || !enabled) {
+            return;
+        }
+        var _a = (0, functions_1.getTranslateValues)(elementRef.current), x = _a[0], y = _a[1];
+        grabOffsetX.current = e.clientX - x;
+        grabOffsetY.current = e.clientY - y;
+        originalUserSelect.current = elementRef.current.style.userSelect;
+        // Prevents from selecting inner content when dragging.
+        elementRef.current.style.userSelect = 'none';
+        elementRef.current.ownerDocument.addEventListener('pointermove', onPointerMove.current);
+        elementRef.current.ownerDocument.addEventListener('pointerup', function () {
+            setTransform("translate(".concat(translateX.current, "px, ").concat(translateY.current, "px)"));
+            document.removeEventListener('pointermove', onPointerMove.current);
+            if (elementRef.current) {
+                elementRef.current.style.userSelect = originalUserSelect.current;
+            }
+        }, { once: true });
+    }, [elementRef, enabled]);
+    return { onPointerDown: onPointerDown, transform: transform };
+};
+exports.useDragAndDrop = useDragAndDrop;
+exports.default = exports.useDragAndDrop;

package/cjs/core/utils/hooks/useEventListener.d.ts

@@ -7,4 +7,4 @@
  *     containerRef.current?.ownerDocument,
  *  );
  */
-export declare const useEventListener: (eventName: string, handler: (event: Event) => void, element: HTMLElement | Document | undefined) => void;
+export declare const useEventListener: (eventName: string, handler: (event: Event) => void, element: HTMLElement | Document | Window | undefined) => void;

package/cjs/core/utils/hooks/useOverflow.d.ts

@@ -21,4 +21,4 @@ import React from 'react';
  *   </div>
  * );
  */
-export declare const useOverflow: <T extends HTMLElement>(items: React.ReactNode[] | string, disabled?: boolean, orientation?: 'horizontal' | 'vertical') => readonly [(instance: T | null) => void, number];
+export declare const useOverflow: <T extends HTMLElement>(items: React.ReactNode[] | string, disabled?: boolean, orientation?: 'horizontal' | 'vertical') => readonly [(instance: T | null | undefined) => void, number];

package/cjs/core/utils/hooks/useResizeObserver.d.ts

@@ -10,4 +10,4 @@
  * ...
  * return <div ref={ref}>...</div>;
  */
-export declare const useResizeObserver: <T extends HTMLElement>(onResize: (size: DOMRectReadOnly) => void) => readonly [(element: T | null) => void, ResizeObserver | undefined];
+export declare const useResizeObserver: <T extends HTMLElement>(onResize: (size: DOMRectReadOnly) => void) => readonly [(element: T | null | undefined) => void, ResizeObserver | undefined];

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

@@ -19,7 +19,7 @@ declare module 'react-table' {
          */
         isDisabled?: (rowData: D) => boolean;
     };
-    interface TableOptions<D extends object = {}> extends Omit<UseTableOptions<D>, 'data'>, UseRowSelectOptions<D>, UseExpandedOptions<D>, UseFiltersOptions<D>, UsePaginationOptions<D>, Omit<UseResizeColumnsOptions<D>, 'disableResizing'>, UseSortByOptions<D> {
+    interface TableOptions<D extends object = {}> extends Omit<UseTableOptions<D>, 'data'>, UseRowSelectOptions<D>, UseExpandedOptions<D>, UseFiltersOptions<D>, UsePaginationOptions<D>, UseGlobalFiltersOptions<D>, UseGlobalFiltersColumnOptions<D>, Omit<UseResizeColumnsOptions<D>, 'disableResizing'>, UseSortByOptions<D> {
         /**
          * Table data list.
          * Must be memoized.
@@ -50,6 +50,7 @@ declare module 'react-table' {
             isScrolledToRight?: boolean;
             isScrolledToLeft?: boolean;
         };
+        lastSelectedRowId?: string;
     }
     interface ColumnInterface<D extends object = {}> extends UseSortByColumnOptions<D>, UseFiltersColumnOptions<D>, UseResizeColumnsColumnOptions<D> {
         /**

package/esm/core/Breadcrumbs/Breadcrumbs.d.ts

@@ -16,6 +16,64 @@ export declare type BreadcrumbsProps = {
      * Defaults to the `SvgChevronRight` icon.
      */
     separator?: React.ReactNode;
+    /**
+     * If specified, this prop will be used to show a custom button when overflow happens,
+     * i.e. when there is not enough space to fit all the breadcrumbs.
+     *
+     * Expects a function that takes the number of items that are visible
+     * and returns the `ReactNode` to render.
+     *
+     * @example <caption>Uses the overflow button to redirect to the previous breadcrumb</caption>
+     *  <Breadcrumbs
+     *    overflowButton={(visibleCount: number) => {
+     *      const previousBreadcrumb = visibleCount > 1 ? items.length - visibleCount : items.length - 2;
+     *      return (
+     *        <Tooltip content={`Item ${previousBreadcrumb}`} placement='bottom'>
+     *          <IconButton
+     *            onClick={() => {
+     *              // click on "previousBreadcrumb"
+     *            }}
+     *          >
+     *            <SvgMoreSmall />
+     *          </IconButton>
+     *        </Tooltip>
+     *      );
+     *    }}
+     *  >
+     *    {items}
+     *  </Breadcrumbs>
+     *
+     * @example <caption>Uses the overflow button to add a dropdown that contains hidden breadcrumbs</caption>
+     *  <Breadcrumbs
+     *    overflowButton={(visibleCount) => (
+     *      <DropdownMenu
+     *        menuItems={(close) =>
+     *          Array(items.length - visibleCount)
+     *            .fill(null)
+     *            .map((_, _index) => {
+     *              const index = visibleCount > 1 ? _index + 1 : _index;
+     *              const onClick = () => {
+     *                // click on "index" breadcrumb
+     *                close();
+     *              };
+     *              return (
+     *                <MenuItem key={index} onClick={onClick}>
+     *                  Item {index}
+     *                </MenuItem>
+     *              );
+     *            })
+     *        }
+     *      >
+     *        <IconButton>
+     *          <SvgMoreSmall />
+     *        </IconButton>
+     *      </DropdownMenu>
+     *    )}
+     *  >
+     *    {items}
+     *  </Breadcrumbs>
+     */
+    overflowButton?: (visibleCount: number) => React.ReactNode;
 } & Omit<CommonProps, 'title'>;
 /**
  * A breadcrumb trail is used as a navigational aid to help users keep track
@@ -54,5 +112,63 @@ export declare const Breadcrumbs: React.ForwardRefExoticComponent<{
      * Defaults to the `SvgChevronRight` icon.
      */
     separator?: React.ReactNode;
+    /**
+     * If specified, this prop will be used to show a custom button when overflow happens,
+     * i.e. when there is not enough space to fit all the breadcrumbs.
+     *
+     * Expects a function that takes the number of items that are visible
+     * and returns the `ReactNode` to render.
+     *
+     * @example <caption>Uses the overflow button to redirect to the previous breadcrumb</caption>
+     *  <Breadcrumbs
+     *    overflowButton={(visibleCount: number) => {
+     *      const previousBreadcrumb = visibleCount > 1 ? items.length - visibleCount : items.length - 2;
+     *      return (
+     *        <Tooltip content={`Item ${previousBreadcrumb}`} placement='bottom'>
+     *          <IconButton
+     *            onClick={() => {
+     *              // click on "previousBreadcrumb"
+     *            }}
+     *          >
+     *            <SvgMoreSmall />
+     *          </IconButton>
+     *        </Tooltip>
+     *      );
+     *    }}
+     *  >
+     *    {items}
+     *  </Breadcrumbs>
+     *
+     * @example <caption>Uses the overflow button to add a dropdown that contains hidden breadcrumbs</caption>
+     *  <Breadcrumbs
+     *    overflowButton={(visibleCount) => (
+     *      <DropdownMenu
+     *        menuItems={(close) =>
+     *          Array(items.length - visibleCount)
+     *            .fill(null)
+     *            .map((_, _index) => {
+     *              const index = visibleCount > 1 ? _index + 1 : _index;
+     *              const onClick = () => {
+     *                // click on "index" breadcrumb
+     *                close();
+     *              };
+     *              return (
+     *                <MenuItem key={index} onClick={onClick}>
+     *                  Item {index}
+     *                </MenuItem>
+     *              );
+     *            })
+     *        }
+     *      >
+     *        <IconButton>
+     *          <SvgMoreSmall />
+     *        </IconButton>
+     *      </DropdownMenu>
+     *    )}
+     *  >
+     *    {items}
+     *  </Breadcrumbs>
+     */
+    overflowButton?: ((visibleCount: number) => React.ReactNode) | undefined;
 } & Omit<CommonProps, "title"> & React.RefAttributes<HTMLElement>>;
 export default Breadcrumbs;

package/esm/core/Breadcrumbs/Breadcrumbs.js

@@ -52,7 +52,7 @@ import '@itwin/itwinui-css/css/breadcrumbs.css';
  * </Breadcrumbs>
  */
 export var Breadcrumbs = React.forwardRef(function (props, ref) {
-    var items = props.children, _a = props.currentIndex, currentIndex = _a === void 0 ? items.length - 1 : _a, separator = props.separator, className = props.className, rest = __rest(props, ["children", "currentIndex", "separator", "className"]);
+    var items = props.children, _a = props.currentIndex, currentIndex = _a === void 0 ? items.length - 1 : _a, separator = props.separator, overflowButton = props.overflowButton, className = props.className, rest = __rest(props, ["children", "currentIndex", "separator", "overflowButton", "className"]);
     useTheme();
     var _b = useOverflow(items), overflowRef = _b[0], visibleCount = _b[1];
     var refs = useMergedRefs(overflowRef, ref);
@@ -62,8 +62,7 @@ export var Breadcrumbs = React.forwardRef(function (props, ref) {
                 React.createElement(ListItem, { item: items[0], isActive: currentIndex === 0 }),
                 React.createElement(Separator, { separator: separator }))),
             items.length - visibleCount > 0 && (React.createElement(React.Fragment, null,
-                React.createElement("li", { className: 'iui-breadcrumbs-item iui-breadcrumbs-item-overrides' },
-                    React.createElement("span", { className: 'iui-breadcrumbs-text' }, "\u2026")),
+                React.createElement("li", { className: 'iui-breadcrumbs-item iui-breadcrumbs-item-overrides' }, overflowButton ? (overflowButton(visibleCount)) : (React.createElement("span", { className: 'iui-breadcrumbs-text' }, "\u2026"))),
                 React.createElement(Separator, { separator: separator }))),
             items
                 .slice(visibleCount > 1

package/esm/core/ButtonGroup/ButtonGroup.js

@@ -72,7 +72,7 @@ export var ButtonGroup = React.forwardRef(function (props, ref) {
                 overflowButton &&
                 overflowPlacement === 'start' && (React.createElement("div", null, overflowButton(visibleCount))),
             visibleCount < items.length
-                ? items.slice(0, visibleCount - 1)
+                ? items.slice(0, Math.max(0, visibleCount - 1))
                 : items,
             visibleCount < items.length &&
                 overflowButton &&

package/esm/core/ColorPicker/ColorSwatch.d.ts

@@ -17,5 +17,5 @@ export declare type ColorSwatchProps = {
  * <ColorSwatch color='#23450b' onClick={onClick}/>
  * <ColorSwatch color={{ r: 255, g: 255, b: 0 }} onClick={onClick}/>
  */
-export declare const ColorSwatch: React.ForwardRefExoticComponent<Pick<ColorSwatchProps, "dir" | "slot" | "style" | "title" | "id" | "aria-disabled" | "children" | "role" | "className" | "onClick" | "accessKey" | "draggable" | "hidden" | "lang" | "translate" | "prefix" | "contentEditable" | "inputMode" | "tabIndex" | "onFocus" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "color" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "key" | "contextMenu" | "placeholder" | "spellCheck" | "radioGroup" | "about" | "datatype" | "inlist" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "is" | "isActive"> & React.RefAttributes<HTMLDivElement>>;
+export declare const ColorSwatch: React.ForwardRefExoticComponent<Pick<ColorSwatchProps, "dir" | "slot" | "style" | "title" | "id" | "aria-disabled" | "children" | "role" | "className" | "onClick" | "accessKey" | "onPointerDown" | "draggable" | "hidden" | "lang" | "translate" | "prefix" | "contentEditable" | "inputMode" | "tabIndex" | "onFocus" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "color" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "key" | "contextMenu" | "placeholder" | "spellCheck" | "radioGroup" | "about" | "datatype" | "inlist" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "is" | "isActive"> & React.RefAttributes<HTMLDivElement>>;
 export default ColorSwatch;

package/esm/core/DatePicker/DatePicker.d.ts

@@ -10,15 +10,35 @@ export declare const generateLocalizedStrings: (locale?: string) => {
     shortDays: string[];
     days: string[];
 };
-export declare type DatePickerProps = {
+export declare type DateRangePickerProps = {
     /**
-     * Selected date.
+     * Enable date range support.
+     * @default false
      */
-    date?: Date;
+    enableRangeSelect?: false;
+    /**
+     * Selected start date
+     */
+    startDate?: undefined;
+    /**
+     * Selected end date
+     */
+    endDate?: undefined;
     /**
      * Callback when date is changed.
      */
     onChange?: (date: Date) => void;
+} | {
+    enableRangeSelect: true;
+    startDate: Date;
+    endDate: Date;
+    onChange?: (startDate: Date, endDate: Date) => void;
+};
+export declare type DatePickerProps = {
+    /**
+     * Selected date.
+     */
+    date?: Date;
     /**
      * Pass localized week days (start from sunday) and months.
      * Use helper function `generateLocalizedStrings` to generate strings using `Intl.DateTimeFormat`.
@@ -41,7 +61,7 @@ export declare type DatePickerProps = {
      * @default false
      */
     showYearSelection?: boolean;
-} & Omit<TimePickerProps, 'date' | 'onChange' | 'setFocusHour'>;
+} & DateRangePickerProps & Omit<TimePickerProps, 'date' | 'onChange' | 'setFocusHour'>;
 /**
  * Date picker component
  * @example

package/esm/core/DatePicker/DatePicker.js

@@ -41,6 +41,33 @@ var isSameDay = function (a, b) {
         a.getMonth() === b.getMonth() &&
         a.getDate() === b.getDate());
 };
+var isInDateRange = function (date, startDate, endDate) {
+    if (!date || !startDate || !endDate) {
+        return false;
+    }
+    var minDate = new Date(startDate);
+    var maxDate = new Date(endDate);
+    var testDate = new Date(date);
+    testDate && testDate.setHours(0, 0, 0, 0);
+    minDate && minDate.setHours(0, 0, 0, 0);
+    maxDate && maxDate.setHours(0, 0, 0, 0);
+    return testDate > minDate && testDate < maxDate;
+};
+// compares to see if one date is earlier than another
+var isBefore = function (beforeDate, afterDate) {
+    if (!beforeDate || !afterDate) {
+        return false;
+    }
+    var firstDate = new Date(beforeDate);
+    var secondDate = new Date(afterDate);
+    firstDate && firstDate.setHours(0, 0, 0, 0);
+    secondDate && secondDate.setHours(0, 0, 0, 0);
+    return firstDate < secondDate;
+};
+// Type guard for multiple did not work
+var isSingleOnChange = function (onChange, enableRangeSelect) {
+    return !enableRangeSelect;
+};
 var defaultMonths = [
     'January',
     'February',
@@ -121,16 +148,20 @@ export var generateLocalizedStrings = function (locale) {
  * <DatePicker date={new Date()} onChange={(e) => console.log('New date value: ' + e)} />
  */
 export var DatePicker = function (props) {
-    var _a, _b, _c;
-    var date = props.date, onChange = props.onChange, localizedNames = props.localizedNames, className = props.className, style = props.style, _d = props.setFocus, setFocus = _d === void 0 ? false : _d, _e = props.showTime, showTime = _e === void 0 ? false : _e, _f = props.use12Hours, use12Hours = _f === void 0 ? false : _f, precision = props.precision, hourStep = props.hourStep, minuteStep = props.minuteStep, secondStep = props.secondStep, _g = props.showYearSelection, showYearSelection = _g === void 0 ? false : _g, rest = __rest(props, ["date", "onChange", "localizedNames", "className", "style", "setFocus", "showTime", "use12Hours", "precision", "hourStep", "minuteStep", "secondStep", "showYearSelection"]);
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var date = props.date, onChange = props.onChange, localizedNames = props.localizedNames, className = props.className, style = props.style, _j = props.setFocus, setFocus = _j === void 0 ? false : _j, _k = props.showTime, showTime = _k === void 0 ? false : _k, _l = props.use12Hours, use12Hours = _l === void 0 ? false : _l, precision = props.precision, hourStep = props.hourStep, minuteStep = props.minuteStep, secondStep = props.secondStep, _m = props.showYearSelection, showYearSelection = _m === void 0 ? false : _m, _o = props.enableRangeSelect, enableRangeSelect = _o === void 0 ? false : _o, startDate = props.startDate, endDate = props.endDate, rest = __rest(props, ["date", "onChange", "localizedNames", "className", "style", "setFocus", "showTime", "use12Hours", "precision", "hourStep", "minuteStep", "secondStep", "showYearSelection", "enableRangeSelect", "startDate", "endDate"]);
     useTheme();
     var monthNames = (_a = localizedNames === null || localizedNames === void 0 ? void 0 : localizedNames.months) !== null && _a !== void 0 ? _a : defaultMonths;
     var shortDays = (_b = localizedNames === null || localizedNames === void 0 ? void 0 : localizedNames.shortDays) !== null && _b !== void 0 ? _b : defaultShortDays;
     var longDays = (_c = localizedNames === null || localizedNames === void 0 ? void 0 : localizedNames.days) !== null && _c !== void 0 ? _c : defaultLongDays;
-    var _h = React.useState(date), selectedDay = _h[0], setSelectedDay = _h[1];
-    var _j = React.useState(selectedDay !== null && selectedDay !== void 0 ? selectedDay : new Date()), focusedDay = _j[0], setFocusedDay = _j[1];
-    var _k = React.useState(selectedDay ? selectedDay.getMonth() : new Date().getMonth()), displayedMonthIndex = _k[0], setDisplayedMonthIndex = _k[1];
-    var _l = React.useState(selectedDay ? selectedDay.getFullYear() : new Date().getFullYear()), displayedYear = _l[0], setDisplayedYear = _l[1];
+    var _p = React.useState(date), selectedDay = _p[0], setSelectedDay = _p[1];
+    var _q = React.useState(startDate), selectedStartDay = _q[0], setSelectedStartDay = _q[1];
+    var _r = React.useState(endDate), selectedEndDay = _r[0], setSelectedEndDay = _r[1];
+    var _s = React.useState((_d = selectedStartDay !== null && selectedStartDay !== void 0 ? selectedStartDay : selectedDay) !== null && _d !== void 0 ? _d : new Date()), focusedDay = _s[0], setFocusedDay = _s[1];
+    var _t = React.useState((_f = (_e = selectedStartDay === null || selectedStartDay === void 0 ? void 0 : selectedStartDay.getMonth()) !== null && _e !== void 0 ? _e : selectedDay === null || selectedDay === void 0 ? void 0 : selectedDay.getMonth()) !== null && _f !== void 0 ? _f : new Date().getMonth()), displayedMonthIndex = _t[0], setDisplayedMonthIndex = _t[1];
+    var _u = React.useState((_h = (_g = selectedStartDay === null || selectedStartDay === void 0 ? void 0 : selectedStartDay.getFullYear()) !== null && _g !== void 0 ? _g : selectedDay === null || selectedDay === void 0 ? void 0 : selectedDay.getFullYear()) !== null && _h !== void 0 ? _h : new Date().getFullYear()), displayedYear = _u[0], setDisplayedYear = _u[1];
+    // boolean that toggles between the user picking the start date and end date for date range
+    var _v = React.useState(true), isSelectingStartDate = _v[0], setIsSelectingStartDate = _v[1];
     // Used to focus days only when days are changed
     // e.g. without this, when changing months day would be focused
     var needFocus = React.useRef(setFocus);
@@ -144,11 +175,16 @@ export var DatePicker = function (props) {
         setDisplayedYear(newYear);
     }, []);
     React.useEffect(function () {
+        var _a, _b, _c, _d;
         var currentDate = new Date();
         setSelectedDay(date);
-        setFocusedDay(date !== null && date !== void 0 ? date : currentDate);
-        setMonthAndYear(date ? date.getMonth() : currentDate.getMonth(), date ? date.getFullYear() : currentDate.getFullYear());
-    }, [date, setMonthAndYear]);
+        setSelectedStartDay(startDate);
+        setSelectedEndDay(endDate);
+        if (!enableRangeSelect) {
+            setFocusedDay(date !== null && date !== void 0 ? date : currentDate);
+        }
+        setMonthAndYear((_b = (_a = startDate === null || startDate === void 0 ? void 0 : startDate.getMonth()) !== null && _a !== void 0 ? _a : date === null || date === void 0 ? void 0 : date.getMonth()) !== null && _b !== void 0 ? _b : currentDate.getMonth(), (_d = (_c = startDate === null || startDate === void 0 ? void 0 : startDate.getFullYear()) !== null && _c !== void 0 ? _c : date === null || date === void 0 ? void 0 : date.getFullYear()) !== null && _d !== void 0 ? _d : currentDate.getFullYear());
+    }, [date, setMonthAndYear, startDate, endDate, enableRangeSelect]);
     var days = React.useMemo(function () {
         var offsetToFirst = new Date(displayedYear, displayedMonthIndex, 1).getDay();
         // if its sunday, show one week before
@@ -172,7 +208,8 @@ export var DatePicker = function (props) {
         return weeksInMonth;
     }, [days]);
     var getNewFocusedDate = function (newYear, newMonth) {
-        var currentDate = selectedDay !== null && selectedDay !== void 0 ? selectedDay : new Date();
+        var _a;
+        var currentDate = (_a = selectedStartDay !== null && selectedStartDay !== void 0 ? selectedStartDay : selectedDay) !== null && _a !== void 0 ? _a : new Date();
         var newDate = new Date(newYear, newMonth, currentDate.getDate(), currentDate.getHours(), currentDate.getMinutes(), currentDate.getSeconds());
         return newDate;
     };
@@ -199,14 +236,55 @@ export var DatePicker = function (props) {
         setFocusedDay(getNewFocusedDate(newYear, newMonth));
     };
     var onDayClick = function (day) {
-        if (day.getMonth() !== (selectedDay === null || selectedDay === void 0 ? void 0 : selectedDay.getMonth())) {
-            setMonthAndYear(day.getMonth(), day.getFullYear());
+        // single date selection
+        if (!enableRangeSelect) {
+            if (day.getMonth() !== (selectedDay === null || selectedDay === void 0 ? void 0 : selectedDay.getMonth())) {
+                setMonthAndYear(day.getMonth(), day.getFullYear());
+            }
+            var currentDate = selectedDay !== null && selectedDay !== void 0 ? selectedDay : new Date();
+            var newDate = new Date(day.getFullYear(), day.getMonth(), day.getDate(), currentDate.getHours(), currentDate.getMinutes(), currentDate.getSeconds());
+            setSelectedDay(newDate);
+            setFocusedDay(newDate);
+            isSingleOnChange(onChange, enableRangeSelect) && (onChange === null || onChange === void 0 ? void 0 : onChange(newDate));
+        }
+        // start date selection (date range only)
+        else if (isSelectingStartDate) {
+            if (day.getMonth() !== (selectedStartDay === null || selectedStartDay === void 0 ? void 0 : selectedStartDay.getMonth())) {
+                setMonthAndYear(day.getMonth(), day.getFullYear());
+            }
+            var currentStartDate = selectedStartDay !== null && selectedStartDay !== void 0 ? selectedStartDay : new Date();
+            var newStartDate = new Date(day.getFullYear(), day.getMonth(), day.getDate(), currentStartDate.getHours(), currentStartDate.getMinutes(), currentStartDate.getSeconds());
+            setSelectedStartDay(newStartDate);
+            setFocusedDay(newStartDate);
+            // if the start date is after the end date or the end date is undefined, reset the end date
+            if (!isBefore(newStartDate, selectedEndDay)) {
+                setSelectedEndDay(newStartDate);
+                onChange === null || onChange === void 0 ? void 0 : onChange(newStartDate, newStartDate);
+            }
+            else {
+                selectedEndDay && (onChange === null || onChange === void 0 ? void 0 : onChange(newStartDate, selectedEndDay));
+            }
+            setIsSelectingStartDate(false);
+        }
+        // end date selection (date range only)
+        else {
+            if (day.getMonth() !== (selectedEndDay === null || selectedEndDay === void 0 ? void 0 : selectedEndDay.getMonth())) {
+                setMonthAndYear(day.getMonth(), day.getFullYear());
+            }
+            var currentEndDate = selectedEndDay !== null && selectedEndDay !== void 0 ? selectedEndDay : new Date();
+            var newEndDate = new Date(day.getFullYear(), day.getMonth(), day.getDate(), currentEndDate.getHours(), currentEndDate.getMinutes(), currentEndDate.getSeconds());
+            setFocusedDay(newEndDate);
+            // if the end date is before the start date, move back the start date and still have user select end date
+            if (!isBefore(newEndDate, selectedStartDay)) {
+                setSelectedEndDay(newEndDate);
+                selectedStartDay && (onChange === null || onChange === void 0 ? void 0 : onChange(selectedStartDay, newEndDate));
+                setIsSelectingStartDate(true);
+            }
+            else {
+                setSelectedStartDay(newEndDate);
+                selectedEndDay && (onChange === null || onChange === void 0 ? void 0 : onChange(newEndDate, selectedEndDay));
+            }
         }
-        var currentDate = selectedDay !== null && selectedDay !== void 0 ? selectedDay : new Date();
-        var newDate = new Date(day.getFullYear(), day.getMonth(), day.getDate(), currentDate.getHours(), currentDate.getMinutes(), currentDate.getSeconds());
-        setSelectedDay(newDate);
-        setFocusedDay(newDate);
-        onChange === null || onChange === void 0 ? void 0 : onChange(newDate);
     };
     var handleCalendarKeyDown = function (event) {
         if (!focusedDay) {
@@ -263,9 +341,23 @@ export var DatePicker = function (props) {
             return 'iui-calendar-day-outside-month';
         }
         var dayClass = 'iui-calendar-day';
-        if (isSameDay(day, selectedDay)) {
+        var isSelectedDay = isSameDay(day, selectedDay) ||
+            (isSameDay(day, selectedStartDay) && isSameDay(day, selectedEndDay));
+        if (isSelectedDay) {
             dayClass += '-selected';
         }
+        else if (isSameDay(day, selectedStartDay)) {
+            dayClass += '-range-start';
+        }
+        else if (isSameDay(day, selectedEndDay)) {
+            dayClass += '-range-end';
+        }
+        // adds range class to dates between start and end date
+        if (selectedStartDay &&
+            selectedEndDay &&
+            isInDateRange(day, selectedStartDay, selectedEndDay)) {
+            dayClass += '-range';
+        }
         if (isSameDay(day, new Date())) {
             dayClass += '-today';
         }
@@ -297,6 +389,11 @@ export var DatePicker = function (props) {
                         } }, dateValue));
                 })));
             }))),
-        showTime && (React.createElement(TimePicker, { date: selectedDay, use12Hours: use12Hours, precision: precision, hourStep: hourStep, minuteStep: minuteStep, secondStep: secondStep, onChange: function (date) { return onChange === null || onChange === void 0 ? void 0 : onChange(date); } }))));
+        showTime && (React.createElement(TimePicker, { date: selectedStartDay !== null && selectedStartDay !== void 0 ? selectedStartDay : selectedDay, use12Hours: use12Hours, precision: precision, hourStep: hourStep, minuteStep: minuteStep, secondStep: secondStep, onChange: function (date) {
+                var _a, _b, _c, _d, _e, _f;
+                return isSingleOnChange(onChange, enableRangeSelect)
+                    ? onChange === null || onChange === void 0 ? void 0 : onChange(date)
+                    : onChange === null || onChange === void 0 ? void 0 : onChange(new Date((_a = selectedStartDay === null || selectedStartDay === void 0 ? void 0 : selectedStartDay.getFullYear()) !== null && _a !== void 0 ? _a : date.getFullYear(), (_b = selectedStartDay === null || selectedStartDay === void 0 ? void 0 : selectedStartDay.getMonth()) !== null && _b !== void 0 ? _b : date.getMonth(), (_c = selectedStartDay === null || selectedStartDay === void 0 ? void 0 : selectedStartDay.getDate()) !== null && _c !== void 0 ? _c : date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds()), new Date((_d = selectedEndDay === null || selectedEndDay === void 0 ? void 0 : selectedEndDay.getFullYear()) !== null && _d !== void 0 ? _d : date.getFullYear(), (_e = selectedEndDay === null || selectedEndDay === void 0 ? void 0 : selectedEndDay.getMonth()) !== null && _e !== void 0 ? _e : date.getMonth(), (_f = selectedEndDay === null || selectedEndDay === void 0 ? void 0 : selectedEndDay.getDate()) !== null && _f !== void 0 ? _f : date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds()));
+            } }))));
 };
 export default DatePicker;

package/esm/core/Dialog/Dialog.d.ts

@@ -6,7 +6,7 @@ export declare type DialogProps = {
      * Dialog content.
      */
     children: React.ReactNode;
-} & DialogContextProps;
+} & Omit<DialogContextProps, 'dialogRootRef'> & React.ComponentPropsWithRef<'div'>;
 /**
  * Dialog component.
  * @example
@@ -29,10 +29,10 @@ export declare type DialogProps = {
  *   </Dialog.Main>
  * </Dialog>
  */
-export declare const Dialog: ((props: DialogProps) => JSX.Element) & {
-    Backdrop: React.ForwardRefExoticComponent<Pick<import("./DialogBackdrop").DialogBackdropProps, "onClose" | "key" | keyof React.HTMLAttributes<HTMLDivElement> | "isVisible" | "isDismissible" | "closeOnExternalClick"> & React.RefAttributes<HTMLDivElement>>;
-    Main: React.ForwardRefExoticComponent<Pick<import("./DialogMain").DialogMainProps, "onClose" | "key" | keyof React.HTMLAttributes<HTMLDivElement> | "styleType" | "isOpen" | "isDismissible" | "closeOnEsc" | "trapFocus" | "preventDocumentScroll"> & React.RefAttributes<HTMLDivElement>>;
-    TitleBar: React.ForwardRefExoticComponent<Pick<import("./DialogTitleBar").DialogTitleBarProps, "onClose" | "key" | keyof React.HTMLAttributes<HTMLDivElement> | "isDismissible" | "titleText"> & React.RefAttributes<HTMLDivElement>> & {
+export declare const Dialog: React.ForwardRefExoticComponent<Pick<DialogProps, "onClose" | "key" | keyof React.HTMLAttributes<HTMLDivElement> | "setFocus" | "isOpen" | "isDismissible" | "isDraggable" | "closeOnExternalClick" | "closeOnEsc" | "trapFocus" | "preventDocumentScroll" | "isResizable" | "relativeTo"> & React.RefAttributes<HTMLDivElement>> & {
+    Backdrop: React.ForwardRefExoticComponent<Pick<import("./DialogBackdrop").DialogBackdropProps, "onClose" | "key" | keyof React.HTMLAttributes<HTMLDivElement> | "isVisible" | "isDismissible" | "closeOnExternalClick" | "relativeTo"> & React.RefAttributes<HTMLDivElement>>;
+    Main: React.ForwardRefExoticComponent<Pick<import("./DialogMain").DialogMainProps, "onClose" | "key" | keyof React.HTMLAttributes<HTMLDivElement> | "styleType" | "setFocus" | "isOpen" | "isDismissible" | "isDraggable" | "closeOnEsc" | "trapFocus" | "preventDocumentScroll" | "isResizable" | "relativeTo"> & React.RefAttributes<HTMLDivElement>>;
+    TitleBar: React.ForwardRefExoticComponent<Pick<import("./DialogTitleBar").DialogTitleBarProps, "onClose" | "key" | keyof React.HTMLAttributes<HTMLDivElement> | "isDismissible" | "isDraggable" | "titleText"> & React.RefAttributes<HTMLDivElement>> & {
         Title: React.ForwardRefExoticComponent<Pick<import("./DialogTitleBarTitle").DialogTitleBarTitleProps, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & React.RefAttributes<HTMLDivElement>>;
     };
     Content: React.ForwardRefExoticComponent<Pick<import("./DialogContent").DialogContentProps, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & React.RefAttributes<HTMLDivElement>>;