@sesionario/blocks 1.3.1 → 1.4.0

package/dist/index.d.cts

@@ -334,6 +334,8 @@ interface EmojiPickerPopoverProps extends EmojiPickerProps {
     triggerLabel?: string;
     /** Extra classes for the trigger button. */
     triggerClassName?: string;
+    /** Disable the trigger (e.g. when the host field is disabled). */
+    disabled?: boolean;
     /** Popover side. Default `"top"`. */
     side?: React.ComponentProps<typeof PopoverContent>["side"];
     /** Popover alignment. Default `"end"`. */
@@ -347,10 +349,38 @@ interface EmojiPickerPopoverProps extends EmojiPickerProps {
 }
 /**
  * Convenience wrapper: a `Smile` icon button that opens {@link EmojiPicker} in
- * a popover. Drop it next to a textarea/input; wire `onSelect` to insert at the
- * caret. Uncontrolled by default; pass `open`/`onOpenChange` to control it.
+ * a popover. Prefer {@link EmojiTextarea} / {@link EmojiInput} for in-field
+ * adornment; use this when you need a standalone trigger. Uncontrolled by
+ * default; pass `open`/`onOpenChange` to control it.
+ */
+declare function EmojiPickerPopover({ onSelect, triggerLabel, triggerClassName, disabled, side, align, open, onOpenChange, keepOpenOnSelect, locale, ...pickerProps }: EmojiPickerPopoverProps): React.JSX.Element;
+
+type PickerPassthrough = Pick<EmojiPickerPopoverProps, "triggerLabel" | "keepOpenOnSelect" | "open" | "onOpenChange" | "side" | "align" | "labels" | "recentLimit" | "storageKey">;
+type EmojiFieldSharedProps = PickerPassthrough & {
+    /** Locale for the emoji picker labels. Default `"en"`. */
+    locale?: EmojiPickerLocale;
+    /** Extra classes for the emoji trigger button. */
+    emojiTriggerClassName?: string;
+};
+type EmojiTextareaProps = Omit<React.ComponentProps<"textarea">, "children"> & EmojiFieldSharedProps;
+declare const EmojiTextarea: React.ForwardRefExoticComponent<Omit<EmojiTextareaProps, "ref"> & React.RefAttributes<HTMLTextAreaElement>>;
+type EmojiInputProps = Omit<React.ComponentProps<"input">, "children"> & EmojiFieldSharedProps;
+declare const EmojiInput: React.ForwardRefExoticComponent<Omit<EmojiInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+
+/**
+ * Splices `text` into `value` at the current caret (falling back to the end
+ * when the element is unfocused/unavailable), returning the new value and the
+ * caret position right after the inserted text. Used to insert an emoji into
+ * a controlled textarea/input without clobbering whatever the user was
+ * typing.
  */
-declare function EmojiPickerPopover({ onSelect, triggerLabel, triggerClassName, side, align, open, onOpenChange, keepOpenOnSelect, locale, ...pickerProps }: EmojiPickerPopoverProps): React.JSX.Element;
+declare function insertAtCaret(element: {
+    selectionStart: number | null;
+    selectionEnd: number | null;
+} | null, value: string, text: string): {
+    value: string;
+    caret: number;
+};
 
 /**
  * Playback error description, ported from the app's HLS player but stripped of
@@ -795,4 +825,4 @@ declare function getAvatarColors(name: string): AvatarColors;
 /** CSS style object for `AvatarFallback` (or any letter-avatar container). */
 declare function avatarFallbackStyle(name: string): Pick<AvatarColors, "backgroundColor" | "color">;
 
-export { type AutoplayState, type AvatarColors, 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, EmojiPicker, type EmojiPickerLabels, type EmojiPickerLocale, EmojiPickerPopover, type EmojiPickerPopoverProps, type EmojiPickerProps, type EmojiSkinTone, 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, avatarFallbackStyle, bubbleVariants, cn, createLiveHlsConfig, createVodHlsConfig, defaultLanguages, describePlaybackError, fuzzyMatch, getAvatarColors, getInitials, markerVariants, normalizeEmojiQuery, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useHlsPlayback, useLanguageContext, usePlaybackStats, useSearchHotkey };
+export { type AutoplayState, type AvatarColors, 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, avatarFallbackStyle, bubbleVariants, cn, createLiveHlsConfig, createVodHlsConfig, defaultLanguages, describePlaybackError, fuzzyMatch, getAvatarColors, getInitials, insertAtCaret, markerVariants, normalizeEmojiQuery, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useHlsPlayback, useLanguageContext, usePlaybackStats, useSearchHotkey };

package/dist/index.d.ts

@@ -334,6 +334,8 @@ interface EmojiPickerPopoverProps extends EmojiPickerProps {
     triggerLabel?: string;
     /** Extra classes for the trigger button. */
     triggerClassName?: string;
+    /** Disable the trigger (e.g. when the host field is disabled). */
+    disabled?: boolean;
     /** Popover side. Default `"top"`. */
     side?: React.ComponentProps<typeof PopoverContent>["side"];
     /** Popover alignment. Default `"end"`. */
@@ -347,10 +349,38 @@ interface EmojiPickerPopoverProps extends EmojiPickerProps {
 }
 /**
  * Convenience wrapper: a `Smile` icon button that opens {@link EmojiPicker} in
- * a popover. Drop it next to a textarea/input; wire `onSelect` to insert at the
- * caret. Uncontrolled by default; pass `open`/`onOpenChange` to control it.
+ * a popover. Prefer {@link EmojiTextarea} / {@link EmojiInput} for in-field
+ * adornment; use this when you need a standalone trigger. Uncontrolled by
+ * default; pass `open`/`onOpenChange` to control it.
+ */
+declare function EmojiPickerPopover({ onSelect, triggerLabel, triggerClassName, disabled, side, align, open, onOpenChange, keepOpenOnSelect, locale, ...pickerProps }: EmojiPickerPopoverProps): React.JSX.Element;
+
+type PickerPassthrough = Pick<EmojiPickerPopoverProps, "triggerLabel" | "keepOpenOnSelect" | "open" | "onOpenChange" | "side" | "align" | "labels" | "recentLimit" | "storageKey">;
+type EmojiFieldSharedProps = PickerPassthrough & {
+    /** Locale for the emoji picker labels. Default `"en"`. */
+    locale?: EmojiPickerLocale;
+    /** Extra classes for the emoji trigger button. */
+    emojiTriggerClassName?: string;
+};
+type EmojiTextareaProps = Omit<React.ComponentProps<"textarea">, "children"> & EmojiFieldSharedProps;
+declare const EmojiTextarea: React.ForwardRefExoticComponent<Omit<EmojiTextareaProps, "ref"> & React.RefAttributes<HTMLTextAreaElement>>;
+type EmojiInputProps = Omit<React.ComponentProps<"input">, "children"> & EmojiFieldSharedProps;
+declare const EmojiInput: React.ForwardRefExoticComponent<Omit<EmojiInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+
+/**
+ * Splices `text` into `value` at the current caret (falling back to the end
+ * when the element is unfocused/unavailable), returning the new value and the
+ * caret position right after the inserted text. Used to insert an emoji into
+ * a controlled textarea/input without clobbering whatever the user was
+ * typing.
  */
-declare function EmojiPickerPopover({ onSelect, triggerLabel, triggerClassName, side, align, open, onOpenChange, keepOpenOnSelect, locale, ...pickerProps }: EmojiPickerPopoverProps): React.JSX.Element;
+declare function insertAtCaret(element: {
+    selectionStart: number | null;
+    selectionEnd: number | null;
+} | null, value: string, text: string): {
+    value: string;
+    caret: number;
+};
 
 /**
  * Playback error description, ported from the app's HLS player but stripped of
@@ -795,4 +825,4 @@ declare function getAvatarColors(name: string): AvatarColors;
 /** CSS style object for `AvatarFallback` (or any letter-avatar container). */
 declare function avatarFallbackStyle(name: string): Pick<AvatarColors, "backgroundColor" | "color">;
 
-export { type AutoplayState, type AvatarColors, 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, EmojiPicker, type EmojiPickerLabels, type EmojiPickerLocale, EmojiPickerPopover, type EmojiPickerPopoverProps, type EmojiPickerProps, type EmojiSkinTone, 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, avatarFallbackStyle, bubbleVariants, cn, createLiveHlsConfig, createVodHlsConfig, defaultLanguages, describePlaybackError, fuzzyMatch, getAvatarColors, getInitials, markerVariants, normalizeEmojiQuery, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useHlsPlayback, useLanguageContext, usePlaybackStats, useSearchHotkey };
+export { type AutoplayState, type AvatarColors, 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, avatarFallbackStyle, bubbleVariants, cn, createLiveHlsConfig, createVodHlsConfig, defaultLanguages, describePlaybackError, fuzzyMatch, getAvatarColors, getInitials, insertAtCaret, markerVariants, normalizeEmojiQuery, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useHlsPlayback, useLanguageContext, usePlaybackStats, useSearchHotkey };