@atlaskit/mention 26.1.0 → 26.3.0

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.4";
+const packageVersion = "26.3.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/MentionAvatar/index.js

@@ -2,7 +2,7 @@ import React from 'react';
 import Avatar, { getAppearanceForAppType } from '@atlaskit/avatar';
 import TeamAvatar from '@atlaskit/teams-avatar';
 import { fg } from '@atlaskit/platform-feature-flags';
-import { isTeamMention } from '../../types';
+import { isAppMention, isTeamMention } from '../../types';
 export var MentionAvatar = function MentionAvatar(_ref) {
   var mention = _ref.mention,
     selected = _ref.selected;
@@ -19,11 +19,16 @@ export var MentionAvatar = function MentionAvatar(_ref) {
       borderColor: borderColor
     });
   }
+
+  // Agent providers can request GraphQL `identityAccount { picture }` and pass it as
+  // `avatarUrl`; this component only applies the hexagon agent shape.
+  var shouldRenderAgentMentionAvatar = isAppMention(mention) && mention.appType === 'agent' && fg('rovo_chat_agent_selection');
+  var avatarAppearance = shouldRenderAgentMentionAvatar ? 'hexagon' : fg('jira_ai_agent_avatar_issue_view_comment_mentions') ? getAppearanceForAppType(appType) : undefined;
   return /*#__PURE__*/React.createElement(Avatar, {
     src: avatarUrl,
     size: "medium",
     presence: status,
     borderColor: borderColor,
-    appearance: fg('jira_ai_agent_avatar_issue_view_comment_mentions') ? getAppearanceForAppType(appType) : undefined
+    appearance: avatarAppearance
   });
 };

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.4";
+var packageVersion = "26.3.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/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/docs/0-intro.tsx

@@ -79,6 +79,27 @@ const _default_1: any = md`
 		/>
 	)}
 
+  ## Mention chip variants
+
+  The \`<Mention>\` chip has four visual variants:
+
+  - **Default** — a neutral chip rendered for any in-scope mention.
+  - **Self** — emphasised brand-coloured chip rendered when \`isHighlighted\`
+    is set, typically used to highlight a mention of the current user.
+  - **Restricted** — outlined chip rendered when the mention's
+    \`accessLevel\` indicates the referenced user does not have access; on
+    hover the chip surfaces a "no access" tooltip.
+  - **Disabled** — muted grey chip rendered when \`isDisabled\` is set.
+    Click handlers are suppressed, the chip exposes
+    \`aria-disabled="true"\`, and (with a \`disabledTooltip\` set) hover or
+    keyboard focus surfaces an ADS tooltip explaining why the chip is
+    disabled. The disabled chip remains keyboard-focusable so screen-reader
+    users encounter it and hear the reason.
+
+  Inside the editor, the disabled state is driven by
+  \`MentionProvider.getMentionDisabledState({ id })\` so rendering surfaces
+  don't need to thread per-chip props through ProseMirror node views.
+
   ${(<Props props={MentionProps} />)}
 
 `;

package/element/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/element.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/element.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/element.d.ts"
 }

package/item/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/item.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/item.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/item.d.ts"
 }

package/mention/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/components/Mention/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/components/Mention/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/components/Mention/index.d.ts"
 }

package/mention-item/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/components/MentionItem/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/components/MentionItem/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/components/MentionItem/index.d.ts"
 }

package/mention-item/styles/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../../dist/types/components/MentionItem/styles.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../../dist/types-ts4.5/components/MentionItem/styles.d.ts"
-      ]
-    }
-  }
+  "types": "../../dist/types/components/MentionItem/styles.d.ts"
 }

package/mention-list/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/components/MentionList/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/components/MentionList/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/components/MentionList/index.d.ts"
 }

package/mention-name-client/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/api/MentionNameClient.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/api/MentionNameClient.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/api/MentionNameClient.d.ts"
 }

package/mention-name-resolver/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/api/MentionNameResolver.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/api/MentionNameResolver.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/api/MentionNameResolver.d.ts"
 }

package/mention-picker/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/components/MentionPicker/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/components/MentionPicker/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/components/MentionPicker/index.d.ts"
 }

package/mention-resource/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/api/MentionResource.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/api/MentionResource.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/api/MentionResource.d.ts"
 }