@atlaskit/mention 26.0.4 → 26.2.0

package/dist/types-ts4.5/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-ts4.5/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-ts4.5/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-ts4.5/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-ts4.5/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-ts4.5/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/package.json

@@ -26,20 +26,20 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@atlaskit/afm-i18n-platform-elements-mention": "2.130.0",
+		"@atlaskit/afm-i18n-platform-elements-mention": "2.142.0",
 		"@atlaskit/analytics-gas-types": "^5.1.0",
-		"@atlaskit/analytics-next": "^11.2.0",
+		"@atlaskit/analytics-next": "^11.3.0",
 		"@atlaskit/avatar": "^25.15.0",
 		"@atlaskit/focus-ring": "^3.1.0",
 		"@atlaskit/heading": "^5.4.0",
-		"@atlaskit/icon": "^35.3.0",
+		"@atlaskit/icon": "^35.4.0",
 		"@atlaskit/lozenge": "^13.8.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/primitives": "^19.0.0",
-		"@atlaskit/tag": "^14.14.0",
+		"@atlaskit/tag": "^14.15.0",
 		"@atlaskit/teams-avatar": "^2.7.0",
-		"@atlaskit/tokens": "^13.0.0",
-		"@atlaskit/tooltip": "^22.3.0",
+		"@atlaskit/tokens": "^13.1.0",
+		"@atlaskit/tooltip": "^22.6.0",
 		"@atlaskit/ufo": "^0.5.0",
 		"@atlaskit/util-service-support": "^6.4.0",
 		"@babel/runtime": "^7.0.0",
@@ -120,5 +120,5 @@
 			]
 		}
 	},
-	"version": "26.0.4"
+	"version": "26.2.0"
 }