@atlaskit/editor-plugin-selection-extension 3.0.1 → 3.1.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @atlaskit/editor-plugin-selection-extension
 
+## 3.1.1
+
+### Patch Changes
+
+- [#183521](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/183521)
+  [`86379b9b3d99e`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/86379b9b3d99e) -
+  Insert links to page bottom as fallback when changes detect
+- [#183158](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/183158)
+  [`d6096ec5c8ad9`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/d6096ec5c8ad9) -
+  Migrate to useSharedPluginStateWithSelector
+- Updated dependencies
+
+## 3.1.0
+
+### Minor Changes
+
+- [#181784](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/181784)
+  [`e3cd18b4fc263`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/e3cd18b4fc263) -
+  Create a new action insertSmartLinks to allow inserting multiple smart links in page
+
 ## 3.0.1
 
 ### Patch Changes

package/dist/cjs/pm-plugins/actions.js

@@ -0,0 +1,93 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.insertSmartLinks = void 0;
+var _types = require("../types");
+var _main = require("./main");
+var _utils = require("./utils");
+var _getOffsetByPath = require("./utils/getOffsetByPath");
+var insertLinkTr = function insertLinkTr(tr, link, offset, schema) {
+  var newFromPos = tr.mapping.map(offset.from);
+  var newToPos = tr.mapping.map(offset.to || offset.from);
+  var smartLink = schema.nodes.inlineCard.createChecked({
+    url: link
+  });
+  return tr.replaceWith(newFromPos, newToPos, smartLink);
+};
+var insertSmartLinks = exports.insertSmartLinks = function insertSmartLinks(linkInsertionOption, selectedNodeAdf) {
+  return function (state, dispatch) {
+    var _selectionExtensionPl;
+    var tr = state.tr,
+      schema = state.schema;
+    if (!Array.isArray(linkInsertionOption)) {
+      linkInsertionOption = [linkInsertionOption];
+    }
+    if (linkInsertionOption.length === 0) {
+      return {
+        status: 'error',
+        message: 'No link insertion options provided'
+      };
+    }
+
+    // we need to track if any changes were made since user click the toolbar button
+    // if there is change, we insert the links at the bottom of the page instead
+    var docChangedAfterClick = ((_selectionExtensionPl = _main.selectionExtensionPluginKey.getState(state)) === null || _selectionExtensionPl === void 0 ? void 0 : _selectionExtensionPl.docChangedAfterClick) || false;
+    if (docChangedAfterClick) {
+      var docEnd = state.doc.content.size;
+      linkInsertionOption.forEach(function (option) {
+        var link = option.link;
+        tr.insert(tr.mapping.map(docEnd), schema.nodes.inlineCard.createChecked({
+          url: link
+        }));
+      });
+      tr.setMeta(_main.selectionExtensionPluginKey, {
+        type: _types.SelectionExtensionActionTypes.START_TRACK_CHANGES,
+        startTrackChanges: false // Reset the flag when starting to track changes
+      });
+      dispatch(tr);
+      return {
+        status: 'success',
+        message: 'Links inserted to page bottom successfully'
+      };
+    }
+    var newTr = tr;
+    try {
+      var _selectionExtensionPl2, _selectionExtensionPl3;
+      var selectedNode = (_selectionExtensionPl2 = _main.selectionExtensionPluginKey.getState(state)) === null || _selectionExtensionPl2 === void 0 ? void 0 : _selectionExtensionPl2.selectedNode;
+      var nodePos = (_selectionExtensionPl3 = _main.selectionExtensionPluginKey.getState(state)) === null || _selectionExtensionPl3 === void 0 ? void 0 : _selectionExtensionPl3.nodePos;
+      if (!selectedNode || nodePos === undefined) {
+        throw new Error('No selected node or node position found');
+      }
+
+      // Validate if the selectedNodeAdf matches the selected node we have in the state
+      if (!(0, _utils.validateSelectedNode)(selectedNodeAdf, selectedNode)) {
+        throw new Error('Selected node ADF does not match the previous stored node');
+      }
+      linkInsertionOption.forEach(function (option) {
+        var link = option.link,
+          insertPosition = option.insertPosition;
+        var pointer = insertPosition.pointer,
+          from = insertPosition.from,
+          to = insertPosition.to;
+        var offset = (0, _getOffsetByPath.getOffsetByPath)(selectedNode, nodePos, pointer, from, to);
+        newTr = insertLinkTr(tr, link, offset, schema);
+      });
+    } catch (error) {
+      return {
+        status: 'error',
+        message: error instanceof Error ? error.message : 'Unknown error'
+      };
+    }
+    newTr.setMeta(_main.selectionExtensionPluginKey, {
+      type: _types.SelectionExtensionActionTypes.START_TRACK_CHANGES,
+      startTrackChanges: false // Reset the flag when starting to track changes
+    });
+    dispatch(newTr);
+    return {
+      status: 'success',
+      message: 'Links inserted successfully'
+    };
+  };
+};

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

@@ -8,6 +8,7 @@ exports.selectionExtensionPluginKey = exports.createPlugin = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _safePlugin = require("@atlaskit/editor-common/safe-plugin");
 var _state = require("@atlaskit/editor-prosemirror/state");
+var _transform = require("@atlaskit/editor-prosemirror/transform");
 var _types = require("../types");
 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) { (0, _defineProperty2.default)(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; }
@@ -32,6 +33,26 @@ var createPlugin = exports.createPlugin = function createPlugin() {
             return _objectSpread(_objectSpread({}, pluginState), {}, {
               activeExtension: undefined
             });
+          case _types.SelectionExtensionActionTypes.SET_SELECTED_NODE:
+            return _objectSpread(_objectSpread({}, pluginState), {}, {
+              selectedNode: meta.selectedNode,
+              nodePos: meta.nodePos,
+              startTrackChanges: true,
+              docChangedAfterClick: false // Reset the flag when starting to track changes
+            });
+          case _types.SelectionExtensionActionTypes.START_TRACK_CHANGES:
+            return _objectSpread(_objectSpread({}, pluginState), {}, {
+              startTrackChanges: meta.startTrackChanges
+            });
+        }
+        var docChangedAfterClick = pluginState.startTrackChanges && tr.steps.some(function (step) {
+          return step instanceof _transform.ReplaceStep || step instanceof _transform.ReplaceAroundStep;
+        });
+        if (docChangedAfterClick) {
+          return _objectSpread(_objectSpread({}, pluginState), {}, {
+            docChangedAfterClick: true,
+            startTrackChanges: false // Reset the flag to stop tracking after the document has changed
+          });
         }
         return pluginState;
       }

package/dist/cjs/pm-plugins/utils/getOffsetByPath.js

@@ -0,0 +1,83 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getOffsetByPath = getOffsetByPath;
+var _model = require("@atlaskit/editor-prosemirror/model");
+// TODO: ED-28434 - move this to a shared package
+// mirror code from https://bitbucket.org/atlassian/pf-adf-service/src/master/src/lib/update/get-offset.ts
+
+function getOffsetByPath(root, pos, pointer) {
+  var from = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 0;
+  var to = arguments.length > 4 ? arguments[4] : undefined;
+  var parts = pointer.split('/');
+  var ref = root;
+  var len = parts.length;
+  // -1 to account for the root node (usually doc)
+  // The start of the document, right before the first content, is position 0.
+  var offset = pos; //-1;
+
+  for (var i = 1; i < len; i++) {
+    var key = parts[i];
+    if (ref instanceof _model.Fragment && /^[0-9]+$/.test(key)) {
+      var index = parseInt(key, 10);
+      if (index >= ref.childCount) {
+        throw new Error("JSON pointer \"".concat(pointer, "\" points to non-existing location."));
+      }
+      var nextRef = ref.child(index);
+      while (index--) {
+        offset += ref.child(index).nodeSize;
+      }
+      ref = nextRef;
+    } else if (ref instanceof _model.Node) {
+      /**
+       * Reference: https://prosemirror.net/docs/guide/#doc.data_structures
+       * +----------------------------------+
+       * |              Node                |
+       * |              ^^^^                |
+       * | type:       NodeType             |
+       * | content:    Fragment             |
+       * |              [ Node, Node, ...]  |
+       * | attrs:      Object               |
+       * | marks:      Mark                 |
+       * |              [                   |
+       * |                type: MarkType    |
+       * |                attrs: Object     |
+       * |              ]                   |
+       * +----------------------------------+
+       */
+      switch (key) {
+        case 'content':
+          // Entering or leaving a node that is not a leaf node (i.e. supports content) counts as one token.
+          offset++;
+          ref = ref.content;
+          break;
+        case 'attrs':
+          return {
+            type: 'attrs',
+            from: offset + from,
+            path: parts.slice(i + 1)
+          };
+        case 'text':
+          if (!ref.isText) {
+            throw new Error("\"".concat(parts.slice(0, i).join('/'), "\" doesn't have any \"text\" node!"));
+          }
+          continue;
+        default:
+          throw new Error("JSON pointer \"".concat(pointer, "\" points to an unsupported location."));
+      }
+    } else {
+      throw new Error("JSON pointer \"".concat(pointer, "\" points to an unsupported entity."));
+    }
+  }
+  if (ref instanceof _model.Fragment) {
+    throw new Error("Expected a Node, but the JSON pointer \"".concat(pointer, "\" points to a Fragment."));
+  }
+  return {
+    type: 'node',
+    from: offset + from,
+    to: offset + (to !== null && to !== void 0 ? to : ref.nodeSize),
+    matches: [to ? ref.textBetween(from, to) : ref.textContent]
+  };
+}

package/dist/cjs/pm-plugins/utils/index.js

@@ -1,9 +1,11 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.getSelectionInfo = void 0;
+exports.validateSelectedNode = exports.getSelectionInfo = void 0;
+var _isEqual = _interopRequireDefault(require("lodash/isEqual"));
 var _editorJsonTransformer = require("@atlaskit/editor-json-transformer");
 var _state = require("@atlaskit/editor-prosemirror/state");
 var _editorTables = require("@atlaskit/editor-tables");
@@ -30,11 +32,13 @@ var getSelectionInfoFromSameNode = function getSelectionInfoFromSameNode(selecti
         pointer: "/content/".concat($from.index(), "/text"),
         position: $to.parentOffset - 1
       }
-    }]
+    }],
+    nodePos: $from.before() // position before the selection
   };
 };
 var getSelectionInfoFromCellSelection = function getSelectionInfoFromCellSelection(selection) {
   var selectedNode = selection.$anchorCell.node(-1);
+  var nodePos = selection.$anchorCell.before(-1);
   var selectionRanges = [];
   var rect = getSelectedRect(selection);
   for (var row = rect.top; row < rect.bottom; row++) {
@@ -49,14 +53,16 @@ var getSelectionInfoFromCellSelection = function getSelectionInfoFromCellSelecti
   }
   return {
     selectedNode: selectedNode,
-    selectionRanges: selectionRanges
+    selectionRanges: selectionRanges,
+    nodePos: nodePos
   };
 };
 var getSelectionInfo = exports.getSelectionInfo = function getSelectionInfo(state) {
   var selection = state.selection;
   var selectionInfo = {
     selectedNode: selection.$from.node(),
-    selectionRanges: []
+    selectionRanges: [],
+    nodePos: selection.$from.before() // default to the position before the selection
   };
   if (selection instanceof _state.TextSelection) {
     var $from = selection.$from,
@@ -70,9 +76,20 @@ var getSelectionInfo = exports.getSelectionInfo = function getSelectionInfo(stat
     selectionInfo = getSelectionInfoFromCellSelection(selection);
   }
   var serializer = new _editorJsonTransformer.JSONTransformer();
-  var selectedNodeAdf = serializer.encodeNode(selectionInfo.selectedNode);
+  var _selectionInfo = selectionInfo,
+    selectionRanges = _selectionInfo.selectionRanges,
+    selectedNode = _selectionInfo.selectedNode,
+    nodePos = _selectionInfo.nodePos;
+  var selectedNodeAdf = serializer.encodeNode(selectedNode);
   return {
     selectedNodeAdf: selectedNodeAdf,
-    selectionRanges: selectionInfo.selectionRanges
+    selectionRanges: selectionRanges,
+    selectedNode: selectedNode,
+    nodePos: nodePos
   };
+};
+var validateSelectedNode = exports.validateSelectedNode = function validateSelectedNode(selectedNodeAdf, selectedNode) {
+  var serializer = new _editorJsonTransformer.JSONTransformer();
+  var selectedNodeAdfFromState = serializer.encodeNode(selectedNode);
+  return (0, _isEqual.default)(selectedNodeAdf, selectedNodeAdfFromState);
 };

package/dist/cjs/selectionExtensionPlugin.js

@@ -10,8 +10,10 @@ var _react = _interopRequireDefault(require("react"));
 var _messages = require("@atlaskit/editor-common/messages");
 var _safePlugin = require("@atlaskit/editor-common/safe-plugin");
 var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
+var _actions = require("./pm-plugins/actions");
 var _main = require("./pm-plugins/main");
 var _utils = require("./pm-plugins/utils");
+var _types = require("./types");
 var _SelectionExtensionComponentWrapper = require("./ui/extension/SelectionExtensionComponentWrapper");
 var _getBoundingBoxFromSelection = require("./ui/getBoundingBoxFromSelection");
 var _selectionToolbar2 = require("./ui/selectionToolbar");
@@ -50,6 +52,20 @@ var selectionExtensionPlugin = exports.selectionExtensionPlugin = function selec
         };
       }
     },
+    actions: {
+      insertSmartLinks: function insertSmartLinks(linkInsertionOptions, selectedNodeAdf) {
+        if (!editorViewRef.current) {
+          return {
+            status: 'error',
+            message: 'Editor view is not available'
+          };
+        }
+        var _editorViewRef$curren = editorViewRef.current,
+          state = _editorViewRef$curren.state,
+          dispatch = _editorViewRef$curren.dispatch;
+        return (0, _actions.insertSmartLinks)(linkInsertionOptions, selectedNodeAdf)(state, dispatch);
+      }
+    },
     contentComponent: function contentComponent(_ref4) {
       var _api$analytics;
       var editorView = _ref4.editorView;
@@ -137,15 +153,26 @@ var selectionExtensionPlugin = exports.selectionExtensionPlugin = function selec
               selection: selection
             };
             if ((0, _platformFeatureFlags.fg)('platform_editor_selection_extension_api_v2')) {
-              var _extension$onClick;
+              var _extension$onClick, _api$core;
               var _getSelectionInfo = (0, _utils.getSelectionInfo)(view.state),
                 selectedNodeAdf = _getSelectionInfo.selectedNodeAdf,
-                selectionRanges = _getSelectionInfo.selectionRanges;
+                selectionRanges = _getSelectionInfo.selectionRanges,
+                selectedNode = _getSelectionInfo.selectedNode,
+                nodePos = _getSelectionInfo.nodePos;
               onClickCallbackOptions = {
                 selectedNodeAdf: selectedNodeAdf,
                 selectionRanges: selectionRanges
               };
               (_extension$onClick = extension.onClick) === null || _extension$onClick === void 0 || _extension$onClick.call(extension, onClickCallbackOptions);
+              api === null || api === void 0 || (_api$core = api.core) === null || _api$core === void 0 || _api$core.actions.execute(function (_ref5) {
+                var tr = _ref5.tr;
+                tr.setMeta(_main.selectionExtensionPluginKey, {
+                  type: _types.SelectionExtensionActionTypes.SET_SELECTED_NODE,
+                  selectedNode: selectedNode,
+                  nodePos: nodePos
+                });
+                return tr;
+              });
             } else {
               if (extension.onClick) {
                 extension.onClick(onClickCallbackOptions);

package/dist/cjs/types/index.js

@@ -14,5 +14,7 @@ var SelectionExtensionActionTypes = exports.SelectionExtensionActionTypes = /*#_
   SelectionExtensionActionTypes["SET_ACTIVE_EXTENSION"] = "set-active-extension";
   SelectionExtensionActionTypes["UPDATE_ACTIVE_EXTENSION_COORDS"] = "update-active-extension-coords";
   SelectionExtensionActionTypes["CLEAR_ACTIVE_EXTENSION"] = "clear-active-extension";
+  SelectionExtensionActionTypes["SET_SELECTED_NODE"] = "set-selected-node";
+  SelectionExtensionActionTypes["START_TRACK_CHANGES"] = "start-track-changes";
   return SelectionExtensionActionTypes;
 }({});

package/dist/cjs/ui/extension/SelectionExtensionComponentWrapper.js

@@ -8,20 +8,26 @@ exports.SelectionExtensionComponentWrapper = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _analytics = require("@atlaskit/editor-common/analytics");
 var _hooks = require("@atlaskit/editor-common/hooks");
-var _useSharedPluginStateSelector = require("@atlaskit/editor-common/use-shared-plugin-state-selector");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 var useSharedState = (0, _hooks.sharedPluginStateHookMigratorFactory)(function (api) {
-  var activeExtension = (0, _useSharedPluginStateSelector.useSharedPluginStateSelector)(api, 'selectionExtension.activeExtension');
-  var mode = (0, _useSharedPluginStateSelector.useSharedPluginStateSelector)(api, 'editorViewMode.mode');
+  var _useSharedPluginState = (0, _hooks.useSharedPluginStateWithSelector)(api, ['selectionExtension', 'editorViewMode'], function (states) {
+      var _states$selectionExte, _states$editorViewMod;
+      return {
+        activeExtension: (_states$selectionExte = states.selectionExtensionState) === null || _states$selectionExte === void 0 ? void 0 : _states$selectionExte.activeExtension,
+        mode: (_states$editorViewMod = states.editorViewModeState) === null || _states$editorViewMod === void 0 ? void 0 : _states$editorViewMod.mode
+      };
+    }),
+    activeExtension = _useSharedPluginState.activeExtension,
+    mode = _useSharedPluginState.mode;
   return {
     editorViewModeState: undefined,
     mode: mode,
     activeExtension: activeExtension
   };
 }, function (api) {
-  var _useSharedPluginState = (0, _hooks.useSharedPluginState)(api, ['selectionExtension', 'editorViewMode']),
-    selectionExtensionState = _useSharedPluginState.selectionExtensionState,
-    editorViewModeState = _useSharedPluginState.editorViewModeState;
+  var _useSharedPluginState2 = (0, _hooks.useSharedPluginState)(api, ['selectionExtension', 'editorViewMode']),
+    selectionExtensionState = _useSharedPluginState2.selectionExtensionState,
+    editorViewModeState = _useSharedPluginState2.editorViewModeState;
   return {
     editorViewModeState: editorViewModeState,
     mode: editorViewModeState === null || editorViewModeState === void 0 ? void 0 : editorViewModeState.mode,

package/dist/es2019/pm-plugins/actions.js

@@ -0,0 +1,93 @@
+import { SelectionExtensionActionTypes } from '../types';
+import { selectionExtensionPluginKey } from './main';
+import { validateSelectedNode } from './utils';
+import { getOffsetByPath } from './utils/getOffsetByPath';
+const insertLinkTr = (tr, link, offset, schema) => {
+  const newFromPos = tr.mapping.map(offset.from);
+  const newToPos = tr.mapping.map(offset.to || offset.from);
+  const smartLink = schema.nodes.inlineCard.createChecked({
+    url: link
+  });
+  return tr.replaceWith(newFromPos, newToPos, smartLink);
+};
+export const insertSmartLinks = (linkInsertionOption, selectedNodeAdf) => (state, dispatch) => {
+  var _selectionExtensionPl;
+  const {
+    tr,
+    schema
+  } = state;
+  if (!Array.isArray(linkInsertionOption)) {
+    linkInsertionOption = [linkInsertionOption];
+  }
+  if (linkInsertionOption.length === 0) {
+    return {
+      status: 'error',
+      message: 'No link insertion options provided'
+    };
+  }
+
+  // we need to track if any changes were made since user click the toolbar button
+  // if there is change, we insert the links at the bottom of the page instead
+  const docChangedAfterClick = ((_selectionExtensionPl = selectionExtensionPluginKey.getState(state)) === null || _selectionExtensionPl === void 0 ? void 0 : _selectionExtensionPl.docChangedAfterClick) || false;
+  if (docChangedAfterClick) {
+    const docEnd = state.doc.content.size;
+    linkInsertionOption.forEach(option => {
+      const {
+        link
+      } = option;
+      tr.insert(tr.mapping.map(docEnd), schema.nodes.inlineCard.createChecked({
+        url: link
+      }));
+    });
+    tr.setMeta(selectionExtensionPluginKey, {
+      type: SelectionExtensionActionTypes.START_TRACK_CHANGES,
+      startTrackChanges: false // Reset the flag when starting to track changes
+    });
+    dispatch(tr);
+    return {
+      status: 'success',
+      message: 'Links inserted to page bottom successfully'
+    };
+  }
+  let newTr = tr;
+  try {
+    var _selectionExtensionPl2, _selectionExtensionPl3;
+    const selectedNode = (_selectionExtensionPl2 = selectionExtensionPluginKey.getState(state)) === null || _selectionExtensionPl2 === void 0 ? void 0 : _selectionExtensionPl2.selectedNode;
+    const nodePos = (_selectionExtensionPl3 = selectionExtensionPluginKey.getState(state)) === null || _selectionExtensionPl3 === void 0 ? void 0 : _selectionExtensionPl3.nodePos;
+    if (!selectedNode || nodePos === undefined) {
+      throw new Error('No selected node or node position found');
+    }
+
+    // Validate if the selectedNodeAdf matches the selected node we have in the state
+    if (!validateSelectedNode(selectedNodeAdf, selectedNode)) {
+      throw new Error('Selected node ADF does not match the previous stored node');
+    }
+    linkInsertionOption.forEach(option => {
+      const {
+        link,
+        insertPosition
+      } = option;
+      const {
+        pointer,
+        from,
+        to
+      } = insertPosition;
+      const offset = getOffsetByPath(selectedNode, nodePos, pointer, from, to);
+      newTr = insertLinkTr(tr, link, offset, schema);
+    });
+  } catch (error) {
+    return {
+      status: 'error',
+      message: error instanceof Error ? error.message : 'Unknown error'
+    };
+  }
+  newTr.setMeta(selectionExtensionPluginKey, {
+    type: SelectionExtensionActionTypes.START_TRACK_CHANGES,
+    startTrackChanges: false // Reset the flag when starting to track changes
+  });
+  dispatch(newTr);
+  return {
+    status: 'success',
+    message: 'Links inserted successfully'
+  };
+};

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

@@ -1,5 +1,6 @@
 import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
 import { PluginKey } from '@atlaskit/editor-prosemirror/state';
+import { ReplaceAroundStep, ReplaceStep } from '@atlaskit/editor-prosemirror/transform';
 import { SelectionExtensionActionTypes } from '../types';
 export const selectionExtensionPluginKey = new PluginKey('selectionExtensionPlugin');
 export const createPlugin = () => {
@@ -24,6 +25,27 @@ export const createPlugin = () => {
               ...pluginState,
               activeExtension: undefined
             };
+          case SelectionExtensionActionTypes.SET_SELECTED_NODE:
+            return {
+              ...pluginState,
+              selectedNode: meta.selectedNode,
+              nodePos: meta.nodePos,
+              startTrackChanges: true,
+              docChangedAfterClick: false // Reset the flag when starting to track changes
+            };
+          case SelectionExtensionActionTypes.START_TRACK_CHANGES:
+            return {
+              ...pluginState,
+              startTrackChanges: meta.startTrackChanges
+            };
+        }
+        const docChangedAfterClick = pluginState.startTrackChanges && tr.steps.some(step => step instanceof ReplaceStep || step instanceof ReplaceAroundStep);
+        if (docChangedAfterClick) {
+          return {
+            ...pluginState,
+            docChangedAfterClick: true,
+            startTrackChanges: false // Reset the flag to stop tracking after the document has changed
+          };
         }
         return pluginState;
       }

package/dist/es2019/pm-plugins/utils/getOffsetByPath.js

@@ -0,0 +1,76 @@
+import { Fragment, Node as PMNode } from '@atlaskit/editor-prosemirror/model';
+
+// TODO: ED-28434 - move this to a shared package
+// mirror code from https://bitbucket.org/atlassian/pf-adf-service/src/master/src/lib/update/get-offset.ts
+
+export function getOffsetByPath(root, pos, pointer, from = 0, to) {
+  const parts = pointer.split('/');
+  let ref = root;
+  const len = parts.length;
+  // -1 to account for the root node (usually doc)
+  // The start of the document, right before the first content, is position 0.
+  let offset = pos; //-1;
+
+  for (let i = 1; i < len; i++) {
+    const key = parts[i];
+    if (ref instanceof Fragment && /^[0-9]+$/u.test(key)) {
+      let index = parseInt(key, 10);
+      if (index >= ref.childCount) {
+        throw new Error(`JSON pointer "${pointer}" points to non-existing location.`);
+      }
+      const nextRef = ref.child(index);
+      while (index--) {
+        offset += ref.child(index).nodeSize;
+      }
+      ref = nextRef;
+    } else if (ref instanceof PMNode) {
+      /**
+       * Reference: https://prosemirror.net/docs/guide/#doc.data_structures
+       * +----------------------------------+
+       * |              Node                |
+       * |              ^^^^                |
+       * | type:       NodeType             |
+       * | content:    Fragment             |
+       * |              [ Node, Node, ...]  |
+       * | attrs:      Object               |
+       * | marks:      Mark                 |
+       * |              [                   |
+       * |                type: MarkType    |
+       * |                attrs: Object     |
+       * |              ]                   |
+       * +----------------------------------+
+       */
+      switch (key) {
+        case 'content':
+          // Entering or leaving a node that is not a leaf node (i.e. supports content) counts as one token.
+          offset++;
+          ref = ref.content;
+          break;
+        case 'attrs':
+          return {
+            type: 'attrs',
+            from: offset + from,
+            path: parts.slice(i + 1)
+          };
+        case 'text':
+          if (!ref.isText) {
+            throw new Error(`"${parts.slice(0, i).join('/')}" doesn't have any "text" node!`);
+          }
+          continue;
+        default:
+          throw new Error(`JSON pointer "${pointer}" points to an unsupported location.`);
+      }
+    } else {
+      throw new Error(`JSON pointer "${pointer}" points to an unsupported entity.`);
+    }
+  }
+  if (ref instanceof Fragment) {
+    throw new Error(`Expected a Node, but the JSON pointer "${pointer}" points to a Fragment.`);
+  }
+  return {
+    type: 'node',
+    from: offset + from,
+    to: offset + (to !== null && to !== void 0 ? to : ref.nodeSize),
+    matches: [to ? ref.textBetween(from, to) : ref.textContent]
+  };
+}