@botiverse/raft-ui 0.26.0 → 0.28.0

package/CHANGELOG.md

@@ -1,3 +1,43 @@
+## [0.28.0](https://github.com/botiverse/raft-design/compare/v0.27.0...v0.28.0) (2026-10-23)
+
+### Design System
+
+- **Toasts: one at a time, no Dismiss, above the composer on a phone**: a toast shows alone; a new one replaces it at once and the replaced one is closed, not queued. It has no Dismiss: it closes by itself after 5 seconds, or 8 with an action or as an error, and can be swiped away or closed with Esc. It stays at the bottom center: at the bottom of the window on a desktop, and on a phone just above the composer, the tab bar or the keyboard, which the app sets with `--toast-viewport-bottom`. ([#675](https://github.com/botiverse/raft-design/pull/675))
+  - Why: stacked toasts and a × on each one asked people to manage messages that were only receipts; at the very bottom of a phone a toast sat under the composer and the keyboard (decided with stdrc).
+  - Affects: a rule for products; raft-ui's Toast defaults.
+  - Docs: https://raft-design.botiverse.build/components/toast/#where-it-appears
+
+- **Pull to refresh looks like Android's own on Android**: on Android web the indicator is Material 3's: a small disc with a shadow slides down over the list, which stays still; inside, a progress arc with an arrowhead grows with the pull, faint until the pull is armed and faint again when it is pulled back (disarmed); while refreshing the arc turns; at the end the disc scales away. iOS and everything else keep the Spinner. The disc is the one round surface besides switches, radios and grab handles, and its turning arc the one other looping animation. ([#765](https://github.com/botiverse/raft-design/pull/765))
+  - Why: a pull on Android should look the way it does in every Android app (decided by stdrc); armed and disarmed now look different.
+  - Affects: `PullToRefresh` (wip) on Android; shape, motion and navigation rules record the exception.
+  - Docs: https://raft-design.botiverse.build/components/pull-to-refresh/#on-android
+
+### Changed
+
+- **Toast defaults** ([#675](https://github.com/botiverse/raft-design/pull/675)):
+  - `limit` is 1 (was 3); a newer toast replaces the older and closes it.
+  - The command API shows `ToastClose` only with `dismissible: true`.
+  - `actionTimeout` (8s) applies to toasts with an action and to errors; `timeout` stays 5s.
+  - Bottom placements sit 16px above `max(var(--toast-viewport-bottom, 0px), env(safe-area-inset-bottom))`; `top-center` takes `--toast-viewport-top`. A toast swipes away toward the edge it came from.
+  - Migration: an app that passed its own `placement` or drew its own close can drop them; set `--toast-viewport-bottom` on a phone (from `visualViewport` while the keyboard is up on iOS).
+
+## [0.27.0](https://github.com/botiverse/raft-design/compare/v0.26.0...v0.27.0) (2026-10-23)
+
+### Design System
+
+- **Refreshing a snapshot page by pulling**: on a phone, a page that shows a snapshot and doesn't update itself (Saved, search results, a conversation's files, the lists in Settings) refreshes when pulled down past 100px; while it refreshes the indicator holds at 60px, and it snaps back in 300ms without overshoot. Pages fed by realtime updates (conversations, Home, Activity, Tasks, Members, Computers) are never pulled: they stay current on their own. On iOS a pull that passed the trigger stays armed; on Android, as in Material 3, pulling back above it takes it back, and crossing it gives a short vibration. The indicator is the Spinner on every platform. Every such page also reloads when it is opened, so the gesture is never the only way. `PullToRefresh` is experimental, from `@botiverse/raft-ui/wip`. ([#743](https://github.com/botiverse/raft-design/pull/743))
+  - Why: on a phone there was no way to ask a snapshot page for what is new without leaving it; the numbers match Raft's iOS app so the two feel the same.
+  - Affects: a rule for products; raft-ui adds `PullToRefresh` (wip).
+  - Docs: https://raft-design.botiverse.build/patterns/navigation/#refreshing
+- **A right panel grows until the area left of it is 360px**: a thread, a profile or task side panel and the side cards have no fixed maximum width (640px, 720px before); they grow until the area beside them is down to its 360px minimum. ([#759](https://github.com/botiverse/raft-design/pull/759))
+  - Why: a fixed maximum stopped them at about half of a 1280px to 1440px window, though people wanted three quarters while they worked in them.
+  - Affects: a rule for products.
+  - Docs: https://raft-design.botiverse.build/foundations/spacing/
+- **Dragging past the end snaps**: dragging the sidebar 40px past its minimum collapses it, and dragging a thread 40px past where the conversation is down to 360px puts it in focus mode, during the drag; dragging back undoes it, and the width before the snap comes back. ([#761](https://github.com/botiverse/raft-design/pull/761))
+  - Why: the jump is how people know they went past the end; 40px keeps a drag that only reaches it from snapping by accident.
+  - Affects: a rule for products.
+  - Docs: https://raft-design.botiverse.build/components/resizable/#dragging-past-the-end
+
 ## [0.26.0](https://github.com/botiverse/raft-design/compare/v0.25.0...v0.26.0) (2026-10-23)
 
 ### Design System

package/dist/{inbox-item-Cgf9IT7y.mjs → inbox-item-CfS34Ssw.mjs}

@@ -5521,6 +5521,14 @@ function Skeleton({ variant = "block", className, ...props }) {
 	});
 }
 //#endregion
+//#region src/components/virtual-list/hooks/use-latest-ref.ts
+/** A ref whose `current` is the value of the latest render. */
+function useLatestRef(value) {
+	const ref = useRef(value);
+	ref.current = value;
+	return ref;
+}
+//#endregion
 //#region src/components/inbox-item/inbox-item.recipe.ts
 const inboxItem = tv$1({
 	slots: {
@@ -5930,4 +5938,4 @@ function InboxItemActions({ className, render, reveal, ...props }) {
 	});
 }
 //#endregion
-export { MessageMultiSelect as $, PopoverTitle as $n, ListRowTitle as $r, MessageItemAvatarSlot as $t, MessageQuotedPreview as A, textLinkVariants as Ai, MobileNavServerItem as An, PanelBody as Ar, MessageItemReadReceipt as At, MessageQuotedPreviewLoading as B, useTheme as Bi, MobileNavServerPopoverRowLabel as Bn, ScrollAreaThumb as Br, MessageItemMeta as Bt, MessageListJumpPillDismiss as C, DialogSurface as Ci, PreviewCardHeader as Cn, DropdownMenuShortcut as Cr, MessageReactionTooltipMeta as Ct, MessageListHistoryLimited as D, panelToggleAction as Di, PreviewCardSeparator as Dn, Kbd as Dr, MessageReactionTooltipSeparator as Dt, MessageListEndFade as E, PanelAction as Ei, PreviewCardPortal as En, DropdownMenuTrigger as Er, MessageReactionTooltipNames as Et, MessageQuotedPreviewAuthorMeta as F, defaultNativeButton as Fi, MobileNavServerPopoverGroup as Fn, PanelSection as Fr, MessageItemDelegatedBy as Ft, MessageEmbed as G, controlIconInset as Gi, PopoverBody as Gn, ListRow as Gr, MessageItemTime as Gt, MessageQuotedPreviewThread as H, tv$1 as Hi, PopoverActions as Hn, Checkbox$1 as Hr, MessageItemSenderBadges as Ht, MessageQuotedPreviewAuthorName as I, OverlayLayerProvider as Ii, MobileNavServerPopoverList as In, ScrollArea$1 as Ir, MessageItemDelegatedByButton as It, MessageEmbedHeader as J, decisionWidth as Ji, PopoverDescription as Jn, ListRowChevron as Jr, MessageItemContent as Jt, MessageEmbedContent as K, headEdgePull as Ki, PopoverClose as Kn, ListRowBody as Kr, MessageItemAttachments as Kt, MessageQuotedPreviewChannel as L, useParentOverlayKind as Li, MobileNavServerPopoverRow as Ln, ScrollAreaContent as Lr, MessageItemDelegatedByName as Lt, MessageQuotedPreviewAttachments as M, Button$1 as Mi, MobileNavServerPopoverContent as Mn, PanelHeaderRoot as Mr, MessageItemToolbar as Mt, MessageQuotedPreviewAuthor as N, buttonVariants as Ni, MobileNavServerPopoverDestination as Nn, PanelScrollContent as Nr, MessageItemToolbarButton as Nt, MessageListNotice as O, TextLink as Oi, PreviewCardTitle as On, KbdGroup as Or, MessageItemBadge as Ot, MessageQuotedPreviewAuthorDelegatedBy as P, Spinner as Pi, MobileNavServerPopoverDestinations as Pn, PanelScrollViewport as Pr, MessageItemDelegatedAvatar as Pt, MessageTextSelectionToolbarSeparator as Q, PopoverSeparator as Qn, ListRowMeta as Qr, MessageItemSearchMatch as Qt, MessageQuotedPreviewContent as R, withOverlayLayer as Ri, MobileNavServerPopoverRowBody as Rn, ScrollAreaCorner as Rr, MessageItemHeader as Rt, MessageListJumpPill as S, DialogSheetBack as Si, PreviewCardFooter as Sn, DropdownMenuSeparator as Sr, MessageReactionTooltipContent as St, MessageListDateDivider as T, DialogTrigger as Ti, PreviewCardPopup as Tn, DropdownMenuSubmenuTrigger as Tr, MessageReactionTooltipNameText as Tt, MessageQuotedPreviewTimestamp as U, stackedActions as Ui, PopoverArrow as Un, CheckboxIndicator as Ur, MessageItemSenderButton as Ut, MessageQuotedPreviewText as V, ThemeStateContext as Vi, Popover$1 as Vn, ScrollAreaViewport as Vr, MessageItemSender as Vt, MessageQuotedPreviewUnavailable as W, useStackedActions as Wi, PopoverBackdrop as Wn, PRESENCE_COLOR as Wr, MessageItemSenderGroup as Wt, MessageTextSelectionToolbar as X, PopoverPopup as Xn, ListRowGroup as Xr, MessageItemEmbedded as Xt, messageEmbed as Y, PopoverHeader as Yn, ListRowDescription as Yr, MessageItemEdited as Yt, MessageTextSelectionToolbarButton as Z, PopoverPortal as Zn, ListRowIcon as Zr, MessageItemFooter as Zt, InboxItemTrailing as _, DialogFooterNote as _i, PreviewCardArrow as _n, DropdownMenuPopup as _r, MessageReactionGlyph as _t, InboxItemContext as a, TooltipProvider as ai, AvatarBadge as an, MobileNavLabel as ar, MessageReferenceIndicator as at, Skeleton as b, DialogOverlay as bi, PreviewCardDescription as bn, DropdownMenuRadioItem as br, MessageReactionQuickButton as bt, InboxItemLeading as c, DialogCommit as ci, AvatarGroupCount as cn, DropdownMenuCheckboxItem as cr, MessageReferenceReadMark as ct, InboxItemMetadata as d, Dialog$1 as di, measureContent as dn, DropdownMenuFooter as dr, MessageReferenceUnavailable as dt, ListRowTop as ei, MessageItemContinuationTime as en, PopoverTrigger as er, MessageMultiSelectCheckbox as et, InboxItemSelection as f, DialogBody as fi, measureElement as fn, DropdownMenuItem as fr, inlineChip as ft, InboxItemTitle as g, DialogFooter as gi, PreviewCardActions as gn, DropdownMenuLinkItem as gr, MessageReactionErrorIndicator as gt, InboxItemTimestamp as h, DialogDescription as hi, PreviewCard$1 as hn, DropdownMenuLabel as hr, MessageReactionCount as ht, InboxItemContent as i, TooltipPortal as ii, Avatar$1 as in, MobileNavItem as ir, MessageReferenceIcon as it, MessageQuotedPreviewAttachment as j, DialogSheetReset as ji, MobileNavServerPopover as jn, PanelFooter as jr, MessageItemSavedIndicator as jt, MessageList as k, TextLinkExternalIcon as ki, PreviewCardTrigger as kn, Panel as kr, MessageItemBadgeSeparator as kt, InboxItemMarks as l, DialogSheetContent as li, AvatarImage as ln, DropdownMenuCheckboxItemIndicator as lr, MessageReferenceSuffix as lt, InboxItemSubtitle as m, DialogContent as mi, readNow as mn, DropdownMenuItemLabel as mr, MessageReactionChip as mt, InboxItemActions as n, Tooltip$1 as ni, MessageItem as nn, useHoldThenMoveTouchSensor as nr, MessageMultiSelectToolbarActions as nt, InboxItemHeading as o, TooltipTrigger as oi, AvatarFallback as on, MobileNavRoot as or, MessageReferenceLabel as ot, InboxItemSender as p, DialogClose as pi, observeTruncation as pn, DropdownMenuItemCount as pr, MessageReactionAddButton as pt, MessageEmbedFooter as q, headEdges as qi, PopoverContent as qn, ListRowBottom as qr, MessageItemBody as qt, InboxItemBody as r, TooltipContent as ri, searchHit as rn, useMouseOnlyPointerSensor as rr, MessageReferenceChip as rt, InboxItemHoverTarget as s, Badge as si, AvatarGroup as sn, DropdownMenu as sr, MessageReferencePending as st, InboxItem as t, ListRowValue as ti, MessageItemGutter as tn, PopoverViewport as tr, MessageMultiSelectToolbar as tt, InboxItemMessage as u, useMobileViewport as ui, useOverflowTitle as un, DropdownMenuContent as ur, MessageReferenceText as ut, InboxItemTrigger as v, DialogHeader as vi, PreviewCardBody as vn, DropdownMenuPortal as vr, MessageReactionPickerContent as vt, MessageListJumpPillGroup as w, DialogTitle as wi, PreviewCardMeta as wn, DropdownMenuSubmenu as wr, MessageReactionTooltipName as wt, MessageListJumpControls as x, DialogPortal as xi, PreviewCardEyebrow as xn, DropdownMenuRadioItemIndicator as xr, MessageReactionQuickRow as xt, inboxItem as y, DialogNav as yi, PreviewCardContent as yn, DropdownMenuRadioGroup as yr, MessageReactionPickerStatic as yt, MessageQuotedPreviewHeader as z, useThemeScopeProps as zi, MobileNavServerPopoverRowDescription as zn, ScrollAreaScrollbar as zr, MessageItemInlineStatus as zt };
+export { MessageTextSelectionToolbarSeparator as $, PopoverSeparator as $n, ListRowMeta as $r, MessageItemSearchMatch as $t, MessageList as A, TextLinkExternalIcon as Ai, PreviewCardTrigger as An, Panel as Ar, MessageItemBadgeSeparator as At, MessageQuotedPreviewHeader as B, useThemeScopeProps as Bi, MobileNavServerPopoverRowDescription as Bn, ScrollAreaScrollbar as Br, MessageItemInlineStatus as Bt, MessageListJumpPill as C, DialogSheetBack as Ci, PreviewCardFooter as Cn, DropdownMenuSeparator as Cr, MessageReactionTooltipContent as Ct, MessageListEndFade as D, PanelAction as Di, PreviewCardPortal as Dn, DropdownMenuTrigger as Dr, MessageReactionTooltipNames as Dt, MessageListDateDivider as E, DialogTrigger as Ei, PreviewCardPopup as En, DropdownMenuSubmenuTrigger as Er, MessageReactionTooltipNameText as Et, MessageQuotedPreviewAuthorDelegatedBy as F, Spinner as Fi, MobileNavServerPopoverDestinations as Fn, PanelScrollViewport as Fr, MessageItemDelegatedAvatar as Ft, MessageQuotedPreviewUnavailable as G, useStackedActions as Gi, PopoverBackdrop as Gn, PRESENCE_COLOR as Gr, MessageItemSenderGroup as Gt, MessageQuotedPreviewText as H, ThemeStateContext as Hi, Popover$1 as Hn, ScrollAreaViewport as Hr, MessageItemSender as Ht, MessageQuotedPreviewAuthorMeta as I, defaultNativeButton as Ii, MobileNavServerPopoverGroup as In, PanelSection as Ir, MessageItemDelegatedBy as It, MessageEmbedFooter as J, headEdges as Ji, PopoverContent as Jn, ListRowBottom as Jr, MessageItemBody as Jt, MessageEmbed as K, controlIconInset as Ki, PopoverBody as Kn, ListRow as Kr, MessageItemTime as Kt, MessageQuotedPreviewAuthorName as L, OverlayLayerProvider as Li, MobileNavServerPopoverList as Ln, ScrollArea$1 as Lr, MessageItemDelegatedByButton as Lt, MessageQuotedPreviewAttachment as M, DialogSheetReset as Mi, MobileNavServerPopover as Mn, PanelFooter as Mr, MessageItemSavedIndicator as Mt, MessageQuotedPreviewAttachments as N, Button$1 as Ni, MobileNavServerPopoverContent as Nn, PanelHeaderRoot as Nr, MessageItemToolbar as Nt, MessageListHistoryLimited as O, panelToggleAction as Oi, PreviewCardSeparator as On, Kbd as Or, MessageReactionTooltipSeparator as Ot, MessageQuotedPreviewAuthor as P, buttonVariants as Pi, MobileNavServerPopoverDestination as Pn, PanelScrollContent as Pr, MessageItemToolbarButton as Pt, MessageTextSelectionToolbarButton as Q, PopoverPortal as Qn, ListRowIcon as Qr, MessageItemFooter as Qt, MessageQuotedPreviewChannel as R, useParentOverlayKind as Ri, MobileNavServerPopoverRow as Rn, ScrollAreaContent as Rr, MessageItemDelegatedByName as Rt, MessageListJumpControls as S, DialogPortal as Si, PreviewCardEyebrow as Sn, DropdownMenuRadioItemIndicator as Sr, MessageReactionQuickRow as St, MessageListJumpPillGroup as T, DialogTitle as Ti, PreviewCardMeta as Tn, DropdownMenuSubmenu as Tr, MessageReactionTooltipName as Tt, MessageQuotedPreviewThread as U, tv$1 as Ui, PopoverActions as Un, Checkbox$1 as Ur, MessageItemSenderBadges as Ut, MessageQuotedPreviewLoading as V, useTheme as Vi, MobileNavServerPopoverRowLabel as Vn, ScrollAreaThumb as Vr, MessageItemMeta as Vt, MessageQuotedPreviewTimestamp as W, stackedActions as Wi, PopoverArrow as Wn, CheckboxIndicator as Wr, MessageItemSenderButton as Wt, messageEmbed as X, PopoverHeader as Xn, ListRowDescription as Xr, MessageItemEdited as Xt, MessageEmbedHeader as Y, decisionWidth as Yi, PopoverDescription as Yn, ListRowChevron as Yr, MessageItemContent as Yt, MessageTextSelectionToolbar as Z, PopoverPopup as Zn, ListRowGroup as Zr, MessageItemEmbedded as Zt, InboxItemTrailing as _, DialogFooter as _i, PreviewCardActions as _n, DropdownMenuLinkItem as _r, MessageReactionErrorIndicator as _t, InboxItemContext as a, TooltipPortal as ai, Avatar$1 as an, MobileNavItem as ar, MessageReferenceIcon as at, useLatestRef as b, DialogNav as bi, PreviewCardContent as bn, DropdownMenuRadioGroup as br, MessageReactionPickerStatic as bt, InboxItemLeading as c, Badge as ci, AvatarGroup as cn, DropdownMenu as cr, MessageReferencePending as ct, InboxItemMetadata as d, useMobileViewport as di, useOverflowTitle as dn, DropdownMenuContent as dr, MessageReferenceText as dt, ListRowTitle as ei, MessageItemAvatarSlot as en, PopoverTitle as er, MessageMultiSelect as et, InboxItemSelection as f, Dialog$1 as fi, measureContent as fn, DropdownMenuFooter as fr, MessageReferenceUnavailable as ft, InboxItemTitle as g, DialogDescription as gi, PreviewCard$1 as gn, DropdownMenuLabel as gr, MessageReactionCount as gt, InboxItemTimestamp as h, DialogContent as hi, readNow as hn, DropdownMenuItemLabel as hr, MessageReactionChip as ht, InboxItemContent as i, TooltipContent as ii, searchHit as in, useMouseOnlyPointerSensor as ir, MessageReferenceChip as it, MessageQuotedPreview as j, textLinkVariants as ji, MobileNavServerItem as jn, PanelBody as jr, MessageItemReadReceipt as jt, MessageListNotice as k, TextLink as ki, PreviewCardTitle as kn, KbdGroup as kr, MessageItemBadge as kt, InboxItemMarks as l, DialogCommit as li, AvatarGroupCount as ln, DropdownMenuCheckboxItem as lr, MessageReferenceReadMark as lt, InboxItemSubtitle as m, DialogClose as mi, observeTruncation as mn, DropdownMenuItemCount as mr, MessageReactionAddButton as mt, InboxItemActions as n, ListRowValue as ni, MessageItemGutter as nn, PopoverViewport as nr, MessageMultiSelectToolbar as nt, InboxItemHeading as o, TooltipProvider as oi, AvatarBadge as on, MobileNavLabel as or, MessageReferenceIndicator as ot, InboxItemSender as p, DialogBody as pi, measureElement as pn, DropdownMenuItem as pr, inlineChip as pt, MessageEmbedContent as q, headEdgePull as qi, PopoverClose as qn, ListRowBody as qr, MessageItemAttachments as qt, InboxItemBody as r, Tooltip$1 as ri, MessageItem as rn, useHoldThenMoveTouchSensor as rr, MessageMultiSelectToolbarActions as rt, InboxItemHoverTarget as s, TooltipTrigger as si, AvatarFallback as sn, MobileNavRoot as sr, MessageReferenceLabel as st, InboxItem as t, ListRowTop as ti, MessageItemContinuationTime as tn, PopoverTrigger as tr, MessageMultiSelectCheckbox as tt, InboxItemMessage as u, DialogSheetContent as ui, AvatarImage as un, DropdownMenuCheckboxItemIndicator as ur, MessageReferenceSuffix as ut, InboxItemTrigger as v, DialogFooterNote as vi, PreviewCardArrow as vn, DropdownMenuPopup as vr, MessageReactionGlyph as vt, MessageListJumpPillDismiss as w, DialogSurface as wi, PreviewCardHeader as wn, DropdownMenuShortcut as wr, MessageReactionTooltipMeta as wt, Skeleton as x, DialogOverlay as xi, PreviewCardDescription as xn, DropdownMenuRadioItem as xr, MessageReactionQuickButton as xt, inboxItem as y, DialogHeader as yi, PreviewCardBody as yn, DropdownMenuPortal as yr, MessageReactionPickerContent as yt, MessageQuotedPreviewContent as z, withOverlayLayer as zi, MobileNavServerPopoverRowBody as zn, ScrollAreaCorner as zr, MessageItemHeader as zt };

package/dist/index.d.mts

@@ -3291,16 +3291,16 @@ export declare function NotificationCenterEmptyState(props: NotificationCenterEm
 declare const toastStyles: import("tailwind-variants/lite").TVReturnType<{
   placement: {
     "bottom-center": {
-      viewport: string;
+      viewport: string[];
     };
     "bottom-right": {
-      viewport: string;
+      viewport: string[];
     };
     "top-center": {
-      viewport: string;
+      viewport: string[];
     };
     "top-right": {
-      viewport: string;
+      viewport: string[];
     };
     none: {
       viewport: string;
@@ -3338,16 +3338,16 @@ declare const toastStyles: import("tailwind-variants/lite").TVReturnType<{
 }, undefined, {
   placement: {
     "bottom-center": {
-      viewport: string;
+      viewport: string[];
     };
     "bottom-right": {
-      viewport: string;
+      viewport: string[];
     };
     "top-center": {
-      viewport: string;
+      viewport: string[];
     };
     "top-right": {
-      viewport: string;
+      viewport: string[];
     };
     none: {
       viewport: string;
@@ -3385,16 +3385,16 @@ declare const toastStyles: import("tailwind-variants/lite").TVReturnType<{
 }, import("tailwind-variants/lite").TVReturnTypeLike<{
   placement: {
     "bottom-center": {
-      viewport: string;
+      viewport: string[];
     };
     "bottom-right": {
-      viewport: string;
+      viewport: string[];
     };
     "top-center": {
-      viewport: string;
+      viewport: string[];
     };
     "top-right": {
-      viewport: string;
+      viewport: string[];
     };
     none: {
       viewport: string;
@@ -3448,6 +3448,10 @@ type ToastCommandOptions<Data extends object = ToastData> = Omit<Partial<ToastOb
     onClick?: ComponentPropsWithRef<"button">["onClick"];
   };
   contentClassName?: string;
+  /**
+   * Show `ToastClose` (Dismiss). Defaults to `false`: every toast closes by
+   * itself, swipes away and closes with Esc.
+   */
   dismissible?: boolean;
   /** Show the intent's icon in `ToastIcon`. Defaults to `true`. */
   icon?: boolean;
@@ -3472,13 +3476,19 @@ export declare const toast: {
   dismiss(id?: string): void;
 };
 type ToastProviderProps = Toast.Provider.Props & {
+  /**
+   * How long a toast from the `toast` command API stays when it has an action
+   * or is an `error`, in ms. Defaults to 8000, or to `timeout` when that is
+   * longer, and to 0 when `timeout` is 0.
+   */
+  actionTimeout?: number;
   portalContainer?: Toast.Portal.Props["container"];
   renderViewport?: boolean;
   viewportClassName?: string;
   viewportPlacement?: ToastViewportProps["placement"];
   viewportStrategy?: ToastViewportProps["strategy"];
 };
-export declare function ToastProvider({ children, portalContainer, renderViewport, toastManager, timeout, viewportClassName, viewportPlacement, viewportStrategy, ...props }: ToastProviderProps): import("react").JSX.Element;
+export declare function ToastProvider({ actionTimeout, children, limit, portalContainer, renderViewport, toastManager, timeout, viewportClassName, viewportPlacement, viewportStrategy, ...props }: ToastProviderProps): import("react").JSX.Element;
 type ToastPortalProps = Toast.Portal.Props;
 export declare function ToastPortal(props: ToastPortalProps): import("react").JSX.Element;
 type ToastViewportProps = StyledProps<Toast.Viewport.Props> & Pick<VariantProps<typeof toastStyles>, "placement" | "strategy">;
@@ -3486,7 +3496,13 @@ export declare function ToastViewport({ placement, strategy, className, ...props
 type ToastPositionerProps = StyledProps<Toast.Positioner.Props>;
 export declare function ToastPositioner({ className, ...props }: ToastPositionerProps): import("react").JSX.Element;
 type ToastRootProps = StyledProps<Toast.Root.Props> & Pick<VariantProps<typeof toastStyles>, "layout">;
-export declare function ToastRoot({ layout, className, toast: toastObject, ...props }: ToastRootProps): import("react").JSX.Element;
+/**
+ * A toast pushed past the provider's `limit` by a newer one is closed, not
+ * held back: toasts replace each other and never queue, so an older toast
+ * can't come back when the newer one goes. Its swipe direction follows the
+ * viewport's edge unless `swipeDirection` is passed.
+ */
+export declare function ToastRoot({ layout, className, swipeDirection, toast: toastObject, ...props }: ToastRootProps): import("react").JSX.Element;
 type ToastContentProps = StyledProps<Toast.Content.Props> & {
   ref?: Ref<HTMLDivElement>;
 };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { cn } from "./cn.mjs";
-import { $ as MessageMultiSelect, $n as PopoverTitle, $r as ListRowTitle, $t as MessageItemAvatarSlot, A as MessageQuotedPreview, Ai as textLinkVariants, Ar as PanelBody, At as MessageItemReadReceipt, B as MessageQuotedPreviewLoading, Bi as useTheme, Br as ScrollAreaThumb, Bt as MessageItemMeta, Ci as DialogSurface, Cn as PreviewCardHeader, Cr as DropdownMenuShortcut, Ct as MessageReactionTooltipMeta, D as MessageListHistoryLimited, Di as panelToggleAction, Dn as PreviewCardSeparator, Dr as Kbd, Dt as MessageReactionTooltipSeparator, E as MessageListEndFade, Ei as PanelAction, En as PreviewCardPortal, Er as DropdownMenuTrigger, Et as MessageReactionTooltipNames, F as MessageQuotedPreviewAuthorMeta, Fi as defaultNativeButton, Fr as PanelSection, G as MessageEmbed, Gi as controlIconInset, Gr as ListRow, Gt as MessageItemTime, H as MessageQuotedPreviewThread, Hi as tv, Hr as Checkbox, Ht as MessageItemSenderBadges, I as MessageQuotedPreviewAuthorName, Ir as ScrollArea, J as MessageEmbedHeader, Ji as decisionWidth, Jn as PopoverDescription, Jr as ListRowChevron, Jt as MessageItemContent, K as MessageEmbedContent, Ki as headEdgePull, Kn as PopoverClose, Kr as ListRowBody, Kt as MessageItemAttachments, L as MessageQuotedPreviewChannel, Li as useParentOverlayKind, Lr as ScrollAreaContent, M as MessageQuotedPreviewAttachments, Mi as Button, Mr as PanelHeaderRoot, Mt as MessageItemToolbar, N as MessageQuotedPreviewAuthor, Ni as buttonVariants, Nr as PanelScrollContent, Nt as MessageItemToolbarButton, O as MessageListNotice, Oi as TextLink, On as PreviewCardTitle, Or as KbdGroup, Ot as MessageItemBadge, Pi as Spinner, Pr as PanelScrollViewport, Q as MessageTextSelectionToolbarSeparator, Qn as PopoverSeparator, Qr as ListRowMeta, Qt as MessageItemSearchMatch, R as MessageQuotedPreviewContent, Ri as withOverlayLayer, Rr as ScrollAreaCorner, Rt as MessageItemHeader, Sr as DropdownMenuSeparator, St as MessageReactionTooltipContent, T as MessageListDateDivider, Ti as DialogTrigger, Tn as PreviewCardPopup, Tr as DropdownMenuSubmenuTrigger, Tt as MessageReactionTooltipNameText, U as MessageQuotedPreviewTimestamp, Ui as stackedActions, Un as PopoverArrow, Ur as CheckboxIndicator, Ut as MessageItemSenderButton, V as MessageQuotedPreviewText, Vi as ThemeStateContext, Vn as Popover, Vr as ScrollAreaViewport, Vt as MessageItemSender, W as MessageQuotedPreviewUnavailable, Wi as useStackedActions, Wn as PopoverBackdrop, Wr as PRESENCE_COLOR, Wt as MessageItemSenderGroup, X as MessageTextSelectionToolbar, Xn as PopoverPopup, Xr as ListRowGroup, Xt as MessageItemEmbedded, Y as messageEmbed, Yn as PopoverHeader, Yr as ListRowDescription, Yt as MessageItemEdited, Z as MessageTextSelectionToolbarButton, Zn as PopoverPortal, Zr as ListRowIcon, Zt as MessageItemFooter, _ as InboxItemTrailing, _n as PreviewCardArrow, _r as DropdownMenuPopup, _t as MessageReactionGlyph, a as InboxItemContext, ai as TooltipProvider, an as AvatarBadge, ar as MobileNavLabel, at as MessageReferenceIndicator, b as Skeleton, bi as DialogOverlay, bn as PreviewCardDescription, br as DropdownMenuRadioItem, bt as MessageReactionQuickButton, c as InboxItemLeading, cn as AvatarGroupCount, cr as DropdownMenuCheckboxItem, d as InboxItemMetadata, di as Dialog, dr as DropdownMenuFooter, dt as MessageReferenceUnavailable, ei as ListRowTop, en as MessageItemContinuationTime, er as PopoverTrigger, et as MessageMultiSelectCheckbox, f as InboxItemSelection, fi as DialogBody, fr as DropdownMenuItem, ft as inlineChip, g as InboxItemTitle, gi as DialogFooter, gt as MessageReactionErrorIndicator, h as InboxItemTimestamp, hi as DialogDescription, hn as PreviewCard, hr as DropdownMenuLabel, ht as MessageReactionCount, i as InboxItemContent, ii as TooltipPortal, in as Avatar, ir as MobileNavItem, j as MessageQuotedPreviewAttachment, ji as DialogSheetReset, jr as PanelFooter, jt as MessageItemSavedIndicator, k as MessageList, ki as TextLinkExternalIcon, kn as PreviewCardTrigger, kr as Panel, kt as MessageItemBadgeSeparator, l as InboxItemMarks, ln as AvatarImage, lr as DropdownMenuCheckboxItemIndicator, lt as MessageReferenceSuffix, m as InboxItemSubtitle, mi as DialogContent, mr as DropdownMenuItemLabel, mt as MessageReactionChip, n as InboxItemActions, ni as Tooltip, nn as MessageItem, nr as useHoldThenMoveTouchSensor, nt as MessageMultiSelectToolbarActions, o as InboxItemHeading, oi as TooltipTrigger, on as AvatarFallback, or as MobileNavRoot, ot as MessageReferenceLabel, p as InboxItemSender, pi as DialogClose, pr as DropdownMenuItemCount, pt as MessageReactionAddButton, q as MessageEmbedFooter, qi as headEdges, qn as PopoverContent, qr as ListRowBottom, qt as MessageItemBody, r as InboxItemBody, ri as TooltipContent, rn as searchHit, rr as useMouseOnlyPointerSensor, rt as MessageReferenceChip, s as InboxItemHoverTarget, si as Badge, sn as AvatarGroup, sr as DropdownMenu, st as MessageReferencePending, t as InboxItem, ti as ListRowValue, tn as MessageItemGutter, tr as PopoverViewport, tt as MessageMultiSelectToolbar, u as InboxItemMessage, ui as useMobileViewport, un as useOverflowTitle, ur as DropdownMenuContent, ut as MessageReferenceText, v as InboxItemTrigger, vi as DialogHeader, vr as DropdownMenuPortal, vt as MessageReactionPickerContent, wi as DialogTitle, wr as DropdownMenuSubmenu, wt as MessageReactionTooltipName, xi as DialogPortal, xr as DropdownMenuRadioItemIndicator, xt as MessageReactionQuickRow, yi as DialogNav, yn as PreviewCardContent, yr as DropdownMenuRadioGroup, yt as MessageReactionPickerStatic, z as MessageQuotedPreviewHeader, zi as useThemeScopeProps, zr as ScrollAreaScrollbar, zt as MessageItemInlineStatus } from "./inbox-item-Cgf9IT7y.mjs";
+import { $ as MessageTextSelectionToolbarSeparator, $n as PopoverSeparator, $r as ListRowMeta, $t as MessageItemSearchMatch, A as MessageList, Ai as TextLinkExternalIcon, An as PreviewCardTrigger, Ar as Panel, At as MessageItemBadgeSeparator, B as MessageQuotedPreviewHeader, Bi as useThemeScopeProps, Br as ScrollAreaScrollbar, Bt as MessageItemInlineStatus, Cr as DropdownMenuSeparator, Ct as MessageReactionTooltipContent, D as MessageListEndFade, Di as PanelAction, Dn as PreviewCardPortal, Dr as DropdownMenuTrigger, Dt as MessageReactionTooltipNames, E as MessageListDateDivider, Ei as DialogTrigger, En as PreviewCardPopup, Er as DropdownMenuSubmenuTrigger, Et as MessageReactionTooltipNameText, Fi as Spinner, Fr as PanelScrollViewport, G as MessageQuotedPreviewUnavailable, Gi as useStackedActions, Gn as PopoverBackdrop, Gr as PRESENCE_COLOR, Gt as MessageItemSenderGroup, H as MessageQuotedPreviewText, Hi as ThemeStateContext, Hn as Popover, Hr as ScrollAreaViewport, Ht as MessageItemSender, I as MessageQuotedPreviewAuthorMeta, Ii as defaultNativeButton, Ir as PanelSection, J as MessageEmbedFooter, Ji as headEdges, Jn as PopoverContent, Jr as ListRowBottom, Jt as MessageItemBody, K as MessageEmbed, Ki as controlIconInset, Kr as ListRow, Kt as MessageItemTime, L as MessageQuotedPreviewAuthorName, Lr as ScrollArea, M as MessageQuotedPreviewAttachment, Mi as DialogSheetReset, Mr as PanelFooter, Mt as MessageItemSavedIndicator, N as MessageQuotedPreviewAttachments, Ni as Button, Nr as PanelHeaderRoot, Nt as MessageItemToolbar, O as MessageListHistoryLimited, Oi as panelToggleAction, On as PreviewCardSeparator, Or as Kbd, Ot as MessageReactionTooltipSeparator, P as MessageQuotedPreviewAuthor, Pi as buttonVariants, Pr as PanelScrollContent, Pt as MessageItemToolbarButton, Q as MessageTextSelectionToolbarButton, Qn as PopoverPortal, Qr as ListRowIcon, Qt as MessageItemFooter, R as MessageQuotedPreviewChannel, Ri as useParentOverlayKind, Rr as ScrollAreaContent, Si as DialogPortal, Sr as DropdownMenuRadioItemIndicator, St as MessageReactionQuickRow, Ti as DialogTitle, Tr as DropdownMenuSubmenu, Tt as MessageReactionTooltipName, U as MessageQuotedPreviewThread, Ui as tv, Ur as Checkbox, Ut as MessageItemSenderBadges, V as MessageQuotedPreviewLoading, Vi as useTheme, Vr as ScrollAreaThumb, Vt as MessageItemMeta, W as MessageQuotedPreviewTimestamp, Wi as stackedActions, Wn as PopoverArrow, Wr as CheckboxIndicator, Wt as MessageItemSenderButton, X as messageEmbed, Xn as PopoverHeader, Xr as ListRowDescription, Xt as MessageItemEdited, Y as MessageEmbedHeader, Yi as decisionWidth, Yn as PopoverDescription, Yr as ListRowChevron, Yt as MessageItemContent, Z as MessageTextSelectionToolbar, Zn as PopoverPopup, Zr as ListRowGroup, Zt as MessageItemEmbedded, _ as InboxItemTrailing, _i as DialogFooter, _t as MessageReactionErrorIndicator, a as InboxItemContext, ai as TooltipPortal, an as Avatar, ar as MobileNavItem, b as useLatestRef, bi as DialogNav, bn as PreviewCardContent, br as DropdownMenuRadioGroup, bt as MessageReactionPickerStatic, c as InboxItemLeading, ci as Badge, cn as AvatarGroup, cr as DropdownMenu, ct as MessageReferencePending, d as InboxItemMetadata, di as useMobileViewport, dn as useOverflowTitle, dr as DropdownMenuContent, dt as MessageReferenceText, ei as ListRowTitle, en as MessageItemAvatarSlot, er as PopoverTitle, et as MessageMultiSelect, f as InboxItemSelection, fi as Dialog, fr as DropdownMenuFooter, ft as MessageReferenceUnavailable, g as InboxItemTitle, gi as DialogDescription, gn as PreviewCard, gr as DropdownMenuLabel, gt as MessageReactionCount, h as InboxItemTimestamp, hi as DialogContent, hr as DropdownMenuItemLabel, ht as MessageReactionChip, i as InboxItemContent, ii as TooltipContent, in as searchHit, ir as useMouseOnlyPointerSensor, it as MessageReferenceChip, j as MessageQuotedPreview, ji as textLinkVariants, jr as PanelBody, jt as MessageItemReadReceipt, k as MessageListNotice, ki as TextLink, kn as PreviewCardTitle, kr as KbdGroup, kt as MessageItemBadge, l as InboxItemMarks, ln as AvatarGroupCount, lr as DropdownMenuCheckboxItem, m as InboxItemSubtitle, mi as DialogClose, mr as DropdownMenuItemCount, mt as MessageReactionAddButton, n as InboxItemActions, ni as ListRowValue, nn as MessageItemGutter, nr as PopoverViewport, nt as MessageMultiSelectToolbar, o as InboxItemHeading, oi as TooltipProvider, on as AvatarBadge, or as MobileNavLabel, ot as MessageReferenceIndicator, p as InboxItemSender, pi as DialogBody, pr as DropdownMenuItem, pt as inlineChip, q as MessageEmbedContent, qi as headEdgePull, qn as PopoverClose, qr as ListRowBody, qt as MessageItemAttachments, r as InboxItemBody, ri as Tooltip, rn as MessageItem, rr as useHoldThenMoveTouchSensor, rt as MessageMultiSelectToolbarActions, s as InboxItemHoverTarget, si as TooltipTrigger, sn as AvatarFallback, sr as MobileNavRoot, st as MessageReferenceLabel, t as InboxItem, ti as ListRowTop, tn as MessageItemContinuationTime, tr as PopoverTrigger, tt as MessageMultiSelectCheckbox, u as InboxItemMessage, un as AvatarImage, ur as DropdownMenuCheckboxItemIndicator, ut as MessageReferenceSuffix, v as InboxItemTrigger, vn as PreviewCardArrow, vr as DropdownMenuPopup, vt as MessageReactionGlyph, wi as DialogSurface, wn as PreviewCardHeader, wr as DropdownMenuShortcut, wt as MessageReactionTooltipMeta, x as Skeleton, xi as DialogOverlay, xn as PreviewCardDescription, xr as DropdownMenuRadioItem, xt as MessageReactionQuickButton, yi as DialogHeader, yr as DropdownMenuPortal, yt as MessageReactionPickerContent, z as MessageQuotedPreviewContent, zi as withOverlayLayer, zr as ScrollAreaCorner, zt as MessageItemHeader } from "./inbox-item-CfS34Ssw.mjs";
 import { Dialog as Dialog$1 } from "@base-ui/react/dialog";
 import { AlertTriangle, Bell, Check, CheckCircle2, ChevronDown, ChevronLeft, ChevronRight, CircleCheck, Copy, FileText, Image, Info, TriangleAlert, Upload, X, Zap } from "lucide-react";
 import { Children, cloneElement, createContext, createElement, isValidElement, use, useCallback, useContext, useEffect, useId, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
@@ -10143,10 +10143,10 @@ const toastStyles = tv({
 	},
 	variants: {
 		placement: {
-			"bottom-center": { viewport: "bottom-4 left-1/2 -translate-x-1/2" },
-			"bottom-right": { viewport: "right-4 bottom-4" },
-			"top-center": { viewport: "top-4 left-1/2 -translate-x-1/2" },
-			"top-right": { viewport: "top-4 right-4" },
+			"bottom-center": { viewport: ["bottom-[calc(max(var(--toast-viewport-bottom,0px),env(safe-area-inset-bottom))+1rem)]", "left-1/2 -translate-x-1/2"] },
+			"bottom-right": { viewport: ["bottom-[calc(max(var(--toast-viewport-bottom,0px),env(safe-area-inset-bottom))+1rem)]", "right-4"] },
+			"top-center": { viewport: ["top-[calc(max(var(--toast-viewport-top,0px),env(safe-area-inset-top))+1rem)]", "left-1/2 -translate-x-1/2"] },
+			"top-right": { viewport: ["top-[calc(max(var(--toast-viewport-top,0px),env(safe-area-inset-top))+1rem)]", "right-4"] },
 			none: { viewport: "contents" }
 		},
 		strategy: {
@@ -10215,7 +10215,22 @@ const toastProgressStyle = /* @__PURE__ */ jsx("style", {
 `
 });
 const DEFAULT_TOAST_TIMEOUT_MS = 5e3;
+const DEFAULT_TOAST_ACTION_TIMEOUT_MS = 8e3;
 const ToastProviderConfigContext = createContext({ timeout: DEFAULT_TOAST_TIMEOUT_MS });
+const ToastPlacementContext = createContext(void 0);
+const SWIPE_DIRECTION_BY_EDGE = {
+	top: ["up"],
+	bottom: ["down", "right"]
+};
+function getSwipeDirection(placement) {
+	if (placement?.startsWith("top-")) return [...SWIPE_DIRECTION_BY_EDGE.top];
+	if (placement?.startsWith("bottom-")) return [...SWIPE_DIRECTION_BY_EDGE.bottom];
+}
+function resolveActionTimeout(timeout, actionTimeout) {
+	if (actionTimeout !== void 0) return actionTimeout;
+	return timeout > 0 ? Math.max(timeout, DEFAULT_TOAST_ACTION_TIMEOUT_MS) : 0;
+}
+const defaultManagerTiming = { actionTimeout: DEFAULT_TOAST_ACTION_TIMEOUT_MS };
 const toastAction = tv({ slots: {
 	root: [
 		"relative order-2 inline-flex shrink-0 items-center justify-center whitespace-nowrap select-none",
@@ -10236,9 +10251,11 @@ const createToastManager = Toast.createToastManager;
 const useToastManager = Toast.useToastManager;
 const defaultToastManager = createToastManager();
 function addDefaultToast(intent, title, options = {}) {
-	const { action, contentClassName, dismissible, icon, leading, priority, progress, ...toastOptions } = options;
+	const { action, contentClassName, dismissible, icon, leading, priority, progress, timeout, ...toastOptions } = options;
+	const needsTimeToAct = Boolean(action) || intent === "error";
 	return defaultToastManager.add({
 		...toastOptions,
+		timeout: timeout ?? (needsTimeToAct ? defaultManagerTiming.actionTimeout : void 0),
 		actionProps: action ? {
 			children: action.label,
 			onClick: action.onClick
@@ -10281,13 +10298,22 @@ function getToastTone(type) {
 	if (type === "success" || type === "warning" || type === "error") return type;
 	return "info";
 }
-function ToastProvider({ children, portalContainer, renderViewport = true, toastManager = defaultToastManager, timeout = DEFAULT_TOAST_TIMEOUT_MS, viewportClassName, viewportPlacement = "bottom-center", viewportStrategy = "fixed", ...props }) {
+function ToastProvider({ actionTimeout, children, limit = 1, portalContainer, renderViewport = true, toastManager = defaultToastManager, timeout = DEFAULT_TOAST_TIMEOUT_MS, viewportClassName, viewportPlacement = "bottom-center", viewportStrategy = "fixed", ...props }) {
 	const config = useMemo(() => ({ timeout }), [timeout]);
+	const resolvedActionTimeout = resolveActionTimeout(timeout, actionTimeout);
+	useLayoutEffect(() => {
+		if (toastManager !== defaultToastManager) return;
+		defaultManagerTiming.actionTimeout = resolvedActionTimeout;
+		return () => {
+			defaultManagerTiming.actionTimeout = DEFAULT_TOAST_ACTION_TIMEOUT_MS;
+		};
+	}, [resolvedActionTimeout, toastManager]);
 	return /* @__PURE__ */ jsx(ToastProviderConfigContext.Provider, {
 		value: config,
 		children: /* @__PURE__ */ jsxs(Toast.Provider, {
 			toastManager,
 			timeout,
+			limit,
 			...props,
 			children: [children, renderViewport ? /* @__PURE__ */ jsx(DefaultToastLayer, {
 				placement: viewportPlacement,
@@ -10309,11 +10335,14 @@ function ToastViewport({ placement = "bottom-center", strategy = "fixed", classN
 		placement,
 		strategy
 	});
-	return /* @__PURE__ */ jsx(Toast.Viewport, {
-		"data-slot": "toast-viewport",
-		"data-toast-placement": placement,
-		className: viewport({ className }),
-		...props
+	return /* @__PURE__ */ jsx(ToastPlacementContext.Provider, {
+		value: placement,
+		children: /* @__PURE__ */ jsx(Toast.Viewport, {
+			"data-slot": "toast-viewport",
+			"data-toast-placement": placement,
+			className: viewport({ className }),
+			...props
+		})
 	});
 }
 function ToastPositioner({ className, ...props }) {
@@ -10324,11 +10353,28 @@ function ToastPositioner({ className, ...props }) {
 		...props
 	});
 }
-function ToastRoot({ layout = "stacked", className, toast: toastObject, ...props }) {
+/**
+* A toast pushed past the provider's `limit` by a newer one is closed, not
+* held back: toasts replace each other and never queue, so an older toast
+* can't come back when the newer one goes. Its swipe direction follows the
+* viewport's edge unless `swipeDirection` is passed.
+*/
+function ToastRoot({ layout = "stacked", className, swipeDirection, toast: toastObject, ...props }) {
 	const { root } = toastStyles({ layout });
+	const placement = useContext(ToastPlacementContext);
+	const { close } = useToastManager();
+	const replaced = toastObject.limited === true && toastObject.transitionStatus !== "ending";
+	useLayoutEffect(() => {
+		if (replaced) close(toastObject.id);
+	}, [
+		close,
+		replaced,
+		toastObject.id
+	]);
 	return /* @__PURE__ */ jsx(Toast.Root, {
 		"data-slot": "toast",
 		"data-toast-type": toastObject.type ?? "info",
+		swipeDirection: swipeDirection ?? getSwipeDirection(placement),
 		toast: toastObject,
 		className: root({ className }),
 		...props
@@ -10504,29 +10550,24 @@ function DefaultToastLayer({ placement, portalContainer, strategy, viewportClass
 			placement,
 			strategy,
 			className: viewportClassName,
-			children: /* @__PURE__ */ jsx(DefaultToastList, { placement })
+			children: /* @__PURE__ */ jsx(DefaultToastList, {})
 		})
 	});
 }
-function DefaultToastList({ placement }) {
+function DefaultToastList() {
 	const { toasts } = useToastManager();
-	return toasts.map((toastObject) => /* @__PURE__ */ jsx(DefaultToastItem, {
-		placement,
-		toast: toastObject
-	}, toastObject.id));
+	return toasts.map((toastObject) => /* @__PURE__ */ jsx(DefaultToastItem, { toast: toastObject }, toastObject.id));
 }
-const TOP_SWIPE_DIRECTION = ["up", "right"];
-function DefaultToastItem({ placement, toast: toastObject }) {
+function DefaultToastItem({ toast: toastObject }) {
 	const { timeout } = useContext(ToastProviderConfigContext);
 	const showDescription = Boolean(toastObject.description);
 	const showAction = Boolean(toastObject.actionProps?.children);
-	const showClose = toastObject.data?.hasClose !== false;
+	const showClose = toastObject.data?.hasClose === true;
 	const showIcon = hasLeading(toastObject) || toastObject.data?.hasIcon !== false;
 	const progressDuration = toastObject.timeout ?? timeout;
 	const showProgress = toastObject.data?.hasProgress === true && toastObject.type !== "loading" && progressDuration > 0;
 	return /* @__PURE__ */ jsx(ToastRoot, {
 		toast: toastObject,
-		swipeDirection: placement.startsWith("top-") ? TOP_SWIPE_DIRECTION : void 0,
 		children: /* @__PURE__ */ jsxs(ToastContent, {
 			className: toastObject.data?.contentClassName,
 			children: [
@@ -12973,14 +13014,6 @@ function useEventCallback(fn) {
 	return useCallback((...args) => fnRef.current(...args), []);
 }
 //#endregion
-//#region src/components/virtual-list/hooks/use-latest-ref.ts
-/** A ref whose `current` is the value of the latest render. */
-function useLatestRef(value) {
-	const ref = useRef(value);
-	ref.current = value;
-	return ref;
-}
-//#endregion
 //#region src/components/virtual-list/hooks/use-layout-effect-with-previous.ts
 /**
 * `useLayoutEffect(() => fn(previousDeps), deps)`: the layout-effect form of useMemoWithPrevious;

package/dist/wip.d.mts

@@ -604,4 +604,106 @@ export declare function OverlayLayerProvider({ kind, modal, children }: OverlayL
  */
 export declare function useParentOverlayKind(): OverlayLayerKind | null;
 //#endregion
-export { Dialog as AnnouncementDialog, DialogClose as AnnouncementDialogClose, DialogTrigger as AnnouncementDialogTrigger, type ComboboxSelectGroup, type ComboboxSelectMessages, type ComboboxSelectOption, type ComboboxSelectProps, type ComboboxSelectSelection, type ComboboxSelectValue, type CommentCardMetaProps, type CommentCardProps, type CommentCardQuoteProps, type CommentCardTriggerProps, type CommentEntryAuthorProps, type CommentEntryBodyProps, type CommentEntryHeaderProps, type CommentEntryProps, type CommentEntryTimeProps, type CommentMarginItemProps, type CommentMarginLayout, type CommentMarginLayoutItem, type CommentMarginLayoutOptions, type CommentMarginProps, type CommentMarkerProps, DialogCommit, type DialogCommitProps, DialogFooterNote, type DialogFooterNoteProps, DialogSheetBack, type DialogSheetBackProps, DialogSheetContent, type DialogSheetContentProps, DropdownMenuLinkItem, type DropdownMenuLinkItemProps, type EllipsisProps, type EllipsisState, type EllipsisToggleProps, type HoldThenMoveOptions, type InboxItemLeadingBadgeProps, type InboxItemSkeletonListProps, type InboxItemSkeletonProps, type ListRowSkeletonProps, MessageItemDelegatedAvatar, type MessageItemDelegatedAvatarProps, MessageItemDelegatedBy, MessageItemDelegatedByButton, type MessageItemDelegatedByButtonProps, MessageItemDelegatedByName, type MessageItemDelegatedByNameProps, type MessageItemDelegatedByProps, MessageListJumpControls, type MessageListJumpControlsProps, MessageListJumpPill, MessageListJumpPillDismiss, type MessageListJumpPillDismissProps, MessageListJumpPillGroup, type MessageListJumpPillGroupProps, type MessageListJumpPillProps, MessageQuotedPreviewAuthorDelegatedBy, type MessageQuotedPreviewAuthorDelegatedByProps, MessageReferenceIcon, type MessageReferenceIconProps, MessageReferenceReadMark, type MessageReferenceReadMarkProps, type MeterHeaderProps, type MeterIndicatorProps, type MeterLabelProps, type MeterProps, type MeterTrackProps, type MeterValueProps, MobileNavServerItem, type MobileNavServerItemProps, MobileNavServerPopover, MobileNavServerPopoverContent, type MobileNavServerPopoverContentProps, MobileNavServerPopoverDestination, type MobileNavServerPopoverDestinationProps, MobileNavServerPopoverDestinations, type MobileNavServerPopoverDestinationsProps, MobileNavServerPopoverGroup, type MobileNavServerPopoverGroupProps, MobileNavServerPopoverList, type MobileNavServerPopoverListProps, type MobileNavServerPopoverProps, MobileNavServerPopoverRow, MobileNavServerPopoverRowBody, type MobileNavServerPopoverRowBodyProps, MobileNavServerPopoverRowDescription, type MobileNavServerPopoverRowDescriptionProps, MobileNavServerPopoverRowLabel, type MobileNavServerPopoverRowLabelProps, type MobileNavServerPopoverRowProps, type OverlayLayerKind, type OverlayLayerProviderProps, PopoverActions, type PopoverActionsProps, PopoverBody, type PopoverBodyProps, PreviewCardActions, type PreviewCardActionsProps, PreviewCardBody, type PreviewCardBodyProps, PreviewCardEyebrow, type PreviewCardEyebrowProps, PreviewCardFooter, type PreviewCardFooterProps, PreviewCardMeta, type PreviewCardMetaProps, type UseCommentMarginFitsOptions };
+//#region src/components/pull-to-refresh/pull-to-refresh-gesture.d.ts
+/**
+ * The pull-to-refresh gesture as a pure state machine (pull-to-refresh.md,
+ * "Behavior"). `usePullToRefresh` feeds it the scroller's touch events; this
+ * file owns every decision, so the rules can be tested without a DOM.
+ */
+/** How far the indicator has to be pulled, after damping, for a release to refresh. */
+export declare const PULL_TO_REFRESH_THRESHOLD = 100;
+/**
+ * The furthest the indicator follows the finger. 40px past the threshold is
+ * enough to show the pull is armed and still going; any further and a long
+ * drag would push the list off a small phone's screen.
+ */
+export declare const PULL_TO_REFRESH_MAX_DISTANCE = 140;
+/** The indicator's height while the refresh runs. */
+export declare const PULL_TO_REFRESH_HOLD_DISTANCE = 60;
+/**
+ * The rubber band: the indicator moves this fraction of the finger's travel,
+ * so it lags and the pull reads as resistance. 0.55 is iOS's own
+ * scroll-view constant.
+ */
+export declare const PULL_TO_REFRESH_DAMPING = 0.55;
+/**
+ * How long the indicator takes to go back, to the hold height or to 0, once
+ * the finger lifts or the refresh ends: ease-out (`ease-slide`), with no
+ * overshoot. Instant with reduced motion.
+ */
+export declare const PULL_TO_REFRESH_SNAP_BACK_MS = 300;
+type PullToRefreshState = "idle" | "pulling" | "refreshing";
+//#endregion
+//#region src/components/pull-to-refresh/use-pull-to-refresh.d.ts
+/** A primary pointer that is a finger: the only input pull to refresh answers. */
+export declare const PULL_TO_REFRESH_POINTER_QUERY = "(pointer: coarse)";
+/**
+ * How the pull looks. `default` (iOS and every other touch screen), as in
+ * the iOS app: the content moves down with the pull and the indicator sits in
+ * the space it opens. `android` follows Material 3: the indicator travels
+ * down over the content, which stays still, arming the pull gives a short
+ * vibration, and moving back above the threshold disarms it (no latch).
+ */
+type PullToRefreshPlatform = "default" | "android";
+type UsePullToRefreshOptions = {
+  /**
+   * Reload the page's snapshot. The indicator holds until the promise
+   * settles. Handle a failure here (keep the content, show the same toast as
+   * a failed first load): a rejection only ends the refresh.
+   */
+  onRefresh: () => Promise<unknown>;
+  /** Turn the gesture off, such as while the first load is still running or a search is empty. */
+  disabled?: boolean;
+  /** Pull distance, after damping, that arms the refresh. Default 100px. */
+  threshold?: number;
+  /** The furthest the indicator follows the finger. Default 140px. */
+  maxDistance?: number;
+  /** The indicator's height while refreshing. Default 60px. */
+  holdDistance?: number;
+  /** Override the detected platform, such as in a preview. */
+  platform?: PullToRefreshPlatform;
+};
+type PullToRefresh = {
+  /** `idle`, `pulling` while a finger pulls the indicator down, `refreshing` until `onRefresh` settles. */
+  state: PullToRefreshState;
+  /** The indicator's height in px. */
+  distance: number;
+  /** How far towards the threshold the pull is, from 0 to 1; 1 once armed and while refreshing. */
+  progress: number;
+  /** Which platform's look the indicator takes. */
+  platform: PullToRefreshPlatform;
+};
+/**
+ * Pull to refresh for a scroll container on a touch screen
+ * (pull-to-refresh.md). Pulling down from the top of `scrollRef` past the
+ * threshold calls `onRefresh`; render a `PullToRefreshIndicator` with the
+ * result as the scroller's first child.
+ *
+ * On Android it takes Material 3's look (`PullToRefreshPlatform`). It does
+ * nothing on a fine pointer. While it is on, the scroller gets
+ * `overscroll-behavior-y: contain`, so a browser tab's own pull to reload
+ * doesn't run as well. `scrollRef` is read when the hook turns on; a
+ * scroller that is replaced later needs the hook remounted (a `key`).
+ */
+export declare function usePullToRefresh(scrollRef: RefObject<HTMLElement | null>, { onRefresh, disabled, threshold, maxDistance, holdDistance, platform: platformOverride }: UsePullToRefreshOptions): PullToRefresh;
+//#endregion
+//#region src/components/pull-to-refresh/pull-to-refresh-indicator.d.ts
+type PullToRefreshIndicatorProps = Omit<ComponentProps<"div">, "children"> & {
+  /** The result of `usePullToRefresh`. */
+  pull: PullToRefresh;
+  /**
+   * What a screen reader announces when the refresh starts, such as
+   * "Refreshing…". Product copy, so it comes from the consumer.
+   */
+  label: string;
+};
+/**
+ * The pull's indicator. Render it as the scroller's first child: by default
+ * it is the space the pull opens, with the DS Spinner in it, so the content
+ * moves down with the pull; on Android it is Material 3's own indicator, a
+ * disc with a progress arc that travels down over the content. It holds a
+ * polite live region that announces `label` while refreshing.
+ */
+export declare function PullToRefreshIndicator({ pull, label, className, style, ...props }: PullToRefreshIndicatorProps): import("react").JSX.Element;
+//#endregion
+export { Dialog as AnnouncementDialog, DialogClose as AnnouncementDialogClose, DialogTrigger as AnnouncementDialogTrigger, type ComboboxSelectGroup, type ComboboxSelectMessages, type ComboboxSelectOption, type ComboboxSelectProps, type ComboboxSelectSelection, type ComboboxSelectValue, type CommentCardMetaProps, type CommentCardProps, type CommentCardQuoteProps, type CommentCardTriggerProps, type CommentEntryAuthorProps, type CommentEntryBodyProps, type CommentEntryHeaderProps, type CommentEntryProps, type CommentEntryTimeProps, type CommentMarginItemProps, type CommentMarginLayout, type CommentMarginLayoutItem, type CommentMarginLayoutOptions, type CommentMarginProps, type CommentMarkerProps, DialogCommit, type DialogCommitProps, DialogFooterNote, type DialogFooterNoteProps, DialogSheetBack, type DialogSheetBackProps, DialogSheetContent, type DialogSheetContentProps, DropdownMenuLinkItem, type DropdownMenuLinkItemProps, type EllipsisProps, type EllipsisState, type EllipsisToggleProps, type HoldThenMoveOptions, type InboxItemLeadingBadgeProps, type InboxItemSkeletonListProps, type InboxItemSkeletonProps, type ListRowSkeletonProps, MessageItemDelegatedAvatar, type MessageItemDelegatedAvatarProps, MessageItemDelegatedBy, MessageItemDelegatedByButton, type MessageItemDelegatedByButtonProps, MessageItemDelegatedByName, type MessageItemDelegatedByNameProps, type MessageItemDelegatedByProps, MessageListJumpControls, type MessageListJumpControlsProps, MessageListJumpPill, MessageListJumpPillDismiss, type MessageListJumpPillDismissProps, MessageListJumpPillGroup, type MessageListJumpPillGroupProps, type MessageListJumpPillProps, MessageQuotedPreviewAuthorDelegatedBy, type MessageQuotedPreviewAuthorDelegatedByProps, MessageReferenceIcon, type MessageReferenceIconProps, MessageReferenceReadMark, type MessageReferenceReadMarkProps, type MeterHeaderProps, type MeterIndicatorProps, type MeterLabelProps, type MeterProps, type MeterTrackProps, type MeterValueProps, MobileNavServerItem, type MobileNavServerItemProps, MobileNavServerPopover, MobileNavServerPopoverContent, type MobileNavServerPopoverContentProps, MobileNavServerPopoverDestination, type MobileNavServerPopoverDestinationProps, MobileNavServerPopoverDestinations, type MobileNavServerPopoverDestinationsProps, MobileNavServerPopoverGroup, type MobileNavServerPopoverGroupProps, MobileNavServerPopoverList, type MobileNavServerPopoverListProps, type MobileNavServerPopoverProps, MobileNavServerPopoverRow, MobileNavServerPopoverRowBody, type MobileNavServerPopoverRowBodyProps, MobileNavServerPopoverRowDescription, type MobileNavServerPopoverRowDescriptionProps, MobileNavServerPopoverRowLabel, type MobileNavServerPopoverRowLabelProps, type MobileNavServerPopoverRowProps, type OverlayLayerKind, type OverlayLayerProviderProps, PopoverActions, type PopoverActionsProps, PopoverBody, type PopoverBodyProps, PreviewCardActions, type PreviewCardActionsProps, PreviewCardBody, type PreviewCardBodyProps, PreviewCardEyebrow, type PreviewCardEyebrowProps, PreviewCardFooter, type PreviewCardFooterProps, PreviewCardMeta, type PreviewCardMetaProps, type PullToRefresh, type PullToRefreshIndicatorProps, type PullToRefreshPlatform, type PullToRefreshState, type UseCommentMarginFitsOptions, type UsePullToRefreshOptions };

package/dist/wip.mjs

@@ -1,4 +1,4 @@
-import { $r as ListRowTitle, An as MobileNavServerItem, Bi as useTheme, Bn as MobileNavServerPopoverRowLabel, C as MessageListJumpPillDismiss, Fi as defaultNativeButton, Fn as MobileNavServerPopoverGroup, Ft as MessageItemDelegatedBy, Gn as PopoverBody, Gr as ListRow, Hi as tv, Hn as PopoverActions, Ii as OverlayLayerProvider, In as MobileNavServerPopoverList, It as MessageItemDelegatedByButton, Kr as ListRowBody, Li as useParentOverlayKind, Ln as MobileNavServerPopoverRow, Lt as MessageItemDelegatedByName, Mi as Button$1, Mn as MobileNavServerPopoverContent, Nn as MobileNavServerPopoverDestination, Oi as TextLink, P as MessageQuotedPreviewAuthorDelegatedBy, Pn as MobileNavServerPopoverDestinations, Pt as MessageItemDelegatedAvatar, Qr as ListRowMeta, Rn as MobileNavServerPopoverRowBody, S as MessageListJumpPill, Si as DialogSheetBack, Sn as PreviewCardFooter, Ti as DialogTrigger, Yr as ListRowDescription, _ as InboxItemTrailing, _i as DialogFooterNote, a as InboxItemContext, b as Skeleton, c as InboxItemLeading, ci as DialogCommit, ct as MessageReferenceReadMark, di as Dialog, dn as measureContent, ei as ListRowTop, fn as measureElement, g as InboxItemTitle, gn as PreviewCardActions, gr as DropdownMenuLinkItem, h as InboxItemTimestamp, i as InboxItemContent, it as MessageReferenceIcon, jn as MobileNavServerPopover, li as DialogSheetContent, mi as DialogContent, mn as readNow, ni as Tooltip, nr as useHoldThenMoveTouchSensor, o as InboxItemHeading, oi as TooltipTrigger, pi as DialogClose, pn as observeTruncation, qr as ListRowBottom, r as InboxItemBody, ri as TooltipContent, t as InboxItem, un as useOverflowTitle, vn as PreviewCardBody, w as MessageListJumpPillGroup, wi as DialogTitle, wn as PreviewCardMeta, x as MessageListJumpControls, xn as PreviewCardEyebrow, y as inboxItem, zi as useThemeScopeProps, zn as MobileNavServerPopoverRowDescription } from "./inbox-item-Cgf9IT7y.mjs";
+import { $r as ListRowMeta, Bi as useThemeScopeProps, Bn as MobileNavServerPopoverRowDescription, C as MessageListJumpPill, Ci as DialogSheetBack, Cn as PreviewCardFooter, Ei as DialogTrigger, F as MessageQuotedPreviewAuthorDelegatedBy, Fi as Spinner, Fn as MobileNavServerPopoverDestinations, Ft as MessageItemDelegatedAvatar, Ii as defaultNativeButton, In as MobileNavServerPopoverGroup, It as MessageItemDelegatedBy, Jr as ListRowBottom, Kn as PopoverBody, Kr as ListRow, Li as OverlayLayerProvider, Ln as MobileNavServerPopoverList, Lt as MessageItemDelegatedByButton, Mn as MobileNavServerPopover, Ni as Button$1, Nn as MobileNavServerPopoverContent, Pn as MobileNavServerPopoverDestination, Ri as useParentOverlayKind, Rn as MobileNavServerPopoverRow, Rt as MessageItemDelegatedByName, S as MessageListJumpControls, Sn as PreviewCardEyebrow, T as MessageListJumpPillGroup, Ti as DialogTitle, Tn as PreviewCardMeta, Ui as tv, Un as PopoverActions, Vi as useTheme, Vn as MobileNavServerPopoverRowLabel, Xr as ListRowDescription, _ as InboxItemTrailing, _n as PreviewCardActions, _r as DropdownMenuLinkItem, a as InboxItemContext, at as MessageReferenceIcon, b as useLatestRef, c as InboxItemLeading, dn as useOverflowTitle, ei as ListRowTitle, fi as Dialog, fn as measureContent, g as InboxItemTitle, h as InboxItemTimestamp, hi as DialogContent, hn as readNow, i as InboxItemContent, ii as TooltipContent, jn as MobileNavServerItem, ki as TextLink, li as DialogCommit, lt as MessageReferenceReadMark, mi as DialogClose, mn as observeTruncation, o as InboxItemHeading, pn as measureElement, qr as ListRowBody, r as InboxItemBody, ri as Tooltip, rr as useHoldThenMoveTouchSensor, si as TooltipTrigger, t as InboxItem, ti as ListRowTop, ui as DialogSheetContent, vi as DialogFooterNote, w as MessageListJumpPillDismiss, x as Skeleton, y as inboxItem, yn as PreviewCardBody, zn as MobileNavServerPopoverRowBody } from "./inbox-item-CfS34Ssw.mjs";
 import { Check, ChevronDown, LoaderCircle, Plus, X } from "lucide-react";
 import { createContext, use, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -1750,4 +1750,581 @@ function MeterIndicator({ className, ...props }) {
 	});
 }
 //#endregion
-export { Dialog as AnnouncementDialog, AnnouncementDialogAction, AnnouncementDialogBody, DialogClose as AnnouncementDialogClose, AnnouncementDialogContent, AnnouncementDialogFooter, AnnouncementDialogHeader, AnnouncementDialogLabel, AnnouncementDialogPicture, AnnouncementDialogSecondaryAction, AnnouncementDialogText, AnnouncementDialogTitle, DialogTrigger as AnnouncementDialogTrigger, COMMENT_HIGHLIGHT, COMMENT_HIGHLIGHT_ACTIVE, ComboboxSelect, CommentCard, CommentCardMeta, CommentCardQuote, CommentCardTrigger, CommentEntry, CommentEntryAuthor, CommentEntryBody, CommentEntryHeader, CommentEntryTime, CommentMargin, CommentMarginItem, CommentMarker, DialogCommit, DialogFooterNote, DialogSheetBack, DialogSheetContent, DropdownMenuLinkItem, Ellipsis, EllipsisToggle, InboxItemLeadingBadge, InboxItemSkeleton, InboxItemSkeletonList, ListRowSkeleton, MessageItemDelegatedAvatar, MessageItemDelegatedBy, MessageItemDelegatedByButton, MessageItemDelegatedByName, MessageListJumpControls, MessageListJumpPill, MessageListJumpPillDismiss, MessageListJumpPillGroup, MessageQuotedPreviewAuthorDelegatedBy, MessageReferenceIcon, MessageReferenceReadMark, Meter, MeterHeader, MeterIndicator, MeterLabel, MeterTrack, MeterValue, MobileNavServerItem, MobileNavServerPopover, MobileNavServerPopoverContent, MobileNavServerPopoverDestination, MobileNavServerPopoverDestinations, MobileNavServerPopoverGroup, MobileNavServerPopoverList, MobileNavServerPopoverRow, MobileNavServerPopoverRowBody, MobileNavServerPopoverRowDescription, MobileNavServerPopoverRowLabel, OverlayLayerProvider, PopoverActions, PopoverBody, PreviewCardActions, PreviewCardBody, PreviewCardEyebrow, PreviewCardFooter, PreviewCardMeta, resolveCommentMarginLayout, setCommentHighlights, useCommentMarginFits, useHoldThenMoveTouchSensor, useParentOverlayKind, useTruncated };
+//#region src/components/pull-to-refresh/pull-to-refresh-gesture.ts
+/**
+* The pull-to-refresh gesture as a pure state machine (pull-to-refresh.md,
+* "Behavior"). `usePullToRefresh` feeds it the scroller's touch events; this
+* file owns every decision, so the rules can be tested without a DOM.
+*/
+/** How far the indicator has to be pulled, after damping, for a release to refresh. */
+const PULL_TO_REFRESH_THRESHOLD = 100;
+/**
+* The furthest the indicator follows the finger. 40px past the threshold is
+* enough to show the pull is armed and still going; any further and a long
+* drag would push the list off a small phone's screen.
+*/
+const PULL_TO_REFRESH_MAX_DISTANCE = 140;
+/** The indicator's height while the refresh runs. */
+const PULL_TO_REFRESH_HOLD_DISTANCE = 60;
+/**
+* The rubber band: the indicator moves this fraction of the finger's travel,
+* so it lags and the pull reads as resistance. 0.55 is iOS's own
+* scroll-view constant.
+*/
+const PULL_TO_REFRESH_DAMPING = .55;
+/**
+* How long the indicator takes to go back, to the hold height or to 0, once
+* the finger lifts or the refresh ends: ease-out (`ease-slide`), with no
+* overshoot. Instant with reduced motion.
+*/
+const PULL_TO_REFRESH_SNAP_BACK_MS = 300;
+/** A finger held this long before it pulls is a long press (a menu, a drag), not a pull. */
+const PULL_TO_REFRESH_LONG_PRESS_MS = 500;
+/** How far the finger may drift while it could still be a long press. */
+const PULL_TO_REFRESH_TOLERANCE = 10;
+/** Where a touch must not start a pull: text entry, and anything the consumer marks. */
+const PULL_TO_REFRESH_IGNORE_SELECTOR = [
+	"input",
+	"textarea",
+	"select",
+	"[contenteditable=\"\"]",
+	"[contenteditable=\"true\"]",
+	"[contenteditable=\"plaintext-only\"]",
+	"[data-pull-to-refresh-ignore]"
+].join(", ");
+const DEFAULT_PULL_GESTURE_CONFIG = {
+	threshold: 100,
+	maxDistance: 140,
+	holdDistance: 60,
+	latch: true
+};
+const IDLE_PULL_GESTURE = {
+	phase: "idle",
+	startX: 0,
+	startY: 0,
+	distance: 0,
+	armed: false
+};
+/** How far the indicator is for a finger that has travelled `delta` px down. */
+function pullDistance(delta, maxDistance = 140) {
+	if (delta <= 0) return 0;
+	return Math.min(maxDistance, delta * PULL_TO_REFRESH_DAMPING);
+}
+/** How far towards the threshold the pull is, from 0 to 1. */
+function pullProgress(distance, threshold = 100) {
+	if (threshold <= 0) return 1;
+	return Math.min(1, Math.max(0, distance / threshold));
+}
+/**
+* Which of the spinner's 4 pixels is lit while pulling, clockwise from the
+* top left: one step per quarter of the threshold, the last from the
+* threshold on (the same walk as the native apps' indicator).
+*/
+function pullStep(progress) {
+	return Math.min(3, Math.floor(Math.max(0, progress) * 4));
+}
+/** The state the indicator shows for a gesture. */
+function pullState(gesture) {
+	if (gesture.phase === "refreshing") return "refreshing";
+	if (gesture.phase !== "pulling") return "idle";
+	return gesture.distance > 0 || gesture.armed ? "pulling" : "idle";
+}
+function step(gesture, preventDefault = false, refresh = false, armed = false) {
+	return {
+		gesture,
+		preventDefault,
+		refresh,
+		armed
+	};
+}
+/** The next gesture for an event. */
+function stepPullGesture(gesture, event, config = DEFAULT_PULL_GESTURE_CONFIG) {
+	if (gesture.phase === "refreshing") return step(event.type === "settle" ? IDLE_PULL_GESTURE : gesture);
+	switch (event.type) {
+		case "start":
+			if (event.fingers !== 1 || !event.atTop || event.ignored) return step(IDLE_PULL_GESTURE);
+			return step({
+				...IDLE_PULL_GESTURE,
+				phase: "tracking",
+				startX: event.x,
+				startY: event.y
+			});
+		case "move": {
+			if (gesture.phase === "idle") return step(gesture);
+			if (event.fingers !== 1) return step(IDLE_PULL_GESTURE);
+			if (!event.atTop && !gesture.armed) return step(IDLE_PULL_GESTURE);
+			const dx = event.x - gesture.startX;
+			const dy = event.y - gesture.startY;
+			if (gesture.phase === "tracking") {
+				if (Math.abs(dx) > PULL_TO_REFRESH_TOLERANCE && Math.abs(dx) > dy) return step(IDLE_PULL_GESTURE);
+				if (dy < -6) return step(IDLE_PULL_GESTURE);
+				if (dy <= 6) return step(gesture);
+			}
+			const distance = pullDistance(dy, config.maxDistance);
+			const armed = config.latch && gesture.armed || distance >= config.threshold;
+			return step({
+				...gesture,
+				phase: "pulling",
+				distance,
+				armed
+			}, armed || dy > 6, false, armed && !gesture.armed);
+		}
+		case "hold": return step(gesture.phase === "tracking" ? IDLE_PULL_GESTURE : gesture);
+		case "end":
+			if (gesture.phase === "pulling" && gesture.armed) return step({
+				...gesture,
+				phase: "refreshing",
+				distance: config.holdDistance
+			}, false, true);
+			return step(IDLE_PULL_GESTURE);
+		case "cancel":
+		case "settle": return step(IDLE_PULL_GESTURE);
+	}
+}
+//#endregion
+//#region src/components/pull-to-refresh/use-pull-to-refresh.ts
+/** A primary pointer that is a finger: the only input pull to refresh answers. */
+const PULL_TO_REFRESH_POINTER_QUERY = "(pointer: coarse)";
+/** The one platform check: Android, by its user agent (Client Hints first). */
+function detectPullToRefreshPlatform() {
+	if (typeof navigator === "undefined") return "default";
+	const hints = navigator.userAgentData;
+	if (hints?.platform) return hints.platform === "Android" ? "android" : "default";
+	return /\bAndroid\b/i.test(navigator.userAgent) ? "android" : "default";
+}
+function hapticTick() {
+	if (typeof navigator !== "undefined" && typeof navigator.vibrate === "function") navigator.vibrate(10);
+}
+const subscribeNever = () => () => void 0;
+const defaultSnapshot = () => "default";
+function subscribeCoarse(onChange) {
+	if (typeof window === "undefined" || typeof window.matchMedia !== "function") return () => void 0;
+	const media = window.matchMedia(PULL_TO_REFRESH_POINTER_QUERY);
+	media.addEventListener("change", onChange);
+	return () => media.removeEventListener("change", onChange);
+}
+function coarseSnapshot() {
+	return typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia("(pointer: coarse)").matches;
+}
+function ignoredTarget(target) {
+	return target instanceof Element && target.closest(PULL_TO_REFRESH_IGNORE_SELECTOR) !== null;
+}
+/**
+* Pull to refresh for a scroll container on a touch screen
+* (pull-to-refresh.md). Pulling down from the top of `scrollRef` past the
+* threshold calls `onRefresh`; render a `PullToRefreshIndicator` with the
+* result as the scroller's first child.
+*
+* On Android it takes Material 3's look (`PullToRefreshPlatform`). It does
+* nothing on a fine pointer. While it is on, the scroller gets
+* `overscroll-behavior-y: contain`, so a browser tab's own pull to reload
+* doesn't run as well. `scrollRef` is read when the hook turns on; a
+* scroller that is replaced later needs the hook remounted (a `key`).
+*/
+function usePullToRefresh(scrollRef, { onRefresh, disabled = false, threshold = DEFAULT_PULL_GESTURE_CONFIG.threshold, maxDistance = DEFAULT_PULL_GESTURE_CONFIG.maxDistance, holdDistance = DEFAULT_PULL_GESTURE_CONFIG.holdDistance, platform: platformOverride }) {
+	const coarse = useSyncExternalStore(subscribeCoarse, coarseSnapshot, () => false);
+	const detected = useSyncExternalStore(subscribeNever, detectPullToRefreshPlatform, defaultSnapshot);
+	const platform = platformOverride ?? detected;
+	const enabled = coarse && !disabled;
+	const [gesture, setGesture] = useState(IDLE_PULL_GESTURE);
+	const gestureRef = useRef(IDLE_PULL_GESTURE);
+	const onRefreshRef = useLatestRef(onRefresh);
+	useEffect(() => {
+		const element = scrollRef.current;
+		if (!enabled || !element) return;
+		const config = {
+			threshold,
+			maxDistance,
+			holdDistance,
+			latch: platform !== "android"
+		};
+		let holdTimer;
+		let live = true;
+		const dispatch = (event, native) => {
+			const next = stepPullGesture(gestureRef.current, event, config);
+			if (next.preventDefault && native?.cancelable) native.preventDefault();
+			if (next.gesture !== gestureRef.current) {
+				gestureRef.current = next.gesture;
+				setGesture(next.gesture);
+			}
+			if (next.gesture.phase !== "tracking") clearTimeout(holdTimer);
+			if (next.armed && platform === "android") hapticTick();
+			if (next.refresh) {
+				const settle = () => {
+					if (live) dispatch({ type: "settle" });
+				};
+				let result;
+				try {
+					result = Promise.resolve(onRefreshRef.current());
+				} catch (error) {
+					result = Promise.reject(error);
+				}
+				result.then(settle, settle);
+			}
+		};
+		const atTop = () => element.scrollTop <= 0;
+		const onTouchStart = (event) => {
+			const touch = event.touches[0];
+			dispatch({
+				type: "start",
+				x: touch?.clientX ?? 0,
+				y: touch?.clientY ?? 0,
+				fingers: event.touches.length,
+				atTop: atTop(),
+				ignored: ignoredTarget(event.target)
+			});
+			if (gestureRef.current.phase === "tracking") {
+				clearTimeout(holdTimer);
+				holdTimer = setTimeout(() => dispatch({ type: "hold" }), PULL_TO_REFRESH_LONG_PRESS_MS);
+			}
+		};
+		const onTouchMove = (event) => {
+			if (event.defaultPrevented && gestureRef.current.phase === "tracking") {
+				dispatch({ type: "cancel" });
+				return;
+			}
+			const touch = event.touches[0];
+			dispatch({
+				type: "move",
+				x: touch?.clientX ?? 0,
+				y: touch?.clientY ?? 0,
+				fingers: event.touches.length,
+				atTop: atTop()
+			}, event);
+		};
+		const onTouchEnd = () => dispatch({ type: "end" });
+		const onCancel = () => dispatch({ type: "cancel" });
+		const previousOverscroll = element.style.overscrollBehaviorY;
+		element.style.overscrollBehaviorY = "contain";
+		element.addEventListener("touchstart", onTouchStart, { passive: true });
+		element.addEventListener("touchmove", onTouchMove, { passive: false });
+		element.addEventListener("touchend", onTouchEnd, { passive: true });
+		element.addEventListener("touchcancel", onCancel, { passive: true });
+		element.addEventListener("contextmenu", onCancel);
+		element.addEventListener("dragstart", onCancel);
+		return () => {
+			live = false;
+			clearTimeout(holdTimer);
+			element.style.overscrollBehaviorY = previousOverscroll;
+			element.removeEventListener("touchstart", onTouchStart);
+			element.removeEventListener("touchmove", onTouchMove);
+			element.removeEventListener("touchend", onTouchEnd);
+			element.removeEventListener("touchcancel", onCancel);
+			element.removeEventListener("contextmenu", onCancel);
+			element.removeEventListener("dragstart", onCancel);
+			gestureRef.current = IDLE_PULL_GESTURE;
+			setGesture(IDLE_PULL_GESTURE);
+		};
+	}, [
+		enabled,
+		scrollRef,
+		onRefreshRef,
+		threshold,
+		maxDistance,
+		holdDistance,
+		platform
+	]);
+	const state = pullState(gesture);
+	const distance = state === "idle" ? 0 : gesture.distance;
+	return {
+		state,
+		distance,
+		progress: state === "refreshing" || gesture.armed ? 1 : pullProgress(distance, threshold),
+		platform
+	};
+}
+//#endregion
+//#region src/components/pull-to-refresh/pull-to-refresh-material-progress.tsx
+/**
+* Android's own pull-to-refresh progress, drawn as Material 3 draws it
+* (Compose's `PullToRefreshDefaults.Indicator`, the one Chrome on Android
+* shows too): a 2.5px arc of radius 7.5px in a 40px disc. While pulling the
+* arc grows to 0.8 of the circle and turns a little with the pull, with an
+* arrowhead at its end, at 0.3 opacity until the pull is armed and fully
+* opaque from then on. While refreshing it is Material's indeterminate arc,
+* which grows and shrinks as it turns. Internal: `PullToRefreshIndicator`
+* renders it on Android.
+*/
+/** The disc's centre, in its 40px box. */
+const CENTER = 20;
+const MATERIAL_ARC_RADIUS = 7.5;
+const MATERIAL_STROKE_WIDTH = 2.5;
+const ARROW_WIDTH = 10;
+const ARROW_HEIGHT = 5;
+/** The longest the arc gets while pulling, as a share of the circle. */
+const MATERIAL_MAX_ARC = .8;
+const CIRCUMFERENCE = 2 * Math.PI * MATERIAL_ARC_RADIUS;
+/**
+* The arc for a pull's progress (0 to 1), as Material computes it: nothing
+* for the first 40%, then the arc grows to `MATERIAL_MAX_ARC` of the circle
+* and its start turns from -45° to +27° (12 o'clock is -90°), and the
+* arrowhead grows with it.
+*/
+function materialArc(progress) {
+	const adjusted = Math.max(Math.min(1, progress) - .4, 0) * 5 / 3;
+	const rotation = (-.25 + .4 * adjusted) * .5;
+	return {
+		startAngle: rotation * 360,
+		endAngle: (rotation + adjusted * MATERIAL_MAX_ARC) * 360,
+		arrowScale: Math.min(1, adjusted)
+	};
+}
+const point = (degrees) => {
+	const radians = degrees * Math.PI / 180;
+	return `${CENTER + MATERIAL_ARC_RADIUS * Math.cos(radians)} ${CENTER + MATERIAL_ARC_RADIUS * Math.sin(radians)}`;
+};
+/** An SVG path for the arc, clockwise from `startAngle` to `endAngle`. */
+function arcPath({ startAngle, endAngle }) {
+	const sweep = endAngle - startAngle;
+	if (sweep <= .01) return "";
+	const large = sweep > 180 ? 1 : 0;
+	return `M ${point(startAngle)} A ${MATERIAL_ARC_RADIUS} ${MATERIAL_ARC_RADIUS} 0 ${large} 1 ${point(endAngle)}`;
+}
+/**
+* The arrowhead: a triangle whose base straddles the arc at 3 o'clock and
+* whose tip points clockwise, turned to the arc's end.
+*/
+function arrowPoints(scale) {
+	const half = ARROW_WIDTH * scale / 2;
+	const base = 17.5;
+	const x = 27.5;
+	return `${x - half},${base} ${x + half},${base} ${x},${base + ARROW_HEIGHT * scale}`;
+}
+const MATERIAL_STYLE = `
+@keyframes raft-ptr-material-rotate {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+@keyframes raft-ptr-material-dash {
+  0% {
+    stroke-dasharray: 0.4 ${CIRCUMFERENCE};
+    stroke-dashoffset: 0;
+  }
+  50% {
+    stroke-dasharray: ${CIRCUMFERENCE * .7} ${CIRCUMFERENCE};
+    stroke-dashoffset: ${-CIRCUMFERENCE * .1};
+  }
+  100% {
+    stroke-dasharray: ${CIRCUMFERENCE * .7} ${CIRCUMFERENCE};
+    stroke-dashoffset: ${-CIRCUMFERENCE * .99};
+  }
+}
+
+[data-slot="pull-to-refresh-material-progress"][data-state="refreshing"] {
+  animation: raft-ptr-material-rotate 1.4s linear infinite;
+}
+
+[data-slot="pull-to-refresh-material-progress"][data-state="refreshing"] [data-material-indeterminate] {
+  animation: raft-ptr-material-dash 1.4s ease-in-out infinite;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [data-slot="pull-to-refresh-material-progress"][data-state="refreshing"],
+  [data-slot="pull-to-refresh-material-progress"][data-state="refreshing"] [data-material-indeterminate] {
+    animation: none;
+  }
+
+  [data-slot="pull-to-refresh-material-progress"][data-state="refreshing"] [data-material-indeterminate] {
+    stroke-dasharray: ${CIRCUMFERENCE * .75} ${CIRCUMFERENCE};
+  }
+}
+`;
+const materialStyle = /* @__PURE__ */ jsx("style", {
+	href: "raft-ui-pull-to-refresh-material",
+	precedence: "default",
+	children: MATERIAL_STYLE
+});
+const materialProgress = tv({ slots: {
+	root: ["size-10 shrink-0 overflow-visible", "text-info-strong"],
+	determinate: ["transition-opacity duration-150 ease-out motion-reduce:transition-none", "opacity-30 data-armed:opacity-100"],
+	arc: ["fill-none stroke-current [stroke-linecap:butt]"],
+	arrow: ["fill-current"],
+	indeterminate: ["fill-none stroke-current [stroke-linecap:round]"]
+} });
+function PullToRefreshMaterialProgress({ state, progress }) {
+	const { root, determinate, arc, arrow, indeterminate } = materialProgress();
+	const refreshing = state === "refreshing";
+	const armed = progress >= 1;
+	const values = materialArc(refreshing ? 1 : progress);
+	return /* @__PURE__ */ jsxs("svg", {
+		"data-slot": "pull-to-refresh-material-progress",
+		"data-state": state,
+		"data-armed": !refreshing && armed ? "" : void 0,
+		viewBox: "0 0 40 40",
+		"aria-hidden": "true",
+		className: root(),
+		children: [materialStyle, refreshing ? /* @__PURE__ */ jsx("circle", {
+			"data-material-indeterminate": "",
+			cx: CENTER,
+			cy: CENTER,
+			r: MATERIAL_ARC_RADIUS,
+			strokeWidth: MATERIAL_STROKE_WIDTH,
+			transform: `rotate(-90 ${CENTER} ${CENTER})`,
+			className: indeterminate()
+		}) : /* @__PURE__ */ jsxs("g", {
+			"data-armed": armed ? "" : void 0,
+			className: determinate(),
+			children: [/* @__PURE__ */ jsx("path", {
+				"data-material-arc": "",
+				d: arcPath(values),
+				strokeWidth: MATERIAL_STROKE_WIDTH,
+				className: arc()
+			}), values.arrowScale > 0 && /* @__PURE__ */ jsx("polygon", {
+				"data-material-arrow": "",
+				points: arrowPoints(values.arrowScale),
+				transform: `rotate(${values.endAngle - 2.5} ${CENTER} ${CENTER})`,
+				className: arrow()
+			})]
+		})]
+	});
+}
+//#endregion
+//#region src/components/pull-to-refresh/pull-to-refresh-indicator.tsx
+const pullStepStyle = /* @__PURE__ */ jsx("style", {
+	href: "raft-ui-pull-to-refresh",
+	precedence: "default",
+	children: `
+[data-slot="pull-to-refresh-indicator"][data-pull-step] [data-spinner-pixel],
+[data-slot="pull-to-refresh-indicator"][data-state="idle"] [data-spinner-pixel] {
+  animation: none;
+  opacity: 0.2;
+}
+
+[data-slot="pull-to-refresh-indicator"][data-pull-step="0"] [data-spinner-pixel]:nth-child(1),
+[data-slot="pull-to-refresh-indicator"][data-pull-step="1"] [data-spinner-pixel]:nth-child(2),
+[data-slot="pull-to-refresh-indicator"][data-pull-step="2"] [data-spinner-pixel]:nth-child(4),
+[data-slot="pull-to-refresh-indicator"][data-pull-step="3"] [data-spinner-pixel]:nth-child(3) {
+  opacity: 1;
+}
+`
+});
+const SNAP_BACK = ["duration-300 ease-slide motion-reduce:transition-none", "data-[state=pulling]:transition-none"];
+const pullToRefreshIndicator = tv({
+	slots: {
+		root: ["flex w-full shrink-0 justify-center", "text-foreground-icon"],
+		surface: ["flex items-center justify-center"],
+		spinner: [
+			"transition-opacity duration-300 ease-slide motion-reduce:transition-none",
+			"in-data-[state=pulling]:transition-none",
+			"in-data-[state=pulling]:opacity-(--pull-progress) in-data-[state=idle]:opacity-0"
+		],
+		status: ["sr-only"]
+	},
+	variants: { platform: {
+		default: {
+			root: [
+				"relative items-center overflow-hidden",
+				"transition-[height]",
+				...SNAP_BACK
+			],
+			surface: ["size-full"]
+		},
+		android: {
+			root: ["sticky top-0 z-10 h-0 overflow-visible"],
+			surface: [
+				"absolute inset-x-0 top-0 mx-auto size-10 rounded-full bg-layer-popover shadow-float",
+				"translate-y-[calc(var(--pull-distance)-100%)]",
+				"transition-[translate,opacity,scale]",
+				...SNAP_BACK,
+				"data-[state=idle]:opacity-0",
+				"data-[exit=finish]:scale-0 data-[exit=finish]:duration-150 data-[exit=finish]:ease-out"
+			]
+		}
+	} },
+	defaultVariants: { platform: "default" }
+});
+/**
+* How the Android disc leaves once idle: `finish` when a refresh has just
+* ended (it scales down where it held), `cancel` otherwise (it slides back
+* up). The finish keeps the distance it held, so it doesn't also slide.
+* `gone` once the scale-down has ended: the disc stays scaled away and its
+* arc stops turning.
+*/
+function useAndroidExit(state, distance) {
+	const [previous, setPrevious] = useState(state);
+	const [exit, setExit] = useState({
+		kind: "cancel",
+		distance: 0
+	});
+	const [held, setHeld] = useState(distance);
+	if (state !== previous) {
+		setPrevious(state);
+		if (state === "idle") setExit(previous === "refreshing" ? {
+			kind: "finish",
+			distance: held
+		} : {
+			kind: "cancel",
+			distance: 0
+		});
+	}
+	if (state === "refreshing" && distance !== held) setHeld(distance);
+	const settle = () => {
+		if (exit.kind === "finish") setExit({
+			...exit,
+			kind: "gone"
+		});
+	};
+	return {
+		...exit,
+		settle
+	};
+}
+/**
+* The pull's indicator. Render it as the scroller's first child: by default
+* it is the space the pull opens, with the DS Spinner in it, so the content
+* moves down with the pull; on Android it is Material 3's own indicator, a
+* disc with a progress arc that travels down over the content. It holds a
+* polite live region that announces `label` while refreshing.
+*/
+function PullToRefreshIndicator({ pull, label, className, style, ...props }) {
+	const { state, distance, progress, platform } = pull;
+	const { root, surface, spinner, status } = pullToRefreshIndicator({ platform });
+	const android = platform === "android";
+	const exit = useAndroidExit(state, distance);
+	const finishing = android && state === "idle" && exit.kind !== "cancel";
+	return /* @__PURE__ */ jsxs("div", {
+		"data-slot": "pull-to-refresh-indicator",
+		"data-state": state,
+		"data-platform": platform,
+		"data-pull-step": !android && state === "pulling" ? pullStep(progress) : void 0,
+		className: root({ className }),
+		style: {
+			...style,
+			height: android ? void 0 : distance,
+			["--pull-progress"]: progress,
+			["--pull-distance"]: `${finishing ? exit.distance : distance}px`
+		},
+		...props,
+		children: [
+			!android && pullStepStyle,
+			/* @__PURE__ */ jsx("div", {
+				"data-slot": "pull-to-refresh-surface",
+				"data-state": state,
+				"data-exit": finishing ? "finish" : void 0,
+				className: surface(),
+				onTransitionEnd: (event) => {
+					if (event.target === event.currentTarget && event.propertyName === "scale") exit.settle();
+				},
+				children: android ? /* @__PURE__ */ jsx(PullToRefreshMaterialProgress, {
+					state: finishing && exit.kind === "finish" ? "refreshing" : state,
+					progress
+				}) : /* @__PURE__ */ jsx(Spinner, {
+					"aria-hidden": "true",
+					role: "presentation",
+					"aria-label": void 0,
+					className: spinner()
+				})
+			}),
+			/* @__PURE__ */ jsx("span", {
+				role: "status",
+				"aria-live": "polite",
+				className: status(),
+				children: state === "refreshing" ? label : ""
+			})
+		]
+	});
+}
+//#endregion
+export { Dialog as AnnouncementDialog, AnnouncementDialogAction, AnnouncementDialogBody, DialogClose as AnnouncementDialogClose, AnnouncementDialogContent, AnnouncementDialogFooter, AnnouncementDialogHeader, AnnouncementDialogLabel, AnnouncementDialogPicture, AnnouncementDialogSecondaryAction, AnnouncementDialogText, AnnouncementDialogTitle, DialogTrigger as AnnouncementDialogTrigger, COMMENT_HIGHLIGHT, COMMENT_HIGHLIGHT_ACTIVE, ComboboxSelect, CommentCard, CommentCardMeta, CommentCardQuote, CommentCardTrigger, CommentEntry, CommentEntryAuthor, CommentEntryBody, CommentEntryHeader, CommentEntryTime, CommentMargin, CommentMarginItem, CommentMarker, DialogCommit, DialogFooterNote, DialogSheetBack, DialogSheetContent, DropdownMenuLinkItem, Ellipsis, EllipsisToggle, InboxItemLeadingBadge, InboxItemSkeleton, InboxItemSkeletonList, ListRowSkeleton, MessageItemDelegatedAvatar, MessageItemDelegatedBy, MessageItemDelegatedByButton, MessageItemDelegatedByName, MessageListJumpControls, MessageListJumpPill, MessageListJumpPillDismiss, MessageListJumpPillGroup, MessageQuotedPreviewAuthorDelegatedBy, MessageReferenceIcon, MessageReferenceReadMark, Meter, MeterHeader, MeterIndicator, MeterLabel, MeterTrack, MeterValue, MobileNavServerItem, MobileNavServerPopover, MobileNavServerPopoverContent, MobileNavServerPopoverDestination, MobileNavServerPopoverDestinations, MobileNavServerPopoverGroup, MobileNavServerPopoverList, MobileNavServerPopoverRow, MobileNavServerPopoverRowBody, MobileNavServerPopoverRowDescription, MobileNavServerPopoverRowLabel, OverlayLayerProvider, PULL_TO_REFRESH_DAMPING, PULL_TO_REFRESH_HOLD_DISTANCE, PULL_TO_REFRESH_MAX_DISTANCE, PULL_TO_REFRESH_POINTER_QUERY, PULL_TO_REFRESH_SNAP_BACK_MS, PULL_TO_REFRESH_THRESHOLD, PopoverActions, PopoverBody, PreviewCardActions, PreviewCardBody, PreviewCardEyebrow, PreviewCardFooter, PreviewCardMeta, PullToRefreshIndicator, resolveCommentMarginLayout, setCommentHighlights, useCommentMarginFits, useHoldThenMoveTouchSensor, useParentOverlayKind, usePullToRefresh, useTruncated };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/raft-ui",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "React components and CSS foundations for the Raft Design System.",
   "keywords": [
     "agent-skills",