@baseline-ui/core 3.3.0 → 3.5.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import React__default, { ReactNode, AriaAttributes, DOMAttributes as DOMAttributes$1, AriaRole, CSSProperties, HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy, ClipboardEventHandler, CompositionEventHandler, ReactEventHandler, FormEventHandler, MouseEventHandler, TouchEventHandler, PointerEventHandler, UIEventHandler, WheelEventHandler, AnimationEventHandler, TransitionEventHandler, ReactElement, MouseEvent, FocusEvent, SyntheticEvent, KeyboardEvent as KeyboardEvent$2, JSX, HTMLAttributes, RefObject as RefObject$1, LabelHTMLAttributes, ElementType, JSXElementConstructor, ButtonHTMLAttributes, AnchorHTMLAttributes, InputHTMLAttributes, SVGProps, Ref, MutableRefObject, Key as Key$1, KeyboardEventHandler, Dispatch, SetStateAction } from 'react';
+import React__default, { ReactNode, AriaAttributes, DOMAttributes as DOMAttributes$1, AriaRole, CSSProperties, HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy, ClipboardEventHandler, CompositionEventHandler, ReactEventHandler, FormEventHandler, MouseEventHandler, TouchEventHandler, PointerEventHandler, UIEventHandler, WheelEventHandler, AnimationEventHandler, TransitionEventHandler, ReactElement, MouseEvent, FocusEvent, SyntheticEvent, KeyboardEvent as KeyboardEvent$2, JSX, HTMLAttributes, RefObject as RefObject$1, LabelHTMLAttributes, ElementType, JSXElementConstructor, ButtonHTMLAttributes, AnchorHTMLAttributes, InputHTMLAttributes, Ref, SVGProps, MutableRefObject, Key as Key$1, KeyboardEventHandler, Dispatch, SetStateAction } from 'react';
 import { CalendarDate, CalendarDateTime, ZonedDateTime, DateDuration, CalendarIdentifier, Calendar as Calendar$1, Time, DateFormatter } from '@internationalized/date';
 import { Theme, Sprinkles } from '@baseline-ui/tokens';
 import { PanelImperativeHandle, PanelProps as PanelProps$1, SeparatorProps as SeparatorProps$2 } from 'react-resizable-panels';
@@ -375,6 +375,12 @@ interface GlobalDOMAttributes<T = Element> extends GlobalDOMEvents<T> {
   hidden?: boolean | undefined;
   inert?: boolean | undefined;
   translate?: 'yes' | 'no' | undefined;
+  /**
+   * A React-only flag that suppresses the warning React normally logs when an element's
+   * server-rendered content doesn't match the client render during hydration. See [React
+   * docs](https://react.dev/reference/react-dom/client/hydrateRoot#suppressing-unavoidable-hydration-mismatch-errors).
+   */
+  suppressHydrationWarning?: boolean | undefined;
 }
 
 /**
@@ -1524,6 +1530,11 @@ declare function useFilter(options?: Intl.CollatorOptions): Filter;
 interface LinkProps$1 extends PressEvents, FocusableProps$1 {
 }
 interface AriaLinkProps extends LinkProps$1, LinkDOMProps, AriaLabelingProps {
+    /**
+     * Indicates whether this element represents the current item within a container or set of related
+     * elements.
+     */
+    'aria-current'?: boolean | 'true' | 'false' | 'page' | 'step' | 'location' | 'date' | 'time';
 }
 interface AriaLinkOptions extends AriaLinkProps {
     /** Whether the link is disabled. */
@@ -2091,7 +2102,7 @@ interface CheckboxProps$1 extends Omit<AriaCheckboxProps, 'children' | 'validati
     /**
      * A ref for the HTML input element.
      */
-    inputRef?: RefObject<HTMLInputElement | null>;
+    inputRef?: Ref<HTMLInputElement | null>;
 }
 interface CheckboxRenderProps {
     /**
@@ -2900,6 +2911,7 @@ interface DragHooks<T = object> {
         y: number;
     };
     isVirtualDragging?: () => boolean;
+    pointerDragSource?: 'item' | 'handle';
 }
 interface DropHooks {
     useDroppableCollectionState?: (props: DroppableCollectionStateOptions) => DroppableCollectionState;
@@ -2945,12 +2957,15 @@ interface DragAndDropOptions<T = object> extends Omit<DraggableCollectionProps,
     dropTargetDelegate?: DropTargetDelegate;
     /** Whether the drag and drop events should be disabled. */
     isDisabled?: boolean;
+    /**
+     * Controls where mouse and touch dragging can start. `'item'` allows dragging from anywhere on
+     * an item. `'handle'` restricts dragging to the drag handle, enabling interactive content such
+     * as text fields within draggable items. Keyboard and screen reader dragging are unaffected.
+     *
+     * @default 'item'
+     */
+    pointerDragSource?: 'item' | 'handle';
 }
-/**
- * Provides the hooks required to enable drag and drop behavior for a drag and drop compatible
- * collection component.
- */
-declare function useDragAndDrop$1<T = object>(options: DragAndDropOptions<T>): DragAndDrop<T>;
 
 interface LoadMoreSentinelProps extends Omit<AsyncLoadable, 'isLoading'> {
     collection: Collection<any>;
@@ -2964,6 +2979,13 @@ interface LoadMoreSentinelProps extends Omit<AsyncLoadable, 'isLoading'> {
      * @default 1
      */
     scrollOffset?: number;
+    /**
+     * The scroll direction that triggers load more. Use 'start' for reversed layouts where older
+     * content loads when scrolling toward the top.
+     *
+     * @default 'end'
+     */
+    direction?: 'start' | 'end';
 }
 
 interface ListBoxRenderProps {
@@ -3054,6 +3076,10 @@ interface OverlayTriggerProps$1 {
     /** Handler that is called when the overlay's open state changes. */
     onOpenChange?: (isOpen: boolean) => void;
 }
+interface Point$2 {
+    x: number;
+    y: number;
+}
 interface OverlayTriggerState {
     /** Whether the overlay is currently open. */
     readonly isOpen: boolean;
@@ -3065,11 +3091,15 @@ interface OverlayTriggerState {
     close(): void;
     /** Toggles the overlay's visibility. */
     toggle(): void;
+    /** The cursor position when the overlay was triggered, relative to the window viewport. */
+    readonly point: Point$2 | null;
+    /** Sets the cursor position relative to the window viewport. */
+    setPoint(point: Point$2): void;
 }
 
 type MenuTriggerAction = 'focus' | 'input' | 'manual';
 type SelectionMode$2 = 'single' | 'multiple';
-type ValueType$1<M extends SelectionMode$2> = M extends 'single' ? Key | null : Key[];
+type ValueType$1<M extends SelectionMode$2> = M extends 'single' ? Key | null : readonly Key[];
 type ChangeValueType$1<M extends SelectionMode$2> = M extends 'single' ? Key | null : Key[];
 type ValidationType$1<M extends SelectionMode$2> = M extends 'single' ? Key | null : Key[];
 interface ComboBoxValidationValue<M extends SelectionMode$2 = 'single'> {
@@ -3156,6 +3186,12 @@ interface AriaComboBoxOptions<T, M extends SelectionMode$2 = 'single'> extends O
     listBoxRef: RefObject<HTMLElement | null>;
     /** The ref for the optional list box popup trigger button. */
     buttonRef?: RefObject<Element | null>;
+    /**
+     * The HTML element used to render the label, e.g. 'label', or 'span'.
+     *
+     * @default 'label'
+     */
+    labelElementType?: ElementType;
     /** An optional keyboard delegate implementation, to override the default. */
     keyboardDelegate?: KeyboardDelegate;
     /**
@@ -3351,6 +3387,12 @@ interface AriaDialogProps extends DOMProps, AriaLabelingProps {
      * @default 'dialog'
      */
     role?: 'dialog' | 'alertdialog';
+    /**
+     * Whether the dialog is currently performing an entry animation. Focus is not moved into the
+     * dialog until the animation completes, since moving the screen reader cursor may cause scrolling
+     * that interrupts the animation.
+     */
+    isEntering?: boolean;
 }
 
 interface DisclosureProps$1 {
@@ -3578,56 +3620,6 @@ interface GridState<T, C extends IGridCollection<T>> {
     isKeyboardNavigationDisabled: boolean;
 }
 
-interface MenuProps$1<T> extends CollectionBase<T>, MultipleSelection {
-    /** Where the focus should be set. */
-    autoFocus?: boolean | FocusStrategy;
-    /** Whether keyboard navigation is circular. */
-    shouldFocusWrap?: boolean;
-    /** Handler that is called when an item is selected. */
-    onAction?: (key: Key, value: T) => void;
-    /** Handler that is called when the menu should close after selecting an item. */
-    onClose?: () => void;
-}
-interface AriaMenuProps<T> extends MenuProps$1<T>, DOMProps, AriaLabelingProps {
-    /**
-     * Whether pressing the escape key should clear selection in the menu or not.
-     *
-     * Most experiences should not modify this option as it eliminates a keyboard user's ability to
-     * easily clear selection. Only use if the escape key is being handled externally or should not
-     * trigger selection clearing contextually.
-     *
-     * @default 'clearSelection'
-     */
-    escapeKeyBehavior?: 'clearSelection' | 'none';
-}
-
-type MenuTriggerType = 'press' | 'longPress';
-interface MenuTriggerProps extends OverlayTriggerProps$1 {
-    /**
-     * How the menu is triggered.
-     *
-     * @default 'press'
-     */
-    trigger?: MenuTriggerType;
-}
-interface MenuTriggerState extends OverlayTriggerState {
-    /** Controls which item will be auto focused when the menu opens. */
-    readonly focusStrategy: FocusStrategy | null;
-    /** Opens the menu. */
-    open(focusStrategy?: FocusStrategy | null): void;
-    /** Toggles the menu. */
-    toggle(focusStrategy?: FocusStrategy | null): void;
-}
-
-interface AriaMenuTriggerProps {
-    /** The type of menu that the menu trigger opens. */
-    type?: 'menu' | 'listbox';
-    /** Whether menu trigger is disabled. */
-    isDisabled?: boolean;
-    /** How menu is triggered. */
-    trigger?: MenuTriggerType;
-}
-
 type BoundaryAxis = 'horizontal' | 'vertical' | 'both';
 type HorizontalBoundaryBehavior$1 = 'shift' | 'anchor';
 
@@ -3751,7 +3743,26 @@ interface AriaPositionProps extends PositionProps {
     getTargetRect?: (target: Element) => DOMRect | null | undefined;
 }
 
-interface AriaPopoverProps extends Omit<AriaPositionProps, 'isOpen' | 'onClose' | 'targetRef' | 'overlayRef'> {
+interface FocusWithinProps {
+    /** Whether the focus within events should be disabled. */
+    isDisabled?: boolean;
+    /** Handler that is called when the target element or a descendant receives focus. */
+    onFocusWithin?: (e: FocusEvent) => void;
+    /** Handler that is called when the target element and all descendants lose focus. */
+    onBlurWithin?: (e: FocusEvent) => void;
+    /** Handler that is called when the the focus within state changes. */
+    onFocusWithinChange?: (isFocusWithin: boolean) => void;
+}
+interface FocusWithinResult {
+    /** Props to spread onto the target element. */
+    focusWithinProps: DOMAttributes;
+}
+/**
+ * Handles focus events for the target and its descendants.
+ */
+declare function useFocusWithin(props: FocusWithinProps): FocusWithinResult;
+
+interface AriaPopoverProps extends Omit<AriaPositionProps, 'isOpen' | 'onClose' | 'targetRef' | 'overlayRef'>, Omit<FocusWithinProps, 'isDisabled'> {
     /**
      * The ref for the element which the popover positions itself with respect to.
      */
@@ -3802,6 +3813,89 @@ interface AriaPopoverProps extends Omit<AriaPositionProps, 'isOpen' | 'onClose'
     shouldCloseOnScroll?: boolean;
 }
 
+interface TooltipTriggerProps extends OverlayTriggerProps$1 {
+    /**
+     * Whether the tooltip should be disabled, independent from the trigger.
+     */
+    isDisabled?: boolean;
+    /**
+     * The delay time for the tooltip to show up. [See
+     * guidelines](https://spectrum.adobe.com/web/rsp/components/tooltip#behaviors).
+     *
+     * @default 1500
+     */
+    delay?: number;
+    /**
+     * The delay time for the tooltip to close. [See
+     * guidelines](https://spectrum.adobe.com/web/rsp/components/tooltip#behaviors).
+     *
+     * @default 500
+     */
+    closeDelay?: number;
+    /**
+     * By default, opens for both focus and hover. Can be made to open only for focus.
+     *
+     * @default 'hover'
+     */
+    trigger?: 'hover' | 'focus';
+    /**
+     * Whether the tooltip should close when the trigger is pressed.
+     *
+     * @default true
+     */
+    shouldCloseOnPress?: boolean;
+}
+
+interface MenuProps$1<T> extends CollectionBase<T>, MultipleSelection {
+    /** Where the focus should be set. */
+    autoFocus?: boolean | FocusStrategy;
+    /** Whether keyboard navigation is circular. */
+    shouldFocusWrap?: boolean;
+    /** Handler that is called when an item is selected. */
+    onAction?: (key: Key, value: T) => void;
+    /** Handler that is called when the menu should close after selecting an item. */
+    onClose?: () => void;
+}
+interface AriaMenuProps<T> extends MenuProps$1<T>, DOMProps, AriaLabelingProps {
+    /**
+     * Whether pressing the escape key should clear selection in the menu or not.
+     *
+     * Most experiences should not modify this option as it eliminates a keyboard user's ability to
+     * easily clear selection. Only use if the escape key is being handled externally or should not
+     * trigger selection clearing contextually.
+     *
+     * @default 'clearSelection'
+     */
+    escapeKeyBehavior?: 'clearSelection' | 'none';
+}
+
+type MenuTriggerType = 'press' | 'longPress' | 'contextMenu';
+interface MenuTriggerProps extends OverlayTriggerProps$1 {
+    /**
+     * How the menu is triggered.
+     *
+     * @default 'press'
+     */
+    trigger?: MenuTriggerType;
+}
+interface MenuTriggerState extends OverlayTriggerState {
+    /** Controls which item will be auto focused when the menu opens. */
+    readonly focusStrategy: FocusStrategy | null;
+    /** Opens the menu. */
+    open(focusStrategy?: FocusStrategy | null): void;
+    /** Toggles the menu. */
+    toggle(focusStrategy?: FocusStrategy | null): void;
+}
+
+interface AriaMenuTriggerProps {
+    /** The type of menu that the menu trigger opens. */
+    type?: 'menu' | 'listbox';
+    /** Whether menu trigger is disabled. */
+    isDisabled?: boolean;
+    /** How menu is triggered. */
+    trigger?: MenuTriggerType;
+}
+
 interface OverlayProps {
     /**
      * The container element in which the overlay portal will be placed.
@@ -3934,6 +4028,19 @@ interface AriaModalOverlayProps extends Pick<AriaOverlayProps, 'shouldCloseOnInt
      * @default false
      */
     shouldUseInert?: boolean;
+    /**
+     * Whether the modal is currently performing an entry animation. Content outside the modal is
+     * not hidden from assistive technology until the animation completes, so that the screen reader
+     * cursor is not forced into the modal before it is ready.
+     */
+    isEntering?: boolean;
+    /**
+     * Whether to override the `focus()` method so it does not scroll the page.
+     * This is temporary and will be removed after fully testing all overlays.
+     *
+     * @private
+     */
+    UNSTABLE_overrideFocus?: boolean;
 }
 
 interface RadioGroupProps$1 extends ValueBase<string | null, string>, InputBase, Pick<InputDOMProps, 'name'>, Validation<string>, LabelableProps, HelpTextProps, FocusEvents {
@@ -4190,6 +4297,13 @@ interface TableProps$2<T> extends MultipleSelection, Sortable, Expandable {
     shouldSelectOnPressUp?: boolean;
     /** The id of the column that displays hierarchical data. */
     treeColumn?: Key;
+    /**
+     * Whether keyboard navigation to focusable elements within the cells is
+     * via the left/right arrow keys or the tab key.
+     *
+     * @default 'arrow'
+     */
+    keyboardNavigationBehavior?: 'arrow' | 'tab';
 }
 interface TableState<T> extends GridState<T, ITableCollection<T>> {
     /** A collection of rows and columns in the table. */
@@ -4389,6 +4503,18 @@ interface ColumnProps$1 extends RenderProps<ColumnRenderProps, 'th' | 'div'>, Gl
      * `<ResizableTableContainer>`.
      */
     maxWidth?: ColumnStaticSize | null;
+    /**
+     * Whether the column header or its first focusable child element should be focused when the
+     * column header is focused. Defaults to 'child' in arrow keyboard navigation mode and 'cell' in
+     * tab keyboard navigation mode.
+     */
+    focusMode?: 'child' | 'cell';
+    /**
+     * Whether the column should support arrow key navigation even when the containing table uses tab
+     * keyboard navigation. Allows users to navigate between columns and rows with arrow keys while
+     * focus is on an interactive child element within the column header.
+     */
+    allowsArrowNavigation?: boolean;
 }
 interface TableBodyRenderProps {
     /**
@@ -4573,13 +4699,25 @@ interface CellProps$1 extends RenderProps<CellRenderProps, 'td' | 'div'>, Global
     textValue?: string;
     /** Indicates how many columns the data cell spans. */
     colSpan?: number;
+    /**
+     * Whether the cell or its first focusable child element should be focused when the cell is
+     * focused. Defaults to 'child' in arrow keyboard navigation mode and 'cell' in tab keyboard
+     * navigation mode.
+     */
+    focusMode?: 'child' | 'cell';
+    /**
+     * Whether the cell should support arrow key navigation even when the containing table uses
+     * tab keyboard navigation. Allows users to navigate between cells and rows with arrow keys while
+     * focus is on an interactive child element within the cell.
+     */
+    allowsArrowNavigation?: boolean;
 }
 interface TableLoadMoreItemProps extends Omit<LoadMoreSentinelProps, 'collection'>, StyleProps, DOMRenderProps<'tr' | 'div', undefined>, GlobalDOMAttributes<HTMLTableRowElement> {
     /**
      * The CSS [className](https://developer.mozilla.org/en-US/docs/Web/API/Element/className) for the
      * element.
      *
-     * @default 'react-aria-TableLoadMoreItem'
+     * @default 'react-aria-TableLoadingIndicator'
      */
     className?: string;
     /**
@@ -4719,6 +4857,8 @@ interface InvalidationContext<O = any> {
     contentChanged?: boolean;
     offsetChanged?: boolean;
     sizeChanged?: boolean;
+    widthChanged?: boolean;
+    heightChanged?: boolean;
     itemSizeChanged?: boolean;
     layoutOptionsChanged?: boolean;
     layoutOptions?: O;
@@ -4890,6 +5030,7 @@ declare class Virtualizer$1<T extends object, V> {
     private _isScrolling;
     private _invalidationContext;
     private _overscanManager;
+    private _scrollAnchor;
     constructor(options: VirtualizerOptions<T, V>);
     /** Returns whether the given key, or an ancestor, is persisted. */
     isPersistedKey(key: Key): boolean;
@@ -5373,6 +5514,10 @@ interface VirtualizerProps<O> {
     layout: LayoutClass<O> | ILayout<O>;
     /** Options for the layout. */
     layoutOptions?: O;
+    /**
+     * Whether to observe each item's size with a ResizeObserver and re-measure when it changes.
+     */
+    shouldObserveItemSize?: boolean;
 }
 /**
  * A Virtualizer renders a scrollable collection of data using customizable layouts.
@@ -5523,39 +5668,6 @@ interface AriaToolbarProps extends AriaLabelingProps {
     isSingleTabStop?: boolean;
 }
 
-interface TooltipTriggerProps extends OverlayTriggerProps$1 {
-    /**
-     * Whether the tooltip should be disabled, independent from the trigger.
-     */
-    isDisabled?: boolean;
-    /**
-     * The delay time for the tooltip to show up. [See
-     * guidelines](https://spectrum.adobe.com/page/tooltip/#Immediate-or-delayed-appearance).
-     *
-     * @default 1500
-     */
-    delay?: number;
-    /**
-     * The delay time for the tooltip to close. [See
-     * guidelines](https://spectrum.adobe.com/page/tooltip/#Warmup-and-cooldown).
-     *
-     * @default 500
-     */
-    closeDelay?: number;
-    /**
-     * By default, opens for both focus and hover. Can be made to open only for focus.
-     *
-     * @default 'hover'
-     */
-    trigger?: 'hover' | 'focus';
-    /**
-     * Whether the tooltip should close when the trigger is pressed.
-     *
-     * @default true
-     */
-    shouldCloseOnPress?: boolean;
-}
-
 interface Locale {
     /** The [BCP47](https://www.ietf.org/rfc/bcp/bcp47.txt) language code for the locale. */
     locale: string;
@@ -5627,6 +5739,26 @@ interface VisuallyHiddenProps extends DOMAttributes {
  */
 declare function VisuallyHidden(props: VisuallyHiddenProps): JSX.Element;
 
+type Modality = 'keyboard' | 'pointer' | 'virtual';
+interface FocusVisibleProps {
+    /** Whether the element is a text input. */
+    isTextInput?: boolean;
+    /** Whether the element will be auto focused. */
+    autoFocus?: boolean;
+}
+interface FocusVisibleResult {
+    /** Whether keyboard focus is visible globally. */
+    isFocusVisible: boolean;
+}
+/**
+ * Keeps state of the current modality.
+ */
+declare function useInteractionModality(): Modality | null;
+/**
+ * Manages focus visible state for the page, and subscribes individual components for updates.
+ */
+declare function useFocusVisible(props?: FocusVisibleProps): FocusVisibleResult;
+
 interface ListOptions<T> {
     /** Initial items in the list. */
     initialItems?: T[];
@@ -6150,7 +6282,8 @@ declare function filterTruthyValues<T extends Record<string, unknown>>(obj: T):
 declare function booleanOrObjectToConfig<T extends Record<string, unknown>>(value: boolean | Partial<T>, defaults: T): T | undefined;
 
 /**
- * Lightens a color by a percentage.
+ * Lightens a color by a percentage. Accepts any string `parseColor` accepts, or
+ * a CSS color name.
  *
  * ```ts
  * lightenColor("#000000", 10); // #1a1a1a
@@ -6162,10 +6295,10 @@ declare function lightenColor(color: string, percent: number): string;
  * serialized form. Browsers normalize colors when they round-trip through the
  * DOM — `#ac0000` reads back as `rgb(172, 0, 0)`, `rgba(255, 0, 0, 1)` as
  * `rgb(255, 0, 0)` — so a raw-string compare would treat the same color as
- * different. Both sides are canonicalized via React Aria's {@link Color}; a
- * value React Aria cannot parse (a CSS named color, or an invalid value) is
- * compared by exact string instead — so it matches only an identical string
- * and never a real, parseable color.
+ * different. Both sides are canonicalized via React Aria's {@link Color}, with
+ * CSS color names resolved to their value (`"red"` equals `"#ff0000"`); an
+ * invalid value is compared by exact string instead — so it matches only an
+ * identical string and never a real, parseable color.
  */
 declare function areColorsEqual(a: string | undefined, b: string | undefined): boolean;
 
@@ -6203,6 +6336,9 @@ declare const capitalize: (str: string) => string;
 /**
  * Parses the given text using DOMParser and retrieves the plain text content of
  * the HTML document body.
+ *
+ * Without DOMParser (on the server) it only strips tags: entities are not
+ * decoded, script or style content is kept, and the result is not sanitized.
  */
 declare const getPlainText: (text: string) => string;
 
@@ -6326,48 +6462,22 @@ interface FocusProps<Target = FocusableElement> extends FocusEvents<Target> {
     isDisabled?: boolean;
 }
 
-type Modality = 'keyboard' | 'pointer' | 'virtual';
-interface FocusVisibleProps {
-    /** Whether the element is a text input. */
-    isTextInput?: boolean;
-    /** Whether the element will be auto focused. */
-    autoFocus?: boolean;
-}
-interface FocusVisibleResult {
-    /** Whether keyboard focus is visible globally. */
-    isFocusVisible: boolean;
-}
-/**
- * Keeps state of the current modality.
- */
-declare function useInteractionModality(): Modality | null;
-/**
- * Manages focus visible state for the page, and subscribes individual components for updates.
- */
-declare function useFocusVisible(props?: FocusVisibleProps): FocusVisibleResult;
-
-interface FocusWithinProps {
-    /** Whether the focus within events should be disabled. */
-    isDisabled?: boolean;
-    /** Handler that is called when the target element or a descendant receives focus. */
-    onFocusWithin?: (e: FocusEvent) => void;
-    /** Handler that is called when the target element and all descendants lose focus. */
-    onBlurWithin?: (e: FocusEvent) => void;
-    /** Handler that is called when the the focus within state changes. */
-    onFocusWithinChange?: (isFocusWithin: boolean) => void;
-}
-interface FocusWithinResult {
-    /** Props to spread onto the target element. */
-    focusWithinProps: DOMAttributes;
-}
-/**
- * Handles focus events for the target and its descendants.
- */
-declare function useFocusWithin(props: FocusWithinProps): FocusWithinResult;
+type KeyboardShortcutAction = (e: KeyboardEvent$1) => void | boolean | Partial<{
+    shouldContinuePropagation?: boolean;
+    shouldPreventDefault?: boolean;
+}>;
+/** Maps shortcut strings (e.g. `"Mod+s"`, `"Control+Shift+a"`) to handlers. */
+type KeyboardShortcutBindings = Record<string, KeyboardShortcutAction>;
 
 interface KeyboardProps extends KeyboardEvents {
     /** Whether the keyboard events should be disabled. */
     isDisabled?: boolean;
+    /** Keyboard shortcuts to handle. */
+    shortcuts?: KeyboardShortcutBindings;
+    /** Whether to allow repeating keys. Only affects shortcuts. */
+    allowRepeats?: boolean;
+    /** Whether to allow composing keys. Only affects shortcuts. */
+    allowComposing?: boolean;
 }
 interface KeyboardResult {
     /** Props to spread onto the target element. */
@@ -6534,7 +6644,11 @@ interface ListBoxProps extends StylingProps, Omit<AriaListBoxProps<ListItem> & A
         showSelectedIcon?: boolean;
         _state: ListState<ListItem>;
     }, ref: React__default.Ref<HTMLLIElement>) => React__default.ReactNode;
-    /** Renders the drop indicator component. */
+    /**
+     * Renders the drop indicator component. It is called before each item and
+     * after the last one, whether or not a drag is in progress, and must return
+     * `null` when `isHidden` is true.
+     */
     renderDropIndicator?: (options: {
         dropIndicatorProps: React__default.HTMLAttributes<HTMLLIElement>;
         isDropTarget: boolean;
@@ -6643,7 +6757,7 @@ interface ModalProps extends OverlayTriggerProps$1 {
     /** The contents of the modal. */
     children: React__default.ReactNode;
 }
-interface ModalContentProps extends Omit<AriaModalOverlayProps, "isDismissable" | "isKeyboardDismissDisabled" | "root" | "shouldUseInert">, Pick<OverlayProps, "disableFocusManagement">, StylingProps {
+interface ModalContentProps extends Omit<AriaModalOverlayProps, "isDismissable" | "isKeyboardDismissDisabled" | "root" | "shouldUseInert" | "isEntering" | "UNSTABLE_overrideFocus">, Pick<OverlayProps, "disableFocusManagement">, StylingProps {
     /**
      * The contents of the modal. Can be a React node or a function that returns a
      * React node.
@@ -6976,7 +7090,14 @@ type MenuSection = Omit<ListSection, "children"> & {
 type MenuItem = MenuOption | MenuSection;
 type MenuPopoverProps = Pick<PopoverContentProps, "isNonModal" | "placement" | "shouldUpdatePosition" | "shouldFlip" | "boundaryElement" | "boundaryAxis" | "horizontalBoundaryBehavior" | "crossOffset" | "offset" | "portalContainer">;
 type MenuSelectionKeys = "selectionMode" | "selectedKeys" | "defaultSelectedKeys" | "onSelectionChange";
-interface MenuPropsBase extends MenuPopoverProps, MenuTriggerProps, CollectionOptionRenderProps<MenuOption, MenuItemRenderProps>, Omit<AriaMenuProps<MenuItem>, "children" | MenuSelectionKeys>, Omit<AriaMenuTriggerProps, "type"> {
+interface MenuPropsBase extends MenuPopoverProps, Omit<MenuTriggerProps, "trigger">, CollectionOptionRenderProps<MenuOption, MenuItemRenderProps>, Omit<AriaMenuProps<MenuItem>, "children" | MenuSelectionKeys>, Omit<AriaMenuTriggerProps, "type" | "trigger"> {
+    /**
+     * How the menu is opened from its trigger. With `"longPress"`, a long press
+     * or `Alt` + `ArrowDown` / `ArrowUp` / `Enter` / `Space` opens the menu.
+     *
+     * @default "press"
+     */
+    trigger?: "press" | "longPress";
     /** The `className` property assigned to the root element of the component. */
     className?: string;
     /** The `className` property assigned to the content element of the component. */
@@ -7054,12 +7175,7 @@ interface DefaultListOptionProps {
 }
 
 interface DomNodeRendererProps extends StylingProps, Omit<PressHookProps, "ref"> {
-    /**
-     * The DOM node to render inside the component. If this is not provided, the
-     * component will render nothing. If this is provided, the component will
-     * render the DOM node inside a `div` component with `display` set to
-     * `contents`.
-     */
+    /** The DOM node to render inside the component's `div`. */
     node: Node;
 }
 
@@ -7488,6 +7604,8 @@ interface SliderProps extends Omit<AriaSliderProps<number> & SliderStateOptions<
     };
     /** The label for the slider. */
     label?: React__default.ReactNode;
+    /** The description of the slider. */
+    description?: string;
     /**
      * Whether to include a number input for the slider.
      *
@@ -7499,7 +7617,7 @@ interface SliderProps extends Omit<AriaSliderProps<number> & SliderStateOptions<
     /** Additional inline styles merged into the embedded number input. */
     numberInputStyle?: NumberInputProps["style"];
 }
-interface IconSliderProps extends Pick<SliderProps, "value" | "minValue" | "maxValue" | "onChange" | "defaultValue" | "includeNumberInput" | "step" | "numberFormatOptions" | "isDisabled" | "isReadOnly">, StylingProps, IconComponentProps, Pick<ColorInputProps, "onTriggerPress"> {
+interface IconSliderProps extends Pick<SliderProps, "value" | "minValue" | "maxValue" | "onChange" | "defaultValue" | "includeNumberInput" | "step" | "numberFormatOptions" | "isDisabled" | "isReadOnly" | "description">, StylingProps, IconComponentProps, Pick<ColorInputProps, "onTriggerPress"> {
     /**
      * A function to format the value of the slider.
      *
@@ -7717,6 +7835,12 @@ interface SingleLineTextInputProps extends Omit<AriaTextFieldProps, "validationS
      * @default false
      */
     isMultiLine?: false;
+    /**
+     * An object ref (from `useRef` or `createRef`) to the native `<input>`
+     * element, for calls such as `focus()` or `select()`. `ref` points at the
+     * wrapping `<div>`.
+     */
+    inputRef?: React__default.RefObject<HTMLInputElement | null>;
 }
 interface MultiLineTextInputProps extends Omit<AriaTextFieldProps<HTMLTextAreaElement>, "validationState" | "isInvalid" | "description" | "errorMessage">, TextInputBaseProps {
     /**
@@ -7725,10 +7849,16 @@ interface MultiLineTextInputProps extends Omit<AriaTextFieldProps<HTMLTextAreaEl
      * the status icon.
      */
     isMultiLine: true;
+    /**
+     * An object ref (from `useRef` or `createRef`) to the native `<textarea>`
+     * element, for calls such as `focus()` or `select()`. `ref` points at the
+     * wrapping `<div>`.
+     */
+    inputRef?: React__default.RefObject<HTMLTextAreaElement | null>;
 }
 type TextInputProps = SingleLineTextInputProps | MultiLineTextInputProps;
 
-interface FileInputProps extends InputMessage, FileTriggerProps, Pick<SharedInputProps, "validationState" | "labelPosition"> {
+interface FileInputProps extends InputMessage, Omit<FileTriggerProps, "suppressHydrationWarning">, Pick<SharedInputProps, "validationState" | "labelPosition"> {
     /** The id applied to the root element of the component. */
     id?: string;
     /** The className applied to the root element of the component. */
@@ -7913,14 +8043,14 @@ interface CalendarBaseProps {
      */
     selectYearLabel?: string;
 }
-type CalendarProps<T extends DateValue = DateValue> = StylingProps & Omit<CalendarProps$1<T>, "visibleDuration"> & CalendarBaseProps;
-type RangeCalendarProps<T extends DateValue = DateValue> = StylingProps & Omit<RangeCalendarProps$1<T>, "visibleDuration"> & CalendarBaseProps;
+type CalendarProps<T extends DateValue = DateValue> = StylingProps & Omit<CalendarProps$1<T>, "visibleDuration" | "suppressHydrationWarning"> & CalendarBaseProps;
+type RangeCalendarProps<T extends DateValue = DateValue> = StylingProps & Omit<RangeCalendarProps$1<T>, "visibleDuration" | "suppressHydrationWarning"> & CalendarBaseProps;
 
 declare const Calendar: <T extends DateValue>(props: CalendarProps<T> & React__default.RefAttributes<HTMLDivElement>) => React__default.ReactElement;
 
 declare const RangeCalendar: <T extends DateValue>(props: RangeCalendarProps<T> & React__default.RefAttributes<HTMLDivElement>) => React__default.ReactElement;
 
-interface CheckboxProps extends Omit<CheckboxProps$1, "children" | "className" | "style">, StylingProps {
+interface CheckboxProps extends Omit<CheckboxProps$1, "children" | "className" | "style" | "suppressHydrationWarning">, StylingProps {
     /** The checkbox's label. */
     label?: string;
     /**
@@ -8164,6 +8294,13 @@ interface TagProps extends StylingProps {
      * is rendered.
      */
     onRemove?: () => void;
+    /**
+     * Overrides the accessible label of the remove button. Ignored inside a
+     * `TagGroup`, which labels its own remove buttons.
+     *
+     * Message id: `bui.tag.remove`. Defaults to `"Remove"`.
+     */
+    removeLabel?: string;
 }
 
 declare const Tag: React__default.ForwardRefExoticComponent<TagProps & React__default.RefAttributes<HTMLDivElement>>;
@@ -8244,10 +8381,11 @@ interface AccordionItemProps extends StylingProps {
      * @example
      *   ```jsx
      *   <AccordionItem
+     *    value="item-1"
      *    title="Accordion Item"
      *    actions={[{
      *      icon: EditIcon,
-     *      label: "Edit",
+     *      "aria-label": "Edit",
      *      onPress: () => alert("Edit"),
      *    }]}>Content</AccordionItem>
      *    ```;
@@ -8269,6 +8407,18 @@ interface AccordionItemProps extends StylingProps {
      * the accordion header.
      */
     subLabel?: string;
+    /**
+     * Keeps the content mounted while the item is collapsed, so its state (for
+     * example, typed input) is preserved. Once the collapse animation completes,
+     * the content is hidden from view and from assistive technology.
+     *
+     * The content renders even if the item is never expanded, and content of an
+     * initially collapsed item mounts hidden, so it measures zero sizes until the
+     * first expand. Set this up front: toggling it remounts the content.
+     *
+     * @default false
+     */
+    shouldForceMount?: boolean;
 }
 
 declare const Accordion: React__default.ForwardRefExoticComponent<AccordionProps & React__default.RefAttributes<HTMLDivElement>>;
@@ -8422,10 +8572,10 @@ type TabsProps = Omit<StylingProps & AriaTabListProps<ItemProps>, "orientation"
      *
      * ```jsx
      * <Tabs>
-     *   <TabItem key="tab1" title="Tab 1">
+     *   <TabItem value="tab1" title="Tab 1">
      *     <div>Tab 1 content</div>
      *   </TabItem>
-     *   <TabItem key="tab2" title="Tab 2">
+     *   <TabItem value="tab2" title="Tab 2">
      *     <div>Tab 2 content</div>
      *   </TabItem>
      * </Tabs>;
@@ -8518,7 +8668,7 @@ interface InlineAlertProps extends StylingProps {
 
 declare const InlineAlert: React__default.ForwardRefExoticComponent<InlineAlertProps & React__default.RefAttributes<HTMLDivElement>>;
 
-interface DrawerProps extends StylingProps, AriaDialogProps {
+interface DrawerProps extends StylingProps, Omit<AriaDialogProps, "isEntering"> {
     /** The children to render. */
     children: React__default.ReactNode;
     /**
@@ -8547,13 +8697,13 @@ interface DrawerProps extends StylingProps, AriaDialogProps {
 
 declare const Drawer: React__default.ForwardRefExoticComponent<DrawerProps & React__default.RefAttributes<HTMLDivElement>>;
 
-interface DialogProps extends AriaDialogProps, StylingProps {
+interface DialogProps extends Omit<AriaDialogProps, "isEntering">, StylingProps {
     /** The children to render. */
     children: React__default.ReactNode;
     /**
      * The size of the dialog. This defines the max width of the dialog.
      *
-     * @default "sm"
+     * @default "md"
      */
     size?: "sm" | "md" | "lg" | "content";
     /**
@@ -9031,7 +9181,11 @@ interface ToolbarProps extends StylingProps, AriaToolbarProps {
      * relevant when `isCollapsible` is true.
      */
     renderSpacer?: boolean;
-    /** The callback to call when any key is pressed. */
+    /**
+     * The callback to call when any key is pressed. It runs before the toolbar
+     * moves focus, so calling `preventDefault` for Tab keeps focus in a text
+     * field.
+     */
     onKeyDown?: KeyboardProps["onKeyDown"];
     /**
      * When set to true, the toolbar will act as a normal toolbar and will not
@@ -9582,7 +9736,11 @@ interface CommandArgs {
         id: string;
         displayName: string;
     }];
-    removeMentionInput: [restoreText: string];
+    /**
+     * `caretAt` is the edge of `restoreText` the caret lands on; defaults to
+     * `"end"`.
+     */
+    removeMentionInput: [restoreText: string, caretAt?: "start" | "end"];
 }
 declare class EditorCore {
     private doc;
@@ -9936,7 +10094,7 @@ interface ScrollControlButtonProps extends StylingProps, Pick<ActionButtonProps,
     /**
      * The ref to the scrollable element.
      *
-     * @default document.body
+     * @default the page scroller (the document, or the body when it scrolls)
      */
     scrollRef?: React__default.RefObject<HTMLElement | null>;
     /**
@@ -10119,7 +10277,19 @@ declare const AudioPlayer: React__default.ForwardRefExoticComponent<AudioPlayerP
 
 declare const UNSAFE_ListBox: React__default.ForwardRefExoticComponent<UNSAFE_ListBoxProps & React__default.RefAttributes<HTMLDivElement>>;
 
-declare const useDragAndDrop: typeof useDragAndDrop$1<ListOption>;
+interface UseDragAndDropOptions<T> extends Omit<DragAndDropOptions<T>, "pointerDragSource"> {
+    /**
+     * Where mouse and touch dragging can start in a `TreeView`. `"item"` allows
+     * dragging from anywhere on a row; `"handle"` only from its drag handle, so
+     * text fields and other controls in the row stay usable. Keyboard and screen
+     * reader dragging are unaffected. `UNSAFE_ListBox` and `ImageGallery` have no
+     * drag handle and ignore it.
+     *
+     * @default "item"
+     */
+    pointerDragSource?: DragAndDropOptions<T>["pointerDragSource"];
+}
+declare function useDragAndDrop<T extends ListOption = ListOption>(props: UseDragAndDropOptions<T>): DragAndDrop<T>;
 
 interface Item {
     id: string;
@@ -10309,7 +10479,7 @@ interface ButtonSelectProps extends StylingProps, Pick<SelectProps<"single">, "i
 
 declare const ButtonSelect: React__default.ForwardRefExoticComponent<ButtonSelectProps & React__default.RefAttributes<HTMLDivElement>>;
 
-interface ComboBoxProps extends StylingProps, Omit<AriaComboBoxOptions<ListItem>, "items" | "children" | "inputRef" | "popoverRef" | "listBoxRef" | "buttonRef" | "validationState" | "errorMessage" | "description">, Omit<AriaComboBoxProps<ListItem>, "items" | "children" | "errorMessage" | "description" | "validationState">, Omit<UNSAFE_ListBoxProps, "autoFocus" | "onBlur" | "onFocus" | "onSelectionChange" | "selectionBehavior" | "selectionMode" | "selectedKeys" | "defaultSelectedKeys" | "renderDropIndicator" | "renderDragPreview" | "dropIndicatorClassName" | "dropIndicatorStyle" | "dragAndDropHooks" | "dependencies" | "orientation" | "layout" | "renderSectionHeader" | "showSectionHeader" | "withSectionHeaderPadding" | "listBoxHandle" | "sectionClassName" | "sectionStyle">, AriaValidationProps, Omit<ComboBoxStateOptions<ListItem>, "items" | "children" | "errorMessage" | "description" | "validationState" | "selectedKey">, InputMessage, Pick<ActionIconButtonProps, "tooltip">, Pick<ColorInputProps, "onTriggerPress"> {
+interface ComboBoxProps extends StylingProps, Omit<AriaComboBoxOptions<ListItem>, "items" | "children" | "inputRef" | "popoverRef" | "listBoxRef" | "buttonRef" | "validationState" | "errorMessage" | "description" | "labelElementType">, Omit<AriaComboBoxProps<ListItem>, "items" | "children" | "errorMessage" | "description" | "validationState">, Omit<UNSAFE_ListBoxProps, "autoFocus" | "onBlur" | "onFocus" | "onSelectionChange" | "selectionBehavior" | "selectionMode" | "selectedKeys" | "defaultSelectedKeys" | "renderDropIndicator" | "renderDragPreview" | "dropIndicatorClassName" | "dropIndicatorStyle" | "dragAndDropHooks" | "dependencies" | "orientation" | "layout" | "renderSectionHeader" | "showSectionHeader" | "withSectionHeaderPadding" | "listBoxHandle" | "sectionClassName" | "sectionStyle">, AriaValidationProps, Omit<ComboBoxStateOptions<ListItem>, "items" | "children" | "errorMessage" | "description" | "validationState" | "selectedKey">, InputMessage, Pick<ActionIconButtonProps, "tooltip">, Pick<ColorInputProps, "onTriggerPress"> {
     /** ID of the initially selected item */
     defaultSelectedKey?: string;
     /**
@@ -10330,7 +10500,11 @@ interface ComboBoxProps extends StylingProps, Omit<AriaComboBoxOptions<ListItem>
      * @default top
      */
     labelPosition?: "top" | "start";
-    /** Whether the input is read only. */
+    /**
+     * Whether the input is read only.
+     *
+     * @deprecated Use `isReadOnly`, which takes precedence when both are set.
+     */
     readOnly?: boolean;
     /** The style object to apply to the input element */
     inputStyle?: React__default.CSSProperties;
@@ -10343,6 +10517,12 @@ interface ComboBoxProps extends StylingProps, Omit<AriaComboBoxOptions<ListItem>
      * overrides any `aria-labelledby` the toggle would otherwise inherit.
      */
     toggleLabel?: string;
+    /**
+     * Whether typing in the input filters the items shown in the list. When
+     * `false`, every item is shown and `filter` is ignored.
+     *
+     * @default true
+     */
     filterItems?: boolean;
     onInputChange?: (value: string) => void;
     showIcon?: boolean;
@@ -10374,7 +10554,10 @@ interface ComboBoxProps extends StylingProps, Omit<AriaComboBoxOptions<ListItem>
      * @default input
      */
     menuTrigger?: "manual" | "input" | "focus";
-    /** Custom filter function to use when filtering items. */
+    /**
+     * Custom filter function to use when filtering items. Ignored when
+     * `filterItems` is `false`.
+     */
     filter?: ComboBoxStateOptions<ListItem>["defaultFilter"];
     /**
      * The type of the input field
@@ -10588,12 +10771,13 @@ interface ColorSwatchPickerProps extends StylingProps, Pick<RadioGroupProps, "op
     icon?: React__default.FC<IconProps>;
     /**
      * The value of the selected item. This is useful if you want to control the
-     * value of the picker.
+     * value of the picker. It selects the item with the same colour however
+     * either is written, so `"#FF0000"` or `"red"` selects a `"#ff0000"` item.
      */
     value?: string;
     /** A function that is called when the selected item changes. */
     onChange?: (value?: string) => void;
-    /** The default value of the picker. */
+    /** The default value of the picker. Matched to an item like `value`. */
     defaultValue?: string;
     /** The label for the picker. */
     label?: string;
@@ -10617,6 +10801,35 @@ type TimeFieldProps = StylingProps & Omit<Omit<TimeFieldStateOptions, "locale">
 interface TreeListItem extends ListOption {
     children?: TreeListItem[];
 }
+/** The state of a tree item, passed to `renderItem`. */
+interface TreeItemRenderState {
+    /** 1-based depth of the item. Top-level items are level 1. */
+    level: number;
+    /** Whether the item is currently expanded. */
+    isExpanded: boolean;
+    /** Whether the item has children. */
+    hasChildItems: boolean;
+    /** Whether the item is selected. */
+    isSelected: boolean;
+    /** Whether the item should show a focus ring. */
+    isFocusVisible: boolean;
+    /** Whether the item or a control inside it has keyboard focus. */
+    isFocusVisibleWithin: boolean;
+    /** Whether the pointer is over the item. */
+    isHovered: boolean;
+    /**
+     * Whether the item is being pressed with a pointer, <kbd>Enter</kbd> or
+     * <kbd>Space</kbd>. Pressing a Baseline button inside the item
+     * doesn't count.
+     */
+    isPressed: boolean;
+    /** Whether a dragged item is over this item and would be dropped into it. */
+    isDropTarget: boolean;
+    /** Whether the item is being dragged. */
+    isDragging: boolean;
+    /** Expands the item if collapsed, collapses it if expanded. */
+    toggleExpanded: () => void;
+}
 interface TreeViewProps extends StylingProps, Omit<AriaLabelingProps, "aria-describedby" | "aria-details">, Omit<TreeProps<TreeListItem>, "items" | "children" | "disabledKeys" | "defaultSelectedKeys" | "onSelectionChange" | "collection" | "selectionMode"> {
     /**
      * The items to display in the tree view. Each item can be a leaf or a
@@ -10723,6 +10936,43 @@ interface TreeViewProps extends StylingProps, Omit<AriaLabelingProps, "aria-desc
      * @default item => item.label
      */
     renderItemTitle?: (item: TreeListItem) => ReactNode;
+    /**
+     * The drag and drop hooks that enable moving items within the tree. Get them
+     * from `useDragAndDrop`. Keep passing them for the tree's lifetime; to turn
+     * dragging off, pass `isDisabled` to `useDragAndDrop` instead of removing
+     * this prop.
+     */
+    dragAndDropHooks?: DragAndDropHooks<TreeListItem>;
+    /**
+     * How the keyboard moves focus into a row. With `"arrow"`, the arrow keys
+     * move between a row and its controls. With `"tab"`, <kbd>Tab</kbd> moves
+     * into a row's controls and keys pressed in them, such as arrows and space in
+     * a text field, stay there. Use `"tab"` when rows contain text fields or other
+     * controls that handle keys themselves.
+     *
+     * @default "arrow"
+     */
+    keyboardNavigationBehavior?: "arrow" | "tab";
+    /**
+     * Renders the entire content of each row, replacing the chevron,
+     * indentation, icon, title, description and actions, as well as the row's
+     * padding, hover, selected and focus styling. The tree keeps its keyboard
+     * navigation, selection, focus and expansion behavior, and the item `label`
+     * remains the row's accessible name, so include a text label in the content
+     * and draw a focus indicator from `isFocusVisible`.
+     *
+     * When set, `onPrimaryAction`, `onSecondaryAction`, `primaryActionIcon`,
+     * `secondaryActionIcon`, `primaryActionAriaLabel`,
+     * `secondaryActionAriaLabel`, `actionsPosition`, `onRename`, `renameLabel`,
+     * `renderItemTitle`, `expandLabel` and `collapseLabel` have no effect.
+     *
+     * With `dragAndDropHooks`, the drag handle is still rendered before the
+     * content. Style the drop target from `isDropTarget`.
+     *
+     * Every row re-renders whenever the function's identity changes, so pass a
+     * stable function rather than an inline one.
+     */
+    renderItem?: (item: TreeListItem, state: TreeItemRenderState) => ReactNode;
 }
 
 declare const TreeView: React__default.ForwardRefExoticComponent<TreeViewProps & React__default.RefAttributes<HTMLDivElement>>;
@@ -11007,10 +11257,6 @@ interface PointPickerContentProps extends StylingProps, Pick<FocusProps<Focusabl
      * @param options - The options for the move event.
      * @param options.coordinates - The coordinates of the cursor.
      * @param options.boundingRect - The bounding rectangle of the element.
-     * @param options.activePoint - The active point of the element. This point is
-     *   the point which is snapped to the snap points if any or the coordinates
-     *   of the cursor if no snap points are provided or the cursor is not near a
-     *   snap point.
      */
     onMove?: (options: Options$1) => void;
     /** The content follows the cursor. */
@@ -11043,10 +11289,6 @@ interface PointPickerDisplayProps extends StylingProps {
      * @param options - The options for the description.
      * @param options.coordinates - The coordinates of the cursor.
      * @param options.boundingRect - The bounding rectangle of the element.
-     * @param options.activePoint - The active point of the element. This point is
-     *   the point which is snapped to the snap points if any or the coordinates
-     *   of the cursor if no snap points are provided or the cursor is not near a
-     *   snap point.
      */
     description?: Description[] | ((options: Options$1) => Description[]);
     /**
@@ -11079,6 +11321,14 @@ interface Point {
     x: number;
     y: number;
 }
+/**
+ * Finds snap points near a cursor in a web worker.
+ *
+ * `findNearestPoint` and `findPointsInRadius` change when `snapPoints` or
+ * `snapRadius` change, and each answers from the `snapPoints` of the render
+ * that created it. Call the ones from the latest render: a callback kept from
+ * an earlier render keeps answering from the old points.
+ */
 declare function usePointProximity({ snapPoints, snapRadius, }: {
     snapPoints?: Point[];
     snapRadius?: number;
@@ -11249,8 +11499,8 @@ interface KbdProps extends Omit<StylingProps, "data-block-id" | "data-block-clas
 
 declare const Kbd: React__default.ForwardRefExoticComponent<KbdProps & React__default.RefAttributes<HTMLSpanElement>>;
 
-type TableProps = TableProps$1;
-type TableHeaderProps<T extends object = object> = TableHeaderProps$1<T>;
+type TableProps = Omit<TableProps$1, "keyboardNavigationBehavior" | "suppressHydrationWarning">;
+type TableHeaderProps<T extends object = object> = Omit<TableHeaderProps$1<T>, "suppressHydrationWarning">;
 type LoadMoreProps = {
     /**
      * Called when the table scrolls near the end of the currently loaded rows.
@@ -11269,7 +11519,7 @@ type LoadMoreProps = {
     isLoading?: never;
     scrollOffset?: never;
 };
-type TableBodyProps<T extends object = object> = TableBodyProps$1<T> & LoadMoreProps & {
+type TableBodyProps<T extends object = object> = Omit<TableBodyProps$1<T>, "suppressHydrationWarning"> & LoadMoreProps & {
     /**
      * Overrides the accessible label of the loading spinner shown while more
      * rows are being fetched.
@@ -11278,18 +11528,18 @@ type TableBodyProps<T extends object = object> = TableBodyProps$1<T> & LoadMoreP
      */
     loadingLabel?: string;
 };
-type ColumnProps = Omit<ColumnProps$1, "width" | "defaultWidth" | "minWidth" | "maxWidth">;
-type RowProps<T extends object = object> = RowProps$1<T>;
-type CellProps = CellProps$1;
+type ColumnProps = Omit<ColumnProps$1, "width" | "defaultWidth" | "minWidth" | "maxWidth" | "focusMode" | "allowsArrowNavigation" | "suppressHydrationWarning">;
+type RowProps<T extends object = object> = Omit<RowProps$1<T>, "suppressHydrationWarning">;
+type CellProps = Omit<CellProps$1, "focusMode" | "allowsArrowNavigation" | "suppressHydrationWarning">;
 
-declare const Table: React__default.ForwardRefExoticComponent<TableProps$1 & React__default.RefAttributes<HTMLDivElement | HTMLTableElement>>;
+declare const Table: React__default.ForwardRefExoticComponent<TableProps & React__default.RefAttributes<HTMLDivElement | HTMLTableElement>>;
 declare const TableHeader: React__default.ForwardRefExoticComponent<TableHeaderProps & React__default.RefAttributes<HTMLTableSectionElement>>;
 declare const Column: React__default.ForwardRefExoticComponent<ColumnProps & React__default.RefAttributes<HTMLTableCellElement>>;
 declare const TableBody: React__default.ForwardRefExoticComponent<TableBodyProps & React__default.RefAttributes<HTMLDivElement | HTMLTableSectionElement>>;
 declare const Row: React__default.ForwardRefExoticComponent<RowProps & React__default.RefAttributes<HTMLTableRowElement>>;
-declare const Cell: React__default.ForwardRefExoticComponent<CellProps$1 & React__default.RefAttributes<HTMLTableCellElement>>;
+declare const Cell: React__default.ForwardRefExoticComponent<CellProps & React__default.RefAttributes<HTMLTableCellElement>>;
 
-interface UseTableDragAndDropOptions<T extends object = object> extends DragAndDropOptions<T> {
+interface UseTableDragAndDropOptions<T extends object = object> extends Omit<DragAndDropOptions<T>, "pointerDragSource"> {
     /** Ref to the scrollable container element. When provided, auto-scroll
      *  activates when dragging near container edges. */
     scrollRef?: React__default.RefObject<HTMLElement | null>;
@@ -11319,7 +11569,8 @@ interface StepperItem {
      * the step renders in indicator-only mode automatically (no visible text)
      * and this string is exposed to assistive technology. When `description`
      * is also provided, the step renders normally and this value overrides
-     * `title` as the accessible name.
+     * `title` as the accessible name. A completed step prefixes it with
+     * `completedLabel`.
      */
     "aria-label"?: string;
 }
@@ -11374,7 +11625,7 @@ interface StepperProps extends StylingProps {
         index: number;
     }) => string);
     /**
-     * Overrides the screen-reader-only suffix marking a step the reader has
+     * Overrides the screen-reader-only prefix marking a step the reader has
      * finished.
      *
      * Message id: `bui.stepper.completed`. Defaults to `"Completed"`.
@@ -11704,7 +11955,7 @@ declare function useIsFirstRender(): boolean;
  *   const uncovered = messageIds.filter((id) => !(id in ourCatalog.en));
  *   ```;
  */
-declare const messageIds: readonly ["bui.alertDialog.close", "bui.audioPlayer.audioTimeline", "bui.audioPlayer.pause", "bui.audioPlayer.play", "bui.buttonSelect.more", "bui.buttonSelect.moreWithLabel", "bui.calendar.nextMonth", "bui.calendar.nextYear", "bui.calendar.previousMonth", "bui.calendar.previousYear", "bui.calendar.selectMonth", "bui.calendar.selectYear", "bui.colorInput.add", "bui.colorInput.addColor", "bui.colorInput.cancel", "bui.colorInput.colorFormat", "bui.colorInput.colorPresets", "bui.colorInput.customColors", "bui.colorInput.indeterminate", "bui.colorInput.newColor", "bui.colorInput.noColor", "bui.colorInput.removeColor", "bui.colorInput.transparent", "bui.colorSwatch.none", "bui.dateField.openCalendar", "bui.drawer.close", "bui.editor.action", "bui.editor.addLink", "bui.editor.backgroundColor", "bui.editor.bold", "bui.editor.cancel", "bui.editor.close", "bui.editor.copy", "bui.editor.cut", "bui.editor.editLink", "bui.editor.fontColor", "bui.editor.help", "bui.editor.italic", "bui.editor.linkAnnotation", "bui.editor.mention", "bui.editor.openHelpDialog", "bui.editor.paste", "bui.editor.redo", "bui.editor.removeLink", "bui.editor.save", "bui.editor.selectAll", "bui.editor.shortcut", "bui.editor.submit", "bui.editor.toolbarFocus", "bui.editor.underline", "bui.editor.undo", "bui.fileList.loading", "bui.fileList.removeHint", "bui.freehandCanvas.redo", "bui.freehandCanvas.undo", "bui.imageDropZone.selectImage", "bui.imageGallery.cancel", "bui.imageGallery.delete", "bui.imageGallery.loading", "bui.inlineAlert.close", "bui.pagination.goToPage", "bui.pagination.nextPage", "bui.pagination.pageXofY", "bui.pagination.prevPage", "bui.select.clear", "bui.select.more", "bui.select.search", "bui.select.selectAll", "bui.stepper.completed", "bui.stepper.label", "bui.stepper.step", "bui.table.loading", "bui.toolbar.more", "bui.treeView.collapse", "bui.treeView.expand", "bui.treeView.rename", "bui.useMedia.paused", "bui.useMedia.playing"];
+declare const messageIds: readonly ["bui.alertDialog.close", "bui.audioPlayer.audioTimeline", "bui.audioPlayer.pause", "bui.audioPlayer.play", "bui.buttonSelect.more", "bui.buttonSelect.moreWithLabel", "bui.calendar.nextMonth", "bui.calendar.nextYear", "bui.calendar.previousMonth", "bui.calendar.previousYear", "bui.calendar.selectMonth", "bui.calendar.selectYear", "bui.colorInput.add", "bui.colorInput.addColor", "bui.colorInput.cancel", "bui.colorInput.colorFormat", "bui.colorInput.colorPresets", "bui.colorInput.customColors", "bui.colorInput.indeterminate", "bui.colorInput.newColor", "bui.colorInput.noColor", "bui.colorInput.removeColor", "bui.colorInput.transparent", "bui.colorSwatch.none", "bui.dateField.openCalendar", "bui.drawer.close", "bui.editor.action", "bui.editor.addLink", "bui.editor.backgroundColor", "bui.editor.bold", "bui.editor.cancel", "bui.editor.close", "bui.editor.copy", "bui.editor.cut", "bui.editor.editLink", "bui.editor.fontColor", "bui.editor.help", "bui.editor.italic", "bui.editor.linkAnnotation", "bui.editor.mention", "bui.editor.openHelpDialog", "bui.editor.paste", "bui.editor.redo", "bui.editor.removeLink", "bui.editor.save", "bui.editor.selectAll", "bui.editor.shortcut", "bui.editor.submit", "bui.editor.toolbarFocus", "bui.editor.underline", "bui.editor.undo", "bui.fileList.loading", "bui.fileList.removeHint", "bui.freehandCanvas.redo", "bui.freehandCanvas.undo", "bui.imageDropZone.selectImage", "bui.imageGallery.cancel", "bui.imageGallery.delete", "bui.imageGallery.loading", "bui.inlineAlert.close", "bui.pagination.goToPage", "bui.pagination.nextPage", "bui.pagination.pageXofY", "bui.pagination.prevPage", "bui.select.clear", "bui.select.more", "bui.select.search", "bui.select.selectAll", "bui.stepper.completed", "bui.stepper.label", "bui.stepper.step", "bui.table.loading", "bui.tag.remove", "bui.toolbar.more", "bui.treeView.collapse", "bui.treeView.expand", "bui.treeView.rename", "bui.useMedia.paused", "bui.useMedia.playing"];
 type MessageId = (typeof messageIds)[number];
 /**
  * Maps each deprecated bare id — the last dot-segment of a namespaced id — to
@@ -12037,7 +12288,8 @@ declare function usePortalContainer(_portalContainer?: HTMLElement): HTMLElement
  * changes modality when a significant event occurs, such as clicking or
  * pressing a key. It does not change when the user is moving the mouse.
  *
- * @param ownerDocument - The owner document to listen to.
+ * @param ownerDocument - The owner document to listen to. Defaults to the
+ *   global document.
  * @returns The live interaction modality of the user.
  */
 declare function useLiveInteractionModality({ ownerDocument, }: {
@@ -12084,7 +12336,7 @@ declare function clearAnnouncer(assertiveness: Assertiveness): void;
  */
 declare function destroyAnnouncer(): void;
 
-declare const getOwnerDocument: (el: Element | null | undefined) => Document;
+declare const getOwnerDocument: (target?: EventTarget | null) => Document;
 
 interface Options {
     /**
@@ -12134,4 +12386,4 @@ declare namespace reactStately {
 }
 
 export { Accordion, AccordionItem, ActionButton, ActionGroup, ActionGroupItem, ActionIconButton, Actionable, AlertDialog, AudioPlayer, Autocomplete, Avatar, Box, ButtonSelect, Calendar, Cell, Checkbox, Code, ColorInput, ColorSwatch, ColorSwatchPicker, Column, ComboBox, DateField, DateFormat, DefaultListOption, DeviceProvider, DeviceProviderContext, Dialog, DialogTitle, Disclosure, DomNodeRenderer, Drawer, EMPTY_SELECTION_STATE, Editor, EditorCore, EditorProvider, FileInput, FileList$1 as FileList, FileUploader, FocusScope, Focusable, FrameProvider, FreehandCanvas, GlobalToastRegion, GridLayout, GridList, Group, I18nProvider, Icon, IconColorInput, IconColorInputButton, IconSelect, IconSlider, ImageDropZone, ImageGallery, InlineAlert, Kbd, Link, ListBox, ListLayout, LocaleAwareGridLayout, Markdown, Menu, MessageFormat, Modal, ModalClose, ModalContent, ModalTrigger, NumberFormat, NumberInput, Pagination, Panel, PanelGroup, PanelResizeHandle, PointPicker, PointPickerContent, PointPickerDisplay, Popover, PopoverContent, PopoverTrigger, Portal, PortalContainerProvider, Pressable, Preview, ProgressBar, ProgressSpinner, REACT_ARIA_INCOMPATIBLE_KEYS, RadioGroup, RangeCalendar, Reaction, Row, ScrollControlButton, SearchInput, Select, Separator, Size, Skeleton, Slider, StatusCard, Stepper, Switch, TabItem, Table, TableBody, TableHeader, TableLayout, Tabs, Tag, TagGroup, TaggedPagination, Text, TextInput, ThemeProvider, TimeField, ToastQueue, ToggleButton, ToggleIconButton, Toolbar, Tooltip, TreeView, UNSAFE_ListBox, reactAria as UNSAFE_aria, reactStately as UNSAFE_stately, VIRTUALIZER_LAYOUT_DEFAULT_OPTIONS, Virtualizer, VisuallyHidden, WaterfallLayout, announce, areColorsEqual, booleanOrObjectToConfig, calculateFontSizeToFitWidth, capitalize, clamp, classNames, cleanKeyFromGlobImport, clearAnnouncer, createMessageFormatter, defineMessages, destroyAnnouncer, devWarnOnce, directionVar, disableAnimations, enableAnimations, filterDOMProps, filterTruthyValues, findFocusableElements, getAbsoluteBounds, getAbsolutePosition, getActiveElement, getHTMLElement, getOsSpecificKeyboardShortcutLabel, getOwnerDocument, getPlainText, getSvgPathFromStroke, getTextDimensions, handleEditorShortcut, iconMap, invariant, isFocusableElement, isInIframe, isInShadowDOM, isInputThatOpensKeyboard, isInsideOverlayContent, isRect, isUrl, legacyMessageIdMap, lightenColor, mergeProps, mergeRefs, messageIds, onDropOrPaste, parseColor, safeSpreadProps, useCollator, useDateFormatter, useDevice, useDragAndDrop, useEditable, useEditor, useEditorContext, useFilter, useFocusRing, useFocusVisible, useFrameDimensions, useI18n, useId, useImage, useInteractionModality, useIntersectionObserver, useIsFirstRender, useKeyboard, useListData, useLiveInteractionModality, useLocalStorage, useLocale, useMutationObserver, useNumberFormatter, useObjectRef, usePointProximity, usePortalContainer, usePreventFocus, useResizeObserver, useTableDragAndDrop, useTextSelection, useUndoRedo, useUserPreferences };
-export type { AccordionItemProps, AccordionProps, ActionButtonProps, ActionGroupProps, ActionIconButtonProps, ActionableProps, ActiveMarks, AlertDialogProps, AudioPlayerProps, AutocompleteProps, AvatarProps, BlockProps, BoundaryAxis, BoxProps, ButtonSelectProps, CalendarHeaderVariant, CalendarProps, CalendarSize, CellProps, CheckboxProps, CodeProps, ColorInputProps, ColorPreset, ColorSwatchPickerProps, ColorSwatchProps, ColumnProps, ComboBoxProps, CommandArgs, CommandName, CreateMessageFormatterOptions, DateFieldPickerType, DateFieldProps, DateFormatProps, Device, DeviceProviderProps, DialogProps, DialogTitleProps, DisclosureProps, DomNodeRendererProps, DrawerProps, EditableProps, EditorCoreOptions, EditorHandle, EditorProps, EditorProviderProps, EditorState, FileInputProps, FileListItem, FileListProps, FileUploaderProps, FocusableProps, FrameProviderProps, FreehandCanvasProps, GridListProps, GroupProps, HorizontalBoundaryBehavior, I18nProviderProps, I18nResult, IconColorInputProps, IconComponentProps$1 as IconComponentProps, IconProps, IconSelectProps, IconSliderProps, ImageDropZoneProps, ImageGalleryProps, ImperativePanelGroupHandle, ImperativePanelHandle, InlineAlertProps, IntersectionObserverOptions, KbdProps, Key, LinkProps, ListBoxProps, ListHandle$1 as ListHandle, ListOption, MarkName, MarkdownProps, MenuItem, MenuProps, MessageDescriptor, MessageFormatProps, MessageFormatter, MessageId, MessageIssue, MessageIssueCode, ModalContentProps, ModalProps, ModelPoint, ModelRange, NumberFormatProps, NumberInputProps, PaginationProps, PanelGroupProps, PanelProps, PanelResizeHandleProps, PointPickerContentProps, PointPickerDisplayProps, PointPickerProps, PopoverContentHandle, PopoverContentProps, PopoverProps, PopoverTriggerProps, PortalProps, PressEvent, PreviewProps, ProgressBarProps, ProgressSpinnerProps, RadioGroupProps, RangeCalendarProps, ReactAriaIncompatibleKey, ReactionProps, Rect, ResizeObserverOptions, RichTextEditorDoc, RichTextEditorInline, RichTextEditorLink, RichTextEditorMention, RichTextEditorMentionInput, RichTextEditorParagraph, RichTextEditorText, RowProps, SVGRProps, SafeDOMAttributes, ScrollControlButtonProps, SearchInputProps, SelectProps, SelectionState, SeparatorProps, SetValue, SkeletonProps, SliderProps, StatusCardProps, StepperItem, StepperProps, StylingProps, SwitchProps, TabItemProps, TableBodyProps, TableHeaderProps, TableProps, TabsProps, TagGroupProps, TagProps, TagVariant, TaggedPaginationProps, TextInputProps, TextProps, TextSelectionProps, ThemeProviderProps, TimeFieldProps, ToastProps, ToggleButtonProps, ToggleIconButtonProps, ToolbarProps, TooltipProps, TreeListItem, TreeViewProps, UNSAFE_ListBoxProps, UseEditableOptions, UseEditorOptions, UseTableDragAndDropOptions, VirtualizerProps };
+export type { AccordionItemProps, AccordionProps, ActionButtonProps, ActionGroupProps, ActionIconButtonProps, ActionableProps, ActiveMarks, AlertDialogProps, AudioPlayerProps, AutocompleteProps, AvatarProps, BlockProps, BoundaryAxis, BoxProps, ButtonSelectProps, CalendarHeaderVariant, CalendarProps, CalendarSize, CellProps, CheckboxProps, CodeProps, ColorInputProps, ColorPreset, ColorSwatchPickerProps, ColorSwatchProps, ColumnProps, ComboBoxProps, CommandArgs, CommandName, CreateMessageFormatterOptions, DateFieldPickerType, DateFieldProps, DateFormatProps, Device, DeviceProviderProps, DialogProps, DialogTitleProps, DisclosureProps, DomNodeRendererProps, DrawerProps, EditableProps, EditorCoreOptions, EditorHandle, EditorProps, EditorProviderProps, EditorState, FileInputProps, FileListItem, FileListProps, FileUploaderProps, FocusableProps, FrameProviderProps, FreehandCanvasProps, GridListProps, GroupProps, HorizontalBoundaryBehavior, I18nProviderProps, I18nResult, IconColorInputProps, IconComponentProps$1 as IconComponentProps, IconProps, IconSelectProps, IconSliderProps, ImageDropZoneProps, ImageGalleryProps, ImperativePanelGroupHandle, ImperativePanelHandle, InlineAlertProps, IntersectionObserverOptions, KbdProps, Key, LinkProps, ListBoxProps, ListHandle$1 as ListHandle, ListOption, MarkName, MarkdownProps, MenuItem, MenuProps, MessageDescriptor, MessageFormatProps, MessageFormatter, MessageId, MessageIssue, MessageIssueCode, ModalContentProps, ModalProps, ModelPoint, ModelRange, NumberFormatProps, NumberInputProps, PaginationProps, PanelGroupProps, PanelProps, PanelResizeHandleProps, PointPickerContentProps, PointPickerDisplayProps, PointPickerProps, PopoverContentHandle, PopoverContentProps, PopoverProps, PopoverTriggerProps, PortalProps, PressEvent, PreviewProps, ProgressBarProps, ProgressSpinnerProps, RadioGroupProps, RangeCalendarProps, ReactAriaIncompatibleKey, ReactionProps, Rect, ResizeObserverOptions, RichTextEditorDoc, RichTextEditorInline, RichTextEditorLink, RichTextEditorMention, RichTextEditorMentionInput, RichTextEditorParagraph, RichTextEditorText, RowProps, SVGRProps, SafeDOMAttributes, ScrollControlButtonProps, SearchInputProps, SelectProps, SelectionState, SeparatorProps, SetValue, SkeletonProps, SliderProps, StatusCardProps, StepperItem, StepperProps, StylingProps, SwitchProps, TabItemProps, TableBodyProps, TableHeaderProps, TableProps, TabsProps, TagGroupProps, TagProps, TagVariant, TaggedPaginationProps, TextInputProps, TextProps, TextSelectionProps, ThemeProviderProps, TimeFieldProps, ToastProps, ToggleButtonProps, ToggleIconButtonProps, ToolbarProps, TooltipProps, TreeItemRenderState, TreeListItem, TreeViewProps, UNSAFE_ListBoxProps, UseEditableOptions, UseEditorOptions, UseTableDragAndDropOptions, VirtualizerProps };