@baseline-ui/core 0.44.0 → 0.44.2

package/dist/index.d.ts

@@ -2407,6 +2407,10 @@ interface I18nProviderProps$1 {
     /** The locale to apply to the children. */
     locale?: string;
 }
+/**
+ * Returns the current locale and layout direction.
+ */
+declare function useLocale(): Locale;
 interface DateFormatterOptions extends Intl.DateTimeFormatOptions {
     calendar?: string;
 }
@@ -2433,6 +2437,20 @@ interface TreeProps<T> extends CollectionStateBase<T>, Expandable, MultipleSelec
     /** Whether `disabledKeys` applies to all interactions, or only selection. */
     disabledBehavior?: DisabledBehavior;
 }
+interface TreeState<T> {
+    /** A collection of items in the tree. */
+    readonly collection: Collection<Node$1<T>>;
+    /** A set of keys for items that are disabled. */
+    readonly disabledKeys: Set<Key>;
+    /** A set of keys for items that are expanded. */
+    readonly expandedKeys: Set<Key>;
+    /** Toggles the expanded state for an item by its key. */
+    toggleKey(key: Key): void;
+    /** Replaces the set of expanded keys. */
+    setExpandedKeys(keys: Set<Key>): void;
+    /** A selection manager to read and update multiple selection state. */
+    readonly selectionManager: SelectionManager;
+}
 
 interface GridListProps$1<T> extends CollectionBase<T>, MultipleSelection {
     /** Whether to auto focus the gridlist or an option. */
@@ -3376,6 +3394,11 @@ interface AriaToolbarProps extends AriaLabelingProps {
      * @default 'horizontal'
      */
     orientation?: Orientation;
+    /**
+   * Allows tabbing through the toolbar's content when false.
+   * @default true
+   */
+    isSingleTabStop?: boolean;
 }
 
 /*
@@ -19259,6 +19282,31 @@ declare function getOsSpecificKeyboardShortcutLabel(keyboardShortcut: string, us
  */
 declare const getPlainText: (text: string) => string;
 
+/**
+ * Checks whether a given DOM node is inside an iframe.
+ *
+ * This function compares the node's owning document's `defaultView` to
+ * `window.top`. If they're different, the node is inside an iframe. Handles
+ * cross-origin iframes safely using try/catch.
+ *
+ * @param {Node} node - The DOM node to check.
+ * @returns {boolean} `true` if the node is inside an iframe, `false` otherwise.
+ * @see https://stackoverflow.com/a/326076
+ */
+declare function isInIframe(el: Node): boolean;
+
+/**
+ * Checks whether a given node is inside a Shadow DOM.
+ *
+ * This function uses `getRootNode()` to determine if the node's root is a
+ * `ShadowRoot`, which indicates that the node is part of a shadow tree.
+ *
+ * @param {Node} node - The DOM node to check.
+ * @returns {boolean} `true` if the node is inside a Shadow DOM, `false`
+ *   otherwise.
+ */
+declare function isInShadowDOM(element: Node | null | undefined): boolean;
+
 interface ListHandle {
     /** Scrolls the listbox to the specified item. */
     scrollIntoView: (id: string, options?: ScrollIntoViewOptions) => void;
@@ -19408,18 +19456,6 @@ interface ActionButtonProps extends ActionButtonSharedProps {
 
 declare const ActionButton: React__default__default.ForwardRefExoticComponent<ActionButtonProps & React__default__default.RefAttributes<HTMLButtonElement>>;
 
-interface DomNodeRendererProps extends StylingProps, Omit<PressHookProps, "ref"> {
-    /**
-     * The DOM node to render inside the component. If this is not provided, the
-     * component will render nothing. If this is provided, the component will
-     * render the DOM node inside a `div` component with `display` set to
-     * `contents`.
-     */
-    node: Node;
-}
-
-declare const DomNodeRenderer: React__default__default.ForwardRefExoticComponent<DomNodeRendererProps & React__default__default.RefAttributes<HTMLDivElement>>;
-
 interface ModalProps extends OverlayTriggerProps$1 {
     /** The contents of the modal. */
     children: React__default__default.ReactNode;
@@ -19568,6 +19604,91 @@ declare const PopoverTrigger: React__default__default.FC<PopoverTriggerProps>;
 
 declare const Popover: React__default__default.FC<PopoverProps>;
 
+type MenuOption = Omit<ListOption, "description"> & {
+    keyboardShortcut?: string;
+};
+type MenuSection = Omit<ListSection, "children"> & {
+    children: MenuOption[];
+};
+type MenuItem = MenuOption | MenuSection;
+type MenuPopoverProps = Pick<PopoverContentProps, "isNonModal" | "placement" | "shouldUpdatePosition" | "shouldFlip" | "boundaryElement" | "crossOffset" | "offset" | "portalContainer">;
+interface MenuProps extends MenuPopoverProps, MenuTriggerProps, Omit<AriaMenuProps<MenuItem>, "children">, Omit<AriaMenuTriggerProps, "type"> {
+    /** The `className` property assigned to the root element of the component. */
+    className?: string;
+    /** The `className` property assigned to the content element of the component. */
+    contentClassName?: string;
+    /** The `className` property assigned to the item element of the component. */
+    itemClassName?: string;
+    /**
+     * A list of items to render in the menu. Items have the following shape:
+     *
+     * ```ts
+     * export type MenuOption = {
+     *   id: string;
+     *   label: string;
+     *   keyboardShortcut?: string;
+     *   icon?: React.FC<IconProps>;
+     * };
+     *
+     * export type MenuSection = {
+     *   id: string;
+     *   title?: string;
+     *   type: "section";
+     *   children: MenuOption[];
+     * };
+     *
+     * export type MenuItem = MenuOption | MenuSection;
+     * ```
+     */
+    items: MenuItem[];
+    /**
+     * A function that renders the trigger element of the component. The default
+     * implementation renders an `ActionButton` component.
+     *
+     * ```tsx
+     * <Menu renderTrigger={({ buttonProps, ref }) => <ActionButton {...buttonProps} label="Label" ref={ref} />
+     * ```
+     */
+    renderTrigger?: (options: {
+        buttonProps: ActionButtonProps;
+        ref: React__default__default.RefObject<HTMLButtonElement>;
+    }) => React__default__default.ReactNode;
+    /**
+     * The label of the trigger element. This can be a string, a React node, or a
+     * function that accepts a boolean indicating whether the menu is open.
+     */
+    triggerLabel?: React__default__default.ReactNode | ((isOpen: boolean) => React__default__default.ReactNode);
+}
+
+declare const DefaultListOption: React__default__default.ForwardRefExoticComponent<DefaultListOptionProps & React__default__default.RefAttributes<HTMLLIElement>>;
+interface DefaultListOptionProps {
+    item: Node$1<ListItem | MenuItem>;
+    liProps: React__default__default.ComponentProps<"li">;
+    labelProps: React__default__default.ComponentProps<"span">;
+    isFocusVisible: boolean;
+    isDisabled: boolean;
+    isSelected: boolean;
+    showSelectedIcon?: boolean;
+    description?: string;
+    descriptionProps?: React__default__default.ComponentProps<"span">;
+    selectionMode?: "single" | "multiple";
+    isFocused?: boolean;
+    isPressed?: boolean;
+    _state: ListState<ListItem> | TreeState<MenuItem>;
+}
+
+interface DomNodeRendererProps extends StylingProps, Omit<PressHookProps, "ref"> {
+    /**
+     * The DOM node to render inside the component. If this is not provided, the
+     * component will render nothing. If this is provided, the component will
+     * render the DOM node inside a `div` component with `display` set to
+     * `contents`.
+     */
+    node: Node;
+}
+
+declare const DomNodeRenderer: React__default__default.ForwardRefExoticComponent<DomNodeRendererProps & React__default__default.RefAttributes<HTMLDivElement>>;
+
 interface TooltipProps extends StylingProps, TooltipTriggerProps, AriaTooltipProps, Omit<AriaPositionProps, "overlayRef" | "targetRef" | "maxHeight" | "isOpen" | "arrowSize"> {
     /** The content of the tooltip. */
     text?: string;
@@ -19804,62 +19925,6 @@ interface PortalContainerProviderProps {
 
 declare const PortalContainerProvider: React__default__default.FC<PortalContainerProviderProps>;
 
-type MenuOption = Omit<ListOption, "description"> & {
-    keyboardShortcut?: string;
-};
-type MenuSection = Omit<ListSection, "children"> & {
-    children: MenuOption[];
-};
-type MenuItem = MenuOption | MenuSection;
-type MenuPopoverProps = Pick<PopoverContentProps, "isNonModal" | "placement" | "shouldUpdatePosition" | "shouldFlip" | "boundaryElement" | "crossOffset" | "offset" | "portalContainer">;
-interface MenuProps extends MenuPopoverProps, MenuTriggerProps, Omit<AriaMenuProps<MenuItem>, "children">, Omit<AriaMenuTriggerProps, "type"> {
-    /** The `className` property assigned to the root element of the component. */
-    className?: string;
-    /** The `className` property assigned to the content element of the component. */
-    contentClassName?: string;
-    /** The `className` property assigned to the item element of the component. */
-    itemClassName?: string;
-    /**
-     * A list of items to render in the menu. Items have the following shape:
-     *
-     * ```ts
-     * export type MenuOption = {
-     *   id: string;
-     *   label: string;
-     *   keyboardShortcut?: string;
-     *   icon?: React.FC<IconProps>;
-     * };
-     *
-     * export type MenuSection = {
-     *   id: string;
-     *   title?: string;
-     *   type: "section";
-     *   children: MenuOption[];
-     * };
-     *
-     * export type MenuItem = MenuOption | MenuSection;
-     * ```
-     */
-    items: MenuItem[];
-    /**
-     * A function that renders the trigger element of the component. The default
-     * implementation renders an `ActionButton` component.
-     *
-     * ```tsx
-     * <Menu renderTrigger={({ buttonProps, ref }) => <ActionButton {...buttonProps} label="Label" ref={ref} />
-     * ```
-     */
-    renderTrigger?: (options: {
-        buttonProps: ActionButtonProps;
-        ref: React__default__default.RefObject<HTMLButtonElement>;
-    }) => React__default__default.ReactNode;
-    /**
-     * The label of the trigger element. This can be a string, a React node, or a
-     * function that accepts a boolean indicating whether the menu is open.
-     */
-    triggerLabel?: React__default__default.ReactNode | ((isOpen: boolean) => React__default__default.ReactNode);
-}
-
 declare const Menu: React__default__default.ForwardRefExoticComponent<MenuProps & React__default__default.RefAttributes<HTMLUListElement>>;
 
 interface LinkProps extends AriaLinkOptions, StylingProps {
@@ -20117,6 +20182,8 @@ interface I18nProviderProps extends I18nProviderProps$1 {
 
 declare const I18nProvider: React__default__default.FC<I18nProviderProps>;
 
+declare const directionVar: `var(--${string})` | `var(--${string}, ${string})` | `var(--${string}, ${number})`;
+
 type NumberFormatProps = Parameters<typeof useNumberFormatter>[0] & {
     /** The number to format. */
     value: number;
@@ -20526,7 +20593,8 @@ interface ColorSwatchProps extends Omit<AriaColorSwatchProps, "colorName">, Styl
     tooltip?: boolean | Partial<Omit<TooltipProps, "children">>;
     /**
      * Whether the swatch is indeterminate. When this is `true`, the color related
-     * props will be ignored.
+     * props will be ignored and indeterminate styles will be applied. This change
+     * is only visual.
      *
      * @default false
      */
@@ -21161,13 +21229,25 @@ interface ToolbarProps extends StylingProps, AriaToolbarProps {
      */
     collapsibleMenuProps?: Omit<MenuProps, "items" | "onAction" | "placement" | "disabledKeys">;
     /**
-     * A function that renders a spacer element in the collapsible toolbar between
-     * the toolbar buttons and the menu trigger. This prop is only relevant when
-     * `isCollapsible` is true.
+     * A boolean indicating whether to render a spacer element in the collapsible
+     * toolbar between the toolbar buttons and the menu trigger. This prop is only
+     * relevant when `isCollapsible` is true.
      */
     renderSpacer?: boolean;
     /** The callback to call when any key is pressed. */
     onKeyDown?: KeyboardProps["onKeyDown"];
+    /**
+     * When set to true, the toolbar will act as a normal toolbar and will not
+     * contain the navigation within it when the user presses tab again.
+     *
+     * When set to false, the toolbar will allow for navigating through all
+     * elements within it if the user presses tab, and move to the next focusable
+     * element outside of the toolbar only after user navigates through all
+     * elements within the toolbar.
+     *
+     * @default true
+     */
+    isSingleTabStop?: boolean;
 }
 
 declare const Toolbar: React__default__default.ForwardRefExoticComponent<ToolbarProps & React__default__default.RefAttributes<HTMLDivElement>>;
@@ -22682,5 +22762,5 @@ declare namespace reactStately {
   export type { Color };
 }
 
-export { Accordion, AccordionItem, ActionButton, ActionGroup, ActionGroupItem, ActionIconButton, AlertDialog, AudioPlayer, Avatar, Box, ButtonSelect, Checkbox, ColorInput, ColorSwatch, ColorSwatchPicker, ComboBox, DateField, DateFormat, DeviceProvider, DeviceProviderContext, Dialog, DialogTitle, DomNodeRenderer, Drawer, Editor, FileUpload, FocusScope, Focusable, FrameProvider, FreehandCanvas, GlobalToastRegion, GridList, Group, I18nProvider, Icon, IconColorInput, IconColorInputButton, IconSelect, IconSlider, ImageDropZone, ImageGallery, InlineAlert, Link, ListBox, Markdown, Menu, MessageFormat, Modal, ModalClose, ModalContent, ModalTrigger, MotionGlobalConfig, NumberFormat, NumberInput, Pagination, Panel, PanelGroup, PanelResizeHandle, PointPicker, PointPickerContent, PointPickerDisplay, PointsVisualiser, Popover, PopoverContent, PopoverTrigger, Portal, PortalContainerProvider, Pressable, Preview, ProgressBar, ProgressSpinner, RadioGroup, Reaction, ScrollControlButton, SearchInput, Select, Separator, Slider, Switch, TabItem, Tabs, TagGroup, TaggedPagination, Text, TextInput, ThemeProvider, TimeField, ToastQueue, ToggleButton, ToggleIconButton, Toolbar, Tooltip, Transform, TreeView, reactAria as UNSAFE_aria, reactStately as UNSAFE_stately, VisuallyHidden, announce, calculateFontSizeToFitWidth, classNames, cleanKeyFromGlobImport, clearAnnouncer, defineMessages, destroyAnnouncer, disableAnimations, enableAnimations, filterDOMProps, filterTruthyValues, findFocusableElements, getAbsoluteBounds, getAbsolutePosition, getActiveElement, getHTMLElement, getOsSpecificKeyboardShortcutLabel, getOwnerDocument, getPlainText, getSvgPathFromStroke, getTextDimensions, invariant, isFocusableElement, isInputThatOpensKeyboard, isInsideOverlayContent, isRect, isUrl, lightenColor, mergeProps, mergeRefs, parseColor, useCollator, useDateFormatter, useDevice, useFocusRing, useFocusVisible, useI18n, useId, useImage, useInteractionModality, useIntersectionObserver, useIsFirstRender, useKeyboard, useLiveInteractionModality, useLocalStorage, useMutationObserver, useNumberFormatter, useObjectRef, usePointProximity, usePortalContainer, useResizeObserver, useTextSelection, useUndoRedo, useUserPreferences };
+export { Accordion, AccordionItem, ActionButton, ActionGroup, ActionGroupItem, ActionIconButton, AlertDialog, AudioPlayer, Avatar, Box, ButtonSelect, Checkbox, ColorInput, ColorSwatch, ColorSwatchPicker, ComboBox, DateField, DateFormat, DefaultListOption, DeviceProvider, DeviceProviderContext, Dialog, DialogTitle, DomNodeRenderer, Drawer, Editor, FileUpload, FocusScope, Focusable, FrameProvider, FreehandCanvas, GlobalToastRegion, GridList, Group, I18nProvider, Icon, IconColorInput, IconColorInputButton, IconSelect, IconSlider, ImageDropZone, ImageGallery, InlineAlert, Link, ListBox, Markdown, Menu, MessageFormat, Modal, ModalClose, ModalContent, ModalTrigger, MotionGlobalConfig, NumberFormat, NumberInput, Pagination, Panel, PanelGroup, PanelResizeHandle, PointPicker, PointPickerContent, PointPickerDisplay, PointsVisualiser, Popover, PopoverContent, PopoverTrigger, Portal, PortalContainerProvider, Pressable, Preview, ProgressBar, ProgressSpinner, RadioGroup, Reaction, ScrollControlButton, SearchInput, Select, Separator, Slider, Switch, TabItem, Tabs, TagGroup, TaggedPagination, Text, TextInput, ThemeProvider, TimeField, ToastQueue, ToggleButton, ToggleIconButton, Toolbar, Tooltip, Transform, TreeView, reactAria as UNSAFE_aria, reactStately as UNSAFE_stately, VisuallyHidden, announce, calculateFontSizeToFitWidth, classNames, cleanKeyFromGlobImport, clearAnnouncer, defineMessages, destroyAnnouncer, directionVar, disableAnimations, enableAnimations, filterDOMProps, filterTruthyValues, findFocusableElements, getAbsoluteBounds, getAbsolutePosition, getActiveElement, getHTMLElement, getOsSpecificKeyboardShortcutLabel, getOwnerDocument, getPlainText, getSvgPathFromStroke, getTextDimensions, invariant, isFocusableElement, isInIframe, isInShadowDOM, isInputThatOpensKeyboard, isInsideOverlayContent, isRect, isUrl, lightenColor, mergeProps, mergeRefs, parseColor, useCollator, useDateFormatter, useDevice, useFocusRing, useFocusVisible, useI18n, useId, useImage, useInteractionModality, useIntersectionObserver, useIsFirstRender, useKeyboard, useLiveInteractionModality, useLocalStorage, useLocale, useMutationObserver, useNumberFormatter, useObjectRef, usePointProximity, usePortalContainer, useResizeObserver, useTextSelection, useUndoRedo, useUserPreferences };
 export type { AccordionItemProps, AccordionProps, ActionButtonProps, ActionGroupProps, ActionIconButtonProps, AlertDialogProps, Assertiveness, AudioPlayerProps, AvatarProps, BlockProps, BoxProps, ButtonSelectProps, CheckboxProps, ColorInputProps, ColorPreset, ColorSwatchPickerProps, ColorSwatchProps, ComboBoxProps, DateFieldProps, DateFormatProps, Device, DeviceProviderProps, DialogProps, DialogTitleProps, DomNodeRendererProps, DrawerProps, EditorHandle, EditorProps, FileUploadProps, FocusableProps, FrameProviderProps, FreehandCanvasProps, GridListProps, GroupProps, I18nProviderProps, I18nResult, IconColorInputProps, IconComponentProps$1 as IconComponentProps, IconProps, IconSelectProps, IconSliderProps, ImageDropZoneProps, ImageGalleryProps, ImperativePanelGroupHandle, ImperativePanelHandle, InlineAlertProps, Key, LinkProps, ListBoxProps, ListHandle, ListOption, MarkdownProps, MenuItem, MenuProps, Message, MessageDescriptor, MessageFormatProps, MessageFormatter, ModalContentProps, ModalProps, NumberFormatProps, NumberInputProps, PaginationProps, PanelGroupProps, PanelProps, PanelResizeHandleProps, PointPickerContentProps, PointPickerDisplayProps, PointPickerProps, PointsVisualiserProps, PopoverContentProps, PopoverProps, PopoverTriggerProps, PortalProps, PressEvent, PreviewProps, ProgressBarProps, ProgressSpinnerProps, RadioGroupProps, ReactComplexTreeItem, ReactionProps, Rect, SVGRProps, ScrollControlButtonProps, SearchInputProps, SelectProps, SeparatorProps, SliderProps, StylingProps, SwitchProps, TabItemProps, TabsProps, TagGroupProps, TaggedPaginationProps, TextInputProps, TextProps, ThemeProviderProps, TimeFieldProps, ToastProps, ToggleButtonProps, ToggleIconButtonProps, ToolbarProps, TooltipProps, TransformProps, TreeViewProps };