@atlaskit/editor-plugin-mentions 20.1.5 → 20.2.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @atlaskit/editor-plugin-mentions
 
+## 20.2.0
+
+### Minor Changes
+
+- [`b51cc398d7701`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b51cc398d7701) -
+  Add the opt-in @mention availability predicate used by the gated Home Search mode, so Search
+  preserves existing Chat mentions as inactive content while preventing new mention typeahead and
+  `/mention` slash-menu insertion. The `editor-disable-feature` feature gate enables that predicate
+  for Home Search.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 20.1.5
 
 ### Patch Changes

package/dist/cjs/isMentionTypeAheadEnabled.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isMentionTypeAheadEnabled = void 0;
+var _fg = require("@atlaskit/platform-feature-flags/fg");
+var isMentionTypeAheadEnabled = exports.isMentionTypeAheadEnabled = function isMentionTypeAheadEnabled(canOpenTypeAhead) {
+  return (canOpenTypeAhead === null || canOpenTypeAhead === void 0 ? void 0 : canOpenTypeAhead()) !== false || !(0, _fg.fg)('editor-disable-feature');
+};

package/dist/cjs/mentionsPlugin.js

@@ -24,6 +24,7 @@ var _isExperimentEnabled = require("@atlaskit/platform-feature-experiments/is-ex
 var _fg = require("@atlaskit/platform-feature-flags/fg");
 var _editorExperiment = require("@atlaskit/tmp-editor-statsig/editor-experiment");
 var _editorCommands = require("./editor-commands");
+var _isMentionTypeAheadEnabled = require("./isMentionTypeAheadEnabled");
 var _mentionNodeSpec = require("./nodeviews/mentionNodeSpec");
 var _agent = require("./pm-plugins/agent");
 var _key = require("./pm-plugins/key");
@@ -106,6 +107,7 @@ var mentionsPlugin = exports.mentionsPlugin = function mentionsPlugin(_ref3) {
     fireAnalyticsEvent(payload, channel);
   };
   var typeAhead = (0, _typeAhead.createTypeAheadConfig)({
+    canOpenTypeAhead: options === null || options === void 0 ? void 0 : options.canOpenTypeAhead,
     sanitizePrivateContent: options === null || options === void 0 ? void 0 : options.sanitizePrivateContent,
     mentionInsertDisplayName: options === null || options === void 0 ? void 0 : options.insertDisplayName,
     HighlightComponent: options === null || options === void 0 ? void 0 : options.HighlightComponent,
@@ -116,11 +118,15 @@ var mentionsPlugin = exports.mentionsPlugin = function mentionsPlugin(_ref3) {
     fireEvent: fireEvent,
     api: api
   });
+  var canOpenMentionTypeAhead = function canOpenMentionTypeAhead() {
+    return (0, _isMentionTypeAheadEnabled.isMentionTypeAheadEnabled)(options === null || options === void 0 ? void 0 : options.canOpenTypeAhead);
+  };
   var isRegisteredSlashCommandEnabled = (0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_slash_command');
   if (isRegisteredSlashCommandEnabled) {
     var _api$uiControlRegistr;
     api === null || api === void 0 || (_api$uiControlRegistr = api.uiControlRegistry) === null || _api$uiControlRegistr === void 0 || _api$uiControlRegistr.actions.register((0, _getMentionQuickInsertComponents.getMentionQuickInsertComponents)({
       api: api,
+      canOpenMentionTypeAhead: canOpenMentionTypeAhead,
       typeAhead: typeAhead
     }));
   }
@@ -321,17 +327,24 @@ var mentionsPlugin = exports.mentionsPlugin = function mentionsPlugin(_ref3) {
           icon: function icon() {
             return /*#__PURE__*/_react.default.createElement(_assets.IconMention, null);
           },
+          isHidden: function isHidden() {
+            var _api$mention$sharedSt;
+            return canOpenMentionTypeAhead() === false || (api === null || api === void 0 || (_api$mention$sharedSt = api.mention.sharedState.currentState()) === null || _api$mention$sharedSt === void 0 ? void 0 : _api$mention$sharedSt.canInsertMention) === false;
+          },
           action: function action(insert, state) {
             var _api$typeAhead3;
-            var tr = insert(undefined);
             var pluginState = _key.mentionPluginKey.getState(state);
             if (pluginState && pluginState.canInsertMention === false) {
               return false;
             }
-            api === null || api === void 0 || (_api$typeAhead3 = api.typeAhead) === null || _api$typeAhead3 === void 0 || _api$typeAhead3.actions.openAtTransaction({
+            var tr = insert(undefined);
+            var didOpen = api === null || api === void 0 || (_api$typeAhead3 = api.typeAhead) === null || _api$typeAhead3 === void 0 ? void 0 : _api$typeAhead3.actions.openAtTransaction({
               triggerHandler: typeAhead,
               inputMethod: _analytics.INPUT_METHOD.QUICK_INSERT
             })(tr);
+            if (didOpen === false) {
+              return false;
+            }
             return tr;
           }
         }];

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

@@ -13,6 +13,7 @@ var _insm = require("@atlaskit/insm");
 var _analytics2 = require("@atlaskit/mention/analytics");
 var _types = require("@atlaskit/mention/types");
 var _fg = require("@atlaskit/platform-feature-flags/fg");
+var _isMentionTypeAheadEnabled = require("../isMentionTypeAheadEnabled");
 var _mentionNodeView = require("../nodeviews/mentionNodeView");
 var _types2 = require("../types");
 var _key = require("./key");
@@ -43,7 +44,7 @@ var ACTIONS = exports.ACTIONS = {
   CLEAR_PENDING_PASTED_AGENT_MENTION: 'CLEAR_PENDING_PASTED_AGENT_MENTION'
 };
 var PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-var PACKAGE_VERSION = "20.1.4";
+var PACKAGE_VERSION = "20.1.5";
 var setProvider = function setProvider(provider) {
   return function (state, dispatch) {
     if (dispatch) {
@@ -63,6 +64,9 @@ function createMentionPlugin(_ref) {
     options = _ref.options,
     api = _ref.api;
   var mentionProvider;
+  var isMentionInsertionEnabled = function isMentionInsertionEnabled(state) {
+    return (0, _isMentionTypeAheadEnabled.isMentionTypeAheadEnabled)(options === null || options === void 0 ? void 0 : options.canOpenTypeAhead) && (0, _utils.canMentionBeCreatedInRange)(state.selection.from, state.selection.to)(state);
+  };
   var sendAnalytics = function sendAnalytics(event, actionSubject, action, attributes) {
     if (event === _analytics2.SLI_EVENT_TYPE || event === _analytics2.SMART_EVENT_TYPE) {
       fireEvent({
@@ -81,9 +85,8 @@ function createMentionPlugin(_ref) {
     key: _key.mentionPluginKey,
     state: {
       init: function init(_, state) {
-        var canInsertMention = (0, _utils.canMentionBeCreatedInRange)(state.selection.from, state.selection.to)(state);
         return {
-          canInsertMention: canInsertMention
+          canInsertMention: isMentionInsertionEnabled(state)
         };
       },
       apply: function apply(tr, pluginState, oldState, newState) {
@@ -98,7 +101,7 @@ function createMentionPlugin(_ref) {
         var hasPositionChanged = oldState.selection.from !== newState.selection.from || oldState.selection.to !== newState.selection.to;
         if (tr.docChanged || tr.selectionSet && hasPositionChanged) {
           newPluginState = _objectSpread(_objectSpread({}, pluginState), {}, {
-            canInsertMention: (0, _utils.canMentionBeCreatedInRange)(newState.selection.from, newState.selection.to)(newState)
+            canInsertMention: isMentionInsertionEnabled(newState)
           });
           hasPublicPluginStateChanged = true;
         }

package/dist/cjs/ui/quick-insert/MentionQuickInsertMenuItem.js

@@ -27,10 +27,13 @@ var MentionQuickInsertMenuItem = exports.MentionQuickInsertMenuItem = function M
       return false;
     }
     var tr = insert(undefined);
-    api === null || api === void 0 || (_api$typeAhead = api.typeAhead) === null || _api$typeAhead === void 0 || _api$typeAhead.actions.openAtTransaction({
+    var didOpen = api === null || api === void 0 || (_api$typeAhead = api.typeAhead) === null || _api$typeAhead === void 0 ? void 0 : _api$typeAhead.actions.openAtTransaction({
       triggerHandler: typeAhead,
       inputMethod: _analytics.INPUT_METHOD.QUICK_INSERT
     })(tr);
+    if (didOpen === false) {
+      return false;
+    }
     return tr;
   }, [api, typeAhead]);
   return /*#__PURE__*/_react.default.createElement(_menuItem.QuickInsertMenuItem, {

package/dist/cjs/ui/quick-insert/getMentionQuickInsertComponents.js

@@ -13,6 +13,7 @@ var _rank = require("@atlaskit/editor-common/quick-insert/rank");
 var _MentionQuickInsertMenuItem = require("./MentionQuickInsertMenuItem");
 var getMentionQuickInsertComponents = exports.getMentionQuickInsertComponents = function getMentionQuickInsertComponents(_ref) {
   var api = _ref.api,
+    canOpenMentionTypeAhead = _ref.canOpenMentionTypeAhead,
     typeAhead = _ref.typeAhead;
   return [{
     key: _keys.MENTION_MENU_ITEM.key,
@@ -22,6 +23,10 @@ var getMentionQuickInsertComponents = exports.getMentionQuickInsertComponents =
       type: _keys.STRUCTURE_SECTION.type,
       rank: _rank.STRUCTURE_SECTION_RANK[_keys.MENTION_MENU_ITEM.key]
     }],
+    isHidden: function isHidden() {
+      var _api$mention$sharedSt;
+      return (canOpenMentionTypeAhead === null || canOpenMentionTypeAhead === void 0 ? void 0 : canOpenMentionTypeAhead()) === false || (api === null || api === void 0 || (_api$mention$sharedSt = api.mention.sharedState.currentState()) === null || _api$mention$sharedSt === void 0 ? void 0 : _api$mention$sharedSt.canInsertMention) === false;
+    },
     match: (0, _createQuickInsertMatcher.createQuickInsertMatcher)(function (_ref2) {
       var formatMessage = _ref2.formatMessage;
       return {

package/dist/cjs/ui/type-ahead/index.js

@@ -395,7 +395,8 @@ var makeTransformMentionsToTypeAheadItems = function makeTransformMentionsToType
   };
 };
 var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeAheadConfig(_ref1) {
-  var sanitizePrivateContent = _ref1.sanitizePrivateContent,
+  var canOpenTypeAhead = _ref1.canOpenTypeAhead,
+    sanitizePrivateContent = _ref1.sanitizePrivateContent,
     mentionInsertDisplayName = _ref1.mentionInsertDisplayName,
     fireEvent = _ref1.fireEvent,
     HighlightComponent = _ref1.HighlightComponent,
@@ -433,6 +434,7 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
     })).call
   });
   var typeAhead = {
+    canOpen: canOpenTypeAhead,
     id: _typeAhead.TypeAheadAvailableNodes.MENTION,
     trigger: '@',
     // Custom regex must have a capture group around trigger

package/dist/es2019/isMentionTypeAheadEnabled.js

@@ -0,0 +1,2 @@
+import { fg } from '@atlaskit/platform-feature-flags/fg';
+export const isMentionTypeAheadEnabled = canOpenTypeAhead => (canOpenTypeAhead === null || canOpenTypeAhead === void 0 ? void 0 : canOpenTypeAhead()) !== false || !fg('editor-disable-feature');

package/dist/es2019/mentionsPlugin.js

@@ -13,6 +13,7 @@ import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-e
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { editorExperiment } from '@atlaskit/tmp-editor-statsig/editor-experiment';
 import { insertMention } from './editor-commands';
+import { isMentionTypeAheadEnabled } from './isMentionTypeAheadEnabled';
 import { mentionNodeSpec } from './nodeviews/mentionNodeSpec';
 import { agentMentionPluginKey, createAgentMentionPlugin } from './pm-plugins/agent';
 import { mentionPluginKey } from './pm-plugins/key';
@@ -102,6 +103,7 @@ const mentionsPlugin = ({
     fireAnalyticsEvent(payload, channel);
   };
   const typeAhead = createTypeAheadConfig({
+    canOpenTypeAhead: options === null || options === void 0 ? void 0 : options.canOpenTypeAhead,
     sanitizePrivateContent: options === null || options === void 0 ? void 0 : options.sanitizePrivateContent,
     mentionInsertDisplayName: options === null || options === void 0 ? void 0 : options.insertDisplayName,
     HighlightComponent: options === null || options === void 0 ? void 0 : options.HighlightComponent,
@@ -112,11 +114,13 @@ const mentionsPlugin = ({
     fireEvent,
     api
   });
+  const canOpenMentionTypeAhead = () => isMentionTypeAheadEnabled(options === null || options === void 0 ? void 0 : options.canOpenTypeAhead);
   const isRegisteredSlashCommandEnabled = isExperimentEnabled('platform_editor_slash_command');
   if (isRegisteredSlashCommandEnabled) {
     var _api$uiControlRegistr;
     api === null || api === void 0 ? void 0 : (_api$uiControlRegistr = api.uiControlRegistry) === null || _api$uiControlRegistr === void 0 ? void 0 : _api$uiControlRegistr.actions.register(getMentionQuickInsertComponents({
       api,
+      canOpenMentionTypeAhead,
       typeAhead
     }));
   }
@@ -293,17 +297,24 @@ const mentionsPlugin = ({
         priority: 400,
         keyshortcut: '@',
         icon: () => /*#__PURE__*/React.createElement(IconMention, null),
+        isHidden: () => {
+          var _api$mention$sharedSt;
+          return canOpenMentionTypeAhead() === false || (api === null || api === void 0 ? void 0 : (_api$mention$sharedSt = api.mention.sharedState.currentState()) === null || _api$mention$sharedSt === void 0 ? void 0 : _api$mention$sharedSt.canInsertMention) === false;
+        },
         action(insert, state) {
           var _api$typeAhead3;
-          const tr = insert(undefined);
           const pluginState = mentionPluginKey.getState(state);
           if (pluginState && pluginState.canInsertMention === false) {
             return false;
           }
-          api === null || api === void 0 ? void 0 : (_api$typeAhead3 = api.typeAhead) === null || _api$typeAhead3 === void 0 ? void 0 : _api$typeAhead3.actions.openAtTransaction({
+          const tr = insert(undefined);
+          const didOpen = api === null || api === void 0 ? void 0 : (_api$typeAhead3 = api.typeAhead) === null || _api$typeAhead3 === void 0 ? void 0 : _api$typeAhead3.actions.openAtTransaction({
             triggerHandler: typeAhead,
             inputMethod: INPUT_METHOD.QUICK_INSERT
           })(tr);
+          if (didOpen === false) {
+            return false;
+          }
           return tr;
         }
       }],

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

@@ -4,6 +4,7 @@ import { insm } from '@atlaskit/insm';
 import { SLI_EVENT_TYPE, SMART_EVENT_TYPE } from '@atlaskit/mention/analytics';
 import { ComponentNames } from '@atlaskit/mention/types';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
+import { isMentionTypeAheadEnabled } from '../isMentionTypeAheadEnabled';
 import { MentionNodeView } from '../nodeviews/mentionNodeView';
 import { MENTION_PROVIDER_REJECTED, MENTION_PROVIDER_UNDEFINED } from '../types';
 import { mentionPluginKey } from './key';
@@ -32,7 +33,7 @@ export const ACTIONS = {
   CLEAR_PENDING_PASTED_AGENT_MENTION: 'CLEAR_PENDING_PASTED_AGENT_MENTION'
 };
 const PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-const PACKAGE_VERSION = "20.1.4";
+const PACKAGE_VERSION = "20.1.5";
 const setProvider = provider => (state, dispatch) => {
   if (dispatch) {
     dispatch(state.tr.setMeta(mentionPluginKey, {
@@ -51,6 +52,7 @@ export function createMentionPlugin({
   api
 }) {
   let mentionProvider;
+  const isMentionInsertionEnabled = state => isMentionTypeAheadEnabled(options === null || options === void 0 ? void 0 : options.canOpenTypeAhead) && canMentionBeCreatedInRange(state.selection.from, state.selection.to)(state);
   const sendAnalytics = (event, actionSubject, action, attributes) => {
     if (event === SLI_EVENT_TYPE || event === SMART_EVENT_TYPE) {
       fireEvent({
@@ -70,9 +72,8 @@ export function createMentionPlugin({
     key: mentionPluginKey,
     state: {
       init(_, state) {
-        const canInsertMention = canMentionBeCreatedInRange(state.selection.from, state.selection.to)(state);
         return {
-          canInsertMention
+          canInsertMention: isMentionInsertionEnabled(state)
         };
       },
       apply(tr, pluginState, oldState, newState) {
@@ -89,7 +90,7 @@ export function createMentionPlugin({
         if (tr.docChanged || tr.selectionSet && hasPositionChanged) {
           newPluginState = {
             ...pluginState,
-            canInsertMention: canMentionBeCreatedInRange(newState.selection.from, newState.selection.to)(newState)
+            canInsertMention: isMentionInsertionEnabled(newState)
           };
           hasPublicPluginStateChanged = true;
         }

package/dist/es2019/ui/quick-insert/MentionQuickInsertMenuItem.js

@@ -21,10 +21,13 @@ export const MentionQuickInsertMenuItem = ({
       return false;
     }
     const tr = insert(undefined);
-    api === null || api === void 0 ? void 0 : (_api$typeAhead = api.typeAhead) === null || _api$typeAhead === void 0 ? void 0 : _api$typeAhead.actions.openAtTransaction({
+    const didOpen = api === null || api === void 0 ? void 0 : (_api$typeAhead = api.typeAhead) === null || _api$typeAhead === void 0 ? void 0 : _api$typeAhead.actions.openAtTransaction({
       triggerHandler: typeAhead,
       inputMethod: INPUT_METHOD.QUICK_INSERT
     })(tr);
+    if (didOpen === false) {
+      return false;
+    }
     return tr;
   }, [api, typeAhead]);
   return /*#__PURE__*/React.createElement(QuickInsertMenuItem, {

package/dist/es2019/ui/quick-insert/getMentionQuickInsertComponents.js

@@ -6,6 +6,7 @@ import { STRUCTURE_SECTION_RANK } from '@atlaskit/editor-common/quick-insert/ran
 import { MentionQuickInsertMenuItem } from './MentionQuickInsertMenuItem';
 export const getMentionQuickInsertComponents = ({
   api,
+  canOpenMentionTypeAhead,
   typeAhead
 }) => [{
   key: MENTION_MENU_ITEM.key,
@@ -15,6 +16,10 @@ export const getMentionQuickInsertComponents = ({
     type: STRUCTURE_SECTION.type,
     rank: STRUCTURE_SECTION_RANK[MENTION_MENU_ITEM.key]
   }],
+  isHidden: () => {
+    var _api$mention$sharedSt;
+    return (canOpenMentionTypeAhead === null || canOpenMentionTypeAhead === void 0 ? void 0 : canOpenMentionTypeAhead()) === false || (api === null || api === void 0 ? void 0 : (_api$mention$sharedSt = api.mention.sharedState.currentState()) === null || _api$mention$sharedSt === void 0 ? void 0 : _api$mention$sharedSt.canInsertMention) === false;
+  },
   match: createQuickInsertMatcher(({
     formatMessage
   }) => ({

package/dist/es2019/ui/type-ahead/index.js

@@ -353,6 +353,7 @@ const makeTransformMentionsToTypeAheadItems = ({
   };
 };
 export const createTypeAheadConfig = ({
+  canOpenTypeAhead,
   sanitizePrivateContent,
   mentionInsertDisplayName,
   fireEvent,
@@ -386,6 +387,7 @@ export const createTypeAheadConfig = ({
     })).call
   });
   const typeAhead = {
+    canOpen: canOpenTypeAhead,
     id: TypeAheadAvailableNodes.MENTION,
     trigger: '@',
     // Custom regex must have a capture group around trigger

package/dist/esm/isMentionTypeAheadEnabled.js

@@ -0,0 +1,4 @@
+import { fg } from '@atlaskit/platform-feature-flags/fg';
+export var isMentionTypeAheadEnabled = function isMentionTypeAheadEnabled(canOpenTypeAhead) {
+  return (canOpenTypeAhead === null || canOpenTypeAhead === void 0 ? void 0 : canOpenTypeAhead()) !== false || !fg('editor-disable-feature');
+};

package/dist/esm/mentionsPlugin.js

@@ -20,6 +20,7 @@ import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-e
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { editorExperiment } from '@atlaskit/tmp-editor-statsig/editor-experiment';
 import { insertMention } from './editor-commands';
+import { isMentionTypeAheadEnabled } from './isMentionTypeAheadEnabled';
 import { mentionNodeSpec } from './nodeviews/mentionNodeSpec';
 import { agentMentionPluginKey, createAgentMentionPlugin } from './pm-plugins/agent';
 import { mentionPluginKey } from './pm-plugins/key';
@@ -98,6 +99,7 @@ var mentionsPlugin = function mentionsPlugin(_ref3) {
     fireAnalyticsEvent(payload, channel);
   };
   var typeAhead = createTypeAheadConfig({
+    canOpenTypeAhead: options === null || options === void 0 ? void 0 : options.canOpenTypeAhead,
     sanitizePrivateContent: options === null || options === void 0 ? void 0 : options.sanitizePrivateContent,
     mentionInsertDisplayName: options === null || options === void 0 ? void 0 : options.insertDisplayName,
     HighlightComponent: options === null || options === void 0 ? void 0 : options.HighlightComponent,
@@ -108,11 +110,15 @@ var mentionsPlugin = function mentionsPlugin(_ref3) {
     fireEvent: fireEvent,
     api: api
   });
+  var canOpenMentionTypeAhead = function canOpenMentionTypeAhead() {
+    return isMentionTypeAheadEnabled(options === null || options === void 0 ? void 0 : options.canOpenTypeAhead);
+  };
   var isRegisteredSlashCommandEnabled = isExperimentEnabled('platform_editor_slash_command');
   if (isRegisteredSlashCommandEnabled) {
     var _api$uiControlRegistr;
     api === null || api === void 0 || (_api$uiControlRegistr = api.uiControlRegistry) === null || _api$uiControlRegistr === void 0 || _api$uiControlRegistr.actions.register(getMentionQuickInsertComponents({
       api: api,
+      canOpenMentionTypeAhead: canOpenMentionTypeAhead,
       typeAhead: typeAhead
     }));
   }
@@ -313,17 +319,24 @@ var mentionsPlugin = function mentionsPlugin(_ref3) {
           icon: function icon() {
             return /*#__PURE__*/React.createElement(IconMention, null);
           },
+          isHidden: function isHidden() {
+            var _api$mention$sharedSt;
+            return canOpenMentionTypeAhead() === false || (api === null || api === void 0 || (_api$mention$sharedSt = api.mention.sharedState.currentState()) === null || _api$mention$sharedSt === void 0 ? void 0 : _api$mention$sharedSt.canInsertMention) === false;
+          },
           action: function action(insert, state) {
             var _api$typeAhead3;
-            var tr = insert(undefined);
             var pluginState = mentionPluginKey.getState(state);
             if (pluginState && pluginState.canInsertMention === false) {
               return false;
             }
-            api === null || api === void 0 || (_api$typeAhead3 = api.typeAhead) === null || _api$typeAhead3 === void 0 || _api$typeAhead3.actions.openAtTransaction({
+            var tr = insert(undefined);
+            var didOpen = api === null || api === void 0 || (_api$typeAhead3 = api.typeAhead) === null || _api$typeAhead3 === void 0 ? void 0 : _api$typeAhead3.actions.openAtTransaction({
               triggerHandler: typeAhead,
               inputMethod: INPUT_METHOD.QUICK_INSERT
             })(tr);
+            if (didOpen === false) {
+              return false;
+            }
             return tr;
           }
         }];

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

@@ -7,6 +7,7 @@ import { insm } from '@atlaskit/insm';
 import { SLI_EVENT_TYPE, SMART_EVENT_TYPE } from '@atlaskit/mention/analytics';
 import { ComponentNames } from '@atlaskit/mention/types';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
+import { isMentionTypeAheadEnabled } from '../isMentionTypeAheadEnabled';
 import { MentionNodeView } from '../nodeviews/mentionNodeView';
 import { MENTION_PROVIDER_REJECTED, MENTION_PROVIDER_UNDEFINED } from '../types';
 import { mentionPluginKey } from './key';
@@ -35,7 +36,7 @@ export var ACTIONS = {
   CLEAR_PENDING_PASTED_AGENT_MENTION: 'CLEAR_PENDING_PASTED_AGENT_MENTION'
 };
 var PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-var PACKAGE_VERSION = "20.1.4";
+var PACKAGE_VERSION = "20.1.5";
 var setProvider = function setProvider(provider) {
   return function (state, dispatch) {
     if (dispatch) {
@@ -55,6 +56,9 @@ export function createMentionPlugin(_ref) {
     options = _ref.options,
     api = _ref.api;
   var mentionProvider;
+  var isMentionInsertionEnabled = function isMentionInsertionEnabled(state) {
+    return isMentionTypeAheadEnabled(options === null || options === void 0 ? void 0 : options.canOpenTypeAhead) && canMentionBeCreatedInRange(state.selection.from, state.selection.to)(state);
+  };
   var sendAnalytics = function sendAnalytics(event, actionSubject, action, attributes) {
     if (event === SLI_EVENT_TYPE || event === SMART_EVENT_TYPE) {
       fireEvent({
@@ -73,9 +77,8 @@ export function createMentionPlugin(_ref) {
     key: mentionPluginKey,
     state: {
       init: function init(_, state) {
-        var canInsertMention = canMentionBeCreatedInRange(state.selection.from, state.selection.to)(state);
         return {
-          canInsertMention: canInsertMention
+          canInsertMention: isMentionInsertionEnabled(state)
         };
       },
       apply: function apply(tr, pluginState, oldState, newState) {
@@ -90,7 +93,7 @@ export function createMentionPlugin(_ref) {
         var hasPositionChanged = oldState.selection.from !== newState.selection.from || oldState.selection.to !== newState.selection.to;
         if (tr.docChanged || tr.selectionSet && hasPositionChanged) {
           newPluginState = _objectSpread(_objectSpread({}, pluginState), {}, {
-            canInsertMention: canMentionBeCreatedInRange(newState.selection.from, newState.selection.to)(newState)
+            canInsertMention: isMentionInsertionEnabled(newState)
           });
           hasPublicPluginStateChanged = true;
         }

package/dist/esm/ui/quick-insert/MentionQuickInsertMenuItem.js

@@ -18,10 +18,13 @@ export var MentionQuickInsertMenuItem = function MentionQuickInsertMenuItem(_ref
       return false;
     }
     var tr = insert(undefined);
-    api === null || api === void 0 || (_api$typeAhead = api.typeAhead) === null || _api$typeAhead === void 0 || _api$typeAhead.actions.openAtTransaction({
+    var didOpen = api === null || api === void 0 || (_api$typeAhead = api.typeAhead) === null || _api$typeAhead === void 0 ? void 0 : _api$typeAhead.actions.openAtTransaction({
       triggerHandler: typeAhead,
       inputMethod: INPUT_METHOD.QUICK_INSERT
     })(tr);
+    if (didOpen === false) {
+      return false;
+    }
     return tr;
   }, [api, typeAhead]);
   return /*#__PURE__*/React.createElement(QuickInsertMenuItem, {

package/dist/esm/ui/quick-insert/getMentionQuickInsertComponents.js

@@ -6,6 +6,7 @@ import { STRUCTURE_SECTION_RANK } from '@atlaskit/editor-common/quick-insert/ran
 import { MentionQuickInsertMenuItem } from './MentionQuickInsertMenuItem';
 export var getMentionQuickInsertComponents = function getMentionQuickInsertComponents(_ref) {
   var api = _ref.api,
+    canOpenMentionTypeAhead = _ref.canOpenMentionTypeAhead,
     typeAhead = _ref.typeAhead;
   return [{
     key: MENTION_MENU_ITEM.key,
@@ -15,6 +16,10 @@ export var getMentionQuickInsertComponents = function getMentionQuickInsertCompo
       type: STRUCTURE_SECTION.type,
       rank: STRUCTURE_SECTION_RANK[MENTION_MENU_ITEM.key]
     }],
+    isHidden: function isHidden() {
+      var _api$mention$sharedSt;
+      return (canOpenMentionTypeAhead === null || canOpenMentionTypeAhead === void 0 ? void 0 : canOpenMentionTypeAhead()) === false || (api === null || api === void 0 || (_api$mention$sharedSt = api.mention.sharedState.currentState()) === null || _api$mention$sharedSt === void 0 ? void 0 : _api$mention$sharedSt.canInsertMention) === false;
+    },
     match: createQuickInsertMatcher(function (_ref2) {
       var formatMessage = _ref2.formatMessage;
       return {

package/dist/esm/ui/type-ahead/index.js

@@ -386,7 +386,8 @@ var makeTransformMentionsToTypeAheadItems = function makeTransformMentionsToType
   };
 };
 export var createTypeAheadConfig = function createTypeAheadConfig(_ref1) {
-  var sanitizePrivateContent = _ref1.sanitizePrivateContent,
+  var canOpenTypeAhead = _ref1.canOpenTypeAhead,
+    sanitizePrivateContent = _ref1.sanitizePrivateContent,
     mentionInsertDisplayName = _ref1.mentionInsertDisplayName,
     fireEvent = _ref1.fireEvent,
     HighlightComponent = _ref1.HighlightComponent,
@@ -424,6 +425,7 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref1) {
     })).call
   });
   var typeAhead = {
+    canOpen: canOpenTypeAhead,
     id: TypeAheadAvailableNodes.MENTION,
     trigger: '@',
     // Custom regex must have a capture group around trigger

package/dist/types/isMentionTypeAheadEnabled.d.ts

@@ -0,0 +1 @@
+export declare const isMentionTypeAheadEnabled: (canOpenTypeAhead?: () => boolean) => boolean;

package/dist/types/types/index.d.ts

@@ -28,6 +28,11 @@ export type MentionChange = {
 export type MentionsChangedHandler = (changes: MentionChange[]) => void;
 export interface MentionsPluginOptions extends MentionPluginConfig {
     allowZeroWidthSpaceAfter?: boolean;
+    /**
+     * Optional predicate evaluated before opening the @mention typeahead. When
+     * false, a typed @ remains plain editor text.
+     */
+    canOpenTypeAhead?: () => boolean;
     /**
      * User ID to highlight as a self-mention (typically the current user).
      *

package/dist/types/ui/quick-insert/getMentionQuickInsertComponents.d.ts

@@ -2,7 +2,8 @@ import type { ExtractInjectionAPI } from '@atlaskit/editor-common/types';
 import type { TypeAheadHandler } from '@atlaskit/editor-plugin-type-ahead';
 import type { RegisterMenuItem } from '@atlaskit/editor-ui-control-model/types';
 import type { MentionsPlugin } from '../../mentionsPluginType';
-export declare const getMentionQuickInsertComponents: ({ api, typeAhead, }: {
+export declare const getMentionQuickInsertComponents: ({ api, canOpenMentionTypeAhead, typeAhead, }: {
     api: ExtractInjectionAPI<MentionsPlugin> | undefined;
+    canOpenMentionTypeAhead?: () => boolean;
     typeAhead: TypeAheadHandler;
 }) => RegisterMenuItem[];

package/dist/types/ui/type-ahead/index.d.ts

@@ -14,6 +14,7 @@ export declare function memoize<ResultFn extends (mention: MentionDescription) =
 };
 type Props = {
     api: ExtractInjectionAPI<MentionsPlugin> | undefined;
+    canOpenTypeAhead?: () => boolean;
     enableAgentSectioning?: boolean;
     fireEvent: FireElementsChannelEvent;
     handleMentionsChanged?: (mentionChanges: MentionChange[]) => void;
@@ -23,5 +24,5 @@ type Props = {
     sanitizePrivateContent?: boolean;
     showAgentMentionsLabsLozenge?: boolean;
 };
-export declare const createTypeAheadConfig: ({ sanitizePrivateContent, mentionInsertDisplayName, fireEvent, HighlightComponent, api, handleMentionsChanged, enableAgentSectioning, showAgentMentionsLabsLozenge, profilecardProvider, }: Props) => TypeAheadHandler;
+export declare const createTypeAheadConfig: ({ canOpenTypeAhead, sanitizePrivateContent, mentionInsertDisplayName, fireEvent, HighlightComponent, api, handleMentionsChanged, enableAgentSectioning, showAgentMentionsLabsLozenge, profilecardProvider, }: Props) => TypeAheadHandler;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-mentions",
-	"version": "20.1.5",
+	"version": "20.2.0",
 	"description": "Mentions plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -28,7 +28,7 @@
 		"@atlaskit/editor-plugin-base": "^19.0.0",
 		"@atlaskit/editor-plugin-context-identifier": "^18.0.0",
 		"@atlaskit/editor-plugin-selection": "^18.0.0",
-		"@atlaskit/editor-plugin-type-ahead": "^19.0.0",
+		"@atlaskit/editor-plugin-type-ahead": "^19.1.0",
 		"@atlaskit/editor-prosemirror": "^8.0.0",
 		"@atlaskit/feature-gate-js-client": "^6.0.0",
 		"@atlaskit/icon": "^37.7.0",
@@ -59,7 +59,7 @@
 		"uuid": "^11.1.1"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^122.10.0",
+		"@atlaskit/editor-common": "^122.11.0",
 		"react": "^18.2.0 || ^19.2.0",
 		"react-dom": "^18.2.0 || ^19.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"
@@ -75,6 +75,10 @@
 		"wait-for-expect": "^1.2.0"
 	},
 	"platform-feature-flags": {
+		"editor-disable-feature": {
+			"type": "boolean",
+			"referenceOnly": true
+		},
 		"team-mention-inline-smartlink": {
 			"type": "boolean"
 		},