@atlaskit/editor-plugin-synced-block 10.0.21 → 10.1.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @atlaskit/editor-plugin-synced-block
 
+## 10.1.0
+
+### Minor Changes
+
+- [`ecafba7c81b7d`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/ecafba7c81b7d) -
+  Enrich synced block deletion analytics so source-block deletions can be explained rather than just
+  counted. The source `syncedBlockDelete` operational event now carries `deletionReason` and a
+  `mechanism` dimension (undo/redo/deleteButton/keyboardDelete/selectionReplaced/other), and
+  repeated emissions for the same removal are de-duplicated. A real operational `syncedBlockCreate`
+  success event is now emitted, and the source bare-uuid join key is added to the copy event so
+  create/copy/delete can be correlated. All new attributes and events are gated behind
+  `platform_editor_blocks_patch_4`; gate-off behaviour is unchanged.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 10.0.21
 
 ### Patch Changes

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

@@ -158,6 +158,10 @@ var copySyncedBlockReferenceToClipboardInternal = function copySyncedBlockRefere
   }
   var domNode = (0, _copyButton.toDOM)(referenceSyncBlockNode, schema);
   (0, _copyButton.copyDomNode)(domNode, referenceSyncBlockNode.type, selection);
+
+  // Bare-uuid join key shared with the create/delete events: for a source
+  // bodiedSyncBlock its `localId` is the source uuid (copy was page-form only).
+  var sourceJoinKey = isBodiedSyncBlock ? syncBlockFindResult.node.attrs.localId : undefined;
   (0, _utils2.deferDispatch)(function () {
     api === null || api === void 0 || api.core.actions.execute(function (_ref3) {
       var _api$analytics4;
@@ -167,10 +171,12 @@ var copySyncedBlockReferenceToClipboardInternal = function copySyncedBlockRefere
         action: _analytics.ACTION.COPIED,
         actionSubject: _analytics.ACTION_SUBJECT.SYNCED_BLOCK,
         actionSubjectId: _analytics.ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY,
-        attributes: {
+        attributes: _objectSpread({
           resourceId: referenceSyncBlockNode.attrs.resourceId,
           inputMethod: inputMethod
-        }
+        }, sourceJoinKey && (0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_4') && {
+          blockInstanceId: sourceJoinKey
+        })
       });
       return tr.setMeta(_main.syncedBlockPluginKey, {
         activeFlag: {
@@ -246,6 +252,13 @@ var removeSyncedBlock = exports.removeSyncedBlock = function removeSyncedBlock(a
     if (!removeTr) {
       return false;
     }
+
+    // Tag the transaction so analytics can report this as `deleteButton` rather
+    // than a keyboard delete (both produce a plain ReplaceStep). Gated so the
+    // gate-off transaction is unchanged.
+    if ((0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_4')) {
+      removeTr.setMeta(_main.deleteMechanismMetaKey, 'deleteButton');
+    }
     dispatch(removeTr);
     api === null || api === void 0 || api.core.actions.focus();
     return true;

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

@@ -4,10 +4,11 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.syncedBlockPluginKey = exports.createPlugin = void 0;
+exports.syncedBlockPluginKey = exports.getDeleteMechanism = exports.deleteMechanismMetaKey = exports.createPlugin = void 0;
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _analytics = require("@atlaskit/editor-common/analytics");
 var _collab = require("@atlaskit/editor-common/collab");
@@ -41,6 +42,17 @@ function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 var syncedBlockPluginKey = exports.syncedBlockPluginKey = new _state.PluginKey('syncedBlockPlugin');
+
+/**
+ * Dedicated transaction-meta {@link PluginKey} the synced-block removal command
+ * sets so {@link getDeleteMechanism} can report a toolbar Delete as
+ * `deleteButton` (otherwise indistinguishable from a keyboard delete — both are
+ * plain ReplaceSteps). A separate key (rather than `syncedBlockPluginKey`, which
+ * carries plugin-state transitions read in `apply()`, or a bare string) keeps
+ * this transient signal uniquely namespaced and isolated. Only read behind
+ * `platform_editor_blocks_patch_4`.
+ */
+var deleteMechanismMetaKey = exports.deleteMechanismMetaKey = new _state.PluginKey('syncedBlockDeleteMechanism');
 var mapRetryCreationPosMap = function mapRetryCreationPosMap(oldMap, newRetryCreationPos, mapPos, isPerfExperimentOn) {
   var resourceId = newRetryCreationPos === null || newRetryCreationPos === void 0 ? void 0 : newRetryCreationPos.resourceId;
 
@@ -121,6 +133,55 @@ var getDeleteReason = function getDeleteReason(tr) {
   }
   return reason;
 };
+
+/** Narrows the history plugin meta, matching the editor-plugin-card pattern. */
+var isHistoryMeta = function isHistoryMeta(meta) {
+  return (0, _typeof2.default)(meta) === 'object' && meta !== null && 'redo' in meta;
+};
+
+/**
+ * Derive how a source bodiedSyncBlock removal was performed, for the `mechanism`
+ * analytics dimension. Each value names the user action; most-specific wins:
+ *  - `undo` / `redo` — history transaction.
+ *  - `deleteButton` — the explicit "Delete" control in the synced-block toolbar
+ *    (the removal command tags its transaction with {@link deleteMechanismMetaKey}).
+ *  - `selectionReplaced` — ReplaceStep on a node-selected block (the
+ *    accidental-overwrite path: block selected, then typed/pasted over).
+ *  - `keyboardDelete` — ReplaceStep removal at a caret/range selection
+ *    (Backspace/Delete key).
+ *  - `other` — anything else (unsync, conversion, code-dispatched, or a
+ *    structural `ReplaceAroundStep` such as wrap/lift/unwrap).
+ *
+ * Only a plain `ReplaceStep` counts as a direct user deletion. `ReplaceAroundStep`
+ * is used for wrapping/lifting/unwrapping content, not direct removal, so a
+ * removal carried by one is classified as `other` rather than misreported as a
+ * keyboard delete.
+ *
+ * `state` is the pre-transaction state, so its selection reflects what was
+ * selected when the edit was made.
+ */
+var getDeleteMechanism = exports.getDeleteMechanism = function getDeleteMechanism(tr, state) {
+  var _selection$node;
+  var historyMeta = tr.getMeta(_utils.pmHistoryPluginKey);
+  if (historyMeta) {
+    return isHistoryMeta(historyMeta) && historyMeta.redo ? 'redo' : 'undo';
+  }
+
+  // The toolbar Delete control tags its transaction so we can report it
+  // distinctly from a keyboard delete (both produce a plain ReplaceStep).
+  if (tr.getMeta(deleteMechanismMetaKey) === 'deleteButton') {
+    return 'deleteButton';
+  }
+  var hasReplaceStep = tr.steps.some(function (step) {
+    return step instanceof _transform.ReplaceStep;
+  });
+  if (!hasReplaceStep) {
+    return 'other';
+  }
+  var selection = state.selection;
+  var isNodeSelected = selection instanceof _state.NodeSelection && ((_selection$node = selection.node) === null || _selection$node === void 0 ? void 0 : _selection$node.type.name) === 'bodiedSyncBlock';
+  return isNodeSelected ? 'selectionReplaced' : 'keyboardDelete';
+};
 var filterTransactionOnline = function filterTransactionOnline(_ref3) {
   var _tr$getMeta;
   var tr = _ref3.tr,
@@ -180,7 +241,9 @@ var filterTransactionOnline = function filterTransactionOnline(_ref3) {
       // eslint-disable-next-line no-param-reassign
       confirmationTransactionRef.current = tr;
     }
-    return (0, _handleBodiedSyncBlockRemoval.handleBodiedSyncBlockRemoval)(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, getDeleteReason(tr));
+    // Only derive the mechanism behind the gate — discarded gate-off.
+    var mechanism = (0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_4') ? getDeleteMechanism(tr, state) : undefined;
+    return (0, _handleBodiedSyncBlockRemoval.handleBodiedSyncBlockRemoval)(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, getDeleteReason(tr), mechanism);
   }
   if (bodiedSyncBlockAdded.length > 0) {
     if (tr.getMeta(_utils.pmHistoryPluginKey)) {

package/dist/cjs/pm-plugins/utils/handle-bodied-sync-block-removal.js

@@ -34,7 +34,7 @@ var onDismissed = function onDismissed(syncBlockStore) {
     });
   };
 };
-var handleBodiedSyncBlockRemoval = exports.handleBodiedSyncBlockRemoval = function handleBodiedSyncBlockRemoval(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, deletionReason) {
+var handleBodiedSyncBlockRemoval = exports.handleBodiedSyncBlockRemoval = function handleBodiedSyncBlockRemoval(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, deletionReason, mechanism) {
   // Clear potential old pending deletion to retreat the deletion as first attempt
   syncBlockStore.sourceManager.clearPendingDeletion();
 
@@ -121,6 +121,6 @@ var handleBodiedSyncBlockRemoval = exports.handleBodiedSyncBlockRemoval = functi
     });
   }, function () {
     confirmationTransactionRef.current = undefined;
-  });
+  }, mechanism);
   return false;
 };

package/dist/es2019/editor-commands/index.js

@@ -5,7 +5,7 @@ import { DOMSerializer, Fragment } from '@atlaskit/editor-prosemirror/model';
 import { NodeSelection, TextSelection } from '@atlaskit/editor-prosemirror/state';
 import { findSelectedNodeOfType, removeParentNodeOfType, removeSelectedNode, safeInsert } from '@atlaskit/editor-prosemirror/utils';
 import { fg } from '@atlaskit/platform-feature-flags';
-import { syncedBlockPluginKey } from '../pm-plugins/main';
+import { deleteMechanismMetaKey, syncedBlockPluginKey } from '../pm-plugins/main';
 import { canBeConvertedToSyncBlock, deferDispatch, findSyncBlock, findSyncBlockOrBodiedSyncBlock, isBodiedSyncBlockNode } from '../pm-plugins/utils/utils';
 import { FLAG_ID } from '../types';
 import { findBodiedSyncBlockByLocalId, pasteSyncBlockHTMLContent } from './utils';
@@ -153,6 +153,10 @@ const copySyncedBlockReferenceToClipboardInternal = (schema, selection, syncBloc
   }
   const domNode = toDOM(referenceSyncBlockNode, schema);
   copyDomNode(domNode, referenceSyncBlockNode.type, selection);
+
+  // Bare-uuid join key shared with the create/delete events: for a source
+  // bodiedSyncBlock its `localId` is the source uuid (copy was page-form only).
+  const sourceJoinKey = isBodiedSyncBlock ? syncBlockFindResult.node.attrs.localId : undefined;
   deferDispatch(() => {
     api === null || api === void 0 ? void 0 : api.core.actions.execute(({
       tr
@@ -165,7 +169,10 @@ const copySyncedBlockReferenceToClipboardInternal = (schema, selection, syncBloc
         actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY,
         attributes: {
           resourceId: referenceSyncBlockNode.attrs.resourceId,
-          inputMethod
+          inputMethod,
+          ...(sourceJoinKey && fg('platform_editor_blocks_patch_4') && {
+            blockInstanceId: sourceJoinKey
+          })
         }
       });
       return tr.setMeta(syncedBlockPluginKey, {
@@ -246,6 +253,13 @@ export const removeSyncedBlock = api => (state, dispatch, _view) => {
   if (!removeTr) {
     return false;
   }
+
+  // Tag the transaction so analytics can report this as `deleteButton` rather
+  // than a keyboard delete (both produce a plain ReplaceStep). Gated so the
+  // gate-off transaction is unchanged.
+  if (fg('platform_editor_blocks_patch_4')) {
+    removeTr.setMeta(deleteMechanismMetaKey, 'deleteButton');
+  }
   dispatch(removeTr);
   api === null || api === void 0 ? void 0 : api.core.actions.focus();
   return true;

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

@@ -6,7 +6,7 @@ import { createSelectionClickHandler } from '@atlaskit/editor-common/selection';
 import { BodiedSyncBlockSharedCssClassName, SyncBlockStateCssClassName } from '@atlaskit/editor-common/sync-block';
 import { mapSlice, pmHistoryPluginKey } from '@atlaskit/editor-common/utils';
 import { isOfflineMode } from '@atlaskit/editor-plugin-connectivity';
-import { PluginKey } from '@atlaskit/editor-prosemirror/state';
+import { NodeSelection, PluginKey } from '@atlaskit/editor-prosemirror/state';
 import { ReplaceAroundStep, ReplaceStep } from '@atlaskit/editor-prosemirror/transform';
 import { DecorationSet, Decoration } from '@atlaskit/editor-prosemirror/view';
 import { convertPMNodesToSyncBlockNodes, rebaseTransaction } from '@atlaskit/editor-synced-block-provider';
@@ -26,6 +26,17 @@ import { hasEditInSyncBlock, trackSyncBlocks } from './utils/track-sync-blocks';
 import { transactionInsertsSyncedBlock } from './utils/transaction-inserts-synced-block';
 import { deferDispatch, wasExtensionInsertedInBodiedSyncBlock, sliceFullyContainsNode } from './utils/utils';
 export const syncedBlockPluginKey = new PluginKey('syncedBlockPlugin');
+
+/**
+ * Dedicated transaction-meta {@link PluginKey} the synced-block removal command
+ * sets so {@link getDeleteMechanism} can report a toolbar Delete as
+ * `deleteButton` (otherwise indistinguishable from a keyboard delete — both are
+ * plain ReplaceSteps). A separate key (rather than `syncedBlockPluginKey`, which
+ * carries plugin-state transitions read in `apply()`, or a bare string) keeps
+ * this transient signal uniquely namespaced and isolated. Only read behind
+ * `platform_editor_blocks_patch_4`.
+ */
+export const deleteMechanismMetaKey = new PluginKey('syncedBlockDeleteMechanism');
 const mapRetryCreationPosMap = (oldMap, newRetryCreationPos, mapPos, isPerfExperimentOn) => {
   const resourceId = newRetryCreationPos === null || newRetryCreationPos === void 0 ? void 0 : newRetryCreationPos.resourceId;
 
@@ -95,6 +106,53 @@ const getDeleteReason = tr => {
   }
   return reason;
 };
+
+/** Narrows the history plugin meta, matching the editor-plugin-card pattern. */
+const isHistoryMeta = meta => typeof meta === 'object' && meta !== null && 'redo' in meta;
+
+/**
+ * Derive how a source bodiedSyncBlock removal was performed, for the `mechanism`
+ * analytics dimension. Each value names the user action; most-specific wins:
+ *  - `undo` / `redo` — history transaction.
+ *  - `deleteButton` — the explicit "Delete" control in the synced-block toolbar
+ *    (the removal command tags its transaction with {@link deleteMechanismMetaKey}).
+ *  - `selectionReplaced` — ReplaceStep on a node-selected block (the
+ *    accidental-overwrite path: block selected, then typed/pasted over).
+ *  - `keyboardDelete` — ReplaceStep removal at a caret/range selection
+ *    (Backspace/Delete key).
+ *  - `other` — anything else (unsync, conversion, code-dispatched, or a
+ *    structural `ReplaceAroundStep` such as wrap/lift/unwrap).
+ *
+ * Only a plain `ReplaceStep` counts as a direct user deletion. `ReplaceAroundStep`
+ * is used for wrapping/lifting/unwrapping content, not direct removal, so a
+ * removal carried by one is classified as `other` rather than misreported as a
+ * keyboard delete.
+ *
+ * `state` is the pre-transaction state, so its selection reflects what was
+ * selected when the edit was made.
+ */
+export const getDeleteMechanism = (tr, state) => {
+  var _selection$node;
+  const historyMeta = tr.getMeta(pmHistoryPluginKey);
+  if (historyMeta) {
+    return isHistoryMeta(historyMeta) && historyMeta.redo ? 'redo' : 'undo';
+  }
+
+  // The toolbar Delete control tags its transaction so we can report it
+  // distinctly from a keyboard delete (both produce a plain ReplaceStep).
+  if (tr.getMeta(deleteMechanismMetaKey) === 'deleteButton') {
+    return 'deleteButton';
+  }
+  const hasReplaceStep = tr.steps.some(step => step instanceof ReplaceStep);
+  if (!hasReplaceStep) {
+    return 'other';
+  }
+  const {
+    selection
+  } = state;
+  const isNodeSelected = selection instanceof NodeSelection && ((_selection$node = selection.node) === null || _selection$node === void 0 ? void 0 : _selection$node.type.name) === 'bodiedSyncBlock';
+  return isNodeSelected ? 'selectionReplaced' : 'keyboardDelete';
+};
 const filterTransactionOnline = ({
   tr,
   state,
@@ -156,7 +214,9 @@ const filterTransactionOnline = ({
       // eslint-disable-next-line no-param-reassign
       confirmationTransactionRef.current = tr;
     }
-    return handleBodiedSyncBlockRemoval(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, getDeleteReason(tr));
+    // Only derive the mechanism behind the gate — discarded gate-off.
+    const mechanism = fg('platform_editor_blocks_patch_4') ? getDeleteMechanism(tr, state) : undefined;
+    return handleBodiedSyncBlockRemoval(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, getDeleteReason(tr), mechanism);
   }
   if (bodiedSyncBlockAdded.length > 0) {
     if (tr.getMeta(pmHistoryPluginKey)) {

package/dist/es2019/pm-plugins/utils/handle-bodied-sync-block-removal.js

@@ -21,7 +21,7 @@ const onDismissed = syncBlockStore => tr => {
     bodiedSyncBlockDeletionStatus: 'none'
   });
 };
-export const handleBodiedSyncBlockRemoval = (bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, deletionReason) => {
+export const handleBodiedSyncBlockRemoval = (bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, deletionReason, mechanism) => {
   // Clear potential old pending deletion to retreat the deletion as first attempt
   syncBlockStore.sourceManager.clearPendingDeletion();
 
@@ -107,6 +107,6 @@ export const handleBodiedSyncBlockRemoval = (bodiedSyncBlockRemoved, syncBlockSt
     });
   }, () => {
     confirmationTransactionRef.current = undefined;
-  });
+  }, mechanism);
   return false;
 };

package/dist/esm/editor-commands/index.js

@@ -8,7 +8,7 @@ import { DOMSerializer, Fragment } from '@atlaskit/editor-prosemirror/model';
 import { NodeSelection, TextSelection } from '@atlaskit/editor-prosemirror/state';
 import { findSelectedNodeOfType, removeParentNodeOfType, removeSelectedNode, safeInsert } from '@atlaskit/editor-prosemirror/utils';
 import { fg } from '@atlaskit/platform-feature-flags';
-import { syncedBlockPluginKey } from '../pm-plugins/main';
+import { deleteMechanismMetaKey, syncedBlockPluginKey } from '../pm-plugins/main';
 import { canBeConvertedToSyncBlock, deferDispatch, findSyncBlock, findSyncBlockOrBodiedSyncBlock, isBodiedSyncBlockNode } from '../pm-plugins/utils/utils';
 import { FLAG_ID } from '../types';
 import { findBodiedSyncBlockByLocalId, pasteSyncBlockHTMLContent } from './utils';
@@ -151,6 +151,10 @@ var copySyncedBlockReferenceToClipboardInternal = function copySyncedBlockRefere
   }
   var domNode = toDOM(referenceSyncBlockNode, schema);
   copyDomNode(domNode, referenceSyncBlockNode.type, selection);
+
+  // Bare-uuid join key shared with the create/delete events: for a source
+  // bodiedSyncBlock its `localId` is the source uuid (copy was page-form only).
+  var sourceJoinKey = isBodiedSyncBlock ? syncBlockFindResult.node.attrs.localId : undefined;
   deferDispatch(function () {
     api === null || api === void 0 || api.core.actions.execute(function (_ref3) {
       var _api$analytics4;
@@ -160,10 +164,12 @@ var copySyncedBlockReferenceToClipboardInternal = function copySyncedBlockRefere
         action: ACTION.COPIED,
         actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
         actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY,
-        attributes: {
+        attributes: _objectSpread({
           resourceId: referenceSyncBlockNode.attrs.resourceId,
           inputMethod: inputMethod
-        }
+        }, sourceJoinKey && fg('platform_editor_blocks_patch_4') && {
+          blockInstanceId: sourceJoinKey
+        })
       });
       return tr.setMeta(syncedBlockPluginKey, {
         activeFlag: {
@@ -239,6 +245,13 @@ export var removeSyncedBlock = function removeSyncedBlock(api) {
     if (!removeTr) {
       return false;
     }
+
+    // Tag the transaction so analytics can report this as `deleteButton` rather
+    // than a keyboard delete (both produce a plain ReplaceStep). Gated so the
+    // gate-off transaction is unchanged.
+    if (fg('platform_editor_blocks_patch_4')) {
+      removeTr.setMeta(deleteMechanismMetaKey, 'deleteButton');
+    }
     dispatch(removeTr);
     api === null || api === void 0 || api.core.actions.focus();
     return true;

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

@@ -1,6 +1,7 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _typeof from "@babel/runtime/helpers/typeof";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
@@ -14,7 +15,7 @@ import { createSelectionClickHandler } from '@atlaskit/editor-common/selection';
 import { BodiedSyncBlockSharedCssClassName, SyncBlockStateCssClassName } from '@atlaskit/editor-common/sync-block';
 import { mapSlice, pmHistoryPluginKey } from '@atlaskit/editor-common/utils';
 import { isOfflineMode } from '@atlaskit/editor-plugin-connectivity';
-import { PluginKey } from '@atlaskit/editor-prosemirror/state';
+import { NodeSelection, PluginKey } from '@atlaskit/editor-prosemirror/state';
 import { ReplaceAroundStep, ReplaceStep } from '@atlaskit/editor-prosemirror/transform';
 import { DecorationSet, Decoration } from '@atlaskit/editor-prosemirror/view';
 import { convertPMNodesToSyncBlockNodes, rebaseTransaction } from '@atlaskit/editor-synced-block-provider';
@@ -34,6 +35,17 @@ import { hasEditInSyncBlock, trackSyncBlocks } from './utils/track-sync-blocks';
 import { transactionInsertsSyncedBlock } from './utils/transaction-inserts-synced-block';
 import { deferDispatch, wasExtensionInsertedInBodiedSyncBlock, sliceFullyContainsNode } from './utils/utils';
 export var syncedBlockPluginKey = new PluginKey('syncedBlockPlugin');
+
+/**
+ * Dedicated transaction-meta {@link PluginKey} the synced-block removal command
+ * sets so {@link getDeleteMechanism} can report a toolbar Delete as
+ * `deleteButton` (otherwise indistinguishable from a keyboard delete — both are
+ * plain ReplaceSteps). A separate key (rather than `syncedBlockPluginKey`, which
+ * carries plugin-state transitions read in `apply()`, or a bare string) keeps
+ * this transient signal uniquely namespaced and isolated. Only read behind
+ * `platform_editor_blocks_patch_4`.
+ */
+export var deleteMechanismMetaKey = new PluginKey('syncedBlockDeleteMechanism');
 var mapRetryCreationPosMap = function mapRetryCreationPosMap(oldMap, newRetryCreationPos, mapPos, isPerfExperimentOn) {
   var resourceId = newRetryCreationPos === null || newRetryCreationPos === void 0 ? void 0 : newRetryCreationPos.resourceId;
 
@@ -114,6 +126,55 @@ var getDeleteReason = function getDeleteReason(tr) {
   }
   return reason;
 };
+
+/** Narrows the history plugin meta, matching the editor-plugin-card pattern. */
+var isHistoryMeta = function isHistoryMeta(meta) {
+  return _typeof(meta) === 'object' && meta !== null && 'redo' in meta;
+};
+
+/**
+ * Derive how a source bodiedSyncBlock removal was performed, for the `mechanism`
+ * analytics dimension. Each value names the user action; most-specific wins:
+ *  - `undo` / `redo` — history transaction.
+ *  - `deleteButton` — the explicit "Delete" control in the synced-block toolbar
+ *    (the removal command tags its transaction with {@link deleteMechanismMetaKey}).
+ *  - `selectionReplaced` — ReplaceStep on a node-selected block (the
+ *    accidental-overwrite path: block selected, then typed/pasted over).
+ *  - `keyboardDelete` — ReplaceStep removal at a caret/range selection
+ *    (Backspace/Delete key).
+ *  - `other` — anything else (unsync, conversion, code-dispatched, or a
+ *    structural `ReplaceAroundStep` such as wrap/lift/unwrap).
+ *
+ * Only a plain `ReplaceStep` counts as a direct user deletion. `ReplaceAroundStep`
+ * is used for wrapping/lifting/unwrapping content, not direct removal, so a
+ * removal carried by one is classified as `other` rather than misreported as a
+ * keyboard delete.
+ *
+ * `state` is the pre-transaction state, so its selection reflects what was
+ * selected when the edit was made.
+ */
+export var getDeleteMechanism = function getDeleteMechanism(tr, state) {
+  var _selection$node;
+  var historyMeta = tr.getMeta(pmHistoryPluginKey);
+  if (historyMeta) {
+    return isHistoryMeta(historyMeta) && historyMeta.redo ? 'redo' : 'undo';
+  }
+
+  // The toolbar Delete control tags its transaction so we can report it
+  // distinctly from a keyboard delete (both produce a plain ReplaceStep).
+  if (tr.getMeta(deleteMechanismMetaKey) === 'deleteButton') {
+    return 'deleteButton';
+  }
+  var hasReplaceStep = tr.steps.some(function (step) {
+    return step instanceof ReplaceStep;
+  });
+  if (!hasReplaceStep) {
+    return 'other';
+  }
+  var selection = state.selection;
+  var isNodeSelected = selection instanceof NodeSelection && ((_selection$node = selection.node) === null || _selection$node === void 0 ? void 0 : _selection$node.type.name) === 'bodiedSyncBlock';
+  return isNodeSelected ? 'selectionReplaced' : 'keyboardDelete';
+};
 var filterTransactionOnline = function filterTransactionOnline(_ref3) {
   var _tr$getMeta;
   var tr = _ref3.tr,
@@ -173,7 +234,9 @@ var filterTransactionOnline = function filterTransactionOnline(_ref3) {
       // eslint-disable-next-line no-param-reassign
       confirmationTransactionRef.current = tr;
     }
-    return handleBodiedSyncBlockRemoval(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, getDeleteReason(tr));
+    // Only derive the mechanism behind the gate — discarded gate-off.
+    var mechanism = fg('platform_editor_blocks_patch_4') ? getDeleteMechanism(tr, state) : undefined;
+    return handleBodiedSyncBlockRemoval(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, getDeleteReason(tr), mechanism);
   }
   if (bodiedSyncBlockAdded.length > 0) {
     if (tr.getMeta(pmHistoryPluginKey)) {

package/dist/esm/pm-plugins/utils/handle-bodied-sync-block-removal.js

@@ -27,7 +27,7 @@ var onDismissed = function onDismissed(syncBlockStore) {
     });
   };
 };
-export var handleBodiedSyncBlockRemoval = function handleBodiedSyncBlockRemoval(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, deletionReason) {
+export var handleBodiedSyncBlockRemoval = function handleBodiedSyncBlockRemoval(bodiedSyncBlockRemoved, syncBlockStore, api, confirmationTransactionRef, deletionReason, mechanism) {
   // Clear potential old pending deletion to retreat the deletion as first attempt
   syncBlockStore.sourceManager.clearPendingDeletion();
 
@@ -114,6 +114,6 @@ export var handleBodiedSyncBlockRemoval = function handleBodiedSyncBlockRemoval(
     });
   }, function () {
     confirmationTransactionRef.current = undefined;
-  });
+  }, mechanism);
   return false;
 };

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

@@ -1,11 +1,23 @@
 import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
 import type { ExtractInjectionAPI, PMPluginFactoryParams } from '@atlaskit/editor-common/types';
+import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
 import { PluginKey } from '@atlaskit/editor-prosemirror/state';
 import { DecorationSet } from '@atlaskit/editor-prosemirror/view';
 import type { SyncBlockStoreManager } from '@atlaskit/editor-synced-block-provider';
+import type { DeletionMechanism } from '@atlaskit/editor-synced-block-provider/common/types';
 import type { SyncedBlockPlugin, SyncedBlockPluginOptions } from '../syncedBlockPluginType';
 import type { ActiveFlag, BodiedSyncBlockDeletionStatus, RetryCreationPosMap } from '../types';
 export declare const syncedBlockPluginKey: PluginKey;
+/**
+ * Dedicated transaction-meta {@link PluginKey} the synced-block removal command
+ * sets so {@link getDeleteMechanism} can report a toolbar Delete as
+ * `deleteButton` (otherwise indistinguishable from a keyboard delete — both are
+ * plain ReplaceSteps). A separate key (rather than `syncedBlockPluginKey`, which
+ * carries plugin-state transitions read in `apply()`, or a bare string) keeps
+ * this transient signal uniquely namespaced and isolated. Only read behind
+ * `platform_editor_blocks_patch_4`.
+ */
+export declare const deleteMechanismMetaKey: PluginKey<DeletionMechanism>;
 type SyncedBlockPluginState = {
     activeFlag: ActiveFlag;
     bodiedSyncBlockDeletionStatus?: BodiedSyncBlockDeletionStatus;
@@ -42,5 +54,27 @@ type SyncedBlockPluginState = {
     statusDecorationSet: DecorationSet;
     syncBlockStore: SyncBlockStoreManager;
 };
+/**
+ * Derive how a source bodiedSyncBlock removal was performed, for the `mechanism`
+ * analytics dimension. Each value names the user action; most-specific wins:
+ *  - `undo` / `redo` — history transaction.
+ *  - `deleteButton` — the explicit "Delete" control in the synced-block toolbar
+ *    (the removal command tags its transaction with {@link deleteMechanismMetaKey}).
+ *  - `selectionReplaced` — ReplaceStep on a node-selected block (the
+ *    accidental-overwrite path: block selected, then typed/pasted over).
+ *  - `keyboardDelete` — ReplaceStep removal at a caret/range selection
+ *    (Backspace/Delete key).
+ *  - `other` — anything else (unsync, conversion, code-dispatched, or a
+ *    structural `ReplaceAroundStep` such as wrap/lift/unwrap).
+ *
+ * Only a plain `ReplaceStep` counts as a direct user deletion. `ReplaceAroundStep`
+ * is used for wrapping/lifting/unwrapping content, not direct removal, so a
+ * removal carried by one is classified as `other` rather than misreported as a
+ * keyboard delete.
+ *
+ * `state` is the pre-transaction state, so its selection reflects what was
+ * selected when the edit was made.
+ */
+export declare const getDeleteMechanism: (tr: Transaction, state: EditorState) => DeletionMechanism;
 export declare const createPlugin: (options: SyncedBlockPluginOptions | undefined, pmPluginFactoryParams: PMPluginFactoryParams, syncBlockStore: SyncBlockStoreManager, api?: ExtractInjectionAPI<SyncedBlockPlugin>) => SafePlugin<SyncedBlockPluginState>;
 export {};

package/dist/types/pm-plugins/utils/handle-bodied-sync-block-removal.d.ts

@@ -1,9 +1,10 @@
 import type { ExtractInjectionAPI } from '@atlaskit/editor-common/types';
 import type { Transaction } from '@atlaskit/editor-prosemirror/state';
-import type { DeletionReason, SyncBlockStoreManager } from '@atlaskit/editor-synced-block-provider';
+import type { SyncBlockStoreManager } from '@atlaskit/editor-synced-block-provider';
+import type { DeletionMechanism, DeletionReason } from '@atlaskit/editor-synced-block-provider/common/types';
 import type { SyncedBlockPlugin } from '../../syncedBlockPluginType';
 import type { SyncBlockInfo } from '../../types';
 export type TransactionRef = {
     current: Transaction | undefined;
 };
-export declare const handleBodiedSyncBlockRemoval: (bodiedSyncBlockRemoved: SyncBlockInfo[], syncBlockStore: SyncBlockStoreManager, api: ExtractInjectionAPI<SyncedBlockPlugin> | undefined, confirmationTransactionRef: TransactionRef, deletionReason: DeletionReason) => boolean;
+export declare const handleBodiedSyncBlockRemoval: (bodiedSyncBlockRemoved: SyncBlockInfo[], syncBlockStore: SyncBlockStoreManager, api: ExtractInjectionAPI<SyncedBlockPlugin> | undefined, confirmationTransactionRef: TransactionRef, deletionReason: DeletionReason, mechanism?: DeletionMechanism) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-synced-block",
-	"version": "10.0.21",
+	"version": "10.1.0",
 	"description": "SyncedBlock plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -35,7 +35,7 @@
 		"@atlaskit/editor-plugin-user-intent": "^10.0.0",
 		"@atlaskit/editor-prosemirror": "^8.0.0",
 		"@atlaskit/editor-shared-styles": "^4.0.0",
-		"@atlaskit/editor-synced-block-provider": "^8.4.0",
+		"@atlaskit/editor-synced-block-provider": "^8.5.0",
 		"@atlaskit/editor-toolbar": "^2.1.0",
 		"@atlaskit/flag": "^18.1.0",
 		"@atlaskit/icon": "36.1.0",
@@ -56,7 +56,7 @@
 		"date-fns": "^2.17.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^116.18.0",
+		"@atlaskit/editor-common": "^116.19.0",
 		"react": "^18.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"
 	},