@itwin/itwinui-react 3.17.2 → 3.17.3

package/DEV-esm/styles.js

@@ -1,4 +1,4 @@
-const t = '3.17.2';
+const t = '3.17.3';
 const u = new Proxy(
   {},
   {

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

@@ -48,3 +48,13 @@ export type DropdownMenuProps = {
  * </DropdownMenu>
  */
 export declare const DropdownMenu: PolymorphicForwardRefComponent<"div", DropdownMenuProps>;
+export declare const DropdownMenuContext: React.Context<{
+    close: () => void;
+} | undefined>;
+/**
+ * @private
+ * Wraps around a `DropdownMenu`.
+ *
+ * If `true`, closes the `DropdownMenu` when any descendant `MenuItem` is clicked.
+ */
+export declare const DropdownMenuCloseOnClickContext: React.Context<boolean | undefined>;

package/cjs/core/DropdownMenu/DropdownMenu.js

@@ -2,11 +2,23 @@
 Object.defineProperty(exports, '__esModule', {
   value: true,
 });
-Object.defineProperty(exports, 'DropdownMenu', {
-  enumerable: true,
-  get: function () {
+function _export(target, all) {
+  for (var name in all)
+    Object.defineProperty(target, name, {
+      enumerable: true,
+      get: all[name],
+    });
+}
+_export(exports, {
+  DropdownMenu: function () {
     return DropdownMenu;
   },
+  DropdownMenuCloseOnClickContext: function () {
+    return DropdownMenuCloseOnClickContext;
+  },
+  DropdownMenuContext: function () {
+    return DropdownMenuContext;
+  },
 });
 const _interop_require_wildcard = require('@swc/helpers/_/_interop_require_wildcard');
 const _react = /*#__PURE__*/ _interop_require_wildcard._(require('react'));
@@ -41,34 +53,50 @@ const DropdownMenuContent = _react.forwardRef((props, forwardedRef) => {
     visibleProp,
     onVisibleChange,
   );
+  let close = _react.useCallback(() => {
+    setVisible(false);
+  }, [setVisible]);
   let menuContent = _react.useMemo(() => {
-    if ('function' == typeof menuItems)
-      return menuItems(() => setVisible(false));
+    if ('function' == typeof menuItems) return menuItems(close);
     return menuItems;
-  }, [menuItems, setVisible]);
+  }, [close, menuItems]);
+  let dropdownMenuContextValue = _react.useMemo(
+    () => ({
+      close,
+    }),
+    [close],
+  );
   return _react.createElement(
-    _Menu.Menu,
+    DropdownMenuContext.Provider,
     {
-      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,
-          middleware,
-        }),
-        [matchWidth, middleware, placement, setVisible, visible],
-      ),
-      ...rest,
+      value: dropdownMenuContextValue,
     },
-    menuContent,
+    _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: _react.useMemo(
+          () => ({
+            placement,
+            matchWidth,
+            visible,
+            onVisibleChange: setVisible,
+            middleware,
+          }),
+          [matchWidth, middleware, placement, setVisible, visible],
+        ),
+        ...rest,
+      },
+      menuContent,
+    ),
   );
 });
+const DropdownMenuContext = _react.createContext(void 0);
+const DropdownMenuCloseOnClickContext = _react.createContext(void 0);

package/cjs/core/Menu/Menu.d.ts

@@ -28,7 +28,12 @@ type MenuProps = {
             listNavigation?: Partial<UseListNavigationProps>;
         };
     };
-} & Pick<PortalProps, 'portal'>;
+    /**
+     * If not passed, uses the `portal` from its parent `Menu`.
+     * @see {@link PortalProps.portal} for docs on the prop.
+     */
+    portal?: PortalProps['portal'];
+};
 /**
  * @private
  *
@@ -92,4 +97,7 @@ export declare const MenuContext: React.Context<{
     popoverGetItemProps: PopoverGetItemProps;
     focusableElements: HTMLElement[];
 } | undefined>;
+export declare const MenuPortalContext: React.Context<boolean | {
+    to: HTMLElement | null | undefined | (() => HTMLElement | null | undefined);
+} | undefined>;
 export {};

package/cjs/core/Menu/Menu.js

@@ -16,6 +16,9 @@ _export(exports, {
   MenuContext: function () {
     return MenuContext;
   },
+  MenuPortalContext: function () {
+    return MenuPortalContext;
+  },
 });
 const _interop_require_default = require('@swc/helpers/_/_interop_require_default');
 const _interop_require_wildcard = require('@swc/helpers/_/_interop_require_wildcard');
@@ -31,11 +34,13 @@ const Menu = _react.forwardRef((props, ref) => {
     className,
     trigger,
     positionReference,
-    portal = true,
+    portal: portalProp,
     popoverProps: popoverPropsProp,
     children,
     ...rest
   } = props;
+  let menuPortalContext = _react.useContext(MenuPortalContext);
+  let portal = portalProp ?? menuPortalContext;
   let tree = (0, _react1.useFloatingTree)();
   let nodeId = (0, _react1.useFloatingNodeId)();
   let parentId = (0, _react1.useFloatingParentNodeId)();
@@ -134,35 +139,39 @@ const Menu = _react.forwardRef((props, ref) => {
     () => void 0,
     () => void 0,
   );
-  let popoverGetItemProps = ({ focusableItemIndex, userProps }) =>
-    getItemProps({
-      ...userProps,
-      tabIndex:
-        null != activeIndex &&
-        activeIndex >= 0 &&
-        null != focusableItemIndex &&
-        focusableItemIndex >= 0 &&
-        activeIndex === focusableItemIndex
-          ? 0
-          : -1,
-      onFocus: (0, _index.mergeEventHandlers)(userProps?.onFocus, () => {
-        queueMicrotask(() => {
-          setHasFocusedNodeInSubmenu(true);
-        });
-        tree?.events.emit('onNodeFocused', {
-          nodeId: nodeId,
-          parentId: parentId,
-        });
+  let popoverGetItemProps = _react.useCallback(
+    ({ focusableItemIndex, userProps }) =>
+      getItemProps({
+        ...userProps,
+        tabIndex:
+          null != activeIndex &&
+          activeIndex >= 0 &&
+          null != focusableItemIndex &&
+          focusableItemIndex >= 0 &&
+          activeIndex === focusableItemIndex
+            ? 0
+            : -1,
+        onFocus: (0, _index.mergeEventHandlers)(userProps?.onFocus, () => {
+          queueMicrotask(() => {
+            setHasFocusedNodeInSubmenu(true);
+          });
+          tree?.events.emit('onNodeFocused', {
+            nodeId: nodeId,
+            parentId: parentId,
+          });
+        }),
+        onMouseEnter: (0, _index.mergeEventHandlers)(
+          userProps?.onMouseEnter,
+          (event) => {
+            if (null != focusableItemIndex && focusableItemIndex >= 0)
+              setActiveIndex(focusableItemIndex);
+            if (event.target === event.currentTarget)
+              event.currentTarget.focus();
+          },
+        ),
       }),
-      onMouseEnter: (0, _index.mergeEventHandlers)(
-        userProps?.onMouseEnter,
-        (event) => {
-          if (null != focusableItemIndex && focusableItemIndex >= 0)
-            setActiveIndex(focusableItemIndex);
-          if (event.target === event.currentTarget) event.currentTarget.focus();
-        },
-      ),
-    });
+    [activeIndex, getItemProps, nodeId, parentId, tree?.events],
+  );
   let reference = (0, _index.cloneElementWithRef)(trigger, (triggerChild) =>
     getReferenceProps(
       popover.getReferenceProps({
@@ -201,28 +210,38 @@ const Menu = _react.forwardRef((props, ref) => {
     _react.createElement(
       MenuContext.Provider,
       {
-        value: {
-          popoverGetItemProps,
-          focusableElements,
-        },
+        value: _react.useMemo(
+          () => ({
+            popoverGetItemProps,
+            focusableElements,
+          }),
+          [focusableElements, popoverGetItemProps],
+        ),
       },
       _react.createElement(
-        _Popover.PopoverOpenContext.Provider,
+        MenuPortalContext.Provider,
         {
-          value: popover.open,
+          value: portal,
         },
-        reference,
+        _react.createElement(
+          _Popover.PopoverOpenContext.Provider,
+          {
+            value: popover.open,
+          },
+          reference,
+        ),
+        null != tree
+          ? _react.createElement(
+              _react1.FloatingNode,
+              {
+                id: nodeId,
+              },
+              floating,
+            )
+          : floating,
       ),
-      null != tree
-        ? _react.createElement(
-            _react1.FloatingNode,
-            {
-              id: nodeId,
-            },
-            floating,
-          )
-        : floating,
     ),
   );
 });
 const MenuContext = _react.createContext(void 0);
+const MenuPortalContext = _react.createContext(void 0);

package/cjs/core/Menu/MenuItem.js

@@ -17,6 +17,7 @@ const _ListItem = require('../List/ListItem.js');
 const _classnames = /*#__PURE__*/ _interop_require_default._(
   require('classnames'),
 );
+const _DropdownMenu = require('../DropdownMenu/DropdownMenu.js');
 const MenuItem = _react.forwardRef((props, forwardedRef) => {
   let {
     className,
@@ -37,6 +38,10 @@ const MenuItem = _react.forwardRef((props, forwardedRef) => {
   } = props;
   let logWarning = (0, _index.useWarningLogger)();
   let parentMenu = _react.useContext(_Menu.MenuContext);
+  let dropdownMenu = _react.useContext(_DropdownMenu.DropdownMenuContext);
+  let shouldCloseMenuOnClick = _react.useContext(
+    _DropdownMenu.DropdownMenuCloseOnClickContext,
+  );
   let menuItemRef = _react.useRef(null);
   let submenuId = (0, _index.useId)();
   let popoverProps = _react.useMemo(
@@ -55,6 +60,7 @@ const MenuItem = _react.forwardRef((props, forwardedRef) => {
   );
   let onClick = () => {
     if (disabled) return;
+    if (shouldCloseMenuOnClick) dropdownMenu?.close();
     onClickProp?.(value);
   };
   let handlers = {

package/cjs/core/Tile/Tile.js

@@ -196,41 +196,39 @@ const TileMoreOptions = _react.forwardRef((props, forwardedRef) => {
   let { className, children = [], buttonProps, ...rest } = props;
   let [isMenuVisible, setIsMenuVisible] = _react.useState(false);
   return _react.createElement(
-    _index.Box,
+    _DropdownMenu.DropdownMenuCloseOnClickContext.Provider,
     {
-      className: (0, _classnames.default)(
-        'iui-tile-more-options',
-        {
-          'iui-visible': isMenuVisible,
-        },
-        className,
-      ),
-      ref: forwardedRef,
-      ...rest,
+      value: true,
     },
     _react.createElement(
-      _DropdownMenu.DropdownMenu,
+      _index.Box,
       {
-        onVisibleChange: setIsMenuVisible,
-        menuItems: (close) =>
-          children?.map((option) =>
-            _react.cloneElement(option, {
-              onClick: (value) => {
-                close();
-                option.props.onClick?.(value);
-              },
-            }),
-          ),
+        className: (0, _classnames.default)(
+          'iui-tile-more-options',
+          {
+            'iui-visible': isMenuVisible,
+          },
+          className,
+        ),
+        ref: forwardedRef,
+        ...rest,
       },
       _react.createElement(
-        _IconButton.IconButton,
+        _DropdownMenu.DropdownMenu,
         {
-          styleType: 'borderless',
-          size: 'small',
-          'aria-label': 'More options',
-          ...buttonProps,
+          onVisibleChange: setIsMenuVisible,
+          menuItems: children,
         },
-        _react.createElement(_index.SvgMore, null),
+        _react.createElement(
+          _IconButton.IconButton,
+          {
+            styleType: 'borderless',
+            size: 'small',
+            'aria-label': 'More options',
+            ...buttonProps,
+          },
+          _react.createElement(_index.SvgMore, null),
+        ),
       ),
     ),
   );

package/cjs/styles.js

@@ -1,6 +1,6 @@
 'use strict';
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const e = '3.17.2';
+const e = '3.17.3';
 const u = new Proxy(
   {},
   {

package/esm/core/DropdownMenu/DropdownMenu.d.ts

@@ -48,3 +48,13 @@ export type DropdownMenuProps = {
  * </DropdownMenu>
  */
 export declare const DropdownMenu: PolymorphicForwardRefComponent<"div", DropdownMenuProps>;
+export declare const DropdownMenuContext: React.Context<{
+    close: () => void;
+} | undefined>;
+/**
+ * @private
+ * Wraps around a `DropdownMenu`.
+ *
+ * If `true`, closes the `DropdownMenu` when any descendant `MenuItem` is clicked.
+ */
+export declare const DropdownMenuCloseOnClickContext: React.Context<boolean | undefined>;

package/esm/core/DropdownMenu/DropdownMenu.js

@@ -30,34 +30,50 @@ let DropdownMenuContent = React.forwardRef((props, forwardedRef) => {
     visibleProp,
     onVisibleChange,
   );
+  let close = React.useCallback(() => {
+    setVisible(false);
+  }, [setVisible]);
   let menuContent = React.useMemo(() => {
-    if ('function' == typeof menuItems)
-      return menuItems(() => setVisible(false));
+    if ('function' == typeof menuItems) return menuItems(close);
     return menuItems;
-  }, [menuItems, setVisible]);
+  }, [close, menuItems]);
+  let dropdownMenuContextValue = React.useMemo(
+    () => ({
+      close,
+    }),
+    [close],
+  );
   return React.createElement(
-    Menu,
+    DropdownMenuContext.Provider,
     {
-      trigger: children,
-      onKeyDown: 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,
-          middleware,
-        }),
-        [matchWidth, middleware, placement, setVisible, visible],
-      ),
-      ...rest,
+      value: dropdownMenuContextValue,
     },
-    menuContent,
+    React.createElement(
+      Menu,
+      {
+        trigger: children,
+        onKeyDown: 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,
+            middleware,
+          }),
+          [matchWidth, middleware, placement, setVisible, visible],
+        ),
+        ...rest,
+      },
+      menuContent,
+    ),
   );
 });
+export const DropdownMenuContext = React.createContext(void 0);
+export const DropdownMenuCloseOnClickContext = React.createContext(void 0);

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

@@ -28,7 +28,12 @@ type MenuProps = {
             listNavigation?: Partial<UseListNavigationProps>;
         };
     };
-} & Pick<PortalProps, 'portal'>;
+    /**
+     * If not passed, uses the `portal` from its parent `Menu`.
+     * @see {@link PortalProps.portal} for docs on the prop.
+     */
+    portal?: PortalProps['portal'];
+};
 /**
  * @private
  *
@@ -92,4 +97,7 @@ export declare const MenuContext: React.Context<{
     popoverGetItemProps: PopoverGetItemProps;
     focusableElements: HTMLElement[];
 } | undefined>;
+export declare const MenuPortalContext: React.Context<boolean | {
+    to: HTMLElement | null | undefined | (() => HTMLElement | null | undefined);
+} | undefined>;
 export {};

package/esm/core/Menu/Menu.js

@@ -25,11 +25,13 @@ export const Menu = React.forwardRef((props, ref) => {
     className,
     trigger,
     positionReference,
-    portal = true,
+    portal: portalProp,
     popoverProps: popoverPropsProp,
     children,
     ...rest
   } = props;
+  let menuPortalContext = React.useContext(MenuPortalContext);
+  let portal = portalProp ?? menuPortalContext;
   let tree = useFloatingTree();
   let nodeId = useFloatingNodeId();
   let parentId = useFloatingParentNodeId();
@@ -125,32 +127,35 @@ export const Menu = React.forwardRef((props, ref) => {
     () => void 0,
     () => void 0,
   );
-  let popoverGetItemProps = ({ focusableItemIndex, userProps }) =>
-    getItemProps({
-      ...userProps,
-      tabIndex:
-        null != activeIndex &&
-        activeIndex >= 0 &&
-        null != focusableItemIndex &&
-        focusableItemIndex >= 0 &&
-        activeIndex === focusableItemIndex
-          ? 0
-          : -1,
-      onFocus: mergeEventHandlers(userProps?.onFocus, () => {
-        queueMicrotask(() => {
-          setHasFocusedNodeInSubmenu(true);
-        });
-        tree?.events.emit('onNodeFocused', {
-          nodeId: nodeId,
-          parentId: parentId,
-        });
+  let popoverGetItemProps = React.useCallback(
+    ({ focusableItemIndex, userProps }) =>
+      getItemProps({
+        ...userProps,
+        tabIndex:
+          null != activeIndex &&
+          activeIndex >= 0 &&
+          null != focusableItemIndex &&
+          focusableItemIndex >= 0 &&
+          activeIndex === focusableItemIndex
+            ? 0
+            : -1,
+        onFocus: mergeEventHandlers(userProps?.onFocus, () => {
+          queueMicrotask(() => {
+            setHasFocusedNodeInSubmenu(true);
+          });
+          tree?.events.emit('onNodeFocused', {
+            nodeId: nodeId,
+            parentId: parentId,
+          });
+        }),
+        onMouseEnter: mergeEventHandlers(userProps?.onMouseEnter, (event) => {
+          if (null != focusableItemIndex && focusableItemIndex >= 0)
+            setActiveIndex(focusableItemIndex);
+          if (event.target === event.currentTarget) event.currentTarget.focus();
+        }),
       }),
-      onMouseEnter: mergeEventHandlers(userProps?.onMouseEnter, (event) => {
-        if (null != focusableItemIndex && focusableItemIndex >= 0)
-          setActiveIndex(focusableItemIndex);
-        if (event.target === event.currentTarget) event.currentTarget.focus();
-      }),
-    });
+    [activeIndex, getItemProps, nodeId, parentId, tree?.events],
+  );
   let reference = cloneElementWithRef(trigger, (triggerChild) =>
     getReferenceProps(
       popover.getReferenceProps({
@@ -189,28 +194,38 @@ export const Menu = React.forwardRef((props, ref) => {
     React.createElement(
       MenuContext.Provider,
       {
-        value: {
-          popoverGetItemProps,
-          focusableElements,
-        },
+        value: React.useMemo(
+          () => ({
+            popoverGetItemProps,
+            focusableElements,
+          }),
+          [focusableElements, popoverGetItemProps],
+        ),
       },
       React.createElement(
-        PopoverOpenContext.Provider,
+        MenuPortalContext.Provider,
         {
-          value: popover.open,
+          value: portal,
         },
-        reference,
+        React.createElement(
+          PopoverOpenContext.Provider,
+          {
+            value: popover.open,
+          },
+          reference,
+        ),
+        null != tree
+          ? React.createElement(
+              FloatingNode,
+              {
+                id: nodeId,
+              },
+              floating,
+            )
+          : floating,
       ),
-      null != tree
-        ? React.createElement(
-            FloatingNode,
-            {
-              id: nodeId,
-            },
-            floating,
-          )
-        : floating,
     ),
   );
 });
 export const MenuContext = React.createContext(void 0);
+export const MenuPortalContext = React.createContext(void 0);

package/esm/core/Menu/MenuItem.js

@@ -8,6 +8,10 @@ import {
 import { Menu, MenuContext } from './Menu.js';
 import { ListItem } from '../List/ListItem.js';
 import cx from 'classnames';
+import {
+  DropdownMenuCloseOnClickContext,
+  DropdownMenuContext,
+} from '../DropdownMenu/DropdownMenu.js';
 export const MenuItem = React.forwardRef((props, forwardedRef) => {
   let {
     className,
@@ -28,6 +32,10 @@ export const MenuItem = React.forwardRef((props, forwardedRef) => {
   } = props;
   let logWarning = useWarningLogger();
   let parentMenu = React.useContext(MenuContext);
+  let dropdownMenu = React.useContext(DropdownMenuContext);
+  let shouldCloseMenuOnClick = React.useContext(
+    DropdownMenuCloseOnClickContext,
+  );
   let menuItemRef = React.useRef(null);
   let submenuId = useId();
   let popoverProps = React.useMemo(
@@ -46,6 +54,7 @@ export const MenuItem = React.forwardRef((props, forwardedRef) => {
   );
   let onClick = () => {
     if (disabled) return;
+    if (shouldCloseMenuOnClick) dropdownMenu?.close();
     onClickProp?.(value);
   };
   let handlers = {