@convokitapp/vue-ui 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Conversation as Conversation$1, InboxPage, MessageListOptions, Message, SendMessageInput, EditMessageInput, MarkConversationReadOptions, ConversationPrivateState, ClearConversationUnreadOptions, ClearUnreadResult, RealtimeConnectionHandlers, RealtimeSubscription, MessageEvent, MessageDeletedEvent, ReadEvent, TypingEvent, ReadPosition, InboxSummary, MessageMedia, ConvoKitClient, InboxEntry } from '@convokitapp/sdk';
+import { Conversation as Conversation$1, InboxPage, MessageListOptions, Message, SendMessageInput, EditMessageInput, ReplyPreview, MessageContextOptions, MessageContextPage, MarkConversationReadOptions, ConversationPrivateState, ClearConversationUnreadOptions, ClearUnreadResult, RealtimeConnectionHandlers, RealtimeSubscription, MessageEvent, MessageDeletedEvent, ReadEvent, TypingEvent, ReadPosition, InboxSummary, MessageMedia, ConvoKitClient, InboxEntry } from '@convokitapp/sdk';
 import * as vue from 'vue';
 import { CSSProperties, HTMLAttributes, Ref, VNodeChild, PropType, MaybeRefOrGetter, TextareaHTMLAttributes } from 'vue';
 
@@ -41,6 +41,21 @@ interface ConvoKitUiClient {
      * `deleteMessage` rejects.
      */
     deleteMessage?(messageId: string): Promise<void>;
+    /** Resolve the quoted parents of the rendered replies in one round trip (0.9.0). The room store calls this once
+     * per page load, reconcile and live-insert burst with the distinct `Message.replyToMessageId` values it cannot
+     * derive from the loaded window; the core SDK de-duplicates and chunks at 50 per request. An ID missing from a
+     * RESOLVED result is the only deletion signal (the store caches it as the terminal `'unavailable'`); a rejection
+     * says nothing about which IDs exist, so the store writes no entry for any of them. Optional: without it the
+     * store renders reply references with no quoted text.
+     */
+    getReplyPreviews?(conversationId: string, messageIds: string[]): Promise<ReplyPreview[]>;
+    /** One window of the room's history centred on `options.messageId`, or continued from a previous window's
+     * `olderCursor` / `newerCursor` (0.9.0); exactly one of the three, `limit` 1..100. Rows come back newest-first
+     * like `getMessages`, and both cursors are always present (null at that end of the history). An unknown or
+     * deleted `messageId` must reject with `code: 'MESSAGE_NOT_FOUND'`. Optional: without it the room store hides
+     * the jump affordance and `jumpToMessage` resolves false for rows outside the loaded window.
+     */
+    getMessageContext?(conversationId: string, options: MessageContextOptions): Promise<MessageContextPage>;
     /** Acknowledge through `options.throughMessageId` (the newest rendered row). Custom adapters must forward the
      * options unchanged (0.7 adds `privateStateVersion`, the version captured when the room opened; an adapter that
      * drops it acknowledges the position but never clears the caller's unread marker) and reject a missing target
@@ -74,6 +89,13 @@ interface ConvoKitUiClient {
     onTyping(conversationId: string, handler: (event: TypingEvent) => void, onError?: (error: Error) => void): RealtimeSubscription;
 }
 
+/** A quoted parent as the room store holds it (0.9.0): the resolved preview, or the terminal `'unavailable'`
+ * once a call that resolved did not return it (deleted, or never in this room). A missing map entry is the
+ * distinct third state, "not resolved yet".
+ */
+type ReplyPreviewEntry = ReplyPreview | 'unavailable';
+/** Whether the room renders the live tail (`live`) or a historical window a jump loaded (`jumped`, 0.9.0). */
+type ConvoKitWindowMode = 'live' | 'jumped';
 interface ConversationFilter {
     query?: string;
     archived?: boolean;
@@ -128,6 +150,26 @@ interface ConversationState {
      */
     canEditMessages: Readonly<Ref<boolean>>;
     canDeleteMessages: Readonly<Ref<boolean>>;
+    /** The message the composer is quoting (0.9.0), or null. Replying and editing are mutually exclusive. */
+    replyTarget: Readonly<Ref<Message | null>>;
+    /** Quoted parents by `Message.replyToMessageId` (0.9.0); a missing key means "not resolved yet". */
+    replyPreviews: Readonly<Ref<ReadonlyMap<string, ReplyPreviewEntry>>>;
+    /** The row the last jump landed on (0.9.0); cleared about two seconds later. */
+    highlightedMessageId: Readonly<Ref<string | null>>;
+    /** Set while a jump replaces the window and scrolls (0.9.0); the views suspend stick-to-bottom, the highlight
+     * clear and pagination while it is set.
+     */
+    jumpInFlight: Readonly<Ref<boolean>>;
+    /** `live` (the tail) or `jumped` (a window a jump loaded, 0.9.0). */
+    windowMode: Readonly<Ref<ConvoKitWindowMode>>;
+    /** Whether a jumped window has newer messages beyond it; always false in `live` mode (0.9.0). */
+    hasNewerMessages: Readonly<Ref<boolean>>;
+    isLoadingNewer: Readonly<Ref<boolean>>;
+    /** Whether the adapter implements `getMessageContext` / `getReplyPreviews` (0.9.0); either turns false for the
+     * store's life after the uncoded 404 a 0.8 backend answers, so the affordance disappears instead of failing.
+     */
+    canJumpToMessage: Readonly<Ref<boolean>>;
+    canResolveReplyPreviews: Readonly<Ref<boolean>>;
     readerIdsFor(message: Message): ReadonlySet<string>;
 }
 type ConvoKitUiDensity = 'comfortable' | 'compact';
@@ -170,6 +212,22 @@ interface MessageSlotProps {
      * `canDelete`.
      */
     remove?: () => Promise<boolean>;
+    /** Whether the default row would offer the reply action (0.9.0): the view has `onReplyToMessage`, the row is
+     * confirmed and the viewer's role (when known) is not `READ` — or `canReplyToMessage` says so. Unlike `canEdit`
+     * it does not require the row to be the viewer's own: any member may quote any row.
+     */
+    canReply: boolean;
+    /** Ask the view to quote this message (`onReplyToMessage`); present exactly while `canReply`. */
+    reply?: () => void;
+    /** The quoted parent of this row (0.9.0); present only while `message.replyToMessageId` is set. `'unavailable'`
+     * means the quoted message is gone; the key being absent from `replyPreviewByMessageId` leaves this undefined,
+     * which is "not resolved yet" — render the reference without quoted text, never the unavailable copy.
+     */
+    replyPreview?: ReplyPreviewEntry;
+    /** Bring the quoted parent into view (`onJumpToMessage`); present only while `message.replyToMessageId` is set
+     * and the view can jump.
+     */
+    jumpToReplyTarget?: () => void;
 }
 interface MediaSlotProps {
     media: MessageMedia;
@@ -188,6 +246,19 @@ interface ComposerSlotProps {
     editing?: Message;
     /** Leave edit mode and restore the unsent draft (0.8.0); present while `editing` is. */
     cancelEdit?: () => void;
+    /** The message being quoted (0.9.0); present while the view is replying and not editing. The field keeps the
+     * draft — replying never replaces it, unlike edit mode.
+     */
+    replying?: Message;
+    /** Drop the reply target (0.9.0); present while `replying` is. */
+    cancelReply?: () => void;
+}
+/** The payload of the `#jump-to-latest` slot (0.9.0): the control renders only while the view is jumped, so
+ * the slot is only ever called with a live return in hand.
+ */
+interface JumpToLatestSlotProps {
+    /** Drop the historical window and render the live tail again (the view's `onReturnToLatest`). */
+    returnToLatest: () => void | Promise<void>;
 }
 interface TypingSlotProps {
     userIds: ReadonlySet<string>;
@@ -272,7 +343,25 @@ interface ConversationController extends ConversationState {
      * unknown to the server). No optimistic removal. Rejects when the adapter lacks `deleteMessage`.
      */
     deleteMessage(messageId: string): Promise<boolean>;
-    /** Acknowledge through the newest rendered message now; no request is sent while nothing is rendered. */
+    /** Quote a rendered, confirmed message in the composer (0.9.0); a no-op for pending, tombstoned and unknown
+     * rows and for a `READ` role. Any member may quote any row, own or not. Leaves edit mode. Sends nothing.
+     */
+    startReply(messageId: string): void;
+    /** Drop the reply target without a request; the draft is untouched. */
+    cancelReply(): void;
+    /** Bring a message into view (0.9.0): a rendered row is only highlighted, otherwise the window is replaced by
+     * a context window centred on it (`windowMode` becomes `jumped`). Resolves true once the target is
+     * highlighted; false when the quoted message is gone (its preview becomes `'unavailable'`), when a send is in
+     * flight, or when the adapter cannot fetch a context window.
+     */
+    jumpToMessage(messageId: string): Promise<boolean>;
+    /** Page a jumped window towards the newest messages; a no-op while `live` or already at the end. */
+    loadNewerMessages(): Promise<void>;
+    /** Leave a jumped window and render the live tail again; resolves true once it is rendered. */
+    returnToLatest(): Promise<boolean>;
+    /** Acknowledge through the newest rendered message now; no request is sent while nothing is rendered, and a
+     * jumped window acknowledges nothing at all (0.9.0).
+     */
     markRead(): Promise<void>;
     /** Automatic acknowledgements pause while hidden and resume when the view becomes visible again. */
     setVisible(visible: boolean): void;
@@ -318,6 +407,35 @@ interface ConversationViewProps extends ConvoKitAppearanceProps {
     canEditMessage?: (message: Message) => boolean;
     /** Replaces the inline "Delete this message?" prompt (and confirms `remove()` from custom rows). */
     confirmDelete?: (message: Message) => boolean | Promise<boolean>;
+    /** The message being quoted (0.9.0), or null. The composer shows a cancellable strip and keeps the draft —
+     * replying never replaces it, unlike edit mode. Editing wins while both are set.
+     */
+    replyTarget?: Message | null;
+    /** Quote a message (0.9.0): set `replyTarget` in response. Without it rows offer no reply action. */
+    onReplyToMessage?: (message: Message) => void;
+    /** Drop the reply target (0.9.0): clear `replyTarget` in response. */
+    onCancelReply?: () => void;
+    /** Replaces the default reply eligibility (any confirmed row while the viewer's role is not `READ`, 0.9.0). */
+    canReplyToMessage?: (message: Message) => boolean;
+    /** Quoted parents by `Message.replyToMessageId` (0.9.0); a missing key renders the reference with no quoted
+     * text, `'unavailable'` the deleted-parent copy.
+     */
+    replyPreviewByMessageId?: ReadonlyMap<string, ReplyPreviewEntry>;
+    /** Bring a message into view (0.9.0). Without it quoted blocks are inert and no row is focusable. */
+    onJumpToMessage?: (messageId: string) => void;
+    /** The row a jump landed on (0.9.0); it is centred, focused and highlighted. */
+    highlightedMessageId?: string | null;
+    /** Set while a jump lands (0.9.0): the list is `aria-busy` and suspends stick-to-bottom and pagination. */
+    jumpInFlight?: boolean;
+    /** Whether newer messages exist past the window (0.9.0); only ever true in a jumped window. */
+    hasNewerMessages?: boolean;
+    isLoadingNewer?: boolean;
+    /** Load the page immediately newer than a jumped window (0.9.0); the newer-edge scroll trigger. */
+    onLoadNewer?: () => void | Promise<void>;
+    /** Leave a jumped window for the live tail (0.9.0). Present only while the window IS jumped: it is what
+     * renders the "Jump to latest" control.
+     */
+    onReturnToLatest?: () => void | Promise<void>;
     isInitialLoading?: boolean;
     isLoadingOlder?: boolean;
     isSending?: boolean;
@@ -425,6 +543,54 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
         readonly type: PropType<(message: Message) => boolean | Promise<boolean>>;
         readonly default: undefined;
     };
+    readonly replyTarget: {
+        readonly type: PropType<Message | null>;
+        readonly default: null;
+    };
+    readonly onReplyToMessage: {
+        readonly type: PropType<(message: Message) => void>;
+        readonly default: undefined;
+    };
+    readonly onCancelReply: {
+        readonly type: PropType<() => void>;
+        readonly default: undefined;
+    };
+    readonly canReplyToMessage: {
+        readonly type: PropType<(message: Message) => boolean>;
+        readonly default: undefined;
+    };
+    readonly replyPreviewByMessageId: {
+        readonly type: PropType<ReadonlyMap<string, ReplyPreviewEntry>>;
+        readonly default: undefined;
+    };
+    readonly onJumpToMessage: {
+        readonly type: PropType<(messageId: string) => void>;
+        readonly default: undefined;
+    };
+    readonly highlightedMessageId: {
+        readonly type: PropType<string | null>;
+        readonly default: null;
+    };
+    readonly jumpInFlight: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly hasNewerMessages: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly isLoadingNewer: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly onLoadNewer: {
+        readonly type: PropType<() => void | Promise<void>>;
+        readonly default: undefined;
+    };
+    readonly onReturnToLatest: {
+        readonly type: PropType<() => void | Promise<void>>;
+        readonly default: undefined;
+    };
     readonly isInitialLoading: {
         readonly type: BooleanConstructor;
         readonly default: false;
@@ -515,7 +681,7 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click" | "edit-message" | "delete-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit")[], "load-older" | "attachment-click" | "edit-message" | "delete-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "load-newer" | "attachment-click" | "edit-message" | "delete-message" | "reply-to-message" | "jump-to-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit" | "cancel-reply" | "return-to-latest")[], "load-older" | "load-newer" | "attachment-click" | "edit-message" | "delete-message" | "reply-to-message" | "jump-to-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit" | "cancel-reply" | "return-to-latest", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     readonly conversation: {
         readonly type: PropType<Conversation$1>;
         readonly required: true;
@@ -600,6 +766,54 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
         readonly type: PropType<(message: Message) => boolean | Promise<boolean>>;
         readonly default: undefined;
     };
+    readonly replyTarget: {
+        readonly type: PropType<Message | null>;
+        readonly default: null;
+    };
+    readonly onReplyToMessage: {
+        readonly type: PropType<(message: Message) => void>;
+        readonly default: undefined;
+    };
+    readonly onCancelReply: {
+        readonly type: PropType<() => void>;
+        readonly default: undefined;
+    };
+    readonly canReplyToMessage: {
+        readonly type: PropType<(message: Message) => boolean>;
+        readonly default: undefined;
+    };
+    readonly replyPreviewByMessageId: {
+        readonly type: PropType<ReadonlyMap<string, ReplyPreviewEntry>>;
+        readonly default: undefined;
+    };
+    readonly onJumpToMessage: {
+        readonly type: PropType<(messageId: string) => void>;
+        readonly default: undefined;
+    };
+    readonly highlightedMessageId: {
+        readonly type: PropType<string | null>;
+        readonly default: null;
+    };
+    readonly jumpInFlight: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly hasNewerMessages: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly isLoadingNewer: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly onLoadNewer: {
+        readonly type: PropType<() => void | Promise<void>>;
+        readonly default: undefined;
+    };
+    readonly onReturnToLatest: {
+        readonly type: PropType<() => void | Promise<void>>;
+        readonly default: undefined;
+    };
     readonly isInitialLoading: {
         readonly type: BooleanConstructor;
         readonly default: false;
@@ -690,9 +904,12 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>> & Readonly<{
     "onLoad-older"?: (...args: any[]) => any;
+    "onLoad-newer"?: (...args: any[]) => any;
     "onAttachment-click"?: (...args: any[]) => any;
     "onEdit-message"?: (...args: any[]) => any;
     "onDelete-message"?: (...args: any[]) => any;
+    "onReply-to-message"?: (...args: any[]) => any;
+    "onJump-to-message"?: (...args: any[]) => any;
     onBack?: (...args: any[]) => any;
     onRefresh?: (...args: any[]) => any;
     "onSend-message"?: (...args: any[]) => any;
@@ -701,6 +918,8 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     "onUpdate:modelValue"?: (...args: any[]) => any;
     "onSave-edit"?: (...args: any[]) => any;
     "onCancel-edit"?: (...args: any[]) => any;
+    "onCancel-reply"?: (...args: any[]) => any;
+    "onReturn-to-latest"?: (...args: any[]) => any;
 }>, {
     readonly typingUserIds: ReadonlySet<string>;
     readonly readAtByUserId: ReadonlyMap<string, Date>;
@@ -710,6 +929,11 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     readonly isSending: boolean;
     readonly hasOlderMessages: boolean;
     readonly editingMessage: Message | null;
+    readonly replyTarget: Message | null;
+    readonly highlightedMessageId: string | null;
+    readonly jumpInFlight: boolean;
+    readonly hasNewerMessages: boolean;
+    readonly isLoadingNewer: boolean;
     readonly readersResolver: (message: Message) => ReadonlySet<string>;
     readonly onLoadOlder: () => void | Promise<void>;
     readonly onAttachmentClick: (media: MessageMedia, message: Message) => void;
@@ -717,6 +941,11 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     readonly onDeleteMessage: (message: Message) => boolean | void | Promise<boolean | void>;
     readonly canEditMessage: (message: Message) => boolean;
     readonly confirmDelete: (message: Message) => boolean | Promise<boolean>;
+    readonly onReplyToMessage: (message: Message) => void;
+    readonly canReplyToMessage: (message: Message) => boolean;
+    readonly replyPreviewByMessageId: ReadonlyMap<string, ReplyPreviewEntry>;
+    readonly onJumpToMessage: (messageId: string) => void;
+    readonly onLoadNewer: () => void | Promise<void>;
     readonly paginationThreshold: number;
     readonly stickToBottom: boolean;
     readonly formatTime: (date: Date) => string;
@@ -731,6 +960,8 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     readonly onAddAttachment: () => void;
     readonly onSaveEdit: (message: Message, text: string) => boolean | void | Promise<boolean | void>;
     readonly onCancelEdit: () => void;
+    readonly onCancelReply: () => void;
+    readonly onReturnToLatest: () => void | Promise<void>;
     readonly displayNameForUser: (userId: string) => string | null | undefined;
     readonly reverseMessages: boolean;
     readonly composerPlaceholder: string;
@@ -740,7 +971,7 @@ declare const ConversationView: vue.DefineComponent<vue.ExtractPropTypes<{
     readonly defaultDraft: string;
     readonly onDraftChange: (value: string) => void;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
-interface ConversationProps extends Omit<ConversationViewProps, 'conversation' | 'messages' | 'currentUserId' | 'onSendMessage' | 'typingUserIds' | 'readAtByUserId' | 'readPositionByUserId' | 'onRefresh' | 'onLoadOlder' | 'onTypingChange' | 'isInitialLoading' | 'isLoadingOlder' | 'isSending' | 'hasOlderMessages' | 'error' | 'editingMessage' | 'onEditMessage' | 'onSaveEdit' | 'onCancelEdit' | 'onDeleteMessage'>, Omit<UseConversationOptions, 'client' | 'conversationId'> {
+interface ConversationProps extends Omit<ConversationViewProps, 'conversation' | 'messages' | 'currentUserId' | 'onSendMessage' | 'typingUserIds' | 'readAtByUserId' | 'readPositionByUserId' | 'onRefresh' | 'onLoadOlder' | 'onTypingChange' | 'isInitialLoading' | 'isLoadingOlder' | 'isSending' | 'hasOlderMessages' | 'error' | 'editingMessage' | 'onEditMessage' | 'onSaveEdit' | 'onCancelEdit' | 'onDeleteMessage' | 'replyTarget' | 'onReplyToMessage' | 'onCancelReply' | 'replyPreviewByMessageId' | 'onJumpToMessage' | 'highlightedMessageId' | 'jumpInFlight' | 'hasNewerMessages' | 'isLoadingNewer' | 'onLoadNewer' | 'onReturnToLatest'>, Omit<UseConversationOptions, 'client' | 'conversationId'> {
     client: ConvoKitUiClient;
     conversationId: string;
     onControllerChange?: (controller: ConversationController) => void;
@@ -783,6 +1014,22 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(message: Message) => boolean | void | Promise<boolean | void>>;
         default: undefined;
     };
+    replyTarget: {
+        type: PropType<Message | null>;
+        default: undefined;
+    };
+    onReplyToMessage: {
+        type: PropType<(message: Message) => void>;
+        default: undefined;
+    };
+    onCancelReply: {
+        type: PropType<() => void>;
+        default: undefined;
+    };
+    onJumpToMessage: {
+        type: PropType<(messageId: string) => void>;
+        default: undefined;
+    };
     client: {
         type: PropType<ConvoKitUiClient>;
         required: true;
@@ -863,6 +1110,38 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
         readonly type: PropType<(message: Message) => boolean | Promise<boolean>>;
         readonly default: undefined;
     };
+    canReplyToMessage: {
+        readonly type: PropType<(message: Message) => boolean>;
+        readonly default: undefined;
+    };
+    replyPreviewByMessageId: {
+        readonly type: PropType<ReadonlyMap<string, ReplyPreviewEntry>>;
+        readonly default: undefined;
+    };
+    highlightedMessageId: {
+        readonly type: PropType<string | null>;
+        readonly default: null;
+    };
+    jumpInFlight: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    hasNewerMessages: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    isLoadingNewer: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    onLoadNewer: {
+        readonly type: PropType<() => void | Promise<void>>;
+        readonly default: undefined;
+    };
+    onReturnToLatest: {
+        readonly type: PropType<() => void | Promise<void>>;
+        readonly default: undefined;
+    };
     isInitialLoading: {
         readonly type: BooleanConstructor;
         readonly default: false;
@@ -953,7 +1232,7 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click" | "edit-message" | "delete-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit" | "controller-change")[], "load-older" | "attachment-click" | "edit-message" | "delete-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit" | "controller-change", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "load-newer" | "attachment-click" | "edit-message" | "delete-message" | "reply-to-message" | "jump-to-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit" | "cancel-reply" | "return-to-latest" | "controller-change")[], "load-older" | "load-newer" | "attachment-click" | "edit-message" | "delete-message" | "reply-to-message" | "jump-to-message" | "send-message" | "typing-change" | "back" | "refresh" | "add-attachment" | "update:modelValue" | "save-edit" | "cancel-edit" | "cancel-reply" | "return-to-latest" | "controller-change", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     conversation: {
         type: PropType<Conversation$1>;
         default: undefined;
@@ -990,6 +1269,22 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(message: Message) => boolean | void | Promise<boolean | void>>;
         default: undefined;
     };
+    replyTarget: {
+        type: PropType<Message | null>;
+        default: undefined;
+    };
+    onReplyToMessage: {
+        type: PropType<(message: Message) => void>;
+        default: undefined;
+    };
+    onCancelReply: {
+        type: PropType<() => void>;
+        default: undefined;
+    };
+    onJumpToMessage: {
+        type: PropType<(messageId: string) => void>;
+        default: undefined;
+    };
     client: {
         type: PropType<ConvoKitUiClient>;
         required: true;
@@ -1070,6 +1365,38 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
         readonly type: PropType<(message: Message) => boolean | Promise<boolean>>;
         readonly default: undefined;
     };
+    canReplyToMessage: {
+        readonly type: PropType<(message: Message) => boolean>;
+        readonly default: undefined;
+    };
+    replyPreviewByMessageId: {
+        readonly type: PropType<ReadonlyMap<string, ReplyPreviewEntry>>;
+        readonly default: undefined;
+    };
+    highlightedMessageId: {
+        readonly type: PropType<string | null>;
+        readonly default: null;
+    };
+    jumpInFlight: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    hasNewerMessages: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    isLoadingNewer: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    onLoadNewer: {
+        readonly type: PropType<() => void | Promise<void>>;
+        readonly default: undefined;
+    };
+    onReturnToLatest: {
+        readonly type: PropType<() => void | Promise<void>>;
+        readonly default: undefined;
+    };
     isInitialLoading: {
         readonly type: BooleanConstructor;
         readonly default: false;
@@ -1160,9 +1487,12 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>> & Readonly<{
     "onLoad-older"?: (...args: any[]) => any;
+    "onLoad-newer"?: (...args: any[]) => any;
     "onAttachment-click"?: (...args: any[]) => any;
     "onEdit-message"?: (...args: any[]) => any;
     "onDelete-message"?: (...args: any[]) => any;
+    "onReply-to-message"?: (...args: any[]) => any;
+    "onJump-to-message"?: (...args: any[]) => any;
     onBack?: (...args: any[]) => any;
     onRefresh?: (...args: any[]) => any;
     "onSend-message"?: (...args: any[]) => any;
@@ -1171,6 +1501,8 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     "onUpdate:modelValue"?: (...args: any[]) => any;
     "onSave-edit"?: (...args: any[]) => any;
     "onCancel-edit"?: (...args: any[]) => any;
+    "onCancel-reply"?: (...args: any[]) => any;
+    "onReturn-to-latest"?: (...args: any[]) => any;
     "onController-change"?: (...args: any[]) => any;
 }>, {
     messages: readonly Message[];
@@ -1184,6 +1516,11 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     hasOlderMessages: boolean;
     currentUserId: string;
     editingMessage: Message | null;
+    replyTarget: Message | null;
+    highlightedMessageId: string | null;
+    jumpInFlight: boolean;
+    hasNewerMessages: boolean;
+    isLoadingNewer: boolean;
     readersResolver: (message: Message) => ReadonlySet<string>;
     onLoadOlder: () => void | Promise<void>;
     onAttachmentClick: (media: MessageMedia, message: Message) => void;
@@ -1191,6 +1528,11 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     onDeleteMessage: (message: Message) => boolean | void | Promise<boolean | void>;
     canEditMessage: (message: Message) => boolean;
     confirmDelete: (message: Message) => boolean | Promise<boolean>;
+    onReplyToMessage: (message: Message) => void;
+    canReplyToMessage: (message: Message) => boolean;
+    replyPreviewByMessageId: ReadonlyMap<string, ReplyPreviewEntry>;
+    onJumpToMessage: (messageId: string) => void;
+    onLoadNewer: () => void | Promise<void>;
     paginationThreshold: number;
     stickToBottom: boolean;
     formatTime: (date: Date) => string;
@@ -1206,6 +1548,8 @@ declare const Conversation: vue.DefineComponent<vue.ExtractPropTypes<{
     onAddAttachment: () => void;
     onSaveEdit: (message: Message, text: string) => boolean | void | Promise<boolean | void>;
     onCancelEdit: () => void;
+    onCancelReply: () => void;
+    onReturnToLatest: () => void | Promise<void>;
     displayNameForUser: (userId: string) => string | null | undefined;
     reverseMessages: boolean;
     composerPlaceholder: string;
@@ -1730,6 +2074,32 @@ interface MessageListViewProps extends ConvoKitAppearanceProps {
     canEditMessage?: (message: Message) => boolean;
     /** Replaces the row's inline "Delete this message?" prompt (and confirms `remove()` from custom rows). */
     confirmDelete?: (message: Message) => boolean | Promise<boolean>;
+    /** Quote a message (0.9.0). Without it no row offers a reply action and the markup is unchanged. */
+    onReplyToMessage?: (message: Message) => void;
+    /** Replaces the default reply eligibility (any confirmed row while the viewer's role is not `READ`, 0.9.0).
+     * Deliberately separate from `canEditMessage`: an edit-eligibility override must not suppress Reply on rows
+     * the viewer does not own.
+     */
+    canReplyToMessage?: (message: Message) => boolean;
+    /** Quoted parents by `Message.replyToMessageId` (0.9.0). A row whose id is missing from the map renders its
+     * reference with no quoted text ("not resolved yet"); `'unavailable'` renders the deleted-parent copy.
+     */
+    replyPreviewByMessageId?: ReadonlyMap<string, ReplyPreviewEntry>;
+    /** Bring a message into view (0.9.0). Without it quoted blocks are inert and no row is focusable. */
+    onJumpToMessage?: (messageId: string) => void;
+    /** The row a jump landed on (0.9.0): it is scrolled to the centre, focused and highlighted until the host
+     * clears the prop or the viewer scrolls.
+     */
+    highlightedMessageId?: string | null;
+    /** Set by the store while a jump lands (0.9.0): the list is `aria-busy`, stick-to-bottom, pagination and the
+     * highlight clear are suspended, and the attribute is omitted entirely while it is false.
+     */
+    jumpInFlight?: boolean;
+    /** Whether newer messages exist past the top of the window (0.9.0); only ever true in a jumped window. */
+    hasNewerMessages?: boolean;
+    isLoadingNewer?: boolean;
+    /** Load the page of messages immediately newer than the window (0.9.0); the newer-edge scroll trigger. */
+    onLoadNewer?: () => void | Promise<void>;
     scrollElement?: Ref<HTMLElement | null>;
     paginationThreshold?: number;
     reverse?: boolean;
@@ -1801,6 +2171,42 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(message: Message) => boolean | Promise<boolean>>;
         default: undefined;
     };
+    onReplyToMessage: {
+        type: PropType<(message: Message) => void>;
+        default: undefined;
+    };
+    canReplyToMessage: {
+        type: PropType<(message: Message) => boolean>;
+        default: undefined;
+    };
+    replyPreviewByMessageId: {
+        type: PropType<ReadonlyMap<string, ReplyPreviewEntry>>;
+        default: undefined;
+    };
+    onJumpToMessage: {
+        type: PropType<(messageId: string) => void>;
+        default: undefined;
+    };
+    highlightedMessageId: {
+        type: PropType<string | null>;
+        default: null;
+    };
+    jumpInFlight: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    hasNewerMessages: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    isLoadingNewer: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onLoadNewer: {
+        type: PropType<() => void | Promise<void>>;
+        default: undefined;
+    };
     scrollElement: {
         type: PropType<Ref<HTMLElement | null>>;
         default: undefined;
@@ -1843,7 +2249,7 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "attachment-click" | "edit-message" | "delete-message")[], "load-older" | "attachment-click" | "edit-message" | "delete-message", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("load-older" | "load-newer" | "attachment-click" | "edit-message" | "delete-message" | "reply-to-message" | "jump-to-message")[], "load-older" | "load-newer" | "attachment-click" | "edit-message" | "delete-message" | "reply-to-message" | "jump-to-message", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     conversation: {
         type: PropType<Conversation$1>;
         required: true;
@@ -1904,6 +2310,42 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(message: Message) => boolean | Promise<boolean>>;
         default: undefined;
     };
+    onReplyToMessage: {
+        type: PropType<(message: Message) => void>;
+        default: undefined;
+    };
+    canReplyToMessage: {
+        type: PropType<(message: Message) => boolean>;
+        default: undefined;
+    };
+    replyPreviewByMessageId: {
+        type: PropType<ReadonlyMap<string, ReplyPreviewEntry>>;
+        default: undefined;
+    };
+    onJumpToMessage: {
+        type: PropType<(messageId: string) => void>;
+        default: undefined;
+    };
+    highlightedMessageId: {
+        type: PropType<string | null>;
+        default: null;
+    };
+    jumpInFlight: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    hasNewerMessages: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    isLoadingNewer: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onLoadNewer: {
+        type: PropType<() => void | Promise<void>>;
+        default: undefined;
+    };
     scrollElement: {
         type: PropType<Ref<HTMLElement | null>>;
         default: undefined;
@@ -1946,15 +2388,22 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>> & Readonly<{
     "onLoad-older"?: (...args: any[]) => any;
+    "onLoad-newer"?: (...args: any[]) => any;
     "onAttachment-click"?: (...args: any[]) => any;
     "onEdit-message"?: (...args: any[]) => any;
     "onDelete-message"?: (...args: any[]) => any;
+    "onReply-to-message"?: (...args: any[]) => any;
+    "onJump-to-message"?: (...args: any[]) => any;
 }>, {
     reverse: boolean;
     readAtByUserId: ReadonlyMap<string, Date>;
     readPositionByUserId: ReadonlyMap<string, ReadPosition>;
     isLoadingOlder: boolean;
     hasOlderMessages: boolean;
+    highlightedMessageId: string | null;
+    jumpInFlight: boolean;
+    hasNewerMessages: boolean;
+    isLoadingNewer: boolean;
     readersResolver: (message: Message) => ReadonlySet<string>;
     onLoadOlder: () => void | Promise<void>;
     onAttachmentClick: (media: MessageMedia, message: Message) => void;
@@ -1962,6 +2411,11 @@ declare const MessageListView: vue.DefineComponent<vue.ExtractPropTypes<{
     onDeleteMessage: (message: Message) => boolean | void | Promise<boolean | void>;
     canEditMessage: (message: Message) => boolean;
     confirmDelete: (message: Message) => boolean | Promise<boolean>;
+    onReplyToMessage: (message: Message) => void;
+    canReplyToMessage: (message: Message) => boolean;
+    replyPreviewByMessageId: ReadonlyMap<string, ReplyPreviewEntry>;
+    onJumpToMessage: (messageId: string) => void;
+    onLoadNewer: () => void | Promise<void>;
     scrollElement: Ref<HTMLElement | null, HTMLElement | null>;
     paginationThreshold: number;
     stickToBottom: boolean;
@@ -1987,6 +2441,8 @@ interface ConvoKitTheme {
     outgoingText: string;
     /** Unread badge and dot background (0.6.0); the badge label uses `outgoingText`. Defaults to the primary color. */
     badge: string;
+    /** The fading tint on the row a jump landed on (0.9.0). Defaults to the primary color at low opacity. */
+    highlight: string;
     radius: string;
     avatarSize: string;
     fontFamily: string;
@@ -2027,4 +2483,4 @@ declare const ConvoKitThemeProvider: vue.DefineComponent<vue.ExtractPropTypes<{
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 declare function useConvoKitTheme(): Readonly<Ref<ConvoKitTheme>>;
 
-export { type BaseViewProps, type ComposerSlotProps, Conversation, type ConversationController, type ConversationFilter, type ConversationItemSlotProps, ConversationList, type ConversationListController, type ConversationListProps, type ConversationListState, ConversationListView, type ConversationListViewProps, type ConversationPageLoader, type ConversationPageRequest, type ConversationProps, type ConversationState, ConversationView, type ConversationViewProps, type ConvoKitAppearanceProps, ConvoKitAvatar, type ConvoKitTheme, ConvoKitThemeProvider, type ConvoKitUiClient, type ConvoKitUiDensity, type ConvoKitUiPart, type ErrorSlot, type ErrorSlotProps, type MediaSlotProps, MessageListView, type MessageListViewProps, type MessageSlotProps, type ReadReceiptSlotProps, type ScrollOptions, type StateSlot, type TypingSlotProps, type UseConversationListOptions, type UseConversationOptions, applyConversationFilter, createConvoKitUiClient, defaultConvoKitTheme, defaultReadersResolver, formatFileSize, isConvoKitPendingMessage, matchesConversation, mergeConversations, mergeInboxEntries, mergeMessages, readerIdsFor, useConversation, useConversationList, useConvoKitTheme };
+export { type BaseViewProps, type ComposerSlotProps, Conversation, type ConversationController, type ConversationFilter, type ConversationItemSlotProps, ConversationList, type ConversationListController, type ConversationListProps, type ConversationListState, ConversationListView, type ConversationListViewProps, type ConversationPageLoader, type ConversationPageRequest, type ConversationProps, type ConversationState, ConversationView, type ConversationViewProps, type ConvoKitAppearanceProps, ConvoKitAvatar, type ConvoKitTheme, ConvoKitThemeProvider, type ConvoKitUiClient, type ConvoKitUiDensity, type ConvoKitUiPart, type ConvoKitWindowMode, type ErrorSlot, type ErrorSlotProps, type JumpToLatestSlotProps, type MediaSlotProps, MessageListView, type MessageListViewProps, type MessageSlotProps, type ReadReceiptSlotProps, type ReplyPreviewEntry, type ScrollOptions, type StateSlot, type TypingSlotProps, type UseConversationListOptions, type UseConversationOptions, applyConversationFilter, createConvoKitUiClient, defaultConvoKitTheme, defaultReadersResolver, formatFileSize, isConvoKitPendingMessage, matchesConversation, mergeConversations, mergeInboxEntries, mergeMessages, readerIdsFor, useConversation, useConversationList, useConvoKitTheme };