@sesionario/blocks 1.8.0 → 1.9.0

package/dist/index.d.cts

@@ -629,6 +629,8 @@ declare function useDebouncedValue<T>(value: T, delayMs: number): T;
  */
 declare function useDebouncedValueStrict<T>(value: T, delayMs: number): T | undefined;
 
+declare function useMediaQuery(query: string): boolean;
+
 interface UseSearchHotkeyOptions {
     /** Initial open state. Defaults to `false`. */
     defaultOpen?: boolean;
@@ -647,6 +649,93 @@ interface UseSearchHotkeyResult {
  */
 declare function useSearchHotkey(options?: UseSearchHotkeyOptions): UseSearchHotkeyResult;
 
+type SearchablePickerLabels = {
+    placeholder?: string;
+    searchPlaceholder?: string;
+    empty?: string;
+    loading?: string;
+    error?: string;
+    recommended?: string;
+    recent?: string;
+    results?: string;
+    done?: string;
+    cancel?: string;
+    clear?: string;
+    /** Interpolates selected count, e.g. `(n) => \`${n} seleccionados\``. */
+    selectedCount?: (count: number) => string;
+    emptyOption?: string;
+    loadMore?: string;
+    dialogTitle?: string;
+};
+type SearchablePickerPinned<T> = {
+    recommended?: T[];
+    recent?: T[];
+};
+type SearchablePickerCreateOption = {
+    label: string;
+    onSelect: () => void;
+};
+type SearchablePickerBaseProps<T> = {
+    /** Static option list. Filtered client-side with `fuzzyMatch`. */
+    options?: T[];
+    /**
+     * Remote fetcher. When provided with a non-empty query (≥ `minQueryLength`),
+     * results replace the static filtered list. Empty query still shows `options`
+     * and pinned groups (hybrid mode).
+     */
+    fetchOptions?: (query: string) => Promise<T[]>;
+    getOptionValue: (item: T) => string;
+    getOptionLabel: (item: T) => string;
+    getOptionKeywords?: (item: T) => string[];
+    renderOption?: (item: T, state: {
+        selected: boolean;
+    }) => ReactNode;
+    /** Custom trigger content. Receives the resolved selected item(s). */
+    renderValue?: (item: T | T[] | null) => ReactNode;
+    pinned?: SearchablePickerPinned<T>;
+    labels?: SearchablePickerLabels;
+    /** Minimum query length before calling `fetchOptions`. Default 0 (fetch on any query). */
+    minQueryLength?: number;
+    /** Debounce delay for `fetchOptions`. Default 200ms. */
+    debounceMs?: number;
+    disabled?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    clearable?: boolean;
+    /** Show a leading “none / empty” option in single mode. */
+    allowEmpty?: boolean;
+    emptyLabel?: string;
+    /**
+     * Keep the panel open after selecting an item.
+     * Defaults to `false` for single and `true` for multiple.
+     */
+    keepOpenOnSelect?: boolean;
+    /** Cap for multiple selection. */
+    maxSelected?: number;
+    createOption?: SearchablePickerCreateOption;
+    /** Called when the user activates the load-more sentinel (remote pagination). */
+    onLoadMore?: () => void | Promise<void>;
+    hasMore?: boolean;
+    className?: string;
+    triggerClassName?: string;
+    id?: string;
+    "aria-labelledby"?: string;
+    "aria-label"?: string;
+};
+type SearchablePickerSingleProps<T> = SearchablePickerBaseProps<T> & {
+    mode?: "single";
+    value?: string | null;
+    onValueChange?: (value: string | null) => void;
+};
+type SearchablePickerMultipleProps<T> = SearchablePickerBaseProps<T> & {
+    mode: "multiple";
+    value?: string[];
+    onValueChange?: (value: string[]) => void;
+};
+type SearchablePickerProps<T> = SearchablePickerSingleProps<T> | SearchablePickerMultipleProps<T>;
+
+declare function SearchablePicker<T>(props: SearchablePickerProps<T>): React.JSX.Element;
+
 /**
  * A search result returned by search-svc's `GET /search` after ACL
  * hydration. Mirrors `search-svc/src/domain/search/types.ts` `SearchHit` —
@@ -968,4 +1057,4 @@ declare function useSupportConversation({ client, getWsUrl, conversationId: conv
 
 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 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, ExpandableText, type ExpandableTextProps, 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 };
+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, ExpandableText, type ExpandableTextProps, 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, SearchablePicker, type SearchablePickerCreateOption, type SearchablePickerLabels, type SearchablePickerMultipleProps, type SearchablePickerPinned, type SearchablePickerProps, type SearchablePickerSingleProps, 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, useMediaQuery, usePlaybackStats, useSearchHotkey, useSupportConversation, useSupportMessenger, useSupportMessengerOptional };

package/dist/index.d.ts

@@ -629,6 +629,8 @@ declare function useDebouncedValue<T>(value: T, delayMs: number): T;
  */
 declare function useDebouncedValueStrict<T>(value: T, delayMs: number): T | undefined;
 
+declare function useMediaQuery(query: string): boolean;
+
 interface UseSearchHotkeyOptions {
     /** Initial open state. Defaults to `false`. */
     defaultOpen?: boolean;
@@ -647,6 +649,93 @@ interface UseSearchHotkeyResult {
  */
 declare function useSearchHotkey(options?: UseSearchHotkeyOptions): UseSearchHotkeyResult;
 
+type SearchablePickerLabels = {
+    placeholder?: string;
+    searchPlaceholder?: string;
+    empty?: string;
+    loading?: string;
+    error?: string;
+    recommended?: string;
+    recent?: string;
+    results?: string;
+    done?: string;
+    cancel?: string;
+    clear?: string;
+    /** Interpolates selected count, e.g. `(n) => \`${n} seleccionados\``. */
+    selectedCount?: (count: number) => string;
+    emptyOption?: string;
+    loadMore?: string;
+    dialogTitle?: string;
+};
+type SearchablePickerPinned<T> = {
+    recommended?: T[];
+    recent?: T[];
+};
+type SearchablePickerCreateOption = {
+    label: string;
+    onSelect: () => void;
+};
+type SearchablePickerBaseProps<T> = {
+    /** Static option list. Filtered client-side with `fuzzyMatch`. */
+    options?: T[];
+    /**
+     * Remote fetcher. When provided with a non-empty query (≥ `minQueryLength`),
+     * results replace the static filtered list. Empty query still shows `options`
+     * and pinned groups (hybrid mode).
+     */
+    fetchOptions?: (query: string) => Promise<T[]>;
+    getOptionValue: (item: T) => string;
+    getOptionLabel: (item: T) => string;
+    getOptionKeywords?: (item: T) => string[];
+    renderOption?: (item: T, state: {
+        selected: boolean;
+    }) => ReactNode;
+    /** Custom trigger content. Receives the resolved selected item(s). */
+    renderValue?: (item: T | T[] | null) => ReactNode;
+    pinned?: SearchablePickerPinned<T>;
+    labels?: SearchablePickerLabels;
+    /** Minimum query length before calling `fetchOptions`. Default 0 (fetch on any query). */
+    minQueryLength?: number;
+    /** Debounce delay for `fetchOptions`. Default 200ms. */
+    debounceMs?: number;
+    disabled?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    clearable?: boolean;
+    /** Show a leading “none / empty” option in single mode. */
+    allowEmpty?: boolean;
+    emptyLabel?: string;
+    /**
+     * Keep the panel open after selecting an item.
+     * Defaults to `false` for single and `true` for multiple.
+     */
+    keepOpenOnSelect?: boolean;
+    /** Cap for multiple selection. */
+    maxSelected?: number;
+    createOption?: SearchablePickerCreateOption;
+    /** Called when the user activates the load-more sentinel (remote pagination). */
+    onLoadMore?: () => void | Promise<void>;
+    hasMore?: boolean;
+    className?: string;
+    triggerClassName?: string;
+    id?: string;
+    "aria-labelledby"?: string;
+    "aria-label"?: string;
+};
+type SearchablePickerSingleProps<T> = SearchablePickerBaseProps<T> & {
+    mode?: "single";
+    value?: string | null;
+    onValueChange?: (value: string | null) => void;
+};
+type SearchablePickerMultipleProps<T> = SearchablePickerBaseProps<T> & {
+    mode: "multiple";
+    value?: string[];
+    onValueChange?: (value: string[]) => void;
+};
+type SearchablePickerProps<T> = SearchablePickerSingleProps<T> | SearchablePickerMultipleProps<T>;
+
+declare function SearchablePicker<T>(props: SearchablePickerProps<T>): React.JSX.Element;
+
 /**
  * A search result returned by search-svc's `GET /search` after ACL
  * hydration. Mirrors `search-svc/src/domain/search/types.ts` `SearchHit` —
@@ -968,4 +1057,4 @@ declare function useSupportConversation({ client, getWsUrl, conversationId: conv
 
 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 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, ExpandableText, type ExpandableTextProps, 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 };
+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, ExpandableText, type ExpandableTextProps, 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, SearchablePicker, type SearchablePickerCreateOption, type SearchablePickerLabels, type SearchablePickerMultipleProps, type SearchablePickerPinned, type SearchablePickerProps, type SearchablePickerSingleProps, 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, useMediaQuery, usePlaybackStats, useSearchHotkey, useSupportConversation, useSupportMessenger, useSupportMessengerOptional };