@poolse/react-native 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,672 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Uuid, Message, AttachmentUploadInput, Conversation, Membership, Attachment } from '@poolse/sdk';
+import * as react from 'react';
+import { ReactElement, ReactNode } from 'react';
+
+interface ConversationViewProps {
+    conversationId: Uuid;
+    emptyState?: ReactElement | string;
+    renderMessage?: (msg: Message, currentUserId: string | null) => ReactElement;
+    labelFor?: (externalId: string) => string;
+    avatarFor?: (externalId: string) => string | null;
+    reactions?: boolean;
+    mentions?: boolean;
+    attachments?: boolean;
+    actions?: boolean;
+    threads?: boolean;
+    quotations?: boolean;
+    readReceipts?: boolean;
+    maxBodyLength?: number;
+    /** Show sender labels in group chats. `auto` (default), `always`, `never`. */
+    senderLabels?: 'auto' | 'always' | 'never';
+    /** Show avatars to the left of other-side bubbles in group chats. Same semantics. */
+    avatars?: 'auto' | 'always' | 'never';
+    /** Fires when auto-mark-read commits — clear sidebar badges via this. */
+    onMarkedRead?: (conversationId: string) => void;
+}
+declare function ConversationView({ conversationId, emptyState, renderMessage, labelFor, avatarFor, reactions, mentions, attachments, actions, threads, quotations, readReceipts, maxBodyLength, senderLabels, avatars, onMarkedRead, }: ConversationViewProps): react_jsx_runtime.JSX.Element;
+
+type BubbleGroupPosition = 'first' | 'middle' | 'last' | 'standalone';
+interface MessageBubbleProps {
+    message: Message;
+    /** Used to decide left/right alignment, color, and read-receipt visibility. */
+    currentUserId: string | null;
+    /** `'sent'` → single tick, `'read'` → double tick (theme.colors.brand). */
+    readState?: 'sent' | 'read';
+    /** Label resolver keyed by `external_id` — falls back to the externalId itself. */
+    labelFor?: (externalId: string) => string;
+    /** Quoted-card tap handler. Typically used to scroll the list to the original message. */
+    onQuotedClick?: (quotedMessageId: Uuid) => void;
+    /** Position in a same-sender cluster — drives tail-corner rendering. */
+    groupPosition?: BubbleGroupPosition;
+    /** Truncate at this many chars and show a "Read more" toggle. Defaults to 0 (off). */
+    maxBodyLength?: number;
+    /** Show a colored sender label above other-side bubbles. Only meaningful in group chats. */
+    showSenderName?: boolean;
+    /** Slot for an actions trigger — typically a chevron rendered by `<MessageRow>`. */
+    actionsTrigger?: ReactNode;
+    /** Render in-bubble attachments (images, file cards). Defaults to true. */
+    showAttachments?: 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;
+
+interface MessageRowProps {
+    msg: Message;
+    meId: string | null;
+    reactions?: boolean;
+    attachments?: boolean;
+    actions?: boolean;
+    /** Pass false in ThreadView since nested threads aren't a thing in v1. */
+    threads?: boolean;
+    /** WhatsApp-style quote-reply. Defaults true on ConversationView. */
+    quotations?: boolean;
+    readState?: 'sent' | 'read';
+    editing?: boolean;
+    onStartEdit?: () => void;
+    onCancelEdit?: () => void;
+    onSaveEdit?: (body: string) => Promise<unknown> | void;
+    onDelete?: () => void;
+    onOpenThread?: () => void;
+    onQuote?: () => void;
+    labelFor?: (externalId: string) => string;
+    onQuotedClick?: (quotedMessageId: Uuid) => void;
+    groupPosition?: BubbleGroupPosition;
+    maxBodyLength?: number;
+    /** Show a colored sender label above other-side bubbles. */
+    showSenderName?: boolean;
+    /** Render an avatar to the LEFT of other-side bubbles. */
+    showAvatar?: boolean;
+    /** 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;
+
+interface MessageComposerProps {
+    /**
+     * Called when the user taps Send. Second arg carries
+     * `quoted_message_id` (when replying) and `attachment_ids`
+     * (resolved from the composer's upload queue). Awaited so the
+     * composer disables until the send round-trips.
+     */
+    onSend: (body: string, opts?: {
+        quoted_message_id?: Uuid;
+        attachment_ids?: Uuid[];
+    }) => Promise<unknown> | void;
+    /** Called on every keystroke. Hook to `useTyping().signalTyping`. */
+    onTyping?: () => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** Renders a quote chip above the input; cleared by the caller in `onSend`. */
+    replyingTo?: Message | null;
+    /** User tapped (x) on the quote chip. */
+    onCancelReply?: () => void;
+    /** Display label for the quoted sender, keyed by `external_id`. */
+    labelFor?: (externalId: string) => string;
+    /** Show the paperclip + queue strip. Defaults true. */
+    attachments?: boolean;
+    /** Tap on the paperclip — wire to `<AttachmentPicker>` from the same package. */
+    onAttachPress?: () => void;
+}
+/**
+ * Imperative handle for parents that want to add files to the
+ * composer's upload queue externally (drag/drop on a wrapper,
+ * deep-link, attachment shortcut).
+ */
+interface MessageComposerHandle {
+    /** Enqueue ready-to-upload inputs. The picker component is the usual caller; this is the escape hatch. */
+    addFiles: (inputs: AttachmentUploadInput[]) => void;
+    focus: () => void;
+    clear: () => void;
+}
+declare const MessageComposer: react.ForwardRefExoticComponent<MessageComposerProps & react.RefAttributes<MessageComposerHandle>>;
+
+interface MessageActionsProps {
+    visible: boolean;
+    onClose: () => void;
+    isSelf: boolean;
+    onReply?: () => void;
+    onReplyInThread?: () => void;
+    onQuote?: () => void;
+    onEdit?: () => void;
+    onDelete?: () => void;
+    onCopy?: () => void;
+    onReact?: () => void;
+}
+/**
+ * Long-press action menu — rendered as a modal bottom sheet (RN's
+ * native equivalent of the web hover popover).
+ */
+declare function MessageActions({ visible, onClose, isSelf, onReply, onReplyInThread, onQuote, onEdit, onDelete, onCopy, onReact, }: MessageActionsProps): react_jsx_runtime.JSX.Element;
+
+interface MessageListProps {
+    messages: Message[];
+    loading?: boolean;
+    hasMore?: boolean;
+    onLoadMore?: () => void;
+    renderItem: (msg: Message, index: number) => ReactElement;
+    /** Slot rendered above the latest message (typically the typing indicator). */
+    ListHeader?: ReactElement | null;
+    /** Slot rendered below the oldest message (rare — typically nothing). */
+    ListFooter?: ReactElement | null;
+    /** Custom empty state when there are no messages. */
+    emptyState?: ReactElement | string;
+}
+/**
+ * Inverted FlatList wrapper for chat history. Newest message at the
+ * bottom (visually), oldest at the top. Calls `onLoadMore` when the
+ * user scrolls near the top edge and `hasMore` is true.
+ *
+ * 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;
+
+interface TypingIndicatorProps {
+    /** Set of `external_id`s currently typing — what `useTyping` returns. */
+    typing: Set<string>;
+    /**
+     * Resolves an `external_id` to a display label. Defaults to the
+     * SDK's `userResolver` (and falls back to the external_id itself
+     * when the resolver isn't configured).
+     */
+    labelFor?: (externalId: string) => string;
+}
+/**
+ * Three animated dots + an inline "X is typing" label. Renders a
+ * zero-height row when nobody is typing so the list doesn't jump.
+ */
+declare function TypingIndicator({ typing, labelFor }: TypingIndicatorProps): react_jsx_runtime.JSX.Element;
+
+interface ThreadViewProps {
+    visible: boolean;
+    onClose: () => void;
+    conversationId: Uuid;
+    rootMessage: Message;
+    labelFor?: (externalId: string) => string;
+}
+/**
+ * Modal screen for thread replies. Mirrors the web `<ThreadView>` —
+ * root message preview at the top, oldest-first reply list, composer
+ * at the bottom.
+ */
+declare function ThreadView({ visible, onClose, conversationId, rootMessage, labelFor, }: ThreadViewProps): react_jsx_runtime.JSX.Element;
+
+interface UserNameProps {
+    /** The user's external_id. Pass null to render the fallback. */
+    externalId: string | null | undefined;
+    /** Optional fallback when the resolver returns nothing. Defaults to the externalId itself. */
+    fallback?: string;
+    /** Caller-supplied label override; if it returns a string, it wins. */
+    labelFor?: (externalId: string) => string;
+}
+/**
+ * Display name for a user, looked up via the SDK's `userResolver`
+ * with caller-overridable + fallback fallbacks. Renders a `<Text>`.
+ */
+declare function UserName({ externalId, fallback, labelFor }: UserNameProps): react_jsx_runtime.JSX.Element;
+/**
+ * Resolves a user's display name via the 3-tier chain:
+ * 1. `labelFor(externalId)` — caller-supplied override
+ * 2. SDK `userResolver` (memoized via `useUser`)
+ * 3. The externalId itself (so something always renders)
+ */
+declare function useDisplayName(externalId: string | null | undefined, labelFor?: (externalId: string) => string): string;
+
+interface ConversationListProps {
+    selectedId?: string | null;
+    onSelect?: (conv: Conversation) => void;
+    /** Optional override for each row's rendering. */
+    renderItem?: (conv: Conversation, selected: boolean) => ReactNode;
+    /** Custom empty state when there are no conversations. */
+    emptyState?: ReactNode | string;
+    /** Controlled-mode: skip `useConversations()` and render from these. */
+    conversations?: Conversation[];
+    loading?: boolean;
+    error?: Error | null;
+    /** Per-conversation unread counts rendered as a Pulse Coral pill. */
+    unreadCounts?: Record<Uuid, number>;
+}
+declare function ConversationList({ selectedId, onSelect, renderItem, emptyState, conversations: controlled, loading: controlledLoading, error: controlledError, unreadCounts, }: ConversationListProps): react_jsx_runtime.JSX.Element;
+
+interface MemberListProps {
+    conversationId: Uuid;
+    labelFor?: (externalId: string) => string;
+    avatarFor?: (externalId: string) => string | null;
+    onlineExternalIds?: Set<string>;
+    canRemove?: (m: Membership) => boolean;
+    renderItem?: (m: Membership) => ReactNode;
+    emptyState?: ReactNode | string;
+}
+declare function MemberList({ conversationId, labelFor, avatarFor, onlineExternalIds, canRemove, renderItem, emptyState, }: MemberListProps): react_jsx_runtime.JSX.Element;
+
+interface AttachmentPreviewProps {
+    attachment: Attachment;
+    /** Optional tap handler. For images defaults to opening the source URL. */
+    onPress?: () => void;
+    /** Render at this max width. Defaults to 280. */
+    maxWidth?: number;
+}
+declare function AttachmentPreview({ attachment, onPress, maxWidth }: AttachmentPreviewProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Horizontal strip of in-flight upload chips with cancel + remove
+ * affordances. Reads from `useAttachmentUpload()` so it auto-clears
+ * when the composer resets the queue post-send.
+ */
+declare function UploadQueueStrip(): react_jsx_runtime.JSX.Element | null;
+
+interface ReactionStripProps {
+    messageId: Uuid;
+    conversationId: Uuid;
+    meId: string | null;
+    /** Seed map from a known message (e.g. `useMessages`). */
+    initialReactions?: Record<string, Uuid[]>;
+}
+declare function ReactionStrip({ messageId, conversationId, meId, initialReactions, }: ReactionStripProps): react_jsx_runtime.JSX.Element | null;
+interface ReactionPickerProps {
+    visible: boolean;
+    onClose: () => void;
+    onPick: (emoji: string) => void;
+    /** Override the default 6-emoji set. */
+    emojis?: string[];
+}
+declare function ReactionPicker({ visible, onClose, onPick, emojis, }: ReactionPickerProps): react_jsx_runtime.JSX.Element;
+
+interface MentionInputProps extends Omit<MessageComposerProps, 'onSend'> {
+    conversationId: Uuid;
+    /** Same callback as MessageComposer.onSend, plus optional mention user_ids. */
+    onSend: (body: string, opts?: {
+        quoted_message_id?: Uuid;
+        attachment_ids?: Uuid[];
+        mentions?: Uuid[];
+    }) => Promise<unknown> | void;
+}
+/**
+ * Composer with an inline `@`-trigger that opens a modal sheet of
+ * conversation members. Selecting a member inserts their
+ * `external_id` into the text, and the wire `mentions` array (sent
+ * to the backend) carries the corresponding internal `user_id`s.
+ */
+declare function MentionInput({ conversationId, onSend, ...composerProps }: MentionInputProps): react_jsx_runtime.JSX.Element;
+
+interface AttachmentPickerProps {
+    visible: boolean;
+    onClose: () => void;
+    /**
+     * Optional adapter that produces an `AttachmentUploadInput` from a
+     * picked RN file. Default reads `uri`/`name`/`type`/`size` and wraps
+     * in a fetch-compatible `Blob`. Override to plug in custom storage
+     * or transcoding.
+     */
+    onPickInputs?: (kind: 'image' | 'document') => Promise<{
+        body: Blob | {
+            uri: string;
+            name: string;
+            type: string;
+        } | unknown;
+        contentType: string;
+        byteSize: number;
+        filename?: string;
+    }[]>;
+}
+/**
+ * Picker sheet wrapping `expo-image-picker` and `expo-document-picker`.
+ * Both are OPTIONAL peer dependencies — install only the ones you
+ * actually use. If a picker is mounted without its dep installed,
+ * the corresponding button is disabled with a tooltip explaining
+ * which install command to run.
+ *
+ * Default implementation dynamically `import()`s the Expo modules
+ * at mount; the caller can pass `onPickInputs` to skip Expo entirely.
+ */
+declare function AttachmentPicker({ visible, onClose, onPickInputs }: AttachmentPickerProps): react_jsx_runtime.JSX.Element;
+
+declare const ICONS: {
+    readonly attachment: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M20 11.6 11.4 20.2a5 5 0 0 1-7.1-7.1l8.7-8.7a3.3 3.3 0 0 1 4.7 4.7l-8.6 8.6a1.65 1.65 0 0 1-2.36-2.32l7.86-7.86\"/>";
+    };
+    readonly bell: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M6 9.2a6 6 0 0 1 12 0c0 4.8 1.4 6.3 1.9 6.8H4.1C4.6 15.5 6 14 6 9.2Z\"/><path d=\"M9.6 19.8a2.5 2.5 0 0 0 4.8 0\"/>";
+    };
+    readonly 'check-double': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M2.5 12.8 6.9 17 15.4 7.6\"/><path d=\"M11.4 16.4 12.3 17.2 21 7.6\"/>";
+    };
+    readonly check: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M4.5 12.6 9.4 17.4 19.5 6.6\"/>";
+    };
+    readonly 'chevron-down': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M5 9 12 16 19 9\"/>";
+    };
+    readonly 'chevron-right': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M9 5 16 12 9 19\"/>";
+    };
+    readonly close: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M6 6 18 18M18 6 6 18\"/>";
+    };
+    readonly code: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M9 7.5 4.5 12 9 16.5\"/><path d=\"M15 7.5 19.5 12 15 16.5\"/><path d=\"M13.2 5 10.8 19\"/>";
+    };
+    readonly compose: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M11.5 4H6a2.5 2.5 0 0 0-2.5 2.5V18A2.5 2.5 0 0 0 6 20.5h11.5A2.5 2.5 0 0 0 20 18v-5.5\"/><path d=\"M18.4 2.7a2.05 2.05 0 0 1 2.9 2.9L12 15l-4 1 1-4 9.4-9.3Z\"/>";
+    };
+    readonly copy: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<rect x=\"8.4\" y=\"8.4\" width=\"11.2\" height=\"11.2\" rx=\"2.3\"/><path d=\"M5.6 15.6H5A1.6 1.6 0 0 1 3.4 14V5A1.6 1.6 0 0 1 5 3.4h9A1.6 1.6 0 0 1 15.6 5v.6\"/>";
+    };
+    readonly download: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M12 3.2v11.6\"/><path d=\"M7.4 10.2 12 14.8 16.6 10.2\"/><path d=\"M4 19.6h16\"/>";
+    };
+    readonly edit: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M16.7 3.3a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4 12.7-12.7Z\"/>";
+    };
+    readonly emoji: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"12\" cy=\"12\" r=\"8.6\"/><circle cx=\"9\" cy=\"10\" r=\"1\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"15\" cy=\"10\" r=\"1\" fill=\"currentColor\" stroke=\"none\"/><path d=\"M8.4 14.2a4.6 4.6 0 0 0 7.2 0\"/>";
+    };
+    readonly heart: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M12 20.3 4.4 12.9a4.6 4.6 0 1 1 6.5-6.5l1.1 1.1 1.1-1.1a4.6 4.6 0 1 1 6.5 6.5L12 20.3Z\"/>";
+    };
+    readonly image: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<rect x=\"3.2\" y=\"4.2\" width=\"17.6\" height=\"15.6\" rx=\"2.6\"/><circle cx=\"8.6\" cy=\"9.4\" r=\"1.7\" fill=\"currentColor\" stroke=\"none\"/><path d=\"M20.8 15.8 16 11 6 19.8\"/>";
+    };
+    readonly info: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"12\" cy=\"12\" r=\"8.6\"/><path d=\"M12 11v5.2\"/><circle cx=\"12\" cy=\"7.7\" r=\"1\" fill=\"currentColor\" stroke=\"none\"/>";
+    };
+    readonly key: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"8\" cy=\"8\" r=\"4.4\"/><path d=\"M11.1 11.1 20 20\"/><path d=\"M16.6 16.6 18.6 14.6M14 14l2-2\"/>";
+    };
+    readonly link: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M10.2 13.8a3.5 3.5 0 0 0 5 0l3-3a3.5 3.5 0 0 0-5-5l-1.2 1.2\"/><path d=\"M13.8 10.2a3.5 3.5 0 0 0-5 0l-3 3a3.5 3.5 0 0 0 5 5l1.2-1.2\"/>";
+    };
+    readonly lock: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<rect x=\"4.6\" y=\"10.4\" width=\"14.8\" height=\"9.8\" rx=\"2.2\"/><path d=\"M8 10.4V7a4 4 0 0 1 8 0v3.4\"/>";
+    };
+    readonly message: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M20.5 11.4c0 4.5-3.9 8.1-8.5 8.1a9 9 0 0 1-3.7-.78L3.5 20.5l1.8-4.6A7.9 7.9 0 0 1 3.5 11.4C3.5 6.9 7.4 3.3 12 3.3s8.5 3.6 8.5 8.1Z\"/>";
+    };
+    readonly messages: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M14 9.2a4.7 4.7 0 0 1-4.7 4.7H6.8L3.5 16.4v-2.9A4.7 4.7 0 0 1 6.8 4.5h2.5A4.7 4.7 0 0 1 14 9.2Z\"/><path d=\"M9.4 13.6A4.7 4.7 0 0 0 13.6 16h3.6l3.3 2.5v-2.9a4.7 4.7 0 0 0-2.4-4.1\"/>";
+    };
+    readonly mic: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<rect x=\"9\" y=\"2.6\" width=\"6\" height=\"11.2\" rx=\"3\"/><path d=\"M5.6 11.2a6.4 6.4 0 0 0 12.8 0\"/><path d=\"M12 17.6v3.4\"/><path d=\"M8.6 21h6.8\"/>";
+    };
+    readonly 'more-h': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"5.4\" cy=\"12\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"12\" cy=\"12\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"18.6\" cy=\"12\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/>";
+    };
+    readonly 'more-v': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"12\" cy=\"5.4\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"12\" cy=\"12\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"12\" cy=\"18.6\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\"/>";
+    };
+    readonly pin: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M9 3.4h6v1.8l-1 5.6 3 3.2H7l3-3.2-1-5.6V3.4Z\"/><path d=\"M12 17v3.6\"/>";
+    };
+    readonly plus: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M12 5v14M5 12h14\"/>";
+    };
+    readonly presence: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"12\" cy=\"12\" r=\"9\" fill=\"currentColor\" opacity=\"0.18\" stroke=\"none\"/><circle cx=\"12\" cy=\"12\" r=\"5\" fill=\"currentColor\" stroke=\"none\"/>";
+    };
+    readonly pulse: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M3 13h4.6l2.2-4.6 3.4 9 2.2-4.4H21\"/>";
+    };
+    readonly reply: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M9 7 4 12l5 5\"/><path d=\"M4 12h9.5a6.5 6.5 0 0 1 6.5 6.5V20\"/>";
+    };
+    readonly search: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"11\" cy=\"11\" r=\"6.8\"/><path d=\"M20.8 20.8 16 16\"/>";
+    };
+    readonly 'send-fill': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path fill=\"currentColor\" stroke=\"none\" d=\"M21.7 2.3a1 1 0 0 1 .25 1L15.3 21.8a1 1 0 0 1-1.86.06L10.6 14.2 3 11.4a1 1 0 0 1 .06-1.9L20.7 2.05a1 1 0 0 1 1 .25Z\"/>";
+    };
+    readonly send: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M21.4 2.6 11 13\"/><path d=\"M21.4 2.6 14.8 21.5a.6.6 0 0 1-1.1.05L11 14l-7.5-2.7a.6.6 0 0 1 .05-1.1L21.4 2.6Z\"/>";
+    };
+    readonly settings: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"12\" cy=\"12\" r=\"3.1\"/><path d=\"M12 2.6V5M12 19v2.4M4.2 4.2 5.9 5.9M18.1 18.1l1.7 1.7M2.6 12H5M19 12h2.4M4.2 19.8 5.9 18.1M18.1 5.9l1.7-1.7\"/>";
+    };
+    readonly sliders: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M4 7h9M17 7h3\"/><circle cx=\"15\" cy=\"7\" r=\"2.1\"/><path d=\"M4 17h3M11 17h9\"/><circle cx=\"9\" cy=\"17\" r=\"2.1\"/>";
+    };
+    readonly 'thumbs-up': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M7 10.4V20H4.2V10.4Z\"/><path d=\"M7 10.4 11 3.2a2 2 0 0 1 1.9 2.2L12.4 9H18a2 2 0 0 1 2 2.4l-1.1 6A2 2 0 0 1 16.9 20H7\"/>";
+    };
+    readonly trash: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<path d=\"M4 7h16\"/><path d=\"M9.2 7V5.2A1.8 1.8 0 0 1 11 3.4h2a1.8 1.8 0 0 1 1.8 1.8V7\"/><path d=\"M6.2 7 7.2 19A1.9 1.9 0 0 0 9.1 20.7h5.8A1.9 1.9 0 0 0 16.8 19L17.8 7\"/><path d=\"M10.3 11v5M13.7 11v5\"/>";
+    };
+    readonly typing: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"6\" cy=\"12\" r=\"1.7\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"12\" cy=\"12\" r=\"1.7\" fill=\"currentColor\" stroke=\"none\"/><circle cx=\"18\" cy=\"12\" r=\"1.7\" fill=\"currentColor\" stroke=\"none\"/>";
+    };
+    readonly 'user-plus': {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"9\" cy=\"8\" r=\"3.8\"/><path d=\"M3 20a6 6 0 0 1 12 0\"/><path d=\"M18 8v6M15 11h6\"/>";
+    };
+    readonly user: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"12\" cy=\"8\" r=\"4\"/><path d=\"M4.6 20a7.4 7.4 0 0 1 14.8 0\"/>";
+    };
+    readonly users: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"9\" cy=\"8\" r=\"3.6\"/><path d=\"M2.6 20a6.4 6.4 0 0 1 12.8 0\"/><path d=\"M15.8 4.7a3.6 3.6 0 0 1 0 6.6\"/><path d=\"M17.6 20a6.4 6.4 0 0 0-3.1-5.5\"/>";
+    };
+    readonly webhook: {
+        readonly vb: "0 0 24 24";
+        readonly d: "<circle cx=\"6\" cy=\"6\" r=\"2.6\"/><circle cx=\"18\" cy=\"9\" r=\"2.6\"/><circle cx=\"9.5\" cy=\"18\" r=\"2.6\"/><path d=\"M7.9 7.9 12 12l3.7-1.5\"/><path d=\"M11.6 12.7 9.8 16\"/>";
+    };
+};
+type IconName = keyof typeof ICONS;
+
+interface PoolseIconProps {
+    /** Icon name — see {@link IconName} for the full list. */
+    name: IconName;
+    /** Width + height in pixels. Defaults to `20` (matches a body-line). */
+    size?: number;
+    /** Stroke color. Defaults to the theme's `ink` color. */
+    color?: string;
+    /** Accessibility label. Defaults to the icon name. */
+    label?: string | null;
+}
+declare function PoolseIcon({ name, size, color, label }: PoolseIconProps): react_jsx_runtime.JSX.Element | null;
+
+type PoolseLogoVariant = 'lockup' | 'mark' | 'wordmark' | 'mono';
+interface PoolseLogoProps {
+    variant?: PoolseLogoVariant;
+    /** Height in pixels — width is computed from the variant's aspect ratio. */
+    size?: number;
+    /** Mono variant accepts a color override; otherwise the theme drives fills. */
+    color?: string;
+    label?: string | null;
+}
+declare function PoolseLogo({ variant, size, color, label }: PoolseLogoProps): react_jsx_runtime.JSX.Element;
+
+interface AvatarProps {
+    /** URL to a profile image. Falls back to initials when omitted. */
+    src?: string | null;
+    /** Used for initials. */
+    name?: string | null;
+    /** Stable color seed (typically the user's external_id). */
+    seed?: string | null;
+    /** Show a green presence dot in the bottom-right corner. */
+    online?: boolean;
+    /** Size variant. `md` → 40px, `sm` → 28px, `lg` → 56px. */
+    size?: 'sm' | 'md' | 'lg';
+}
+declare function Avatar({ src, name, seed, online, size }: AvatarProps): react_jsx_runtime.JSX.Element;
+
+declare const primitives: {
+    PoolseIcon: typeof PoolseIcon;
+    PoolseLogo: typeof PoolseLogo;
+    Avatar: typeof Avatar;
+};
+
+type ThemeMode = 'light' | 'dark';
+interface ThemeColors {
+    brand: string;
+    brandStrong: string;
+    brandSoft: string;
+    onBrand: string;
+    paper: string;
+    surface: string;
+    surface2: string;
+    ink: string;
+    ink2: string;
+    ink3: string;
+    border: string;
+    presence: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    selfBubble: string;
+    selfBubbleText: string;
+    otherBubble: string;
+    otherBubbleText: string;
+    unreadPill: string;
+    unreadPillText: string;
+}
+interface ThemeType {
+    fontDisplay: string;
+    fontBody: string;
+    fontMono: string;
+    bodySize: number;
+    lineHeight: number;
+    weightRegular: '400';
+    weightMedium: '500';
+    weightSemibold: '600';
+    weightBold: '700';
+}
+interface ThemeRadii {
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    pill: number;
+    bubble: number;
+}
+interface ThemeSpacing {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+}
+interface ShadowTokens {
+    shadowColor: string;
+    shadowOpacity: number;
+    shadowOffset: {
+        width: number;
+        height: number;
+    };
+    shadowRadius: number;
+    elevation: number;
+}
+interface ThemeShadows {
+    sm: ShadowTokens;
+    md: ShadowTokens;
+    lg: ShadowTokens;
+}
+interface PoolseRNTheme {
+    mode: ThemeMode;
+    colors: ThemeColors;
+    type: ThemeType;
+    radii: ThemeRadii;
+    spacing: ThemeSpacing;
+    shadows: ThemeShadows;
+}
+type PoolseRNThemeOverrides = {
+    mode?: ThemeMode;
+    colors?: Partial<ThemeColors>;
+    type?: Partial<ThemeType>;
+    radii?: Partial<ThemeRadii>;
+    spacing?: Partial<ThemeSpacing>;
+    shadows?: Partial<ThemeShadows>;
+};
+
+interface PoolseThemeProps {
+    /**
+     * Light or dark base palette. Overrides are merged on top of the
+     * chosen base. Defaults to `light` if omitted.
+     */
+    mode?: ThemeMode;
+    /**
+     * Partial overrides — only the fields you set replace the defaults.
+     * Nested groups (`colors`, `type`, `radii`, `spacing`, `shadows`)
+     * deep-merge, so `{ colors: { brand: '#000' } }` keeps every other
+     * color from the base theme.
+     */
+    theme?: PoolseRNThemeOverrides;
+    children: ReactNode;
+}
+declare function PoolseTheme({ mode, theme, children }: PoolseThemeProps): react_jsx_runtime.JSX.Element;
+/**
+ * Read the active poolse theme. Falls back to `defaultLightTheme`
+ * if no `<PoolseTheme>` ancestor is mounted, so components render
+ * sensibly even without explicit wiring.
+ */
+declare function usePoolseTheme(): PoolseRNTheme;
+
+declare const defaultLightTheme: PoolseRNTheme;
+declare const defaultDarkTheme: PoolseRNTheme;
+
+/**
+ * Closes the SDK WebSocket cleanly when the app backgrounds and
+ * reopens it when the app comes back to the foreground. Designed
+ * to pair with push-notification delivery on the dev's backend —
+ * iOS / Android suspend sockets aggressively, so we don't fight
+ * the OS; we let the push wake the app and resync on resume.
+ *
+ * Mount once near the root of your app:
+ *
+ *     <PoolseProvider config={config}>
+ *       <AppShell />
+ *     </PoolseProvider>
+ *
+ *     function AppShell() {
+ *       useAppStateLifecycle();
+ *       return ...;
+ *     }
+ */
+declare function useAppStateLifecycle(): void;
+
+export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, EditableMessageBubble, type EditableMessageBubbleProps, type IconName, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListProps, MessageRow, type MessageRowProps, PoolseIcon, type PoolseIconProps, 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 };