@atlaskit/editor-plugin-card 16.5.4 → 16.6.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @atlaskit/editor-plugin-card
 
+## 16.6.0
+
+### Minor Changes
+
+- [`a94026f1bcd86`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/a94026f1bcd86) -
+  [ux] fix: scope card queue to inserted range when inserting MAUI embed via Add to Doc
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 16.5.4
 
 ### Patch Changes

package/dist/cjs/cardPlugin.js

@@ -135,6 +135,19 @@ var cardPlugin = exports.cardPlugin = function cardPlugin(_ref) {
         editorView: editorView
       }));
     },
+    commands: {
+      queueCardsFromRange: function queueCardsFromRange(from, to, source, analyticsAction, normalizeLinkText, sourceEvent, appearance) {
+        return function (_ref5) {
+          var tr = _ref5.tr;
+          return (0, _doc.queueCardsFromRange)(
+          // Synthesise the minimal EditorState shape the impl actually reads.
+          {
+            schema: tr.doc.type.schema,
+            selection: tr.selection
+          }, tr, from, to, source, analyticsAction, normalizeLinkText, sourceEvent, appearance);
+        };
+      }
+    },
     actions: {
       setProvider: function () {
         var _setProvider2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(providerPromise) {
@@ -154,8 +167,8 @@ var cardPlugin = exports.cardPlugin = function cardPlugin(_ref) {
                 return _context.abrupt("return", false);
               case 5:
                 previousCardProvider = provider;
-                return _context.abrupt("return", (_api$core$actions$exe = api === null || api === void 0 ? void 0 : api.core.actions.execute(function (_ref5) {
-                  var tr = _ref5.tr;
+                return _context.abrupt("return", (_api$core$actions$exe = api === null || api === void 0 ? void 0 : api.core.actions.execute(function (_ref6) {
+                  var tr = _ref6.tr;
                   return (0, _actions.setProvider)(provider)(tr);
                 })) !== null && _api$core$actions$exe !== void 0 ? _api$core$actions$exe : false);
               case 7:
@@ -171,6 +184,7 @@ var cardPlugin = exports.cardPlugin = function cardPlugin(_ref) {
       }(),
       hideLinkToolbar: _actions.hideLinkToolbar,
       queueCardsFromChangedTr: _doc.queueCardsFromChangedTr,
+      queueCardsFromRange: _doc.queueCardsFromRange,
       registerEmbedCardTransformer: function registerEmbedCardTransformer(transformers) {
         instanceEmbedCardTransformers = transformers;
       },
@@ -262,8 +276,8 @@ var cardPlugin = exports.cardPlugin = function cardPlugin(_ref) {
     },
     pluginsOptions: {
       floatingToolbar: (0, _toolbar.floatingToolbar)(options, (_options$lpLinkPicker = options.lpLinkPicker) !== null && _options$lpLinkPicker !== void 0 ? _options$lpLinkPicker : false, options.linkPicker, api, options.disableFloatingToolbar),
-      quickInsert: function quickInsert(_ref6) {
-        var formatMessage = _ref6.formatMessage;
+      quickInsert: function quickInsert(_ref7) {
+        var formatMessage = _ref7.formatMessage;
         var quickInsertArray = [];
         if (!options.allowDatasource) {
           return quickInsertArray;

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

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.updateCardViaDatasource = exports.updateCard = exports.setSelectedCardAppearance = exports.replaceQueuedUrlWithCard = exports.queueCardsFromChangedTr = exports.queueCardFromChangedTr = exports.insertDatasource = exports.handleFallbackWithAnalytics = exports.getLinkNodeType = exports.getAttrsForAppearance = exports.convertHyperlinkToSmartCard = exports.changeSelectedCardToText = exports.changeSelectedCardToLinkFallback = exports.changeSelectedCardToLink = void 0;
+exports.updateCardViaDatasource = exports.updateCard = exports.setSelectedCardAppearance = exports.replaceQueuedUrlWithCard = exports.queueCardsFromRange = exports.queueCardsFromChangedTr = exports.queueCardFromChangedTr = exports.insertDatasource = exports.handleFallbackWithAnalytics = exports.getLinkNodeType = exports.getAttrsForAppearance = exports.convertHyperlinkToSmartCard = exports.changeSelectedCardToText = exports.changeSelectedCardToLinkFallback = exports.changeSelectedCardToLink = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
@@ -199,6 +199,45 @@ var handleFallbackWithAnalytics = exports.handleFallbackWithAnalytics = function
     return true;
   };
 };
+
+/**
+ * Shared options used by both `queueCardsFromChangedTr` and
+ * `queueCardsFromRange` to build smart-link resolution requests for text
+ * nodes carrying a `link` mark.
+ */
+
+/**
+ * Per-node walker shared by `queueCardsFromChangedTr` and
+ * `queueCardsFromRange`. Pushes a smart-link resolution request for every
+ * text node carrying a qualifying `link` mark.
+ *
+ * Returning `true`/`false` follows the ProseMirror `nodesBetween`/
+ * `nodesBetweenChanged` walker contract: `true` to descend into children,
+ * `false` to skip subtree.
+ */
+var collectLinkRequest = function collectLinkRequest(requests, node, pos, options) {
+  if (!node.isText) {
+    return true;
+  }
+  var linkMark = node.marks.find(function (mark) {
+    return mark.type === options.linkMarkType;
+  });
+  if (linkMark) {
+    if (!(0, _shouldReplaceLink.shouldReplaceLink)(node, options.normalizeLinkText)) {
+      return false;
+    }
+    requests.push({
+      url: linkMark.attrs.href,
+      pos: pos,
+      appearance: options.appearance,
+      compareLinkText: options.normalizeLinkText,
+      source: options.source,
+      analyticsAction: options.analyticsAction,
+      sourceEvent: options.sourceEvent
+    });
+  }
+  return false;
+};
 var queueCardsFromChangedTr = exports.queueCardsFromChangedTr = function queueCardsFromChangedTr(state, tr, source, analyticsAction) {
   var normalizeLinkText = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : true;
   var sourceEvent = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : undefined;
@@ -206,28 +245,16 @@ var queueCardsFromChangedTr = exports.queueCardsFromChangedTr = function queueCa
   var schema = state.schema;
   var link = schema.marks.link;
   var requests = [];
+  var options = {
+    analyticsAction: analyticsAction,
+    appearance: appearance,
+    linkMarkType: link,
+    normalizeLinkText: normalizeLinkText,
+    source: source,
+    sourceEvent: sourceEvent
+  };
   (0, _utils.nodesBetweenChanged)(tr, function (node, pos) {
-    if (!node.isText) {
-      return true;
-    }
-    var linkMark = node.marks.find(function (mark) {
-      return mark.type === link;
-    });
-    if (linkMark) {
-      if (!(0, _shouldReplaceLink.shouldReplaceLink)(node, normalizeLinkText)) {
-        return false;
-      }
-      requests.push({
-        url: linkMark.attrs.href,
-        pos: pos,
-        appearance: appearance,
-        compareLinkText: normalizeLinkText,
-        source: source,
-        analyticsAction: analyticsAction,
-        sourceEvent: sourceEvent
-      });
-    }
-    return false;
+    return collectLinkRequest(requests, node, pos, options);
   });
   if (analyticsAction) {
     (0, _card.addLinkMetadata)(state.selection, tr, {
@@ -236,6 +263,44 @@ var queueCardsFromChangedTr = exports.queueCardsFromChangedTr = function queueCa
   }
   return (0, _actions.queueCards)(requests)(tr);
 };
+
+/**
+ * Queue link-mark → smart-link resolution for text nodes within an explicit
+ * document range, rather than the entire step range of the transaction.
+ *
+ * Use this instead of `queueCardsFromChangedTr` when you know the exact range
+ * that was inserted/modified and want to avoid accidentally queuing pre-existing
+ * links that happen to fall within the broader step range.
+ */
+var queueCardsFromRange = exports.queueCardsFromRange = function queueCardsFromRange(state, tr, from, to, source, analyticsAction) {
+  var normalizeLinkText = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : true;
+  var sourceEvent = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : undefined;
+  var appearance = arguments.length > 8 && arguments[8] !== undefined ? arguments[8] : 'inline';
+  var schema = state.schema;
+  var link = schema.marks.link;
+  var requests = [];
+  var options = {
+    analyticsAction: analyticsAction,
+    appearance: appearance,
+    linkMarkType: link,
+    normalizeLinkText: normalizeLinkText,
+    source: source,
+    sourceEvent: sourceEvent
+  };
+  var clampedFrom = Math.max(0, from);
+  var clampedTo = Math.min(tr.doc.content.size, to);
+  if (clampedFrom < clampedTo) {
+    tr.doc.nodesBetween(clampedFrom, clampedTo, function (node, pos) {
+      return collectLinkRequest(requests, node, pos, options);
+    });
+  }
+  if (analyticsAction) {
+    (0, _card.addLinkMetadata)(state.selection, tr, {
+      action: analyticsAction
+    });
+  }
+  return (0, _actions.queueCards)(requests)(tr);
+};
 var queueCardFromChangedTr = exports.queueCardFromChangedTr = function queueCardFromChangedTr(state, tr, source, analyticsAction) {
   var normalizeLinkText = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : true;
   var sourceEvent = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : undefined;

package/dist/es2019/cardPlugin.js

@@ -8,7 +8,7 @@ import { blockCardSpecWithFixedToDOM } from './nodeviews/toDOM-fixes/blockCard';
 import { embedCardSpecWithFixedToDOM } from './nodeviews/toDOM-fixes/embedCard';
 import { inlineCardSpecWithFixedToDOM } from './nodeviews/toDOM-fixes/inlineCard';
 import { hideLinkToolbar, setProvider, showDatasourceModal } from './pm-plugins/actions';
-import { queueCardsFromChangedTr } from './pm-plugins/doc';
+import { queueCardsFromChangedTr, queueCardsFromRange } from './pm-plugins/doc';
 import { cardKeymap } from './pm-plugins/keymap';
 import { createPlugin } from './pm-plugins/main';
 import { pluginKey } from './pm-plugins/plugin-key';
@@ -133,6 +133,16 @@ export const cardPlugin = ({
         editorView: editorView
       }));
     },
+    commands: {
+      queueCardsFromRange: (from, to, source, analyticsAction, normalizeLinkText, sourceEvent, appearance) => ({
+        tr
+      }) => queueCardsFromRange(
+      // Synthesise the minimal EditorState shape the impl actually reads.
+      {
+        schema: tr.doc.type.schema,
+        selection: tr.selection
+      }, tr, from, to, source, analyticsAction, normalizeLinkText, sourceEvent, appearance)
+    },
     actions: {
       setProvider: async providerPromise => {
         var _api$core$actions$exe;
@@ -148,6 +158,7 @@ export const cardPlugin = ({
       },
       hideLinkToolbar,
       queueCardsFromChangedTr,
+      queueCardsFromRange,
       registerEmbedCardTransformer: transformers => {
         instanceEmbedCardTransformers = transformers;
       },

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

@@ -176,6 +176,43 @@ export const handleFallbackWithAnalytics = (request, editorAnalyticsApi) => (sta
   }
   return true;
 };
+
+/**
+ * Shared options used by both `queueCardsFromChangedTr` and
+ * `queueCardsFromRange` to build smart-link resolution requests for text
+ * nodes carrying a `link` mark.
+ */
+
+/**
+ * Per-node walker shared by `queueCardsFromChangedTr` and
+ * `queueCardsFromRange`. Pushes a smart-link resolution request for every
+ * text node carrying a qualifying `link` mark.
+ *
+ * Returning `true`/`false` follows the ProseMirror `nodesBetween`/
+ * `nodesBetweenChanged` walker contract: `true` to descend into children,
+ * `false` to skip subtree.
+ */
+const collectLinkRequest = (requests, node, pos, options) => {
+  if (!node.isText) {
+    return true;
+  }
+  const linkMark = node.marks.find(mark => mark.type === options.linkMarkType);
+  if (linkMark) {
+    if (!shouldReplaceLink(node, options.normalizeLinkText)) {
+      return false;
+    }
+    requests.push({
+      url: linkMark.attrs.href,
+      pos,
+      appearance: options.appearance,
+      compareLinkText: options.normalizeLinkText,
+      source: options.source,
+      analyticsAction: options.analyticsAction,
+      sourceEvent: options.sourceEvent
+    });
+  }
+  return false;
+};
 export const queueCardsFromChangedTr = (state, tr, source, analyticsAction, normalizeLinkText = true, sourceEvent = undefined, appearance = 'inline') => {
   const {
     schema
@@ -184,27 +221,52 @@ export const queueCardsFromChangedTr = (state, tr, source, analyticsAction, norm
     link
   } = schema.marks;
   const requests = [];
-  nodesBetweenChanged(tr, (node, pos) => {
-    if (!node.isText) {
-      return true;
-    }
-    const linkMark = node.marks.find(mark => mark.type === link);
-    if (linkMark) {
-      if (!shouldReplaceLink(node, normalizeLinkText)) {
-        return false;
-      }
-      requests.push({
-        url: linkMark.attrs.href,
-        pos,
-        appearance,
-        compareLinkText: normalizeLinkText,
-        source,
-        analyticsAction,
-        sourceEvent
-      });
-    }
-    return false;
-  });
+  const options = {
+    analyticsAction,
+    appearance,
+    linkMarkType: link,
+    normalizeLinkText,
+    source,
+    sourceEvent
+  };
+  nodesBetweenChanged(tr, (node, pos) => collectLinkRequest(requests, node, pos, options));
+  if (analyticsAction) {
+    addLinkMetadata(state.selection, tr, {
+      action: analyticsAction
+    });
+  }
+  return queueCards(requests)(tr);
+};
+
+/**
+ * Queue link-mark → smart-link resolution for text nodes within an explicit
+ * document range, rather than the entire step range of the transaction.
+ *
+ * Use this instead of `queueCardsFromChangedTr` when you know the exact range
+ * that was inserted/modified and want to avoid accidentally queuing pre-existing
+ * links that happen to fall within the broader step range.
+ */
+export const queueCardsFromRange = (state, tr, from, to, source, analyticsAction, normalizeLinkText = true, sourceEvent = undefined, appearance = 'inline') => {
+  const {
+    schema
+  } = state;
+  const {
+    link
+  } = schema.marks;
+  const requests = [];
+  const options = {
+    analyticsAction,
+    appearance,
+    linkMarkType: link,
+    normalizeLinkText,
+    source,
+    sourceEvent
+  };
+  const clampedFrom = Math.max(0, from);
+  const clampedTo = Math.min(tr.doc.content.size, to);
+  if (clampedFrom < clampedTo) {
+    tr.doc.nodesBetween(clampedFrom, clampedTo, (node, pos) => collectLinkRequest(requests, node, pos, options));
+  }
   if (analyticsAction) {
     addLinkMetadata(state.selection, tr, {
       action: analyticsAction

package/dist/esm/cardPlugin.js

@@ -14,7 +14,7 @@ import { blockCardSpecWithFixedToDOM } from './nodeviews/toDOM-fixes/blockCard';
 import { embedCardSpecWithFixedToDOM } from './nodeviews/toDOM-fixes/embedCard';
 import { inlineCardSpecWithFixedToDOM } from './nodeviews/toDOM-fixes/inlineCard';
 import { hideLinkToolbar, setProvider as _setProvider, showDatasourceModal } from './pm-plugins/actions';
-import { queueCardsFromChangedTr } from './pm-plugins/doc';
+import { queueCardsFromChangedTr, queueCardsFromRange as _queueCardsFromRange } from './pm-plugins/doc';
 import { cardKeymap } from './pm-plugins/keymap';
 import { createPlugin } from './pm-plugins/main';
 import { pluginKey } from './pm-plugins/plugin-key';
@@ -129,6 +129,19 @@ export var cardPlugin = function cardPlugin(_ref) {
         editorView: editorView
       }));
     },
+    commands: {
+      queueCardsFromRange: function queueCardsFromRange(from, to, source, analyticsAction, normalizeLinkText, sourceEvent, appearance) {
+        return function (_ref5) {
+          var tr = _ref5.tr;
+          return _queueCardsFromRange(
+          // Synthesise the minimal EditorState shape the impl actually reads.
+          {
+            schema: tr.doc.type.schema,
+            selection: tr.selection
+          }, tr, from, to, source, analyticsAction, normalizeLinkText, sourceEvent, appearance);
+        };
+      }
+    },
     actions: {
       setProvider: function () {
         var _setProvider2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(providerPromise) {
@@ -148,8 +161,8 @@ export var cardPlugin = function cardPlugin(_ref) {
                 return _context.abrupt("return", false);
               case 5:
                 previousCardProvider = provider;
-                return _context.abrupt("return", (_api$core$actions$exe = api === null || api === void 0 ? void 0 : api.core.actions.execute(function (_ref5) {
-                  var tr = _ref5.tr;
+                return _context.abrupt("return", (_api$core$actions$exe = api === null || api === void 0 ? void 0 : api.core.actions.execute(function (_ref6) {
+                  var tr = _ref6.tr;
                   return _setProvider(provider)(tr);
                 })) !== null && _api$core$actions$exe !== void 0 ? _api$core$actions$exe : false);
               case 7:
@@ -165,6 +178,7 @@ export var cardPlugin = function cardPlugin(_ref) {
       }(),
       hideLinkToolbar: hideLinkToolbar,
       queueCardsFromChangedTr: queueCardsFromChangedTr,
+      queueCardsFromRange: _queueCardsFromRange,
       registerEmbedCardTransformer: function registerEmbedCardTransformer(transformers) {
         instanceEmbedCardTransformers = transformers;
       },
@@ -256,8 +270,8 @@ export var cardPlugin = function cardPlugin(_ref) {
     },
     pluginsOptions: {
       floatingToolbar: floatingToolbar(options, (_options$lpLinkPicker = options.lpLinkPicker) !== null && _options$lpLinkPicker !== void 0 ? _options$lpLinkPicker : false, options.linkPicker, api, options.disableFloatingToolbar),
-      quickInsert: function quickInsert(_ref6) {
-        var formatMessage = _ref6.formatMessage;
+      quickInsert: function quickInsert(_ref7) {
+        var formatMessage = _ref7.formatMessage;
         var quickInsertArray = [];
         if (!options.allowDatasource) {
           return quickInsertArray;

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

@@ -193,6 +193,45 @@ export var handleFallbackWithAnalytics = function handleFallbackWithAnalytics(re
     return true;
   };
 };
+
+/**
+ * Shared options used by both `queueCardsFromChangedTr` and
+ * `queueCardsFromRange` to build smart-link resolution requests for text
+ * nodes carrying a `link` mark.
+ */
+
+/**
+ * Per-node walker shared by `queueCardsFromChangedTr` and
+ * `queueCardsFromRange`. Pushes a smart-link resolution request for every
+ * text node carrying a qualifying `link` mark.
+ *
+ * Returning `true`/`false` follows the ProseMirror `nodesBetween`/
+ * `nodesBetweenChanged` walker contract: `true` to descend into children,
+ * `false` to skip subtree.
+ */
+var collectLinkRequest = function collectLinkRequest(requests, node, pos, options) {
+  if (!node.isText) {
+    return true;
+  }
+  var linkMark = node.marks.find(function (mark) {
+    return mark.type === options.linkMarkType;
+  });
+  if (linkMark) {
+    if (!shouldReplaceLink(node, options.normalizeLinkText)) {
+      return false;
+    }
+    requests.push({
+      url: linkMark.attrs.href,
+      pos: pos,
+      appearance: options.appearance,
+      compareLinkText: options.normalizeLinkText,
+      source: options.source,
+      analyticsAction: options.analyticsAction,
+      sourceEvent: options.sourceEvent
+    });
+  }
+  return false;
+};
 export var queueCardsFromChangedTr = function queueCardsFromChangedTr(state, tr, source, analyticsAction) {
   var normalizeLinkText = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : true;
   var sourceEvent = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : undefined;
@@ -200,28 +239,16 @@ export var queueCardsFromChangedTr = function queueCardsFromChangedTr(state, tr,
   var schema = state.schema;
   var link = schema.marks.link;
   var requests = [];
+  var options = {
+    analyticsAction: analyticsAction,
+    appearance: appearance,
+    linkMarkType: link,
+    normalizeLinkText: normalizeLinkText,
+    source: source,
+    sourceEvent: sourceEvent
+  };
   nodesBetweenChanged(tr, function (node, pos) {
-    if (!node.isText) {
-      return true;
-    }
-    var linkMark = node.marks.find(function (mark) {
-      return mark.type === link;
-    });
-    if (linkMark) {
-      if (!shouldReplaceLink(node, normalizeLinkText)) {
-        return false;
-      }
-      requests.push({
-        url: linkMark.attrs.href,
-        pos: pos,
-        appearance: appearance,
-        compareLinkText: normalizeLinkText,
-        source: source,
-        analyticsAction: analyticsAction,
-        sourceEvent: sourceEvent
-      });
-    }
-    return false;
+    return collectLinkRequest(requests, node, pos, options);
   });
   if (analyticsAction) {
     addLinkMetadata(state.selection, tr, {
@@ -230,6 +257,44 @@ export var queueCardsFromChangedTr = function queueCardsFromChangedTr(state, tr,
   }
   return queueCards(requests)(tr);
 };
+
+/**
+ * Queue link-mark → smart-link resolution for text nodes within an explicit
+ * document range, rather than the entire step range of the transaction.
+ *
+ * Use this instead of `queueCardsFromChangedTr` when you know the exact range
+ * that was inserted/modified and want to avoid accidentally queuing pre-existing
+ * links that happen to fall within the broader step range.
+ */
+export var queueCardsFromRange = function queueCardsFromRange(state, tr, from, to, source, analyticsAction) {
+  var normalizeLinkText = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : true;
+  var sourceEvent = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : undefined;
+  var appearance = arguments.length > 8 && arguments[8] !== undefined ? arguments[8] : 'inline';
+  var schema = state.schema;
+  var link = schema.marks.link;
+  var requests = [];
+  var options = {
+    analyticsAction: analyticsAction,
+    appearance: appearance,
+    linkMarkType: link,
+    normalizeLinkText: normalizeLinkText,
+    source: source,
+    sourceEvent: sourceEvent
+  };
+  var clampedFrom = Math.max(0, from);
+  var clampedTo = Math.min(tr.doc.content.size, to);
+  if (clampedFrom < clampedTo) {
+    tr.doc.nodesBetween(clampedFrom, clampedTo, function (node, pos) {
+      return collectLinkRequest(requests, node, pos, options);
+    });
+  }
+  if (analyticsAction) {
+    addLinkMetadata(state.selection, tr, {
+      action: analyticsAction
+    });
+  }
+  return queueCards(requests)(tr);
+};
 export var queueCardFromChangedTr = function queueCardFromChangedTr(state, tr, source, analyticsAction) {
   var normalizeLinkText = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : true;
   var sourceEvent = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : undefined;

package/dist/types/cardPluginType.d.ts

@@ -1,6 +1,8 @@
-import type { INPUT_METHOD } from '@atlaskit/editor-common/analytics';
-import type { CardPluginActions } from '@atlaskit/editor-common/card';
-import type { NextEditorPlugin, OptionalPlugin, Command } from '@atlaskit/editor-common/types';
+import type { UIAnalyticsEvent } from '@atlaskit/analytics-next';
+import type { ACTION, INPUT_METHOD } from '@atlaskit/editor-common/analytics';
+import type { CardPluginActions, CardReplacementInputMethod } from '@atlaskit/editor-common/card';
+import type { CardAppearance } from '@atlaskit/editor-common/provider-factory';
+import type { Command, EditorCommand, NextEditorPlugin, OptionalPlugin } from '@atlaskit/editor-common/types';
 import type { AnalyticsPlugin } from '@atlaskit/editor-plugin-analytics';
 import type { InlineCommentPluginState } from '@atlaskit/editor-plugin-annotation';
 import type { BasePlugin } from '@atlaskit/editor-plugin-base';
@@ -38,6 +40,10 @@ export type CardPluginDependencies = [
 ];
 export type CardPlugin = NextEditorPlugin<'card', {
     actions: CardPluginActions;
+    commands: {
+        /** EditorCommand form of `queueCardsFromRange`. Prefer over the action. */
+        queueCardsFromRange: (from: number, to: number, source: CardReplacementInputMethod, analyticsAction?: ACTION, normalizeLinkText?: boolean, sourceEvent?: UIAnalyticsEvent | null, appearance?: CardAppearance) => EditorCommand;
+    };
     dependencies: CardPluginDependencies;
     pluginConfiguration: CardPluginOptions | undefined;
     sharedState: CardPluginState | null;

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

@@ -12,6 +12,15 @@ import type { Request } from '../types';
 export declare const replaceQueuedUrlWithCard: (url: string, cardData: CardAdf | DatasourceAdf, analyticsAction?: ACTION, editorAnalyticsApi?: EditorAnalyticsAPI, createAnalyticsEvent?: CreateUIAnalyticsEvent, embedCardNodeTransformer?: EmbedCardNodeTransformer) => Command;
 export declare const handleFallbackWithAnalytics: (request: Request, editorAnalyticsApi: EditorAnalyticsAPI | undefined) => Command;
 export declare const queueCardsFromChangedTr: (state: EditorState, tr: Transaction, source: CardReplacementInputMethod, analyticsAction?: ACTION, normalizeLinkText?: boolean, sourceEvent?: UIAnalyticsEvent | null | undefined, appearance?: CardAppearance) => Transaction;
+/**
+ * Queue link-mark → smart-link resolution for text nodes within an explicit
+ * document range, rather than the entire step range of the transaction.
+ *
+ * Use this instead of `queueCardsFromChangedTr` when you know the exact range
+ * that was inserted/modified and want to avoid accidentally queuing pre-existing
+ * links that happen to fall within the broader step range.
+ */
+export declare const queueCardsFromRange: (state: EditorState, tr: Transaction, from: number, to: number, source: CardReplacementInputMethod, analyticsAction?: ACTION, normalizeLinkText?: boolean, sourceEvent?: UIAnalyticsEvent | null | undefined, appearance?: CardAppearance) => Transaction;
 export declare const queueCardFromChangedTr: (state: EditorState, tr: Transaction, source: CardReplacementInputMethod, analyticsAction: ACTION, normalizeLinkText?: boolean, sourceEvent?: UIAnalyticsEvent | null | undefined, previousAppearance?: CardAppearance | "url") => Transaction;
 export declare const convertHyperlinkToSmartCard: (state: EditorState, source: CardReplacementInputMethod, appearance: CardAppearance, normalizeLinkText?: boolean) => Transaction;
 export declare const changeSelectedCardToLink: (text?: string, href?: string, sendAnalytics?: boolean, node?: Node, pos?: number, editorAnalyticsApi?: EditorAnalyticsAPI) => Command;

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

@@ -1,6 +1,8 @@
-import type { INPUT_METHOD } from '@atlaskit/editor-common/analytics';
-import type { CardPluginActions } from '@atlaskit/editor-common/card';
-import type { NextEditorPlugin, OptionalPlugin, Command } from '@atlaskit/editor-common/types';
+import type { UIAnalyticsEvent } from '@atlaskit/analytics-next';
+import type { ACTION, INPUT_METHOD } from '@atlaskit/editor-common/analytics';
+import type { CardPluginActions, CardReplacementInputMethod } from '@atlaskit/editor-common/card';
+import type { CardAppearance } from '@atlaskit/editor-common/provider-factory';
+import type { Command, EditorCommand, NextEditorPlugin, OptionalPlugin } from '@atlaskit/editor-common/types';
 import type { AnalyticsPlugin } from '@atlaskit/editor-plugin-analytics';
 import type { InlineCommentPluginState } from '@atlaskit/editor-plugin-annotation';
 import type { BasePlugin } from '@atlaskit/editor-plugin-base';
@@ -38,6 +40,10 @@ export type CardPluginDependencies = [
 ];
 export type CardPlugin = NextEditorPlugin<'card', {
     actions: CardPluginActions;
+    commands: {
+        /** EditorCommand form of `queueCardsFromRange`. Prefer over the action. */
+        queueCardsFromRange: (from: number, to: number, source: CardReplacementInputMethod, analyticsAction?: ACTION, normalizeLinkText?: boolean, sourceEvent?: UIAnalyticsEvent | null, appearance?: CardAppearance) => EditorCommand;
+    };
     dependencies: CardPluginDependencies;
     pluginConfiguration: CardPluginOptions | undefined;
     sharedState: CardPluginState | null;

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

@@ -12,6 +12,15 @@ import type { Request } from '../types';
 export declare const replaceQueuedUrlWithCard: (url: string, cardData: CardAdf | DatasourceAdf, analyticsAction?: ACTION, editorAnalyticsApi?: EditorAnalyticsAPI, createAnalyticsEvent?: CreateUIAnalyticsEvent, embedCardNodeTransformer?: EmbedCardNodeTransformer) => Command;
 export declare const handleFallbackWithAnalytics: (request: Request, editorAnalyticsApi: EditorAnalyticsAPI | undefined) => Command;
 export declare const queueCardsFromChangedTr: (state: EditorState, tr: Transaction, source: CardReplacementInputMethod, analyticsAction?: ACTION, normalizeLinkText?: boolean, sourceEvent?: UIAnalyticsEvent | null | undefined, appearance?: CardAppearance) => Transaction;
+/**
+ * Queue link-mark → smart-link resolution for text nodes within an explicit
+ * document range, rather than the entire step range of the transaction.
+ *
+ * Use this instead of `queueCardsFromChangedTr` when you know the exact range
+ * that was inserted/modified and want to avoid accidentally queuing pre-existing
+ * links that happen to fall within the broader step range.
+ */
+export declare const queueCardsFromRange: (state: EditorState, tr: Transaction, from: number, to: number, source: CardReplacementInputMethod, analyticsAction?: ACTION, normalizeLinkText?: boolean, sourceEvent?: UIAnalyticsEvent | null | undefined, appearance?: CardAppearance) => Transaction;
 export declare const queueCardFromChangedTr: (state: EditorState, tr: Transaction, source: CardReplacementInputMethod, analyticsAction: ACTION, normalizeLinkText?: boolean, sourceEvent?: UIAnalyticsEvent | null | undefined, previousAppearance?: CardAppearance | "url") => Transaction;
 export declare const convertHyperlinkToSmartCard: (state: EditorState, source: CardReplacementInputMethod, appearance: CardAppearance, normalizeLinkText?: boolean) => Transaction;
 export declare const changeSelectedCardToLink: (text?: string, href?: string, sendAnalytics?: boolean, node?: Node, pos?: number, editorAnalyticsApi?: EditorAnalyticsAPI) => Command;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-card",
-	"version": "16.5.4",
+	"version": "16.6.0",
 	"description": "Card plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -29,7 +29,7 @@
 	],
 	"atlaskit:src": "src/index.ts",
 	"dependencies": {
-		"@atlaskit/adf-schema": "^52.10.0",
+		"@atlaskit/adf-schema": "^52.11.0",
 		"@atlaskit/analytics-next": "^11.2.0",
 		"@atlaskit/custom-steps": "^0.16.0",
 		"@atlaskit/editor-card-provider": "^6.7.0",
@@ -62,7 +62,7 @@
 		"@atlaskit/primitives": "^19.0.0",
 		"@atlaskit/prosemirror-history": "^0.2.0",
 		"@atlaskit/smart-card": "^44.9.0",
-		"@atlaskit/tmp-editor-statsig": "^78.0.0",
+		"@atlaskit/tmp-editor-statsig": "^79.0.0",
 		"@atlaskit/tokens": "^13.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@emotion/react": "^11.7.1",
@@ -72,7 +72,7 @@
 		"uuid": "^3.1.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^114.26.0",
+		"@atlaskit/editor-common": "^114.29.0",
 		"@atlaskit/link-provider": "^4.4.0",
 		"react": "^18.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"