@atlaskit/editor-plugin-block-controls 17.1.4 → 17.1.5

package/dist/esm/pm-plugins/main.js

@@ -7,6 +7,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 import rafSchedule from 'raf-schd';
 import { getDocument } from '@atlaskit/browser-apis';
 import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, EVENT_TYPE } from '@atlaskit/editor-common/analytics';
+import { BLOCK_CONTROLS_LEFT_SURFACE } from '@atlaskit/editor-common/block-controls/surface-keys';
 import { getBrowserInfo } from '@atlaskit/editor-common/browser';
 import { getNodeIdProvider } from '@atlaskit/editor-common/node-anchor';
 import { isMeasuring, startMeasure, stopMeasure } from '@atlaskit/editor-common/performance-measures';
@@ -17,6 +18,7 @@ import { EDIT_AREA_ID } from '@atlaskit/editor-common/ui';
 import { isEmptyDocument } from '@atlaskit/editor-common/utils';
 import { PluginKey, TextSelection } from '@atlaskit/editor-prosemirror/state';
 import { DecorationSet } from '@atlaskit/editor-prosemirror/view';
+import { resolveSurface } from '@atlaskit/editor-ui-control-model/surface-renderer';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { autoScrollForElements } from '@atlaskit/pragmatic-drag-and-drop-auto-scroll/element';
 import { combine } from '@atlaskit/pragmatic-drag-and-drop/utils/combine';
@@ -38,6 +40,7 @@ import { getMultiSelectAnalyticsAttributes } from './utils/analytics';
 import { AnchorRectCache, isAnchorSupported } from './utils/anchor-utils';
 import { selectNode } from './utils/getSelection';
 import { getSelectedSlicePosition } from './utils/selection';
+import { getSurfaceNodePositions, updateSurfaceNodePositions } from './utils/surface-node-positions';
 import { getTrMetadata } from './utils/transactions';
 export var key = new PluginKey('blockControls');
 var EDITOR_BLOCKS_DRAG_INIT = 'Editor Blocks Drag Initialization Time';
@@ -198,6 +201,7 @@ var destroyFn = function destroyFn(api, editorView) {
 };
 var initialState = {
   decorations: DecorationSet.empty,
+  surfaceNodePositions: [],
   activeNode: undefined,
   isDragging: false,
   isMenuOpen: false,
@@ -235,10 +239,13 @@ var _apply = function apply(api, formatMessage, tr, currentState, newState, flag
   var anchorRectCache = arguments.length > 10 ? arguments[10] : undefined;
   var resizeObserverWidth = arguments.length > 11 ? arguments[11] : undefined;
   var pragmaticCleanup = arguments.length > 12 ? arguments[12] : undefined;
+  var resolvedSurface = arguments.length > 13 ? arguments[13] : undefined;
   var activeNode = currentState.activeNode,
     decorations = currentState.decorations,
     isResizerResizing = currentState.isResizerResizing,
-    multiSelectDnD = currentState.multiSelectDnD;
+    multiSelectDnD = currentState.multiSelectDnD,
+    surfaceNodePositions = currentState.surfaceNodePositions;
+  var previousActiveNode = activeNode;
   var editorHeight = currentState.editorHeight,
     editorWidthLeft = currentState.editorWidthLeft,
     editorWidthRight = currentState.editorWidthRight,
@@ -803,6 +810,18 @@ var _apply = function apply(api, formatMessage, tr, currentState, newState, flag
     var _latestActiveNode13, _latestActiveNode14;
     newActiveNode = isEmptyDoc || !(meta !== null && meta !== void 0 && meta.activeNode) && flags.legacyDragHandleEnabled && findHandleDec(decorations, (_latestActiveNode13 = latestActiveNode) === null || _latestActiveNode13 === void 0 ? void 0 : _latestActiveNode13.pos, (_latestActiveNode14 = latestActiveNode) === null || _latestActiveNode14 === void 0 ? void 0 : _latestActiveNode14.pos).length === 0 ? null : latestActiveNode;
   }
+  if (flags.surfaceNodePositionsEnabled && resolvedSurface) {
+    surfaceNodePositions = updateSurfaceNodePositions({
+      activeNode: newActiveNode,
+      currentPositions: surfaceNodePositions,
+      from: from,
+      newState: newState,
+      previousActiveNode: previousActiveNode,
+      resolvedSurface: resolvedSurface,
+      to: to,
+      tr: tr
+    });
+  }
   var isMenuOpenNew = isMenuOpen;
   if (editorExperiment('platform_editor_block_menu', true)) {
     if (meta !== null && meta !== void 0 && meta.closeMenu) {
@@ -822,6 +841,7 @@ var _apply = function apply(api, formatMessage, tr, currentState, newState, flag
   }
   return {
     decorations: decorations,
+    surfaceNodePositions: surfaceNodePositions,
     activeNode: newActiveNode,
     activeDropTargetNode: currentActiveDropTargetNode,
     isDragging: (_meta$isDragging3 = meta === null || meta === void 0 ? void 0 : meta.isDragging) !== null && _meta$isDragging3 !== void 0 ? _meta$isDragging3 : isDragging,
@@ -847,9 +867,11 @@ var _apply = function apply(api, formatMessage, tr, currentState, newState, flag
 };
 export { _apply as apply };
 export var createPlugin = function createPlugin(api, getIntl, nodeViewPortalProviderAPI, nodeDecorationRegistry) {
+  var _api$uiControlRegistr, _api$uiControlRegistr2;
   var rightSideControlsEnabled = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
   var quickInsertButtonEnabled = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : true;
   var legacyDragHandleEnabled = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : true;
+  var surfaceNodePositionsEnabled = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : false;
   var _getIntl = getIntl(),
     formatMessage = _getIntl.formatMessage;
   var isAdvancedLayoutEnabled = editorExperiment('advanced_layouts', true, {
@@ -858,8 +880,10 @@ export var createPlugin = function createPlugin(api, getIntl, nodeViewPortalProv
   var toolbarFlagsEnabled = areToolbarFlagsEnabled(Boolean(api === null || api === void 0 ? void 0 : api.toolbar));
   var flags = {
     legacyDragHandleEnabled: legacyDragHandleEnabled,
+    surfaceNodePositionsEnabled: surfaceNodePositionsEnabled,
     toolbarFlagsEnabled: toolbarFlagsEnabled
   };
+  var resolvedSurface = surfaceNodePositionsEnabled ? resolveSurface((_api$uiControlRegistr = api === null || api === void 0 || (_api$uiControlRegistr2 = api.uiControlRegistry) === null || _api$uiControlRegistr2 === void 0 ? void 0 : _api$uiControlRegistr2.actions.getComponents(BLOCK_CONTROLS_LEFT_SURFACE)) !== null && _api$uiControlRegistr !== void 0 ? _api$uiControlRegistr : [], BLOCK_CONTROLS_LEFT_SURFACE) : undefined;
   var anchorRectCache;
   if (!isAnchorSupported()) {
     anchorRectCache = new AnchorRectCache();
@@ -869,11 +893,13 @@ export var createPlugin = function createPlugin(api, getIntl, nodeViewPortalProv
   return new SafePlugin({
     key: key,
     state: {
-      init: function init() {
-        return initialState;
+      init: function init(_config, editorState) {
+        return _objectSpread(_objectSpread({}, initialState), {}, {
+          surfaceNodePositions: resolvedSurface ? getSurfaceNodePositions(editorState, resolvedSurface) : []
+        });
       },
       apply: function apply(tr, currentState, _, newState) {
-        return _apply(api, formatMessage, tr, currentState, newState, flags, nodeViewPortalProviderAPI, nodeDecorationRegistry, rightSideControlsEnabled, quickInsertButtonEnabled, anchorRectCache, resizeObserverWidth, pragmaticCleanup);
+        return _apply(api, formatMessage, tr, currentState, newState, flags, nodeViewPortalProviderAPI, nodeDecorationRegistry, rightSideControlsEnabled, quickInsertButtonEnabled, anchorRectCache, resizeObserverWidth, pragmaticCleanup, resolvedSurface);
       }
     },
     props: {

package/dist/esm/pm-plugins/utils/surface-node-positions.js

@@ -0,0 +1,64 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+import { BLOCK_CONTROL_UI_CONTEXT } from '@atlaskit/editor-common/block-controls/block-control-ui-context';
+import { willComponentRender } from '@atlaskit/editor-ui-control-model/surface-renderer';
+import { createSurfaceContext } from '@atlaskit/editor-ui-control-model/types';
+import { createBlockControlsSurfaceContextForPosition } from '../../ui/block-controls-surface-context';
+var createSurfaceContextAtPosition = function createSurfaceContextAtPosition(state, position, activeNode) {
+  var blockControlsContext = createBlockControlsSurfaceContextForPosition(state, position, activeNode);
+  return blockControlsContext ? createSurfaceContext(BLOCK_CONTROL_UI_CONTEXT, blockControlsContext) : undefined;
+};
+export var getSurfaceNodePositions = function getSurfaceNodePositions(state, resolvedSurface, activeNode) {
+  var from = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 0;
+  var to = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : state.doc.content.size;
+  var root = resolvedSurface.root,
+    childrenMap = resolvedSurface.childrenMap;
+  if (!root) {
+    return [];
+  }
+  var positions = [];
+  var start = Math.max(0, from);
+  var end = Math.min(state.doc.content.size, Math.max(start, to));
+  state.doc.nodesBetween(start, end, function (node, position) {
+    if (node.isBlock && willComponentRender(root, childrenMap, createSurfaceContextAtPosition(state, position, activeNode))) {
+      positions.push(position);
+    }
+  });
+  return positions;
+};
+var hasActiveNodeChanged = function hasActiveNodeChanged(previousActiveNode, activeNode) {
+  return (previousActiveNode === null || previousActiveNode === void 0 ? void 0 : previousActiveNode.pos) !== (activeNode === null || activeNode === void 0 ? void 0 : activeNode.pos) || (previousActiveNode === null || previousActiveNode === void 0 ? void 0 : previousActiveNode.nodeType) !== (activeNode === null || activeNode === void 0 ? void 0 : activeNode.nodeType) || (previousActiveNode === null || previousActiveNode === void 0 ? void 0 : previousActiveNode.rootPos) !== (activeNode === null || activeNode === void 0 ? void 0 : activeNode.rootPos);
+};
+export var updateSurfaceNodePositions = function updateSurfaceNodePositions(_ref) {
+  var activeNode = _ref.activeNode,
+    currentPositions = _ref.currentPositions,
+    from = _ref.from,
+    newState = _ref.newState,
+    previousActiveNode = _ref.previousActiveNode,
+    resolvedSurface = _ref.resolvedSurface,
+    to = _ref.to,
+    tr = _ref.tr;
+  var activeNodeChanged = hasActiveNodeChanged(previousActiveNode, activeNode);
+  if (!tr.docChanged && !activeNodeChanged) {
+    return currentPositions;
+  }
+  var nextActiveNode = activeNode !== null && activeNode !== void 0 ? activeNode : undefined;
+  if (activeNodeChanged) {
+    return getSurfaceNodePositions(newState, resolvedSurface, nextActiveNode);
+  }
+  var root = resolvedSurface.root,
+    childrenMap = resolvedSurface.childrenMap;
+  var mappedPositions = currentPositions.map(function (position) {
+    return tr.mapping.mapResult(position, -1);
+  }).filter(function (result) {
+    return !result.deleted;
+  }).map(function (result) {
+    return result.pos;
+  }).filter(function (position) {
+    var node = newState.doc.nodeAt(position);
+    return Boolean((node === null || node === void 0 ? void 0 : node.isBlock) && root && willComponentRender(root, childrenMap, createSurfaceContextAtPosition(newState, position, nextActiveNode)));
+  });
+  var changedPositions = getSurfaceNodePositions(newState, resolvedSurface, nextActiveNode, from - 1, to + 1);
+  return Array.from(new Set([].concat(_toConsumableArray(mappedPositions), _toConsumableArray(changedPositions)))).sort(function (first, second) {
+    return first - second;
+  });
+};

package/dist/esm/ui/block-controls-left-surface-targets.js

@@ -0,0 +1,39 @@
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+/** Combines hover-driven and stored surface positions into one deduplicated list. */
+export var getBlockControlsLeftSurfaceTargets = function getBlockControlsLeftSurfaceTargets(activeNode, storedPositions) {
+  var targetsByPosition = new Map();
+  var _iterator = _createForOfIteratorHelper(storedPositions),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var position = _step.value;
+      targetsByPosition.set(position, {
+        position: position,
+        source: 'stored'
+      });
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  if (activeNode) {
+    var _activeNode$rootPos;
+    var rootPosition = (_activeNode$rootPos = activeNode.rootPos) !== null && _activeNode$rootPos !== void 0 ? _activeNode$rootPos : activeNode.pos;
+    targetsByPosition.set(rootPosition, {
+      position: rootPosition,
+      source: 'root'
+    });
+    if (activeNode.pos !== rootPosition) {
+      targetsByPosition.set(activeNode.pos, {
+        position: activeNode.pos,
+        source: 'active'
+      });
+    }
+  }
+  return Array.from(targetsByPosition.values()).sort(function (first, second) {
+    return first.position - second.position;
+  });
+};

package/dist/esm/ui/block-controls-left-surface.js

@@ -0,0 +1,38 @@
+/* block-controls-left-surface.tsx generated by @compiled/babel-plugin v2.0.0 */
+import "./block-controls-left-surface.compiled.css";
+import { ax, ix } from "@compiled/react/runtime";
+import React from 'react';
+import { BLOCK_CONTROLS_LEFT_SURFACE } from '@atlaskit/editor-common/block-controls/surface-keys';
+import { SurfaceRenderer, willSurfaceRender } from '@atlaskit/editor-ui-control-model/surface-renderer';
+import { VisibilityContainer } from './visibility-container';
+var leftSurfaceStyles = null;
+/** Renders one left block-controls surface at a document position. */
+export var BlockControlsLeftSurface = function BlockControlsLeftSurface(_ref) {
+  var api = _ref.api,
+    components = _ref.components,
+    forceVisibleOnMouseOut = _ref.forceVisibleOnMouseOut,
+    placement = _ref.placement,
+    source = _ref.source,
+    surfaceContext = _ref.surfaceContext;
+  if (!placement || !willSurfaceRender(components, BLOCK_CONTROLS_LEFT_SURFACE, surfaceContext)) {
+    return null;
+  }
+  var surface = /*#__PURE__*/React.createElement(SurfaceRenderer, {
+    components: components,
+    surface: BLOCK_CONTROLS_LEFT_SURFACE,
+    surfaceContext: surfaceContext
+  });
+  return /*#__PURE__*/React.createElement("div", {
+    "data-editor-block-controls-surface": true,
+    "data-testid": source === 'stored' ? 'block-controls-left-surface-stored' : source === 'active' ? 'block-controls-left-surface-active' : 'block-controls-left-surface'
+    // eslint-disable-next-line @atlaskit/ui-styling-standard/enforce-style-prop -- Placement is resolved from the target node's runtime DOM geometry.
+    ,
+    style: placement,
+    className: ax(["_zulpv77o _4cvr1h6o _1e0c1txw _kqswstnw _1pbyb4wl"])
+  }, /*#__PURE__*/React.createElement(VisibilityContainer, {
+    api: api,
+    controlSide: "left",
+    forceVisibleOnMouseOut: forceVisibleOnMouseOut,
+    shouldUseDisplayContents: true
+  }, surface));
+};

package/dist/esm/ui/block-controls-left-surfaces.js

@@ -0,0 +1,207 @@
+/* block-controls-left-surfaces.tsx generated by @compiled/babel-plugin v2.0.0 */
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import { ax, ix } from "@compiled/react/runtime";
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+import React, { useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { bind } from 'bind-event-listener';
+import { getDocument } from '@atlaskit/browser-apis';
+import { BLOCK_CONTROL_UI_CONTEXT } from '@atlaskit/editor-common/block-controls/block-control-ui-context';
+import { BLOCK_CONTROLS_LEFT_SURFACE } from '@atlaskit/editor-common/block-controls/surface-keys';
+import { useSharedPluginStateWithSelector } from '@atlaskit/editor-common/hooks';
+import { createSurfaceContext } from '@atlaskit/editor-ui-control-model/types';
+import { getNodeTypeWithLevel } from '../pm-plugins/decorations-common';
+import { createBlockControlsSurfaceContext, createBlockControlsSurfaceContextForPosition } from './block-controls-surface-context';
+import { BlockControlsLeftSurface } from './block-controls-left-surface';
+import { getBlockControlsLeftSurfaceTargets } from './block-controls-left-surface-targets';
+import { getNodeContentElement } from './utils/get-node-content-element';
+import { getAbsoluteSurfacePlacement, getSurfacePlacement } from './utils/get-surface-placement';
+var EMPTY_SURFACE_POSITIONS = [];
+var EMPTY_SURFACE_COMPONENTS = [];
+export var BlockControlsLeftSurfaces = function BlockControlsLeftSurfaces(_ref) {
+  var _api$uiControlRegistr, _api$uiControlRegistr2;
+  var api = _ref.api,
+    editorView = _ref.editorView;
+  var _useSharedPluginState = useSharedPluginStateWithSelector(api, ['blockControls'], function (states) {
+      var _states$blockControls, _states$blockControls2, _states$blockControls3;
+      return {
+        activeNode: (_states$blockControls = states.blockControlsState) === null || _states$blockControls === void 0 ? void 0 : _states$blockControls.activeNode,
+        surfaceNodePositions: (_states$blockControls2 = (_states$blockControls3 = states.blockControlsState) === null || _states$blockControls3 === void 0 ? void 0 : _states$blockControls3.surfaceNodePositions) !== null && _states$blockControls2 !== void 0 ? _states$blockControls2 : EMPTY_SURFACE_POSITIONS
+      };
+    }),
+    activeNode = _useSharedPluginState.activeNode,
+    surfaceNodePositions = _useSharedPluginState.surfaceNodePositions;
+  var components = (_api$uiControlRegistr = (_api$uiControlRegistr2 = api.uiControlRegistry) === null || _api$uiControlRegistr2 === void 0 ? void 0 : _api$uiControlRegistr2.actions.getComponents(BLOCK_CONTROLS_LEFT_SURFACE)) !== null && _api$uiControlRegistr !== void 0 ? _api$uiControlRegistr : EMPTY_SURFACE_COMPONENTS;
+  var targets = useMemo(function () {
+    return getBlockControlsLeftSurfaceTargets(activeNode, surfaceNodePositions);
+  }, [activeNode, surfaceNodePositions]);
+  var surfaces = useMemo(function () {
+    return targets.flatMap(function (target) {
+      var context = target.source === 'stored' ? createBlockControlsSurfaceContextForPosition(editorView.state, target.position, activeNode) : createBlockControlsSurfaceContext(editorView, activeNode, target.source);
+      if (!context) {
+        return [];
+      }
+      var surfaceContext = createSurfaceContext(BLOCK_CONTROL_UI_CONTEXT, context);
+      return [_objectSpread(_objectSpread({}, target), {}, {
+        blockControlsContext: context,
+        surfaceContext: surfaceContext
+      })];
+    });
+  }, [activeNode, editorView, targets]);
+  var _useState = useState(new Map()),
+    _useState2 = _slicedToArray(_useState, 2),
+    placements = _useState2[0],
+    setPlacements = _useState2[1];
+  var animationFrameRef = useRef(undefined);
+  useLayoutEffect(function () {
+    var _getDocument;
+    if (surfaces.length === 0) {
+      setPlacements(new Map());
+      return;
+    }
+    var measurementTargets = surfaces.flatMap(function (_ref2) {
+      var blockControlsContext = _ref2.blockControlsContext,
+        position = _ref2.position;
+      var targetNodeElement = editorView.nodeDOM(blockControlsContext.targetNode.pos);
+      var targetElementRoot = targetNodeElement instanceof HTMLElement ? targetNodeElement : targetNodeElement === null || targetNodeElement === void 0 ? void 0 : targetNodeElement.parentElement;
+      if (!targetElementRoot) {
+        return [];
+      }
+      return [{
+        blockControlsContext: blockControlsContext,
+        position: position,
+        targetElement: getNodeContentElement(targetElementRoot, blockControlsContext.targetNode.type.name),
+        targetElementRoot: targetElementRoot
+      }];
+    });
+    var offsetParent = editorView.dom.offsetParent;
+    var isDocumentOffsetParent = !offsetParent || offsetParent === ((_getDocument = getDocument()) === null || _getDocument === void 0 ? void 0 : _getDocument.body);
+    var scrollingOffsetParent = offsetParent instanceof HTMLElement && !isDocumentOffsetParent ? offsetParent : undefined;
+    var updatePositions = function updatePositions() {
+      var _scrollingOffsetParen, _scrollingOffsetParen2;
+      animationFrameRef.current = undefined;
+      var offsetParentRect = offsetParent === null || offsetParent === void 0 ? void 0 : offsetParent.getBoundingClientRect();
+      var offsetParentScrollTop = (_scrollingOffsetParen = scrollingOffsetParent === null || scrollingOffsetParent === void 0 ? void 0 : scrollingOffsetParent.scrollTop) !== null && _scrollingOffsetParen !== void 0 ? _scrollingOffsetParen : window.scrollY;
+      var offsetParentScrollLeft = (_scrollingOffsetParen2 = scrollingOffsetParent === null || scrollingOffsetParent === void 0 ? void 0 : scrollingOffsetParent.scrollLeft) !== null && _scrollingOffsetParen2 !== void 0 ? _scrollingOffsetParen2 : window.scrollX;
+      var nextPlacements = new Map();
+      var _iterator = _createForOfIteratorHelper(measurementTargets),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var _targetElementRoot$ge;
+          var _step$value = _step.value,
+            blockControlsContext = _step$value.blockControlsContext,
+            position = _step$value.position,
+            targetElement = _step$value.targetElement,
+            targetElementRoot = _step$value.targetElementRoot;
+          if (!targetElementRoot.isConnected || !targetElement.isConnected) {
+            continue;
+          }
+          var placement = getSurfacePlacement({
+            layout: (_targetElementRoot$ge = targetElementRoot.getAttribute('layout')) !== null && _targetElementRoot$ge !== void 0 ? _targetElementRoot$ge : '',
+            nodeRect: targetElement.getBoundingClientRect(),
+            nodeType: blockControlsContext.targetNode.type.name,
+            nodeTypeWithLevel: getNodeTypeWithLevel(blockControlsContext.targetNode.node),
+            parentNodeType: blockControlsContext.targetNode.parentType === 'doc' ? undefined : blockControlsContext.targetNode.parentType
+          });
+          nextPlacements.set(position, getAbsoluteSurfacePlacement({
+            offsetParentRect: offsetParentRect,
+            offsetParentScrollLeft: offsetParentScrollLeft,
+            offsetParentScrollTop: offsetParentScrollTop,
+            placement: placement
+          }));
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      setPlacements(nextPlacements);
+    };
+    var schedulePositionUpdate = function schedulePositionUpdate() {
+      if (animationFrameRef.current === undefined) {
+        animationFrameRef.current = requestAnimationFrame(updatePositions);
+      }
+    };
+    updatePositions();
+    var resizeObserver = new ResizeObserver(schedulePositionUpdate);
+    var observedElements = new Set([editorView.dom]);
+    var _iterator2 = _createForOfIteratorHelper(measurementTargets),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var targetElement = _step2.value.targetElement;
+        observedElements.add(targetElement);
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+    if (offsetParent instanceof HTMLElement) {
+      observedElements.add(offsetParent);
+    }
+    observedElements.forEach(function (element) {
+      return resizeObserver.observe(element);
+    });
+    var unbindWindowResize = bind(window, {
+      type: 'resize',
+      listener: schedulePositionUpdate
+    });
+    var unbindWindowScroll = bind(window, {
+      type: 'scroll',
+      listener: schedulePositionUpdate,
+      options: {
+        capture: true,
+        passive: true
+      }
+    });
+    var visualViewport = window.visualViewport;
+    var unbindVisualViewportResize = visualViewport ? bind(visualViewport, {
+      type: 'resize',
+      listener: schedulePositionUpdate
+    }) : undefined;
+    var unbindVisualViewportScroll = visualViewport ? bind(visualViewport, {
+      type: 'scroll',
+      listener: schedulePositionUpdate
+    }) : undefined;
+    var unbindTransitionEnd = bind(editorView.dom, {
+      type: 'transitionend',
+      listener: schedulePositionUpdate,
+      options: {
+        capture: true
+      }
+    });
+    return function () {
+      if (animationFrameRef.current !== undefined) {
+        cancelAnimationFrame(animationFrameRef.current);
+        animationFrameRef.current = undefined;
+      }
+      resizeObserver.disconnect();
+      unbindWindowResize();
+      unbindWindowScroll();
+      unbindVisualViewportResize === null || unbindVisualViewportResize === void 0 || unbindVisualViewportResize();
+      unbindVisualViewportScroll === null || unbindVisualViewportScroll === void 0 || unbindVisualViewportScroll();
+      unbindTransitionEnd();
+    };
+  }, [editorView, surfaces]);
+  return /*#__PURE__*/React.createElement(React.Fragment, null, surfaces.map(function (_ref3) {
+    var _activeNode$handleOpt;
+    var position = _ref3.position,
+      source = _ref3.source,
+      surfaceContext = _ref3.surfaceContext;
+    return /*#__PURE__*/React.createElement(BlockControlsLeftSurface, {
+      api: api,
+      components: components,
+      forceVisibleOnMouseOut: Boolean(activeNode === null || activeNode === void 0 || (_activeNode$handleOpt = activeNode.handleOptions) === null || _activeNode$handleOpt === void 0 ? void 0 : _activeNode$handleOpt.isFocused),
+      key: position,
+      placement: placements.get(position),
+      source: source,
+      surfaceContext: surfaceContext
+    });
+  }));
+};

package/dist/esm/ui/block-controls-surface-context.js

@@ -1,12 +1,12 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-var getNodeContext = function getNodeContext(view, pos) {
-  var node = view.state.doc.nodeAt(pos);
+var getNodeContext = function getNodeContext(state, pos) {
+  var node = state.doc.nodeAt(pos);
   if (!node) {
     return undefined;
   }
-  var $pos = view.state.doc.resolve(pos);
+  var $pos = state.doc.resolve(pos);
   var ancestors = [];
   for (var depth = 0; depth <= $pos.depth; depth++) {
     var ancestor = $pos.node(depth);
@@ -29,26 +29,32 @@ var getNodeContext = function getNodeContext(view, pos) {
     }
   };
 };
-export var createBlockControlsSurfaceContext = function createBlockControlsSurfaceContext(view, activeNode) {
-  var _activeNode$rootPos, _activeNode$rootNodeT;
-  var target = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'root';
-  if (!activeNode) {
-    return undefined;
-  }
-  var rootPos = (_activeNode$rootPos = activeNode.rootPos) !== null && _activeNode$rootPos !== void 0 ? _activeNode$rootPos : activeNode.pos;
-  var activeNodeContext = getNodeContext(view, activeNode.pos);
-  var rootNodeContext = getNodeContext(view, rootPos);
-  if (!activeNodeContext || !rootNodeContext) {
+export var createBlockControlsSurfaceContextForPosition = function createBlockControlsSurfaceContextForPosition(state, targetPos, activeNode) {
+  var _activeNode$rootPos, _getNodeContext, _activeNode$rootNodeT;
+  var targetNodeContext = getNodeContext(state, targetPos);
+  if (!targetNodeContext) {
     return undefined;
   }
+  var activeNodeContext = activeNode ? getNodeContext(state, activeNode.pos) : undefined;
+  var rootPos = activeNode ? (_activeNode$rootPos = activeNode.rootPos) !== null && _activeNode$rootPos !== void 0 ? _activeNode$rootPos : activeNode.pos : targetPos;
+  var rootNodeContext = (_getNodeContext = getNodeContext(state, rootPos)) !== null && _getNodeContext !== void 0 ? _getNodeContext : targetNodeContext;
   return {
-    activeNode: _objectSpread(_objectSpread({}, activeNodeContext), {}, {
+    activeNode: activeNode && activeNodeContext ? _objectSpread(_objectSpread({}, activeNodeContext), {}, {
       rootPos: rootPos,
       rootType: {
         name: (_activeNode$rootNodeT = activeNode.rootNodeType) !== null && _activeNode$rootNodeT !== void 0 ? _activeNode$rootNodeT : rootNodeContext.type.name
       }
-    }),
+    }) : undefined,
     rootNode: rootNodeContext,
-    targetNode: target === 'active' ? activeNodeContext : rootNodeContext
+    targetNode: targetNodeContext
   };
+};
+export var createBlockControlsSurfaceContext = function createBlockControlsSurfaceContext(view, activeNode) {
+  var _activeNode$rootPos2;
+  var target = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'root';
+  if (!activeNode) {
+    return undefined;
+  }
+  var rootPos = (_activeNode$rootPos2 = activeNode.rootPos) !== null && _activeNode$rootPos2 !== void 0 ? _activeNode$rootPos2 : activeNode.pos;
+  return createBlockControlsSurfaceContextForPosition(view.state, target === 'active' ? activeNode.pos : rootPos, activeNode);
 };

package/dist/types/blockControlsPluginType.d.ts

@@ -78,6 +78,7 @@ export interface PluginState {
     menuTriggerByNode?: TriggerByNode;
     multiSelectDnD?: MultiSelectDnD;
     preservedSelection?: Selection;
+    surfaceNodePositions: number[];
 }
 export type ReleaseHiddenDecoration = () => boolean | undefined;
 export type BlockControlsPluginConfig = {
@@ -109,6 +110,7 @@ export type BlockControlsSharedState = {
     preservedSelection?: Selection;
     /** Whether left/right hover split is enabled (from plugin config) */
     rightSideControlsEnabled?: boolean;
+    surfaceNodePositions?: number[];
 } | undefined;
 export type HandleOptions = {
     isFocused: boolean;

package/dist/types/pm-plugins/main.d.ts

@@ -5,6 +5,7 @@ import type { ExtractInjectionAPI } from '@atlaskit/editor-common/types';
 import type { EditorState, ReadonlyTransaction, Transaction } from '@atlaskit/editor-prosemirror/state';
 import { PluginKey } from '@atlaskit/editor-prosemirror/state';
 import { DecorationSet } from '@atlaskit/editor-prosemirror/view';
+import type { ResolvedSurface } from '@atlaskit/editor-ui-control-model/surface-renderer/types';
 import type { ActiveDropTargetNode, BlockControlsMeta, BlockControlsPlugin, MultiSelectDnD, NodeDecorationFactory, PluginState } from '../blockControlsPluginType';
 import { AnchorRectCache } from './utils/anchor-utils';
 export declare const key: PluginKey<PluginState>;
@@ -14,10 +15,11 @@ export interface FlagType {
      * its replacement when this is false.
      */
     legacyDragHandleEnabled: boolean;
+    surfaceNodePositionsEnabled: boolean;
     toolbarFlagsEnabled: boolean;
 }
 export declare const getDecorations: (state: EditorState) => DecorationSet | undefined;
-export declare const apply: (api: ExtractInjectionAPI<BlockControlsPlugin> | undefined, formatMessage: IntlShape['formatMessage'], tr: ReadonlyTransaction, currentState: PluginState, newState: EditorState, flags: FlagType, nodeViewPortalProviderAPI: PortalProviderAPI, nodeDecorationRegistry: NodeDecorationFactory[], rightSideControlsEnabled?: boolean, quickInsertButtonEnabled?: boolean, anchorRectCache?: AnchorRectCache, resizeObserverWidth?: ResizeObserver, pragmaticCleanup?: (() => void) | null) => PluginState | {
+export declare const apply: (api: ExtractInjectionAPI<BlockControlsPlugin> | undefined, formatMessage: IntlShape['formatMessage'], tr: ReadonlyTransaction, currentState: PluginState, newState: EditorState, flags: FlagType, nodeViewPortalProviderAPI: PortalProviderAPI, nodeDecorationRegistry: NodeDecorationFactory[], rightSideControlsEnabled?: boolean, quickInsertButtonEnabled?: boolean, anchorRectCache?: AnchorRectCache, resizeObserverWidth?: ResizeObserver, pragmaticCleanup?: (() => void) | null, resolvedSurface?: ResolvedSurface) => PluginState | {
     activeDropTargetNode: ActiveDropTargetNode | undefined;
     activeNode: any;
     blockMenuOptions: {
@@ -40,8 +42,9 @@ export declare const apply: (api: ExtractInjectionAPI<BlockControlsPlugin> | und
     menuTriggerBy: any;
     menuTriggerByNode: any;
     multiSelectDnD: MultiSelectDnD | undefined;
+    surfaceNodePositions: number[];
 };
-export declare const createPlugin: (api: ExtractInjectionAPI<BlockControlsPlugin> | undefined, getIntl: () => IntlShape, nodeViewPortalProviderAPI: PortalProviderAPI, nodeDecorationRegistry: NodeDecorationFactory[], rightSideControlsEnabled?: boolean, quickInsertButtonEnabled?: boolean, legacyDragHandleEnabled?: boolean) => SafePlugin<PluginState | {
+export declare const createPlugin: (api: ExtractInjectionAPI<BlockControlsPlugin> | undefined, getIntl: () => IntlShape, nodeViewPortalProviderAPI: PortalProviderAPI, nodeDecorationRegistry: NodeDecorationFactory[], rightSideControlsEnabled?: boolean, quickInsertButtonEnabled?: boolean, legacyDragHandleEnabled?: boolean, surfaceNodePositionsEnabled?: boolean) => SafePlugin<PluginState | {
     activeDropTargetNode: ActiveDropTargetNode | undefined;
     activeNode: any;
     blockMenuOptions: {
@@ -64,5 +67,6 @@ export declare const createPlugin: (api: ExtractInjectionAPI<BlockControlsPlugin
     menuTriggerBy: any;
     menuTriggerByNode: any;
     multiSelectDnD: MultiSelectDnD | undefined;
+    surfaceNodePositions: number[];
 }>;
 export declare const getBlockControlsMeta: (tr: Transaction | ReadonlyTransaction) => BlockControlsMeta | undefined;

package/dist/types/pm-plugins/utils/surface-node-positions.d.ts

@@ -0,0 +1,14 @@
+import type { EditorState, ReadonlyTransaction } from '@atlaskit/editor-prosemirror/state';
+import type { ResolvedSurface } from '@atlaskit/editor-ui-control-model/surface-renderer/types';
+import type { ActiveNode } from '../../blockControlsPluginType';
+export declare const getSurfaceNodePositions: (state: EditorState, resolvedSurface: ResolvedSurface, activeNode?: ActiveNode, from?: number, to?: number) => number[];
+export declare const updateSurfaceNodePositions: ({ activeNode, currentPositions, from, newState, previousActiveNode, resolvedSurface, to, tr, }: {
+    activeNode: ActiveNode | null | undefined;
+    currentPositions: number[];
+    from: number;
+    newState: EditorState;
+    previousActiveNode: ActiveNode | null | undefined;
+    resolvedSurface: ResolvedSurface;
+    to: number;
+    tr: ReadonlyTransaction;
+}) => number[];

package/dist/types/ui/block-controls-left-surface-targets.d.ts

@@ -0,0 +1,7 @@
+import type { ActiveNode } from '../blockControlsPluginType';
+export type BlockControlsLeftSurfaceTarget = {
+    position: number;
+    source: 'active' | 'root' | 'stored';
+};
+/** Combines hover-driven and stored surface positions into one deduplicated list. */
+export declare const getBlockControlsLeftSurfaceTargets: (activeNode: ActiveNode | undefined, storedPositions: readonly number[]) => readonly BlockControlsLeftSurfaceTarget[];

package/dist/types/ui/block-controls-left-surface.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @jsxRuntime classic
+ * @jsx jsx
+ * @jsxFrag React.Fragment
+ */
+import React from 'react';
+import type { ExtractInjectionAPI } from '@atlaskit/editor-common/types';
+import { SurfaceRenderer } from '@atlaskit/editor-ui-control-model/surface-renderer';
+import type { SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
+import type { BlockControlsPlugin } from '../blockControlsPluginType';
+import type { BlockControlsLeftSurfaceTarget } from './block-controls-left-surface-targets';
+import type { SurfacePlacement } from './utils/get-surface-placement';
+type BlockControlsLeftSurfaceProps = {
+    api: ExtractInjectionAPI<BlockControlsPlugin>;
+    components: React.ComponentProps<typeof SurfaceRenderer>['components'];
+    forceVisibleOnMouseOut: boolean;
+    placement: SurfacePlacement | undefined;
+    source: BlockControlsLeftSurfaceTarget['source'];
+    surfaceContext: SurfaceContext;
+};
+/** Renders one left block-controls surface at a document position. */
+export declare const BlockControlsLeftSurface: ({ api, components, forceVisibleOnMouseOut, placement, source, surfaceContext, }: BlockControlsLeftSurfaceProps) => React.JSX.Element | null;
+export {};

package/dist/types/ui/{block-controls-surface.d.ts → block-controls-left-surfaces.d.ts}

@@ -11,5 +11,5 @@ type Props = {
     api: ExtractInjectionAPI<BlockControlsPlugin>;
     editorView: EditorView;
 };
-export declare const BlockControlsSurface: ({ api, editorView }: Props) => React.JSX.Element | null;
+export declare const BlockControlsLeftSurfaces: ({ api, editorView }: Props) => React.JSX.Element | null;
 export {};