@itwin/itwinui-react 3.14.2 → 3.15.0

package/DEV-esm/utils/components/ShadowRoot.js

@@ -50,6 +50,19 @@ function useShadowRoot(templateRef, { css = '' }) {
   let styleSheet = React.useRef();
   let latestCss = useLatestRef(css);
   let latestShadowRoot = useLatestRef(shadowRoot);
+  let createStyleSheet = React.useCallback(
+    (shadow) => {
+      if (shadow && supportsAdoptedStylesheets) {
+        let currentWindow = shadow.ownerDocument.defaultView || globalThis;
+        if (styleSheet.current instanceof currentWindow.CSSStyleSheet) return;
+        styleSheet.current = new currentWindow.CSSStyleSheet();
+        shadow.adoptedStyleSheets.push(styleSheet.current);
+        if (latestCss.current)
+          styleSheet.current.replaceSync(latestCss.current);
+      }
+    },
+    [latestCss],
+  );
   useLayoutEffect(() => {
     let parent = templateRef.current?.parentElement;
     if (!parent) return;
@@ -61,22 +74,23 @@ function useShadowRoot(templateRef, { css = '' }) {
         parent.attachShadow({
           mode: 'open',
         });
-      if (supportsAdoptedStylesheets) {
-        let currentWindow = shadow.ownerDocument.defaultView || globalThis;
-        styleSheet.current = new currentWindow.CSSStyleSheet();
-        shadow.adoptedStyleSheets = [styleSheet.current];
-        if (latestCss.current)
-          styleSheet.current.replaceSync(latestCss.current);
-      }
+      createStyleSheet(shadow);
       ReactDOM.flushSync(() => setShadowRoot(shadow));
     };
     queueMicrotask(() => {
       setupOrReuseShadowRoot();
     });
     return () => void setShadowRoot(null);
-  }, [templateRef, latestCss, latestShadowRoot]);
+  }, [templateRef, createStyleSheet, latestShadowRoot]);
   useLayoutEffect(() => {
     if (css && supportsAdoptedStylesheets) styleSheet.current?.replaceSync(css);
   }, [css]);
+  React.useEffect(() => {
+    let listener = () => createStyleSheet(latestShadowRoot.current);
+    window.addEventListener('appui:reparent', listener);
+    return () => {
+      window.removeEventListener('appui:reparent', listener);
+    };
+  }, [createStyleSheet, latestShadowRoot]);
   return shadowRoot;
 }

package/DEV-esm/utils/hooks/useWarningLogger.js

@@ -1,18 +1,19 @@
 import * as React from 'react';
 import { isUnitTest } from '../functions/dev.js';
+import { getWindow } from '../functions/dom.js';
 let _React = React;
 let ReactInternals = _React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
 export const useWarningLogger = isUnitTest
   ? () => () => {}
   : function () {
       let loggedRef = React.useRef(false);
-      let timeoutRef = React.useRef(null);
+      let timeoutRef = React.useRef(void 0);
       let stack = ReactInternals?.ReactDebugCurrentFrame?.getCurrentStack?.();
       let componentName = stack?.trim().split('\n')[1]?.trim();
       let prefix = componentName ? `Warning (${componentName}):` : 'Warning:';
       let logWarning = React.useCallback(
         (message) => {
-          timeoutRef.current = window.setTimeout(() => {
+          timeoutRef.current = getWindow()?.setTimeout(() => {
             if (!loggedRef.current) {
               console.error(prefix, message);
               loggedRef.current = true;
@@ -23,7 +24,7 @@ export const useWarningLogger = isUnitTest
       );
       React.useEffect(
         () => () => {
-          if (timeoutRef.current) window.clearTimeout(timeoutRef.current);
+          if (timeoutRef.current) getWindow()?.clearTimeout(timeoutRef.current);
         },
         [],
       );

package/cjs/core/Buttons/SplitButton.d.ts

@@ -3,6 +3,7 @@ import type { ButtonProps } from './Button.js';
 import { IconButton } from './IconButton.js';
 import type { PolymorphicForwardRefComponent, PortalProps } from '../../utils/index.js';
 import type { Placement } from '@floating-ui/react';
+import type { usePopover } from '../Popover/Popover.js';
 export type SplitButtonProps = ButtonProps & {
     /**
      * Items in the dropdown menu.
@@ -27,6 +28,10 @@ export type SplitButtonProps = ButtonProps & {
      * Passes props to SplitButton menu button.
      */
     menuButtonProps?: Omit<React.ComponentProps<typeof IconButton>, 'label' | 'size'>;
+    /**
+     * Props to customize menu behavior.
+     */
+    dropdownMenuProps?: Pick<Parameters<typeof usePopover>[0], 'middleware'>;
 } & Pick<PortalProps, 'portal'>;
 /**
  * Split button component with a DropdownMenu.

package/cjs/core/Carousel/CarouselDotsList.js

@@ -104,18 +104,25 @@ const CarouselDotsList = _react.forwardRef((props, ref) => {
       handleSlideChange,
     ],
   );
+  let motionOk = (0, _index.useMediaQuery)(
+    '(prefers-reduced-motion: no-preference)',
+  );
   _react.useEffect(() => {
     let firstDot = listRef.current?.children[firstVisibleDotIndex];
     if (!listRef.current || !firstDot) return;
-    let motionOk = (0, _index.getWindow)()?.matchMedia(
-      '(prefers-reduced-motion: no-preference)',
-    )?.matches;
     listRef.current.scrollTo({
       left: firstDot.offsetLeft - listRef.current.offsetLeft,
       behavior: motionOk && !justMounted.current ? 'smooth' : 'auto',
     });
     if (justMounted.current) justMounted.current = false;
-  }, [currentIndex, firstVisibleDotIndex, slideCount, visibleCount, width]);
+  }, [
+    currentIndex,
+    firstVisibleDotIndex,
+    motionOk,
+    slideCount,
+    visibleCount,
+    width,
+  ]);
   let handleKeyDown = (event) => {
     if (event.altKey || event.ctrlKey || event.metaKey || event.shiftKey)
       return;

package/cjs/core/Carousel/CarouselSlider.js

@@ -37,13 +37,13 @@ const CarouselSlider = _react.forwardRef((props, ref) => {
   }, [items.length, setSlideCount]);
   let sliderRef = _react.useRef(null);
   let refs = (0, _index.useMergedRefs)(sliderRef, ref);
+  let motionOk = (0, _index.useMediaQuery)(
+    '(prefers-reduced-motion: no-preference)',
+  );
   scrollToSlide.current = (slideIndex, { instant } = {}) => {
     isManuallyUpdating.current = true;
     let slideToShow = sliderRef.current?.children.item(slideIndex);
     if (!sliderRef.current || !slideToShow) return;
-    let motionOk = (0, _index.getWindow)()?.matchMedia(
-      '(prefers-reduced-motion: no-preference)',
-    )?.matches;
     sliderRef.current.scrollTo({
       left: slideToShow.offsetLeft - sliderRef.current.offsetLeft,
       behavior: instant || !motionOk ? 'instant' : 'smooth',

package/cjs/core/ColorPicker/ColorBuilder.d.ts

@@ -1,7 +1,28 @@
+import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../../utils/index.js';
+import { Slider } from '../Slider/Slider.js';
+type ColorBuilderProps = {
+    /**
+     * Passes props to the color field.
+     */
+    colorFieldProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the color dot.
+     */
+    colorDotProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the color opacity slider.
+     */
+    opacitySliderProps?: React.ComponentProps<typeof Slider>;
+    /**
+     * Passes props to the color hue slider.
+     */
+    hueSliderProps?: React.ComponentProps<typeof Slider>;
+};
 /**
  * `ColorBuilder` consists of two parts:
  * a color canvas to adjust saturation and lightness values,
  * and a set of sliders to adjust hue and alpha values.
  */
-export declare const ColorBuilder: PolymorphicForwardRefComponent<"div">;
+export declare const ColorBuilder: PolymorphicForwardRefComponent<"div", ColorBuilderProps>;
+export {};

package/cjs/core/ColorPicker/ColorBuilder.js

@@ -24,7 +24,14 @@ const getHorizontalPercentageOfRectangle = (rect, pointer) => {
   return ((position - rect.left) / rect.width) * 100;
 };
 const ColorBuilder = _react.forwardRef((props, ref) => {
-  let { className, ...rest } = props;
+  let {
+    className,
+    colorFieldProps,
+    colorDotProps,
+    opacitySliderProps,
+    hueSliderProps,
+    ...rest
+  } = props;
   let builderRef = _react.useRef();
   let refs = (0, _index.useMergedRefs)(builderRef, ref);
   let {
@@ -215,54 +222,86 @@ const ColorBuilder = _react.forwardRef((props, ref) => {
     _react.createElement(
       _index.Box,
       {
-        className: 'iui-color-field',
+        as: 'div',
+        ...colorFieldProps,
+        className: (0, _classnames.default)(
+          'iui-color-field',
+          colorFieldProps?.className,
+        ),
         style: {
           '--iui-color-field-hue': hueColorString,
           '--iui-color-picker-selected-color': dotColorString,
+          ...colorFieldProps?.style,
         },
-        ref: squareRef,
-        onPointerDown: (event) => {
-          event.preventDefault();
-          updateSquareValue(event, 'onClick');
-          setColorDotActive(true);
-          colorDotRef.current?.focus();
-        },
+        ref: (0, _index.useMergedRefs)(squareRef, colorFieldProps?.ref),
+        onPointerDown: (0, _index.mergeEventHandlers)(
+          colorFieldProps?.onPointerDown,
+          (event) => {
+            event.preventDefault();
+            updateSquareValue(event, 'onClick');
+            setColorDotActive(true);
+            colorDotRef.current?.focus();
+          },
+        ),
       },
       _react.createElement(_index.Box, {
-        className: 'iui-color-dot',
+        as: 'div',
+        ...colorDotProps,
+        className: (0, _classnames.default)(
+          'iui-color-dot',
+          colorDotProps?.className,
+        ),
         style: {
           '--iui-color-dot-inset-block': `${squareTop.toString()}% auto`,
           '--iui-color-dot-inset-inline': `${squareLeft.toString()}% auto`,
+          ...colorDotProps?.style,
         },
-        onPointerDown: () => {
-          setColorDotActive(true);
-          colorDotRef.current?.focus();
-        },
-        onKeyDown: handleColorDotKeyDown,
-        onKeyUp: handleColorDotKeyUp,
+        onPointerDown: (0, _index.mergeEventHandlers)(
+          colorDotProps?.onPointerDown,
+          () => {
+            setColorDotActive(true);
+            colorDotRef.current?.focus();
+          },
+        ),
+        onKeyDown: (0, _index.mergeEventHandlers)(
+          colorDotProps?.onKeyDown,
+          handleColorDotKeyDown,
+        ),
+        onKeyUp: (0, _index.mergeEventHandlers)(
+          colorDotProps?.onKeyUp,
+          handleColorDotKeyUp,
+        ),
         tabIndex: 0,
-        ref: colorDotRef,
+        ref: (0, _index.useMergedRefs)(colorDotRef, colorDotProps?.ref),
       }),
     ),
     _react.createElement(_Slider.Slider, {
       minLabel: '',
       maxLabel: '',
       values: [sliderValue],
-      className: 'iui-hue-slider',
       trackDisplayMode: 'none',
+      min: 0,
+      max: 359,
+      ...hueSliderProps,
+      className: (0, _classnames.default)(
+        'iui-hue-slider',
+        hueSliderProps?.className,
+      ),
       tooltipProps: () => ({
         visible: false,
+        ...hueSliderProps?.tooltipProps,
       }),
       onChange: (values) => {
+        hueSliderProps?.onChange?.(values);
         updateHueSlider(values[0], true);
       },
       onUpdate: (values) => {
+        hueSliderProps?.onUpdate?.(values);
         updateHueSlider(values[0], false);
       },
-      min: 0,
-      max: 359,
       thumbProps: () => ({
         'aria-label': 'Hue',
+        ...hueSliderProps?.thumbProps,
       }),
     }),
     showAlpha &&
@@ -270,25 +309,34 @@ const ColorBuilder = _react.forwardRef((props, ref) => {
         minLabel: '',
         maxLabel: '',
         values: [alphaValue],
-        className: 'iui-opacity-slider',
         trackDisplayMode: 'none',
+        min: 0,
+        max: 1,
+        step: 0.01,
+        ...opacitySliderProps,
+        className: (0, _classnames.default)(
+          'iui-opacity-slider',
+          opacitySliderProps?.className,
+        ),
         tooltipProps: () => ({
           visible: false,
+          ...opacitySliderProps?.tooltipProps,
         }),
         onChange: (values) => {
+          opacitySliderProps?.onChange?.(values);
           updateOpacitySlider(values[0], true);
         },
         onUpdate: (values) => {
+          opacitySliderProps?.onUpdate?.(values);
           updateOpacitySlider(values[0], false);
         },
-        min: 0,
-        max: 1,
-        step: 0.01,
         style: {
           '--iui-color-picker-selected-color': hueColorString,
+          ...opacitySliderProps?.style,
         },
         thumbProps: () => ({
           'aria-label': 'Opacity',
+          ...opacitySliderProps?.thumbProps,
         }),
       }),
   );

package/cjs/core/ColorPicker/ColorInputPanel.d.ts

@@ -1,3 +1,5 @@
+import * as React from 'react';
+import { IconButton } from '../Buttons/IconButton.js';
 import type { PolymorphicForwardRefComponent } from '../../utils/index.js';
 type ColorInputPanelProps = {
     /**
@@ -12,6 +14,22 @@ type ColorInputPanelProps = {
      * @default ['hsl', 'rgb', 'hex']
      */
     allowedColorFormats?: ('hsl' | 'rgb' | 'hex')[];
+    /**
+     * Passes props to the color picker section label.
+     */
+    panelLabelProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the color input container.
+     */
+    colorInputContainerProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the color input fields group.
+     */
+    inputFieldsGroupProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the swap color format button.
+     */
+    swapColorFormatButtonProps?: React.ComponentProps<typeof IconButton>;
 };
 /**
  * `ColorInputPanel` shows input fields to enter precise color values in the specified format.

package/cjs/core/ColorPicker/ColorInputPanel.js

@@ -21,6 +21,10 @@ const ColorInputPanel = _react.forwardRef((props, ref) => {
     defaultColorFormat,
     allowedColorFormats = ['hsl', 'rgb', 'hex'],
     className,
+    colorInputContainerProps,
+    panelLabelProps,
+    inputFieldsGroupProps,
+    swapColorFormatButtonProps,
     ...rest
   } = props;
   let inputsContainerRef = _react.useRef(null);
@@ -364,10 +368,12 @@ const ColorInputPanel = _react.forwardRef((props, ref) => {
           Number(input[3]) < 0 || Number(input[3]) > 1 ? 'negative' : void 0,
       }),
   );
-  let labelId = (0, _index.useId)();
+  let fallbackLabelId = (0, _index.useId)();
+  let labelId = panelLabelProps?.id ?? fallbackLabelId;
   return _react.createElement(
     _index.Box,
     {
+      as: 'div',
       className: (0, _classnames.default)('iui-color-input-wrapper', className),
       ref: ref,
       ...rest,
@@ -375,7 +381,12 @@ const ColorInputPanel = _react.forwardRef((props, ref) => {
     _react.createElement(
       _index.Box,
       {
-        className: 'iui-color-picker-section-label',
+        as: 'div',
+        ...panelLabelProps,
+        className: (0, _classnames.default)(
+          'iui-color-picker-section-label',
+          panelLabelProps?.className,
+        ),
         id: labelId,
       },
       showAlpha && 'hex' !== currentFormat
@@ -385,26 +396,43 @@ const ColorInputPanel = _react.forwardRef((props, ref) => {
     _react.createElement(
       _index.Box,
       {
-        className: 'iui-color-input',
+        as: 'div',
+        ...colorInputContainerProps,
+        className: (0, _classnames.default)(
+          'iui-color-input',
+          colorInputContainerProps?.className,
+        ),
       },
       allowedColorFormats.length > 1 &&
         _react.createElement(
           _IconButton.IconButton,
           {
-            styleType: 'borderless',
-            onClick: swapColorFormat,
             size: 'small',
+            styleType: 'borderless',
             label: 'Switch format',
+            ...swapColorFormatButtonProps,
+            onClick: (0, _index.mergeEventHandlers)(
+              swapColorFormatButtonProps?.onClick,
+              swapColorFormat,
+            ),
           },
           _react.createElement(_index.SvgSwap, null),
         ),
       _react.createElement(
         _index.Box,
         {
-          ref: inputsContainerRef,
-          className: 'iui-color-input-fields',
+          as: 'div',
           role: 'hex' !== currentFormat ? 'group' : void 0,
           'aria-labelledby': 'hex' !== currentFormat ? labelId : void 0,
+          ...inputFieldsGroupProps,
+          ref: (0, _index.useMergedRefs)(
+            inputsContainerRef,
+            inputFieldsGroupProps?.ref,
+          ),
+          className: (0, _classnames.default)(
+            'iui-color-input-fields',
+            inputFieldsGroupProps?.className,
+          ),
         },
         'hex' === currentFormat && hexInputField,
         'rgb' === currentFormat && rgbInputs,

package/cjs/core/ColorPicker/ColorPalette.d.ts

@@ -6,6 +6,10 @@ export type ColorPaletteProps = {
      * Label shown above the palette.
      */
     label?: React.ReactNode;
+    /**
+     * Passes props to the color picker section label.
+     */
+    labelProps?: React.ComponentProps<'div'>;
     /**
      * List of colors shown as swatches in the palette.
      */
@@ -14,6 +18,10 @@ export type ColorPaletteProps = {
      * Pass any custom swatches as children.
      */
     children?: React.ReactNode;
+    /**
+     * Passes props to the color palette container.
+     */
+    paletteContainerProps?: React.ComponentProps<'div'>;
 };
 /**
  * `ColorPalette` is used to show a group of `ColorSwatch` components.

package/cjs/core/ColorPicker/ColorPalette.js

@@ -17,7 +17,15 @@ const _ColorPicker = require('./ColorPicker.js');
 const _ColorSwatch = require('./ColorSwatch.js');
 const _ColorPickerContext = require('./ColorPickerContext.js');
 const ColorPalette = _react.forwardRef((props, ref) => {
-  let { colors, label, className, children, ...rest } = props;
+  let {
+    colors,
+    label,
+    labelProps,
+    className,
+    children,
+    paletteContainerProps,
+    ...rest
+  } = props;
   let { activeColor, setActiveColor, onChangeComplete } = (0,
   _ColorPickerContext.useColorPickerContext)();
   return _react.createElement(
@@ -34,14 +42,24 @@ const ColorPalette = _react.forwardRef((props, ref) => {
       _react.createElement(
         _index.Box,
         {
-          className: 'iui-color-picker-section-label',
+          as: 'div',
+          ...labelProps,
+          className: (0, _classnames.default)(
+            'iui-color-picker-section-label',
+            labelProps?.className,
+          ),
         },
         label,
       ),
     _react.createElement(
       _index.Box,
       {
-        className: 'iui-color-palette',
+        as: 'div',
+        ...paletteContainerProps,
+        className: (0, _classnames.default)(
+          'iui-color-palette',
+          paletteContainerProps?.className,
+        ),
       },
       children,
       colors &&

package/cjs/core/ComboBox/ComboBox.d.ts

@@ -1,7 +1,8 @@
 import * as React from 'react';
 import type { SelectOption } from '../Select/Select.js';
 import type { Input } from '../Input/Input.js';
-import type { InputContainerProps, CommonProps } from '../../utils/index.js';
+import { usePopover } from '../Popover/Popover.js';
+import type { InputContainerProps, CommonProps, PortalProps } from '../../utils/index.js';
 import { ComboBoxEndIcon } from './ComboBoxEndIcon.js';
 type ActionType = 'added' | 'removed';
 type MultipleOnChangeProps<T> = {
@@ -59,7 +60,7 @@ export type ComboBoxProps<T> = {
     /**
      * Props to customize dropdown menu behavior.
      */
-    dropdownMenuProps?: React.ComponentProps<'div'>;
+    dropdownMenuProps?: React.ComponentProps<'div'> & Pick<Parameters<typeof usePopover>['0'], 'middleware'> & Pick<PortalProps, 'portal'>;
     /**
      * End icon props.
      */

package/cjs/core/ComboBox/ComboBox.js

@@ -42,7 +42,7 @@ const ComboBox = _react.forwardRef((props, forwardedRef) => {
     filterFunction = defaultFilterFunction,
     inputProps,
     endIconProps,
-    dropdownMenuProps,
+    dropdownMenuProps: { middleware, ...dropdownMenuProps } = {},
     emptyStateMessage = 'No options found',
     itemRenderer,
     enableVirtualization = false,
@@ -322,6 +322,7 @@ const ComboBox = _react.forwardRef((props, forwardedRef) => {
       size: {
         maxHeight: 'var(--iui-menu-max-height)',
       },
+      ...middleware,
     },
     closeOnOutsideClick: true,
     interactions: {

package/cjs/core/ComboBox/ComboBoxMenu.js

@@ -94,7 +94,7 @@ const VirtualizedComboBoxMenu = (props) => {
   );
 };
 const ComboBoxMenu = _react.forwardRef((props, forwardedRef) => {
-  let { className, children, style, ...rest } = props;
+  let { className, children, style, portal = true, ...rest } = props;
   let { id, enableVirtualization, popover } = (0, _index.useSafeContext)(
     _helpers.ComboBoxStateContext,
   );
@@ -109,7 +109,7 @@ const ComboBoxMenu = _react.forwardRef((props, forwardedRef) => {
     _react.createElement(
       _index.Portal,
       {
-        portal: true,
+        portal: portal,
       },
       _react.createElement(
         _List.List,

package/cjs/core/DropdownMenu/DropdownMenu.d.ts

@@ -16,6 +16,17 @@ export type DropdownMenuProps = {
      * Child element to wrap dropdown with.
      */
     children: React.ReactNode;
+    /**
+     * Middleware options.
+     *
+     * By default, `hide` is enabled. If the menu gets hidden even when it shouldn't (e.g. some custom styles interfering
+     * with the trigger's hide detection) consider disabling the `hide` middleware.
+     *
+     * @see https://floating-ui.com/docs/middleware
+     */
+    middleware?: {
+        hide?: boolean;
+    };
 } & Pick<Parameters<typeof usePopover>[0], 'visible' | 'onVisibleChange' | 'placement' | 'matchWidth'> & Pick<PortalProps, 'portal'>;
 /**
  * Dropdown menu component.

package/cjs/core/DropdownMenu/DropdownMenu.js

@@ -33,6 +33,7 @@ const DropdownMenuContent = _react.forwardRef((props, forwardedRef) => {
     matchWidth = false,
     onVisibleChange,
     portal = true,
+    middleware,
     ...rest
   } = props;
   let [visible, setVisible] = (0, _index.useControlledState)(
@@ -46,28 +47,28 @@ const DropdownMenuContent = _react.forwardRef((props, forwardedRef) => {
     return menuItems;
   }, [menuItems, setVisible]);
   return _react.createElement(
-    _react.Fragment,
-    null,
-    _react.createElement(
-      _Menu.Menu,
-      {
-        trigger: children,
-        onKeyDown: (0, _index.mergeEventHandlers)(props.onKeyDown, (e) => {
-          if (e.defaultPrevented) return;
-          if ('Tab' === e.key) setVisible(false);
-        }),
-        role: role,
-        ref: forwardedRef,
-        portal: portal,
-        popoverProps: {
+    _Menu.Menu,
+    {
+      trigger: children,
+      onKeyDown: (0, _index.mergeEventHandlers)(props.onKeyDown, (e) => {
+        if (e.defaultPrevented) return;
+        if ('Tab' === e.key) setVisible(false);
+      }),
+      role: role,
+      ref: forwardedRef,
+      portal: portal,
+      popoverProps: _react.useMemo(
+        () => ({
           placement,
           matchWidth,
           visible,
           onVisibleChange: setVisible,
-        },
-        ...rest,
-      },
-      menuContent,
-    ),
+          middleware,
+        }),
+        [matchWidth, middleware, placement, setVisible, visible],
+      ),
+      ...rest,
+    },
+    menuContent,
   );
 });