@atlaskit/mention 26.0.4 → 26.2.0

package/dist/es2019/components/MentionItem/styles.js

@@ -69,18 +69,23 @@ export const TimeStyle = styled.div({
   font: "var(--ds-font-body-small, normal 400 12px/16px \"Atlassian Sans\", ui-sans-serif, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Ubuntu, \"Helvetica Neue\", sans-serif)"
 });
 export const MENTION_ITEM_HEIGHT = 48;
+export const MENTION_ITEM_HEIGHT_REFRESHED = 44;
 // eslint-disable-next-line @atlaskit/ui-styling-standard/no-styled, @atlaskit/ui-styling-standard/no-exported-styles, @atlaskit/ui-styling-standard/no-dynamic-styles -- Ignored via go/DSP-18766
-export const MentionItemStyle = styled.div(props => ({
-  // eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
-  backgroundColor: props.selected ? "var(--ds-background-selected, #E9F2FE)" : 'transparent',
-  display: 'block',
-  overflow: 'hidden',
-  listStyleType: 'none',
-  height: `${MENTION_ITEM_HEIGHT}px`,
-  // eslint-disable-next-line @atlaskit/design-system/use-tokens-typography
-  lineHeight: 1.2,
-  cursor: 'pointer'
-}));
+export const MentionItemStyle = styled.div(props => {
+  var _props$height;
+  return {
+    // eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
+    backgroundColor: props.selected ? "var(--ds-background-selected, #E9F2FE)" : 'transparent',
+    display: 'block',
+    overflow: 'hidden',
+    listStyleType: 'none',
+    // eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
+    height: `${(_props$height = props.height) !== null && _props$height !== void 0 ? _props$height : MENTION_ITEM_HEIGHT}px`,
+    // eslint-disable-next-line @atlaskit/design-system/use-tokens-typography
+    lineHeight: 1.2,
+    cursor: 'pointer'
+  };
+});
 
 // eslint-disable-next-line @atlaskit/ui-styling-standard/no-styled, @atlaskit/ui-styling-standard/no-exported-styles -- Ignored via go/DSP-18766
 export const AccessSectionStyle = styled.div({

package/dist/es2019/item.js

@@ -1,4 +1,4 @@
-import MentionItem, { MENTION_ITEM_HEIGHT } from './components/MentionItem';
+import MentionItem, { MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED } from './components/MentionItem';
 export {
 // Components
-MentionItem, MENTION_ITEM_HEIGHT };
+MentionItem, MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED };

package/dist/es2019/types.js

@@ -6,12 +6,24 @@
  * and `refreshedSecurityProvider` fields.
  */
 
+/**
+ * Describes whether a mention should be rendered in its disabled visual
+ * state and what tooltip (if any) should be shown on hover.
+ */
+
+/**
+ * The minimal input shape used by `getMentionDisabledState`. Kept as a named
+ * type so the config callback and the provider method share the same input
+ * surface, and so callers do not have to fabricate fields they do not have.
+ */
+
 // data is returned from team search service
 
 export let MentionType = /*#__PURE__*/function (MentionType) {
   MentionType[MentionType["SELF"] = 0] = "SELF";
   MentionType[MentionType["RESTRICTED"] = 1] = "RESTRICTED";
   MentionType[MentionType["DEFAULT"] = 2] = "DEFAULT";
+  MentionType[MentionType["DISABLED"] = 3] = "DISABLED";
   return MentionType;
 }({});
 export let UserAccessLevel = /*#__PURE__*/function (UserAccessLevel) {

package/dist/es2019/util/analytics.js

@@ -2,7 +2,7 @@ import { OPERATIONAL_EVENT_TYPE, UI_EVENT_TYPE } from '@atlaskit/analytics-gas-t
 import { ELEMENTS_CHANNEL } from '../_constants';
 import { ComponentNames, isSpecialMentionText } from '../types';
 const packageName = "@atlaskit/mention";
-const packageVersion = "26.0.3";
+const packageVersion = "26.1.0";
 export const SLI_EVENT_TYPE = 'sli';
 export const SMART_EVENT_TYPE = 'smart';
 export const fireAnalyticsMentionTypeaheadEvent = props => (action, duration, userIds = [], query) => {

package/dist/esm/api/ContextMentionResource.js

@@ -36,6 +36,20 @@ var ContextMentionResource = /*#__PURE__*/function () {
     _defineProperty(this, "filter", this.callWithContextIds('filter', 1));
     _defineProperty(this, "recordMentionSelection", this.callWithContextIds('recordMentionSelection', 1));
     _defineProperty(this, "shouldHighlightMention", this.callDefault('shouldHighlightMention'));
+    _defineProperty(this, "getMentionDisabledState", function (mention) {
+      var _this$mentionProvider3, _this$mentionProvider4;
+      return (_this$mentionProvider3 = (_this$mentionProvider4 = _this.mentionProvider).getMentionDisabledState) === null || _this$mentionProvider3 === void 0 ? void 0 : _this$mentionProvider3.call(_this$mentionProvider4, mention);
+    });
+    _defineProperty(this, "subscribeToDisabledStateChanges", function (listener) {
+      var _this$mentionProvider5, _this$mentionProvider6, _this$mentionProvider7;
+      return (_this$mentionProvider5 = (_this$mentionProvider6 = (_this$mentionProvider7 = _this.mentionProvider).subscribeToDisabledStateChanges) === null || _this$mentionProvider6 === void 0 ? void 0 : _this$mentionProvider6.call(_this$mentionProvider7, listener)) !== null && _this$mentionProvider5 !== void 0 ? _this$mentionProvider5 : function () {
+        return undefined;
+      };
+    });
+    _defineProperty(this, "notifyMentionDestroyed", function (mention) {
+      var _this$mentionProvider8, _this$mentionProvider9;
+      return (_this$mentionProvider8 = (_this$mentionProvider9 = _this.mentionProvider).notifyMentionDestroyed) === null || _this$mentionProvider8 === void 0 ? void 0 : _this$mentionProvider8.call(_this$mentionProvider9, mention);
+    });
     _defineProperty(this, "isFiltering", this.callDefault('isFiltering'));
     this.mentionProvider = mentionProvider;
     this.contextIdentifier = contextIdentifier;

package/dist/esm/api/MentionResource.js

@@ -203,6 +203,12 @@ export var MentionResource = /*#__PURE__*/function (_AbstractMentionResou) {
       }
       return false;
     }
+  }, {
+    key: "getMentionDisabledState",
+    value: function getMentionDisabledState(mention) {
+      var _this$config$getMenti, _this$config;
+      return (_this$config$getMenti = (_this$config = this.config).getMentionDisabledState) === null || _this$config$getMenti === void 0 ? void 0 : _this$config$getMenti.call(_this$config, mention);
+    }
   }, {
     key: "notify",
     value: function notify(searchTime, mentionResult, query) {

package/dist/esm/components/DisabledMentionTooltip/index.js

@@ -0,0 +1,9 @@
+import React from 'react';
+var AsyncDisabledMentionTooltip = /*#__PURE__*/React.lazy(function () {
+  return import( /* webpackChunkName: "@atlaskit-internal_@atlaskit/mention/disabled-mention-tooltip" */'./main').then(function (module) {
+    return {
+      default: module.DisabledMentionTooltip
+    };
+  });
+});
+export default AsyncDisabledMentionTooltip;

package/dist/esm/components/DisabledMentionTooltip/main.js

@@ -0,0 +1,17 @@
+import Tooltip from '@atlaskit/tooltip';
+import React from 'react';
+/**
+ * Wraps a disabled `<Mention>` chip with a tooltip explaining why the chip
+ * is disabled. The chip itself remains non-interactive; the tooltip is the
+ * sole hover affordance.
+ */
+export var DisabledMentionTooltip = function DisabledMentionTooltip(_ref) {
+  var tooltip = _ref.tooltip,
+    children = _ref.children;
+  return /*#__PURE__*/React.createElement(Tooltip, {
+    content: tooltip,
+    position: "top"
+  }, function (triggerProps) {
+    return /*#__PURE__*/React.createElement("span", triggerProps, children);
+  });
+};

package/dist/esm/components/Mention/PrimitiveMention.js

@@ -13,7 +13,7 @@ var _excluded = ["mentionType"];
 import { jsx, css } from '@emotion/react';
 import { MentionType } from '../../types';
 import { forwardRef } from 'react';
-var mentionStyle = _defineProperty(_defineProperty(_defineProperty({}, MentionType.SELF, {
+var mentionStyle = _defineProperty(_defineProperty(_defineProperty(_defineProperty({}, MentionType.SELF, {
   background: "var(--ds-background-brand-bold, #1868DB)",
   borderColor: 'transparent',
   text: "var(--ds-text-inverse, #FFFFFF)",
@@ -31,6 +31,13 @@ var mentionStyle = _defineProperty(_defineProperty(_defineProperty({}, MentionTy
   text: "var(--ds-text-subtle, #505258)",
   hoveredBackground: "var(--ds-background-neutral-hovered, #0B120E24)",
   pressedBackground: "var(--ds-background-neutral-pressed, #080F214A)"
+}), MentionType.DISABLED, {
+  background: "var(--ds-background-disabled, #0515240F)",
+  borderColor: 'transparent',
+  text: "var(--ds-text-disabled, #080F214A)",
+  // Disabled chips do not change on hover / press.
+  hoveredBackground: "var(--ds-background-disabled, #0515240F)",
+  pressedBackground: "var(--ds-background-disabled, #0515240F)"
 });
 var getStyle = function getStyle(_ref, property) {
   var mentionType = _ref.mentionType;

package/dist/esm/components/Mention/index.js

@@ -5,6 +5,8 @@ import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstruct
 import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
 import _inherits from "@babel/runtime/helpers/inherits";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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; }
 function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 import React from 'react';
@@ -12,6 +14,7 @@ import FocusRing from '@atlaskit/focus-ring';
 import MessagesIntlProvider from '../MessagesIntlProvider';
 import PrimitiveMention from './PrimitiveMention';
 import AsyncNoAccessTooltip from '../NoAccessTooltip';
+import AsyncDisabledMentionTooltip from '../DisabledMentionTooltip';
 import { isRestricted, MentionType } from '../../types';
 import { fireAnalyticsMentionEvent } from '../../util/analytics';
 import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
@@ -29,7 +32,12 @@ export var MentionInternal = /*#__PURE__*/function (_React$PureComponent) {
       var _this$props = _this.props,
         id = _this$props.id,
         text = _this$props.text,
-        onClick = _this$props.onClick;
+        onClick = _this$props.onClick,
+        isDisabled = _this$props.isDisabled;
+      if (isDisabled) {
+        // Disabled chips do not invoke their click handler.
+        return;
+      }
       if (onClick) {
         onClick(id, text, e);
       }
@@ -65,7 +73,11 @@ export var MentionInternal = /*#__PURE__*/function (_React$PureComponent) {
     _defineProperty(_this, "getMentionType", function () {
       var _this$props4 = _this.props,
         accessLevel = _this$props4.accessLevel,
-        isHighlighted = _this$props4.isHighlighted;
+        isHighlighted = _this$props4.isHighlighted,
+        isDisabled = _this$props4.isDisabled;
+      if (isDisabled) {
+        return MentionType.DISABLED;
+      }
       if (isHighlighted) {
         return MentionType.SELF;
       }
@@ -115,11 +127,25 @@ export var MentionInternal = /*#__PURE__*/function (_React$PureComponent) {
       var text = props.text,
         id = props.id,
         accessLevel = props.accessLevel,
-        localId = props.localId;
+        localId = props.localId,
+        disabledTooltip = props.disabledTooltip;
       var mentionType = this.getMentionType();
       var failedMention = text === "@".concat(UNKNOWN_USER_ID);
-      var showTooltip = mentionType === MentionType.RESTRICTED;
-      var mentionComponent = /*#__PURE__*/React.createElement(FocusRing, null, /*#__PURE__*/React.createElement(PrimitiveMention, {
+      var showRestrictedTooltip = mentionType === MentionType.RESTRICTED;
+      var showDisabledTooltip = mentionType === MentionType.DISABLED && !!disabledTooltip;
+
+      // A11y: when the chip is in the disabled visual state, expose
+      // `aria-disabled` so assistive tech announces it as such. The
+      // disabled-tooltip text is mirrored into `aria-label` so the
+      // announcement carries the reason even without portal-id wiring for
+      // `aria-describedby`.
+      var isDisabledChip = mentionType === MentionType.DISABLED;
+      var disabledA11yProps = isDisabledChip ? _objectSpread({
+        'aria-disabled': true
+      }, disabledTooltip ? {
+        'aria-label': "".concat(text || '@...', " \u2014 ").concat(disabledTooltip)
+      } : {}) : {};
+      var mentionComponent = /*#__PURE__*/React.createElement(FocusRing, null, /*#__PURE__*/React.createElement(PrimitiveMention, _extends({
         mentionType: mentionType,
         onClick: handleOnClick,
         onMouseEnter: handleOnMouseEnter,
@@ -127,11 +153,28 @@ export var MentionInternal = /*#__PURE__*/function (_React$PureComponent) {
         spellCheck: false,
         "data-testid": "mention-".concat(id),
         "data-mention-type": mentionType,
-        "data-mention-tooltip": showTooltip
-      }, failedMention ? this.renderUnknownUserError(id) : text || '@...'));
+        "data-mention-tooltip": showRestrictedTooltip || showDisabledTooltip
+      }, disabledA11yProps), failedMention ? this.renderUnknownUserError(id) : text || '@...'));
       var ssrPlaceholderProp = props.ssrPlaceholderId ? {
         'data-ssr-placeholder': props.ssrPlaceholderId
       } : {};
+      var wrappedMention = function () {
+        if (showRestrictedTooltip) {
+          return /*#__PURE__*/React.createElement(React.Suspense, {
+            fallback: mentionComponent
+          }, /*#__PURE__*/React.createElement(AsyncNoAccessTooltip, {
+            name: text
+          }, mentionComponent));
+        }
+        if (showDisabledTooltip) {
+          return /*#__PURE__*/React.createElement(React.Suspense, {
+            fallback: mentionComponent
+          }, /*#__PURE__*/React.createElement(AsyncDisabledMentionTooltip, {
+            tooltip: disabledTooltip
+          }, mentionComponent));
+        }
+        return mentionComponent;
+      }();
       return /*#__PURE__*/React.createElement(UfoErrorBoundary, {
         id: id
       }, /*#__PURE__*/React.createElement("span", _extends({
@@ -140,11 +183,7 @@ export var MentionInternal = /*#__PURE__*/function (_React$PureComponent) {
         "data-local-id": localId,
         "data-access-level": accessLevel,
         spellCheck: false
-      }, ssrPlaceholderProp), /*#__PURE__*/React.createElement(MessagesIntlProvider, null, showTooltip ? /*#__PURE__*/React.createElement(React.Suspense, {
-        fallback: mentionComponent
-      }, /*#__PURE__*/React.createElement(AsyncNoAccessTooltip, {
-        name: text
-      }, mentionComponent)) : mentionComponent)));
+      }, ssrPlaceholderProp), /*#__PURE__*/React.createElement(MessagesIntlProvider, null, wrappedMention)));
     }
   }]);
 }(React.PureComponent);

package/dist/esm/components/MentionItem/index.js

@@ -23,7 +23,7 @@ import { renderHighlight } from './MentionHighlightHelpers';
 import MentionDescriptionByline from '../MentionDescriptionByline';
 import MessagesIntlProvider from '../MessagesIntlProvider';
 import { MentionAvatar } from '../MentionAvatar';
-export { MENTION_ITEM_HEIGHT } from './styles';
+export { MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED } from './styles';
 var lozengeAppearanceToTagColor = {
   default: 'standard',
   success: 'lime',
@@ -107,7 +107,8 @@ var MentionItem = /*#__PURE__*/function (_React$PureComponent) {
       var _this$props = this.props,
         mention = _this$props.mention,
         selected = _this$props.selected,
-        forwardedRef = _this$props.forwardedRef;
+        forwardedRef = _this$props.forwardedRef,
+        height = _this$props.height;
       var id = mention.id,
         highlight = mention.highlight,
         presence = mention.presence,
@@ -123,6 +124,7 @@ var MentionItem = /*#__PURE__*/function (_React$PureComponent) {
       var xProductUserInfoIconColor = selected ? "var(--ds-icon-selected, #1868DB)" : "var(--ds-icon, #292A2E)";
       return /*#__PURE__*/React.createElement(MessagesIntlProvider, null, /*#__PURE__*/React.createElement(MentionItemStyle, {
         selected: selected,
+        height: height,
         onMouseDown: this.onMentionSelected,
         onMouseMove: this.onMentionMenuItemMouseMove,
         onMouseEnter: this.onMentionMenuItemMouseEnter,

package/dist/esm/components/MentionItem/styles.js

@@ -75,15 +75,18 @@ export var TimeStyle = styled.div({
   font: "var(--ds-font-body-small, normal 400 12px/16px \"Atlassian Sans\", ui-sans-serif, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Ubuntu, \"Helvetica Neue\", sans-serif)"
 });
 export var MENTION_ITEM_HEIGHT = 48;
+export var MENTION_ITEM_HEIGHT_REFRESHED = 44;
 // eslint-disable-next-line @atlaskit/ui-styling-standard/no-styled, @atlaskit/ui-styling-standard/no-exported-styles, @atlaskit/ui-styling-standard/no-dynamic-styles -- Ignored via go/DSP-18766
 export var MentionItemStyle = styled.div(function (props) {
+  var _props$height;
   return {
     // eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
     backgroundColor: props.selected ? "var(--ds-background-selected, #E9F2FE)" : 'transparent',
     display: 'block',
     overflow: 'hidden',
     listStyleType: 'none',
-    height: "".concat(MENTION_ITEM_HEIGHT, "px"),
+    // eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
+    height: "".concat((_props$height = props.height) !== null && _props$height !== void 0 ? _props$height : MENTION_ITEM_HEIGHT, "px"),
     // eslint-disable-next-line @atlaskit/design-system/use-tokens-typography
     lineHeight: 1.2,
     cursor: 'pointer'

package/dist/esm/item.js

@@ -1,4 +1,4 @@
-import MentionItem, { MENTION_ITEM_HEIGHT } from './components/MentionItem';
+import MentionItem, { MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED } from './components/MentionItem';
 export {
 // Components
-MentionItem, MENTION_ITEM_HEIGHT };
+MentionItem, MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED };

package/dist/esm/types.js

@@ -6,12 +6,24 @@
  * and `refreshedSecurityProvider` fields.
  */
 
+/**
+ * Describes whether a mention should be rendered in its disabled visual
+ * state and what tooltip (if any) should be shown on hover.
+ */
+
+/**
+ * The minimal input shape used by `getMentionDisabledState`. Kept as a named
+ * type so the config callback and the provider method share the same input
+ * surface, and so callers do not have to fabricate fields they do not have.
+ */
+
 // data is returned from team search service
 
 export var MentionType = /*#__PURE__*/function (MentionType) {
   MentionType[MentionType["SELF"] = 0] = "SELF";
   MentionType[MentionType["RESTRICTED"] = 1] = "RESTRICTED";
   MentionType[MentionType["DEFAULT"] = 2] = "DEFAULT";
+  MentionType[MentionType["DISABLED"] = 3] = "DISABLED";
   return MentionType;
 }({});
 export var UserAccessLevel = /*#__PURE__*/function (UserAccessLevel) {

package/dist/esm/util/analytics.js

@@ -5,7 +5,7 @@ import { OPERATIONAL_EVENT_TYPE, UI_EVENT_TYPE } from '@atlaskit/analytics-gas-t
 import { ELEMENTS_CHANNEL } from '../_constants';
 import { ComponentNames, isSpecialMentionText } from '../types';
 var packageName = "@atlaskit/mention";
-var packageVersion = "26.0.3";
+var packageVersion = "26.1.0";
 export var SLI_EVENT_TYPE = 'sli';
 export var SMART_EVENT_TYPE = 'smart';
 export var fireAnalyticsMentionTypeaheadEvent = function fireAnalyticsMentionTypeaheadEvent(props) {

package/dist/types/api/ContextMentionResource.d.ts

@@ -1,5 +1,5 @@
 import { type MentionProvider, type MentionContextIdentifier, ErrorCallback, InfoCallback, ResultCallback } from './MentionResource';
-import { type MentionDescription, type InviteFromMentionProvider, type XProductInviteMentionProvider, type AnalyticsCallback } from '../types';
+import { type MentionDescription, type MentionDisabledState, type MentionDisabledStateInput, type InviteFromMentionProvider, type XProductInviteMentionProvider, type AnalyticsCallback } from '../types';
 export type { MentionDescription };
 export type MentionProviderFunctions = Omit<{
     [Key in keyof MentionProvider]: MentionProvider[Key] extends Function ? MentionProvider[Key] : never;
@@ -19,5 +19,10 @@ export default class ContextMentionResource implements MentionProvider {
     filter: (query?: string, contextIdentifier?: MentionContextIdentifier) => void;
     recordMentionSelection: (mention: MentionDescription, contextIdentifier?: MentionContextIdentifier) => void;
     shouldHighlightMention: (mention: MentionDescription) => boolean;
+    getMentionDisabledState: (mention: MentionDisabledStateInput) => MentionDisabledState | undefined;
+    subscribeToDisabledStateChanges: (listener: () => void) => (() => void);
+    notifyMentionDestroyed: (mention: {
+        id: string;
+    }) => void;
     isFiltering: (query: string) => boolean;
 }

package/dist/types/api/MentionResource.d.ts

@@ -1,4 +1,4 @@
-import { type AnalyticsCallback, type ErrorCallback, type InfoCallback, type InviteFlow, type MentionContextIdentifier, type MentionDescription, type MentionNameDetails, type MentionProvider, type MentionResourceConfig, type MentionsResult, type MentionStats, type ResourceProvider, type ResultCallback, type UserRole } from '../types';
+import { type AnalyticsCallback, type ErrorCallback, type InfoCallback, type InviteFlow, type MentionContextIdentifier, type MentionDescription, type MentionDisabledState, type MentionDisabledStateInput, type MentionNameDetails, type MentionProvider, type MentionResourceConfig, type MentionsResult, type MentionStats, type ResourceProvider, type ResultCallback, type UserRole } from '../types';
 export type { MentionStats, ResultCallback, ErrorCallback, InfoCallback, MentionResourceConfig, ResourceProvider, MentionContextIdentifier, MentionProvider, } from '../types';
 /**
  * Configuration for the TeamMentionResource, which extends {@link MentionResourceConfig}
@@ -62,6 +62,7 @@ export declare class MentionResource extends AbstractMentionResource implements
     inviteXProductUser?: (userId: string, mentionName: string) => Promise<void>;
     constructor(config: MentionResourceConfig);
     shouldHighlightMention(mention: MentionDescription): boolean;
+    getMentionDisabledState(mention: MentionDisabledStateInput): MentionDisabledState | undefined;
     notify(searchTime: number, mentionResult: MentionsResult, query?: string): void;
     notifyError(error: Error, query?: string): void;
     filter(query?: string, contextIdentifier?: MentionContextIdentifier): Promise<void>;

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

@@ -0,0 +1,6 @@
+import React from 'react';
+declare const AsyncDisabledMentionTooltip: React.LazyExoticComponent<({ tooltip, children }: {
+    children: React.ReactNode;
+    tooltip: string;
+}) => React.JSX.Element>;
+export default AsyncDisabledMentionTooltip;

package/dist/types/components/DisabledMentionTooltip/main.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+type Props = {
+    children: React.ReactNode;
+    tooltip: string;
+};
+/**
+ * Wraps a disabled `<Mention>` chip with a tooltip explaining why the chip
+ * is disabled. The chip itself remains non-interactive; the tooltip is the
+ * sole hover affordance.
+ */
+export declare const DisabledMentionTooltip: ({ tooltip, children }: Props) => React.JSX.Element;
+export {};

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

@@ -5,7 +5,19 @@ export declare const ANALYTICS_HOVER_DELAY = 1000;
 export declare const UNKNOWN_USER_ID = "_|unknown|_";
 export type OwnProps = {
     accessLevel?: string;
+    /**
+     * Tooltip text shown on hover when the chip is disabled. Ignored when
+     * `isDisabled` is false. When omitted, no tooltip is rendered even if
+     * `isDisabled` is true.
+     */
+    disabledTooltip?: string;
     id: string;
+    /**
+     * When true, the mention chip is rendered in its disabled visual state
+     * (`MentionType.DISABLED`) and click handlers are not invoked. Takes
+     * precedence over `isHighlighted` and the restricted state.
+     */
+    isDisabled?: boolean;
     isHighlighted?: boolean;
     localId?: string;
     onClick?: MentionEventHandler;

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

@@ -1,8 +1,9 @@
 import React from 'react';
 import { type MentionDescription, type OnMentionEvent } from '../../types';
-export { MENTION_ITEM_HEIGHT } from './styles';
+export { MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED } from './styles';
 export interface Props {
     forwardedRef?: React.Ref<HTMLDivElement>;
+    height?: number;
     mention: MentionDescription;
     onMouseEnter?: OnMentionEvent;
     onMouseMove?: OnMentionEvent;

package/dist/types/components/MentionItem/styles.d.ts

@@ -2,6 +2,7 @@ import { type StyledComponent } from '@emotion/styled';
 import type { Theme } from '@emotion/react';
 import type { DetailedHTMLProps, HTMLAttributes } from 'react';
 export interface MentionItemStyleProps {
+    height?: number;
     selected?: boolean;
 }
 export interface AvatarSectionStyleProps {
@@ -38,6 +39,7 @@ export declare const TimeStyle: StyledComponent<{
     theme?: Theme;
 }, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const MENTION_ITEM_HEIGHT = 48;
+export declare const MENTION_ITEM_HEIGHT_REFRESHED = 44;
 export declare const MentionItemStyle: StyledComponent<{
     as?: React.ElementType;
     theme?: Theme;

package/dist/types/item.d.ts

@@ -1,2 +1,2 @@
-import MentionItem, { MENTION_ITEM_HEIGHT } from './components/MentionItem';
-export { MentionItem, MENTION_ITEM_HEIGHT, };
+import MentionItem, { MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED } from './components/MentionItem';
+export { MentionItem, MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED, };

package/dist/types/types.d.ts

@@ -39,6 +39,24 @@ export interface MentionResourceConfig extends ServiceConfig {
      * calls to `filter` will be debounced to reduce the number of network requests.
      */
     debounceTime?: number;
+    /**
+     * A function to determine whether a given mention should be rendered in
+     * its disabled visual state (`MentionType.DISABLED`), and what tooltip
+     * (if any) to display when the disabled chip is hovered.
+     *
+     * Returning `{ disabled: false }` (or `undefined`) leaves the mention in
+     * whatever state the other predicates resolve to.
+     *
+     * The input deliberately exposes only the mention's `id` because the
+     * canonical caller (the editor mentions `NodeView`) does not have the
+     * full `MentionDescription` in scope. Implementations should look the
+     * additional context they need (e.g. agent metadata) up via the `id`.
+     *
+     * @param mention - The minimal mention identifier to evaluate.
+     * @returns `{ disabled, tooltip? }` describing the disabled visual state,
+     * or `undefined` to leave it unchanged.
+     */
+    getMentionDisabledState?: (mention: MentionDisabledStateInput) => MentionDisabledState | undefined;
     /**
      * Custom HTTP headers to include in mention service requests.
      */
@@ -94,6 +112,22 @@ export interface MentionResourceConfig extends ServiceConfig {
      */
     userRole?: UserRole;
 }
+/**
+ * Describes whether a mention should be rendered in its disabled visual
+ * state and what tooltip (if any) should be shown on hover.
+ */
+export interface MentionDisabledState {
+    disabled: boolean;
+    tooltip?: string;
+}
+/**
+ * The minimal input shape used by `getMentionDisabledState`. Kept as a named
+ * type so the config callback and the provider method share the same input
+ * surface, and so callers do not have to fabricate fields they do not have.
+ */
+export interface MentionDisabledStateInput {
+    id: string;
+}
 export interface ResourceProvider<Result> {
     /**
      * Subscribe to ResourceProvider results
@@ -119,9 +153,40 @@ export type MentionContextIdentifier = {
 };
 export interface MentionProvider extends ResourceProvider<MentionDescription[]>, InviteFromMentionProvider, XProductInviteMentionProvider {
     filter(query?: string, contextIdentifier?: MentionContextIdentifier): void;
+    /**
+     * Optional. When implemented, lets the rendering surface ask whether a
+     * mention should be displayed in its disabled visual state, and what
+     * tooltip to surface on hover. Returning `undefined` (or omitting the
+     * method entirely) is equivalent to "not disabled".
+     */
+    getMentionDisabledState?(mention: MentionDisabledStateInput): MentionDisabledState | undefined;
     isFiltering(query: string): boolean;
+    /**
+     * Optional. Called by the rendering surface (e.g. the editor NodeView)
+     * when a mention chip is destroyed (removed from the doc). This is the
+     * lowest-level deletion signal — it fires regardless of how the chip was
+     * removed (backspace, select-and-delete, programmatic replace, …) and
+     * does not depend on the editor's debounced `onChange` callback.
+     *
+     * Implementations typically forward the call to consumers via the chat
+     * layer so they can react (e.g. update `selectedAgentIds`).
+     */
+    notifyMentionDestroyed?(mention: {
+        id: string;
+    }): void;
     recordMentionSelection(mention: MentionDescription, contextIdentifier?: MentionContextIdentifier): void;
     shouldHighlightMention(mention: MentionDescription): boolean;
+    /**
+     * Optional. When implemented, lets the rendering surface subscribe to
+     * changes in the disabled-state predicate so already-rendered chips can
+     * re-evaluate themselves when the external state that drives
+     * `getMentionDisabledState` changes (e.g. the active agent selection in
+     * Rovo Chat). Implementations should invoke the listener after their
+     * own state changes.
+     *
+     * Returns an unsubscribe function. Callers MUST invoke it on teardown.
+     */
+    subscribeToDisabledStateChanges?(listener: () => void): () => void;
 }
 export interface HighlightDetail {
     end: number;
@@ -188,7 +253,8 @@ export interface OnMentionEvent {
 export declare enum MentionType {
     SELF = 0,
     RESTRICTED = 1,
-    DEFAULT = 2
+    DEFAULT = 2,
+    DISABLED = 3
 }
 export declare enum UserAccessLevel {
     NONE = 0,

package/dist/types-ts4.5/api/ContextMentionResource.d.ts

@@ -1,5 +1,5 @@
 import { type MentionProvider, type MentionContextIdentifier, ErrorCallback, InfoCallback, ResultCallback } from './MentionResource';
-import { type MentionDescription, type InviteFromMentionProvider, type XProductInviteMentionProvider, type AnalyticsCallback } from '../types';
+import { type MentionDescription, type MentionDisabledState, type MentionDisabledStateInput, type InviteFromMentionProvider, type XProductInviteMentionProvider, type AnalyticsCallback } from '../types';
 export type { MentionDescription };
 export type MentionProviderFunctions = Omit<{
     [Key in keyof MentionProvider]: MentionProvider[Key] extends Function ? MentionProvider[Key] : never;
@@ -19,5 +19,10 @@ export default class ContextMentionResource implements MentionProvider {
     filter: (query?: string, contextIdentifier?: MentionContextIdentifier) => void;
     recordMentionSelection: (mention: MentionDescription, contextIdentifier?: MentionContextIdentifier) => void;
     shouldHighlightMention: (mention: MentionDescription) => boolean;
+    getMentionDisabledState: (mention: MentionDisabledStateInput) => MentionDisabledState | undefined;
+    subscribeToDisabledStateChanges: (listener: () => void) => (() => void);
+    notifyMentionDestroyed: (mention: {
+        id: string;
+    }) => void;
     isFiltering: (query: string) => boolean;
 }

package/dist/types-ts4.5/api/MentionResource.d.ts

@@ -1,4 +1,4 @@
-import { type AnalyticsCallback, type ErrorCallback, type InfoCallback, type InviteFlow, type MentionContextIdentifier, type MentionDescription, type MentionNameDetails, type MentionProvider, type MentionResourceConfig, type MentionsResult, type MentionStats, type ResourceProvider, type ResultCallback, type UserRole } from '../types';
+import { type AnalyticsCallback, type ErrorCallback, type InfoCallback, type InviteFlow, type MentionContextIdentifier, type MentionDescription, type MentionDisabledState, type MentionDisabledStateInput, type MentionNameDetails, type MentionProvider, type MentionResourceConfig, type MentionsResult, type MentionStats, type ResourceProvider, type ResultCallback, type UserRole } from '../types';
 export type { MentionStats, ResultCallback, ErrorCallback, InfoCallback, MentionResourceConfig, ResourceProvider, MentionContextIdentifier, MentionProvider, } from '../types';
 /**
  * Configuration for the TeamMentionResource, which extends {@link MentionResourceConfig}
@@ -62,6 +62,7 @@ export declare class MentionResource extends AbstractMentionResource implements
     inviteXProductUser?: (userId: string, mentionName: string) => Promise<void>;
     constructor(config: MentionResourceConfig);
     shouldHighlightMention(mention: MentionDescription): boolean;
+    getMentionDisabledState(mention: MentionDisabledStateInput): MentionDisabledState | undefined;
     notify(searchTime: number, mentionResult: MentionsResult, query?: string): void;
     notifyError(error: Error, query?: string): void;
     filter(query?: string, contextIdentifier?: MentionContextIdentifier): Promise<void>;

package/dist/types-ts4.5/components/DisabledMentionTooltip/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+declare const AsyncDisabledMentionTooltip: React.LazyExoticComponent<({ tooltip, children }: {
+    children: React.ReactNode;
+    tooltip: string;
+}) => React.JSX.Element>;
+export default AsyncDisabledMentionTooltip;