@atlaskit/editor-core 182.0.3 → 182.1.0

package/dist/cjs/editor-next/index.js

@@ -27,6 +27,7 @@ var _editorPropTypes = require("./utils/editorPropTypes");
 var _trackEditorActions = _interopRequireDefault(require("./utils/trackEditorActions"));
 var _onEditorCreated2 = _interopRequireDefault(require("./utils/onEditorCreated"));
 var _deprecationWarnings = _interopRequireDefault(require("./utils/deprecationWarnings"));
+var _featureFlagsFromProps = require("../create-editor/feature-flags-from-props");
 var _plugins = require("../plugins");
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
@@ -52,6 +53,9 @@ var EditorNext = /*#__PURE__*/function (_React$Component) {
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "handleAnalyticsEvent", function (data) {
       return (0, _analytics.fireAnalyticsEvent)(_this.createAnalyticsEvent)(data);
     });
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "getFeatureFlags", function () {
+      return (0, _featureFlagsFromProps.createFeatureFlagsFromProps)(_this.props);
+    });
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "getExperienceStore", function () {
       return _this.experienceStore;
     });
@@ -89,7 +93,7 @@ var EditorNext = /*#__PURE__*/function (_React$Component) {
   }, {
     key: "registerEditorForActions",
     value: function registerEditorForActions(editorView, eventDispatcher, contentTransformer) {
-      this.editorActions._privateRegisterEditor(editorView, eventDispatcher, contentTransformer);
+      this.editorActions._privateRegisterEditor(editorView, eventDispatcher, contentTransformer, this.getFeatureFlags);
     }
   }, {
     key: "unregisterEditorFromActions",

package/dist/cjs/editor.js

@@ -27,6 +27,7 @@ var _editorPropTypes = require("./editor-next/utils/editorPropTypes");
 var _trackEditorActions2 = _interopRequireDefault(require("./editor-next/utils/trackEditorActions"));
 var _onEditorCreated2 = _interopRequireDefault(require("./editor-next/utils/onEditorCreated"));
 var _deprecationWarnings = _interopRequireDefault(require("./editor-next/utils/deprecationWarnings"));
+var _featureFlagsFromProps = require("./create-editor/feature-flags-from-props");
 var _analytics = require("@atlaskit/editor-common/analytics");
 var _prepareQuickInsertProvider = _interopRequireDefault(require("./utils/prepare-quick-insert-provider"));
 var _prepareExtensionProvider = _interopRequireDefault(require("./utils/prepare-extension-provider"));
@@ -66,6 +67,9 @@ var Editor = /*#__PURE__*/function (_React$Component) {
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "handleAnalyticsEvent", function (data) {
       return (0, _analytics.fireAnalyticsEvent)(_this.createAnalyticsEvent)(data);
     });
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "getFeatureFlags", function () {
+      return (0, _featureFlagsFromProps.createFeatureFlagsFromProps)(_this.props);
+    });
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "getExperienceStore", function () {
       return _this.experienceStore;
     });
@@ -262,18 +266,18 @@ var Editor = /*#__PURE__*/function (_React$Component) {
      * and need to find a workaround.
      */
     function registerEditorForActions(editorView, eventDispatcher, contentTransformer) {
-      this.editorActions._privateRegisterEditor(editorView, eventDispatcher, contentTransformer);
+      this.editorActions._privateRegisterEditor(editorView, eventDispatcher, contentTransformer, this.getFeatureFlags);
     }
-
+  }, {
+    key: "unregisterEditorFromActions",
+    value:
     /**
      * @private
      * @deprecated - Do not override this at all, this is an antipattern.
      * Please reach out to the Editor team if you were previously using this
      * and need to find a workaround.
      */
-  }, {
-    key: "unregisterEditorFromActions",
-    value: function unregisterEditorFromActions() {
+    function unregisterEditorFromActions() {
       this.editorActions._privateUnregisterEditor();
     }
   }, {

package/dist/cjs/keymaps/index.js

@@ -285,6 +285,18 @@ Object.defineProperty(exports, "moveUp", {
     return _keymaps.moveUp;
   }
 });
+Object.defineProperty(exports, "navToEditorToolbar", {
+  enumerable: true,
+  get: function get() {
+    return _keymaps.navToEditorToolbar;
+  }
+});
+Object.defineProperty(exports, "navToFloatingToolbar", {
+  enumerable: true,
+  get: function get() {
+    return _keymaps.navToFloatingToolbar;
+  }
+});
 Object.defineProperty(exports, "nextCell", {
   enumerable: true,
   get: function get() {

package/dist/cjs/labs/next/internal/hooks/use-editor/index.js

@@ -13,8 +13,7 @@ var _utils = require("@atlaskit/editor-common/utils");
 var _measureEnum = _interopRequireDefault(require("../../../../../utils/performance/measure-enum"));
 var _utils2 = require("../../../../../utils");
 var _analytics = require("../../../../../plugins/analytics");
-var _getEnabledFeatureFlagKeys = require("../../../../../plugins/feature-flags-context/get-enabled-feature-flag-keys");
-var _featureFlagsContext = require("../../../../../plugins/feature-flags-context/");
+var _normalizeFeatureFlags = require("@atlaskit/editor-common/normalize-feature-flags");
 var _useAnalytics = require("../use-analytics");
 var _createDispatchTransaction = require("./create-dispatch-transaction");
 var _createEditor = require("./create-editor");
@@ -28,7 +27,7 @@ function useEditor(config) {
     editorSharedConfig = _useCreateEditor2[0],
     mountEditor = _useCreateEditor2[1];
   useApplyEditorViewProps(editorSharedConfig, config.disabled);
-  useHandleEditorLifecycle(editorSharedConfig);
+  useHandleEditorLifecycle(editorSharedConfig, config.featureFlags);
   (0, _useAnalytics.useAnalyticsHandler)(editorSharedConfig);
   return [editorSharedConfig, mountEditor];
 }
@@ -127,7 +126,7 @@ function useApplyEditorViewProps(editorSharedConfig, disabled) {
 /**
  * Handles editor component unmount
  */
-function useHandleEditorLifecycle(editorSharedConfig) {
+function useHandleEditorLifecycle(editorSharedConfig, featureFlags) {
   _react.default.useEffect(function () {
     //#region Did mount
     if (editorSharedConfig) {
@@ -140,8 +139,7 @@ function useHandleEditorLifecycle(editorSharedConfig) {
       if (onMount) {
         onMount(editorActions);
       }
-      var featureFlags = (0, _featureFlagsContext.getFeatureFlags)(editorSharedConfig.editorView.state);
-      var featureFlagsEnabled = featureFlags ? (0, _getEnabledFeatureFlagKeys.getEnabledFeatureFlagKeys)(featureFlags) : [];
+      var featureFlagsEnabled = featureFlags ? (0, _normalizeFeatureFlags.getEnabledFeatureFlagKeys)(featureFlags) : [];
 
       // Fire editor started event
       dispatch(_consts.analyticsEventKey, {
@@ -191,5 +189,5 @@ function useHandleEditorLifecycle(editorSharedConfig) {
         editorView.destroy();
       }
     };
-  }, [editorSharedConfig]);
+  }, [editorSharedConfig, featureFlags]);
 }

package/dist/cjs/labs/next/presets/default.js

@@ -18,7 +18,6 @@ var _editorDisabled = _interopRequireDefault(require("../../../plugins/editor-di
 var _typeAhead = _interopRequireDefault(require("../../../plugins/type-ahead"));
 var _submitEditor = _interopRequireDefault(require("../../../plugins/submit-editor"));
 var _fakeTextCursor = _interopRequireDefault(require("../../../plugins/fake-text-cursor"));
-var _featureFlagsContext = _interopRequireDefault(require("../../../plugins/feature-flags-context"));
 var _editorPluginFeatureFlags = _interopRequireDefault(require("@atlaskit/editor-plugin-feature-flags"));
 var _floatingToolbar = _interopRequireDefault(require("../../../plugins/floating-toolbar"));
 var _clipboard = _interopRequireDefault(require("../../../plugins/clipboard"));
@@ -52,7 +51,7 @@ function createDefaultPreset(options) {
     return builder;
   }).add([_hyperlink.default, options.hyperlinkOptions]).add([_textFormatting.default, options.textFormatting]).add(_width.default).add([_quickInsert.default, options.quickInsert]).add([_typeAhead.default, options.typeAhead || {
     createAnalyticsEvent: options.createAnalyticsEvent
-  }]).add(_unsupportedContent.default).add(_editorDisabled.default).add([_submitEditor.default, options.submitEditor]).add(_fakeTextCursor.default).add(_floatingToolbar.default).add([_featureFlagsContext.default, options.featureFlags || {}]).add([_selection.default, options.selection]).add([_codeBlock.default, options.codeBlock || {
+  }]).add(_unsupportedContent.default).add(_editorDisabled.default).add([_submitEditor.default, options.submitEditor]).add(_fakeTextCursor.default).add(_floatingToolbar.default).add([_selection.default, options.selection]).add([_codeBlock.default, options.codeBlock || {
     appearance: 'full-page'
   }]);
   return preset;

package/dist/cjs/plugins/card/index.js

@@ -1,17 +1,21 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 var _adfSchema = require("@atlaskit/adf-schema");
 var _main = require("./pm-plugins/main");
 var _toolbar = require("./toolbar");
 var _EditorSmartCardEvents = require("./ui/EditorSmartCardEvents");
 var _keymap = require("./pm-plugins/keymap");
+var _EditorSmartCardEventsNext = require("./ui/EditorSmartCardEventsNext");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 var cardPlugin = function cardPlugin(options, api) {
@@ -36,16 +40,20 @@ var cardPlugin = function cardPlugin(options, api) {
       return nodes;
     },
     pmPlugins: function pmPlugins() {
-      var _options$allowBlockCa, _options$allowResizin, _options$useAlternati;
+      var _options$allowBlockCa, _options$allowResizin, _options$useAlternati, _options$allowWrappin, _options$allowAlignme;
       var allowBlockCards = (_options$allowBlockCa = options.allowBlockCards) !== null && _options$allowBlockCa !== void 0 ? _options$allowBlockCa : true;
       var allowResizing = (_options$allowResizin = options.allowResizing) !== null && _options$allowResizin !== void 0 ? _options$allowResizin : true;
       var useAlternativePreloader = (_options$useAlternati = options.useAlternativePreloader) !== null && _options$useAlternati !== void 0 ? _options$useAlternati : true;
+      var allowWrapping = (_options$allowWrappin = options.allowWrapping) !== null && _options$allowWrappin !== void 0 ? _options$allowWrappin : true;
+      var allowAlignment = (_options$allowAlignme = options.allowAlignment) !== null && _options$allowAlignme !== void 0 ? _options$allowAlignme : true;
       var plugins = [{
         name: 'card',
         plugin: (0, _main.createPlugin)(_objectSpread(_objectSpread({}, options), {}, {
           allowBlockCards: allowBlockCards,
           allowResizing: allowResizing,
-          useAlternativePreloader: useAlternativePreloader
+          useAlternativePreloader: useAlternativePreloader,
+          allowWrapping: allowWrapping,
+          allowAlignment: allowAlignment
         }))
       }];
       plugins.push({
@@ -59,9 +67,12 @@ var cardPlugin = function cardPlugin(options, api) {
     },
     contentComponent: function contentComponent(_ref2) {
       var editorView = _ref2.editorView;
-      return /*#__PURE__*/_react.default.createElement(_EditorSmartCardEvents.EditorSmartCardEvents, {
+      var lpAnalyticsEventsNext = featureFlags.lpAnalyticsEventsNext;
+      return /*#__PURE__*/_react.default.createElement(_react.Fragment, null, /*#__PURE__*/_react.default.createElement(_EditorSmartCardEvents.EditorSmartCardEvents, {
         editorView: editorView
-      });
+      }), lpAnalyticsEventsNext && /*#__PURE__*/_react.default.createElement(_EditorSmartCardEventsNext.EditorSmartCardEventsNext, {
+        editorView: editorView
+      }));
     },
     pluginsOptions: {
       floatingToolbar: (0, _toolbar.floatingToolbar)(options, featureFlags, options.platform, options.linkPicker)

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.showLinkToolbar = exports.setProvider = exports.resolveCard = exports.registerSmartCardEvents = exports.registerCard = exports.queueCards = exports.hideLinkToolbar = exports.cardAction = void 0;
+exports.showLinkToolbar = exports.setProvider = exports.resolveCard = exports.registerSmartCardEventsNext = exports.registerSmartCardEvents = exports.registerCard = exports.queueCards = exports.hideLinkToolbar = exports.cardAction = void 0;
 var _pluginKey = require("./plugin-key");
 var cardAction = function cardAction(tr, action) {
   return tr.setMeta(_pluginKey.pluginKey, action);
@@ -45,6 +45,15 @@ var registerSmartCardEvents = function registerSmartCardEvents(smartLinkEvents)
   };
 };
 exports.registerSmartCardEvents = registerSmartCardEvents;
+var registerSmartCardEventsNext = function registerSmartCardEventsNext(smartLinkEvents) {
+  return function (tr) {
+    return cardAction(tr, {
+      type: 'REGISTER_EVENTS_NEXT',
+      smartLinkEvents: smartLinkEvents
+    });
+  };
+};
+exports.registerSmartCardEventsNext = registerSmartCardEventsNext;
 var setProvider = function setProvider(cardProvider) {
   return function (tr) {
     return cardAction(tr, {

package/dist/cjs/plugins/card/pm-plugins/analytics/create-analytics-queue.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createAnalyticsQueue = void 0;
+/**
+ * Simple mechanism to defer analytics related callbacks
+ */
+var createAnalyticsQueue = function createAnalyticsQueue() {
+  var enabled = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+  var queue = [];
+  var callbacksRef = {
+    current: null
+  };
+  var setCallbacks = function setCallbacks(callbacks) {
+    callbacksRef.current = callbacks;
+  };
+  var push = function push() {
+    var callbacks = callbacksRef.current;
+    if (!enabled || !callbacks) {
+      return;
+    }
+    queue.push.apply(queue, arguments);
+  };
+  var flush = function flush() {
+    var callbacks = callbacksRef.current;
+    if (!enabled || !callbacks) {
+      return;
+    }
+    while (queue.length) {
+      var event = queue.pop();
+      if (event) {
+        callbacks[event.type](event.data);
+      }
+    }
+  };
+  var getSize = function getSize() {
+    return queue.length;
+  };
+  return {
+    push: push,
+    flush: flush,
+    setCallbacks: setCallbacks,
+    getSize: getSize
+  };
+};
+exports.createAnalyticsQueue = createAnalyticsQueue;

package/dist/cjs/plugins/card/pm-plugins/analytics/events-from-tr.js

@@ -0,0 +1,337 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.eventsFromTransaction = eventsFromTransaction;
+exports.findChangedLinks = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var _prosemirrorTransform = require("prosemirror-transform");
+var _analytics = require("@atlaskit/editor-common/analytics");
+var _utils = require("@atlaskit/editor-common/utils");
+var _card = require("@atlaskit/editor-common/card");
+var _steps = require("@atlaskit/adf-schema/steps");
+var _pmHistoryTypes = require("../../../history/pm-history-types");
+var _state = require("../util/state");
+var _pluginKey = require("../plugin-key");
+var _utils2 = require("./utils");
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+var findLinksInNodeRange = function findLinksInNodeRange(node, schema, from, to) {
+  var links = [];
+  node.nodesBetween(from, to, function (node, pos) {
+    if ((0, _utils2.isLink)(schema, node)) {
+      var entireLinkInRange = pos >= from && pos + node.nodeSize <= to;
+      if (entireLinkInRange) {
+        var link = (0, _utils2.linkObjectFromNode)(schema, node, pos);
+        if (link) {
+          links.push(link);
+        }
+      }
+    }
+  });
+  return links;
+};
+var findChangedLinks = function findChangedLinks(tr, state) {
+  var schema = tr.doc.type.schema;
+  var removed = [];
+  var inserted = [];
+  var updated = [];
+  var queuedForUpgrade = isTransactionQueuedForUpgrade(tr);
+  var isResolveReplace = isTransactionResolveReplace(tr);
+
+  // History
+  var historyMeta = tr.getMeta(_pmHistoryTypes.pmHistoryPluginKey);
+  var isUndo = isHistoryMeta(historyMeta) && historyMeta.redo === false;
+  var isRedo = isHistoryMeta(historyMeta) && historyMeta.redo === true;
+  var isUpdate = isUpdateTr(tr, isUndo || isRedo);
+  var _loop = function _loop(i) {
+    var step = tr.steps[i];
+    var stepMap = step.getMap();
+    var removedInStep = [];
+    var insertedInStep = [];
+
+    /**
+     * AddMarkStep and RemoveMarkSteps don't produce stepMap ranges
+     * because there are no "changed tokens" only marks added/removed
+     * So have to check these manually
+     */
+    if (step instanceof _prosemirrorTransform.AddMarkStep) {
+      var addMarkStep = step;
+      if ((0, _utils.isLinkMark)(addMarkStep.mark, schema)) {
+        /**
+         * For url text pasted on plain text
+         */
+        insertedInStep.push({
+          type: 'mark',
+          pos: addMarkStep.from,
+          mark: addMarkStep.mark
+        });
+      }
+    }
+    if (step instanceof _prosemirrorTransform.RemoveMarkStep) {
+      var removeMarkStep = step;
+      if ((0, _utils.isLinkMark)(removeMarkStep.mark, schema)) {
+        /**
+         * For url text pasted on plain text
+         */
+        removedInStep.push({
+          type: 'mark',
+          pos: removeMarkStep.from,
+          mark: removeMarkStep.mark
+        });
+      }
+    }
+    stepMap.forEach(function (oldStart, oldEnd, newStart, newEnd) {
+      var _tr$docs;
+      var before = tr.docs[i];
+      var after = (_tr$docs = tr.docs[i + 1]) !== null && _tr$docs !== void 0 ? _tr$docs : tr.doc;
+      var removedInRange = [];
+      var insertedInRange = [];
+
+      // Removed
+      removedInRange.push.apply(removedInRange, (0, _toConsumableArray2.default)(findLinksInNodeRange(before, schema, oldStart, oldEnd)));
+      // Inserted
+      insertedInRange.push.apply(insertedInRange, (0, _toConsumableArray2.default)(findLinksInNodeRange(after, schema, newStart, newEnd)));
+      removedInStep.push.apply(removedInStep, removedInRange);
+      insertedInStep.push.apply(insertedInStep, insertedInRange);
+    });
+    var omitQueuedLinks = function omitQueuedLinks(links) {
+      if (!queuedForUpgrade) {
+        return links;
+      }
+      /**
+       * Skip/filter out links that have been queued, they will be tracked later
+       */
+      var queuedPositions = getQueuedPositions(tr);
+      return links.filter(function (link) {
+        return !queuedPositions.includes(link.pos);
+      });
+    };
+
+    /**
+     * Skip "deletions" when the transaction is relating to
+     * replacing links queued for upgrade to cards,
+     * because the "deleted" link has not actually been
+     * tracked as "created" yet
+     */
+    if (!isResolveReplace) {
+      removed.push.apply(removed, removedInStep);
+    }
+    inserted.push.apply(inserted, (0, _toConsumableArray2.default)(omitQueuedLinks(insertedInStep)));
+  };
+  for (var i = 0; i < tr.steps.length; i++) {
+    _loop(i);
+  }
+
+  /**
+   * If there are no links changed but the transaction is a "resolve" action
+   * Then this means we have resolved a link but it has failed to upgrade
+   * We should track all resolved links as now being created
+   */
+  if (inserted.length === 0 && isResolveReplace) {
+    var positions = getResolvePositions(tr, state);
+    inserted.push.apply(inserted, (0, _toConsumableArray2.default)((0, _utils2.findLinksAtPositions)(tr, positions)));
+  }
+  if (!isUpdate) {
+    return {
+      removed: removed,
+      inserted: inserted,
+      updated: updated
+    };
+  }
+  for (var _i = 0; _i < inserted.length; _i++) {
+    if (isResolveReplace) {
+      var newLink = inserted[_i];
+
+      // what is the 2nd argument 'assoc = -1' doing here exactly?
+      var mappedPos = tr.mapping.map(newLink.pos, -1);
+      var previousDisplay = getResolveLinkPrevDisplay(state, mappedPos);
+      updated.push({
+        inserted: inserted[_i],
+        previous: {
+          display: previousDisplay
+        }
+      });
+      continue;
+    }
+    if (inserted.length === removed.length) {
+      updated.push({
+        removed: removed[_i],
+        inserted: inserted[_i]
+      });
+    }
+  }
+  return {
+    inserted: [],
+    removed: [],
+    updated: updated
+  };
+};
+
+/**
+ * List of actions to be considered link "updates"
+ */
+exports.findChangedLinks = findChangedLinks;
+var UPDATE_ACTIONS = [_analytics.ACTION.CHANGED_TYPE, _analytics.ACTION.UPDATED];
+
+/**
+ * Returns true if the transaction has LinkMetaSteps that indicate the transaction is
+ * intended to be perceived as an update to links, rather than insertion+deletion
+ */
+var isUpdateTr = function isUpdateTr(tr, isUndoOrRedo) {
+  return !!tr.steps.find(function (step) {
+    if (!(step instanceof _steps.LinkMetaStep)) {
+      return false;
+    }
+    var _step$getMetadata = step.getMetadata(),
+      action = _step$getMetadata.action,
+      cardAction = _step$getMetadata.cardAction;
+
+    /**
+     * Undo of a resolve step should be considered an update
+     * because the user is choosing to update the url back to the un-upgraded display
+     */
+    if (cardAction === 'RESOLVE' && isUndoOrRedo) {
+      return true;
+    }
+    if (!action) {
+      return false;
+    }
+    return UPDATE_ACTIONS.includes(action);
+  });
+};
+var hasType = function hasType(pluginMeta) {
+  return (0, _typeof2.default)(pluginMeta) === 'object' && pluginMeta !== null && 'type' in pluginMeta;
+};
+var isTransactionQueuedForUpgrade = function isTransactionQueuedForUpgrade(tr) {
+  var pluginMeta = tr.getMeta(_pluginKey.pluginKey);
+  return hasType(pluginMeta) && pluginMeta.type === 'QUEUE';
+};
+var isTransactionResolveReplace = function isTransactionResolveReplace(tr) {
+  var pluginMeta = tr.getMeta(_pluginKey.pluginKey);
+  return hasType(pluginMeta) && pluginMeta.type === 'RESOLVE';
+};
+var isHistoryMeta = function isHistoryMeta(meta) {
+  return (0, _typeof2.default)(meta) === 'object' && meta !== null && 'redo' in meta;
+};
+var getQueuedPositions = function getQueuedPositions(tr) {
+  var pluginMeta = tr.getMeta(_pluginKey.pluginKey);
+  if (!isTransactionQueuedForUpgrade(tr)) {
+    return [];
+  }
+  return pluginMeta.requests.map(function (_ref) {
+    var pos = _ref.pos;
+    return pos;
+  });
+};
+var getResolvePositions = function getResolvePositions(tr, state) {
+  var cardState = (0, _state.getPluginState)(state);
+  if (!cardState) {
+    return [];
+  }
+  var pluginMeta = tr.getMeta(_pluginKey.pluginKey);
+  if (!isTransactionResolveReplace(tr)) {
+    return [];
+  }
+  return cardState.requests.filter(function (request) {
+    return request.url === pluginMeta.url;
+  }).map(function (request) {
+    return request.pos;
+  });
+};
+var getResolveLinkPrevDisplay = function getResolveLinkPrevDisplay(state, pos) {
+  var _cardState$requests$f;
+  var cardState = (0, _state.getPluginState)(state);
+  if (!cardState) {
+    return undefined;
+  }
+  return (_cardState$requests$f = cardState.requests.find(function (request) {
+    return request.pos === pos;
+  })) === null || _cardState$requests$f === void 0 ? void 0 : _cardState$requests$f.previousAppearance;
+};
+function eventsFromTransaction(tr, state) {
+  var events = [];
+  try {
+    /**
+     * Skip transactions sent by collab (identified by 'isRemote' key)
+     * Skip entire document replace steps
+     * We are only concerned with transactions performed on the document directly by the user
+     */
+    var isRemote = tr.getMeta('isRemote');
+    var isReplaceDocument = tr.getMeta('replaceDocument');
+    if (isRemote || isReplaceDocument) {
+      return events;
+    }
+    var historyMeta = tr.getMeta(_pmHistoryTypes.pmHistoryPluginKey);
+    var isUndo = isHistoryMeta(historyMeta) && historyMeta.redo === false;
+    var isRedo = isHistoryMeta(historyMeta) && historyMeta.redo === true;
+
+    /**
+     * Retrieve metadata from the LinkMetaStep(s) in the transaction
+     */
+    var _getLinkMetadataFromT = (0, _card.getLinkMetadataFromTransaction)(tr),
+      action = _getLinkMetadataFromT.action,
+      inputMethod = _getLinkMetadataFromT.inputMethod,
+      sourceEvent = _getLinkMetadataFromT.sourceEvent;
+    var contextualData = {
+      action: action,
+      inputMethod: inputMethod,
+      sourceEvent: sourceEvent,
+      isUndo: isUndo,
+      isRedo: isRedo
+    };
+    var _findChangedLinks = findChangedLinks(tr, state),
+      removed = _findChangedLinks.removed,
+      inserted = _findChangedLinks.inserted,
+      updated = _findChangedLinks.updated;
+    var MAX_LINK_EVENTS = 10;
+    if ([removed, inserted, updated].some(function (arr) {
+      return arr.length > MAX_LINK_EVENTS;
+    })) {
+      return [];
+    }
+    for (var i = 0; i < updated.length; i++) {
+      var _update$previous$disp;
+      var update = updated[i];
+      var link = update.inserted;
+      var url = (0, _utils2.getLinkUrl)(link);
+      var display = (0, _utils2.appearanceForLink)(link);
+      var previousDisplay = 'removed' in update ? (0, _utils2.appearanceForLink)(update.removed) : (_update$previous$disp = update.previous.display) !== null && _update$previous$disp !== void 0 ? _update$previous$disp : 'unknown';
+      if (url) {
+        events.push({
+          type: 'updated',
+          data: _objectSpread(_objectSpread({}, contextualData), {}, {
+            url: url,
+            display: display,
+            previousDisplay: previousDisplay
+          })
+        });
+      }
+    }
+    var pushEvents = function pushEvents(links, type) {
+      for (var _i2 = 0; _i2 < links.length; _i2++) {
+        var _link = links[_i2];
+        var _url = (0, _utils2.getLinkUrl)(_link);
+        var _display = (0, _utils2.appearanceForLink)(_link);
+        if (_url) {
+          events.push({
+            type: type,
+            data: _objectSpread(_objectSpread({}, contextualData), {}, {
+              url: _url,
+              display: _display
+            })
+          });
+        }
+      }
+    };
+    pushEvents(removed, 'deleted');
+    pushEvents(inserted, 'created');
+    return events;
+  } catch (err) {
+    return events;
+  }
+}

package/dist/cjs/plugins/card/pm-plugins/analytics/index.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "createAnalyticsQueue", {
+  enumerable: true,
+  get: function get() {
+    return _createAnalyticsQueue.createAnalyticsQueue;
+  }
+});
+Object.defineProperty(exports, "eventsFromTransaction", {
+  enumerable: true,
+  get: function get() {
+    return _eventsFromTr.eventsFromTransaction;
+  }
+});
+var _createAnalyticsQueue = require("./create-analytics-queue");
+var _eventsFromTr = require("./events-from-tr");

package/dist/cjs/plugins/card/pm-plugins/analytics/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});