@box/threaded-annotations 1.80.0

package/dist/types/lib/document-node-types.d.ts

@@ -0,0 +1,32 @@
+export type MentionNode = {
+    type: 'mention';
+    attrs: EditorMentionAttributes & MentionRenderAttributes;
+};
+export type EditorMentionAttributes = {
+    mentionedUserId: string;
+    mentionedUserName: string;
+    mentionedUserEmail?: string;
+    mentionId: string;
+};
+export type MentionRenderAttributes = {
+    authorId: string;
+    mentionId: string;
+};
+export type TextNode = {
+    type: 'text';
+    text: string;
+    marks?: Array<{
+        type: string;
+        attrs?: Record<string, unknown>;
+    }>;
+};
+export type ParagraphNode = {
+    type: 'paragraph';
+    content?: (MentionNode | TextNode)[];
+    attrs?: Record<string, unknown>;
+};
+export type DocumentNode = {
+    type: 'doc';
+    content: ParagraphNode[];
+    attrs?: Record<string, unknown>;
+};

package/dist/types/lib/messages.d.ts

@@ -0,0 +1,28 @@
+declare const messages: {
+    reply: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
+    annotationMessageAriaLabel: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
+    replyButtonAriaLabel: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
+    textMentionAriaLabel: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
+    textMessageAriaLabel: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
+};
+export default messages;

package/dist/types/lib/stories/mock/index.d.ts

@@ -0,0 +1,5 @@
+export * from './mock-callbacks';
+export * from './mock-messages';
+export * from './mock-users';
+export * from './mock-utilities';
+export * from './mock-messages-long-strings';

package/dist/types/lib/stories/mock/mock-callbacks.d.ts

@@ -0,0 +1,6 @@
+import { JSONContent } from '@tiptap/core';
+import { TextMessageType } from '../../components/text-message/types';
+export declare const MOCK_CALLBACKS: {
+    onPost: (content: JSONContent | null) => Promise<TextMessageType>;
+    onPostWithError: () => Promise<never>;
+};

package/dist/types/lib/stories/mock/mock-messages-long-strings.d.ts

@@ -0,0 +1,11 @@
+import { TextMessageType } from '../../components/text-message/types';
+import { DocumentNode } from '../../document-node-types';
+export declare const generateLongAlphabetString: (length: number) => string;
+export declare const createLongStringMessage: (stringLength: number) => DocumentNode;
+export declare const createUserWithLongName: (id: number, nameLength: number) => {
+    id: number;
+    name: string;
+    isExternalUser: boolean;
+};
+export declare const createLongStringAnnotationMessage: (id: string, messageLength: number, nameLength: number, userId: number) => TextMessageType;
+export declare const MOCK_LONG_STRING_MESSAGES: TextMessageType[];

package/dist/types/lib/stories/mock/mock-messages.d.ts

@@ -0,0 +1,8 @@
+import { TextMessageType } from '../../components/text-message/types';
+import { DocumentNode } from '../../document-node-types';
+import { MOCK_USERS } from './mock-users';
+export declare const MOCK_MESSAGE_CONTENT: DocumentNode[];
+export declare const MOCK_ANNOTATIONS_MESSAGE_CONTENT: DocumentNode;
+export declare const createMockAnnotationMessage: (id: string, messageContent: DocumentNode, author: (typeof MOCK_USERS)[keyof typeof MOCK_USERS]) => TextMessageType;
+export declare const MOCK_ANNOTATION_MESSAGES: TextMessageType[];
+export declare const MOCK_SINGLE_ANNOTATION_MESSAGE: TextMessageType;

package/dist/types/lib/stories/mock/mock-users.d.ts

@@ -0,0 +1,56 @@
+import { UserContactType } from '@box/user-selector';
+export declare const MOCK_USERS: {
+    readonly LIAM_FOSTER: {
+        readonly avatarUrl: "/img/avatar.svg";
+        readonly email: "liam.foster@example.com";
+        readonly id: 1;
+        readonly name: "Liam Foster";
+        readonly value: "Liam Foster";
+        readonly isExternalUser: false;
+    };
+    readonly SARAH_CHEN: {
+        readonly email: "sarah.chen@example.com";
+        readonly id: 2;
+        readonly name: "Sarah Chen";
+        readonly value: "Sarah Chen";
+        readonly isExternalUser: true;
+    };
+    readonly ALEX_RODRIGUEZ: {
+        readonly email: "alex.rodriguez@example.com";
+        readonly id: 3;
+        readonly name: "Alex Rodriguez";
+        readonly value: "Alex Rodriguez";
+        readonly isExternalUser: false;
+    };
+    readonly EMMA_WILSON: {
+        readonly avatarUrl: "/img/avatar.svg";
+        readonly email: "emma.wilson@external.com";
+        readonly id: 4;
+        readonly name: "Emma Wilson";
+        readonly value: "Emma Wilson";
+        readonly isExternalUser: true;
+    };
+    readonly DAVID_THOMPSON: {
+        readonly email: "david.thompson@example.com";
+        readonly id: 12312312;
+        readonly name: "David Thompson";
+        readonly value: "David Thompson";
+        readonly isExternalUser: false;
+    };
+    readonly TEST_USER: {
+        readonly id: 1213123;
+        readonly name: "Test User";
+        readonly email: "test@box.com";
+        readonly isCurrentUser: true;
+        readonly isExternalUser: false;
+        readonly value: "Test User";
+    };
+    readonly CURRENT_USER: {
+        readonly email: "you@example.com";
+        readonly id: 999;
+        readonly name: "Test User";
+        readonly value: "Test User";
+        readonly isExternalUser: false;
+    };
+};
+export declare const MOCK_USER_SELECTOR_USERS: UserContactType[];

package/dist/types/lib/stories/mock/mock-utilities.d.ts

@@ -0,0 +1,6 @@
+import { FetchedAvatarUrls, UserContactType } from '@box/user-selector';
+import { JSONContent } from '@tiptap/core';
+import { DocumentNode } from '../../document-node-types';
+export declare const createDocumentNode: (content: JSONContent | null) => DocumentNode;
+export declare const createMockFetchUsers: (users?: UserContactType[]) => (query: string) => Promise<UserContactType[]>;
+export declare const createMockFetchAvatarUrls: () => () => Promise<FetchedAvatarUrls>;

package/dist/types/lib/stories/shared.d.ts

@@ -0,0 +1,9 @@
+import { ThreadedAnnotationsProps } from '../threaded-annotations';
+import { mockMessageData } from './utils/mock-props';
+interface InteractiveModuleProps {
+    initialMessages?: typeof mockMessageData;
+    onAnnotationsClose?: () => void;
+}
+export declare const InteractiveModule: ({ initialMessages, onAnnotationsClose: onAnnotationsCloseProp, }?: InteractiveModuleProps) => import("react/jsx-runtime").JSX.Element;
+export declare const StaticModule: (props: ThreadedAnnotationsProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/lib/stories/utils/mock-collaboration-props.d.ts

@@ -0,0 +1,13 @@
+import { CollaborationPopoverType, UserInfo } from '@box/collaboration-popover';
+/**
+ * Creates mock collaboration popover props for use in story files.
+ * This centralizes the mock props to avoid code duplication.
+ */
+export declare const createMockCollaborationPopoverProps: () => {
+    onSubmit: (userInfo: UserInfo, inviteType?: string) => Promise<void>;
+    onUserClick: import('storybook/test').Mock<(...args: any[]) => any>;
+    onClose: import('storybook/test').Mock<(...args: any[]) => any>;
+    onInviteTypeChange: import('storybook/test').Mock<(...args: any[]) => any>;
+    loading: boolean;
+    type: CollaborationPopoverType;
+};

package/dist/types/lib/stories/utils/mock-props.d.ts

@@ -0,0 +1,20 @@
+import { CollaborationPopoverType, UserInfo } from '@box/collaboration-popover';
+import { MessageEditorProps } from '../../components/message-editor/message-editor';
+import { TextMessageType } from '../../components/text-message/types';
+export declare const createMockThreadedAnnotationsProps: (messages?: TextMessageType[]) => {
+    messageEditorOptions: Omit<MessageEditorProps, "onCancel" | "messageCount">;
+    messagesViewOptions: {
+        messages: TextMessageType[];
+        onDelete: () => any;
+        onAvatarClick: () => any;
+    };
+    collaborationPopoverProps: {
+        onSubmit: (userInfo: UserInfo, inviteType?: string) => Promise<void>;
+        onUserClick: () => any;
+        onClose: () => any;
+        onInviteTypeChange: () => any;
+        loading: boolean;
+        type: (user: UserInfo) => CollaborationPopoverType.Invite | CollaborationPopoverType.Collaborator;
+    };
+};
+export declare const mockMessageData: TextMessageType[];

package/dist/types/lib/stories/utils/mock-state.d.ts

@@ -0,0 +1,8 @@
+import { JSONContent } from '@tiptap/core';
+import { TextMessageType } from '../../components/text-message/types';
+export declare const useMessagesState: (initialMessages: TextMessageType[]) => {
+    messages: TextMessageType[];
+    addMessage: (content: JSONContent | null, timeout?: number) => Promise<TextMessageType>;
+    onSuccess: (message: TextMessageType) => void;
+    deleteMessage: (id: string) => Promise<void>;
+};

package/dist/types/lib/stories/utils/shared/button-utils.d.ts

@@ -0,0 +1,6 @@
+import { userEvent, within } from 'storybook/test';
+export declare const waitForButtonByName: (canvas: ReturnType<typeof within>, name: string | RegExp, options?: {
+    timeout?: number;
+}) => Promise<any>;
+export declare const waitForButtonToDisappear: (canvas: ReturnType<typeof within>, name: string | RegExp) => Promise<void>;
+export declare const clickButtonByName: (user: ReturnType<typeof userEvent.setup>, canvas: ReturnType<typeof within>, name: string | RegExp) => Promise<void>;

package/dist/types/lib/stories/utils/shared/index.d.ts

@@ -0,0 +1,4 @@
+export * from './button-utils';
+export * from './interaction-utils';
+export * from './text-utils';
+export * from './verify-mention-elements';

package/dist/types/lib/stories/utils/shared/interaction-utils.d.ts

@@ -0,0 +1,4 @@
+import { userEvent } from 'storybook/test';
+export declare const hoverOverElement: (user: ReturnType<typeof userEvent.setup>, element: HTMLElement) => Promise<void>;
+export declare const typeInContentEditable: (canvasElement: HTMLElement, user: ReturnType<typeof userEvent.setup>, text: string, editable?: string) => Promise<void>;
+export declare const selectUserByEmail: (user: ReturnType<typeof userEvent.setup>, identifier: string) => Promise<void>;

package/dist/types/lib/stories/utils/shared/test-selectors.d.ts

@@ -0,0 +1,7 @@
+export declare const TEST_SELECTORS: {
+    CANCEL_BUTTON: string;
+    POST_BUTTON: string;
+    REPLY_BUTTON: string;
+    MORE_OPTIONS_BUTTON: string;
+    DELETE_BUTTON: string;
+};

package/dist/types/lib/stories/utils/shared/text-utils.d.ts

@@ -0,0 +1,4 @@
+import { within } from 'storybook/test';
+export declare const waitForTextToAppear: (canvas: ReturnType<typeof within>, text: string, exact?: boolean, timeout?: number) => Promise<any>;
+export declare const waitForTextToDisappear: (canvas: ReturnType<typeof within>, text: string) => Promise<void>;
+export declare const waitForPlaceholderToAppear: (canvas: ReturnType<typeof within>) => Promise<void>;

package/dist/types/lib/stories/utils/shared/verify-mention-elements.d.ts

@@ -0,0 +1,2 @@
+import { userEvent, within } from 'storybook/test';
+export declare const verifyMentionElements: (user: ReturnType<typeof userEvent.setup>, canvas: ReturnType<typeof within>, mentionNames: string[]) => Promise<void>;

package/dist/types/lib/stories/utils/test-utils.d.ts

@@ -0,0 +1,3 @@
+import { userEvent, within } from 'storybook/test';
+export declare const sendMessage: (canvas: ReturnType<typeof within>, canvasElement: HTMLElement, user: ReturnType<typeof userEvent.setup>, messageText: string) => Promise<void>;
+export declare const deleteMessage: (canvas: ReturnType<typeof within>, user: ReturnType<typeof userEvent.setup>, messageText: string, authorName: string) => Promise<void>;

package/dist/types/lib/threaded-annotations.d.ts

@@ -0,0 +1,51 @@
+import { CollaborationPopoverProps } from '@box/collaboration-popover';
+import { UserContactType } from '@box/user-selector';
+import { MessagesViewProps } from './components/messages-view/messages-view';
+import { MessageEditorProps } from './components/message-editor/message-editor';
+/**
+ * Props for the ThreadedAnnotations component.
+ */
+export interface ThreadedAnnotationsProps {
+    /**
+     * Options for the message editor.
+     */
+    messageEditorOptions: Omit<MessageEditorProps, 'onCancel' | 'messageCount'>;
+    /**
+     * Options for the messages view.
+     */
+    messagesViewOptions: Omit<MessagesViewProps, 'onOverflowChange'>;
+    /**
+     * Callback function to be called when the editor is opened.
+     */
+    onEditorOpen?: () => void;
+    /**
+     * Callback function to be called when the editor is closed.
+     */
+    onEditorClose?: () => void;
+    /**
+     * Callback function to be called when the annotations are closed.
+     */
+    onAnnotationsClose?: () => void;
+    /**
+     * Whether the reply button is blocked.
+     */
+    isReplyAllowed?: boolean;
+    /**
+     * Collaboration popover props.
+     */
+    collaborationPopoverProps: Omit<CollaborationPopoverProps, 'anchor' | 'userInfo'>;
+    /**
+     * Function to get the avatar url for the user.
+     */
+    getAvatarUrl?: (id: string) => string;
+    /**
+     * Function to fetch the collaborator state for the user.
+     */
+    fetchCollaboratorState?: (user: UserContactType) => Promise<boolean>;
+    /**
+     * Lazily resolves a user's email by ID when the mention doesn't carry one.
+     * Called during mention click, before the popover opens.
+     */
+    fetchEmail?: (userId: string) => Promise<string>;
+}
+export declare const ThreadedAnnotations: ({ messageEditorOptions, messagesViewOptions, onEditorOpen, onEditorClose, onAnnotationsClose, isReplyAllowed, collaborationPopoverProps, getAvatarUrl, fetchCollaboratorState, fetchEmail, }: ThreadedAnnotationsProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/lib/utils/getErrorMessage.d.ts

@@ -0,0 +1 @@
+export declare const getErrorMessage: (error: unknown) => string;

package/dist/types/lib/v2/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Prop spread onto portaled elements (popovers, menus, listboxes) that belong
+ * to the threaded-annotations component tree. Used by the click-outside handler
+ * to distinguish "our" portals from unrelated ones on the page.
+ */
+export declare const THREADED_ANNOTATIONS_PORTAL: {
+    readonly 'data-threaded-annotations-portal': true;
+};

package/dist/types/lib/v2/messages.d.ts

@@ -0,0 +1,8 @@
+declare const messages: {
+    threadedAnnotationsAriaLabel: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+};
+export default messages;

package/dist/types/lib/v2/stories/shared.d.ts

@@ -0,0 +1,18 @@
+import { ThreadedAnnotationsProps } from '../threaded-annotations';
+import { AnnotationBadgeTargetType } from '../types/annotation-badge-types';
+import { TextMessageType } from '../types';
+export declare const defaultUserSelectorProps: Omit<import('@box/user-selector').HeadlessUserSelectorProps, "value" | "open" | "rootElement" | "onSelectedUserChange" | "inputElementRef">;
+export declare const DefaultThreadedAnnotations: (props: ThreadedAnnotationsProps) => import("react/jsx-runtime").JSX.Element;
+interface InteractiveModuleBaseProps {
+    initialMessages?: TextMessageType[];
+    isReplyDisabled?: boolean;
+}
+type InteractiveModuleProps = (InteractiveModuleBaseProps & {
+    isAnnotations: true;
+}) | (InteractiveModuleBaseProps & {
+    isAnnotations?: false;
+    annotationTarget?: AnnotationBadgeTargetType;
+    onAnnotationBadgeClick?: (id: string) => void;
+});
+export declare const InteractiveModule: (props: InteractiveModuleProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/lib/v2/test-utils/button-utils.d.ts

@@ -0,0 +1,15 @@
+import { BoundFunctions, Queries } from '@testing-library/dom';
+import { UserEvent } from '@testing-library/user-event';
+type ButtonQueryOptions = {
+    timeout?: number;
+    enabled?: boolean;
+};
+type QueryCanvas = Readonly<BoundFunctions<Queries>>;
+export declare const waitForButtonByName: (canvas: QueryCanvas, name: string | RegExp, options?: ButtonQueryOptions) => Promise<HTMLElement>;
+export declare const waitForButtonToDisappear: (canvas: QueryCanvas, name: string | RegExp) => Promise<void>;
+export declare const clickButtonByName: (user: Readonly<UserEvent>, canvas: QueryCanvas, name: string | RegExp) => Promise<void>;
+export declare const waitForMenuItemByName: (canvas: QueryCanvas, name: string | RegExp, options?: {
+    timeout?: number;
+}) => Promise<HTMLElement>;
+export declare const clickMenuItemByName: (user: Readonly<UserEvent>, canvas: QueryCanvas, name: string | RegExp) => Promise<void>;
+export {};

package/dist/types/lib/v2/test-utils/default-user-selector-props.d.ts

@@ -0,0 +1,2 @@
+import { HeadlessUserSelectorProps } from '@box/user-selector';
+export declare const createDefaultUserSelectorProps: (userSelectorWidthClassName: string) => Omit<HeadlessUserSelectorProps, "inputElementRef" | "onSelectedUserChange" | "open" | "rootElement" | "value">;

package/dist/types/lib/v2/test-utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './button-utils';
+export * from './default-user-selector-props';
+export * from './interaction-utils';
+export * from './test-selectors';
+export * from './text-utils';
+export * from './verify-mention-elements';
+export * from './mocks';

package/dist/types/lib/v2/test-utils/interaction-utils.d.ts

@@ -0,0 +1,9 @@
+import { within, userEvent } from 'storybook/test';
+export declare const hoverOverElement: (user: ReturnType<typeof userEvent.setup>, element: HTMLElement) => Promise<void>;
+export declare const typeInContentEditable: (canvasElement: HTMLElement, user: ReturnType<typeof userEvent.setup>, text: string, editable?: string) => Promise<void>;
+export declare const keyboardInContentEditable: (canvasElement: HTMLElement, user: ReturnType<typeof userEvent.setup>, keys: string, editable?: string) => Promise<void>;
+export declare const pasteInContentEditable: (canvasElement: HTMLElement, user: ReturnType<typeof userEvent.setup>, text: string, editable?: string) => Promise<void>;
+export declare const openMoreOptionsMenu: (user: ReturnType<typeof userEvent.setup>, canvas: ReturnType<typeof within>, authorName: string) => Promise<void>;
+export declare const clickReplyOnMessage: (user: ReturnType<typeof userEvent.setup>, canvas: ReturnType<typeof within>, authorName: string) => Promise<void>;
+export declare const clickThreadBackground: (canvas: ReturnType<typeof within>) => void;
+export declare const selectUserByEmail: (user: ReturnType<typeof userEvent.setup>, identifier: string) => Promise<void>;

package/dist/types/lib/v2/test-utils/mocks/index.d.ts

@@ -0,0 +1,6 @@
+export * from './mock-callbacks';
+export * from './mock-collaboration-props';
+export * from './mock-messages';
+export * from './mock-messages-long-strings';
+export * from './mock-users';
+export * from './mock-utilities';

package/dist/types/lib/v2/test-utils/mocks/mock-callbacks.d.ts

@@ -0,0 +1,8 @@
+import { JSONContent } from '@tiptap/core';
+import { TextMessageType } from '../../types';
+export declare const MOCK_CALLBACKS: {
+    onPost: (content: JSONContent | null) => Promise<TextMessageType>;
+    onPostWithError: () => Promise<never>;
+    onSave: (content: JSONContent | null) => Promise<TextMessageType>;
+    onSaveWithError: () => Promise<never>;
+};

package/dist/types/lib/v2/test-utils/mocks/mock-collaboration-props.d.ts

@@ -0,0 +1,13 @@
+import { CollaborationPopoverType } from '@box/collaboration-popover';
+/**
+ * Creates mock collaboration popover props for use in story files.
+ * This centralizes the mock props to avoid code duplication.
+ */
+export declare const createMockCollaborationPopoverProps: () => {
+    onSubmit: () => Promise<void>;
+    onUserClick: import('storybook/test').Mock<(...args: any[]) => any>;
+    onClose: import('storybook/test').Mock<(...args: any[]) => any>;
+    onInviteTypeChange: import('storybook/test').Mock<(...args: any[]) => any>;
+    loading: boolean;
+    type: CollaborationPopoverType;
+};

package/dist/types/lib/v2/test-utils/mocks/mock-messages-long-strings.d.ts

@@ -0,0 +1,5 @@
+import { TextMessageType } from '../../types';
+import { DocumentNode } from '../../types/document-node-types';
+export declare const generateLongAlphabetString: (length: number) => string;
+export declare const createLongStringMessage: (stringLength: number) => DocumentNode;
+export declare const createLongStringAnnotationMessage: (id: string, messageLength: number, nameLength: number, userId: number) => TextMessageType;

package/dist/types/lib/v2/test-utils/mocks/mock-messages.d.ts

@@ -0,0 +1,10 @@
+import { Permissions, TextMessageType } from '../../types';
+import { DocumentNode } from '../../types/document-node-types';
+import { MOCK_USERS } from './mock-users';
+export declare const MOCK_MESSAGE_CONTENT: DocumentNode[];
+export declare const MOCK_ANNOTATIONS_MESSAGE_CONTENT: DocumentNode;
+export declare const DEFAULT_PERMISSIONS: Permissions;
+export declare const DEFAULT_ROOT_PERMISSIONS: Permissions;
+export declare const createMockAnnotationMessage: (id: string, messageContent: DocumentNode, author: (typeof MOCK_USERS)[keyof typeof MOCK_USERS], permissions?: Permissions) => TextMessageType;
+export declare const MOCK_ANNOTATION_MESSAGES: TextMessageType[];
+export declare const MOCK_SINGLE_ANNOTATION_MESSAGE: TextMessageType;

package/dist/types/lib/v2/test-utils/mocks/mock-users.d.ts

@@ -0,0 +1,55 @@
+import { UserContactType } from '@box/user-selector';
+export declare const MOCK_USERS: {
+    readonly LIAM_FOSTER: {
+        readonly avatarUrl: "/img/avatar.svg";
+        readonly email: "liam.foster@example.com";
+        readonly id: 1;
+        readonly name: "Liam Foster";
+        readonly value: "Liam Foster";
+        readonly isExternalUser: false;
+    };
+    readonly SARAH_CHEN: {
+        readonly email: "sarah.chen@example.com";
+        readonly id: 2;
+        readonly name: "Sarah Chen";
+        readonly value: "Sarah Chen";
+        readonly isExternalUser: true;
+    };
+    readonly ALEX_RODRIGUEZ: {
+        readonly email: "alex.rodriguez@example.com";
+        readonly id: 3;
+        readonly name: "Alex Rodriguez";
+        readonly value: "Alex Rodriguez";
+        readonly isExternalUser: false;
+    };
+    readonly EMMA_WILSON: {
+        readonly avatarUrl: "/img/avatar.svg";
+        readonly email: "emma.wilson@external.com";
+        readonly id: 4;
+        readonly name: "Emma Wilson";
+        readonly value: "Emma Wilson";
+        readonly isExternalUser: true;
+    };
+    readonly DAVID_THOMPSON: {
+        readonly email: "david.thompson@example.com";
+        readonly id: 12312312;
+        readonly name: "David Thompson";
+        readonly value: "David Thompson";
+        readonly isExternalUser: false;
+    };
+    readonly TEST_USER: {
+        readonly id: 1213123;
+        readonly name: "Test User";
+        readonly email: "test@box.com";
+        readonly isExternalUser: false;
+        readonly value: "Test User";
+    };
+    readonly CURRENT_USER: {
+        readonly email: "you@example.com";
+        readonly id: 999;
+        readonly name: "Test User";
+        readonly value: "Test User";
+        readonly isExternalUser: false;
+    };
+};
+export declare const MOCK_USER_SELECTOR_USERS: UserContactType[];

package/dist/types/lib/v2/test-utils/mocks/mock-utilities.d.ts

@@ -0,0 +1,6 @@
+import { FetchedAvatarUrls, UserContactType } from '@box/user-selector';
+import { JSONContent } from '@tiptap/core';
+import { DocumentNode } from '../../types';
+export declare const createDocumentNode: (content: JSONContent | null) => DocumentNode;
+export declare const createMockFetchUsers: (users?: UserContactType[]) => (query: string) => Promise<UserContactType[]>;
+export declare const createMockFetchAvatarUrls: () => () => Promise<FetchedAvatarUrls>;

package/dist/types/lib/v2/test-utils/test-selectors.d.ts

@@ -0,0 +1,12 @@
+export declare const TEST_SELECTORS: {
+    CANCEL_BUTTON: string;
+    POST_BUTTON: string;
+    SAVE_BUTTON: string;
+    REPLY_BUTTON: string;
+    MORE_OPTIONS_BUTTON: string;
+    DELETE_BUTTON: string;
+    DELETE_MENU_ITEM: string;
+    EDIT_MENU_ITEM: string;
+    RESOLVE_MENU_ITEM: string;
+    UNRESOLVE_MENU_ITEM: string;
+};

package/dist/types/lib/v2/test-utils/text-utils.d.ts

@@ -0,0 +1,3 @@
+import { within } from 'storybook/test';
+export declare const waitForTextToAppear: (canvas: ReturnType<typeof within>, text: string, exact?: boolean, timeout?: number) => Promise<any>;
+export declare const waitForTextToDisappear: (canvas: ReturnType<typeof within>, text: string) => Promise<void>;

package/dist/types/lib/v2/test-utils/verify-mention-elements.d.ts

@@ -0,0 +1,2 @@
+import { userEvent, within } from 'storybook/test';
+export declare const verifyMentionElements: (user: ReturnType<typeof userEvent.setup>, canvas: ReturnType<typeof within>, mentionNames: string[]) => Promise<void>;

package/dist/types/lib/v2/threaded-annotations-context.d.ts

@@ -0,0 +1,47 @@
+import { ReactNode } from 'react';
+import { TextMessageAuthorType } from './types/message-types';
+/**
+ * Explicit view states for the threaded annotations panel.
+ * Replaces the ambiguous `isExpanded` boolean with named states
+ * so impossible combinations (e.g. editor open while replies disabled)
+ * are unrepresentable.
+ */
+export declare enum ThreadViewState {
+    /** Default — root + last reply visible, no editor. */
+    Collapsed = "collapsed",
+    /** All replies visible, editor hidden (resolved / reply-disabled threads). */
+    RepliesOnly = "repliesOnly",
+    /** All replies visible + editor open. */
+    Composing = "composing"
+}
+export type ThreadEvent = {
+    type: 'EXPAND';
+} | {
+    type: 'REPLY';
+    author: TextMessageAuthorType;
+} | {
+    type: 'COLLAPSE';
+} | {
+    type: 'CLEAR_MENTION';
+};
+export interface ThreadedAnnotationsContextValue {
+    viewState: ThreadViewState;
+    replyMention: TextMessageAuthorType | null;
+    /** Whether the component is rendered in annotation mode (scrollable, fixed-height) vs comments mode. */
+    isAnnotations: boolean;
+    /** When true, globally disables replies — hides reply buttons and blocks editor opening on click. */
+    isReplyDisabled: boolean;
+    dispatch: (event: ThreadEvent) => void;
+}
+export interface ThreadedAnnotationsProviderProps {
+    children: ReactNode;
+    defaultExpanded?: boolean;
+    /** When true, globally disables replies — hides reply buttons and blocks editor opening on click. */
+    isReplyDisabled?: boolean;
+    /** When true, forces the panel to the Collapsed state. */
+    collapsed?: boolean;
+    /** Whether the component is rendered in annotation mode (scrollable, fixed-height) vs comments mode. */
+    isAnnotations?: boolean;
+}
+export declare const ThreadedAnnotationsProvider: ({ children, defaultExpanded, isReplyDisabled, collapsed, isAnnotations, }: ThreadedAnnotationsProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useThreadedAnnotationsContext: () => ThreadedAnnotationsContextValue;

package/dist/types/lib/v2/threaded-annotations.d.ts

@@ -0,0 +1,42 @@
+import { JSONContent } from '@tiptap/react';
+import { MessageEditorProps } from '../components/v2/message-editor/message-editor';
+import { AnnotationBadgeTargetType } from './types/annotation-badge-types';
+import { TextMessageType } from './types/message-types';
+type MessageActionCallback = (content: JSONContent | null) => Promise<TextMessageType | void> | TextMessageType | void;
+interface ThreadedAnnotationsBaseProps {
+    messages: TextMessageType[];
+    isResolved?: boolean;
+    /** Display name of the user who resolved the thread. */
+    resolvedBy?: string;
+    /** Unix timestamp (ms) when the thread was resolved. */
+    resolvedAt?: number;
+    onDelete: (id: string) => void;
+    onThreadDelete?: () => void;
+    onAvatarClick: (id: number) => void;
+    onEdit?: (id: string) => void;
+    onResolve?: (id: string) => void;
+    onUnresolve?: (id: string) => void;
+    onPost: MessageActionCallback;
+    onPostError?: (error: unknown) => string | undefined;
+    userSelectorProps: MessageEditorProps['userSelectorProps'];
+    /** When true, globally disables replies — hides reply buttons and blocks editor opening on click. */
+    isReplyDisabled?: boolean;
+    /** Called when the editor is opened or closed. Receives `true` when opened, `false` when closed. */
+    onEditorOpenChange?: (isOpen: boolean) => void;
+    /** When true, collapses the editor and replies panel. */
+    collapsed?: boolean;
+}
+interface AnnotationModeProps extends ThreadedAnnotationsBaseProps {
+    isAnnotations: true;
+    annotationTarget?: never;
+    onAnnotationBadgeClick?: never;
+}
+interface CommentModeProps extends ThreadedAnnotationsBaseProps {
+    isAnnotations?: false;
+    annotationTarget?: AnnotationBadgeTargetType;
+    /** Called when the annotation badge is clicked. Receives the root message id. */
+    onAnnotationBadgeClick?: (id: string) => void;
+}
+export type ThreadedAnnotationsProps = AnnotationModeProps | CommentModeProps;
+export declare const ThreadedAnnotations: (props: ThreadedAnnotationsProps) => import("react/jsx-runtime").JSX.Element;
+export {};