@atlaskit/editor-plugin-selection-extension 10.0.0 → 10.0.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @atlaskit/editor-plugin-selection-extension
 
+## 10.0.2
+
+### Patch Changes
+
+- [`5d14fe3afd499`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/5d14fe3afd499) -
+  Implement `SelectionRanges` for multiple nodes selection to indicate actual selection ranges
+- Updated dependencies
+
+## 10.0.1
+
+### Patch Changes
+
+- [`b429c01ce6af9`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b429c01ce6af9) -
+  icon migration entry point update
+- Updated dependencies
+
 ## 10.0.0
 
 ### Patch Changes

package/dist/cjs/pm-plugins/utils/selection-helpers.js

@@ -1,17 +1,118 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.wrapNodesInDoc = exports.getSelectionInfoFromSameNode = exports.getSelectionInfo = exports.getCommonParentContainer = void 0;
+exports.wrapNodesInDoc = exports.getSelectionInfoFromSameNode = exports.getSelectionInfo = exports.getCommonParentContainer = exports.buildSelectionRanges = void 0;
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _monitoring = require("@atlaskit/editor-common/monitoring");
 var _model = require("@atlaskit/editor-prosemirror/model");
 var LIST_ITEM_TYPES = new Set(['taskItem', 'decisionItem', 'listItem']);
 var LIST_NODE_TYPES = new Set(['taskList', 'bulletList', 'orderedList', 'decisionList']);
 
 /**
- * Find the depth of the deepest common ancestor node.
+ * Build a JSON pointer path for a node within the selectedNode structure.
+ * @param pathIndices - Array of content indices representing the path to the node
  */
+var buildJsonPointer = function buildJsonPointer(pathIndices) {
+  return pathIndices.map(function (index) {
+    return "/content/".concat(index);
+  }).join('');
+};
+
+/**
+ * Build selection ranges for multi-node selections.
+ * This function traverses the selectedNode and creates JSON pointer-based ranges
+ * that describe what parts of the selectedNode are included in the selection.
+ */
+var buildSelectionRanges = exports.buildSelectionRanges = function buildSelectionRanges(selectedNode, selectedNodePos, $from, $to) {
+  var selectionStart = $from.pos;
+  var selectionEnd = $to.pos;
+  var tokenOffset = selectedNode.type.name === 'doc' ? 0 : 1;
+  var nodeStart = selectedNodePos + tokenOffset;
+  var nodeEnd = selectedNodePos + selectedNode.nodeSize - tokenOffset;
+
+  // If selection spans entire content, return undefined (complete block selection)
+  if (selectionStart <= nodeStart && selectionEnd >= nodeEnd) {
+    return undefined;
+  }
+  var selectionRanges = [];
+
+  // Traverse the selectedNode and find all nodes/text within the selection range
+  var _traverse = function traverse(node, nodePos, path) {
+    var nodeEndPos = nodePos + node.nodeSize;
+
+    // Skip nodes completely before or after selection
+    if (nodeEndPos <= selectionStart || nodePos >= selectionEnd) {
+      return;
+    }
+    if (node.isText) {
+      var _node$text;
+      var textStart = nodePos;
+      var textEnd = nodePos + (((_node$text = node.text) === null || _node$text === void 0 ? void 0 : _node$text.length) || 0);
+      var rangeStart = Math.max(textStart, selectionStart);
+      var rangeEnd = Math.min(textEnd, selectionEnd);
+      if (rangeStart < rangeEnd) {
+        var pointer = "".concat(buildJsonPointer(path), "/text");
+        selectionRanges.push({
+          start: {
+            pointer: pointer,
+            position: rangeStart - textStart
+          },
+          end: {
+            pointer: pointer,
+            position: rangeEnd - textStart
+          }
+        });
+      }
+    } else if (node.content.size > 0) {
+      var contentStart = nodePos + 1;
+      var contentEnd = nodeEndPos - 1;
+      var isWholeBlockSelected = node.isBlock && !node.isTextblock && !LIST_NODE_TYPES.has(node.type.name) && selectionStart <= contentStart && selectionEnd >= contentEnd;
+      if (isWholeBlockSelected) {
+        var _pointer = buildJsonPointer(path);
+        selectionRanges.push({
+          start: {
+            pointer: _pointer
+          },
+          end: {
+            pointer: _pointer
+          }
+        });
+      } else {
+        // Traverse children for textblocks, lists, or partial selections
+        var _childPos = nodePos + 1;
+        for (var i = 0; i < node.content.childCount; i++) {
+          _traverse(node.content.child(i), _childPos, [].concat((0, _toConsumableArray2.default)(path), [i]));
+          _childPos += node.content.child(i).nodeSize;
+        }
+      }
+    } else if (nodePos >= selectionStart && nodeEndPos <= selectionEnd) {
+      // Handle leaf nodes (e.g., hardBreak, image)
+      var _pointer2 = buildJsonPointer(path);
+      selectionRanges.push({
+        start: {
+          pointer: _pointer2
+        },
+        end: {
+          pointer: _pointer2
+        }
+      });
+    }
+  };
+
+  // Traverse each child of the selectedNode
+  var childPos = nodeStart;
+  for (var i = 0; i < selectedNode.content.childCount; i++) {
+    var child = selectedNode.content.child(i);
+    _traverse(child, childPos, [i]);
+    childPos += child.nodeSize;
+  }
+  return selectionRanges.length > 0 ? selectionRanges : undefined;
+};
+
+/** Find the depth of the deepest common ancestor node. */
 var getCommonAncestorDepth = function getCommonAncestorDepth($from, $to) {
   var minDepth = Math.min($from.depth, $to.depth);
   for (var d = 0; d <= minDepth; d++) {
@@ -113,15 +214,19 @@ var getSelectionInfo = exports.getSelectionInfo = function getSelectionInfo(sele
       parentNode = _getCommonParentConta.node,
       parentNodePos = _getCommonParentConta.pos;
     if (parentNode) {
+      var _selectionRanges = buildSelectionRanges(parentNode, parentNodePos, $from, $to);
       return {
         selectedNode: parentNode,
-        nodePos: parentNodePos
+        nodePos: parentNodePos,
+        selectionRanges: _selectionRanges
       };
     }
     var nodePos = $from.before();
+    var _selectionRanges2 = buildSelectionRanges($from.node(), nodePos, $from, $to);
     return {
       selectedNode: $from.node(),
-      nodePos: nodePos
+      nodePos: nodePos,
+      selectionRanges: _selectionRanges2
     };
   }
 
@@ -134,24 +239,26 @@ var getSelectionInfo = exports.getSelectionInfo = function getSelectionInfo(sele
     };
   }
   if (range.parent.type.name !== 'doc') {
-    // If it's a list OR list item, check for topmost list parent
+    // For lists, find topmost list parent; otherwise use immediate parent
     if (LIST_NODE_TYPES.has(range.parent.type.name) || LIST_ITEM_TYPES.has(range.parent.type.name)) {
       var _getCommonParentConta2 = getCommonParentContainer($from, $to),
         topList = _getCommonParentConta2.node,
         topListPos = _getCommonParentConta2.pos;
       if (topList) {
+        var _selectionRanges3 = buildSelectionRanges(topList, topListPos, $from, $to);
         return {
           selectedNode: topList,
-          nodePos: topListPos
+          nodePos: topListPos,
+          selectionRanges: _selectionRanges3
         };
       }
     }
-
-    // For non-list containers (panel, expand, etc.), return the immediate parent
     var _nodePos = range.depth > 0 ? $from.before(range.depth) : 0;
+    var _selectionRanges4 = buildSelectionRanges(range.parent, _nodePos, $from, $to);
     return {
       selectedNode: range.parent,
-      nodePos: _nodePos
+      nodePos: _nodePos,
+      selectionRanges: _selectionRanges4
     };
   }
 
@@ -161,8 +268,10 @@ var getSelectionInfo = exports.getSelectionInfo = function getSelectionInfo(sele
     nodes.push(range.parent.child(i));
   }
   var selectedNode = wrapNodesInDoc(schema, nodes);
+  var selectionRanges = buildSelectionRanges(selectedNode, range.start, $from, $to);
   return {
     selectedNode: selectedNode,
-    nodePos: range.start
+    nodePos: range.start,
+    selectionRanges: selectionRanges
   };
 };

package/dist/cjs/ui/toolbar/SelectionExtensionDropdownMenuButton.js

@@ -10,7 +10,7 @@ var _reactIntlNext = require("react-intl-next");
 var _messages = require("@atlaskit/editor-common/messages");
 var _uiMenu = require("@atlaskit/editor-common/ui-menu");
 var _apps = _interopRequireDefault(require("@atlaskit/icon/core/apps"));
-var _chevronDown = _interopRequireDefault(require("@atlaskit/icon/core/migration/chevron-down"));
+var _chevronDown = _interopRequireDefault(require("@atlaskit/icon/core/chevron-down"));
 var SelectionExtensionDropdownMenuButtonComponent = function SelectionExtensionDropdownMenuButtonComponent(_ref) {
   var onClick = _ref.onClick,
     selected = _ref.selected,

package/dist/es2019/pm-plugins/utils/selection-helpers.js

@@ -4,8 +4,103 @@ const LIST_ITEM_TYPES = new Set(['taskItem', 'decisionItem', 'listItem']);
 const LIST_NODE_TYPES = new Set(['taskList', 'bulletList', 'orderedList', 'decisionList']);
 
 /**
- * Find the depth of the deepest common ancestor node.
+ * Build a JSON pointer path for a node within the selectedNode structure.
+ * @param pathIndices - Array of content indices representing the path to the node
  */
+const buildJsonPointer = pathIndices => pathIndices.map(index => `/content/${index}`).join('');
+
+/**
+ * Build selection ranges for multi-node selections.
+ * This function traverses the selectedNode and creates JSON pointer-based ranges
+ * that describe what parts of the selectedNode are included in the selection.
+ */
+export const buildSelectionRanges = (selectedNode, selectedNodePos, $from, $to) => {
+  const selectionStart = $from.pos;
+  const selectionEnd = $to.pos;
+  const tokenOffset = selectedNode.type.name === 'doc' ? 0 : 1;
+  const nodeStart = selectedNodePos + tokenOffset;
+  const nodeEnd = selectedNodePos + selectedNode.nodeSize - tokenOffset;
+
+  // If selection spans entire content, return undefined (complete block selection)
+  if (selectionStart <= nodeStart && selectionEnd >= nodeEnd) {
+    return undefined;
+  }
+  const selectionRanges = [];
+
+  // Traverse the selectedNode and find all nodes/text within the selection range
+  const traverse = (node, nodePos, path) => {
+    const nodeEndPos = nodePos + node.nodeSize;
+
+    // Skip nodes completely before or after selection
+    if (nodeEndPos <= selectionStart || nodePos >= selectionEnd) {
+      return;
+    }
+    if (node.isText) {
+      var _node$text;
+      const textStart = nodePos;
+      const textEnd = nodePos + (((_node$text = node.text) === null || _node$text === void 0 ? void 0 : _node$text.length) || 0);
+      const rangeStart = Math.max(textStart, selectionStart);
+      const rangeEnd = Math.min(textEnd, selectionEnd);
+      if (rangeStart < rangeEnd) {
+        const pointer = `${buildJsonPointer(path)}/text`;
+        selectionRanges.push({
+          start: {
+            pointer,
+            position: rangeStart - textStart
+          },
+          end: {
+            pointer,
+            position: rangeEnd - textStart
+          }
+        });
+      }
+    } else if (node.content.size > 0) {
+      const contentStart = nodePos + 1;
+      const contentEnd = nodeEndPos - 1;
+      const isWholeBlockSelected = node.isBlock && !node.isTextblock && !LIST_NODE_TYPES.has(node.type.name) && selectionStart <= contentStart && selectionEnd >= contentEnd;
+      if (isWholeBlockSelected) {
+        const pointer = buildJsonPointer(path);
+        selectionRanges.push({
+          start: {
+            pointer
+          },
+          end: {
+            pointer
+          }
+        });
+      } else {
+        // Traverse children for textblocks, lists, or partial selections
+        let childPos = nodePos + 1;
+        for (let i = 0; i < node.content.childCount; i++) {
+          traverse(node.content.child(i), childPos, [...path, i]);
+          childPos += node.content.child(i).nodeSize;
+        }
+      }
+    } else if (nodePos >= selectionStart && nodeEndPos <= selectionEnd) {
+      // Handle leaf nodes (e.g., hardBreak, image)
+      const pointer = buildJsonPointer(path);
+      selectionRanges.push({
+        start: {
+          pointer
+        },
+        end: {
+          pointer
+        }
+      });
+    }
+  };
+
+  // Traverse each child of the selectedNode
+  let childPos = nodeStart;
+  for (let i = 0; i < selectedNode.content.childCount; i++) {
+    const child = selectedNode.content.child(i);
+    traverse(child, childPos, [i]);
+    childPos += child.nodeSize;
+  }
+  return selectionRanges.length > 0 ? selectionRanges : undefined;
+};
+
+/** Find the depth of the deepest common ancestor node. */
 const getCommonAncestorDepth = ($from, $to) => {
   const minDepth = Math.min($from.depth, $to.depth);
   for (let d = 0; d <= minDepth; d++) {
@@ -112,15 +207,19 @@ export const getSelectionInfo = (selection, schema) => {
       pos: parentNodePos
     } = getCommonParentContainer($from, $to);
     if (parentNode) {
+      const selectionRanges = buildSelectionRanges(parentNode, parentNodePos, $from, $to);
       return {
         selectedNode: parentNode,
-        nodePos: parentNodePos
+        nodePos: parentNodePos,
+        selectionRanges
       };
     }
     const nodePos = $from.before();
+    const selectionRanges = buildSelectionRanges($from.node(), nodePos, $from, $to);
     return {
       selectedNode: $from.node(),
-      nodePos
+      nodePos,
+      selectionRanges
     };
   }
 
@@ -133,25 +232,27 @@ export const getSelectionInfo = (selection, schema) => {
     };
   }
   if (range.parent.type.name !== 'doc') {
-    // If it's a list OR list item, check for topmost list parent
+    // For lists, find topmost list parent; otherwise use immediate parent
     if (LIST_NODE_TYPES.has(range.parent.type.name) || LIST_ITEM_TYPES.has(range.parent.type.name)) {
       const {
         node: topList,
         pos: topListPos
       } = getCommonParentContainer($from, $to);
       if (topList) {
+        const selectionRanges = buildSelectionRanges(topList, topListPos, $from, $to);
         return {
           selectedNode: topList,
-          nodePos: topListPos
+          nodePos: topListPos,
+          selectionRanges
         };
       }
     }
-
-    // For non-list containers (panel, expand, etc.), return the immediate parent
     const nodePos = range.depth > 0 ? $from.before(range.depth) : 0;
+    const selectionRanges = buildSelectionRanges(range.parent, nodePos, $from, $to);
     return {
       selectedNode: range.parent,
-      nodePos
+      nodePos,
+      selectionRanges
     };
   }
 
@@ -161,8 +262,10 @@ export const getSelectionInfo = (selection, schema) => {
     nodes.push(range.parent.child(i));
   }
   const selectedNode = wrapNodesInDoc(schema, nodes);
+  const selectionRanges = buildSelectionRanges(selectedNode, range.start, $from, $to);
   return {
     selectedNode,
-    nodePos: range.start
+    nodePos: range.start,
+    selectionRanges
   };
 };

package/dist/es2019/ui/toolbar/SelectionExtensionDropdownMenuButton.js

@@ -3,7 +3,7 @@ import { injectIntl } from 'react-intl-next';
 import { selectionExtensionMessages } from '@atlaskit/editor-common/messages';
 import { ToolbarButton } from '@atlaskit/editor-common/ui-menu';
 import AppsIcon from '@atlaskit/icon/core/apps';
-import ChevronDownIcon from '@atlaskit/icon/core/migration/chevron-down';
+import ChevronDownIcon from '@atlaskit/icon/core/chevron-down';
 const SelectionExtensionDropdownMenuButtonComponent = ({
   onClick,
   selected,

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

@@ -1,11 +1,111 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 import { logException } from '@atlaskit/editor-common/monitoring';
 import { Fragment } from '@atlaskit/editor-prosemirror/model';
 var LIST_ITEM_TYPES = new Set(['taskItem', 'decisionItem', 'listItem']);
 var LIST_NODE_TYPES = new Set(['taskList', 'bulletList', 'orderedList', 'decisionList']);
 
 /**
- * Find the depth of the deepest common ancestor node.
+ * Build a JSON pointer path for a node within the selectedNode structure.
+ * @param pathIndices - Array of content indices representing the path to the node
  */
+var buildJsonPointer = function buildJsonPointer(pathIndices) {
+  return pathIndices.map(function (index) {
+    return "/content/".concat(index);
+  }).join('');
+};
+
+/**
+ * Build selection ranges for multi-node selections.
+ * This function traverses the selectedNode and creates JSON pointer-based ranges
+ * that describe what parts of the selectedNode are included in the selection.
+ */
+export var buildSelectionRanges = function buildSelectionRanges(selectedNode, selectedNodePos, $from, $to) {
+  var selectionStart = $from.pos;
+  var selectionEnd = $to.pos;
+  var tokenOffset = selectedNode.type.name === 'doc' ? 0 : 1;
+  var nodeStart = selectedNodePos + tokenOffset;
+  var nodeEnd = selectedNodePos + selectedNode.nodeSize - tokenOffset;
+
+  // If selection spans entire content, return undefined (complete block selection)
+  if (selectionStart <= nodeStart && selectionEnd >= nodeEnd) {
+    return undefined;
+  }
+  var selectionRanges = [];
+
+  // Traverse the selectedNode and find all nodes/text within the selection range
+  var _traverse = function traverse(node, nodePos, path) {
+    var nodeEndPos = nodePos + node.nodeSize;
+
+    // Skip nodes completely before or after selection
+    if (nodeEndPos <= selectionStart || nodePos >= selectionEnd) {
+      return;
+    }
+    if (node.isText) {
+      var _node$text;
+      var textStart = nodePos;
+      var textEnd = nodePos + (((_node$text = node.text) === null || _node$text === void 0 ? void 0 : _node$text.length) || 0);
+      var rangeStart = Math.max(textStart, selectionStart);
+      var rangeEnd = Math.min(textEnd, selectionEnd);
+      if (rangeStart < rangeEnd) {
+        var pointer = "".concat(buildJsonPointer(path), "/text");
+        selectionRanges.push({
+          start: {
+            pointer: pointer,
+            position: rangeStart - textStart
+          },
+          end: {
+            pointer: pointer,
+            position: rangeEnd - textStart
+          }
+        });
+      }
+    } else if (node.content.size > 0) {
+      var contentStart = nodePos + 1;
+      var contentEnd = nodeEndPos - 1;
+      var isWholeBlockSelected = node.isBlock && !node.isTextblock && !LIST_NODE_TYPES.has(node.type.name) && selectionStart <= contentStart && selectionEnd >= contentEnd;
+      if (isWholeBlockSelected) {
+        var _pointer = buildJsonPointer(path);
+        selectionRanges.push({
+          start: {
+            pointer: _pointer
+          },
+          end: {
+            pointer: _pointer
+          }
+        });
+      } else {
+        // Traverse children for textblocks, lists, or partial selections
+        var _childPos = nodePos + 1;
+        for (var i = 0; i < node.content.childCount; i++) {
+          _traverse(node.content.child(i), _childPos, [].concat(_toConsumableArray(path), [i]));
+          _childPos += node.content.child(i).nodeSize;
+        }
+      }
+    } else if (nodePos >= selectionStart && nodeEndPos <= selectionEnd) {
+      // Handle leaf nodes (e.g., hardBreak, image)
+      var _pointer2 = buildJsonPointer(path);
+      selectionRanges.push({
+        start: {
+          pointer: _pointer2
+        },
+        end: {
+          pointer: _pointer2
+        }
+      });
+    }
+  };
+
+  // Traverse each child of the selectedNode
+  var childPos = nodeStart;
+  for (var i = 0; i < selectedNode.content.childCount; i++) {
+    var child = selectedNode.content.child(i);
+    _traverse(child, childPos, [i]);
+    childPos += child.nodeSize;
+  }
+  return selectionRanges.length > 0 ? selectionRanges : undefined;
+};
+
+/** Find the depth of the deepest common ancestor node. */
 var getCommonAncestorDepth = function getCommonAncestorDepth($from, $to) {
   var minDepth = Math.min($from.depth, $to.depth);
   for (var d = 0; d <= minDepth; d++) {
@@ -107,15 +207,19 @@ export var getSelectionInfo = function getSelectionInfo(selection, schema) {
       parentNode = _getCommonParentConta.node,
       parentNodePos = _getCommonParentConta.pos;
     if (parentNode) {
+      var _selectionRanges = buildSelectionRanges(parentNode, parentNodePos, $from, $to);
       return {
         selectedNode: parentNode,
-        nodePos: parentNodePos
+        nodePos: parentNodePos,
+        selectionRanges: _selectionRanges
       };
     }
     var nodePos = $from.before();
+    var _selectionRanges2 = buildSelectionRanges($from.node(), nodePos, $from, $to);
     return {
       selectedNode: $from.node(),
-      nodePos: nodePos
+      nodePos: nodePos,
+      selectionRanges: _selectionRanges2
     };
   }
 
@@ -128,24 +232,26 @@ export var getSelectionInfo = function getSelectionInfo(selection, schema) {
     };
   }
   if (range.parent.type.name !== 'doc') {
-    // If it's a list OR list item, check for topmost list parent
+    // For lists, find topmost list parent; otherwise use immediate parent
     if (LIST_NODE_TYPES.has(range.parent.type.name) || LIST_ITEM_TYPES.has(range.parent.type.name)) {
       var _getCommonParentConta2 = getCommonParentContainer($from, $to),
         topList = _getCommonParentConta2.node,
         topListPos = _getCommonParentConta2.pos;
       if (topList) {
+        var _selectionRanges3 = buildSelectionRanges(topList, topListPos, $from, $to);
         return {
           selectedNode: topList,
-          nodePos: topListPos
+          nodePos: topListPos,
+          selectionRanges: _selectionRanges3
         };
       }
     }
-
-    // For non-list containers (panel, expand, etc.), return the immediate parent
     var _nodePos = range.depth > 0 ? $from.before(range.depth) : 0;
+    var _selectionRanges4 = buildSelectionRanges(range.parent, _nodePos, $from, $to);
     return {
       selectedNode: range.parent,
-      nodePos: _nodePos
+      nodePos: _nodePos,
+      selectionRanges: _selectionRanges4
     };
   }
 
@@ -155,8 +261,10 @@ export var getSelectionInfo = function getSelectionInfo(selection, schema) {
     nodes.push(range.parent.child(i));
   }
   var selectedNode = wrapNodesInDoc(schema, nodes);
+  var selectionRanges = buildSelectionRanges(selectedNode, range.start, $from, $to);
   return {
     selectedNode: selectedNode,
-    nodePos: range.start
+    nodePos: range.start,
+    selectionRanges: selectionRanges
   };
 };

package/dist/esm/ui/toolbar/SelectionExtensionDropdownMenuButton.js

@@ -3,7 +3,7 @@ import { injectIntl } from 'react-intl-next';
 import { selectionExtensionMessages } from '@atlaskit/editor-common/messages';
 import { ToolbarButton } from '@atlaskit/editor-common/ui-menu';
 import AppsIcon from '@atlaskit/icon/core/apps';
-import ChevronDownIcon from '@atlaskit/icon/core/migration/chevron-down';
+import ChevronDownIcon from '@atlaskit/icon/core/chevron-down';
 var SelectionExtensionDropdownMenuButtonComponent = function SelectionExtensionDropdownMenuButtonComponent(_ref) {
   var onClick = _ref.onClick,
     selected = _ref.selected,

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

@@ -1,5 +1,12 @@
 import { type Node as PMNode, type ResolvedPos, type Schema } from '@atlaskit/editor-prosemirror/model';
 import type { TextSelection } from '@atlaskit/editor-prosemirror/state';
+import type { SelectionRange } from '../../types';
+/**
+ * Build selection ranges for multi-node selections.
+ * This function traverses the selectedNode and creates JSON pointer-based ranges
+ * that describe what parts of the selectedNode are included in the selection.
+ */
+export declare const buildSelectionRanges: (selectedNode: PMNode, selectedNodePos: number, $from: ResolvedPos, $to: ResolvedPos) => SelectionRange[] | undefined;
 /**
  * Find the closest parent container node that contains the selection.
  * - For lists: returns the topmost list (to handle nested lists)
@@ -31,4 +38,9 @@ export declare const getSelectionInfoFromSameNode: (selection: TextSelection) =>
 export declare const getSelectionInfo: (selection: TextSelection, schema: Schema) => {
     selectedNode: PMNode;
     nodePos: number;
+    selectionRanges: SelectionRange[] | undefined;
+} | {
+    selectedNode: PMNode;
+    nodePos: number;
+    selectionRanges?: undefined;
 };

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

@@ -1,5 +1,12 @@
 import { type Node as PMNode, type ResolvedPos, type Schema } from '@atlaskit/editor-prosemirror/model';
 import type { TextSelection } from '@atlaskit/editor-prosemirror/state';
+import type { SelectionRange } from '../../types';
+/**
+ * Build selection ranges for multi-node selections.
+ * This function traverses the selectedNode and creates JSON pointer-based ranges
+ * that describe what parts of the selectedNode are included in the selection.
+ */
+export declare const buildSelectionRanges: (selectedNode: PMNode, selectedNodePos: number, $from: ResolvedPos, $to: ResolvedPos) => SelectionRange[] | undefined;
 /**
  * Find the closest parent container node that contains the selection.
  * - For lists: returns the topmost list (to handle nested lists)
@@ -31,4 +38,9 @@ export declare const getSelectionInfoFromSameNode: (selection: TextSelection) =>
 export declare const getSelectionInfo: (selection: TextSelection, schema: Schema) => {
     selectedNode: PMNode;
     nodePos: number;
+    selectionRanges: SelectionRange[] | undefined;
+} | {
+    selectedNode: PMNode;
+    nodePos: number;
+    selectionRanges?: undefined;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-selection-extension",
-	"version": "10.0.0",
+	"version": "10.0.2",
 	"description": "editor-plugin-selection-extension plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -52,14 +52,14 @@
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/platform-feature-flags-react": "^0.4.0",
 		"@atlaskit/primitives": "^17.0.0",
-		"@atlaskit/tmp-editor-statsig": "^16.3.0",
+		"@atlaskit/tmp-editor-statsig": "^16.5.0",
 		"@babel/runtime": "^7.0.0",
 		"lodash": "^4.17.21",
 		"react-intl-next": "npm:react-intl@^5.18.1",
 		"uuid": "^3.1.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^111.0.0",
+		"@atlaskit/editor-common": "^111.2.0",
 		"react": "^18.2.0"
 	},
 	"devDependencies": {