@atlaskit/editor-plugin-block-controls 7.7.2 → 7.7.3

package/dist/esm/pm-plugins/selection-preservation/utils.js

@@ -0,0 +1,18 @@
+import { selectionPreservationPluginKey } from './plugin-key';
+/**
+ * Detects if any of the transactions include user-driven selection changes.
+ *
+ * @param transactions The list of transactions to check.
+ * @returns True if any transaction includes a user-driven selection change, otherwise false.
+ */
+export var hasUserSelectionChange = function hasUserSelectionChange(transactions) {
+  return transactions.some(function (tr) {
+    return tr.getMeta('pointer') || tr.getMeta('uiEvent') || tr.getMeta('paste') || tr.getMeta('cut') || tr.getMeta('composition') ||
+    // IME input
+    // Keyboard events that change selection
+    tr.getMeta('addToHistory') && tr.selectionSet;
+  });
+};
+export var getSelectionPreservationMeta = function getSelectionPreservationMeta(tr) {
+  return tr.getMeta(selectionPreservationPluginKey);
+};

package/dist/esm/ui/drag-handle.js

@@ -13,17 +13,18 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 // eslint-disable-next-line @atlaskit/ui-styling-standard/use-compiled -- Ignored via go/DSP-18766
 import { css, jsx } from '@emotion/react';
 import { bind } from 'bind-event-listener';
+import { getDocument } from '@atlaskit/browser-apis';
 import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, EVENT_TYPE } from '@atlaskit/editor-common/analytics';
 import { browser as browserLegacy, getBrowserInfo } from '@atlaskit/editor-common/browser';
 import { useSharedPluginStateWithSelector } from '@atlaskit/editor-common/hooks';
 import { dragToMoveDown, dragToMoveLeft, dragToMoveRight, dragToMoveUp, getAriaKeyshortcuts, TooltipContentWithMultipleShortcuts } from '@atlaskit/editor-common/keymaps';
 import { blockControlsMessages } from '@atlaskit/editor-common/messages';
 import { deleteSelectedRange } from '@atlaskit/editor-common/selection';
-import { tableControlsSpacing, DRAG_HANDLE_WIDTH } from '@atlaskit/editor-common/styles';
+import { DRAG_HANDLE_WIDTH, tableControlsSpacing } from '@atlaskit/editor-common/styles';
 import { useSharedPluginStateSelector } from '@atlaskit/editor-common/use-shared-plugin-state-selector';
 import { NodeSelection, TextSelection } from '@atlaskit/editor-prosemirror/state';
 import { findDomRefAtPos } from '@atlaskit/editor-prosemirror/utils';
-import { akEditorTableToolbarSize, akEditorFullPageNarrowBreakout, relativeSizeToBaseFontSize } from '@atlaskit/editor-shared-styles/consts';
+import { akEditorFullPageNarrowBreakout, akEditorTableToolbarSize, relativeSizeToBaseFontSize } from '@atlaskit/editor-shared-styles/consts';
 import DragHandleVerticalIcon from '@atlaskit/icon/core/drag-handle-vertical';
 import DragHandlerIcon from '@atlaskit/icon/glyph/drag-handler';
 import { fg } from '@atlaskit/platform-feature-flags';
@@ -37,6 +38,7 @@ import { editorExperiment } from '@atlaskit/tmp-editor-statsig/experiments';
 import Tooltip from '@atlaskit/tooltip';
 import { getNodeTypeWithLevel } from '../pm-plugins/decorations-common';
 import { key } from '../pm-plugins/main';
+import { selectionPreservationPluginKey } from '../pm-plugins/selection-preservation/plugin-key';
 import { getMultiSelectAnalyticsAttributes } from '../pm-plugins/utils/analytics';
 import { getControlBottomCSSValue, getControlHeightCSSValue, getLeftPosition, getNodeHeight, getTopPosition, shouldBeSticky, shouldMaskNodeControls } from '../pm-plugins/utils/drag-handle-positions';
 import { isHandleCorrelatedToSelection, isNodeWithCodeBlock, selectNode } from '../pm-plugins/utils/getSelection';
@@ -293,18 +295,81 @@ var getNodeMargins = function getNodeMargins(node) {
   }
   return nodeMargins[nodeTypeName] || nodeMargins['default'];
 };
-export var DragHandle = function DragHandle(_ref) {
-  var _api$core3;
-  var view = _ref.view,
-    api = _ref.api,
-    formatMessage = _ref.formatMessage,
-    getPos = _ref.getPos,
-    anchorName = _ref.anchorName,
-    nodeType = _ref.nodeType,
-    handleOptions = _ref.handleOptions,
-    _ref$isTopLevelNode = _ref.isTopLevelNode,
-    isTopLevelNode = _ref$isTopLevelNode === void 0 ? true : _ref$isTopLevelNode,
-    anchorRectCache = _ref.anchorRectCache;
+var isRangeSpanningMultipleNodes = function isRangeSpanningMultipleNodes(range) {
+  if (range.endIndex - range.startIndex <= 1) {
+    return false; // At most one child
+  }
+
+  // Count block nodes in the range, return true if more than one
+  var blockCount = 0;
+  for (var i = range.startIndex; i < range.endIndex; i++) {
+    if (range.parent.child(i).isBlock) {
+      blockCount++;
+    }
+    if (blockCount > 1) {
+      return true;
+    }
+  }
+  return false;
+};
+var shouldExpandSelection = function shouldExpandSelection(range, startPos) {
+  return !!range && isRangeSpanningMultipleNodes(range) && range.start <= startPos && range.end >= startPos + 1;
+};
+var calculateBlockRange = function calculateBlockRange(_ref) {
+  var selection = _ref.selection,
+    doc = _ref.doc,
+    resolvedStartPos = _ref.resolvedStartPos,
+    isShiftPressed = _ref.isShiftPressed;
+  if (!isShiftPressed) {
+    // When not pressing shift, create range including all block nodes within the selection
+    return selection.$from.blockRange(selection.$to);
+  }
+  if (resolvedStartPos.pos < selection.from) {
+    // If shift+click selecting upwards, get range from start of node to end of selection
+    return resolvedStartPos.blockRange(selection.$to);
+  }
+
+  // Shift+click selecting downwards, get range from start of selection to pos within or after node
+  var resolvedPosWithinOrAfterNode = doc.resolve(resolvedStartPos.pos + 1);
+  return selection.$from.blockRange(resolvedPosWithinOrAfterNode);
+};
+var createExpandedSelection = function createExpandedSelection(doc, selection, range) {
+  return TextSelection.create(doc, Math.min(selection.from, range.start), Math.max(selection.to, range.end));
+};
+var createSelectionFromRange = function createSelectionFromRange(_ref2) {
+  var tr = _ref2.tr,
+    selection = _ref2.selection,
+    startPos = _ref2.startPos,
+    nodeType = _ref2.nodeType,
+    range = _ref2.range,
+    api = _ref2.api;
+  if (range && shouldExpandSelection(range, startPos)) {
+    var expandedSelection = createExpandedSelection(tr.doc, selection, range);
+    if (!expandedSelection.eq(tr.selection)) {
+      tr.setSelection(expandedSelection);
+    }
+    return tr;
+  }
+  var node = tr.doc.nodeAt(startPos);
+  var isEmptyNode = (node === null || node === void 0 ? void 0 : node.content.size) === 0;
+  if (isEmptyNode && node.type.name !== 'paragraph') {
+    tr.setSelection(new NodeSelection(tr.doc.resolve(startPos)));
+    return tr;
+  }
+  return selectNode(tr, startPos, nodeType, api);
+};
+export var DragHandle = function DragHandle(_ref3) {
+  var _api$core4;
+  var view = _ref3.view,
+    api = _ref3.api,
+    formatMessage = _ref3.formatMessage,
+    getPos = _ref3.getPos,
+    anchorName = _ref3.anchorName,
+    nodeType = _ref3.nodeType,
+    handleOptions = _ref3.handleOptions,
+    _ref3$isTopLevelNode = _ref3.isTopLevelNode,
+    isTopLevelNode = _ref3$isTopLevelNode === void 0 ? true : _ref3$isTopLevelNode,
+    anchorRectCache = _ref3.anchorRectCache;
   var buttonRef = useRef(null);
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
@@ -365,14 +430,69 @@ export var DragHandle = function DragHandle(_ref) {
       }
     }
   }, [anchorName, nodeType, view.dom]);
-  var handleOnClick = useCallback(function (e) {
+  var handleOnClickNew = useCallback(function (e) {
     var _api$core;
+    api === null || api === void 0 || (_api$core = api.core) === null || _api$core === void 0 || _api$core.actions.execute(function (_ref4) {
+      var _api$analytics, _resolvedStartPos$nod, _selectionPreservatio, _api$blockControls, _api$blockControls2;
+      var tr = _ref4.tr;
+      var startPos = getPos();
+      if (startPos === undefined) {
+        return tr;
+      }
+      var resolvedStartPos = tr.doc.resolve(startPos);
+      api === null || api === void 0 || (_api$analytics = api.analytics) === null || _api$analytics === void 0 || _api$analytics.actions.attachAnalyticsEvent({
+        eventType: EVENT_TYPE.UI,
+        action: ACTION.CLICKED,
+        actionSubject: ACTION_SUBJECT.BUTTON,
+        actionSubjectId: ACTION_SUBJECT_ID.ELEMENT_DRAG_HANDLE,
+        attributes: {
+          nodeDepth: resolvedStartPos.depth,
+          nodeType: ((_resolvedStartPos$nod = resolvedStartPos.nodeAfter) === null || _resolvedStartPos$nod === void 0 ? void 0 : _resolvedStartPos$nod.type.name) || ''
+        }
+      })(tr);
+      var preservedSelection = (_selectionPreservatio = selectionPreservationPluginKey.getState(view.state)) === null || _selectionPreservatio === void 0 ? void 0 : _selectionPreservatio.preservedSelection;
+      var selection = preservedSelection || tr.selection;
+      var range = calculateBlockRange({
+        doc: tr.doc,
+        selection: selection,
+        resolvedStartPos: resolvedStartPos,
+        isShiftPressed: e.shiftKey
+      });
+      tr = createSelectionFromRange({
+        tr: tr,
+        selection: selection,
+        startPos: startPos,
+        nodeType: nodeType,
+        range: range,
+        api: api
+      });
+      api === null || api === void 0 || (_api$blockControls = api.blockControls) === null || _api$blockControls === void 0 || _api$blockControls.commands.startPreservingSelection()({
+        tr: tr
+      });
+      api === null || api === void 0 || (_api$blockControls2 = api.blockControls) === null || _api$blockControls2 === void 0 || _api$blockControls2.commands.toggleBlockMenu({
+        anchorName: anchorName,
+        openedViaKeyboard: false,
+        triggerByNode: expValEqualsNoExposure('platform_synced_block', 'isEnabled', true) ? {
+          nodeType: nodeType,
+          pos: startPos,
+          rootPos: tr.doc.resolve(startPos).before(1)
+        } : undefined
+      })({
+        tr: tr
+      });
+      tr.setMeta('scrollIntoView', false);
+      return tr;
+    });
+    view.focus();
+  }, [api, view, getPos, nodeType, anchorName]);
+  var handleOnClick = useCallback(function (e) {
+    var _api$core2;
     if (!isMultiSelect) {
       setDragHandleSelected(!dragHandleSelected);
     }
-    api === null || api === void 0 || (_api$core = api.core) === null || _api$core === void 0 || _api$core.actions.execute(function (_ref2) {
-      var _api$blockControls$sh, _api$analytics;
-      var tr = _ref2.tr;
+    api === null || api === void 0 || (_api$core2 = api.core) === null || _api$core2 === void 0 || _api$core2.actions.execute(function (_ref5) {
+      var _api$blockControls$sh, _api$analytics2;
+      var tr = _ref5.tr;
       var startPos = getPos();
       if (startPos === undefined) {
         return tr;
@@ -401,8 +521,8 @@ export var DragHandle = function DragHandle(_ref) {
           rootPos: rootPos
         } : undefined;
         if (BLOCK_MENU_ENABLED && editorExperiment('platform_editor_controls', 'variant1')) {
-          var _api$blockControls;
-          api === null || api === void 0 || (_api$blockControls = api.blockControls) === null || _api$blockControls === void 0 || _api$blockControls.commands.toggleBlockMenu({
+          var _api$blockControls3;
+          api === null || api === void 0 || (_api$blockControls3 = api.blockControls) === null || _api$blockControls3 === void 0 || _api$blockControls3.commands.toggleBlockMenu({
             anchorName: anchorName,
             triggerByNode: triggerByNode,
             openedViaKeyboard: expValEqualsNoExposure('platform_editor_block_menu_keyboard_navigation', 'isEnabled', true) ? false : undefined
@@ -411,8 +531,8 @@ export var DragHandle = function DragHandle(_ref) {
           });
           e.stopPropagation();
         } else if (expValEqualsNoExposure('platform_editor_block_menu', 'isEnabled', true)) {
-          var _api$blockControls2;
-          api === null || api === void 0 || (_api$blockControls2 = api.blockControls) === null || _api$blockControls2 === void 0 || _api$blockControls2.commands.toggleBlockMenu({
+          var _api$blockControls4;
+          api === null || api === void 0 || (_api$blockControls4 = api.blockControls) === null || _api$blockControls4 === void 0 || _api$blockControls4.commands.toggleBlockMenu({
             anchorName: anchorName,
             triggerByNode: triggerByNode,
             openedViaKeyboard: expValEqualsNoExposure('platform_editor_block_menu_keyboard_navigation', 'isEnabled', true) ? false : undefined
@@ -422,18 +542,18 @@ export var DragHandle = function DragHandle(_ref) {
           e.stopPropagation();
         }
       } else if (isTopLevelNode && $anchor.depth <= DRAG_HANDLE_MAX_SHIFT_CLICK_DEPTH && e.shiftKey && fg('platform_editor_elements_dnd_shift_click_select')) {
-        var _api$blockControls3;
+        var _api$blockControls5;
         var alignAnchorHeadToSel = alignAnchorHeadInDirectionOfPos(tr.selection, startPos);
         var selectionWithExpandedHead = expandSelectionHeadToNodeAtPos(alignAnchorHeadToSel, startPos);
         tr.setSelection(selectionWithExpandedHead);
-        api === null || api === void 0 || (_api$blockControls3 = api.blockControls) === null || _api$blockControls3 === void 0 || _api$blockControls3.commands.setMultiSelectPositions()({
+        api === null || api === void 0 || (_api$blockControls5 = api.blockControls) === null || _api$blockControls5 === void 0 || _api$blockControls5.commands.setMultiSelectPositions()({
           tr: tr
         });
       }
       var resolvedMovingNode = tr.doc.resolve(startPos);
       var maybeNode = resolvedMovingNode.nodeAfter;
       tr.setMeta('scrollIntoView', false);
-      api === null || api === void 0 || (_api$analytics = api.analytics) === null || _api$analytics === void 0 || _api$analytics.actions.attachAnalyticsEvent({
+      api === null || api === void 0 || (_api$analytics2 = api.analytics) === null || _api$analytics2 === void 0 || _api$analytics2.actions.attachAnalyticsEvent({
         eventType: EVENT_TYPE.UI,
         action: ACTION.CLICKED,
         actionSubject: ACTION_SUBJECT.BUTTON,
@@ -450,10 +570,10 @@ export var DragHandle = function DragHandle(_ref) {
   var handleKeyDown = useCallback(function (e) {
     // allow user to use spacebar to select the node
     if (!e.repeat && e.key === ' ') {
-      var _api$core2;
+      var _api$core3;
       var startPos = getPos();
-      api === null || api === void 0 || (_api$core2 = api.core) === null || _api$core2 === void 0 || _api$core2.actions.execute(function (_ref3) {
-        var tr = _ref3.tr;
+      api === null || api === void 0 || (_api$core3 = api.core) === null || _api$core3 === void 0 || _api$core3.actions.execute(function (_ref6) {
+        var tr = _ref6.tr;
         if (startPos === undefined) {
           return tr;
         }
@@ -476,20 +596,20 @@ export var DragHandle = function DragHandle(_ref) {
       // return focus to editor to resume editing from caret position
       view.focus();
     }
-  }, [getPos, api === null || api === void 0 || (_api$core3 = api.core) === null || _api$core3 === void 0 ? void 0 : _api$core3.actions, isMultiSelect, view]);
+  }, [getPos, api === null || api === void 0 || (_api$core4 = api.core) === null || _api$core4 === void 0 ? void 0 : _api$core4.actions, isMultiSelect, view]);
   var handleKeyDownNew = useCallback(function (e) {
     // allow user to use spacebar to select the node
     if (e.key === 'Enter' || !e.repeat && e.key === ' ') {
-      var _api$core4;
-      if (document.activeElement !== buttonRef.current) {
+      var _getDocument, _api$core5;
+      if (((_getDocument = getDocument()) === null || _getDocument === void 0 ? void 0 : _getDocument.activeElement) !== buttonRef.current) {
         return;
       }
       e.preventDefault();
       e.stopPropagation();
       var startPos = getPos();
-      api === null || api === void 0 || (_api$core4 = api.core) === null || _api$core4 === void 0 || _api$core4.actions.execute(function (_ref4) {
-        var _api$blockControls4, _api$userIntent;
-        var tr = _ref4.tr;
+      api === null || api === void 0 || (_api$core5 = api.core) === null || _api$core5 === void 0 || _api$core5.actions.execute(function (_ref7) {
+        var _api$blockControls6, _api$userIntent;
+        var tr = _ref7.tr;
         if (startPos === undefined) {
           return tr;
         }
@@ -503,7 +623,7 @@ export var DragHandle = function DragHandle(_ref) {
           pos: startPos,
           rootPos: rootPos
         } : undefined;
-        api === null || api === void 0 || (_api$blockControls4 = api.blockControls) === null || _api$blockControls4 === void 0 || _api$blockControls4.commands.toggleBlockMenu({
+        api === null || api === void 0 || (_api$blockControls6 = api.blockControls) === null || _api$blockControls6 === void 0 || _api$blockControls6.commands.toggleBlockMenu({
           anchorName: anchorName,
           triggerByNode: triggerByNode,
           openedViaKeyboard: true
@@ -518,11 +638,11 @@ export var DragHandle = function DragHandle(_ref) {
     } else if (e.key === 'Backspace' || e.key === 'Delete') {
       e.preventDefault();
       e.stopPropagation();
-      api === null || api === void 0 || api.core.actions.execute(function (_ref5) {
-        var _api$blockControls5;
-        var tr = _ref5.tr;
+      api === null || api === void 0 || api.core.actions.execute(function (_ref8) {
+        var _api$blockControls7;
+        var tr = _ref8.tr;
         deleteSelectedRange(tr);
-        api === null || api === void 0 || (_api$blockControls5 = api.blockControls) === null || _api$blockControls5 === void 0 || _api$blockControls5.commands.toggleBlockMenu({
+        api === null || api === void 0 || (_api$blockControls7 = api.blockControls) === null || _api$blockControls7 === void 0 || _api$blockControls7.commands.toggleBlockMenu({
           closeMenu: true
         })({
           tr: tr
@@ -550,21 +670,21 @@ export var DragHandle = function DragHandle(_ref) {
           start: start
         };
       },
-      onGenerateDragPreview: function onGenerateDragPreview(_ref6) {
+      onGenerateDragPreview: function onGenerateDragPreview(_ref9) {
         var _api$blockControls$sh2;
-        var nativeSetDragImage = _ref6.nativeSetDragImage;
+        var nativeSetDragImage = _ref9.nativeSetDragImage;
         if (isMultiSelect) {
-          var _api$core5;
-          api === null || api === void 0 || (_api$core5 = api.core) === null || _api$core5 === void 0 || _api$core5.actions.execute(function (_ref7) {
-            var tr = _ref7.tr;
+          var _api$core6;
+          api === null || api === void 0 || (_api$core6 = api.core) === null || _api$core6 === void 0 || _api$core6.actions.execute(function (_ref0) {
+            var tr = _ref0.tr;
             var handlePos = getPos();
             if (typeof handlePos !== 'number') {
               return tr;
             }
             var newHandlePosCheck = isHandleCorrelatedToSelection(view.state, tr.selection, handlePos);
             if (!tr.selection.empty && newHandlePosCheck) {
-              var _api$blockControls6;
-              api === null || api === void 0 || (_api$blockControls6 = api.blockControls) === null || _api$blockControls6 === void 0 || _api$blockControls6.commands.setMultiSelectPositions()({
+              var _api$blockControls8;
+              api === null || api === void 0 || (_api$blockControls8 = api.blockControls) === null || _api$blockControls8 === void 0 || _api$blockControls8.commands.setMultiSelectPositions()({
                 tr: tr
               });
             } else if (fg('platform_editor_elements_dnd_select_node_on_drag')) {
@@ -634,8 +754,8 @@ export var DragHandle = function DragHandle(_ref) {
               };
             }
           },
-          render: function render(_ref8) {
-            var container = _ref8.container;
+          render: function render(_ref1) {
+            var container = _ref1.container;
             var dom = view.dom.querySelector("[".concat(getAnchorAttrName(), "=\"").concat(anchorName, "\"]"));
             if (!dom) {
               return;
@@ -667,13 +787,13 @@ export var DragHandle = function DragHandle(_ref) {
         });
       },
       onDragStart: function onDragStart() {
-        var _api$core6;
+        var _api$core7;
         if (start === undefined) {
           return;
         }
-        api === null || api === void 0 || (_api$core6 = api.core) === null || _api$core6 === void 0 || _api$core6.actions.execute(function (_ref9) {
-          var _api$blockControls$sh3, _api$blockControls7, _api$analytics2;
-          var tr = _ref9.tr;
+        api === null || api === void 0 || (_api$core7 = api.core) === null || _api$core7 === void 0 || _api$core7.actions.execute(function (_ref10) {
+          var _api$blockControls$sh3, _api$blockControls9, _api$analytics3;
+          var tr = _ref10.tr;
           var nodeTypes, hasSelectedMultipleNodes;
           var resolvedMovingNode = tr.doc.resolve(start);
           var maybeNode = resolvedMovingNode.nodeAfter;
@@ -686,11 +806,11 @@ export var DragHandle = function DragHandle(_ref) {
             nodeTypes = maybeNode === null || maybeNode === void 0 ? void 0 : maybeNode.type.name;
             hasSelectedMultipleNodes = false;
           }
-          api === null || api === void 0 || (_api$blockControls7 = api.blockControls) === null || _api$blockControls7 === void 0 || _api$blockControls7.commands.setNodeDragged(getPos, anchorName, nodeType)({
+          api === null || api === void 0 || (_api$blockControls9 = api.blockControls) === null || _api$blockControls9 === void 0 || _api$blockControls9.commands.setNodeDragged(getPos, anchorName, nodeType)({
             tr: tr
           });
           tr.setMeta('scrollIntoView', false);
-          api === null || api === void 0 || (_api$analytics2 = api.analytics) === null || _api$analytics2 === void 0 || _api$analytics2.actions.attachAnalyticsEvent({
+          api === null || api === void 0 || (_api$analytics3 = api.analytics) === null || _api$analytics3 === void 0 || _api$analytics3.actions.attachAnalyticsEvent({
             eventType: EVENT_TYPE.UI,
             action: ACTION.DRAGGED,
             actionSubject: ACTION_SUBJECT.ELEMENT,
@@ -984,7 +1104,7 @@ export var DragHandle = function DragHandle(_ref) {
         // eslint-disable-next-line @atlaskit/ui-styling-standard/enforce-style-prop -- Ignored via go/DSP-18766
         ,
         style: !editorExperiment('platform_editor_controls', 'variant1') ? editorExperiment('platform_editor_block_control_optimise_render', true) ? positionStyles : positionStylesOld : {},
-        onClick: handleOnClick,
+        onClick: expValEqualsNoExposure('platform_editor_block_menu', 'isEnabled', true) ? handleOnClickNew : handleOnClick,
         onKeyDown: expValEqualsNoExposure('platform_editor_block_menu', 'isEnabled', true) && expValEqualsNoExposure('platform_editor_block_menu_keyboard_navigation', 'isEnabled', true) ? handleKeyDownNew : handleKeyDown
         // eslint-disable-next-line @atlaskit/design-system/no-direct-use-of-web-platform-drag-and-drop
         ,
@@ -1069,15 +1189,15 @@ export var DragHandle = function DragHandle(_ref) {
   var render = isTooltip ? buttonWithTooltip() : renderButton();
   return editorExperiment('platform_editor_controls', 'variant1') ? stickyRender : render;
 };
-export var DragHandleWithVisibility = function DragHandleWithVisibility(_ref0) {
-  var view = _ref0.view,
-    api = _ref0.api,
-    formatMessage = _ref0.formatMessage,
-    getPos = _ref0.getPos,
-    anchorName = _ref0.anchorName,
-    nodeType = _ref0.nodeType,
-    handleOptions = _ref0.handleOptions,
-    anchorRectCache = _ref0.anchorRectCache;
+export var DragHandleWithVisibility = function DragHandleWithVisibility(_ref11) {
+  var view = _ref11.view,
+    api = _ref11.api,
+    formatMessage = _ref11.formatMessage,
+    getPos = _ref11.getPos,
+    anchorName = _ref11.anchorName,
+    nodeType = _ref11.nodeType,
+    handleOptions = _ref11.handleOptions,
+    anchorRectCache = _ref11.anchorRectCache;
   return jsx(VisibilityContainer, {
     api: api
   }, jsx(DragHandle, {

package/dist/types/blockControlsPluginType.d.ts

@@ -1,6 +1,6 @@
 import { type IntlShape } from 'react-intl-next';
 import { type INPUT_METHOD } from '@atlaskit/editor-common/analytics';
-import type { EditorCommand, NextEditorPlugin, OptionalPlugin, DIRECTION } from '@atlaskit/editor-common/types';
+import type { DIRECTION, EditorCommand, NextEditorPlugin, OptionalPlugin } from '@atlaskit/editor-common/types';
 import type { AccessibilityUtilsPlugin } from '@atlaskit/editor-plugin-accessibility-utils';
 import { type AnalyticsPlugin } from '@atlaskit/editor-plugin-analytics';
 import type { EditorDisabledPlugin } from '@atlaskit/editor-plugin-editor-disabled';
@@ -132,6 +132,17 @@ export type BlockControlsPlugin = NextEditorPlugin<'blockControls', {
         setNodeDragged: (getPos: () => number | undefined, anchorName: string, nodeType: string) => EditorCommand;
         setSelectedViaDragHandle: (isSelectedViaDragHandle?: boolean) => EditorCommand;
         showDragHandleAt: (pos: number, anchorName: string, nodeType: string, handleOptions?: HandleOptions, rootPos?: number, rootAnchorName?: string, rootNodeType?: string) => EditorCommand;
+        /**
+         * Starts preserving the current selection across transactions.
+         * Used when opening block menus, dragging, or other interactions
+         * where multi-node selections should remain stable.
+         */
+        startPreservingSelection: () => EditorCommand;
+        /**
+         * Stops preserving the selection, allowing it to change freely.
+         * Called when block menus close or drag operations end.
+         */
+        stopPreservingSelection: () => EditorCommand;
         toggleBlockMenu: (options?: {
             anchorName?: string;
             closeMenu?: boolean;

package/dist/types/pm-plugins/selection-preservation/editor-commands.d.ts

@@ -0,0 +1,13 @@
+import type { EditorCommand } from '@atlaskit/editor-common/types';
+/**
+ * Start preserving the selection when a UI interaction requires it
+ *
+ * e.g., block menu open, drag-and-drop in progress
+ */
+export declare const startPreservingSelection: EditorCommand;
+/**
+ * Stop preserving the selection when a UI interaction completes
+ *
+ * e.g., block menu closed, drag-and-drop ended
+ */
+export declare const stopPreservingSelection: EditorCommand;

package/dist/types/pm-plugins/selection-preservation/plugin-key.d.ts

@@ -0,0 +1,3 @@
+import { PluginKey } from '@atlaskit/editor-prosemirror/state';
+import type { SelectionPreservationPluginState } from './types';
+export declare const selectionPreservationPluginKey: PluginKey<SelectionPreservationPluginState>;

package/dist/types/pm-plugins/selection-preservation/pm-plugin.d.ts

@@ -0,0 +1,26 @@
+import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
+import type { SelectionPreservationPluginState } from './types';
+/**
+ * Selection Preservation Plugin for ProseMirror Editor
+ *
+ * Solves a ProseMirror limitation where TextSelection cannot include positions at node boundaries
+ * (like media/images). When a selection spans text + media nodes, subsequent transactions cause
+ * ProseMirror to collapse the selection to the nearest inline position, excluding the media node.
+ * This is problematic for features like block menus and drag-and-drop that need stable multi-node
+ * selections while performing operations.
+ *
+ * The plugin works in three phases:
+ * (1) Explicitly save a selection via startPreservingSelection() when opening block menus or starting drag operations.
+ * (2) Map the saved selection through document changes to keep positions valid.
+ * (3) Detect when transactions collapse the selection and restore it via appendTransaction().
+ *
+ * Stops preserving via stopPreservingSelection() when the menu closes or operation completes.
+ *
+ * Commands: startPreservingSelection() to begin preservation, stopPreservingSelection() to end it.
+ *
+ * NOTE: Only use when the UI blocks user selection changes. For example: when a block menu overlay
+ * is open (editor becomes non-interactive), during drag-and-drop operations (user is mid-drag), or
+ * when modal dialogs are active. In these states, any selection changes are from ProseMirror's
+ * internal behavior (not user input) and should be prevented. Do not use during normal editing.
+ */
+export declare const createSelectionPreservationPlugin: () => SafePlugin<SelectionPreservationPluginState>;

package/dist/types/pm-plugins/selection-preservation/types.d.ts

@@ -0,0 +1,7 @@
+import type { Selection } from '@atlaskit/editor-prosemirror/state';
+export type SelectionPreservationPluginState = {
+    preservedSelection?: Selection;
+};
+export type SelectionPreservationMeta = {
+    type: 'startPreserving' | 'stopPreserving';
+};

package/dist/types/pm-plugins/selection-preservation/utils.d.ts

@@ -0,0 +1,10 @@
+import type { ReadonlyTransaction, Transaction } from '@atlaskit/editor-prosemirror/state';
+import type { SelectionPreservationMeta } from './types';
+/**
+ * Detects if any of the transactions include user-driven selection changes.
+ *
+ * @param transactions The list of transactions to check.
+ * @returns True if any transaction includes a user-driven selection change, otherwise false.
+ */
+export declare const hasUserSelectionChange: (transactions: readonly Transaction[]) => boolean;
+export declare const getSelectionPreservationMeta: (tr: Transaction | ReadonlyTransaction) => SelectionPreservationMeta | undefined;

package/dist/types-ts4.5/blockControlsPluginType.d.ts

@@ -1,6 +1,6 @@
 import { type IntlShape } from 'react-intl-next';
 import { type INPUT_METHOD } from '@atlaskit/editor-common/analytics';
-import type { EditorCommand, NextEditorPlugin, OptionalPlugin, DIRECTION } from '@atlaskit/editor-common/types';
+import type { DIRECTION, EditorCommand, NextEditorPlugin, OptionalPlugin } from '@atlaskit/editor-common/types';
 import type { AccessibilityUtilsPlugin } from '@atlaskit/editor-plugin-accessibility-utils';
 import { type AnalyticsPlugin } from '@atlaskit/editor-plugin-analytics';
 import type { EditorDisabledPlugin } from '@atlaskit/editor-plugin-editor-disabled';
@@ -132,6 +132,17 @@ export type BlockControlsPlugin = NextEditorPlugin<'blockControls', {
         setNodeDragged: (getPos: () => number | undefined, anchorName: string, nodeType: string) => EditorCommand;
         setSelectedViaDragHandle: (isSelectedViaDragHandle?: boolean) => EditorCommand;
         showDragHandleAt: (pos: number, anchorName: string, nodeType: string, handleOptions?: HandleOptions, rootPos?: number, rootAnchorName?: string, rootNodeType?: string) => EditorCommand;
+        /**
+         * Starts preserving the current selection across transactions.
+         * Used when opening block menus, dragging, or other interactions
+         * where multi-node selections should remain stable.
+         */
+        startPreservingSelection: () => EditorCommand;
+        /**
+         * Stops preserving the selection, allowing it to change freely.
+         * Called when block menus close or drag operations end.
+         */
+        stopPreservingSelection: () => EditorCommand;
         toggleBlockMenu: (options?: {
             anchorName?: string;
             closeMenu?: boolean;

package/dist/types-ts4.5/pm-plugins/selection-preservation/editor-commands.d.ts

@@ -0,0 +1,13 @@
+import type { EditorCommand } from '@atlaskit/editor-common/types';
+/**
+ * Start preserving the selection when a UI interaction requires it
+ *
+ * e.g., block menu open, drag-and-drop in progress
+ */
+export declare const startPreservingSelection: EditorCommand;
+/**
+ * Stop preserving the selection when a UI interaction completes
+ *
+ * e.g., block menu closed, drag-and-drop ended
+ */
+export declare const stopPreservingSelection: EditorCommand;

package/dist/types-ts4.5/pm-plugins/selection-preservation/plugin-key.d.ts

@@ -0,0 +1,3 @@
+import { PluginKey } from '@atlaskit/editor-prosemirror/state';
+import type { SelectionPreservationPluginState } from './types';
+export declare const selectionPreservationPluginKey: PluginKey<SelectionPreservationPluginState>;

package/dist/types-ts4.5/pm-plugins/selection-preservation/pm-plugin.d.ts

@@ -0,0 +1,26 @@
+import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
+import type { SelectionPreservationPluginState } from './types';
+/**
+ * Selection Preservation Plugin for ProseMirror Editor
+ *
+ * Solves a ProseMirror limitation where TextSelection cannot include positions at node boundaries
+ * (like media/images). When a selection spans text + media nodes, subsequent transactions cause
+ * ProseMirror to collapse the selection to the nearest inline position, excluding the media node.
+ * This is problematic for features like block menus and drag-and-drop that need stable multi-node
+ * selections while performing operations.
+ *
+ * The plugin works in three phases:
+ * (1) Explicitly save a selection via startPreservingSelection() when opening block menus or starting drag operations.
+ * (2) Map the saved selection through document changes to keep positions valid.
+ * (3) Detect when transactions collapse the selection and restore it via appendTransaction().
+ *
+ * Stops preserving via stopPreservingSelection() when the menu closes or operation completes.
+ *
+ * Commands: startPreservingSelection() to begin preservation, stopPreservingSelection() to end it.
+ *
+ * NOTE: Only use when the UI blocks user selection changes. For example: when a block menu overlay
+ * is open (editor becomes non-interactive), during drag-and-drop operations (user is mid-drag), or
+ * when modal dialogs are active. In these states, any selection changes are from ProseMirror's
+ * internal behavior (not user input) and should be prevented. Do not use during normal editing.
+ */
+export declare const createSelectionPreservationPlugin: () => SafePlugin<SelectionPreservationPluginState>;

package/dist/types-ts4.5/pm-plugins/selection-preservation/types.d.ts

@@ -0,0 +1,7 @@
+import type { Selection } from '@atlaskit/editor-prosemirror/state';
+export type SelectionPreservationPluginState = {
+    preservedSelection?: Selection;
+};
+export type SelectionPreservationMeta = {
+    type: 'startPreserving' | 'stopPreserving';
+};

package/dist/types-ts4.5/pm-plugins/selection-preservation/utils.d.ts

@@ -0,0 +1,10 @@
+import type { ReadonlyTransaction, Transaction } from '@atlaskit/editor-prosemirror/state';
+import type { SelectionPreservationMeta } from './types';
+/**
+ * Detects if any of the transactions include user-driven selection changes.
+ *
+ * @param transactions The list of transactions to check.
+ * @returns True if any transaction includes a user-driven selection change, otherwise false.
+ */
+export declare const hasUserSelectionChange: (transactions: readonly Transaction[]) => boolean;
+export declare const getSelectionPreservationMeta: (tr: Transaction | ReadonlyTransaction) => SelectionPreservationMeta | undefined;