@botiverse/raft-ui 0.35.1 → 0.36.0

package/dist/styles.css

@@ -174,6 +174,10 @@
 }
 
 @theme inline {
+  /* A drag settling: the drop and cancel glide, siblings sliding apart, a
+     layout reflowing on a drop (design/foundations/motion.md). */
+  --ease-drag-settle: var(--motion-drag-settle-easing);
+
   --color-foreground: var(--foreground);
   --color-foreground-muted: var(--foreground-muted);
   --color-foreground-hint: var(--foreground-hint);
@@ -659,6 +663,34 @@ textarea:-webkit-autofill:disabled {
   }
 }
 
+/* Drag and drop (design/patterns/drag-and-drop.md). While something is
+   lifted, DragLift sets data-dragging on the root, and DragRefusalHint sets
+   data-drag-refused while the place under the hand refuses it: the cursor
+   says so over everything, whatever the element under it would show. The
+   item a drag came from carries data-drag-origin and stays in place at 40%
+   until something else takes its place, and a container it has moved into
+   carries data-drag-into. Unlayered, so no utility on the
+   item overrides the one value. */
+:root[data-dragging],
+:root[data-dragging] * {
+  cursor: grabbing !important;
+}
+
+:root[data-drag-refused],
+:root[data-drag-refused] * {
+  cursor: not-allowed !important;
+}
+
+[data-drag-origin] {
+  opacity: 0.4;
+}
+
+/* A container the dragged item has moved into (another sidebar section, a
+   row it drops onto) takes the subtle hover tier while the item is in it. */
+[data-drag-into] {
+  background-color: var(--fill-subtle);
+}
+
 @utility image-transparency-bg {
   --checker-cell: light-dark(oklch(0.1813 0.00497 17.62 / 0.12), oklch(1 0 0 / 0.1));
   background-color: light-dark(oklch(1 0 0), oklch(0.23 0 0));

package/dist/tokens.json

@@ -2530,6 +2530,20 @@
       }
     }
   },
+  "motion": {
+    "drag-settle-duration": {
+      "$type": "duration",
+      "$value": { "value": 160, "unit": "ms" },
+      "$description": "A drag settling: the lifted copy gliding into its place on a drop or back home on a cancel, siblings sliding apart to open the place, and a layout reflowing on a drop.",
+      "$extensions": { "build.botiverse.raft": { "scope": "root" } }
+    },
+    "drag-settle-easing": {
+      "$type": "cubicBezier",
+      "$value": [0.25, 1, 0.5, 1],
+      "$description": "The ease-out of drag-settle-duration: fast off the hand, slow into place.",
+      "$extensions": { "build.botiverse.raft": { "scope": "root" } }
+    }
+  },
   "focus": {
     "$type": "shadow",
     "ring": {

package/dist/wip.d.mts

@@ -1,9 +1,10 @@
-import { $i as MobileNavServerPopoverDestinationProps, $s as DialogTitleProps, B as MessageListJumpPill, C as InboxItemProps, Ca as PopoverBodyProps, Cs as DialogCommitProps, Es as Dialog, G as MessageListJumpPillProps, H as MessageListJumpPillDismissProps, Is as DialogFooterNote, Ji as MobileNavServerItemProps, Js as DialogSheetBack, Jt as MessageReferenceIcon, Ls as DialogFooterNoteProps, Ms as DialogContentProps, Qi as MobileNavServerPopoverDestination, R as MessageListJumpControls, Sa as PopoverBody, Ss as DialogCommit, Ti as PreviewCardMetaProps, Ts as DialogSheetContentProps, U as MessageListJumpPillGroup, V as MessageListJumpPillDismiss, W as MessageListJumpPillGroupProps, Xi as MobileNavServerPopoverContent, Yi as MobileNavServerPopover, Ys as DialogSheetBackProps, Yt as MessageReferenceIconProps, Zi as MobileNavServerPopoverContentProps, _a as PopoverActionsProps, aa as MobileNavServerPopoverListProps, ac as ButtonProps, ar as MessageItemDelegatedByButtonProps, bi as PreviewCardFooter, bs as TextLinkProps, ca as MobileNavServerPopoverRowBody, ci as PreviewCardActions, cr as MessageItemDelegatedByProps, ct as MessageQuotedPreviewAuthorDelegatedBy, da as MobileNavServerPopoverRowDescriptionProps, dc as StyledProps, ea as MobileNavServerPopoverDestinations, ec as DialogTrigger, fa as MobileNavServerPopoverRowLabel, fi as PreviewCardBody, ga as PopoverActions, ho as DropdownMenuLinkItemProps, ia as MobileNavServerPopoverList, ir as MessageItemDelegatedByButton, ks as DialogClose, la as MobileNavServerPopoverRowBodyProps, lc as VariantProps, li as PreviewCardActionsProps, ls as ListRowProps, lt as MessageQuotedPreviewAuthorDelegatedByProps, ma as MobileNavServerPopoverRowProps, mo as DropdownMenuLinkItem, na as MobileNavServerPopoverGroup, nn as MessageReferenceReadMark, nr as MessageItemDelegatedAvatarProps, oa as MobileNavServerPopoverProps, or as MessageItemDelegatedByName, pa as MobileNavServerPopoverRowLabelProps, pi as PreviewCardBodyProps, qi as MobileNavServerItem, ra as MobileNavServerPopoverGroupProps, rn as MessageReferenceReadMarkProps, rr as MessageItemDelegatedBy, sa as MobileNavServerPopoverRow, sr as MessageItemDelegatedByNameProps, ta as MobileNavServerPopoverDestinationsProps, tr as MessageItemDelegatedAvatar, u as InboxItemDensity, ua as MobileNavServerPopoverRowDescription, uc as DataAttributes, vi as PreviewCardEyebrow, wi as PreviewCardMeta, ws as DialogSheetContent, xi as PreviewCardFooterProps, yi as PreviewCardEyebrowProps, z as MessageListJumpControlsProps } from "./inbox-item-CQJIhaym.mjs";
+import { $ as MessageListJumpPillProps, Aa as PopoverBody, As as DialogCommit, B as DragMessages, Bs as DialogContentProps, C as InboxItemProps, Co as DropdownMenuLinkItemProps, Di as PreviewCardEyebrowProps, Ei as PreviewCardEyebrow, G as dragMessages, Gs as DialogFooterNoteProps, H as DragPlace, J as MessageListJumpPill, K as MessageListJumpControls, Ls as DialogClose, Mi as PreviewCardMeta, Ms as DialogSheetContent, Ni as PreviewCardMetaProps, Ns as DialogSheetContentProps, Oi as PreviewCardFooter, Os as TextLinkProps, Ps as Dialog, Q as MessageListJumpPillGroupProps, R as DEFAULT_DRAG_MESSAGES, Sa as MobileNavServerPopoverRowProps, So as DropdownMenuLinkItem, Ta as PopoverActionsProps, U as createDragAnnouncements, V as DragNamed, W as dragInstructions, Ws as DialogFooterNote, X as MessageListJumpPillDismissProps, Y as MessageListJumpPillDismiss, Z as MessageListJumpPillGroup, _a as MobileNavServerPopoverRowBodyProps, _c as VariantProps, _i as PreviewCardActionsProps, _s as ListRowProps, _t as MessageQuotedPreviewAuthorDelegatedByProps, aa as MobileNavServerPopoverContentProps, ba as MobileNavServerPopoverRowLabel, bi as PreviewCardBody, ca as MobileNavServerPopoverDestinations, cc as DialogTrigger, da as MobileNavServerPopoverGroupProps, dn as MessageReferenceReadMarkProps, dr as MessageItemDelegatedBy, fa as MobileNavServerPopoverList, fr as MessageItemDelegatedByButton, ga as MobileNavServerPopoverRowBody, gi as PreviewCardActions, gr as MessageItemDelegatedByProps, gt as MessageQuotedPreviewAuthorDelegatedBy, ha as MobileNavServerPopoverRow, hr as MessageItemDelegatedByNameProps, ia as MobileNavServerPopoverContent, ja as PopoverBodyProps, js as DialogCommitProps, ki as PreviewCardFooterProps, la as MobileNavServerPopoverDestinationsProps, lr as MessageItemDelegatedAvatar, ma as MobileNavServerPopoverProps, mr as MessageItemDelegatedByName, na as MobileNavServerItemProps, nc as DialogSheetBack, nn as MessageReferenceIcon, oa as MobileNavServerPopoverDestination, pa as MobileNavServerPopoverListProps, pc as ButtonProps, pr as MessageItemDelegatedByButtonProps, q as MessageListJumpControlsProps, ra as MobileNavServerPopover, rc as DialogSheetBackProps, rn as MessageReferenceIconProps, sa as MobileNavServerPopoverDestinationProps, sc as DialogTitleProps, ta as MobileNavServerItem, u as InboxItemDensity, ua as MobileNavServerPopoverGroup, un as MessageReferenceReadMark, ur as MessageItemDelegatedAvatarProps, va as MobileNavServerPopoverRowDescription, vc as DataAttributes, wa as PopoverActions, xa as MobileNavServerPopoverRowLabelProps, xi as PreviewCardBodyProps, ya as MobileNavServerPopoverRowDescriptionProps, yc as StyledProps, z as DragAnnouncementSource } from "./inbox-item-B8eXIikq.mjs";
 import { CSSProperties, ComponentProps, ComponentPropsWithRef, PointerEvent, ReactNode, RefObject } from "react";
 import { Button } from "@base-ui/react/button";
 import { useRender } from "@base-ui/react/use-render";
-import { PointerSensor, TouchSensor, TouchSensorOptions } from "@dnd-kit/core";
+import { Announcements, CollisionDetection, DragEndEvent, DragOverEvent, DragStartEvent, DropAnimation, KeyboardCoordinateGetter, KeyboardSensorOptions, Modifier, PointerSensor, PointerSensorOptions, ScreenReaderInstructions, TouchSensor, TouchSensorOptions, UniqueIdentifier } from "@dnd-kit/core";
 import { Combobox } from "@base-ui/react/combobox";
+import { SortingStrategy } from "@dnd-kit/sortable";
 import { Meter as Meter$1 } from "@base-ui/react/meter";
 //#region src/components/combobox-select/combobox-select.types.d.ts
 type ComboboxSelectValue = string | number;
@@ -290,6 +291,8 @@ export declare function useCommentMarginFits(element: Element | null, { minWidth
  * touch on its distance and this sensor would never run.
  */
 export declare const TOUCH_DRAG_HOLD_MS = 500;
+export declare const TOUCH_DRAG_DISTANCE_PX = 10;
+export declare const TOUCH_DRAG_TOLERANCE_PX = 10;
 type HoldThenMoveOptions = {
   /** How long the finger stays still before a move can start the drag. */
   holdMs?: number;
@@ -298,12 +301,340 @@ type HoldThenMoveOptions = {
   /** How far the finger may drift during the hold before it counts as a scroll. */
   tolerance?: number;
 };
+/** A TouchSensor that starts a drag on the first move after a still hold (see above). */
+export declare const HoldThenMoveTouchSensor: typeof TouchSensor;
+/**
+ * dnd-kit's PointerSensor for a mouse and a pen only: a finger's pointerdown is
+ * left to `HoldThenMoveTouchSensor`.
+ */
+export declare class MouseOnlyPointerSensor extends PointerSensor {
+  static activators: {
+    eventName: "onPointerDown";
+    handler: (event: PointerEvent, options: PointerSensorOptions) => boolean;
+  }[];
+}
 /**
  * `useSensor(HoldThenMoveTouchSensor, …)` with the activation the sensor relies
  * on: no constraint dnd-kit would act on by itself, so only a move after the
  * hold starts the drag.
  */
 export declare function useHoldThenMoveTouchSensor({ holdMs, distance, tolerance }?: HoldThenMoveOptions): import("@dnd-kit/core").SensorDescriptor<TouchSensorOptions>;
+/** The mouse / pen sensor that goes with it: picks up after `distance` px. */
+export declare function useMouseOnlyPointerSensor(distance: number): import("@dnd-kit/core").SensorDescriptor<{
+  activationConstraint: {
+    distance: number;
+  };
+}>;
+//#endregion
+//#region src/components/drag/drag-sensors.d.ts
+/**
+ * A mouse or a pen picks an item up once it has moved this far, so a click
+ * never moves anything (design/patterns/drag-and-drop.md#starting-a-drag).
+ */
+export declare const MOUSE_DRAG_DISTANCE_PX = 6;
+/**
+ * Space picks up and drops, Escape puts back, the arrow keys move. Enter
+ * never starts a drag: on an item that can also be opened or activated, Enter
+ * does that.
+ */
+export declare const DRAG_KEYBOARD_CODES: NonNullable<KeyboardSensorOptions["keyboardCodes"]>;
+type DragSensorsOptions = {
+  /**
+   * How the arrow keys move a lifted item. Defaults to
+   * `listKeyboardCoordinates`, which steps through a sortable list.
+   */
+  coordinateGetter?: KeyboardCoordinateGetter;
+  /** Leave the keyboard out, for a surface whose keyboard path is a button. */
+  keyboard?: boolean;
+  /** The touch hold, distance and tolerance; the defaults are the system's. */
+  touch?: HoldThenMoveOptions;
+};
+/**
+ * The one sensor set for everything that can be dragged
+ * (design/patterns/drag-and-drop.md#starting-a-drag):
+ *
+ * - a mouse or a pen: after 6px of movement;
+ * - a finger: hold still 500ms, then move 10px (`useHoldThenMoveTouchSensor`);
+ * - the keyboard: Space picks up, the arrows move, Space drops, Escape puts
+ *   back. Enter never starts a drag.
+ *
+ * Pass the options, or only the keyboard's `coordinateGetter`.
+ */
+export declare function useDragSensors(options?: DragSensorsOptions | KeyboardCoordinateGetter): import("@dnd-kit/core").SensorDescriptor<import("@dnd-kit/core").SensorOptions>[];
+/**
+ * dnd-kit's sortable keyboard steps, measured from where the item's place
+ * actually is (its own node, slid into the landing spot) rather than from the
+ * lifted copy. After an item moves into another list the two differ, and the
+ * arrows would skip a place. Use it for lists inside one `DndContext`.
+ */
+export declare const listKeyboardCoordinates: KeyboardCoordinateGetter;
+type DragAcrossLists = {
+  /** The caller's collision detection, holding the item over itself right after it moves list. */
+  collisionDetection: CollisionDetection;
+  /** Pass to `useDragSensors({ coordinateGetter })`. */
+  coordinateGetter: KeyboardCoordinateGetter;
+  /**
+   * Call when the item has just been moved into another list. By keyboard it
+   * then stays over itself until the next arrow; by pointer, for one frame.
+   */
+  moved: (viaKeyboard: boolean) => void;
+  /** Call when the drag ends or is cancelled. */
+  reset: () => void;
+};
+/**
+ * The keyboard fix for an item that moves between lists while it is dragged
+ * (a sidebar's sections, a board's columns). Without it, dnd-kit still counts
+ * the row the item was put next to as the place under it, projects one more
+ * move, and the next arrow skips a place: what is announced and where the item
+ * drops disagree. With it:
+ *
+ * - right after it moves list, the item is over itself (by keyboard until the
+ *   next arrow, by pointer for one frame);
+ * - the arrows are measured from the item's real place (`listKeyboardCoordinates`).
+ *
+ * Render `DragRemeasure` too, so the lists are measured again after the move.
+ */
+export declare function useDragAcrossLists(collisionDetection: CollisionDetection): DragAcrossLists;
+type DragRemeasureProps = {
+  /** Anything that changes when an item moves list, such as the lists' items. */
+  version: unknown;
+};
+/**
+ * Measures every drop target again once an item's move into another list has
+ * rendered. dnd-kit's own observers skip targets whose size didn't change,
+ * even when they moved. Render it inside the `DndContext`.
+ */
+export declare function DragRemeasure({ version }: DragRemeasureProps): null;
+//#endregion
+//#region src/components/drag/drag.recipe.d.ts
+/**
+ * The lift look, for a copy drawn outside `DragLift`: an opaque popover
+ * surface, `shadow-float` and the `line-seam` ring. No scale, no tilt.
+ */
+export declare const LIFT_CLASS = "bg-layer-popover shadow-float ring-1 ring-line-seam";
+//#endregion
+//#region src/components/drag/drag-lift.d.ts
+/**
+ * A drag settling (motion.md, `motion-drag-settle-*`): the lifted copy
+ * gliding into its place on a drop or back home on a cancel, siblings sliding
+ * apart to open the place, and a layout reflowing on a drop.
+ */
+export declare const DRAG_SETTLE: {
+  readonly duration: 160;
+  readonly easing: "cubic-bezier(0.25, 1, 0.5, 1)";
+};
+/** For `useSortable({ transition })`: siblings slide with the same token. */
+export declare const DRAG_SIBLING_TRANSITION: {
+  readonly duration: 160;
+  readonly easing: "cubic-bezier(0.25, 1, 0.5, 1)";
+};
+/** The item a drag came from, while nothing else has taken its place (`data-drag-origin`). */
+export declare const ORIGIN_OPACITY = 0.4;
+/** Auto-scroll starts this close to the edge of anything that scrolls. */
+export declare const DRAG_AUTO_SCROLL_ZONE_PX = 48;
+/** How far a keyboard drag sets the copy off its place, so the place's dashed outline shows. */
+export declare const DRAG_KEYBOARD_OFFSET_PX = 6;
+/**
+ * Drop: the copy glides into its place. Cancel: it glides back home. While
+ * it glides, the item it will become stays hidden, then appears there.
+ */
+export declare const DROP_GLIDE: DropAnimation;
+/**
+ * The sibling transition for `useSortable({ transition })`: the drag-settle
+ * slide, or none with `prefers-reduced-motion`.
+ */
+export declare function useDragSiblingTransition(): {
+  readonly duration: 160;
+  readonly easing: "cubic-bezier(0.25, 1, 0.5, 1)";
+} | null;
+/**
+ * For a compact proxy (a section's head, at most 240px wide): the grab point
+ * is kept, but pulled to within `inset` of the proxy's end, so the hand never
+ * holds empty air beside it. A constant shift: the copy still tracks 1:1.
+ */
+export declare function keepGrabInside(proxyWidth: number, inset?: number): Modifier;
+/**
+ * Cancels the drag in progress, whichever sensor holds it. Every dnd-kit
+ * sensor (and so every sensor of `useDragSensors`) puts the item back when the
+ * window is resized, so this sends the window a `resize`: unlike a synthetic
+ * Escape, no app's own Escape handler (a dialog, a panel, a popover) hears it.
+ */
+export declare function cancelDrag(win?: Window): void;
+/**
+ * Above every raft-ui layer (popovers 50, a stacked dialog 60, toasts and the
+ * lightbox 70) and an app's own top layers: the copy in the hand is always on
+ * top. dnd-kit's own default.
+ */
+export declare const DRAG_LIFT_Z_INDEX = 999;
+type DragLiftProps = {
+  /** The lifted copy: the dragged item itself, or a compact proxy for a large one. Nothing while nothing is lifted. */
+  children?: ReactNode;
+  /**
+   * The copy takes the item's size and the control radius. Pass the item's
+   * own radius here, such as `rounded-container` for a card, or a size for a
+   * compact proxy (`size-auto max-w-60`).
+   */
+  className?: string;
+  style?: CSSProperties;
+  /** Modifiers for the copy only, such as one that keeps a compact proxy under the hand. */
+  modifiers?: Modifier[];
+  /**
+   * Scroll whatever scrollable area the pointer comes within 48px of the edge
+   * of. Turn dnd-kit's own off (`<DndContext autoScroll={false}>`) so the two
+   * don't scroll together.
+   * @default true
+   */
+  autoScroll?: boolean;
+  /**
+   * Render the copy in another element, such as `document.body` when an
+   * ancestor has a transform (a drawer, a dialog), which would offset a
+   * `position: fixed` copy. It keeps the theme scope it was rendered in
+   * (`light` / `dark`), as raft-ui's portals do. By default it renders in place.
+   */
+  container?: Element | DocumentFragment | null;
+  /** @default DRAG_LIFT_Z_INDEX (999) */
+  zIndex?: number;
+};
+/**
+ * The copy of a dragged item that follows the hand
+ * (design/patterns/drag-and-drop.md#what-follows-the-hand): an opaque popover
+ * surface with `shadow-float` and a `line-seam` ring, no scale and no tilt,
+ * 1:1 with the pointer from the grab point, never clamped to its container and
+ * never held to one axis. On a drop it glides into its place, and on a cancel
+ * back home (160ms, `motion-drag-settle-*`; none with reduced motion).
+ *
+ * While something is lifted it also sets the grabbing cursor, cancels the
+ * drag when the window loses focus or the tab is hidden, and scrolls an area
+ * the pointer is near the edge of. Render it inside the `DndContext`.
+ */
+export declare function DragLift({ children, className, style, modifiers, autoScroll, container, zIndex }: DragLiftProps): import("react").JSX.Element;
+//#endregion
+//#region src/components/drag/drop-placeholder.d.ts
+type DropPlaceholderProps = useRender.ComponentProps<"div"> & {
+  /**
+   * Over live content (a panel, a column of a layout): an opaque
+   * `layer-canvas` under the `fill-subtle` wash, so the content under it
+   * never shows through.
+   */
+  opaque?: boolean;
+};
+/**
+ * Where a dragged item will land (design/patterns/drag-and-drop.md#where-it-will-land):
+ * a 1.5px dashed `line-strong` outline on `fill-subtle`, with the item's
+ * radius and size. One look for every place. The control radius is the
+ * default; pass the item's own (`rounded-container` for a card). Hidden from
+ * assistive technology: the announcements say where the item is.
+ */
+export declare function DropPlaceholder({ opaque, className, render, ...props }: DropPlaceholderProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+type DragRefusalHintProps = Omit<ComponentPropsWithRef<"div">, "children" | "ref"> & {
+  /** Why the place under the hand won't take the item, such as "Can't move from Todo to Done". */
+  children: string;
+  /** Render the hint in another element; by default it renders in `document.body`. */
+  container?: Element | DocumentFragment | null;
+};
+/**
+ * Shown while the hand is over a place that refuses the item
+ * (design/patterns/drag-and-drop.md#refused-places): the reason, in a HUD
+ * chip by the pointer (by the lifted copy in a keyboard drag), and the
+ * not-allowed cursor. Render it only while the place is refused, inside the
+ * `DndContext`, with no placeholder anywhere. Announce the reason as well:
+ * the chip is not read out.
+ */
+export declare function DragRefusalHint({ children, container, className, style, ...props }: DragRefusalHintProps): import("react").ReactPortal | null;
+//#endregion
+//#region src/components/drag/drag-lists.d.ts
+type DragListsItems<L extends string> = Record<L, readonly string[]>;
+type UseDragListsOptions<L extends string> = {
+  /** The lists, in the order they are on screen (by keyboard, entering a list from above lands first, from below last). */
+  lists: readonly L[];
+  /** Each list's items, by id. */
+  items: DragListsItems<L>;
+  /** Called with the lists as they should now render: while dragging (the item standing at its landing spot), on a drop and on a cancel. */
+  onItemsChange: (items: DragListsItems<L>) => void;
+  /** A list's name as people see it ("Pinned"). */
+  listName: (list: L) => string;
+  /** An item's name as people see it ("#launch-week"); never its id. */
+  itemName: (id: string) => string;
+  /** Why `to` won't take an item from `from`, or null when it will. */
+  refuse?: (from: L, to: L, id: string) => string | null;
+  /** The surface's collision detection; it is held still for a moment right after the item changes list. */
+  collisionDetection: CollisionDetection;
+  /** Says each step in a polite live region (`useDragAnnouncer`). */
+  announce: (message: string) => void;
+  /** Your translations of the announcements. */
+  messages?: Partial<DragMessages>;
+};
+/** dnd-kit's vertical strategy, except that nothing moves while the hand is outside the list. */
+export declare const dragListStrategy: SortingStrategy;
+/**
+ * Items in one or more lists that can be reordered and moved between lists
+ * (a sidebar's sections, a board's columns): the lists half of the drag
+ * model (design/patterns/drag-and-drop.md#where-it-will-land). While dragging,
+ * the item stands at its landing spot (its own slot is the place; siblings
+ * slide apart), a list can refuse it, and every step is announced by name.
+ * The keyboard is measured from the item's real place, so the arrows never
+ * skip one after a move into another list.
+ *
+ * Spread `handlers`, `collisionDetection` and `accessibility` on the
+ * `DndContext`, pass `coordinateGetter` to `useDragSensors`, and render
+ * `DragRemeasure version={items}` inside it.
+ */
+export declare function useDragLists<L extends string>({ lists, items, onItemsChange, listName, itemName, refuse, collisionDetection, announce, messages }: UseDragListsOptions<L>): {
+  /** The dragged item's id, or null. */
+  activeId: string | null;
+  /** The list that refuses the item under the hand, and why. */
+  refusal: {
+    list: L;
+    reason: string;
+  } | null;
+  /** The list the drag started in, while dragging. */
+  originList: L | null;
+  isHome: (id: string, index: number) => boolean;
+  listOf: (state: DragListsItems<L>, id: UniqueIdentifier) => L | null;
+  collisionDetection: CollisionDetection;
+  coordinateGetter: KeyboardCoordinateGetter;
+  accessibility: {
+    announcements: Announcements;
+    screenReaderInstructions: ScreenReaderInstructions;
+  };
+  handlers: {
+    onDragStart: ({ active, activatorEvent }: DragStartEvent) => void;
+    onDragOver: ({ active, over }: DragOverEvent) => void;
+    onDragEnd: ({ over }: DragEndEvent) => void;
+    onDragCancel: () => void;
+  };
+};
+type DraggedSlotProps = {
+  /**
+   * This item is the one being dragged. Render the slot around every item
+   * and pass `isDragging`, so the dragged one keeps its node (and focus).
+   * @default false
+   */
+  dragging?: boolean;
+  /** The dragged item still stands at its own place. */
+  home: boolean;
+  /** The item's radius class, for the place: `rounded-control` by default. */
+  radius?: string;
+  /** Classes for the place, after `radius`. */
+  className?: string;
+  children: ReactNode;
+};
+/**
+ * Wraps each item's content in a list. The dragged item's own node is at 40%
+ * while it is still home, and the dashed place (its size, its radius) once it
+ * stands anywhere else. Every other item renders as it is: the wrapper stays
+ * the same, so the item keeps focus when its drag starts.
+ */
+export declare function DraggedSlot({ dragging, home, radius, className, children }: DraggedSlotProps): import("react").JSX.Element;
+/** The last announcement, for a polite live region (`DragLiveRegion`). Repeats are dropped. */
+export declare function useDragAnnouncer(): {
+  message: string;
+  announce: (text: string) => void;
+};
+/** A polite, visually hidden live region for drag announcements. */
+export declare function DragLiveRegion({ message }: {
+  message: string;
+}): import("react").JSX.Element;
 //#endregion
 //#region src/components/ellipsis/ellipsis.d.ts
 /** What a function passed as `after` receives. */
@@ -830,4 +1161,4 @@ type ChoiceListMultipleProps = ChoiceListCommonProps & {
 type ChoiceListProps = ChoiceListSingleProps | ChoiceListMultipleProps;
 export declare function ChoiceList(props: ChoiceListProps): import("react").JSX.Element;
 //#endregion
-export { Dialog as AnnouncementDialog, DialogClose as AnnouncementDialogClose, DialogTrigger as AnnouncementDialogTrigger, type ChoiceListGroup, type ChoiceListItem, type ChoiceListMultipleProps, type ChoiceListProps, type ChoiceListSingleProps, 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 };
+export { Dialog as AnnouncementDialog, DialogClose as AnnouncementDialogClose, DialogTrigger as AnnouncementDialogTrigger, type ChoiceListGroup, type ChoiceListItem, type ChoiceListMultipleProps, type ChoiceListProps, type ChoiceListSingleProps, 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, DEFAULT_DRAG_MESSAGES, DialogCommit, type DialogCommitProps, DialogFooterNote, type DialogFooterNoteProps, DialogSheetBack, type DialogSheetBackProps, DialogSheetContent, type DialogSheetContentProps, type DragAcrossLists, type DragAnnouncementSource, type DragLiftProps, type DragListsItems, type DragMessages, type DragNamed, type DragPlace, type DragRefusalHintProps, type DragRemeasureProps, type DragSensorsOptions, type DraggedSlotProps, type DropPlaceholderProps, 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 UseDragListsOptions, type UsePullToRefreshOptions, createDragAnnouncements, dragInstructions, dragMessages };