react-aria 3.49.0 → 3.51.0

package/dist/private/visually-hidden/VisuallyHidden.mjs.map

@@ -1 +1 @@
-{"mappings":";;;;AAAA;;;;;;;;;;CAUC;;;AA6BD,MAAM,+BAAwB;IAC5B,QAAQ;IACR,MAAM;IACN,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,SAAS;IACT,UAAU;IACV,OAAO;IACP,YAAY;AACd;AAUO,SAAS,0CAAkB,QAA6B,CAAC,CAAC;IAC/D,IAAI,SAAC,KAAK,eAAE,WAAW,EAAC,GAAG;IAE3B,IAAI,CAAC,WAAW,WAAW,GAAG,CAAA,GAAA,eAAO,EAAE;IACvC,IAAI,oBAAC,gBAAgB,EAAC,GAAG,CAAA,GAAA,yCAAa,EAAE;QACtC,YAAY,CAAC;QACb,qBAAqB,CAAA,MAAO,WAAW;IACzC;IAEA,sCAAsC;IACtC,IAAI,iBAAiB,CAAA,GAAA,cAAM,EAAE;QAC3B,IAAI,WACF,OAAO;aACF,IAAI,OACT,OAAO;YAAC,GAAG,4BAAM;YAAE,GAAG,KAAK;QAAA;aAE3B,OAAO;IAET,uDAAuD;IACzD,GAAG;QAAC;KAAU;IAEd,OAAO;QACL,qBAAqB;YACnB,GAAG,gBAAgB;YACnB,OAAO;QACT;IACF;AACF;AAMO,SAAS,0CAAe,KAA0B;IACvD,6DAA6D;IAC7D,IAAI,YAAC,QAAQ,EAAE,aAAa,UAAU,KAAK,eAAE,WAAW,SAAE,KAAK,EAAE,GAAG,YAAW,GAAG;IAClF,IAAI,uBAAC,mBAAmB,EAAC,GAAG,0CAAkB;IAE9C,qBAAO,gCAAC,SAAY,CAAA,GAAA,yCAAS,EAAE,YAAY,sBAAuB;AACpE","sources":["packages/react-aria/src/visually-hidden/VisuallyHidden.tsx"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {DOMAttributes} from '@react-types/shared';\nimport {mergeProps} from '../utils/mergeProps';\nimport React, {\n  CSSProperties,\n  JSX,\n  JSXElementConstructor,\n  ReactNode,\n  useMemo,\n  useState\n} from 'react';\nimport {useFocusWithin} from '../interactions/useFocusWithin';\n\nexport interface VisuallyHiddenProps extends DOMAttributes {\n  /** The content to visually hide. */\n  children?: ReactNode;\n\n  /**\n   * The element type for the container.\n   *\n   * @default 'div'\n   */\n  elementType?: string | JSXElementConstructor<any>;\n\n  /** Whether the element should become visible on focus, for example skip links. */\n  isFocusable?: boolean;\n}\n\nconst styles: CSSProperties = {\n  border: 0,\n  clip: 'rect(0 0 0 0)',\n  clipPath: 'inset(50%)',\n  height: '1px',\n  margin: '-1px',\n  overflow: 'hidden',\n  padding: 0,\n  position: 'absolute',\n  width: '1px',\n  whiteSpace: 'nowrap'\n};\n\nexport interface VisuallyHiddenAria {\n  visuallyHiddenProps: DOMAttributes;\n}\n\n/**\n * Provides props for an element that hides its children visually\n * but keeps content visible to assistive technology.\n */\nexport function useVisuallyHidden(props: VisuallyHiddenProps = {}): VisuallyHiddenAria {\n  let {style, isFocusable} = props;\n\n  let [isFocused, setFocused] = useState(false);\n  let {focusWithinProps} = useFocusWithin({\n    isDisabled: !isFocusable,\n    onFocusWithinChange: val => setFocused(val)\n  });\n\n  // If focused, don't hide the element.\n  let combinedStyles = useMemo(() => {\n    if (isFocused) {\n      return style;\n    } else if (style) {\n      return {...styles, ...style};\n    } else {\n      return styles;\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [isFocused]);\n\n  return {\n    visuallyHiddenProps: {\n      ...focusWithinProps,\n      style: combinedStyles\n    }\n  };\n}\n\n/**\n * VisuallyHidden hides its children visually, while keeping content visible\n * to screen readers.\n */\nexport function VisuallyHidden(props: VisuallyHiddenProps): JSX.Element {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  let {children, elementType: Element = 'div', isFocusable, style, ...otherProps} = props;\n  let {visuallyHiddenProps} = useVisuallyHidden(props);\n\n  return <Element {...mergeProps(otherProps, visuallyHiddenProps)}>{children}</Element>;\n}\n"],"names":[],"version":3,"file":"VisuallyHidden.mjs.map"}
+{"mappings":";;;;AAAA;;;;;;;;;;CAUC;;;AA6BD,MAAM,+BAAwB;IAC5B,QAAQ;IACR,MAAM;IACN,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,SAAS;IACT,UAAU;IACV,OAAO;IACP,YAAY;AACd;AAUO,SAAS,0CAAkB,QAA6B,CAAC,CAAC;IAC/D,IAAI,SAAC,KAAK,eAAE,WAAW,EAAC,GAAG;IAE3B,IAAI,CAAC,WAAW,WAAW,GAAG,CAAA,GAAA,eAAO,EAAE;IACvC,IAAI,oBAAC,gBAAgB,EAAC,GAAG,CAAA,GAAA,yCAAa,EAAE;QACtC,YAAY,CAAC;QACb,qBAAqB,CAAA,MAAO,WAAW;IACzC;IAEA,sCAAsC;IACtC,IAAI,iBAAiB,CAAA,GAAA,cAAM,EAAE;QAC3B,IAAI,WACF,gDAAgD;QAChD,OAAO;aACF,IAAI,OACT,OAAO;YAAC,GAAG,4BAAM;YAAE,GAAG,KAAK;QAAA;aAE3B,OAAO;IAET,uDAAuD;IACzD,GAAG;QAAC;KAAU;IAEd,OAAO;QACL,qBAAqB;YACnB,GAAG,gBAAgB;YACnB,OAAO;QACT;IACF;AACF;AAMO,SAAS,0CAAe,KAA0B;IACvD,6DAA6D;IAC7D,IAAI,YAAC,QAAQ,EAAE,aAAa,UAAU,KAAK,eAAE,WAAW,SAAE,KAAK,EAAE,GAAG,YAAW,GAAG;IAClF,IAAI,uBAAC,mBAAmB,EAAC,GAAG,0CAAkB;IAE9C,qBAAO,gCAAC,SAAY,CAAA,GAAA,yCAAS,EAAE,YAAY,sBAAuB;AACpE","sources":["packages/react-aria/src/visually-hidden/VisuallyHidden.tsx"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {DOMAttributes} from '@react-types/shared';\nimport {mergeProps} from '../utils/mergeProps';\nimport React, {\n  CSSProperties,\n  JSX,\n  JSXElementConstructor,\n  ReactNode,\n  useMemo,\n  useState\n} from 'react';\nimport {useFocusWithin} from '../interactions/useFocusWithin';\n\nexport interface VisuallyHiddenProps extends DOMAttributes {\n  /** The content to visually hide. */\n  children?: ReactNode;\n\n  /**\n   * The element type for the container.\n   *\n   * @default 'div'\n   */\n  elementType?: string | JSXElementConstructor<any>;\n\n  /** Whether the element should become visible on focus, for example skip links. */\n  isFocusable?: boolean;\n}\n\nconst styles: CSSProperties = {\n  border: 0,\n  clip: 'rect(0 0 0 0)',\n  clipPath: 'inset(50%)',\n  height: '1px',\n  margin: '-1px',\n  overflow: 'hidden',\n  padding: 0,\n  position: 'absolute',\n  width: '1px',\n  whiteSpace: 'nowrap'\n};\n\nexport interface VisuallyHiddenAria {\n  visuallyHiddenProps: DOMAttributes;\n}\n\n/**\n * Provides props for an element that hides its children visually\n * but keeps content visible to assistive technology.\n */\nexport function useVisuallyHidden(props: VisuallyHiddenProps = {}): VisuallyHiddenAria {\n  let {style, isFocusable} = props;\n\n  let [isFocused, setFocused] = useState(false);\n  let {focusWithinProps} = useFocusWithin({\n    isDisabled: !isFocusable,\n    onFocusWithinChange: val => setFocused(val)\n  });\n\n  // If focused, don't hide the element.\n  let combinedStyles = useMemo(() => {\n    if (isFocused) {\n      // oxlint-disable-next-line react/react-compiler\n      return style;\n    } else if (style) {\n      return {...styles, ...style};\n    } else {\n      return styles;\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [isFocused]);\n\n  return {\n    visuallyHiddenProps: {\n      ...focusWithinProps,\n      style: combinedStyles\n    }\n  };\n}\n\n/**\n * VisuallyHidden hides its children visually, while keeping content visible\n * to screen readers.\n */\nexport function VisuallyHidden(props: VisuallyHiddenProps): JSX.Element {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  let {children, elementType: Element = 'div', isFocusable, style, ...otherProps} = props;\n  let {visuallyHiddenProps} = useVisuallyHidden(props);\n\n  return <Element {...mergeProps(otherProps, visuallyHiddenProps)}>{children}</Element>;\n}\n"],"names":[],"version":3,"file":"VisuallyHidden.mjs.map"}

package/dist/types/exports/index.d.ts

@@ -59,6 +59,7 @@ export { useKeyboard } from '../src/interactions/useKeyboard';
 export { useMove } from '../src/interactions/useMove';
 export { usePress } from '../src/interactions/usePress';
 export { useLongPress } from '../src/interactions/useLongPress';
+export { useContextMenu } from '../src/interactions/useContextMenu';
 export { useFocusable, Focusable } from '../src/interactions/useFocusable';
 export { Pressable } from '../src/interactions/Pressable';
 export { useField } from '../src/label/useField';
@@ -116,6 +117,7 @@ export { useTag } from '../src/tag/useTag';
 export { useTagGroup } from '../src/tag/useTagGroup';
 export { useTextField } from '../src/textfield/useTextField';
 export { useToast } from '../src/toast/useToast';
+export { usePreviewTrigger } from '../src/tooltip/usePreviewTrigger';
 export { useToastRegion } from '../src/toast/useToastRegion';
 export { useToolbar } from '../src/toolbar/useToolbar';
 export { useTooltip } from '../src/tooltip/useTooltip';
@@ -129,6 +131,8 @@ export { useId } from '../src/utils/useId';
 export { useObjectRef } from '../src/utils/useObjectRef';
 export { RouterProvider } from '../src/utils/openLink';
 export { VisuallyHidden, useVisuallyHidden } from '../src/visually-hidden/VisuallyHidden';
+export { useTokenField, tokenFieldPositionToDOMRange, setTokenFieldSelection, getSelection } from '../src/tokenfield/useTokenField';
+export { useToken } from '../src/tokenfield/useToken';
 export type { AriaAutocompleteProps, AriaAutocompleteOptions, AutocompleteAria, CollectionOptions, InputProps } from '../src/autocomplete/useAutocomplete';
 export type { CollectionProps, CollectionBuilderProps } from '../src/collections/CollectionBuilder';
 export type { AriaBreadcrumbItemProps, BreadcrumbItemAria, BreadcrumbItemProps } from '../src/breadcrumbs/useBreadcrumbItem';
@@ -189,7 +193,9 @@ export type { FocusWithinProps, FocusWithinResult } from '../src/interactions/us
 export type { HoverProps, HoverResult } from '../src/interactions/useHover';
 export type { InteractOutsideProps } from '../src/interactions/useInteractOutside';
 export type { KeyboardProps, KeyboardResult } from '../src/interactions/useKeyboard';
+export type { KeyboardShortcutBindings } from '../src/interactions/createKeyboardShortcutHandler';
 export type { LongPressProps, LongPressResult } from '../src/interactions/useLongPress';
+export type { ContextMenuProps, ContextMenuAria, ContextMenuEvent } from '../src/interactions/useContextMenu';
 export type { MoveEvents, PressEvent, PressEvents, LongPressEvent, MoveStartEvent, MoveMoveEvent, MoveEndEvent, MoveEvent, HoverEvent, HoverEvents, FocusEvents, KeyboardEvents } from '@react-types/shared';
 export type { MoveResult } from '../src/interactions/useMove';
 export type { PressHookProps, PressProps, PressResult } from '../src/interactions/usePress';
@@ -252,8 +258,11 @@ export type { AriaToastProps, ToastAria } from '../src/toast/useToast';
 export type { AriaToolbarProps, ToolbarAria } from '../src/toolbar/useToolbar';
 export type { AriaTooltipProps, TooltipAria, TooltipProps } from '../src/tooltip/useTooltip';
 export type { TooltipTriggerAria } from '../src/tooltip/useTooltipTrigger';
+export type { AriaPreviewTriggerProps, PreviewTriggerTriggerAria } from '../src/tooltip/usePreviewTrigger';
 export type { TooltipTriggerProps } from 'react-stately/useTooltipTriggerState';
 export type { AriaTreeProps, TreeProps, TreeAria, AriaTreeOptions } from '../src/tree/useTree';
 export type { AriaTreeItemOptions, TreeItemAria } from '../src/tree/useTreeItem';
 export type { VisuallyHiddenAria, VisuallyHiddenProps } from '../src/visually-hidden/VisuallyHidden';
 export type { Key, Orientation, RangeValue } from '@react-types/shared';
+export type { TokenProps, TokenAria } from '../src/tokenfield/useToken';
+export type { AriaTokenFieldProps, TokenFieldAria } from '../src/tokenfield/useTokenField';

package/dist/types/exports/private/utils/domHelpers.d.ts

@@ -1 +1 @@
-export { getOwnerDocument, getOwnerWindow, isShadowRoot } from '../../../src/utils/domHelpers';
+export { addEvent, getOwnerDocument, getOwnerWindow, isShadowRoot } from '../../../src/utils/domHelpers';

package/dist/types/exports/private/utils/platform.d.ts

@@ -1 +1 @@
-export { isWebKit, isMac, isIPhone, isIPad, isIOS, isAppleDevice, isChrome, isAndroid, isFirefox } from '../../../src/utils/platform';
+export { isWebKit, isMac, isIPhone, isIPad, isIOS, isAppleDevice, isChrome, isAndroid, isFirefox, isSafari } from '../../../src/utils/platform';

package/dist/types/exports/private/utils/shadowdom/DOMFunctions.d.ts

@@ -1 +1 @@
-export { getEventTarget, nodeContains, isFocusWithin, getActiveElement } from '../../../../src/utils/shadowdom/DOMFunctions';
+export { getEventTarget, getPropagationTargets, nodeContains, isFocusWithin, getActiveElement } from '../../../../src/utils/shadowdom/DOMFunctions';

package/dist/types/exports/useContextMenu.d.ts

@@ -0,0 +1,2 @@
+export { useContextMenu } from '../src/interactions/useContextMenu';
+export type { ContextMenuProps, ContextMenuAria, ContextMenuEvent } from '../src/interactions/useContextMenu';

package/dist/types/exports/usePreviewTrigger.d.ts

@@ -0,0 +1,2 @@
+export { usePreviewTrigger } from '../src/tooltip/usePreviewTrigger';
+export type { AriaPreviewTriggerProps, PreviewTriggerTriggerAria } from '../src/tooltip/usePreviewTrigger';

package/dist/types/exports/useTokenField.d.ts

@@ -0,0 +1,4 @@
+export { useTokenField, tokenFieldPositionToDOMRange, setTokenFieldSelection } from '../src/tokenfield/useTokenField';
+export { useToken } from '../src/tokenfield/useToken';
+export type { TokenFieldAria, AriaTokenFieldProps } from '../src/tokenfield/useTokenField';
+export type { TokenAria, TokenProps } from '../src/tokenfield/useToken';

package/dist/types/src/button/useToggleButtonGroup.d.ts

@@ -16,6 +16,14 @@ export interface ToggleButtonGroupAria {
      */
     groupProps: DOMAttributes;
 }
+/**
+ * Provides the behavior and accessibility implementation for a toggle button group component.
+ * Toggle button groups allow users to select one or more options from a group.
+ *
+ * @param props - Props for the toggle button group.
+ * @param state - State for the toggle button group, as returned by `useToggleGroupState`.
+ * @param ref - A ref to the toggle button group element.
+ */
 export declare function useToggleButtonGroup(props: AriaToggleButtonGroupProps, state: ToggleGroupState, ref: RefObject<HTMLElement | null>): ToggleButtonGroupAria;
 export interface AriaToggleButtonGroupItemProps<E extends ElementType = 'button'> extends Omit<AriaToggleButtonProps<E>, 'id' | 'isSelected' | 'defaultSelected' | 'onChange'> {
     /** An identifier for the item in the `selectedKeys` of a ToggleButtonGroup. */

package/dist/types/src/combobox/useComboBox.d.ts

@@ -2,7 +2,7 @@ import { AriaButtonProps } from '../button/useButton';
 import { AriaLabelingProps, DOMAttributes, DOMProps, InputDOMProps, KeyboardDelegate, LayoutDelegate, RefObject, ValidationResult } from '@react-types/shared';
 import { AriaListBoxOptions } from '../listbox/useListBox';
 import { ComboBoxProps, ComboBoxState, SelectionMode } from 'react-stately/useComboBoxState';
-import { InputHTMLAttributes } from 'react';
+import { ElementType, InputHTMLAttributes } from 'react';
 export interface AriaComboBoxProps<T, M extends SelectionMode = 'single'> extends ComboBoxProps<T, M>, DOMProps, InputDOMProps, AriaLabelingProps {
     /** Whether keyboard navigation is circular. */
     shouldFocusWrap?: boolean;
@@ -16,6 +16,12 @@ export interface AriaComboBoxOptions<T, M extends SelectionMode = 'single'> exte
     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;
     /**

package/dist/types/src/dialog/useDialog.d.ts

@@ -12,6 +12,8 @@ export interface DialogAria {
     dialogProps: DOMAttributes;
     /** Props for the dialog title element. */
     titleProps: DOMAttributes;
+    /** Props for the dialog content/description element. Used for aria-describedby on alertdialogs. */
+    contentProps: DOMAttributes;
 }
 /**
  * Provides the behavior and accessibility implementation for a dialog component.

package/dist/types/src/dnd/utils.d.ts

@@ -1,5 +1,5 @@
 import { DROP_OPERATION } from './constants';
-import { DirectoryDropItem, DragItem, DropItem, FileDropItem, DragTypes as IDragTypes, Key, RefObject, TextDropItem } from '@react-types/shared';
+import { DirectoryDropItem, DragItem, DragType, DropItem, FileDropItem, DragTypes as IDragTypes, Key, RefObject, TextDropItem } from '@react-types/shared';
 import { DroppableCollectionState } from 'react-stately/useDroppableCollectionState';
 interface DroppableCollectionMap {
     id: string;
@@ -17,7 +17,7 @@ export declare class DragTypes implements IDragTypes {
     private types;
     private includesUnknownTypes;
     constructor(dataTransfer: DataTransfer);
-    has(type: string | symbol): boolean;
+    has(type: DragType | DragType[]): boolean;
 }
 export declare function readFromDataTransfer(dataTransfer: DataTransfer): DropItem[];
 /** Returns whether a drop item contains text data. */

package/dist/types/src/grid/useGrid.d.ts

@@ -49,6 +49,13 @@ export interface GridProps extends DOMProps, AriaLabelingProps {
     escapeKeyBehavior?: 'clearSelection' | 'none';
     /** Whether selection should occur on press up instead of press down. */
     shouldSelectOnPressUp?: boolean;
+    /**
+     * Whether keyboard navigation to focusable elements within grid cells is
+     * via arrow keys or the tab key.
+     *
+     * @default 'arrow'
+     */
+    keyboardNavigationBehavior?: 'arrow' | 'tab';
 }
 export interface GridAria {
     /** Props for the grid element. */

package/dist/types/src/grid/useGridCell.d.ts

@@ -11,9 +11,16 @@ export interface GridCellProps {
     isVirtualized?: boolean;
     /**
      * Whether the cell or its first focusable child element should be focused when the grid cell is
-     * focused.
+     * 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 collection uses
+     * tab keyboard navigation. Allows users to navigate between rows and cells with arrow keys while
+     * focus is on an interactive child element within the cell.
+     */
+    allowsArrowNavigation?: boolean;
     /** Whether selection should occur on press up instead of press down. */
     shouldSelectOnPressUp?: boolean;
     /** Indicates how many columns the data cell spans. */

package/dist/types/src/grid/utils.d.ts

@@ -8,6 +8,7 @@ interface GridMapShared {
         onCellAction?: (key: Key) => void;
     };
     shouldSelectOnPressUp?: boolean;
+    keyboardNavigationBehavior?: 'arrow' | 'tab';
 }
 export declare const gridMap: WeakMap<GridState<unknown, GridCollection<unknown>>, GridMapShared>;
 export {};

package/dist/types/src/gridlist/useGridList.d.ts

@@ -71,6 +71,13 @@ export interface AriaGridListOptions<T> extends Omit<AriaGridListProps<T>, 'chil
      * @default 'action'
      */
     linkBehavior?: 'action' | 'selection' | 'override';
+    /**
+     * Which item in the collection to focus when tabbing into the collection. Overrides default
+     * roving tab index like behavior.
+     *
+     * @private
+     */
+    UNSTABLE_focusOnEntry?: 'first' | 'last';
 }
 export interface GridListAria {
     /** Props for the grid element. */

package/dist/types/src/gridlist/useGridListItem.d.ts

@@ -14,6 +14,19 @@ export interface AriaGridListItemOptions {
     shouldSelectOnPressUp?: boolean;
     /** Whether this item has children, even if not loaded yet. */
     hasChildItems?: boolean;
+    /**
+     * Whether the row or its first focusable child element should be focused when the row is
+     * focused.
+     *
+     * @default 'row'
+     */
+    focusMode?: 'child' | 'row';
+    /**
+     * Whether the row should support arrow key navigation even when the containing collection uses
+     * tab keyboard navigation. Allows users to navigate between rows with arrow keys while
+     * focus is on an interactive child element within the row.
+     */
+    allowsArrowNavigation?: boolean;
 }
 export interface GridListItemAria extends SelectableItemStates {
     /** Props for the list row element. */

package/dist/types/src/interactions/createKeyboardShortcutHandler.d.ts

@@ -0,0 +1,56 @@
+import { KeyboardEvent } from '@react-types/shared';
+export type KeyboardShortcutAction = (e: KeyboardEvent) => void | boolean | Partial<{
+    shouldContinuePropagation?: boolean;
+    shouldPreventDefault?: boolean;
+}>;
+/** Maps shortcut strings (e.g. `"Mod+s"`, `"Control+Shift+a"`) to handlers. */
+export type KeyboardShortcutBindings = Record<string, KeyboardShortcutAction>;
+export interface ParsedKeyboardShortcut {
+    shift: boolean;
+    alt: boolean;
+    ctrl: boolean;
+    meta: boolean;
+    /**
+     * Platform primary: Cmd on Mac, Control on Windows/Linux — expands to Meta or Control in
+     * canonical form.
+     */
+    mod: boolean;
+    key: string;
+}
+/**
+ * Builds the set of canonical modifier tokens for a binding.
+ * `Mod` contributes Meta (Mac) or Ctrl (non-Mac); explicit Ctrl/Meta add those keys too.
+ */
+export declare function modifierSetFromParsed(parsed: ParsedKeyboardShortcut): Set<string>;
+/** Modifier set from a keydown event (native flags only). */
+export declare function modifierSetFromEvent(e: KeyboardEvent): Set<string>;
+/**
+ * Parses a shortcut like `"Mod+Shift+z"`, `"Ctrl+Alt+Enter"`, or `"Escape"`.
+ * Modifiers are case-insensitive; order does not matter. `control` is an alias for `ctrl`.
+ */
+export declare function parseKeyboardShortcut(spec: string): ParsedKeyboardShortcut;
+/** Canonical shortcut string for a binding (modifiers sorted: Alt, Ctrl, Meta, Shift, then key). */
+export declare function canonicalKeyboardShortcut(parsed: ParsedKeyboardShortcut): string;
+/** Canonical shortcut string for a keydown event. */
+export declare function keyboardEventToCanonicalShortcut(e: KeyboardEvent): string;
+/**
+ * Returns a keydown handler that runs the action only for an exact modifier+key match.
+ * Modifier order in the string does not matter (`Shift+Mod+a` ≡ `Mod+Shift+a`).
+ * Any combination of **Shift**, **Alt**, **Ctrl**, **Meta**, and **Mod** is allowed; **Mod** means
+ * Cmd on Apple platforms and Ctrl on Windows/Linux (same as before). **control** aliases **ctrl**.
+ *
+ * Duplicate bindings that normalize to the same shortcut: later object entries win.
+ *
+ * @example
+ *   ```tsx
+ *   let onKeyDown = createKeyboardShortcutHandler({
+ *     'Mod+s': e => {
+ *       e.preventDefault();
+ *       save();
+ *     },
+ *     'Ctrl+Shift+k': () => palette(),
+ *     'Meta+Alt+ArrowLeft': () => back()
+ *   });
+ *   ```;
+ */
+export declare function createKeyboardShortcutHandler(bindings: KeyboardShortcutBindings): (e: KeyboardEvent) => void;

package/dist/types/src/interactions/useContextMenu.d.ts

@@ -0,0 +1,21 @@
+import { HTMLAttributes } from 'react';
+export interface ContextMenuEvent {
+    /** The target element on which the event was triggered. */
+    target: Element;
+    /** X position relative to the target. */
+    x: number;
+    /** Y position relative to the target. */
+    y: number;
+}
+export interface ContextMenuProps {
+    /** Event that is called when a context menu is triggered. */
+    onContextMenu?: (e: ContextMenuEvent) => void;
+}
+export interface ContextMenuAria {
+    /** Props to spread on the target element. */
+    contextMenuProps: HTMLAttributes<HTMLElement>;
+}
+/**
+ * Handles context menu events across mouse, touch, keyboard, and screen reader interactions.
+ */
+export declare function useContextMenu(props: ContextMenuProps): ContextMenuAria;

package/dist/types/src/interactions/useKeyboard.d.ts

@@ -1,7 +1,14 @@
+import { KeyboardShortcutBindings } from './createKeyboardShortcutHandler';
 import { DOMAttributes, KeyboardEvents } from '@react-types/shared';
 export 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;
 }
 export interface KeyboardResult {
     /** Props to spread onto the target element. */

package/dist/types/src/interactions/useLongPress.d.ts

@@ -2,6 +2,8 @@ import { DOMAttributes, LongPressEvent } from '@react-types/shared';
 export interface LongPressProps {
     /** Whether long press events should be disabled. */
     isDisabled?: boolean;
+    /** Which pointer type to listen for. By default, both mouse and touch are listened for. */
+    pointerType?: 'mouse' | 'touch';
     /** Handler that is called when a long press interaction starts. */
     onLongPressStart?: (e: LongPressEvent) => void;
     /**

package/dist/types/src/menu/useMenu.d.ts

@@ -6,7 +6,7 @@ export interface MenuProps<T> extends CollectionBase<T>, MultipleSelection {
     /** Whether keyboard navigation is circular. */
     shouldFocusWrap?: boolean;
     /** Handler that is called when an item is selected. */
-    onAction?: (key: Key) => void;
+    onAction?: (key: Key, value: T) => void;
     /** Handler that is called when the menu should close after selecting an item. */
     onClose?: () => void;
 }

package/dist/types/src/menu/utils.d.ts

@@ -2,7 +2,7 @@ import { Key } from '@react-types/shared';
 import { TreeState } from 'react-stately/useTreeState';
 interface MenuData {
     onClose?: () => void;
-    onAction?: (key: Key) => void;
+    onAction?: (key: Key, value: any) => void;
     shouldUseVirtualFocus?: boolean;
 }
 export declare const menuData: WeakMap<TreeState<unknown>, MenuData>;

package/dist/types/src/overlays/calculatePosition.d.ts

@@ -33,6 +33,7 @@ interface PositionOpts {
     crossOffset: number;
     maxHeight?: number;
     arrowBoundaryOffset?: number;
+    targetRect?: Offset | null | undefined;
 }
 export interface PositionResult {
     position: Position;

package/dist/types/src/overlays/useOverlayPosition.d.ts

@@ -91,6 +91,14 @@ export interface AriaPositionProps extends PositionProps {
      * @default 0
      */
     arrowBoundaryOffset?: number;
+    /**
+     * Overrides the target element's bounding rectangle. Useful for positioning relative to
+     * a specific point such as the mouse cursor (e.g. context menus) or text selection.
+     *
+     * @default target.getBoundingClientRect()
+     * @param target - The target element.
+     */
+    getTargetRect?: (target: Element) => DOMRect | null | undefined;
 }
 export interface PositionAria {
     /** Props for the overlay container element. */

package/dist/types/src/overlays/usePopover.d.ts

@@ -1,7 +1,8 @@
 import { AriaPositionProps, PlacementAxis } from './useOverlayPosition';
 import { DOMAttributes, RefObject } from '@react-types/shared';
+import { FocusWithinProps } from '../interactions/useFocusWithin';
 import { OverlayTriggerState } from 'react-stately/useOverlayTriggerState';
-export interface AriaPopoverProps extends Omit<AriaPositionProps, 'isOpen' | 'onClose' | 'targetRef' | 'overlayRef'> {
+export 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.
      */

package/dist/types/src/selection/ListKeyboardDelegate.d.ts

@@ -33,6 +33,7 @@ export declare class ListKeyboardDelegate<T> implements KeyboardDelegate {
     private findKey;
     private isSameRow;
     private isSameColumn;
+    private isReversed;
     getKeyBelow(key: Key, options?: {
         includeDisabled?: boolean;
     }): Key | null;

package/dist/types/src/selection/useSelectableCollection.d.ts

@@ -81,6 +81,13 @@ export interface AriaSelectableCollectionOptions {
      * @default 'action'
      */
     linkBehavior?: 'action' | 'selection' | 'override';
+    /**
+     * Which item in the collection to focus when tabbing into the collection. Overrides default
+     * roving tab index like behavior.
+     *
+     * @private
+     */
+    UNSTABLE_focusOnEntry?: 'first' | 'last';
 }
 export interface SelectableCollectionAria {
     /** Props for the collection element. */

package/dist/types/src/table/useTableCell.d.ts

@@ -18,6 +18,18 @@ export interface AriaTableCellProps {
      * @deprecated
      */
     onAction?: () => void;
+    /**
+     * 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 rows and cells with arrow keys while
+     * focus is on an interactive child element within the cell.
+     */
+    allowsArrowNavigation?: boolean;
 }
 export interface TableCellAria {
     /** Props for the table cell element. */

package/dist/types/src/table/useTableColumnHeader.d.ts

@@ -12,6 +12,18 @@ export interface AriaTableColumnHeaderProps<T> {
      * virtual scroller.
      */
     isVirtualized?: boolean;
+    /**
+     * 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 header should support arrow key navigation even when the containing table
+     * uses tab keyboard navigation. Allows users to navigate between columns with arrow keys while
+     * focus is on an interactive child element within the cell.
+     */
+    allowsArrowNavigation?: boolean;
 }
 export interface TableColumnHeaderAria {
     /** Props for the [column header](https://www.w3.org/TR/wai-aria-1.1/#columnheader) element. */

package/dist/types/src/table/useTableColumnResize.d.ts

@@ -9,6 +9,11 @@ export interface TableColumnResizeAria {
     resizerProps: DOMAttributes;
     /** Whether this column is currently being resized. */
     isResizing: boolean;
+    /**
+     * Whether this column is currently being resized via a mouse drag (e.g. to render a cursor
+     * overlay).
+     */
+    isMouseResizing: boolean;
 }
 export interface AriaTableColumnResizeProps<T> {
     /**

package/dist/types/src/tokenfield/useToken.d.ts

@@ -0,0 +1,14 @@
+import { HTMLAttributes, RefObject } from 'react';
+export interface TokenProps {
+}
+export interface TokenAria {
+    /** Props for the token element. */
+    tokenProps: HTMLAttributes<HTMLSpanElement>;
+    /** Whether the token is currently selected. */
+    isSelected: boolean;
+}
+/**
+ * Provides the behavior and accessibility implementation for a token within a token field.
+ * A token field allows users to enter text with inline tokens.
+ */
+export declare function useToken(_props: TokenProps, _state: any, ref: RefObject<HTMLSpanElement | null>): TokenAria;

package/dist/types/src/tokenfield/useTokenField.d.ts

@@ -0,0 +1,57 @@
+import { AriaLabelingProps, DOMAttributes, FocusableProps } from '@react-types/shared';
+import { ClipboardEventHandler, HTMLAttributes, RefObject } from 'react';
+import { Position, TokenFieldProps, TokenFieldState, TokenFieldValue } from 'react-stately/useTokenFieldState';
+export interface AriaTokenFieldProps<T extends TokenFieldValue = TokenFieldValue> extends TokenFieldProps<T>, FocusableProps, AriaLabelingProps {
+    /**
+     * The accessibility role of the token field.
+     *
+     * @default 'textbox'
+     */
+    role?: 'textbox' | 'searchbox' | 'combobox';
+    /** Whether the token field allows newlines. */
+    allowsNewlines?: boolean;
+    /** Whether the token field is read only. */
+    isReadOnly?: boolean;
+    /** Whether the token field is disabled. */
+    isDisabled?: boolean;
+    /** A function that is called when the user presses the Enter key. */
+    onSubmit?: () => void;
+    /** Handler that is called when a key is pressed. */
+    onKeyDown?: (e: React.KeyboardEvent<HTMLDivElement>) => void;
+    /** Handler that is called when a key is released. */
+    onKeyUp?: (e: React.KeyboardEvent<HTMLDivElement>) => void;
+    /**
+     * Handler that is called when the user copies text. See
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/oncopy).
+     */
+    onCopy?: ClipboardEventHandler<T>;
+    /**
+     * Handler that is called when the user cuts text. See
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/oncut).
+     */
+    onCut?: ClipboardEventHandler<T>;
+    /**
+     * Handler that is called when the user pastes text. See
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/onpaste).
+     */
+    onPaste?: ClipboardEventHandler<T>;
+}
+export interface TokenFieldAria {
+    /** Props for the token field's input element. */
+    tokenFieldProps: HTMLAttributes<HTMLDivElement>;
+    /** Props for the text field's visible label element, if any. */
+    labelProps: DOMAttributes;
+    /** Props for the text field's description element, if any. */
+    descriptionProps: DOMAttributes;
+}
+/**
+ * Provides the behavior and accessibility implementation for a token field.
+ * A token field allows users to enter text with inline tokens.
+ *
+ * @param props - Props for the token field.
+ * @param state - State for the token field, as returned by `useTokenFieldState`.
+ */
+export declare function useTokenField<T extends TokenFieldValue = TokenFieldValue>(props: AriaTokenFieldProps<T>, state: TokenFieldState, ref: RefObject<HTMLDivElement | null>): TokenFieldAria;
+export declare function getSelection(container: Element): [Position, Position] | null;
+export declare function setTokenFieldSelection(root: Element, start: Position, end: Position, fireEvent?: boolean): void;
+export declare function tokenFieldPositionToDOMRange(root: Element, pos: Position): Range;

package/dist/types/src/tooltip/usePreviewTrigger.d.ts

@@ -0,0 +1,27 @@
+import { DOMAttributes, FocusableElement, RefObject } from '@react-types/shared';
+import { AriaPopoverProps } from '../overlays/usePopover';
+import { TooltipTriggerProps, TooltipTriggerState } from 'react-stately/useTooltipTriggerState';
+export interface AriaPreviewTriggerProps extends Omit<TooltipTriggerProps, 'trigger' | 'shouldCloseOnPress'> {
+}
+export interface AriaPreviewTriggerOptions extends AriaPreviewTriggerProps {
+    /** A ref to the trigger element (e.g. a Link). */
+    triggerRef: RefObject<FocusableElement | null>;
+    /** A ref to the popover element. */
+    popoverRef: RefObject<Element | null>;
+}
+export interface PreviewTriggerTriggerAria {
+    /**
+     * Props for the trigger element (e.g. a Link).
+     */
+    triggerProps: DOMAttributes;
+    /**
+     * Props for the popover overlay element.
+     */
+    popoverProps: Omit<AriaPopoverProps, 'triggerRef' | 'popoverRef'> & DOMAttributes;
+}
+/**
+ * Provides the behavior and accessibility implementation for a preview trigger.
+ * A preview trigger displays a popover on hover, focus, or long press. Unlike a
+ * tooltip, the popover may contain interactive content.
+ */
+export declare function usePreviewTrigger(props: AriaPreviewTriggerOptions, state: TooltipTriggerState): PreviewTriggerTriggerAria;

package/dist/types/src/tooltip/useSafeArea.d.ts

@@ -0,0 +1,26 @@
+import { RefObject } from '@react-types/shared';
+interface SafeAreaOptions {
+    /** Ref for the trigger element. */
+    triggerRef: RefObject<Element | null>;
+    /** Ref for the overlay element. */
+    overlayRef: RefObject<Element | null>;
+    /** Whether the overlay is open. */
+    isOpen: boolean;
+    /** Whether this feature is disabled. */
+    isDisabled?: boolean;
+    /**
+     * Called on pointer move (and when the pointer leaves the document) with whether the pointer is
+     * currently within the "safe area" — the trigger, the overlay, or the region between them. This
+     * lets an overlay stay open while the pointer travels from the trigger to the overlay, even
+     * diagonally and regardless of placement.
+     */
+    onSafeAreaChange: (isInSafeArea: boolean) => void;
+}
+/**
+ * Tracks whether the pointer is within a "safe area" connecting a trigger and its overlay, so the
+ * overlay can stay open while the pointer moves between them. The safe area is the union of the
+ * trigger rect, the overlay rect, and the convex hull connecting the two (a polygon), which works
+ * for any placement of the overlay relative to the trigger.
+ */
+export declare function useSafeArea(options: SafeAreaOptions): void;
+export {};

package/dist/types/src/tree/useTree.d.ts

@@ -3,7 +3,7 @@ import { DOMAttributes, KeyboardDelegate, RefObject } from '@react-types/shared'
 import { TreeState } from 'react-stately/useTreeState';
 export interface TreeProps<T> extends GridListProps<T> {
 }
-export interface AriaTreeProps<T> extends Omit<AriaGridListProps<T>, 'keyboardNavigationBehavior'> {
+export interface AriaTreeProps<T> extends AriaGridListProps<T> {
 }
 export interface AriaTreeOptions<T> extends Omit<AriaGridListOptions<T>, 'children' | 'shouldFocusWrap'> {
     /**