@sesionario/blocks 1.22.3 → 1.24.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { FormEvent, KeyboardEvent, RefObject, CSSProperties, ReactNode, ComponentProps, SVGProps } from 'react';
+import { FormEvent, KeyboardEvent, RefObject, CSSProperties, ReactNode, ComponentProps, PointerEvent, Dispatch, SetStateAction, SVGProps } from 'react';
 import { LucideIcon } from 'lucide-react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
@@ -289,6 +289,70 @@ type ImageLightboxProps = {
  */
 declare function ImageLightbox({ images, index, onIndexChange, onClose, labels, }: ImageLightboxProps): React.ReactPortal;
 
+type MediaCarouselItem = {
+    kind: "image";
+    src: string;
+    alt?: string;
+} | {
+    kind: "video";
+    node: ReactNode;
+} | {
+    kind: "pdf";
+    fileUrl: string;
+    fileName: string;
+    downloadUrl?: string;
+};
+type MediaCarouselLabels = {
+    previous?: string;
+    next?: string;
+    counter?: (current: number, total: number) => string;
+};
+type MediaCarouselPdfRenderProps = {
+    fileUrl: string;
+    fileName: string;
+    downloadUrl?: string;
+};
+type MediaCarouselProps = {
+    items: MediaCarouselItem[];
+    index: number;
+    onIndexChange: (index: number) => void;
+    labels?: MediaCarouselLabels;
+    className?: string;
+    /**
+     * Slot for PDF rendering so this component can live in the root barrel
+     * without pulling pdfjs into every consumer.
+     */
+    renderPdf?: (props: MediaCarouselPdfRenderProps) => ReactNode;
+};
+/**
+ * Presentational media pane for image / video-slot / pdf items. Images use
+ * pinch/swipe gestures; video and pdf are opaque slots supplied by the
+ * consumer.
+ */
+declare function MediaCarousel({ items, index, onIndexChange, labels, className, renderPdf, }: MediaCarouselProps): React.JSX.Element | null;
+
+type MediaViewerDialogLabels = {
+    close?: string;
+    title?: string;
+    description?: string;
+};
+type MediaViewerDialogProps = {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    children: ReactNode;
+    labels?: MediaViewerDialogLabels;
+    className?: string;
+    /** Extra classes for the dialog content shell. */
+    contentClassName?: string;
+    showCloseButton?: boolean;
+};
+/**
+ * Edge-to-edge fullscreen dialog shell for media viewers (post detail, PDF,
+ * etc.). Uses the shared Radix dialog for focus trap, Esc and `aria-modal`.
+ * Pass `contentClassName` to opt into a contained desktop card when needed.
+ */
+declare function MediaViewerDialog({ open, onOpenChange, children, labels, className, contentClassName, showCloseButton, }: MediaViewerDialogProps): React.JSX.Element;
+
 type ThemeSwitcherLabels = {
     /** Tooltip label for the theme switcher */
     theme?: string;
@@ -958,6 +1022,54 @@ declare function useDebouncedValueStrict<T>(value: T, delayMs: number): T | unde
 
 declare function useMediaQuery(query: string): boolean;
 
+declare const ZOOM_PAN_MIN_SCALE = 1;
+declare const ZOOM_PAN_MAX_SCALE = 4;
+declare const ZOOM_PAN_SWIPE_COMMIT_PX = 56;
+declare const ZOOM_PAN_SWIPE_SNAP_MS = 180;
+type ZoomPanTransform = {
+    scale: number;
+    tx: number;
+    ty: number;
+};
+type SwipeDirection = "prev" | "next";
+type UseZoomPanGesturesOptions = {
+    minScale?: number;
+    maxScale?: number;
+    /** When false, horizontal swipe never commits (still pans when zoomed). */
+    swipeEnabled?: boolean;
+    onSwipeCommit?: (direction: SwipeDirection) => void;
+    /** When true, wheel zoom is attached to the stage. Defaults to true. */
+    wheelZoom?: boolean;
+    /**
+     * Double-tap behavior at min scale: "reset" (default — ImageLightbox) or
+     * "toggle" (zoom in toward tap, then reset).
+     */
+    doubleTap?: "reset" | "toggle";
+};
+type UseZoomPanGesturesResult = {
+    stageRef: RefObject<HTMLDivElement | null>;
+    transform: ZoomPanTransform;
+    isDragging: boolean;
+    snapBack: boolean;
+    handlers: {
+        onPointerDown: (e: PointerEvent<HTMLDivElement>) => void;
+        onPointerMove: (e: PointerEvent<HTMLDivElement>) => void;
+        onPointerUp: (e: PointerEvent<HTMLDivElement>) => void;
+        onPointerCancel: (e: PointerEvent<HTMLDivElement>) => void;
+    };
+    reset: () => void;
+    setScale: (scale: number) => void;
+    clearSnapBack: () => void;
+};
+declare function zoomToward(prev: ZoomPanTransform, nextScale: number, originX: number, originY: number, minScale?: number, maxScale?: number): ZoomPanTransform;
+declare function prefersReducedMotion(): boolean;
+/**
+ * Pointer-driven pinch zoom, double-tap zoom toggle/reset, pan while zoomed,
+ * and horizontal swipe-to-commit. Shared by ImageLightbox, MediaCarousel and
+ * PdfViewer.
+ */
+declare function useZoomPanGestures(options?: UseZoomPanGesturesOptions): UseZoomPanGesturesResult;
+
 type ScrollFadeXEdges = {
     canScrollLeft: boolean;
     canScrollRight: boolean;
@@ -990,6 +1102,57 @@ interface UseSearchHotkeyResult {
  */
 declare function useSearchHotkey(options?: UseSearchHotkeyOptions): UseSearchHotkeyResult;
 
+/**
+ * Like `useState`, but when the surrounding `ScrollRestorationProvider` is
+ * mounting a browser back/forward traversal, the initial state is read from
+ * an in-memory snapshot (so infinite lists paint tall enough to restore
+ * scroll). Writes back on every change. Outside a provider, degrades to
+ * plain `useState`.
+ */
+declare function useRestorableState<T>(subKey: string, initializer: () => T): [T, Dispatch<SetStateAction<T>>];
+
+type ScrollRestorationContextValue = {
+    routeKey: string;
+    /** True when this route mount is a browser back/forward traversal. */
+    isTraversal: boolean;
+    anchorAttribute: string;
+};
+declare function useScrollRestorationContext(): ScrollRestorationContextValue | null;
+type ScrollRestorationProviderProps = {
+    /** App-supplied key, typically `pathname + search`. */
+    routeKey: string;
+    /**
+     * Nested scroll container. Omit to use the document (window) scroller.
+     * Required when the app shells content inside `overflow-auto` / `overflow-y-auto`.
+     */
+    containerRef?: RefObject<HTMLElement | null>;
+    /** Attribute used to mark restore anchors. Default: `data-scroll-anchor`. */
+    anchorAttribute?: string;
+    children: ReactNode;
+};
+/**
+ * Owns per-route scroll marks: saves on scroll, resets to top on fresh
+ * navigation, and restores (with anchor alignment) on browser back/forward.
+ *
+ * Apps must supply `routeKey` from their router (`usePathname` +
+ * `useSearchParams`) so this package stays free of `next/*` imports.
+ */
+declare function ScrollRestorationProvider({ routeKey, containerRef, anchorAttribute, children, }: ScrollRestorationProviderProps): React.JSX.Element;
+
+/**
+ * Framework-free scroll-restoration store.
+ *
+ * Keeps per-route scroll marks (offset + anchor) and in-memory list snapshots
+ * so infinite-scroll pages can remount tall enough for the browser to land
+ * where the user left off. No `next/*` imports — apps supply the route key.
+ */
+type ScrollMark = {
+    top: number;
+    anchorId: string | null;
+    /** Anchor's top edge relative to the scrollport top at save time. */
+    anchorTop: number;
+};
+
 type SearchablePickerLabels = {
     placeholder?: string;
     searchPlaceholder?: string;
@@ -1501,4 +1664,4 @@ declare function useRealtimeChannel({ getWsUrl, onEvent, enabled, reconnectDelay
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AutoplayState, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, type BlocksLanguage, BrandX, type BrandXProps, Bubble, BubbleContent, BubbleGroup, BubbleReactions, type ChatListMessage, ChatMessageList, type ChatMessageListProps, ConfirmDestructiveDialog, type ConfirmDestructiveDialogProps, type ConversationKind, DEFAULT_EDITABLE_SECTION_LABELS, DataList, DataListItem, type DataListItemProps, type DataListProps, type DescribedPlaybackError, DropdownMenuItem, DropdownMenuSeparator, EditableSection, type EditableSectionLabels, type EditableSectionMode, type EditableSectionProps, type EditableSectionSlots, 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, FeedVideoPlayer, type FeedVideoPlayerProps, FieldMessage, type FieldMessageProps, 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, type MergedPlatformAccountOrg, Message, MessageAvatar, MessageComposer, type MessageComposerProps, 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, PLATFORM_ACCOUNT_ORG_COLLAPSE_AT, PaymentIcon, type PaymentIconFormat, type PaymentIconProps, PhoneInput, type PhoneInputProps, PlatformAccountMenu, type PlatformAccountMenuLabels, type PlatformAccountMenuOrg, type PlatformAccountMenuProps, type PlatformAccountMenuUrls, type PlatformAccountMenuUser, type PlatformAccountMenuVariant, PlatformNavbar, type PlatformNavbarProps, type PlaybackErrorContext, type PlaybackErrorDetail, type PlaybackErrorKind, type PlaybackState, type PlaybackStats, type ProfessionalVerificationStatus, type QualityLevel, type RealtimeEvent, type ScrollFadeXEdges, 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 UseEditableSectionOptions, type UseEditableSectionResult, type UseFeedExclusivePlaybackResult, type UseHlsPlaybackOptions, type UseHlsPlaybackResult, type UsePlaybackStatsOptions, type UseRealtimeChannelOptions, type UseSearchHotkeyOptions, type UseSearchHotkeyResult, type UseSupportConversationOptions, type UseSupportConversationResult, VerifiedProfessionalBadge, type VerifiedProfessionalBadgeProps, VideoPlayer, type VideoPlayerLabels, type VideoPlayerProps, bubbleVariants, cn, createLiveHlsConfig, createSupportChatClient, createVodHlsConfig, defaultLanguages, describeAvResync, describePlaybackError, formatPaymentCardBrand, fuzzyMatch, insertAtCaret, markerVariants, mergePlatformAccountOrgs, normalizeEmojiQuery, normalizePaymentCardBrand, paymentIconBrandFromStripe, paymentTypeFromStripeBrand, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useEditableSection, useFeedExclusivePlayback, useHlsPlayback, useLanguageContext, useMediaQuery, usePlaybackStats, useRealtimeChannel, useScrollFadeXEdges, useSearchHotkey, useSupportConversation, useSupportMessenger, useSupportMessengerOptional };
+export { type AutoplayState, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, type BlocksLanguage, BrandX, type BrandXProps, Bubble, BubbleContent, BubbleGroup, BubbleReactions, type ChatListMessage, ChatMessageList, type ChatMessageListProps, ConfirmDestructiveDialog, type ConfirmDestructiveDialogProps, type ConversationKind, DEFAULT_EDITABLE_SECTION_LABELS, DataList, DataListItem, type DataListItemProps, type DataListProps, type DescribedPlaybackError, DropdownMenuItem, DropdownMenuSeparator, EditableSection, type EditableSectionLabels, type EditableSectionMode, type EditableSectionProps, type EditableSectionSlots, 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, FeedVideoPlayer, type FeedVideoPlayerProps, FieldMessage, type FieldMessageProps, 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, MediaCarousel, type MediaCarouselItem, type MediaCarouselLabels, type MediaCarouselPdfRenderProps, type MediaCarouselProps, MediaViewerDialog, type MediaViewerDialogLabels, type MediaViewerDialogProps, type MergedPlatformAccountOrg, Message, MessageAvatar, MessageComposer, type MessageComposerProps, 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, PLATFORM_ACCOUNT_ORG_COLLAPSE_AT, PaymentIcon, type PaymentIconFormat, type PaymentIconProps, PhoneInput, type PhoneInputProps, PlatformAccountMenu, type PlatformAccountMenuLabels, type PlatformAccountMenuOrg, type PlatformAccountMenuProps, type PlatformAccountMenuUrls, type PlatformAccountMenuUser, type PlatformAccountMenuVariant, PlatformNavbar, type PlatformNavbarProps, type PlaybackErrorContext, type PlaybackErrorDetail, type PlaybackErrorKind, type PlaybackState, type PlaybackStats, type ProfessionalVerificationStatus, type QualityLevel, type RealtimeEvent, type ScrollFadeXEdges, type ScrollMark, type ScrollRestorationContextValue, ScrollRestorationProvider, type ScrollRestorationProviderProps, 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, type SwipeDirection, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, type UseEditableSectionOptions, type UseEditableSectionResult, type UseFeedExclusivePlaybackResult, type UseHlsPlaybackOptions, type UseHlsPlaybackResult, type UsePlaybackStatsOptions, type UseRealtimeChannelOptions, type UseSearchHotkeyOptions, type UseSearchHotkeyResult, type UseSupportConversationOptions, type UseSupportConversationResult, type UseZoomPanGesturesOptions, type UseZoomPanGesturesResult, VerifiedProfessionalBadge, type VerifiedProfessionalBadgeProps, VideoPlayer, type VideoPlayerLabels, type VideoPlayerProps, ZOOM_PAN_MAX_SCALE, ZOOM_PAN_MIN_SCALE, ZOOM_PAN_SWIPE_COMMIT_PX, ZOOM_PAN_SWIPE_SNAP_MS, type ZoomPanTransform, bubbleVariants, cn, createLiveHlsConfig, createSupportChatClient, createVodHlsConfig, defaultLanguages, describeAvResync, describePlaybackError, formatPaymentCardBrand, fuzzyMatch, insertAtCaret, markerVariants, mergePlatformAccountOrgs, normalizeEmojiQuery, normalizePaymentCardBrand, paymentIconBrandFromStripe, paymentTypeFromStripeBrand, prefersReducedMotion, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useEditableSection, useFeedExclusivePlayback, useHlsPlayback, useLanguageContext, useMediaQuery, usePlaybackStats, useRealtimeChannel, useRestorableState, useScrollFadeXEdges, useScrollRestorationContext, useSearchHotkey, useSupportConversation, useSupportMessenger, useSupportMessengerOptional, useZoomPanGestures, zoomToward };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { FormEvent, KeyboardEvent, RefObject, CSSProperties, ReactNode, ComponentProps, SVGProps } from 'react';
+import { FormEvent, KeyboardEvent, RefObject, CSSProperties, ReactNode, ComponentProps, PointerEvent, Dispatch, SetStateAction, SVGProps } from 'react';
 import { LucideIcon } from 'lucide-react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
@@ -289,6 +289,70 @@ type ImageLightboxProps = {
  */
 declare function ImageLightbox({ images, index, onIndexChange, onClose, labels, }: ImageLightboxProps): React.ReactPortal;
 
+type MediaCarouselItem = {
+    kind: "image";
+    src: string;
+    alt?: string;
+} | {
+    kind: "video";
+    node: ReactNode;
+} | {
+    kind: "pdf";
+    fileUrl: string;
+    fileName: string;
+    downloadUrl?: string;
+};
+type MediaCarouselLabels = {
+    previous?: string;
+    next?: string;
+    counter?: (current: number, total: number) => string;
+};
+type MediaCarouselPdfRenderProps = {
+    fileUrl: string;
+    fileName: string;
+    downloadUrl?: string;
+};
+type MediaCarouselProps = {
+    items: MediaCarouselItem[];
+    index: number;
+    onIndexChange: (index: number) => void;
+    labels?: MediaCarouselLabels;
+    className?: string;
+    /**
+     * Slot for PDF rendering so this component can live in the root barrel
+     * without pulling pdfjs into every consumer.
+     */
+    renderPdf?: (props: MediaCarouselPdfRenderProps) => ReactNode;
+};
+/**
+ * Presentational media pane for image / video-slot / pdf items. Images use
+ * pinch/swipe gestures; video and pdf are opaque slots supplied by the
+ * consumer.
+ */
+declare function MediaCarousel({ items, index, onIndexChange, labels, className, renderPdf, }: MediaCarouselProps): React.JSX.Element | null;
+
+type MediaViewerDialogLabels = {
+    close?: string;
+    title?: string;
+    description?: string;
+};
+type MediaViewerDialogProps = {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    children: ReactNode;
+    labels?: MediaViewerDialogLabels;
+    className?: string;
+    /** Extra classes for the dialog content shell. */
+    contentClassName?: string;
+    showCloseButton?: boolean;
+};
+/**
+ * Edge-to-edge fullscreen dialog shell for media viewers (post detail, PDF,
+ * etc.). Uses the shared Radix dialog for focus trap, Esc and `aria-modal`.
+ * Pass `contentClassName` to opt into a contained desktop card when needed.
+ */
+declare function MediaViewerDialog({ open, onOpenChange, children, labels, className, contentClassName, showCloseButton, }: MediaViewerDialogProps): React.JSX.Element;
+
 type ThemeSwitcherLabels = {
     /** Tooltip label for the theme switcher */
     theme?: string;
@@ -958,6 +1022,54 @@ declare function useDebouncedValueStrict<T>(value: T, delayMs: number): T | unde
 
 declare function useMediaQuery(query: string): boolean;
 
+declare const ZOOM_PAN_MIN_SCALE = 1;
+declare const ZOOM_PAN_MAX_SCALE = 4;
+declare const ZOOM_PAN_SWIPE_COMMIT_PX = 56;
+declare const ZOOM_PAN_SWIPE_SNAP_MS = 180;
+type ZoomPanTransform = {
+    scale: number;
+    tx: number;
+    ty: number;
+};
+type SwipeDirection = "prev" | "next";
+type UseZoomPanGesturesOptions = {
+    minScale?: number;
+    maxScale?: number;
+    /** When false, horizontal swipe never commits (still pans when zoomed). */
+    swipeEnabled?: boolean;
+    onSwipeCommit?: (direction: SwipeDirection) => void;
+    /** When true, wheel zoom is attached to the stage. Defaults to true. */
+    wheelZoom?: boolean;
+    /**
+     * Double-tap behavior at min scale: "reset" (default — ImageLightbox) or
+     * "toggle" (zoom in toward tap, then reset).
+     */
+    doubleTap?: "reset" | "toggle";
+};
+type UseZoomPanGesturesResult = {
+    stageRef: RefObject<HTMLDivElement | null>;
+    transform: ZoomPanTransform;
+    isDragging: boolean;
+    snapBack: boolean;
+    handlers: {
+        onPointerDown: (e: PointerEvent<HTMLDivElement>) => void;
+        onPointerMove: (e: PointerEvent<HTMLDivElement>) => void;
+        onPointerUp: (e: PointerEvent<HTMLDivElement>) => void;
+        onPointerCancel: (e: PointerEvent<HTMLDivElement>) => void;
+    };
+    reset: () => void;
+    setScale: (scale: number) => void;
+    clearSnapBack: () => void;
+};
+declare function zoomToward(prev: ZoomPanTransform, nextScale: number, originX: number, originY: number, minScale?: number, maxScale?: number): ZoomPanTransform;
+declare function prefersReducedMotion(): boolean;
+/**
+ * Pointer-driven pinch zoom, double-tap zoom toggle/reset, pan while zoomed,
+ * and horizontal swipe-to-commit. Shared by ImageLightbox, MediaCarousel and
+ * PdfViewer.
+ */
+declare function useZoomPanGestures(options?: UseZoomPanGesturesOptions): UseZoomPanGesturesResult;
+
 type ScrollFadeXEdges = {
     canScrollLeft: boolean;
     canScrollRight: boolean;
@@ -990,6 +1102,57 @@ interface UseSearchHotkeyResult {
  */
 declare function useSearchHotkey(options?: UseSearchHotkeyOptions): UseSearchHotkeyResult;
 
+/**
+ * Like `useState`, but when the surrounding `ScrollRestorationProvider` is
+ * mounting a browser back/forward traversal, the initial state is read from
+ * an in-memory snapshot (so infinite lists paint tall enough to restore
+ * scroll). Writes back on every change. Outside a provider, degrades to
+ * plain `useState`.
+ */
+declare function useRestorableState<T>(subKey: string, initializer: () => T): [T, Dispatch<SetStateAction<T>>];
+
+type ScrollRestorationContextValue = {
+    routeKey: string;
+    /** True when this route mount is a browser back/forward traversal. */
+    isTraversal: boolean;
+    anchorAttribute: string;
+};
+declare function useScrollRestorationContext(): ScrollRestorationContextValue | null;
+type ScrollRestorationProviderProps = {
+    /** App-supplied key, typically `pathname + search`. */
+    routeKey: string;
+    /**
+     * Nested scroll container. Omit to use the document (window) scroller.
+     * Required when the app shells content inside `overflow-auto` / `overflow-y-auto`.
+     */
+    containerRef?: RefObject<HTMLElement | null>;
+    /** Attribute used to mark restore anchors. Default: `data-scroll-anchor`. */
+    anchorAttribute?: string;
+    children: ReactNode;
+};
+/**
+ * Owns per-route scroll marks: saves on scroll, resets to top on fresh
+ * navigation, and restores (with anchor alignment) on browser back/forward.
+ *
+ * Apps must supply `routeKey` from their router (`usePathname` +
+ * `useSearchParams`) so this package stays free of `next/*` imports.
+ */
+declare function ScrollRestorationProvider({ routeKey, containerRef, anchorAttribute, children, }: ScrollRestorationProviderProps): React.JSX.Element;
+
+/**
+ * Framework-free scroll-restoration store.
+ *
+ * Keeps per-route scroll marks (offset + anchor) and in-memory list snapshots
+ * so infinite-scroll pages can remount tall enough for the browser to land
+ * where the user left off. No `next/*` imports — apps supply the route key.
+ */
+type ScrollMark = {
+    top: number;
+    anchorId: string | null;
+    /** Anchor's top edge relative to the scrollport top at save time. */
+    anchorTop: number;
+};
+
 type SearchablePickerLabels = {
     placeholder?: string;
     searchPlaceholder?: string;
@@ -1501,4 +1664,4 @@ declare function useRealtimeChannel({ getWsUrl, onEvent, enabled, reconnectDelay
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AutoplayState, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, type BlocksLanguage, BrandX, type BrandXProps, Bubble, BubbleContent, BubbleGroup, BubbleReactions, type ChatListMessage, ChatMessageList, type ChatMessageListProps, ConfirmDestructiveDialog, type ConfirmDestructiveDialogProps, type ConversationKind, DEFAULT_EDITABLE_SECTION_LABELS, DataList, DataListItem, type DataListItemProps, type DataListProps, type DescribedPlaybackError, DropdownMenuItem, DropdownMenuSeparator, EditableSection, type EditableSectionLabels, type EditableSectionMode, type EditableSectionProps, type EditableSectionSlots, 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, FeedVideoPlayer, type FeedVideoPlayerProps, FieldMessage, type FieldMessageProps, 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, type MergedPlatformAccountOrg, Message, MessageAvatar, MessageComposer, type MessageComposerProps, 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, PLATFORM_ACCOUNT_ORG_COLLAPSE_AT, PaymentIcon, type PaymentIconFormat, type PaymentIconProps, PhoneInput, type PhoneInputProps, PlatformAccountMenu, type PlatformAccountMenuLabels, type PlatformAccountMenuOrg, type PlatformAccountMenuProps, type PlatformAccountMenuUrls, type PlatformAccountMenuUser, type PlatformAccountMenuVariant, PlatformNavbar, type PlatformNavbarProps, type PlaybackErrorContext, type PlaybackErrorDetail, type PlaybackErrorKind, type PlaybackState, type PlaybackStats, type ProfessionalVerificationStatus, type QualityLevel, type RealtimeEvent, type ScrollFadeXEdges, 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 UseEditableSectionOptions, type UseEditableSectionResult, type UseFeedExclusivePlaybackResult, type UseHlsPlaybackOptions, type UseHlsPlaybackResult, type UsePlaybackStatsOptions, type UseRealtimeChannelOptions, type UseSearchHotkeyOptions, type UseSearchHotkeyResult, type UseSupportConversationOptions, type UseSupportConversationResult, VerifiedProfessionalBadge, type VerifiedProfessionalBadgeProps, VideoPlayer, type VideoPlayerLabels, type VideoPlayerProps, bubbleVariants, cn, createLiveHlsConfig, createSupportChatClient, createVodHlsConfig, defaultLanguages, describeAvResync, describePlaybackError, formatPaymentCardBrand, fuzzyMatch, insertAtCaret, markerVariants, mergePlatformAccountOrgs, normalizeEmojiQuery, normalizePaymentCardBrand, paymentIconBrandFromStripe, paymentTypeFromStripeBrand, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useEditableSection, useFeedExclusivePlayback, useHlsPlayback, useLanguageContext, useMediaQuery, usePlaybackStats, useRealtimeChannel, useScrollFadeXEdges, useSearchHotkey, useSupportConversation, useSupportMessenger, useSupportMessengerOptional };
+export { type AutoplayState, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, type BlocksLanguage, BrandX, type BrandXProps, Bubble, BubbleContent, BubbleGroup, BubbleReactions, type ChatListMessage, ChatMessageList, type ChatMessageListProps, ConfirmDestructiveDialog, type ConfirmDestructiveDialogProps, type ConversationKind, DEFAULT_EDITABLE_SECTION_LABELS, DataList, DataListItem, type DataListItemProps, type DataListProps, type DescribedPlaybackError, DropdownMenuItem, DropdownMenuSeparator, EditableSection, type EditableSectionLabels, type EditableSectionMode, type EditableSectionProps, type EditableSectionSlots, 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, FeedVideoPlayer, type FeedVideoPlayerProps, FieldMessage, type FieldMessageProps, 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, MediaCarousel, type MediaCarouselItem, type MediaCarouselLabels, type MediaCarouselPdfRenderProps, type MediaCarouselProps, MediaViewerDialog, type MediaViewerDialogLabels, type MediaViewerDialogProps, type MergedPlatformAccountOrg, Message, MessageAvatar, MessageComposer, type MessageComposerProps, 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, PLATFORM_ACCOUNT_ORG_COLLAPSE_AT, PaymentIcon, type PaymentIconFormat, type PaymentIconProps, PhoneInput, type PhoneInputProps, PlatformAccountMenu, type PlatformAccountMenuLabels, type PlatformAccountMenuOrg, type PlatformAccountMenuProps, type PlatformAccountMenuUrls, type PlatformAccountMenuUser, type PlatformAccountMenuVariant, PlatformNavbar, type PlatformNavbarProps, type PlaybackErrorContext, type PlaybackErrorDetail, type PlaybackErrorKind, type PlaybackState, type PlaybackStats, type ProfessionalVerificationStatus, type QualityLevel, type RealtimeEvent, type ScrollFadeXEdges, type ScrollMark, type ScrollRestorationContextValue, ScrollRestorationProvider, type ScrollRestorationProviderProps, 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, type SwipeDirection, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, type UseEditableSectionOptions, type UseEditableSectionResult, type UseFeedExclusivePlaybackResult, type UseHlsPlaybackOptions, type UseHlsPlaybackResult, type UsePlaybackStatsOptions, type UseRealtimeChannelOptions, type UseSearchHotkeyOptions, type UseSearchHotkeyResult, type UseSupportConversationOptions, type UseSupportConversationResult, type UseZoomPanGesturesOptions, type UseZoomPanGesturesResult, VerifiedProfessionalBadge, type VerifiedProfessionalBadgeProps, VideoPlayer, type VideoPlayerLabels, type VideoPlayerProps, ZOOM_PAN_MAX_SCALE, ZOOM_PAN_MIN_SCALE, ZOOM_PAN_SWIPE_COMMIT_PX, ZOOM_PAN_SWIPE_SNAP_MS, type ZoomPanTransform, bubbleVariants, cn, createLiveHlsConfig, createSupportChatClient, createVodHlsConfig, defaultLanguages, describeAvResync, describePlaybackError, formatPaymentCardBrand, fuzzyMatch, insertAtCaret, markerVariants, mergePlatformAccountOrgs, normalizeEmojiQuery, normalizePaymentCardBrand, paymentIconBrandFromStripe, paymentTypeFromStripeBrand, prefersReducedMotion, shouldRetryLiveEdge404, useDebouncedValue, useDebouncedValueStrict, useEditableSection, useFeedExclusivePlayback, useHlsPlayback, useLanguageContext, useMediaQuery, usePlaybackStats, useRealtimeChannel, useRestorableState, useScrollFadeXEdges, useScrollRestorationContext, useSearchHotkey, useSupportConversation, useSupportMessenger, useSupportMessengerOptional, useZoomPanGestures, zoomToward };