@react-spectrum/s2 0.11.1 → 0.12.0

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import React, { CSSProperties, ReactNode, Context, RefAttributes, ForwardRefExoticComponent, HTMLAttributeReferrerPolicy, ComponentType, FunctionComponent, SVGProps, RefObject, JSX, ReactElement } from "react";
 import { AriaLabelingProps, DOMProps, DOMRefValue, GlobalDOMAttributes, SpectrumLabelableProps, FocusableRefValue, LinkDOMProps, Key, LoadingState, HelpTextProps, Orientation, ValueBase, AsyncLoadable, LabelPosition, InputDOMProps, RangeValue } from "@react-types/shared";
-import { ContextValue, SlotProps, FormProps as _FormProps1, ButtonProps as _ButtonProps1, DisclosurePanelProps as _DisclosurePanelProps1, DisclosureProps as _DisclosureProps1, DisclosureGroupProps, CheckboxProps as _CheckboxProps1, SeparatorProps, PopoverProps as _PopoverProps1, DialogProps as _DialogProps1, MenuItemProps as _MenuItemProps1, MenuProps as _MenuProps1, MenuSectionProps as _MenuSectionProps1, MenuTriggerProps as _MenuTriggerProps1, SubmenuTriggerProps as _SubmenuTriggerProps1, ProgressBarProps as _ProgressBarProps1, LinkProps as _LinkProps1, BreadcrumbProps as _BreadcrumbProps1, BreadcrumbsProps as _BreadcrumbsProps1, DialogTriggerProps as _DialogTriggerProps1, CalendarProps as _CalendarProps1, DateValue, GridListItemProps, GridListProps, CheckboxGroupProps as _CheckboxGroupProps1, ColorAreaProps as _ColorAreaProps1, ColorFieldProps as _ColorFieldProps1, ColorSliderProps as _ColorSliderProps1, ColorSwatchProps as _ColorSwatchProps1, Color, ColorWheelProps as _ColorWheelProps1, ComboBoxProps as _ComboBoxProps1, ListBoxItemProps, ListBoxProps, SectionProps, DateFieldProps as _DateFieldProps1, DateRangePickerProps as _DateRangePickerProps1, DropZoneProps as _DropZoneProps1, MeterProps as _MeterProps1, NumberFieldProps as _NumberFieldProps1, SelectProps, RadioProps as _RadioProps1, RadioGroupProps as _RadioGroupProps1, RangeCalendarProps as _RangeCalendarProps2, SliderProps as _SliderProps1, SearchFieldProps as _SearchFieldProps1, SwitchProps as _SwitchProps1, Key as _Key1, CellProps as _CellProps1, ColumnProps as _ColumnProps1, RowProps as _RowProps1, TableBodyProps as _TableBodyProps1, TableHeaderProps as _TableHeaderProps1, TableProps, TabListProps as _TabListProps1, TabPanelProps as _TabPanelProps1, TabProps as _TabProps1, TabsProps as _TabsProps1, TagGroupProps as _TagGroupProps1, TagProps as _TagProps1, TagListProps, TextFieldProps as _TextFieldProps1, TimeFieldProps as _TimeFieldProps1, TimeValue, ToastOptions as _ToastOptions1, ToastRegionProps, ToggleButtonGroupProps as _ToggleButtonGroupProps1, ToggleButtonProps as _ToggleButtonProps1, TooltipProps as _TooltipProps1, TooltipTriggerComponentProps, TreeItemProps, TreeProps, TreeItemContentProps, TreeLoadMoreItemProps, DatePickerProps as _DatePickerProps1 } from "react-aria-components";
+import { ContextValue, SlotProps, ProgressBarProps as _ProgressBarProps1, FormProps as _FormProps1, LinkProps as _LinkProps1, ButtonProps as _ButtonProps1, DisclosurePanelProps as _DisclosurePanelProps1, DisclosureProps as _DisclosureProps1, DisclosureGroupProps, CheckboxProps as _CheckboxProps1, SeparatorProps, PopoverProps as _PopoverProps1, DialogProps as _DialogProps1, MenuItemProps as _MenuItemProps1, MenuProps as _MenuProps1, MenuSectionProps as _MenuSectionProps1, MenuTriggerProps as _MenuTriggerProps1, SubmenuTriggerProps as _SubmenuTriggerProps1, BreadcrumbProps as _BreadcrumbProps1, BreadcrumbsProps as _BreadcrumbsProps1, DialogTriggerProps as _DialogTriggerProps1, CalendarProps as _CalendarProps1, DateValue, GridListItemProps, GridListProps, CheckboxGroupProps as _CheckboxGroupProps1, ColorAreaProps as _ColorAreaProps1, ColorFieldProps as _ColorFieldProps1, InputProps, ColorSliderProps as _ColorSliderProps1, ColorSwatchProps as _ColorSwatchProps1, Color, ColorWheelProps as _ColorWheelProps1, ComboBoxProps as _ComboBoxProps1, ListBoxItemProps, ListBoxProps, SectionProps, DateFieldProps as _DateFieldProps1, DateRangePickerProps as _DateRangePickerProps1, DropZoneProps as _DropZoneProps1, MeterProps as _MeterProps1, NumberFieldProps as _NumberFieldProps1, SelectProps, RadioProps as _RadioProps1, RadioGroupProps as _RadioGroupProps1, RangeCalendarProps as _RangeCalendarProps2, SliderProps as _SliderProps1, SearchFieldProps as _SearchFieldProps1, SwitchProps as _SwitchProps1, Key as _Key1, CellProps as _CellProps1, ColumnProps as _ColumnProps1, RowProps as _RowProps1, TableBodyProps as _TableBodyProps1, TableHeaderProps as _TableHeaderProps1, TableProps, TabListProps as _TabListProps1, TabPanelProps as _TabPanelProps1, TabProps as _TabProps1, TabsProps as _TabsProps1, TagGroupProps as _TagGroupProps1, TagProps as _TagProps1, TagListProps, TextFieldProps as _TextFieldProps1, TimeFieldProps as _TimeFieldProps1, TimeValue, ToastOptions as _ToastOptions1, ToastRegionProps, ToggleButtonGroupProps as _ToggleButtonGroupProps1, ToggleButtonProps as _ToggleButtonProps1, TooltipProps as _TooltipProps1, TooltipTriggerComponentProps, TreeItemProps, TreeProps, TreeItemContentProps, TreeLoadMoreItemProps, DatePickerProps as _DatePickerProps1 } from "react-aria-components";
 import { ColorScheme, Router } from "@react-types/provider";
 import { TextFieldRef } from "@react-types/textfield";
 import { RangeCalendarProps as _RangeCalendarProps1, CalendarProps as _CalendarProps2 } from "../";
@@ -9,7 +9,7 @@ import { ColumnSize } from "@react-types/table";
 type StyleString<P = string> = string & {
     properties: P;
 };
-declare const allowedOverrides: readonly ["margin", "marginStart", "marginEnd", "marginTop", "marginBottom", "marginX", "marginY", "flexGrow", "flexShrink", "flexBasis", "justifySelf", "alignSelf", "order", "gridArea", "gridRowStart", "gridRowEnd", "gridColumnStart", "gridColumnEnd", "position", "zIndex", "top", "bottom", "inset", "insetX", "insetY", "insetStart", "insetEnd"];
+declare const allowedOverrides: readonly ["margin", "marginStart", "marginEnd", "marginTop", "marginBottom", "marginX", "marginY", "flexGrow", "flexShrink", "flexBasis", "justifySelf", "alignSelf", "order", "gridArea", "gridRowStart", "gridRowEnd", "gridColumnStart", "gridColumnEnd", "position", "zIndex", "top", "bottom", "inset", "insetX", "insetY", "insetStart", "insetEnd", "visibility"];
 declare const widthProperties: readonly ["width", "minWidth", "maxWidth"];
 declare const heightProperties: readonly ["size", "height", "minHeight", "maxHeight"];
 type StylesProp = StyleString<(typeof allowedOverrides)[number] | (typeof widthProperties)[number]>;
@@ -127,6 +127,16 @@ export interface ImageProps extends UnsafeStyles, SlotProps {
      * [See MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#referrerpolicy).
      */
     referrerPolicy?: HTMLAttributeReferrerPolicy;
+    /**
+     * The intrinsic width of the image.
+     * [See MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img#width).
+     */
+    width?: number;
+    /**
+     * The intrinsic height of the image.
+     * [See MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img#height).
+     */
+    height?: number;
     /** Spectrum-defined styles, returned by the `style()` macro. */
     styles?: StyleString;
     /** A function that is called to render a fallback when the image fails to load. */
@@ -141,6 +151,9 @@ interface ImageContextValue extends ImageProps {
     hidden?: boolean;
 }
 export const ImageContext: Context<ContextValue<Partial<ImageContextValue>, HTMLDivElement>>;
+/**
+ * An image with support for skeleton loading and custom error states.
+ */
 export const Image: ForwardRefExoticComponent<ImageProps & RefAttributes<HTMLDivElement>>;
 export interface AvatarProps extends UnsafeStyles, DOMProps, SlotProps {
     /** Text description of the avatar. */
@@ -210,6 +223,30 @@ export const NotificationBadge: React.ForwardRefExoticComponent<NotificationBadg
 export function pressScale<R extends {
     isPressed: boolean;
 }>(ref: RefObject<HTMLElement | null>, style?: CSSProperties | ((renderProps: R) => CSSProperties)): (renderProps: R) => CSSProperties;
+interface ProgressCircleStyleProps {
+    /**
+     * The size of the ProgressCircle.
+     *
+     * @default 'M'
+     */
+    size?: 'S' | 'M' | 'L';
+    /** The static color style to apply. Useful when the button appears over a color background. */
+    staticColor?: 'black' | 'white' | 'auto';
+    /**
+     * Whether presentation is indeterminate when progress isn't known.
+     */
+    isIndeterminate?: boolean;
+}
+export const ProgressCircleContext: Context<ContextValue<Partial<ProgressCircleProps>, DOMRefValue<HTMLDivElement>>>;
+export interface ProgressCircleProps extends Omit<_ProgressBarProps1, 'children' | 'style' | 'valueLabel' | 'formatOptions' | 'label' | 'className' | keyof GlobalDOMAttributes>, ProgressCircleStyleProps, UnsafeStyles {
+    /** Spectrum-defined styles, returned by the `style()` macro. */
+    styles?: StylesPropWithHeight;
+}
+/**
+ * ProgressCircles show the progression of a system operation such as downloading, uploading, or processing, in a visual way.
+ * They can represent determinate or indeterminate progress.
+ */
+export const ProgressCircle: ForwardRefExoticComponent<ProgressCircleProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
 interface ContentProps extends UnsafeStyles, SlotProps {
     children: ReactNode;
     styles?: StyleString;
@@ -250,6 +287,48 @@ export interface FormProps extends FormStyleProps, Omit<_FormProps1, 'className'
  * Forms allow users to enter data that can be submitted while providing alignment and styling for form fields.
  */
 export const Form: ForwardRefExoticComponent<FormProps & RefAttributes<DOMRefValue<HTMLFormElement>>>;
+interface ButtonStyleProps {
+    /**
+     * The [visual style](https://spectrum.adobe.com/page/button/#Options) of the button.
+     *
+     * @default 'primary'
+     */
+    variant?: 'primary' | 'secondary' | 'accent' | 'negative' | 'premium' | 'genai';
+    /**
+     * The background style of the Button.
+     *
+     * @default 'fill'
+     */
+    fillStyle?: 'fill' | 'outline';
+    /**
+     * The size of the Button.
+     *
+     * @default 'M'
+     */
+    size?: 'S' | 'M' | 'L' | 'XL';
+    /** The static color style to apply. Useful when the Button appears over a color background. */
+    staticColor?: 'white' | 'black' | 'auto';
+}
+export interface ButtonProps extends Omit<_ButtonProps1, 'className' | 'style' | 'children' | 'onHover' | 'onHoverStart' | 'onHoverEnd' | 'onHoverChange' | 'onClick' | keyof GlobalDOMAttributes>, StyleProps, ButtonStyleProps {
+    /** The content to display in the Button. */
+    children: ReactNode;
+}
+export interface LinkButtonProps extends Omit<_LinkProps1, 'className' | 'style' | 'children' | 'onClick' | keyof GlobalDOMAttributes>, StyleProps, ButtonStyleProps {
+    /** The content to display in the Button. */
+    children: ReactNode;
+}
+export const ButtonContext: Context<ContextValue<Partial<ButtonProps>, FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>>;
+export const LinkButtonContext: Context<ContextValue<Partial<ButtonProps>, FocusableRefValue<HTMLAnchorElement, HTMLAnchorElement>>>;
+/**
+ * Buttons allow users to perform an action.
+ * They have multiple styles for various needs, and are ideal for calling attention to
+ * where a user needs to do something in order to move forward in a flow.
+ */
+export const Button: ForwardRefExoticComponent<ButtonProps & RefAttributes<FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>>;
+/**
+ * A LinkButton combines the functionality of a link with the appearance of a button. Useful for allowing users to navigate to another page.
+ */
+export const LinkButton: ForwardRefExoticComponent<LinkButtonProps & RefAttributes<FocusableRefValue<HTMLAnchorElement, HTMLAnchorElement>>>;
 interface ActionButtonStyleProps {
     /**
      * The size of the ActionButton.
@@ -262,7 +341,7 @@ interface ActionButtonStyleProps {
     /** Whether the button should be displayed with a [quiet style](https://spectrum.adobe.com/page/action-button/#Quiet). */
     isQuiet?: boolean;
 }
-export interface ActionButtonProps extends Omit<_ButtonProps1, 'className' | 'style' | 'children' | 'onHover' | 'onHoverStart' | 'onHoverEnd' | 'onHoverChange' | 'isPending' | 'onClick' | keyof GlobalDOMAttributes>, StyleProps, ActionButtonStyleProps {
+export interface ActionButtonProps extends Omit<_ButtonProps1, 'className' | 'style' | 'children' | 'onHover' | 'onHoverStart' | 'onHoverEnd' | 'onHoverChange' | 'onClick' | keyof GlobalDOMAttributes>, StyleProps, ActionButtonStyleProps {
     /** The content to display in the ActionButton. */
     children: ReactNode;
 }
@@ -370,6 +449,9 @@ export interface ActionBarProps extends SlotProps {
     scrollRef?: RefObject<HTMLElement | null>;
 }
 export const ActionBarContext: Context<ContextValue<Partial<ActionBarProps>, DOMRefValue<HTMLDivElement>>>;
+/**
+ * Action bars are used for single and bulk selection patterns when a user needs to perform actions on one or more items at the same time.
+ */
 export const ActionBar: ForwardRefExoticComponent<ActionBarProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
 interface CheckboxStyleProps {
     /**
@@ -441,7 +523,8 @@ export interface ProviderProps extends UnsafeStyles {
      */
     elementType?: keyof JSX.IntrinsicElements;
 }
-export function Provider(props: ProviderProps): ReactNode;
+export const ColorSchemeContext: Context<"light dark" | ColorScheme | null>;
+export function Provider(props: ProviderProps): JSX.Element;
 export interface PopoverProps extends UnsafeStyles, Omit<_PopoverProps1, 'arrowSize' | 'isNonModal' | 'arrowBoundaryOffset' | 'isKeyboardDismissDisabled' | 'shouldCloseOnInteractOutside' | 'shouldUpdatePosition' | keyof GlobalDOMAttributes> {
     styles?: StyleString;
     /**
@@ -455,12 +538,20 @@ export interface PopoverProps extends UnsafeStyles, Omit<_PopoverProps1, 'arrowS
      */
     size?: 'S' | 'M' | 'L';
 }
-interface PopoverDialogProps extends Pick<PopoverProps, 'size' | 'hideArrow' | 'placement' | 'shouldFlip' | 'containerPadding' | 'offset' | 'crossOffset' | 'triggerRef' | 'isOpen' | 'onOpenChange'>, Omit<_DialogProps1, 'className' | 'style' | keyof GlobalDOMAttributes>, StyleProps {
+type PopoverStylesProp = StyleString<((typeof widthProperties)[number] | (typeof heightProperties)[number])>;
+interface PopoverDialogProps extends Pick<PopoverProps, 'children' | 'size' | 'hideArrow' | 'placement' | 'shouldFlip' | 'containerPadding' | 'offset' | 'crossOffset' | 'triggerRef' | 'isOpen' | 'onOpenChange'>, Omit<_DialogProps1, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, UnsafeStyles {
+    /**
+     * The amount of padding around the contents of the dialog.
+     * @default 'default'
+     */
+    padding?: 'default' | 'none';
+    /** Spectrum-defined styles, returned by the `style()` macro. */
+    styles?: PopoverStylesProp;
 }
 /**
  * A popover is an overlay element positioned relative to a trigger.
  */
-export const Popover: ForwardRefExoticComponent<PopoverDialogProps & RefAttributes<DOMRefValue<HTMLElement>>>;
+export const Popover: ForwardRefExoticComponent<PopoverDialogProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
 export interface MenuTriggerProps extends _MenuTriggerProps1 {
     /**
      * Alignment of the menu relative to the trigger.
@@ -517,7 +608,7 @@ export function MenuItem(props: MenuItemProps): ReactNode;
 export function MenuTrigger(props: MenuTriggerProps): ReactNode;
 export interface SubmenuTriggerProps extends Omit<_SubmenuTriggerProps1, 'delay'> {
 }
-export const SubmenuTrigger: (props: SubmenuTriggerProps) => JSX.Element | null;
+export function SubmenuTrigger(props: SubmenuTriggerProps): JSX.Element;
 export interface ActionMenuProps<T> extends Pick<MenuTriggerProps, 'isOpen' | 'defaultOpen' | 'onOpenChange' | 'align' | 'direction' | 'shouldFlip'>, Pick<MenuProps<T>, 'children' | 'items' | 'disabledKeys' | 'onAction'>, Pick<ActionButtonProps, 'isDisabled' | 'isQuiet' | 'autoFocus' | 'size'>, StyleProps, DOMProps, AriaLabelingProps {
     menuSize?: 'S' | 'M' | 'L' | 'XL';
 }
@@ -526,72 +617,6 @@ export const ActionMenuContext: Context<ContextValue<Partial<ActionMenuProps<any
  * ActionMenu combines an ActionButton with a Menu for simple "more actions" use cases.
  */
 export const ActionMenu: <T extends object>(props: ActionMenuProps<T> & RefAttributes<FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>) => React.ReactElement | null;
-interface ProgressCircleStyleProps {
-    /**
-     * The size of the ProgressCircle.
-     *
-     * @default 'M'
-     */
-    size?: 'S' | 'M' | 'L';
-    /** The static color style to apply. Useful when the button appears over a color background. */
-    staticColor?: 'black' | 'white' | 'auto';
-    /**
-     * Whether presentation is indeterminate when progress isn't known.
-     */
-    isIndeterminate?: boolean;
-}
-export const ProgressCircleContext: Context<ContextValue<Partial<ProgressCircleProps>, DOMRefValue<HTMLDivElement>>>;
-export interface ProgressCircleProps extends Omit<_ProgressBarProps1, 'children' | 'style' | 'valueLabel' | 'formatOptions' | 'label' | 'className' | keyof GlobalDOMAttributes>, ProgressCircleStyleProps, UnsafeStyles {
-    /** Spectrum-defined styles, returned by the `style()` macro. */
-    styles?: StylesPropWithHeight;
-}
-/**
- * ProgressCircles show the progression of a system operation such as downloading, uploading, or processing, in a visual way.
- * They can represent determinate or indeterminate progress.
- */
-export const ProgressCircle: ForwardRefExoticComponent<ProgressCircleProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
-interface ButtonStyleProps {
-    /**
-     * The [visual style](https://spectrum.adobe.com/page/button/#Options) of the button.
-     *
-     * @default 'primary'
-     */
-    variant?: 'primary' | 'secondary' | 'accent' | 'negative' | 'premium' | 'genai';
-    /**
-     * The background style of the Button.
-     *
-     * @default 'fill'
-     */
-    fillStyle?: 'fill' | 'outline';
-    /**
-     * The size of the Button.
-     *
-     * @default 'M'
-     */
-    size?: 'S' | 'M' | 'L' | 'XL';
-    /** The static color style to apply. Useful when the Button appears over a color background. */
-    staticColor?: 'white' | 'black' | 'auto';
-}
-export interface ButtonProps extends Omit<_ButtonProps1, 'className' | 'style' | 'children' | 'onHover' | 'onHoverStart' | 'onHoverEnd' | 'onHoverChange' | 'onClick' | keyof GlobalDOMAttributes>, StyleProps, ButtonStyleProps {
-    /** The content to display in the Button. */
-    children: ReactNode;
-}
-export interface LinkButtonProps extends Omit<_LinkProps1, 'className' | 'style' | 'children' | 'onClick' | keyof GlobalDOMAttributes>, StyleProps, ButtonStyleProps {
-    /** The content to display in the Button. */
-    children: ReactNode;
-}
-export const ButtonContext: Context<ContextValue<Partial<ButtonProps>, FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>>;
-export const LinkButtonContext: Context<ContextValue<Partial<ButtonProps>, FocusableRefValue<HTMLAnchorElement, HTMLAnchorElement>>>;
-/**
- * Buttons allow users to perform an action.
- * They have multiple styles for various needs, and are ideal for calling attention to
- * where a user needs to do something in order to move forward in a flow.
- */
-export const Button: ForwardRefExoticComponent<ButtonProps & RefAttributes<FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>>;
-/**
- * A LinkButton combines the functionality of a link with the appearance of a button. Useful for allowing users to navigate to another page.
- */
-export const LinkButton: ForwardRefExoticComponent<LinkButtonProps & RefAttributes<FocusableRefValue<HTMLAnchorElement, HTMLAnchorElement>>>;
 interface ButtonGroupStyleProps {
     /**
      * The axis the ButtonGroup should align with. Setting this to 'vertical' will prevent
@@ -638,7 +663,7 @@ export interface DialogProps extends Omit<_DialogProps1, 'className' | 'style' |
      *
      * @default 'M'
      */
-    size?: 'S' | 'M' | 'L';
+    size?: 'S' | 'M' | 'L' | 'XL';
     /** Whether pressing the escape key to close the dialog should be disabled. */
     isKeyboardDismissDisabled?: boolean;
 }
@@ -802,6 +827,9 @@ export interface CalendarProps<T extends DateValue> extends Omit<_CalendarProps1
     visibleMonths?: number;
 }
 export const CalendarContext: React.Context<ContextValue<Partial<CalendarProps<any>>, HTMLDivElement>>;
+/**
+ * Calendars display a grid of days in one or more months and allow users to select a single date.
+ */
 export const Calendar: <T extends DateValue>(props: CalendarProps<T> & React.RefAttributes<HTMLDivElement>) => ReactElement | null;
 interface CardRenderProps {
     /** The size of the Card. */
@@ -827,6 +855,9 @@ export interface CardProps extends Omit<GridListItemProps, 'className' | 'style'
     variant?: 'primary' | 'secondary' | 'tertiary' | 'quiet';
 }
 export const CardContext: Context<ContextValue<Partial<CardProps>, DOMRefValue<HTMLDivElement>>>;
+/**
+ * A Card summarizes an object that a user can select or navigate to.
+ */
 export const Card: ForwardRefExoticComponent<CardProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
 export interface CardPreviewProps extends UnsafeStyles, DOMProps {
     children: ReactNode;
@@ -839,7 +870,7 @@ export const AssetCard: ForwardRefExoticComponent<AssetCardProps & RefAttributes
 export interface UserCardProps extends Omit<CardProps, 'density' | 'variant'> {
     variant?: 'primary' | 'secondary' | 'tertiary';
 }
-export const UserCard: ForwardRefExoticComponent<CardProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
+export const UserCard: ForwardRefExoticComponent<UserCardProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
 export interface ProductCardProps extends Omit<CardProps, 'density' | 'variant'> {
     variant?: 'primary' | 'secondary' | 'tertiary';
 }
@@ -880,6 +911,9 @@ export interface CardViewProps<T> extends Omit<GridListProps<T>, 'layout' | 'key
     renderActionBar?: (selectedKeys: 'all' | Set<Key>) => ReactElement;
 }
 export const CardViewContext: Context<ContextValue<Partial<CardViewProps<any>>, DOMRefValue<HTMLDivElement>>>;
+/**
+ * A CardView displays a group of related objects, with support for selection and bulk actions.
+ */
 export const CardView: <T extends object>(props: CardViewProps<T> & RefAttributes<DOMRefValue<HTMLDivElement>>) => ReactElement | null;
 export interface CheckboxGroupProps extends Omit<_CheckboxGroupProps1, 'className' | 'style' | 'children' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps {
     /**
@@ -916,7 +950,7 @@ export const ColorAreaContext: Context<ContextValue<Partial<ColorAreaProps>, DOM
  * A ColorArea allows users to adjust two channels of an RGB, HSL or HSB color value against a two-dimensional gradient background.
  */
 export const ColorArea: ForwardRefExoticComponent<ColorAreaProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
-export interface ColorFieldProps extends Omit<_ColorFieldProps1, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps {
+export interface ColorFieldProps extends Omit<_ColorFieldProps1, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps, Pick<InputProps, 'placeholder'> {
     /**
      * The size of the color field.
      *
@@ -999,7 +1033,7 @@ interface ComboboxStyleProps {
      */
     size?: 'S' | 'M' | 'L' | 'XL';
 }
-export interface ComboBoxProps<T extends object> extends Omit<_ComboBoxProps1<T>, 'children' | 'style' | 'className' | 'defaultFilter' | 'allowsEmptyCollection' | keyof GlobalDOMAttributes>, ComboboxStyleProps, StyleProps, SpectrumLabelableProps, HelpTextProps, Pick<ListBoxProps<T>, 'items' | 'dependencies'>, Pick<_PopoverProps1, 'shouldFlip'>, Pick<AsyncLoadable, 'onLoadMore'> {
+export interface ComboBoxProps<T extends object> extends Omit<_ComboBoxProps1<T>, 'children' | 'style' | 'className' | 'defaultFilter' | 'allowsEmptyCollection' | keyof GlobalDOMAttributes>, ComboboxStyleProps, StyleProps, SpectrumLabelableProps, HelpTextProps, Pick<ListBoxProps<T>, 'items' | 'dependencies'>, Pick<_PopoverProps1, 'shouldFlip'>, Pick<AsyncLoadable, 'onLoadMore'>, Pick<InputProps, 'placeholder'> {
     /** The contents of the collection. */
     children: ReactNode | ((item: T) => ReactNode);
     /**
@@ -1040,8 +1074,12 @@ export interface DateFieldProps<T extends DateValue> extends Omit<_DateFieldProp
     size?: 'S' | 'M' | 'L' | 'XL';
 }
 export const DateFieldContext: Context<ContextValue<Partial<DateFieldProps<any>>, HTMLDivElement>>;
+/**
+ * DateFields allow users to enter and edit date and time values using a keyboard.
+ * Each part of a date value is displayed in an individually editable segment.
+ */
 export const DateField: <T extends DateValue>(props: DateFieldProps<T> & RefAttributes<HTMLDivElement>) => ReactElement | null;
-export interface DateRangePickerProps<T extends DateValue> extends Omit<_DateRangePickerProps1<T>, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, Pick<_RangeCalendarProps1<T>, 'createCalendar' | 'pageBehavior' | 'isDateUnavailable'>, StyleProps, SpectrumLabelableProps, HelpTextProps {
+export interface DateRangePickerProps<T extends DateValue> extends Omit<_DateRangePickerProps1<T>, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, Pick<_RangeCalendarProps1<T>, 'createCalendar' | 'pageBehavior' | 'firstDayOfWeek' | 'isDateUnavailable'>, StyleProps, SpectrumLabelableProps, HelpTextProps {
     /**
      * The size of the DateField.
      *
@@ -1055,6 +1093,10 @@ export interface DateRangePickerProps<T extends DateValue> extends Omit<_DateRan
     maxVisibleMonths?: number;
 }
 export const DateRangePickerContext: Context<ContextValue<Partial<DateRangePickerProps<any>>, HTMLDivElement>>;
+/**
+ * DateRangePickers combine two DateFields and a RangeCalendar popover to allow users
+ * to enter or select a date and time range.
+ */
 export const DateRangePicker: <T extends DateValue>(props: DateRangePickerProps<T> & RefAttributes<HTMLDivElement>) => ReactElement | null;
 export interface CustomDialogProps extends Omit<_DialogProps1, 'className' | 'style' | keyof GlobalDOMAttributes>, StyleProps {
     /**
@@ -1142,7 +1184,10 @@ export interface DropZoneProps extends Omit<_DropZoneProps1, 'className' | 'styl
     children: ReactNode;
     /** Whether the drop zone has been filled. */
     isFilled?: boolean;
-    /** The message to replace the default banner message that is shown when the drop zone is filled. */
+    /**
+     * The message to replace the default banner message that is shown when the drop zone is filled.
+     * @default 'Drop file to replace'
+     */
     replaceMessage?: string;
     /**
      * The size of the DropZone.
@@ -1237,7 +1282,7 @@ export const MeterContext: Context<ContextValue<Partial<MeterProps>, DOMRefValue
  * Their progress is determined by user actions, rather than system actions.
  */
 export const Meter: ForwardRefExoticComponent<MeterProps & RefAttributes<DOMRefValue<HTMLDivElement>>>;
-interface NumberFieldProps extends Omit<_NumberFieldProps1, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps {
+interface NumberFieldProps extends Omit<_NumberFieldProps1, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps, Pick<InputProps, 'placeholder'> {
     /**
      * Whether to hide the increment and decrement buttons.
      * @default false
@@ -1268,7 +1313,8 @@ interface PickerStyleProps {
      */
     isQuiet?: boolean;
 }
-export interface PickerProps<T extends object> extends Omit<SelectProps<T>, 'children' | 'style' | 'className' | keyof GlobalDOMAttributes>, PickerStyleProps, StyleProps, SpectrumLabelableProps, HelpTextProps, Pick<ListBoxProps<T>, 'items' | 'dependencies'>, Pick<_PopoverProps1, 'shouldFlip'>, Pick<AsyncLoadable, 'onLoadMore'> {
+type SelectionMode = 'single' | 'multiple';
+export interface PickerProps<T extends object, M extends SelectionMode = 'single'> extends Omit<SelectProps<T, M>, 'children' | 'style' | 'className' | keyof GlobalDOMAttributes>, PickerStyleProps, StyleProps, SpectrumLabelableProps, HelpTextProps, Pick<ListBoxProps<T>, 'items' | 'dependencies'>, Pick<_PopoverProps1, 'shouldFlip'>, Pick<AsyncLoadable, 'onLoadMore'> {
     /** The contents of the collection. */
     children: ReactNode | ((item: T) => ReactNode);
     /**
@@ -1288,11 +1334,11 @@ export interface PickerProps<T extends object> extends Omit<SelectProps<T>, 'chi
     /** The current loading state of the Picker. */
     loadingState?: LoadingState;
 }
-export const PickerContext: React.Context<ContextValue<Partial<PickerProps<any>>, FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>>;
+export const PickerContext: React.Context<ContextValue<Partial<PickerProps<any, "single">>, FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>>;
 /**
  * Pickers allow users to choose a single option from a collapsible list of options when space is limited.
  */
-export const Picker: <T extends object>(props: PickerProps<T> & React.RefAttributes<FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>) => React.ReactElement | null;
+export const Picker: <T extends object, M extends SelectionMode = "single">(props: PickerProps<T, M> & React.RefAttributes<FocusableRefValue<HTMLButtonElement, HTMLButtonElement>>) => React.ReactElement | null;
 export interface PickerItemProps extends Omit<ListBoxItemProps, 'children' | 'style' | 'className' | 'onClick' | keyof GlobalDOMAttributes>, StyleProps {
     children: ReactNode;
 }
@@ -1382,6 +1428,9 @@ export interface RangeCalendarProps<T extends DateValue> extends Omit<_RangeCale
     visibleMonths?: number;
 }
 export const RangeCalendarContext: Context<ContextValue<Partial<RangeCalendarProps<any>>, HTMLDivElement>>;
+/**
+ * RangeCalendars display a grid of days in one or more months and allow users to select a contiguous range of dates.
+ */
 export const RangeCalendar: <T extends DateValue>(props: RangeCalendarProps<T> & RefAttributes<HTMLDivElement>) => ReactElement | null;
 interface SliderBaseProps<T> extends Omit<_SliderProps1<T>, 'children' | 'style' | 'className' | 'orientation' | keyof GlobalDOMAttributes>, Omit<SpectrumLabelableProps, 'necessityIndicator' | 'isRequired'>, StyleProps {
     children?: ReactNode;
@@ -1436,8 +1485,11 @@ export interface RangeSliderProps extends Omit<SliderBaseProps<RangeValue<number
     form?: string;
 }
 export const RangeSliderContext: Context<ContextValue<Partial<RangeSliderProps>, FocusableRefValue<HTMLDivElement, HTMLDivElement>>>;
+/**
+ * RangeSliders allow users to quickly select a subset range. They should be used when the upper and lower bounds to the range are invariable.
+ */
 export const RangeSlider: ForwardRefExoticComponent<RangeSliderProps & RefAttributes<FocusableRefValue<HTMLDivElement, HTMLDivElement>>>;
-export interface SearchFieldProps extends Omit<_SearchFieldProps1, 'className' | 'style' | 'children' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps {
+export interface SearchFieldProps extends Omit<_SearchFieldProps1, 'className' | 'style' | 'children' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps, Pick<InputProps, 'placeholder'> {
     /**
      * The size of the SearchField.
      *
@@ -1753,7 +1805,7 @@ export const TagGroupContext: Context<ContextValue<Partial<TagGroupProps<any>>,
 export const TagGroup: <T extends object>(props: TagGroupProps<T> & RefAttributes<DOMRefValue<HTMLDivElement>>) => React.ReactElement | null;
 /** An individual Tag for TagGroups. */
 export const Tag: (props: TagProps & RefAttributes<DOMRefValue<HTMLDivElement>>) => React.ReactElement | null;
-export interface TextFieldProps extends Omit<_TextFieldProps1, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps {
+export interface TextFieldProps extends Omit<_TextFieldProps1, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, StyleProps, SpectrumLabelableProps, HelpTextProps, Pick<InputProps, 'placeholder'> {
     /**
      * The size of the text field.
      *
@@ -1786,6 +1838,10 @@ export interface TimeFieldProps<T extends TimeValue> extends Omit<_TimeFieldProp
     size?: 'S' | 'M' | 'L' | 'XL';
 }
 export const TimeFieldContext: Context<ContextValue<Partial<TimeFieldProps<any>>, HTMLDivElement>>;
+/**
+ * TimeFields allow users to enter and edit time values using a keyboard.
+ * Each part of the time is displayed in an individually editable segment.
+ */
 export const TimeField: <T extends TimeValue>(props: TimeFieldProps<T> & RefAttributes<HTMLDivElement>) => ReactElement | null;
 type ToastPlacement = 'top' | 'top end' | 'bottom' | 'bottom end';
 export interface ToastContainerProps extends Omit<ToastRegionProps<SpectrumToastValue>, 'queue' | 'children'> {
@@ -1907,7 +1963,7 @@ export interface TreeViewItemContentProps extends Omit<TreeItemContentProps, 'ch
 }
 export const TreeViewItemContent: (props: TreeViewItemContentProps) => ReactNode;
 export const TreeViewLoadMoreItem: (props: TreeViewLoadMoreItemProps) => ReactNode;
-export interface DatePickerProps<T extends DateValue> extends Omit<_DatePickerProps1<T>, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, Pick<_CalendarProps2<T>, 'createCalendar' | 'pageBehavior' | 'isDateUnavailable'>, StyleProps, SpectrumLabelableProps, HelpTextProps {
+export interface DatePickerProps<T extends DateValue> extends Omit<_DatePickerProps1<T>, 'children' | 'className' | 'style' | keyof GlobalDOMAttributes>, Pick<_CalendarProps2<T>, 'createCalendar' | 'pageBehavior' | 'firstDayOfWeek' | 'isDateUnavailable'>, StyleProps, SpectrumLabelableProps, HelpTextProps {
     /**
      * The size of the DateField.
      *
@@ -1921,10 +1977,14 @@ export interface DatePickerProps<T extends DateValue> extends Omit<_DatePickerPr
     maxVisibleMonths?: number;
 }
 export const DatePickerContext: Context<ContextValue<Partial<DatePickerProps<any>>, HTMLDivElement>>;
+/**
+ * DatePickers combine a DateField and a Calendar popover to allow users to enter or select a date and time value.
+ */
 export const DatePicker: <T extends DateValue>(props: DatePickerProps<T> & RefAttributes<HTMLDivElement>) => ReactElement | null;
 export { Autocomplete } from 'react-aria-components';
 export { Collection } from 'react-aria-components';
 export { FileTrigger } from 'react-aria-components';
-export type { AutocompleteProps, FileTriggerProps, TooltipTriggerComponentProps as TooltipTriggerProps, SortDescriptor } from 'react-aria-components';
+export { parseColor } from 'react-aria-components';
+export type { AutocompleteProps, FileTriggerProps, TooltipTriggerComponentProps as TooltipTriggerProps, SortDescriptor, Color, Key, Selection } from 'react-aria-components';
 
 //# sourceMappingURL=types.d.ts.map