@baseline-ui/core 0.24.1 → 0.26.0

package/dist/index.d.mts

@@ -1,10 +1,11 @@
 import React, { Key, Dispatch, SetStateAction } from 'react';
-import { DraggableCollectionStateOptions, DroppableCollectionStateOptions, Orientation, ListState, SliderStateOptions, ToggleProps, OverlayTriggerProps, OverlayTriggerState, MenuTriggerProps, TooltipTriggerProps, NumberFieldStateOptions, ListProps, SelectStateOptions, Item as Item$2, Selection as Selection$1, ComboBoxStateOptions, Node as Node$2, ListData, ListOptions } from 'react-stately';
+import { IconProps, SVGRProps } from '@baseline-ui/icons';
+import * as react_stately from 'react-stately';
+import { DraggableCollectionStateOptions, DroppableCollectionStateOptions, Orientation, ListState, TooltipTriggerProps, SliderStateOptions, ToggleProps, OverlayTriggerProps, OverlayTriggerState, MenuTriggerProps, NumberFieldStateOptions, ListProps, SelectStateOptions, Item as Item$2, Selection as Selection$1, ComboBoxStateOptions, Node as Node$2 } from 'react-stately';
 import * as react_aria from 'react-aria';
-import { DraggableCollectionOptions, DroppableCollectionOptions, AriaListBoxProps, AriaListBoxOptions, OptionAria, AriaButtonProps, AriaSliderProps, AriaSwitchProps, AriaSearchFieldProps, AriaPopoverProps, useOverlayTrigger, AriaMenuProps, AriaMenuTriggerProps, AriaLinkOptions, SeparatorProps as SeparatorProps$1, AriaProgressBarProps, AriaTextFieldProps, AriaTooltipProps, AriaPositionProps, OverlayProps, AriaToggleButtonProps, AriaCheckboxProps, AriaNumberFieldProps, I18nProviderProps as I18nProviderProps$1, LocalizedStrings, useNumberFormatter, useDateFormatter, AriaTagGroupProps, AriaSelectOptions, AriaDialogProps, DropOptions, ClipboardProps, PressProps, AriaRadioGroupProps, AriaModalOverlayProps, AriaComboBoxOptions, AriaComboBoxProps, AriaGridListOptions, GridListItemAria, Locale, Key as Key$1 } from 'react-aria';
+import { DraggableCollectionOptions, DroppableCollectionOptions, AriaListBoxProps, AriaListBoxOptions, OptionAria, AriaButtonProps, AriaTooltipProps, AriaPositionProps, AriaSliderProps, AriaSwitchProps, AriaSearchFieldProps, AriaPopoverProps, useOverlayTrigger, AriaMenuProps, AriaMenuTriggerProps, AriaLinkOptions, SeparatorProps as SeparatorProps$1, AriaProgressBarProps, AriaTextFieldProps, OverlayProps, AriaToggleButtonProps, AriaCheckboxProps, AriaNumberFieldProps, I18nProviderProps as I18nProviderProps$1, LocalizedStrings, useNumberFormatter, useDateFormatter, AriaTagGroupProps, AriaSelectOptions, Key as Key$1, AriaDialogProps, DropOptions, ClipboardProps, PressProps, AriaRadioGroupProps, AriaModalOverlayProps, AriaComboBoxOptions, AriaComboBoxProps, AriaGridListOptions, GridListItemAria, Locale } from 'react-aria';
 export { I18nProviderProps, useCollator, useDateFormatter, useNumberFormatter } from 'react-aria';
 import { Node as Node$1, DragItem, DOMAttributes, AriaLabelingProps, AriaValidationProps, DOMProps } from '@react-types/shared';
-import { IconProps, SVGRProps } from '@baseline-ui/icons';
 import { Theme, Sprinkles } from '@baseline-ui/tokens';
 import { AriaTabListProps } from '@react-types/tabs';
 import { ColorFieldProps, Color } from '@react-stately/color';
@@ -14,6 +15,20 @@ import { UseTransitionProps } from '@react-spring/core';
 import { AriaColorSwatchProps } from '@react-aria/color';
 import { AriaActionGroupProps } from '@react-aria/actiongroup';
 
+interface ListOption<T = Record<string, any>> {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: React.FC<IconProps>;
+    data?: T;
+}
+interface ListSection {
+    id: string;
+    title?: string;
+    children: ListOption[];
+}
+declare type ListItem = ListOption | ListSection;
+
 declare type DragAndDropProps = Omit<DraggableCollectionStateOptions & DraggableCollectionOptions & DroppableCollectionOptions & DroppableCollectionStateOptions, "keyboardDelegate" | "dropTargetDelegate" | "shouldAcceptItemDrop" | "onDropEnter" | "onDropActivate" | "onDropExit" | "getDropOperation" | "collection" | "selectionManager" | "onRootDrop" | "onInsert" | "getAllowedDropOperations" | "getItems" | "onItemDrop"> & Partial<Pick<DraggableCollectionStateOptions, "getItems">> & {
     /**
      * Indicates whether reordering is enabled.
@@ -44,6 +59,14 @@ interface BlockProps {
      * rendered.
      */
     "data-block-id"?: string;
+    /**
+     * Represents a data block group. This is similar to `data-block-id` but it
+     * doesn't have to be unique just like `class`. This is used to group blocks
+     * together in the DOM and in the block map. It is added as a data attribute
+     * `data-block-class` to the root element of the block if a DOM node is
+     * rendered.
+     */
+    "data-block-class"?: string;
 }
 interface StylingProps extends BlockProps {
     /** The className applied to the root element of the component. */
@@ -76,21 +99,9 @@ declare function isInsideOverlayContent(selector: HTMLElement): Element | null;
  */
 declare function isRect(rect: Rect): rect is Rect;
 
-interface ListOption<T = Record<string, any>> {
-    id: string;
-    label: string;
-    description?: string;
-    icon?: React.FC<IconProps>;
-    data?: T;
-    type?: "option";
-}
-interface ListSection {
-    id: string;
-    title?: string;
-    type: "section";
-    children: ListOption[];
+interface ListBoxHandle {
+    scrollIntoView: (id: string, options: ScrollIntoViewOptions) => void;
 }
-declare type ListItem = ListOption | ListSection;
 interface ListBoxProps extends StylingProps, Omit<AriaListBoxProps<ListItem> & AriaListBoxOptions<ListItem>, "children" | "linkBehavior" | "isVirtualized" | "keyboardDelegate" | "items">, Omit<DragAndDropProps, "preview" | "enableReorder" | "orientation" | "layout">, Partial<Pick<DragAndDropProps, "enableReorder" | "orientation" | "layout">> {
     /**
      * The items to render in the listbox. Items have the following shape:
@@ -137,6 +148,13 @@ interface ListBoxProps extends StylingProps, Omit<AriaListBoxProps<ListItem> & A
      * a custom drag preview when dragging items.
      */
     renderDragPreview?: (items: DragItem[]) => React.ReactNode;
+    /**
+     * The custom render function for the listbox sections.
+     *
+     * @param section ListSection
+     * @param ref React.RefObject<HTMLDivElement>
+     */
+    renderSectionHeader?: (section: Node$1<ListItem>, ref: React.Ref<HTMLSpanElement>) => React.ReactNode;
     /** Whether to show the selected checkmark icon. */
     showSelectedIcon?: boolean;
     /** The label for the listbox. */
@@ -153,6 +171,20 @@ interface ListBoxProps extends StylingProps, Omit<AriaListBoxProps<ListItem> & A
     optionStyle?: React.CSSProperties | ((item: ListOption) => React.CSSProperties);
     /** The style of the section. */
     sectionStyle?: React.CSSProperties | ((item: ListSection) => React.CSSProperties);
+    /**
+     * Whether to show each section title when provided.
+     *
+     * @default false
+     */
+    showSectionHeader?: boolean;
+    /**
+     * Wether to add initial padding to section titles if shown.
+     *
+     * @default false
+     */
+    withSectionHeaderPadding?: boolean;
+    /** Handle to access the listbox methods. */
+    listBoxHandle?: React.RefObject<ListBoxHandle>;
 }
 
 declare const ListBox: React.ForwardRefExoticComponent<ListBoxProps & React.RefAttributes<HTMLUListElement>>;
@@ -184,7 +216,7 @@ interface ActionButtonProps extends ActionButtonSharedProps {
 
 declare const ActionButton: React.ForwardRefExoticComponent<ActionButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
-interface DomNodeRendererProps {
+interface DomNodeRendererProps extends StylingProps {
     /** The class name applied to the wrapper `div` component. */
     className?: string;
     /**
@@ -198,6 +230,61 @@ interface DomNodeRendererProps {
 
 declare const DomNodeRenderer: React.ForwardRefExoticComponent<DomNodeRendererProps & React.RefAttributes<HTMLDivElement>>;
 
+interface TooltipProps extends StylingProps, TooltipTriggerProps, AriaTooltipProps, Omit<AriaPositionProps, "overlayRef" | "targetRef" | "maxHeight" | "isOpen" | "arrowSize"> {
+    /** The content of the tooltip. */
+    text?: string;
+    /** The tooltip trigger element. */
+    children: React.ReactNode;
+    /**
+     * The delay time for the tooltip to show up.
+     *
+     * @default 1000
+     */
+    delay?: number;
+    /**
+     * The delay time for the tooltip to hide.
+     *
+     * @default 500
+     */
+    closeDelay?: number;
+    /**
+     * Represents the size of an element.
+     *
+     * @default md
+     */
+    size?: "sm" | "md";
+    /**
+     * The variant that can be applied to an element.
+     *
+     * @default default
+     */
+    variant?: "default" | "inverse";
+    /**
+     * Indicates whether to include an arrow in the output.
+     *
+     * @default true
+     */
+    includeArrow?: boolean;
+    /**
+     * The container element for the modal. By default, the modal is rendered as a
+     * child of the body element.
+     *
+     * @default document.body
+     */
+    portalContainer?: HTMLElement;
+}
+
+declare const Tooltip: React.ForwardRefExoticComponent<TooltipProps & React.RefAttributes<HTMLDivElement>>;
+
+interface IconComponentProps {
+    /** The icon to show at the start of the color input. */
+    icon?: React.FC<IconProps>;
+    /** The aria label for the color input button. */
+    "aria-label": string;
+    /** Props to pass to the tooltip component. */
+    tooltipProps?: Omit<TooltipProps, "variant" | "size" | "includeArrow" | "children">;
+}
+
 interface SliderProps extends Omit<AriaSliderProps<number> & SliderStateOptions<number>, "orientation" | "numberFormatter">, StylingProps {
     /**
      * Whether the slider is read only.
@@ -218,9 +305,19 @@ interface SliderProps extends Omit<AriaSliderProps<number> & SliderStateOptions<
      */
     includeNumberInput?: boolean;
 }
+interface IconSliderProps extends Pick<SliderProps, "value" | "minValue" | "maxValue" | "onChange" | "defaultValue">, StylingProps, IconComponentProps {
+    /**
+     * A function to format the value of the slider.
+     *
+     * @default value => value
+     */
+    formatValue?: (value: number) => string | number;
+}
 
 declare const Slider: React.ForwardRefExoticComponent<SliderProps & React.RefAttributes<HTMLDivElement>>;
 
+declare const IconSlider: React.ForwardRefExoticComponent<IconSliderProps & React.RefAttributes<HTMLDivElement>>;
+
 interface SwitchProps extends Omit<AriaSwitchProps, "children">, Omit<ToggleProps, "children" | "isRequired" | "validate" | "validationBehavior" | "validationState" | "isInvalid">, StylingProps {
     /** The label to display next to the switch. */
     label?: React.ReactNode;
@@ -311,7 +408,7 @@ declare const PortalContainerProvider: React.FC<PortalContainerProviderProps>;
 declare type OverlayTriggerProps_ = Parameters<typeof useOverlayTrigger>[0];
 interface PopoverProps extends OverlayTriggerProps, OverlayTriggerProps_ {
     /** The children of the popover. */
-    children: React.ReactNode | ((state: OverlayTriggerState) => React.ReactNode);
+    children: React.ReactNode;
 }
 interface PopoverContentProps extends Omit<AriaPopoverProps, "popoverRef" | "triggerRef" | "arrowSize" | "arrowBoundaryOffset">, StylingProps {
     /**
@@ -322,7 +419,7 @@ interface PopoverContentProps extends Omit<AriaPopoverProps, "popoverRef" | "tri
     /** The class name for the underlay element. */
     underlayClassName?: string;
     /** The contents of the popover. */
-    children: React.ReactNode;
+    children: React.ReactNode | ((state: OverlayTriggerState) => React.ReactNode);
     /**
      * The container element for the popover. By default, the modal is rendered as
      * a child of the body element.
@@ -487,9 +584,7 @@ interface SeparatorProps extends SeparatorProps$1, StylingProps {
 
 declare const Separator: React.ForwardRefExoticComponent<SeparatorProps & React.RefAttributes<HTMLDivElement>>;
 
-interface ProgressBarProps extends Omit<AriaProgressBarProps, "isIndeterminate"> {
-    /** The `className` property assigned to the root element of the component. */
-    className?: string;
+interface ProgressBarProps extends StylingProps, Omit<AriaProgressBarProps, "isIndeterminate"> {
     /**
      * The variant of the progress bar.
      *
@@ -554,57 +649,7 @@ interface ReactionProps extends Omit<AriaSwitchProps & ToggleProps, "validationS
 
 declare const Reaction: React.ForwardRefExoticComponent<ReactionProps & React.RefAttributes<HTMLLabelElement>>;
 
-interface TooltipProps extends TooltipTriggerProps, AriaTooltipProps, Omit<AriaPositionProps, "overlayRef" | "targetRef" | "maxHeight" | "isOpen" | "arrowSize"> {
-    /** The content of the tooltip. */
-    text?: string;
-    /** The tooltip trigger element. */
-    children: React.ReactNode;
-    /**
-     * The delay time for the tooltip to show up.
-     *
-     * @default 1000
-     */
-    delay?: number;
-    /**
-     * The delay time for the tooltip to hide.
-     *
-     * @default 500
-     */
-    closeDelay?: number;
-    /**
-     * Represents the size of an element.
-     *
-     * @default md
-     */
-    size?: "sm" | "md";
-    /**
-     * The variant that can be applied to an element.
-     *
-     * @default default
-     */
-    variant?: "default" | "inverse";
-    /**
-     * Indicates whether to include an arrow in the output.
-     *
-     * @default true
-     */
-    includeArrow?: boolean;
-    /**
-     * The container element for the modal. By default, the modal is rendered as a
-     * child of the body element.
-     *
-     * @default document.body
-     */
-    portalContainer?: HTMLElement;
-}
-
-declare const Tooltip: React.ForwardRefExoticComponent<TooltipProps & React.RefAttributes<HTMLDivElement>>;
-
-interface PortalProps extends OverlayProps {
-    /** The `className` property assigned to the root element of the component. */
-    className?: string;
-    /** The `style` property assigned to the root element of the component. */
-    style?: React.CSSProperties;
+interface PortalProps extends OverlayProps, StylingProps {
 }
 
 declare const Portal: React.ForwardRefExoticComponent<PortalProps & React.RefAttributes<HTMLDivElement>>;
@@ -702,6 +747,8 @@ declare const Pagination: React.ForwardRefExoticComponent<PaginationProps & Reac
 interface I18nProviderProps extends I18nProviderProps$1 {
     /** The messages to use for internationalization. */
     messages?: LocalizedStrings;
+    /** The children to render. */
+    children: React.ReactNode;
 }
 
 declare const I18nProvider: React.FC<I18nProviderProps>;
@@ -851,13 +898,7 @@ interface SelectProps extends Omit<AriaSelectOptions<ListItem> & SelectStateOpti
         ref: React.RefObject<HTMLButtonElement>;
     }) => React.ReactNode;
 }
-interface IconSelectProps extends Omit<SelectProps, "renderTrigger">, Pick<TooltipProps, "placement"> {
-    /** The icon to show at the start of the select component. */
-    icon: React.FC<IconProps>;
-    /** The aria label for the select component. */
-    "aria-label": string;
-    /** Whether to include a tooltip for the select component. */
-    includeTooltip?: boolean;
+interface IconSelectProps extends Omit<SelectProps, "renderTrigger" | "aria-label">, IconComponentProps {
 }
 
 declare const Select: React.ForwardRefExoticComponent<SelectProps & React.RefAttributes<HTMLDivElement>>;
@@ -896,7 +937,7 @@ interface AvatarProps extends StylingProps {
 declare const Avatar: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<HTMLSpanElement>>;
 
 declare type ItemProps = React.ComponentProps<typeof Item$2> & StylingProps & {
-    key?: Key;
+    key?: Key$1;
     icon?: React.FC<SVGRProps>;
     value?: string;
     title?: string;
@@ -924,13 +965,13 @@ declare type TabsProps = Omit<StylingProps & AriaTabListProps<ItemProps>, "orien
      *
      * @param key
      */
-    onRemove?: (key: Key) => void;
+    onRemove?: (key: Key$1) => void;
     /** The value of the tab that needs to be selected. */
     selectedValue?: string;
     /** The default value of the tab that needs to be selected. */
     defaultSelectedValue?: string;
     /** The values of the tabs that need to be disabled. */
-    disabledValues?: Set<Key>;
+    disabledValues?: Set<Key$1>;
     /** A list of action buttons to render beside the tab items. */
     actions?: Omit<ActionIconButtonProps, "variant" | "size">[];
     /** The variant of the tabs */
@@ -951,14 +992,16 @@ declare type TabItemProps = StylingProps & {
     titleClassName?: string;
     /** The style to apply to the tab item. */
     titleStyle?: React.CSSProperties;
+    /** The contents of the tab item. */
+    children: React.ReactNode;
 };
 
-declare const Tabs: React.ForwardRefExoticComponent<Omit<StylingProps & react_aria.AriaTabListProps<ItemProps>, "children" | "items" | "disabledKeys" | "orientation" | "selectedKey" | "defaultSelectedKey"> & {
+declare const Tabs: React.ForwardRefExoticComponent<Omit<StylingProps & react_aria.AriaTabListProps<ItemProps>, "children" | "items" | "orientation" | "disabledKeys" | "selectedKey" | "defaultSelectedKey"> & {
     children: React.ReactNode;
-    onRemove?: ((key: React.Key) => void) | undefined;
+    onRemove?: ((key: react_stately.Key) => void) | undefined;
     selectedValue?: string | undefined;
     defaultSelectedValue?: string | undefined;
-    disabledValues?: Set<React.Key> | undefined;
+    disabledValues?: Set<react_stately.Key> | undefined;
     actions?: Omit<ActionIconButtonProps, "size" | "variant">[] | undefined;
     variant?: "primary" | "ghost" | undefined;
     tabHeaderClassName?: string | undefined;
@@ -1192,13 +1235,7 @@ interface ColorInputProps extends OverlayTriggerProps, StylingProps, Pick<ColorF
         labelId?: string;
     }) => React.ReactElement;
 }
-interface IconColorInputProps extends StylingProps, Omit<ColorInputProps, "renderTriggerButton" | "colorLabel" | "label" | "labelPosition">, Pick<TooltipProps, "placement"> {
-    /** The icon to show at the start of the color input. */
-    icon: React.FC<IconProps>;
-    /** Whether to include a tooltip for the color input. */
-    includeTooltip?: boolean;
-    /** The aria label for the color input button. */
-    "aria-label": string;
+interface IconColorInputProps extends StylingProps, Omit<ColorInputProps, "renderTriggerButton" | "colorLabel" | "label" | "labelPosition" | "aria-label">, IconComponentProps {
     /**
      * The variant of the color input button.
      *
@@ -1358,7 +1395,7 @@ declare type TextProps<T extends keyof React.JSX.IntrinsicElements = "span"> = S
     elementType?: React.ElementType;
 };
 
-declare const Text: React.ForwardRefExoticComponent<Pick<TextProps<"span">, "onDrop" | "onDragStart" | "onDragEnd" | "type" | "className" | "style" | "dir" | "slot" | "title" | "children" | "autoFocus" | "onFocus" | "onBlur" | "id" | "aria-label" | "aria-labelledby" | "aria-describedby" | "aria-details" | "data-block-id" | "color" | "size" | "content" | "translate" | "hidden" | "elementType" | "role" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "contentEditable" | "contextMenu" | "draggable" | "lang" | "nonce" | "placeholder" | "spellCheck" | "tabIndex" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStartCapture" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture"> & React.RefAttributes<HTMLDivElement>>;
+declare const Text: React.ForwardRefExoticComponent<Omit<TextProps<"span">, "ref"> & React.RefAttributes<HTMLDivElement>>;
 
 interface TransformProps {
     /** The `className` property assigned to the root element of the component. */
@@ -1629,15 +1666,15 @@ interface RadioGroupProps extends StylingProps, Omit<AriaRadioGroupProps, "descr
 declare const RadioGroup: React.ForwardRefExoticComponent<RadioGroupProps & React.RefAttributes<HTMLDivElement>>;
 
 interface ModalProps extends OverlayTriggerProps {
+    /** The contents of the modal. */
+    children: React.ReactNode;
 }
 interface ModalContentProps extends Omit<AriaModalOverlayProps, "isDismissable" | "isKeyboardDismissDisabled">, StylingProps {
     /**
      * The contents of the modal. Can be a React node or a function that returns a
      * React node.
      */
-    children: React.ReactNode | ((props: {
-        close: () => void;
-    }) => React.ReactNode);
+    children: React.ReactNode | ((props: OverlayTriggerState) => React.ReactNode);
     /**
      * The container element for the modal. By default, the modal is rendered as a
      * child of the body element.
@@ -1683,9 +1720,13 @@ declare const Modal: React.FC<ModalProps>;
 
 declare const ModalContent: React.FC<ModalContentProps>;
 
-declare const ModalTrigger: React.FC;
+declare const ModalTrigger: React.FC<{
+    children: React.ReactNode;
+}>;
 
-declare const ModalClose: React.FC;
+declare const ModalClose: React.FC<{
+    children: React.ReactNode;
+}>;
 
 interface MessageFormatProps {
     /**
@@ -1734,17 +1775,6 @@ interface BoxProps extends Pick<StylingProps, "data-block-id">, Omit<React.Compo
 
 declare const Box: React.ForwardRefExoticComponent<BoxProps & React.RefAttributes<HTMLDivElement>>;
 
-interface ColorPresetInlineInputProps extends Omit<RadioGroupProps, "items" | "disabledValues"> {
-    items: ColorPreset[];
-}
-
-/**
- * @deprecated Please use `ColorSwatchPicker` instead.
- *
- *   TODO [>=0.26.0] Remove this component.
- */
-declare const ColorPresetInlineInput: React.ForwardRefExoticComponent<ColorPresetInlineInputProps & React.RefAttributes<HTMLDivElement>>;
-
 interface ToolbarProps extends StylingProps, AriaToolbarProps {
     /** The children of the toolbar. */
     children: React.ReactNode;
@@ -1771,7 +1801,7 @@ interface ToolbarProps extends StylingProps, AriaToolbarProps {
      * the toolbar buttons and the menu trigger. This prop is only relevant when
      * `isCollapsible` is true.
      */
-    renderSpacer?: () => React.ReactNode;
+    renderSpacer?: boolean;
 }
 
 declare const Toolbar: React.ForwardRefExoticComponent<ToolbarProps & React.RefAttributes<HTMLDivElement>>;
@@ -1809,6 +1839,7 @@ interface MentionableUser {
 }
 interface EditorHandle {
     setCaretPosition: (index: number) => void;
+    focus: () => void;
 }
 interface EditorProps extends StylingProps, AriaLabelingProps {
     /**
@@ -2086,14 +2117,14 @@ declare const AudioPlayer: React.ForwardRefExoticComponent<AudioPlayerProps & Re
 
 interface Item {
     id: string;
+    label: string;
     src?: string;
     alt?: string;
-    label: string;
 }
 interface ImageGalleryProps extends StylingProps, Omit<ListBoxProps, "items" | "layout" | "grid" | "renderOption" | "renderDropIndicator" | "renderDragPreview" | "showSelectedIcon" | "orientation" | "shouldSelectOnPressUp" | "shouldFocusOnHover" | "dropIndicatorClassName" | "dropIndicatorStyle" | "shouldUseVirtualFocus" | "getItems" | "acceptedDragTypes" | "sectionClassName" | "sectionStyle"> {
     /**
      * An array of objects containing the image source, alt text, and label for
-     * each image.
+     * each image. This property makes the component a controlled component.
      *
      * ```tsx
      * const items = [
@@ -2113,6 +2144,28 @@ interface ImageGalleryProps extends StylingProps, Omit<ListBoxProps, "items" | "
      * ```
      */
     items?: Item[];
+    /**
+     * An array of objects containing the image source, alt text, and label for
+     * each image.
+     *
+     * ```tsx
+     * const items = [
+     *   {
+     *     id: "1",
+     *     src: "https://example.com/image1.jpg",
+     *     alt: "Image 1",
+     *     label: "Image 1",
+     *   },
+     *   {
+     *     id: "2",
+     *     src: "https://example.com/image2.jpg",
+     *     alt: "Image 2",
+     *     label: "Image 2",
+     *   },
+     * ];
+     * ```
+     */
+    defaultItems?: Item[];
     /**
      * The width of the images.
      *
@@ -2137,11 +2190,22 @@ interface ImageGalleryProps extends StylingProps, Omit<ListBoxProps, "items" | "
     onDelete?: (keys: Selection$1) => void;
     /** A callback that is called when a key is pressed. */
     onKeyDown?: (event: React.KeyboardEvent<HTMLDivElement>) => void;
+    /** ClassName for each item container */
+    imageContainerClassName?: string;
+    /** ClassName for each item image */
+    imageClassName?: string;
+    /** ClassName for each item image label */
+    labelClassName?: string;
+    /** A callback that is called to render the image. */
+    renderImage?: (item: ListOption<Pick<Item, "alt" | "src">>, options: {
+        deleteElement?: React.ReactElement;
+        onDelete?: (id: string) => void;
+    }) => React.ReactElement;
 }
 
 declare const ImageGallery: React.ForwardRefExoticComponent<ImageGalleryProps & React.RefAttributes<HTMLDivElement>>;
 
-interface ButtonSelectProps extends StylingProps, Pick<SelectProps, "isDisabled" | "validationState" | "onSelectionChange" | "selectedKey" | "defaultSelectedKey" | "items" | "showSelectedIcon" | "isOpen" | "defaultOpen">, Pick<ActionButtonProps, "onPress" | "excludeFromTabOrder">, AriaLabelingProps {
+interface ButtonSelectProps extends StylingProps, Pick<SelectProps, "isDisabled" | "validationState" | "onSelectionChange" | "selectedKey" | "defaultSelectedKey" | "items" | "showSelectedIcon" | "isOpen" | "defaultOpen">, Pick<ToggleButtonProps, "onPress" | "isSelected" | "defaultSelected" | "excludeFromTabOrder">, AriaLabelingProps {
     /**
      * The size of the button.
      *
@@ -2154,6 +2218,11 @@ interface ButtonSelectProps extends StylingProps, Pick<SelectProps, "isDisabled"
      * @default false
      */
     hideLabel?: boolean;
+    /** A callback that is called when the button selection changes. */
+    onButtonSelectionChange?: (options: {
+        isSelected: boolean;
+        selectedKey: string;
+    }) => void;
 }
 
 declare const ButtonSelect: React.ForwardRefExoticComponent<ButtonSelectProps & React.RefAttributes<HTMLDivElement>>;
@@ -2231,6 +2300,22 @@ interface ComboBoxProps extends StylingProps, Omit<AriaComboBoxOptions<ListItem>
     menuTrigger?: "manual" | "input" | "focus";
     /** Custom filter function to use when filtering items. */
     filter?: ComboBoxStateOptions<ListItem>["defaultFilter"];
+    /**
+     * The type of the input field
+     *
+     * @default text
+     */
+    inputType?: "text" | "number";
+    /**
+     * The minimum value for the input field. This is only valid when `inputType`
+     * is set to `number`.
+     */
+    minValue?: number;
+    /**
+     * The maximum value for the input field. This is only valid when `inputType`
+     * is set to `number`.
+     */
+    maxValue?: number;
 }
 
 declare const ComboBox: React.ForwardRefExoticComponent<ComboBoxProps & React.RefAttributes<HTMLDivElement>>;
@@ -2321,20 +2406,53 @@ interface ActionGroupProps extends StylingProps, Omit<AriaActionGroupProps<ListI
      * @default "single"
      */
     selectionMode?: "single" | "multiple";
-    /** Whether to include a tooltip on the action group items. */
-    includeTooltip?: boolean;
+    /** The props to be passed to the tooltip component. */
+    tooltipProps?: IconComponentProps["tooltipProps"] | ((item: ListItem) => IconComponentProps["tooltipProps"]);
+    /**
+     * A function that renders an action item. This function is called for each
+     * item in the action group. By default, an `ActionIconButton` is rendered.
+     *
+     * @default
+     *
+     * ```jsx
+     * <ActionIconButton
+     *   variant="tertiary"
+     *   icon={icon}
+     *   aria-label={item.textValue}
+     *   size="sm"
+     *   isDisabled={_isDisabled}
+     *   className={"BaselineUI-ActionGroup-Item"}
+     * />;
+     * ```
+     */
+    renderActionItem?: (item: Node$2<ListItem>, options: {
+        isSelected?: boolean;
+        isDisabled?: boolean;
+    }) => React.ReactNode;
 }
 
 declare const ActionGroup: React.ForwardRefExoticComponent<ActionGroupProps & React.RefAttributes<HTMLDivElement>>;
-declare const ActionGroupItem: React.FC<{
+declare const ActionGroupItem: React.FC<ActionGroupItemProps>;
+interface ActionGroupItemProps extends Pick<ActionGroupProps, "tooltipProps" | "renderActionItem" | "onAction" | "isDisabled"> {
     item: Node$2<ListItem>;
     state: ListState<ListItem>;
-    onAction?: (key: Key) => void;
-    isDisabled?: boolean;
-    includeTooltip?: boolean;
-}>;
+}
 
-interface ColorSwatchPickerProps extends StylingProps, Pick<ColorPresetInlineInputProps, "items" | "optionsContainerClassName" | "labelPosition">, Pick<ListBoxProps, "optionClassName" | "optionStyle">, AriaLabelingProps {
+interface ColorSwatchPickerProps extends StylingProps, Pick<RadioGroupProps, "optionsContainerClassName" | "labelPosition">, Pick<ListBoxProps, "optionClassName" | "optionStyle">, AriaLabelingProps {
+    /**
+     * The items to display in the picker. Each item should have a `color` and a
+     * `label`.
+     *
+     * ```js
+     * const items = [
+     *   { color: "#FF0000", label: "Red" },
+     *   { color: "#00FF00", label: "Green" },
+     *   { color: "#0000FF", label: "Blue" },
+     *   { color: "#FFFF00", label: "Yellow" },
+     * ];
+     * ```
+     */
+    items: ColorPreset[];
     /** The icon visible at the start of the picker. */
     icon?: React.FC<IconProps>;
     /**
@@ -2669,7 +2787,7 @@ interface TextSelectionProps {
  * @param element - The element to use to get the owner window. Defaults to
  *   `document.body`.
  */
-declare function useDevice(element?: Element | null | undefined): "desktop" | "tablet" | "mobile";
+declare function useDevice(element?: Element | null | undefined): "mobile" | "tablet" | "desktop";
 
 /**
  * Custom hook for accessing PortalContainerProviderContext. This hook allows
@@ -2683,11 +2801,4 @@ declare function useDevice(element?: Element | null | undefined): "desktop" | "t
  */
 declare function usePortalContainer(_portalContainer?: HTMLElement): HTMLElement | undefined;
 
-interface DynamicListOptions<T> extends ListOptions<T> {
-    onListChange?: (items: T[]) => void;
-    onSelectionChange?: (selectedKeys: Selection$1) => void;
-    getKey?: (item: T) => Key$1;
-}
-declare function useDynamicListData<T>(options: DynamicListOptions<T>): ListData<T>;
-
-export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, ActionButton, type ActionButtonProps, ActionGroup, ActionGroupItem, type ActionGroupProps, ActionIconButton, type ActionIconButtonProps, AlertDialog, type AlertDialogProps, AudioPlayer, type AudioPlayerProps, Avatar, type AvatarProps, type BlockProps, Box, type BoxProps, ButtonSelect, type ButtonSelectProps, Checkbox, type CheckboxProps, ColorInput, type ColorInputProps, type ColorPreset, ColorPresetInlineInput, type ColorPresetInlineInputProps, ColorSwatch, ColorSwatchPicker, type ColorSwatchPickerProps, type ColorSwatchProps, ComboBox, type ComboBoxProps, DateFormat, type DateFormatProps, Dialog, type DialogProps, DialogTitle, type DialogTitleProps, DomNodeRenderer, type DomNodeRendererProps, Drawer, type DrawerProps, Editor, type EditorHandle, type EditorProps, FileUpload, type FileUploadProps, FreehandCanvas, type FreehandCanvasProps, GridList, type GridListProps, Group, type GroupProps, I18nProvider, type I18nResult, IconColorInput, IconColorInputButton, type IconColorInputProps, IconSelect, type IconSelectProps, ImageDropZone, type ImageDropZoneProps, ImageGallery, type ImageGalleryProps, InlineAlert, type InlineAlertProps, Link, type LinkProps, ListBox, type ListBoxProps, type ListOption, Markdown, type MarkdownProps, Menu, type MenuItem, type MenuProps, type MessageDescriptor, MessageFormat, type MessageFormatProps, Modal, ModalClose, ModalContent, type ModalContentProps, type ModalProps, ModalTrigger, NumberFormat, type NumberFormatProps, NumberInput, type NumberInputProps, Pagination, type PaginationProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, Portal, PortalContainerProvider, type PortalProps, Preview, type PreviewProps, ProgressBar, type ProgressBarProps, ProgressSpinner, type ProgressSpinnerProps, RadioGroup, type RadioGroupProps, Reaction, type ReactionProps, type Rect, ScrollControlButton, type ScrollControlButtonProps, SearchInput, type SearchInputProps, Select, type SelectProps, Separator, type SeparatorProps, Slider, type SliderProps, type StylingProps, Switch, type SwitchProps, TabItem, type TabItemProps, Tabs, type TabsProps, TagGroup, type TagGroupProps, Text, TextInput, type TextInputProps, type TextProps, ThemeProvider, type ThemeProviderProps, ToggleButton, type ToggleButtonProps, ToggleIconButton, type ToggleIconButtonProps, Toolbar, type ToolbarProps, Tooltip, type TooltipProps, Transform, type TransformProps, Transition, type TransitionProps, defineMessages, isInsideOverlayContent, isRect, useDevice, useDynamicListData, useI18n, useImage, useIntersectionObserver, useIsFirstRender, useLocalStorage, useMutationObserver, usePortalContainer, useResizeObserver, useTextSelection, useUndoRedo, useUserPreferences };
+export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, ActionButton, type ActionButtonProps, ActionGroup, ActionGroupItem, type ActionGroupProps, ActionIconButton, type ActionIconButtonProps, AlertDialog, type AlertDialogProps, AudioPlayer, type AudioPlayerProps, Avatar, type AvatarProps, type BlockProps, Box, type BoxProps, ButtonSelect, type ButtonSelectProps, Checkbox, type CheckboxProps, ColorInput, type ColorInputProps, type ColorPreset, ColorSwatch, ColorSwatchPicker, type ColorSwatchPickerProps, type ColorSwatchProps, ComboBox, type ComboBoxProps, DateFormat, type DateFormatProps, Dialog, type DialogProps, DialogTitle, type DialogTitleProps, DomNodeRenderer, type DomNodeRendererProps, Drawer, type DrawerProps, Editor, type EditorHandle, type EditorProps, FileUpload, type FileUploadProps, FreehandCanvas, type FreehandCanvasProps, GridList, type GridListProps, Group, type GroupProps, I18nProvider, type I18nResult, IconColorInput, IconColorInputButton, type IconColorInputProps, IconSelect, type IconSelectProps, IconSlider, type IconSliderProps, ImageDropZone, type ImageDropZoneProps, ImageGallery, type ImageGalleryProps, InlineAlert, type InlineAlertProps, Link, type LinkProps, ListBox, type ListBoxProps, type ListOption, Markdown, type MarkdownProps, Menu, type MenuItem, type MenuProps, type MessageDescriptor, MessageFormat, type MessageFormatProps, Modal, ModalClose, ModalContent, type ModalContentProps, type ModalProps, ModalTrigger, NumberFormat, type NumberFormatProps, NumberInput, type NumberInputProps, Pagination, type PaginationProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, Portal, PortalContainerProvider, type PortalProps, Preview, type PreviewProps, ProgressBar, type ProgressBarProps, ProgressSpinner, type ProgressSpinnerProps, RadioGroup, type RadioGroupProps, Reaction, type ReactionProps, type Rect, ScrollControlButton, type ScrollControlButtonProps, SearchInput, type SearchInputProps, Select, type SelectProps, Separator, type SeparatorProps, Slider, type SliderProps, type StylingProps, Switch, type SwitchProps, TabItem, type TabItemProps, Tabs, type TabsProps, TagGroup, type TagGroupProps, Text, TextInput, type TextInputProps, type TextProps, ThemeProvider, type ThemeProviderProps, ToggleButton, type ToggleButtonProps, ToggleIconButton, type ToggleIconButtonProps, Toolbar, type ToolbarProps, Tooltip, type TooltipProps, Transform, type TransformProps, Transition, type TransitionProps, defineMessages, isInsideOverlayContent, isRect, useDevice, useI18n, useImage, useIntersectionObserver, useIsFirstRender, useLocalStorage, useMutationObserver, usePortalContainer, useResizeObserver, useTextSelection, useUndoRedo, useUserPreferences };