bm-core-ui 2.12.0-beta.5 → 2.12.0-beta.7

package/build/@types/index.d.ts

@@ -5846,6 +5846,14 @@ export class BMDragSession implements EventHandlerObject {
 	private _beginDrag(): void;
 
 
+	/**
+	 * Invoked when a key is pressed while this drag session is in progress.
+	 * @param event          The event.
+	 *     
+	 */
+	private _keyPressedWithEvent(event: KeyboardEvent): void;
+
+
 	/**
 	 * Invoked whenever the pointer moves while this drag session is in progress.
 	 * @param event        The event.
@@ -5856,11 +5864,11 @@ export class BMDragSession implements EventHandlerObject {
 
 	/**
 	 * Invoked when the pointer is released or cancelled while this drag session is in progress.
-	 * @param event       The event.
-	 * @return                       A promise that resolves when all associated animations finish.
+	 * @param event  The event.
+	 * @return                                   A promise that resolves when all associated animations finish.
 	 *     
 	 */
-	private _dragDidFinishWithEvent(event: MouseEvent | TouchEvent): Promise<void>;
+	private _dragDidFinishWithEvent(event: MouseEvent | TouchEvent | KeyboardEvent): Promise<void>;
 
 
 	/**
@@ -7036,6 +7044,13 @@ export class _BMDragIndicator {
  */
 export class _BMDragPreviewSet {
 
+	/**
+	 * The offset between the drag pointer and the center the from of the view from which the drag session
+	 * started, expressed in percentages relative to the view's frame.
+	 *     
+	 */
+	private _offsetPercent: BMPoint;
+
 	/**
 	 * The offset between the drag pointer and the center of the frames of the preview elements.
 	 *     
@@ -7082,7 +7097,8 @@ export class _BMDragPreviewSet {
 	 * Initializes this drag preview set with the specified item previews and offset position.
 	 * @param previews             The previews for items in the drag session.
 	 * @param pointerOffset               The offset between the drag pointer and the
-	 *                                              center of the frames of the preview elements.
+	 *                                              center of the frames of the view from which the
+	 *                                              drag session started.
 	 * @return                   This preview set.
 	 *     
 	 */
@@ -9975,6 +9991,13 @@ export class BMMenu {
 	 */
 	_delaysClosing: boolean;
 
+	/**
+	 * When set to `YES`, the menu item actions and item selection delegate callbacks will be invoked
+	 * with a slight delay to allow time for the menu closing animation to play.
+	 *     
+	 */
+	delaysActions: boolean;
+
 	/**
 	 * Initializes this menu with the specified items.
 	 * The menu will be hidden by default; the method showAtPoint(_) should be used to make the menu visible.
@@ -10011,6 +10034,20 @@ export class BMMenu {
 	private _renderMenuItems(): void;
 
 
+	/**
+	 * Temporarily set to the menu item that was selected until its action is performed.
+	 *     
+	 */
+	private _selectedMenuItem?: BMMenuItem | null | undefined;
+
+	/**
+	 * Performs the action for the specified menu item and invokes the delegate selection callback for it.
+	 * @param item          The menu item whose action should be performed.
+	 *     
+	 */
+	private _performActionForMenuItem(item: BMMenuItem): void;
+
+
 	/**
 	 * The kind of menu currently displayed.
 	 *     
@@ -10133,7 +10170,7 @@ export class BMMenu {
 	 * @param forKeyboardShortcut      The keyboard shortcut that was triggered.
 	 *     
 	 */
-	private _selectMenuItemWithEvent(event: KeyboardEvent, {forKeyboardShortcut}: {forKeyboardShortcut: BMKeyboardShortcut}): void;
+	protected _selectMenuItemWithEvent(event: KeyboardEvent, {forKeyboardShortcut}: {forKeyboardShortcut: BMKeyboardShortcut}): void;
 
 
 	/**

package/build/BMCoreUI.css

@@ -1524,21 +1524,8 @@ input:not(:checked) + .BMWindowSwitchGutter > .BMWindowSwitchKnob, .BMWindowSwit
 }
 
 .BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem {
-	height: 44px;
-	line-height: 44px;
-	border-top: 1px solid rgba(0, 0, 0, .1);
-}
-
-.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:first-child {
-	border-top-width: 0px;
-}
-
-.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemHighlighted + .BMMenuItem {
-	border-top-color: rgba(0, 0, 0, .2);
-}
-
-.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemHighlighted + .BMMenuDivider {
-	box-shadow: 0px 1px 0px 0px rgba(0, 0, 0, .1) inset;
+	height: 38px;
+	line-height: 38px;
 }
 
 .BMMenuIcon {
@@ -1596,48 +1583,104 @@ input:not(:checked) + .BMWindowSwitchGutter > .BMWindowSwitchKnob, .BMWindowSwit
 
 @keyframes BMMenuItemActiveAnimation {
 	from {
-		background: transparent;
 		color: rgba(0, 0, 0, .8);
 	}
 
 	49% {
-		background: transparent;
 		color: rgba(0, 0, 0, .8);
 	}
 
 	50% {
-		background: rgb(0, 128, 255);
 		color: white;
 	}
 
 	to {
-		background: rgb(0, 128, 255);
 		color: white;
 	}
 }
 
-.BMLayoutEditorConstraintPopupOption:hover, .BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):active, .BMMenuItem.BMMenuItemHighlighted {
-	background: rgb(0, 128, 255);
+@keyframes BMMenuItemActiveAnimationBackground {
+	from {
+		background: transparent;
+	}
+
+	49% {
+		background: transparent;
+	}
+
+	50% {
+		background: rgb(0, 128, 255);
+	}
+
+	to {
+		background: rgb(0, 128, 255);
+	}
+}
+
+.BMLayoutEditorConstraintPopupOption::before,
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem::before,
+.BMMenuItem::before {
+	content: '';
+
+	position: absolute;
+
+	top: 0;
+	bottom: 0;
+
+	left: 4px;
+	right: 4px;
+
+	border-radius: 5px;
+
+	z-index: -1;
+}
+
+.BMLayoutEditorConstraintPopupOption:hover,
+.BMMenuItem.BMMenuItemHighlighted {
 	color: white;
 }
 
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemHighlighted,
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):active {
+	color: rgba(0, 0, 0, .8);
+}
+
+.BMLayoutEditorConstraintPopupOption:hover::before,
+.BMMenuItem.BMMenuItemHighlighted::before {
+	background: rgb(0, 128, 255);
+}
+
 .BMMenuSourceNodeShadow.BMMenuItem.BMMenuItemHighlighted {
 	background: white;
 	color: rgba(0, 0, 0, .8);
 }
 
-.BMLayoutEditorConstraintPopupOption:active, .BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):hover {
+.BMLayoutEditorConstraintPopupOption:active,
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):hover {
 	background: transparent;
 	color: rgba(0, 0, 0, .8);
 }
 
+.BMLayoutEditorConstraintPopupOption:active::before,
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemHighlighted::before,
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):hover::before,
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):active::before {
+	background: transparent;
+}
+
+
 .BMMenuItem.BMMenuItemActive {
 	animation: .15s linear BMMenuItemActiveAnimation;
 	animation-fill-mode: both;
 }
 
-.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemActive,
-.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemHighlighted {
+.BMMenuItem.BMMenuItemActive::before {
+	animation: .15s linear BMMenuItemActiveAnimationBackground;
+	animation-fill-mode: both;
+}
+
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemActive::before,
+.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemHighlighted::before {
 	animation: none;
 	background: transparent;
 	color: rgba(0, 0, 0, .8);
@@ -1646,7 +1689,8 @@ input:not(:checked) + .BMWindowSwitchGutter > .BMWindowSwitchKnob, .BMWindowSwit
 	-webkit-backdrop-filter: brightness(80%);
 }
 
-.BMLayoutEditorConstraintPopupOptionHighlighted, .BMMenuItemHighlighted {
+.BMLayoutEditorConstraintPopupOptionHighlighted::before,
+.BMMenuItemHighlighted::before {
 	background: rgba(0, 128, 255, .5);
 }
 
@@ -1659,46 +1703,46 @@ input:not(:checked) + .BMWindowSwitchGutter > .BMWindowSwitchKnob, .BMWindowSwit
 		color: rgba(255, 255, 255, .45);
 	}
 
-	.BMLayoutEditorConstraintPopupOption:active, .BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):hover {
+	.BMLayoutEditorConstraintPopupOption:active,
+	.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):hover,
+	.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem:not(.BMMenuItemDisabled):active {
 		background: transparent;
 		color: white;
 	}
 
-	.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem {
-		border-bottom-color: rgba(255, 255, 255, .1);
-	}
-
 	.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemActive,
 	.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemHighlighted {
 		color: rgba(255, 255, 255, 1);
-	
+	}
+
+	.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemActive::before,
+	.BMMenuTouch > .BMMenuItemsContainer > .BMMenuItem.BMMenuItemHighlighted::before {
 		backdrop-filter: brightness(110%);
 		-webkit-backdrop-filter: brightness(110%);
 	}
 
 	.BMMenuSourceNodeShadow.BMMenuItem.BMMenuItemHighlighted {
-		background: rgba(33, 33, 33, 1);
 		color: rgba(255, 255, 255, .9);
 	}
 
+	.BMMenuSourceNodeShadow.BMMenuItem.BMMenuItemHighlighted::before {
+		background: rgba(33, 33, 33, 1);
+	}
+
 	@keyframes BMMenuItemActiveAnimation {
 		from {
-			background: transparent;
 			color: rgba(255, 255, 255, .9);
 		}
 	
 		49% {
-			background: transparent;
 			color: rgba(255, 255, 255, .9);
 		}
 	
 		50% {
-			background: rgb(0, 128, 255);
 			color: white;
 		}
 	
 		to {
-			background: rgb(0, 128, 255);
 			color: white;
 		}
 	}
@@ -1834,12 +1878,6 @@ input:not(:checked) + .BMWindowSwitchGutter > .BMWindowSwitchKnob, .BMWindowSwit
 	flex-shrink: 0;
 }
 
-.BMMenuTouch > .BMMenuItemsContainer > .BMMenuDivider {
-	margin: 0;
-	height: 3px;
-	background: rgba(0, 0, 0, .1);
-}
-
 .BMLayoutEditorDetailsDividerCell {
 	background: rgba(0, 0, 0, .05);
 }

package/build/BMView/BMDragSession.js

@@ -435,7 +435,10 @@ BMDragSession.prototype = {
         if (firstItemPreview._sourceNode) {
             const sourceNodeFrame = BMRectMakeWithNodeFrame(firstItemPreview._sourceNode);
             const center = sourceNodeFrame.center;
-            pointerOffset = BMPointMake(center.x - this._position.x, center.y - this._position.y);
+            pointerOffset = BMPointMake(
+                (center.x - this._position.x) / sourceNodeFrame.size.width,
+                (center.y - this._position.y) / sourceNodeFrame.size.height,
+            );
         }
 
         // Obtain the drag previews for the remaining items
@@ -468,10 +471,16 @@ BMDragSession.prototype = {
         if (this._touchIdentifier !== undefined) {
             window.addEventListener('touchcancel', this, {capture: YES, passive: NO});
         }
+
+        // Register a key press event that will cancel the drag when escape is pressed
+        window.addEventListener('keydown', this, {capture: YES, passive: NO});
     },
 
-    handleEvent(/** @type {MouseEvent | TouchEvent} */ event) {
-        if (event.type == 'mousemove' || event.type == 'touchmove') {
+    handleEvent(/** @type {MouseEvent | TouchEvent | KeyboardEvent} */ event) {
+        if (event.type == 'keydown') {
+            this._keyPressedWithEvent(event);
+        }
+        else if (event.type == 'mousemove' || event.type == 'touchmove') {
             this._dragDidMoveWithEvent(event);
         }
         else {
@@ -479,6 +488,26 @@ BMDragSession.prototype = {
         }
     },
 
+    /**
+     * Invoked when a key is pressed while this drag session is in progress.
+     * @param event <KeyboardEvent>         The event.
+     */
+    _keyPressedWithEvent(event) {
+        // Cancel the drag session when pressing escape or command + .
+        if (event.code != 'Escape' && (event.code != 'Period' || !event.metaKey)) {
+            return;
+        }
+
+        // Clear any drop target, set the drop action to ignore and immediately finish the session
+        event.stopPropagation();
+        event.preventDefault();
+        this._setDropTarget(undefined);
+        this._sourceDropAction = BMDragSessionAction.actionWithKind(BMDragSessionActionKind.Ignore);
+        this._updateDropAction();
+
+        this._dragDidFinishWithEvent();
+    },
+
     /** 
      * Invoked whenever the pointer moves while this drag session is in progress.
      * @param event <MouseEvent or TouchEvent>       The event.
@@ -551,8 +580,8 @@ BMDragSession.prototype = {
 
     /**
      * Invoked when the pointer is released or cancelled while this drag session is in progress.
-     * @param event <MouseEvent or TouchEvent>      The event.
-     * @return <Promise<void>>                      A promise that resolves when all associated animations finish.
+     * @param event <MouseEvent or TouchEvent or KeyboardEvent> The event.
+     * @return <Promise<void>>                                  A promise that resolves when all associated animations finish.
      */
     async _dragDidFinishWithEvent(event) {
         event.preventDefault();
@@ -575,6 +604,7 @@ BMDragSession.prototype = {
         if (this._touchIdentifier !== undefined) {
             window.removeEventListener('touchcancel', this, {capture: YES, passive: NO});
         }
+        window.removeEventListener('keydown', this, {capture: YES, passive: NO});
         this._releaseDropTargetHandlers();
 
         // If there is a drop target and its action is not ignore, instruct the delegate to perform the action

package/build/BMView/BMDragSessionPreview.js

@@ -1199,6 +1199,12 @@ export function _BMDragPreviewSet() {} // <constructor>
 
 _BMDragPreviewSet.prototype = {
 
+    /**
+     * The offset between the drag pointer and the center the from of the view from which the drag session
+     * started, expressed in percentages relative to the view's frame.
+     */
+    _offsetPercent: BMPointMake(), // <BMPoint>
+
     /**
      * The offset between the drag pointer and the center of the frames of the preview elements.
      */
@@ -1239,7 +1245,8 @@ _BMDragPreviewSet.prototype = {
      * @param previews <[BMDragPreview]>            The previews for items in the drag session.
      * {
      *  @param pointerOffset <BMPoint>              The offset between the drag pointer and the
-     *                                              center of the frames of the preview elements.
+     *                                              center of the frames of the view from which the
+     *                                              drag session started.
      * }
      * @return <_BMDragPreviewSet>                  This preview set.
      */
@@ -1254,7 +1261,7 @@ _BMDragPreviewSet.prototype = {
             this._baseDragPreviews.set(preview._dragItem, preview);
         }
 
-        this._offset = pointerOffset.copy();
+        this._offsetPercent = pointerOffset.copy();
 
         this._dragIndicator = new _BMDragIndicator().init();
 
@@ -1365,6 +1372,21 @@ _BMDragPreviewSet.prototype = {
      * @param position <BMPoint>        The position of the drag session.
      */
     beginLiftAtPosition(position) {
+        const firstPreview = this._dragPreviews.entries().next().value?.[1];
+        const measureIterator = firstPreview?._attachAtPosition(BMPointMake());
+        let measureIteratorResult = measureIterator.next();
+        while (!measureIteratorResult.done) {
+            measureIteratorResult = measureIterator.next();
+        }
+
+        this._offset = BMPointMake(
+            this._offsetPercent.x * (firstPreview?._frame.size.width ?? 0),
+            this._offsetPercent.y * (firstPreview?._frame.size.height ?? 0),
+        );
+
+        firstPreview._detach();
+        firstPreview._measured = NO;
+
         this._position = position.copy();
         const previewPosition = position.copy();
         previewPosition.x += this._offset.x;
@@ -1373,7 +1395,6 @@ _BMDragPreviewSet.prototype = {
         // Attach and measure the previews
         let attachIterators = [];
         let previousPreview;
-        let firstPreview;
         for (const [item, preview] of this._dragPreviews.entries()) {
 
             // For each preview other than the first, apply a random rotation between 15 and -15 degrees
@@ -1381,10 +1402,6 @@ _BMDragPreviewSet.prototype = {
                 preview._transform.rotateZ = Math.random() * _BMDragPreviewMaxRotation * 2 - _BMDragPreviewMaxRotation;
             }
 
-            if (!firstPreview) {
-                firstPreview = preview;
-            }
-
             const attachIterator = preview._attachAtPosition(previewPosition, {before: previousPreview?._previewNode});
             attachIterators.push(attachIterator);
             attachIterator.next();

package/build/BMView/BMMenu.js

@@ -460,6 +460,12 @@ BMMenu.prototype = {
         this.__delaysClosing = delays;
     },
 
+    /**
+     * When set to `YES`, the menu item actions and item selection delegate callbacks will be invoked
+     * with a slight delay to allow time for the menu closing animation to play.
+     */
+    delaysActions: NO, // <Boolean>
+
     /**
      * Initializes this menu with the specified items.
      * The menu will be hidden by default; the method showAtPoint(_) should be used to make the menu visible.
@@ -701,20 +707,13 @@ BMMenu.prototype = {
                 // animation to play out
                 this._delaysClosing = YES;
 
-                if (item.action) {
-                    // Invoke the menu's action if configured
-                    item.action(item);
-                }
+                this._selectedMenuItem = item;
 
                 itemNode.classList.add('BMMenuItemActive');
-
-                if (this.delegate && this.delegate.menuDidSelectItem) {
-                    this.delegate.menuDidSelectItem(this, item);
-                }
             });
 
             // When moving the mouse over an item, set the highlight index to it,
-            // allowing further keyboard navigation to continute from this item
+            // allowing further keyboard navigation to continue from this item
             itemNode.addEventListener('mouseover', event => {
                 // Disabled items can't be highlighted and can't open submenus
                 if (!item._enabled) {
@@ -747,6 +746,21 @@ BMMenu.prototype = {
         });
     },
 
+    /**
+     * Temporarily set to the menu item that was selected until its action is performed.
+     */
+    _selectedMenuItem: undefined, // <BMMenuItem, nullable>
+
+    /**
+     * Performs the action for the specified menu item and invokes the delegate selection callback for it.
+     * @param item <BMMenuItem>         The menu item whose action should be performed.
+     */
+    _performActionForMenuItem(item) {
+        item.action?.(item);
+
+        this.delegate?.menuDidSelectItem?.(this, item);
+    },
+
     /**
      * The kind of menu currently displayed.
      */
@@ -899,8 +913,8 @@ BMMenu.prototype = {
         });
 
         if (!this._supermenu) {
-            // Make the container visible
-            __BMVelocityAnimate(menuContainer, {opacity: 1}, {duration, easing}, BMMENU_USE_WEB_ANIMATIONS);
+            // Make the container visible, using a different easing for the opacity so that it doesn't overshoot the 1 limit
+            __BMVelocityAnimate(menuContainer, {opacity: 1}, {duration: duration / 2, easing: 'easeOutQuad'}, BMMENU_USE_WEB_ANIMATIONS);
         }
         else {
             this._supermenu._node.classList.add('BMMenuInactive');
@@ -911,8 +925,9 @@ BMMenu.prototype = {
         itemsContainerNode.style.overflow = 'hidden';
         
         __BMVelocityAnimate(menuNode, {opacity: 1}, {
-            duration,
-            easing
+            duration: duration / 2,
+            // Use a different easing for the opacity so that it doesn't overshoot the 1 limit
+            easing: 'easeOutQuad',
         }, BMMENU_USE_WEB_ANIMATIONS);
 
         __BMVelocityAnimate(menuNode, {scaleX: 1, scaleY: 1, translateZ: 0, translateY: 0, translateX: 0}, {
@@ -921,7 +936,7 @@ BMMenu.prototype = {
             complete: _ => {
                 menuNode.style.pointerEvents = 'all';
                 menuContainer.style.pointerEvents = 'all';
-            }
+            },
         }, BMMENU_USE_WEB_ANIMATIONS);
 
         // Animate each child node in
@@ -1380,11 +1395,27 @@ BMMenu.prototype = {
         let delay = Math.min(this._itemsContainerNode.childNodes.length * 16, 150);
         delay = (delay < 0 ? 0 : delay);
 
+        let selectedItemCallbackDelay = 0;
+
         // If an item was clicked, further delay closing to allow the selection animation to play
         const delaysClosing = this._delaysClosing;
         this._delaysClosing = NO;
         if (delaysClosing && !this._sourceNodeShadow) {
             delay += 200;
+
+            selectedItemCallbackDelay = 200;
+        }
+
+        const selectedMenuItem = this._selectedMenuItem;
+        this._selectedMenuItem = undefined;
+        
+        if (selectedMenuItem) {
+            if (this.delaysActions && selectedItemCallbackDelay) {
+                setTimeout(() => this._performActionForMenuItem(selectedMenuItem), selectedItemCallbackDelay);
+            }
+            else {
+                this._performActionForMenuItem(selectedMenuItem);
+            }
         }
 
         const sourceNodeShadow = this._sourceNodeShadow;
@@ -1547,6 +1578,7 @@ BMMenu.prototype = {
     },
 
     /**
+     * @protected
      * Invoked when the key sequence for a menu item is pressed.
      * @param event <KeyboardEvent>                         The event that triggered this action.
      * {
@@ -1598,11 +1630,7 @@ BMMenu.prototype = {
             // animation to play out
             this._delaysClosing = YES;
 
-            if (item.action) item.action(item);
-
-            if (this.delegate && this.delegate.menuDidSelectItem) {
-                this.delegate.menuDidSelectItem(this, item);
-            }
+            this._selectedMenuItem = item;
 
             const highlightedNode = item._node;
             if (highlightedNode) {

package/lib/@types/BMCoreUI.min.d.ts

@@ -5846,6 +5846,14 @@ declare class BMDragSession implements EventHandlerObject {
 	private _beginDrag(): void;
 
 
+	/**
+	 * Invoked when a key is pressed while this drag session is in progress.
+	 * @param event          The event.
+	 *     
+	 */
+	private _keyPressedWithEvent(event: KeyboardEvent): void;
+
+
 	/**
 	 * Invoked whenever the pointer moves while this drag session is in progress.
 	 * @param event        The event.
@@ -5856,11 +5864,11 @@ declare class BMDragSession implements EventHandlerObject {
 
 	/**
 	 * Invoked when the pointer is released or cancelled while this drag session is in progress.
-	 * @param event       The event.
-	 * @return                       A promise that resolves when all associated animations finish.
+	 * @param event  The event.
+	 * @return                                   A promise that resolves when all associated animations finish.
 	 *     
 	 */
-	private _dragDidFinishWithEvent(event: MouseEvent | TouchEvent): Promise<void>;
+	private _dragDidFinishWithEvent(event: MouseEvent | TouchEvent | KeyboardEvent): Promise<void>;
 
 
 	/**
@@ -7036,6 +7044,13 @@ declare class _BMDragIndicator {
  */
 declare class _BMDragPreviewSet {
 
+	/**
+	 * The offset between the drag pointer and the center the from of the view from which the drag session
+	 * started, expressed in percentages relative to the view's frame.
+	 *     
+	 */
+	private _offsetPercent: BMPoint;
+
 	/**
 	 * The offset between the drag pointer and the center of the frames of the preview elements.
 	 *     
@@ -7082,7 +7097,8 @@ declare class _BMDragPreviewSet {
 	 * Initializes this drag preview set with the specified item previews and offset position.
 	 * @param previews             The previews for items in the drag session.
 	 * @param pointerOffset               The offset between the drag pointer and the
-	 *                                              center of the frames of the preview elements.
+	 *                                              center of the frames of the view from which the
+	 *                                              drag session started.
 	 * @return                   This preview set.
 	 *     
 	 */
@@ -9975,6 +9991,13 @@ declare class BMMenu {
 	 */
 	_delaysClosing: boolean;
 
+	/**
+	 * When set to `YES`, the menu item actions and item selection delegate callbacks will be invoked
+	 * with a slight delay to allow time for the menu closing animation to play.
+	 *     
+	 */
+	delaysActions: boolean;
+
 	/**
 	 * Initializes this menu with the specified items.
 	 * The menu will be hidden by default; the method showAtPoint(_) should be used to make the menu visible.
@@ -10011,6 +10034,20 @@ declare class BMMenu {
 	private _renderMenuItems(): void;
 
 
+	/**
+	 * Temporarily set to the menu item that was selected until its action is performed.
+	 *     
+	 */
+	private _selectedMenuItem?: BMMenuItem | null | undefined;
+
+	/**
+	 * Performs the action for the specified menu item and invokes the delegate selection callback for it.
+	 * @param item          The menu item whose action should be performed.
+	 *     
+	 */
+	private _performActionForMenuItem(item: BMMenuItem): void;
+
+
 	/**
 	 * The kind of menu currently displayed.
 	 *     
@@ -10133,7 +10170,7 @@ declare class BMMenu {
 	 * @param forKeyboardShortcut      The keyboard shortcut that was triggered.
 	 *     
 	 */
-	private _selectMenuItemWithEvent(event: KeyboardEvent, {forKeyboardShortcut}: {forKeyboardShortcut: BMKeyboardShortcut}): void;
+	protected _selectMenuItemWithEvent(event: KeyboardEvent, {forKeyboardShortcut}: {forKeyboardShortcut: BMKeyboardShortcut}): void;
 
 
 	/**