@poolse/react-native 2.0.13 → 2.1.0

package/dist/index.d.cts

@@ -100,6 +100,8 @@ interface ConversationViewProps {
     threads?: boolean;
     quotations?: boolean;
     readReceipts?: boolean;
+    /** Render message bodies as Markdown (links, bold, code). Defaults true. */
+    markdown?: boolean;
     maxBodyLength?: number;
     /** Show sender labels in group chats. `auto` (default), `always`, `never`. */
     senderLabels?: 'auto' | 'always' | 'never';
@@ -131,7 +133,7 @@ interface ConversationViewProps {
      */
     keyboardOffset?: number;
 }
-declare function ConversationView({ conversationId, emptyState, renderMessage, labelFor, avatarFor, header, onHeaderMembersPress, onHeaderPress, reactions, mentions, attachments, actions, threads, quotations, readReceipts, maxBodyLength, senderLabels, avatars, onMarkedRead, onSent, keyboardOffset, }: ConversationViewProps): react_jsx_runtime.JSX.Element;
+declare function ConversationView({ conversationId, emptyState, renderMessage, labelFor, avatarFor, header, onHeaderMembersPress, onHeaderPress, reactions, mentions, attachments, actions, threads, quotations, readReceipts, markdown, maxBodyLength, senderLabels, avatars, onMarkedRead, onSent, keyboardOffset, }: ConversationViewProps): react_jsx_runtime.JSX.Element;
 
 interface ChatHeaderProps {
     conversationId: Uuid;
@@ -222,16 +224,15 @@ interface MessageBubbleProps {
     actionsTrigger?: ReactNode;
     /** Render in-bubble attachments (images, file cards). Defaults to true. */
     showAttachments?: boolean;
+    /**
+     * Render the body as Markdown (bold, italic, code, lists, links).
+     * Links open via `Linking.openURL`. Requires
+     * `react-native-markdown-display` to be installed in the host app;
+     * without it we fall back to plain text. Defaults to true.
+     */
+    markdown?: boolean;
 }
-declare function MessageBubble({ message, currentUserId, readState, labelFor, onQuotedClick, groupPosition, maxBodyLength, showSenderName, actionsTrigger, showAttachments, }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
-
-interface EditableMessageBubbleProps {
-    message: Message;
-    currentUserId: string | null;
-    onCancel: () => void;
-    onSave: (body: string) => Promise<unknown> | void;
-}
-declare function EditableMessageBubble({ message, currentUserId, onCancel, onSave, }: EditableMessageBubbleProps): react_jsx_runtime.JSX.Element;
+declare function MessageBubble({ message, currentUserId, readState, labelFor, onQuotedClick, groupPosition, maxBodyLength, showSenderName, actionsTrigger, showAttachments, markdown, }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
 
 interface MessageRowProps {
     msg: Message;
@@ -243,11 +244,23 @@ interface MessageRowProps {
     threads?: boolean;
     /** WhatsApp-style quote-reply. Defaults true on ConversationView. */
     quotations?: boolean;
+    /** Forwarded to `<MessageBubble markdown>`. Defaults true. */
+    markdown?: boolean;
     readState?: 'sent' | 'read';
-    editing?: boolean;
+    /**
+     * Whether this row's message is the one currently being edited.
+     * Editing happens in the composer (see MessageComposer's
+     * `editingMessage` prop); this flag is only used to elevate the
+     * row above the dim backdrop ConversationView renders during
+     * edit mode.
+     */
+    isEditing?: boolean;
+    /**
+     * Long-press → "Edit". Omitted entirely (no Edit option in the
+     * menu) when the parent has decided this message isn't editable
+     * (someone read it, it's deleted, it isn't yours).
+     */
     onStartEdit?: () => void;
-    onCancelEdit?: () => void;
-    onSaveEdit?: (body: string) => Promise<unknown> | void;
     onDelete?: () => void;
     onOpenThread?: () => void;
     onQuote?: () => void;
@@ -262,7 +275,7 @@ interface MessageRowProps {
     /** Avatar resolver — same signature as `<MemberList avatarFor>`. */
     avatarFor?: (externalId: string) => string | null;
 }
-declare function MessageRow({ msg, meId, reactions, attachments, actions, threads, quotations, readState, editing, onStartEdit, onCancelEdit, onSaveEdit, onDelete, onOpenThread, onQuote, labelFor, onQuotedClick, groupPosition, maxBodyLength, showSenderName, showAvatar, avatarFor, }: MessageRowProps): react_jsx_runtime.JSX.Element;
+declare function MessageRow({ msg, meId, reactions, attachments, actions, threads, quotations, markdown, readState, isEditing, onStartEdit, onDelete, onOpenThread, onQuote, labelFor, onQuotedClick, groupPosition, maxBodyLength, showSenderName, showAvatar, avatarFor, }: MessageRowProps): react_jsx_runtime.JSX.Element;
 
 interface MessageComposerProps {
     /**
@@ -298,6 +311,16 @@ interface MessageComposerProps {
      * ignored.
      */
     keyboardOffset?: number;
+    /**
+     * When set, the composer enters edit mode: prefills the input with
+     * the message body and renders an "Editing message" chip above
+     * (mirrors `replyingTo`). Tapping Send calls `onSaveEdit(body)`
+     * instead of `onSend`; `onCancelEdit` clears the chip and restores
+     * the previous draft. Pass `null` (or omit) when not editing.
+     */
+    editingMessage?: Message | null;
+    onCancelEdit?: () => void;
+    onSaveEdit?: (body: string) => Promise<unknown> | void;
 }
 /**
  * Imperative handle for parents that want to add files to the
@@ -338,8 +361,27 @@ interface MessageActionsProps {
  */
 declare function MessageActions({ visible, onClose, isSelf, emojis, onPickReaction, onReply, onReplyInThread, onQuote, onEdit, onDelete, onCopy, }: MessageActionsProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Either a real message or a day-separator row. ConversationView
+ * builds the list of items (interleaving separators where the day
+ * changes) and hands it to MessageList; MessageList just renders.
+ */
+type MessageListItem = {
+    kind: 'msg';
+    msg: Message;
+} | {
+    kind: 'separator';
+    id: string;
+    node: ReactElement;
+};
 interface MessageListProps {
     messages: Message[];
+    /**
+     * Optional pre-built item list (with day separators interleaved).
+     * When omitted, a list with `{ kind: 'msg' }` items is derived
+     * from `messages` and rendered without separators.
+     */
+    items?: MessageListItem[];
     loading?: boolean;
     hasMore?: boolean;
     onLoadMore?: () => void;
@@ -350,6 +392,13 @@ interface MessageListProps {
     ListFooter?: ReactElement | null;
     /** Custom empty state when there are no messages. */
     emptyState?: ReactElement | string;
+    /**
+     * The current user's id. When provided, MessageList will show a
+     * "↓ N new messages" jump button at the bottom of the chat
+     * whenever new messages from OTHER users arrive while the user is
+     * scrolled away from the bottom. Tapping scrolls to the latest.
+     */
+    meId?: string | null;
 }
 /**
  * Inverted FlatList wrapper for chat history. Newest message at the
@@ -359,7 +408,18 @@ interface MessageListProps {
  * Pagination is owned by `useMessages` (hand it `messages` +
  * `hasMore` + `loadMore`); this component just renders + scrolls.
  */
-declare function MessageList({ messages, loading, hasMore, onLoadMore, renderItem, ListHeader, ListFooter, emptyState, }: MessageListProps): react_jsx_runtime.JSX.Element;
+declare function MessageList({ messages, items, loading, hasMore, onLoadMore, renderItem, ListHeader, ListFooter, emptyState, meId, }: MessageListProps): react_jsx_runtime.JSX.Element;
+
+interface DaySeparatorProps {
+    label: string;
+}
+/**
+ * Centered date pill rendered between messages whose `inserted_at`
+ * falls on a different calendar day from the previous message. Pair
+ * with `formatDayLabel` from `@poolse/react` to compute the label
+ * ("Today" / "Yesterday" / weekday / "26 May 2024").
+ */
+declare function DaySeparator({ label }: DaySeparatorProps): react_jsx_runtime.JSX.Element;
 
 interface TypingIndicatorProps {
     /** Set of `external_id`s currently typing — what `useTyping` returns. */
@@ -904,4 +964,4 @@ declare const defaultDarkTheme: PoolseRNTheme;
  */
 declare function useAppStateLifecycle(): void;
 
-export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, ChatHeader, type ChatHeaderProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, EditableMessageBubble, type EditableMessageBubbleProps, GroupDetailsSheet, type GroupDetailsSheetProps, type IconName, ImageMosaic, type ImageMosaicProps, type InboxUser, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListProps, MessageRow, type MessageRowProps, PoolseIcon, type PoolseIconProps, PoolseInbox, type PoolseInboxHandle, type PoolseInboxProps, PoolseLogo, type PoolseLogoProps, type PoolseLogoVariant, type PoolseRNTheme, type PoolseRNThemeOverrides, PoolseTheme, type PoolseThemeProps, primitives as Primitives, ReactionPicker, type ReactionPickerProps, ReactionStrip, type ReactionStripProps, type ThemeColors, type ThemeRadii, type ThemeShadows, type ThemeSpacing, type ThemeType, ThreadView, type ThreadViewProps, TypingIndicator, type TypingIndicatorProps, UploadQueueStrip, UserName, type UserNameProps, defaultDarkTheme, defaultLightTheme, useAppStateLifecycle, useDisplayName, usePoolseTheme };
+export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, ChatHeader, type ChatHeaderProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, DaySeparator, type DaySeparatorProps, GroupDetailsSheet, type GroupDetailsSheetProps, type IconName, ImageMosaic, type ImageMosaicProps, type InboxUser, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListItem, type MessageListProps, MessageRow, type MessageRowProps, PoolseIcon, type PoolseIconProps, PoolseInbox, type PoolseInboxHandle, type PoolseInboxProps, PoolseLogo, type PoolseLogoProps, type PoolseLogoVariant, type PoolseRNTheme, type PoolseRNThemeOverrides, PoolseTheme, type PoolseThemeProps, primitives as Primitives, ReactionPicker, type ReactionPickerProps, ReactionStrip, type ReactionStripProps, type ThemeColors, type ThemeRadii, type ThemeShadows, type ThemeSpacing, type ThemeType, ThreadView, type ThreadViewProps, TypingIndicator, type TypingIndicatorProps, UploadQueueStrip, UserName, type UserNameProps, defaultDarkTheme, defaultLightTheme, useAppStateLifecycle, useDisplayName, usePoolseTheme };

package/dist/index.d.ts

@@ -100,6 +100,8 @@ interface ConversationViewProps {
     threads?: boolean;
     quotations?: boolean;
     readReceipts?: boolean;
+    /** Render message bodies as Markdown (links, bold, code). Defaults true. */
+    markdown?: boolean;
     maxBodyLength?: number;
     /** Show sender labels in group chats. `auto` (default), `always`, `never`. */
     senderLabels?: 'auto' | 'always' | 'never';
@@ -131,7 +133,7 @@ interface ConversationViewProps {
      */
     keyboardOffset?: number;
 }
-declare function ConversationView({ conversationId, emptyState, renderMessage, labelFor, avatarFor, header, onHeaderMembersPress, onHeaderPress, reactions, mentions, attachments, actions, threads, quotations, readReceipts, maxBodyLength, senderLabels, avatars, onMarkedRead, onSent, keyboardOffset, }: ConversationViewProps): react_jsx_runtime.JSX.Element;
+declare function ConversationView({ conversationId, emptyState, renderMessage, labelFor, avatarFor, header, onHeaderMembersPress, onHeaderPress, reactions, mentions, attachments, actions, threads, quotations, readReceipts, markdown, maxBodyLength, senderLabels, avatars, onMarkedRead, onSent, keyboardOffset, }: ConversationViewProps): react_jsx_runtime.JSX.Element;
 
 interface ChatHeaderProps {
     conversationId: Uuid;
@@ -222,16 +224,15 @@ interface MessageBubbleProps {
     actionsTrigger?: ReactNode;
     /** Render in-bubble attachments (images, file cards). Defaults to true. */
     showAttachments?: boolean;
+    /**
+     * Render the body as Markdown (bold, italic, code, lists, links).
+     * Links open via `Linking.openURL`. Requires
+     * `react-native-markdown-display` to be installed in the host app;
+     * without it we fall back to plain text. Defaults to true.
+     */
+    markdown?: boolean;
 }
-declare function MessageBubble({ message, currentUserId, readState, labelFor, onQuotedClick, groupPosition, maxBodyLength, showSenderName, actionsTrigger, showAttachments, }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
-
-interface EditableMessageBubbleProps {
-    message: Message;
-    currentUserId: string | null;
-    onCancel: () => void;
-    onSave: (body: string) => Promise<unknown> | void;
-}
-declare function EditableMessageBubble({ message, currentUserId, onCancel, onSave, }: EditableMessageBubbleProps): react_jsx_runtime.JSX.Element;
+declare function MessageBubble({ message, currentUserId, readState, labelFor, onQuotedClick, groupPosition, maxBodyLength, showSenderName, actionsTrigger, showAttachments, markdown, }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
 
 interface MessageRowProps {
     msg: Message;
@@ -243,11 +244,23 @@ interface MessageRowProps {
     threads?: boolean;
     /** WhatsApp-style quote-reply. Defaults true on ConversationView. */
     quotations?: boolean;
+    /** Forwarded to `<MessageBubble markdown>`. Defaults true. */
+    markdown?: boolean;
     readState?: 'sent' | 'read';
-    editing?: boolean;
+    /**
+     * Whether this row's message is the one currently being edited.
+     * Editing happens in the composer (see MessageComposer's
+     * `editingMessage` prop); this flag is only used to elevate the
+     * row above the dim backdrop ConversationView renders during
+     * edit mode.
+     */
+    isEditing?: boolean;
+    /**
+     * Long-press → "Edit". Omitted entirely (no Edit option in the
+     * menu) when the parent has decided this message isn't editable
+     * (someone read it, it's deleted, it isn't yours).
+     */
     onStartEdit?: () => void;
-    onCancelEdit?: () => void;
-    onSaveEdit?: (body: string) => Promise<unknown> | void;
     onDelete?: () => void;
     onOpenThread?: () => void;
     onQuote?: () => void;
@@ -262,7 +275,7 @@ interface MessageRowProps {
     /** Avatar resolver — same signature as `<MemberList avatarFor>`. */
     avatarFor?: (externalId: string) => string | null;
 }
-declare function MessageRow({ msg, meId, reactions, attachments, actions, threads, quotations, readState, editing, onStartEdit, onCancelEdit, onSaveEdit, onDelete, onOpenThread, onQuote, labelFor, onQuotedClick, groupPosition, maxBodyLength, showSenderName, showAvatar, avatarFor, }: MessageRowProps): react_jsx_runtime.JSX.Element;
+declare function MessageRow({ msg, meId, reactions, attachments, actions, threads, quotations, markdown, readState, isEditing, onStartEdit, onDelete, onOpenThread, onQuote, labelFor, onQuotedClick, groupPosition, maxBodyLength, showSenderName, showAvatar, avatarFor, }: MessageRowProps): react_jsx_runtime.JSX.Element;
 
 interface MessageComposerProps {
     /**
@@ -298,6 +311,16 @@ interface MessageComposerProps {
      * ignored.
      */
     keyboardOffset?: number;
+    /**
+     * When set, the composer enters edit mode: prefills the input with
+     * the message body and renders an "Editing message" chip above
+     * (mirrors `replyingTo`). Tapping Send calls `onSaveEdit(body)`
+     * instead of `onSend`; `onCancelEdit` clears the chip and restores
+     * the previous draft. Pass `null` (or omit) when not editing.
+     */
+    editingMessage?: Message | null;
+    onCancelEdit?: () => void;
+    onSaveEdit?: (body: string) => Promise<unknown> | void;
 }
 /**
  * Imperative handle for parents that want to add files to the
@@ -338,8 +361,27 @@ interface MessageActionsProps {
  */
 declare function MessageActions({ visible, onClose, isSelf, emojis, onPickReaction, onReply, onReplyInThread, onQuote, onEdit, onDelete, onCopy, }: MessageActionsProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Either a real message or a day-separator row. ConversationView
+ * builds the list of items (interleaving separators where the day
+ * changes) and hands it to MessageList; MessageList just renders.
+ */
+type MessageListItem = {
+    kind: 'msg';
+    msg: Message;
+} | {
+    kind: 'separator';
+    id: string;
+    node: ReactElement;
+};
 interface MessageListProps {
     messages: Message[];
+    /**
+     * Optional pre-built item list (with day separators interleaved).
+     * When omitted, a list with `{ kind: 'msg' }` items is derived
+     * from `messages` and rendered without separators.
+     */
+    items?: MessageListItem[];
     loading?: boolean;
     hasMore?: boolean;
     onLoadMore?: () => void;
@@ -350,6 +392,13 @@ interface MessageListProps {
     ListFooter?: ReactElement | null;
     /** Custom empty state when there are no messages. */
     emptyState?: ReactElement | string;
+    /**
+     * The current user's id. When provided, MessageList will show a
+     * "↓ N new messages" jump button at the bottom of the chat
+     * whenever new messages from OTHER users arrive while the user is
+     * scrolled away from the bottom. Tapping scrolls to the latest.
+     */
+    meId?: string | null;
 }
 /**
  * Inverted FlatList wrapper for chat history. Newest message at the
@@ -359,7 +408,18 @@ interface MessageListProps {
  * Pagination is owned by `useMessages` (hand it `messages` +
  * `hasMore` + `loadMore`); this component just renders + scrolls.
  */
-declare function MessageList({ messages, loading, hasMore, onLoadMore, renderItem, ListHeader, ListFooter, emptyState, }: MessageListProps): react_jsx_runtime.JSX.Element;
+declare function MessageList({ messages, items, loading, hasMore, onLoadMore, renderItem, ListHeader, ListFooter, emptyState, meId, }: MessageListProps): react_jsx_runtime.JSX.Element;
+
+interface DaySeparatorProps {
+    label: string;
+}
+/**
+ * Centered date pill rendered between messages whose `inserted_at`
+ * falls on a different calendar day from the previous message. Pair
+ * with `formatDayLabel` from `@poolse/react` to compute the label
+ * ("Today" / "Yesterday" / weekday / "26 May 2024").
+ */
+declare function DaySeparator({ label }: DaySeparatorProps): react_jsx_runtime.JSX.Element;
 
 interface TypingIndicatorProps {
     /** Set of `external_id`s currently typing — what `useTyping` returns. */
@@ -904,4 +964,4 @@ declare const defaultDarkTheme: PoolseRNTheme;
  */
 declare function useAppStateLifecycle(): void;
 
-export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, ChatHeader, type ChatHeaderProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, EditableMessageBubble, type EditableMessageBubbleProps, GroupDetailsSheet, type GroupDetailsSheetProps, type IconName, ImageMosaic, type ImageMosaicProps, type InboxUser, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListProps, MessageRow, type MessageRowProps, PoolseIcon, type PoolseIconProps, PoolseInbox, type PoolseInboxHandle, type PoolseInboxProps, PoolseLogo, type PoolseLogoProps, type PoolseLogoVariant, type PoolseRNTheme, type PoolseRNThemeOverrides, PoolseTheme, type PoolseThemeProps, primitives as Primitives, ReactionPicker, type ReactionPickerProps, ReactionStrip, type ReactionStripProps, type ThemeColors, type ThemeRadii, type ThemeShadows, type ThemeSpacing, type ThemeType, ThreadView, type ThreadViewProps, TypingIndicator, type TypingIndicatorProps, UploadQueueStrip, UserName, type UserNameProps, defaultDarkTheme, defaultLightTheme, useAppStateLifecycle, useDisplayName, usePoolseTheme };
+export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, ChatHeader, type ChatHeaderProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, DaySeparator, type DaySeparatorProps, GroupDetailsSheet, type GroupDetailsSheetProps, type IconName, ImageMosaic, type ImageMosaicProps, type InboxUser, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListItem, type MessageListProps, MessageRow, type MessageRowProps, PoolseIcon, type PoolseIconProps, PoolseInbox, type PoolseInboxHandle, type PoolseInboxProps, PoolseLogo, type PoolseLogoProps, type PoolseLogoVariant, type PoolseRNTheme, type PoolseRNThemeOverrides, PoolseTheme, type PoolseThemeProps, primitives as Primitives, ReactionPicker, type ReactionPickerProps, ReactionStrip, type ReactionStripProps, type ThemeColors, type ThemeRadii, type ThemeShadows, type ThemeSpacing, type ThemeType, ThreadView, type ThreadViewProps, TypingIndicator, type TypingIndicatorProps, UploadQueueStrip, UserName, type UserNameProps, defaultDarkTheme, defaultLightTheme, useAppStateLifecycle, useDisplayName, usePoolseTheme };