@sesionario/blocks 1.5.0 → 1.7.0

package/dist/index.d.cts

@@ -95,6 +95,26 @@ declare function EmptyTitle({ className, ...props }: React.ComponentProps<"div">
 declare function EmptyDescription({ className, ...props }: React.ComponentProps<"p">): React.JSX.Element;
 declare function EmptyContent({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
 
+type ImageLightboxLabels = {
+    ariaLabel?: string;
+    close?: string;
+    previous?: string;
+    next?: string;
+};
+type ImageLightboxProps = {
+    images: string[];
+    index: number;
+    onIndexChange: (index: number) => void;
+    onClose: () => void;
+    labels?: ImageLightboxLabels;
+};
+/**
+ * Fullscreen image gallery viewer. Portal overlay with Esc/click-to-close,
+ * arrow-key navigation, wheel/pinch zoom, and pan when zoomed. Locks page
+ * scroll while mounted.
+ */
+declare function ImageLightbox({ images, index, onIndexChange, onClose, labels, }: ImageLightboxProps): React.ReactPortal;
+
 type ThemeSwitcherLabels = {
     /** Tooltip label for the theme switcher */
     theme?: string;
@@ -811,6 +831,132 @@ type ChatMessageListProps = {
 };
 declare function ChatMessageList({ messages, currentUserId, emptyTitle, emptyDescription, }: ChatMessageListProps): React.JSX.Element;
 
+type ConversationKind = "pharma_support" | "org_support" | "member_support";
+type SupportConversation = {
+    id: string;
+    kind: ConversationKind;
+    subjectId: string;
+    memberUserId: string | null;
+    lastMessageAt: string | null;
+    unreadCount?: number;
+};
+type SupportMessage = {
+    id: string;
+    conversationId: string;
+    senderId: string;
+    senderName: string;
+    senderSide: string;
+    body: string;
+    deleted: boolean;
+    createdAt: string;
+};
+type FindOrCreateConversationInput = {
+    kind: ConversationKind;
+    subjectId: string;
+    memberUserId?: string;
+};
+type SupportChatClient = {
+    basePath: string;
+    listConversations: () => Promise<SupportConversation[]>;
+    findOrCreateConversation: (input: FindOrCreateConversationInput) => Promise<SupportConversation>;
+    listMessages: (conversationId: string) => Promise<SupportMessage[]>;
+    sendMessage: (conversationId: string, text: string) => Promise<SupportMessage>;
+    markRead: (conversationId: string) => Promise<void>;
+};
+declare function createSupportChatClient(basePath?: string): SupportChatClient;
+
+type SupportMessengerItem = {
+    /** Stable list key (org id, conversation id, etc.). */
+    key: string;
+    title: string;
+    subtitle?: string;
+    avatarUrl?: string | null;
+    unreadCount?: number;
+    conversationId?: string | null;
+    open?: FindOrCreateConversationInput;
+};
+type SupportMessengerTab = {
+    id: string;
+    label: string;
+};
+type SupportMessengerLabels = {
+    launcherAria: string;
+    listTitle: string;
+    emptyList: string;
+    emptyThread: string;
+    placeholder: string;
+    send: string;
+    close: string;
+    back: string;
+    loading: string;
+    searchPlaceholder?: string;
+    unreadBadgeAria?: string;
+};
+type OpenThreadRequest = {
+    key: string;
+    title: string;
+    subtitle?: string;
+    conversationId?: string | null;
+    open?: FindOrCreateConversationInput;
+};
+type SupportMessengerContextValue = {
+    listOpen: boolean;
+    openList: () => void;
+    closeList: () => void;
+    toggleList: () => void;
+    openThread: (req: OpenThreadRequest) => void;
+    closeThread: (key: string) => void;
+    closeAll: () => void;
+    activeThreadKey: string | null;
+    totalUnread: number;
+};
+declare function useSupportMessenger(): SupportMessengerContextValue;
+/** Returns null when rendered outside `SupportMessengerProvider`. */
+declare function useSupportMessengerOptional(): SupportMessengerContextValue | null;
+type SupportMessengerProviderProps = {
+    children: ReactNode;
+    client: SupportChatClient;
+    getWsUrl: (conversationId: string) => Promise<string | null>;
+    currentUserId: string | null;
+    items: SupportMessengerItem[];
+    labels: SupportMessengerLabels;
+    /** When false, messenger chrome is not rendered. */
+    enabled?: boolean;
+    /** Collapse dock/sheet; FAB remains (e.g. event chat visible). */
+    forceMinimized?: boolean;
+    emojiLocale?: EmojiPickerLocale;
+    tabs?: SupportMessengerTab[];
+    activeTab?: string;
+    onTabChange?: (id: string) => void;
+    onRefreshItems?: () => void | Promise<void>;
+    /** Show search when item count >= this (default 8). */
+    searchThreshold?: number;
+    className?: string;
+};
+declare function SupportMessengerProvider({ children, client, getWsUrl, currentUserId, items, labels, enabled, forceMinimized, emojiLocale, tabs, activeTab, onTabChange, onRefreshItems, searchThreshold, className, }: SupportMessengerProviderProps): React.JSX.Element;
+
+type UseSupportConversationOptions = {
+    client: SupportChatClient;
+    /** Resolve a WebSocket URL (including auth token). Return null to skip WS. */
+    getWsUrl: (conversationId: string) => Promise<string | null>;
+    /** Existing conversation id, or null to find-or-create via `open`. */
+    conversationId: string | null;
+    open?: FindOrCreateConversationInput | null;
+    enabled?: boolean;
+    onConversationReady?: (conversationId: string) => void;
+    onIncomingMessage?: (message: SupportMessage) => void;
+};
+type UseSupportConversationResult = {
+    conversationId: string | null;
+    messages: SupportMessage[];
+    loading: boolean;
+    sending: boolean;
+    error: string | null;
+    send: (text: string) => Promise<void>;
+    reload: () => Promise<void>;
+};
+declare function useSupportConversation({ client, getWsUrl, conversationId: conversationIdProp, open, enabled, onConversationReady, onIncomingMessage, }: UseSupportConversationOptions): UseSupportConversationResult;
+
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AutoplayState, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, type BlocksLanguage, Bubble, BubbleContent, BubbleGroup, BubbleReactions, type ChatListMessage, ChatMessageList, type ChatMessageListProps, ConfirmDestructiveDialog, type ConfirmDestructiveDialogProps, type DescribedPlaybackError, type EmojiCategoryData, type EmojiCategoryKey, type EmojiDatum, EmojiInput, type EmojiInputProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerLocale, EmojiPickerPopover, type EmojiPickerPopoverProps, type EmojiPickerProps, type EmojiSkinTone, EmojiTextarea, type EmojiTextareaProps, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyState, type EmptyStateProps, EmptyTitle, ErrorState, type FeatureEntry, type HlsPlayerMode, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, LoadingState, MEXICO_STATES, MEXICO_STATE_PATHS, Marker, MarkerContent, MarkerIcon, Message, MessageAvatar, MessageContent, MessageFooter, MessageGroup, MessageHeader, MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerProvider, MessageScrollerViewport, MexicoMap, type MexicoMapProps, type MexicoState, type MexicoStateId, OrgSwitcher, type OrgSwitcherLabels, type OrgSwitcherProps, type OrgSwitcherTenant, PhoneInput, type PhoneInputProps, type PlaybackErrorContext, type PlaybackErrorDetail, type PlaybackErrorKind, type PlaybackState, type PlaybackStats, type ProfessionalVerificationStatus, type QualityLevel, SearchCommand, type SearchCommandLabels, type SearchCommandProps, type SearchCommandSelection, type SearchHit, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, type UseHlsPlaybackOptions, type UseHlsPlaybackResult, type UsePlaybackStatsOptions, type UseSearchHotkeyOptions, type UseSearchHotkeyResult, VerifiedProfessionalBadge, type VerifiedProfessionalBadgeProps, VideoPlayer, type VideoPlayerLabels, type VideoPlayerProps, bubbleVariants, cn, createLiveHlsConfig, createVodHlsConfig, defaultLanguages, describePlaybackError, fuzzyMatch, insertAtCaret, markerVariants, normalizeEmojiQuery, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useHlsPlayback, useLanguageContext, usePlaybackStats, useSearchHotkey };
+export { type AutoplayState, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, type BlocksLanguage, Bubble, BubbleContent, BubbleGroup, BubbleReactions, type ChatListMessage, ChatMessageList, type ChatMessageListProps, ConfirmDestructiveDialog, type ConfirmDestructiveDialogProps, type ConversationKind, type DescribedPlaybackError, type EmojiCategoryData, type EmojiCategoryKey, type EmojiDatum, EmojiInput, type EmojiInputProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerLocale, EmojiPickerPopover, type EmojiPickerPopoverProps, type EmojiPickerProps, type EmojiSkinTone, EmojiTextarea, type EmojiTextareaProps, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyState, type EmptyStateProps, EmptyTitle, ErrorState, type FeatureEntry, type FindOrCreateConversationInput, type HlsPlayerMode, ImageLightbox, type ImageLightboxLabels, type ImageLightboxProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, LoadingState, MEXICO_STATES, MEXICO_STATE_PATHS, Marker, MarkerContent, MarkerIcon, Message, MessageAvatar, MessageContent, MessageFooter, MessageGroup, MessageHeader, MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerProvider, MessageScrollerViewport, MexicoMap, type MexicoMapProps, type MexicoState, type MexicoStateId, type OpenThreadRequest, OrgSwitcher, type OrgSwitcherLabels, type OrgSwitcherProps, type OrgSwitcherTenant, PhoneInput, type PhoneInputProps, type PlaybackErrorContext, type PlaybackErrorDetail, type PlaybackErrorKind, type PlaybackState, type PlaybackStats, type ProfessionalVerificationStatus, type QualityLevel, SearchCommand, type SearchCommandLabels, type SearchCommandProps, type SearchCommandSelection, type SearchHit, type SupportChatClient, type SupportConversation, type SupportMessage, type SupportMessengerItem, type SupportMessengerLabels, SupportMessengerProvider, type SupportMessengerProviderProps, type SupportMessengerTab, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, type UseHlsPlaybackOptions, type UseHlsPlaybackResult, type UsePlaybackStatsOptions, type UseSearchHotkeyOptions, type UseSearchHotkeyResult, type UseSupportConversationOptions, type UseSupportConversationResult, VerifiedProfessionalBadge, type VerifiedProfessionalBadgeProps, VideoPlayer, type VideoPlayerLabels, type VideoPlayerProps, bubbleVariants, cn, createLiveHlsConfig, createSupportChatClient, createVodHlsConfig, defaultLanguages, describePlaybackError, fuzzyMatch, insertAtCaret, markerVariants, normalizeEmojiQuery, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useHlsPlayback, useLanguageContext, usePlaybackStats, useSearchHotkey, useSupportConversation, useSupportMessenger, useSupportMessengerOptional };

package/dist/index.d.ts

@@ -95,6 +95,26 @@ declare function EmptyTitle({ className, ...props }: React.ComponentProps<"div">
 declare function EmptyDescription({ className, ...props }: React.ComponentProps<"p">): React.JSX.Element;
 declare function EmptyContent({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
 
+type ImageLightboxLabels = {
+    ariaLabel?: string;
+    close?: string;
+    previous?: string;
+    next?: string;
+};
+type ImageLightboxProps = {
+    images: string[];
+    index: number;
+    onIndexChange: (index: number) => void;
+    onClose: () => void;
+    labels?: ImageLightboxLabels;
+};
+/**
+ * Fullscreen image gallery viewer. Portal overlay with Esc/click-to-close,
+ * arrow-key navigation, wheel/pinch zoom, and pan when zoomed. Locks page
+ * scroll while mounted.
+ */
+declare function ImageLightbox({ images, index, onIndexChange, onClose, labels, }: ImageLightboxProps): React.ReactPortal;
+
 type ThemeSwitcherLabels = {
     /** Tooltip label for the theme switcher */
     theme?: string;
@@ -811,6 +831,132 @@ type ChatMessageListProps = {
 };
 declare function ChatMessageList({ messages, currentUserId, emptyTitle, emptyDescription, }: ChatMessageListProps): React.JSX.Element;
 
+type ConversationKind = "pharma_support" | "org_support" | "member_support";
+type SupportConversation = {
+    id: string;
+    kind: ConversationKind;
+    subjectId: string;
+    memberUserId: string | null;
+    lastMessageAt: string | null;
+    unreadCount?: number;
+};
+type SupportMessage = {
+    id: string;
+    conversationId: string;
+    senderId: string;
+    senderName: string;
+    senderSide: string;
+    body: string;
+    deleted: boolean;
+    createdAt: string;
+};
+type FindOrCreateConversationInput = {
+    kind: ConversationKind;
+    subjectId: string;
+    memberUserId?: string;
+};
+type SupportChatClient = {
+    basePath: string;
+    listConversations: () => Promise<SupportConversation[]>;
+    findOrCreateConversation: (input: FindOrCreateConversationInput) => Promise<SupportConversation>;
+    listMessages: (conversationId: string) => Promise<SupportMessage[]>;
+    sendMessage: (conversationId: string, text: string) => Promise<SupportMessage>;
+    markRead: (conversationId: string) => Promise<void>;
+};
+declare function createSupportChatClient(basePath?: string): SupportChatClient;
+
+type SupportMessengerItem = {
+    /** Stable list key (org id, conversation id, etc.). */
+    key: string;
+    title: string;
+    subtitle?: string;
+    avatarUrl?: string | null;
+    unreadCount?: number;
+    conversationId?: string | null;
+    open?: FindOrCreateConversationInput;
+};
+type SupportMessengerTab = {
+    id: string;
+    label: string;
+};
+type SupportMessengerLabels = {
+    launcherAria: string;
+    listTitle: string;
+    emptyList: string;
+    emptyThread: string;
+    placeholder: string;
+    send: string;
+    close: string;
+    back: string;
+    loading: string;
+    searchPlaceholder?: string;
+    unreadBadgeAria?: string;
+};
+type OpenThreadRequest = {
+    key: string;
+    title: string;
+    subtitle?: string;
+    conversationId?: string | null;
+    open?: FindOrCreateConversationInput;
+};
+type SupportMessengerContextValue = {
+    listOpen: boolean;
+    openList: () => void;
+    closeList: () => void;
+    toggleList: () => void;
+    openThread: (req: OpenThreadRequest) => void;
+    closeThread: (key: string) => void;
+    closeAll: () => void;
+    activeThreadKey: string | null;
+    totalUnread: number;
+};
+declare function useSupportMessenger(): SupportMessengerContextValue;
+/** Returns null when rendered outside `SupportMessengerProvider`. */
+declare function useSupportMessengerOptional(): SupportMessengerContextValue | null;
+type SupportMessengerProviderProps = {
+    children: ReactNode;
+    client: SupportChatClient;
+    getWsUrl: (conversationId: string) => Promise<string | null>;
+    currentUserId: string | null;
+    items: SupportMessengerItem[];
+    labels: SupportMessengerLabels;
+    /** When false, messenger chrome is not rendered. */
+    enabled?: boolean;
+    /** Collapse dock/sheet; FAB remains (e.g. event chat visible). */
+    forceMinimized?: boolean;
+    emojiLocale?: EmojiPickerLocale;
+    tabs?: SupportMessengerTab[];
+    activeTab?: string;
+    onTabChange?: (id: string) => void;
+    onRefreshItems?: () => void | Promise<void>;
+    /** Show search when item count >= this (default 8). */
+    searchThreshold?: number;
+    className?: string;
+};
+declare function SupportMessengerProvider({ children, client, getWsUrl, currentUserId, items, labels, enabled, forceMinimized, emojiLocale, tabs, activeTab, onTabChange, onRefreshItems, searchThreshold, className, }: SupportMessengerProviderProps): React.JSX.Element;
+
+type UseSupportConversationOptions = {
+    client: SupportChatClient;
+    /** Resolve a WebSocket URL (including auth token). Return null to skip WS. */
+    getWsUrl: (conversationId: string) => Promise<string | null>;
+    /** Existing conversation id, or null to find-or-create via `open`. */
+    conversationId: string | null;
+    open?: FindOrCreateConversationInput | null;
+    enabled?: boolean;
+    onConversationReady?: (conversationId: string) => void;
+    onIncomingMessage?: (message: SupportMessage) => void;
+};
+type UseSupportConversationResult = {
+    conversationId: string | null;
+    messages: SupportMessage[];
+    loading: boolean;
+    sending: boolean;
+    error: string | null;
+    send: (text: string) => Promise<void>;
+    reload: () => Promise<void>;
+};
+declare function useSupportConversation({ client, getWsUrl, conversationId: conversationIdProp, open, enabled, onConversationReady, onIncomingMessage, }: UseSupportConversationOptions): UseSupportConversationResult;
+
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AutoplayState, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, type BlocksLanguage, Bubble, BubbleContent, BubbleGroup, BubbleReactions, type ChatListMessage, ChatMessageList, type ChatMessageListProps, ConfirmDestructiveDialog, type ConfirmDestructiveDialogProps, type DescribedPlaybackError, type EmojiCategoryData, type EmojiCategoryKey, type EmojiDatum, EmojiInput, type EmojiInputProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerLocale, EmojiPickerPopover, type EmojiPickerPopoverProps, type EmojiPickerProps, type EmojiSkinTone, EmojiTextarea, type EmojiTextareaProps, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyState, type EmptyStateProps, EmptyTitle, ErrorState, type FeatureEntry, type HlsPlayerMode, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, LoadingState, MEXICO_STATES, MEXICO_STATE_PATHS, Marker, MarkerContent, MarkerIcon, Message, MessageAvatar, MessageContent, MessageFooter, MessageGroup, MessageHeader, MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerProvider, MessageScrollerViewport, MexicoMap, type MexicoMapProps, type MexicoState, type MexicoStateId, OrgSwitcher, type OrgSwitcherLabels, type OrgSwitcherProps, type OrgSwitcherTenant, PhoneInput, type PhoneInputProps, type PlaybackErrorContext, type PlaybackErrorDetail, type PlaybackErrorKind, type PlaybackState, type PlaybackStats, type ProfessionalVerificationStatus, type QualityLevel, SearchCommand, type SearchCommandLabels, type SearchCommandProps, type SearchCommandSelection, type SearchHit, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, type UseHlsPlaybackOptions, type UseHlsPlaybackResult, type UsePlaybackStatsOptions, type UseSearchHotkeyOptions, type UseSearchHotkeyResult, VerifiedProfessionalBadge, type VerifiedProfessionalBadgeProps, VideoPlayer, type VideoPlayerLabels, type VideoPlayerProps, bubbleVariants, cn, createLiveHlsConfig, createVodHlsConfig, defaultLanguages, describePlaybackError, fuzzyMatch, insertAtCaret, markerVariants, normalizeEmojiQuery, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useHlsPlayback, useLanguageContext, usePlaybackStats, useSearchHotkey };
+export { type AutoplayState, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, type BlocksLanguage, Bubble, BubbleContent, BubbleGroup, BubbleReactions, type ChatListMessage, ChatMessageList, type ChatMessageListProps, ConfirmDestructiveDialog, type ConfirmDestructiveDialogProps, type ConversationKind, type DescribedPlaybackError, type EmojiCategoryData, type EmojiCategoryKey, type EmojiDatum, EmojiInput, type EmojiInputProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerLocale, EmojiPickerPopover, type EmojiPickerPopoverProps, type EmojiPickerProps, type EmojiSkinTone, EmojiTextarea, type EmojiTextareaProps, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyState, type EmptyStateProps, EmptyTitle, ErrorState, type FeatureEntry, type FindOrCreateConversationInput, type HlsPlayerMode, ImageLightbox, type ImageLightboxLabels, type ImageLightboxProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, LoadingState, MEXICO_STATES, MEXICO_STATE_PATHS, Marker, MarkerContent, MarkerIcon, Message, MessageAvatar, MessageContent, MessageFooter, MessageGroup, MessageHeader, MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerProvider, MessageScrollerViewport, MexicoMap, type MexicoMapProps, type MexicoState, type MexicoStateId, type OpenThreadRequest, OrgSwitcher, type OrgSwitcherLabels, type OrgSwitcherProps, type OrgSwitcherTenant, PhoneInput, type PhoneInputProps, type PlaybackErrorContext, type PlaybackErrorDetail, type PlaybackErrorKind, type PlaybackState, type PlaybackStats, type ProfessionalVerificationStatus, type QualityLevel, SearchCommand, type SearchCommandLabels, type SearchCommandProps, type SearchCommandSelection, type SearchHit, type SupportChatClient, type SupportConversation, type SupportMessage, type SupportMessengerItem, type SupportMessengerLabels, SupportMessengerProvider, type SupportMessengerProviderProps, type SupportMessengerTab, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, type UseHlsPlaybackOptions, type UseHlsPlaybackResult, type UsePlaybackStatsOptions, type UseSearchHotkeyOptions, type UseSearchHotkeyResult, type UseSupportConversationOptions, type UseSupportConversationResult, VerifiedProfessionalBadge, type VerifiedProfessionalBadgeProps, VideoPlayer, type VideoPlayerLabels, type VideoPlayerProps, bubbleVariants, cn, createLiveHlsConfig, createSupportChatClient, createVodHlsConfig, defaultLanguages, describePlaybackError, fuzzyMatch, insertAtCaret, markerVariants, normalizeEmojiQuery, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useHlsPlayback, useLanguageContext, usePlaybackStats, useSearchHotkey, useSupportConversation, useSupportMessenger, useSupportMessengerOptional };