@baseline-ui/core 0.51.0 → 0.52.0

package/Acknowledgements.md

@@ -9817,7 +9817,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ---
 
-The following software may be included in this product: markdown-it (14.1.0)
+The following software may be included in this product: markdown-it (14.1.1)
 This software contains the following license and notice below:
 
 Copyright (c) 2014 Vitaly Puzrin, Alex Kocharin.

package/dist/index.d.mts

@@ -3070,6 +3070,12 @@ interface AriaMenuTriggerProps {
     trigger?: MenuTriggerType;
 }
 
+/**
+ * Controls which axes the boundary element constrains when calculating overlay
+ * position.
+ */
+type BoundaryAxis = 'horizontal' | 'vertical' | 'both';
+
 interface AriaPositionProps extends PositionProps {
     /**
      * Cross size of the overlay arrow in pixels.
@@ -3077,10 +3083,23 @@ interface AriaPositionProps extends PositionProps {
      */
     arrowSize?: number;
     /**
-     * Element that that serves as the positioning boundary.
+     * Element that serves as the positioning boundary. The overlay is shifted or
+     * flipped to stay within this element's bounds on the axes selected by
+     * `boundaryAxis`. Pass `null` to disable all boundary constraints.
      * @default document.body
      */
-    boundaryElement?: Element;
+    boundaryElement?: Element | null;
+    /**
+     * Controls which axes `boundaryElement` constrains.
+     *
+     * - `"both"` — constrains horizontal and vertical (default)
+     * - `"horizontal"` — constrains only horizontal overflow
+     * - `"vertical"` — constrains only vertical overflow
+     *
+     * Has no effect when `boundaryElement` is `null`.
+     * @default "both"
+     */
+    boundaryAxis?: BoundaryAxis;
     /**
      * The ref for the element which the overlay positions itself with respect to.
      */
@@ -5448,7 +5467,7 @@ type ClassName$1 = string | ((state: {
 type Style = React__default.CSSProperties | ((state: {
     isOpen: boolean;
 }) => React__default.CSSProperties | undefined);
-interface PopoverContentProps extends Omit<AriaPopoverProps, "popoverRef" | "triggerRef" | "arrowSize" | "arrowBoundaryOffset" | "shouldCloseOnScroll">, Pick<OverlayProps, "shouldContainFocus" | "disableFocusManagement">, Pick<ModalContentProps, "disableAnimation">, BlockProps {
+interface PopoverContentProps extends Omit<AriaPopoverProps, "popoverRef" | "triggerRef" | "arrowSize" | "arrowBoundaryOffset" | "shouldCloseOnScroll" | "boundaryElement">, Pick<OverlayProps, "shouldContainFocus" | "disableFocusManagement">, Pick<ModalContentProps, "disableAnimation">, BlockProps {
     /** The class name for the popover element. */
     className?: ClassName$1;
     /** The style for the popover element. */
@@ -5505,6 +5524,29 @@ interface PopoverContentProps extends Omit<AriaPopoverProps, "popoverRef" | "tri
      * trigger popover position recalculation.
      */
     elementHandle?: React__default.Ref<PopoverContentHandle>;
+    /**
+     * The element used as the boundary when calculating popover position. The
+     * popover is shifted or flipped to stay within this element's bounds on the
+     * axes specified by `boundaryAxis`.
+     *
+     * Pass `null` to disable all boundary constraints.
+     *
+     * @default document.body
+     */
+    boundaryElement?: Element | null;
+    /**
+     * Controls which axes the `boundaryElement` constrains. Has no effect when
+     * `boundaryElement` is `null`.
+     *
+     * - `"both"` — constrains horizontal and vertical (default)
+     * - `"horizontal"` — constrains only horizontal overflow; popover may overflow
+     *   vertically
+     * - `"vertical"` — constrains only vertical overflow; popover may overflow
+     *   horizontally
+     *
+     * @default "both"
+     */
+    boundaryAxis?: BoundaryAxis;
 }
 interface PopoverTriggerProps {
     /** The contents of the popover trigger. */
@@ -5533,7 +5575,7 @@ type MenuSection = Omit<ListSection, "children"> & {
     children: MenuOption[];
 };
 type MenuItem = MenuOption | MenuSection;
-type MenuPopoverProps = Pick<PopoverContentProps, "isNonModal" | "placement" | "shouldUpdatePosition" | "shouldFlip" | "boundaryElement" | "crossOffset" | "offset" | "portalContainer">;
+type MenuPopoverProps = Pick<PopoverContentProps, "isNonModal" | "placement" | "shouldUpdatePosition" | "shouldFlip" | "boundaryElement" | "boundaryAxis" | "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;
@@ -6994,6 +7036,13 @@ interface ImageDropZoneProps extends Omit<SharedFileUploadProps, "label" | "vari
     labelClassName?: string;
     /** The style to apply to the label. */
     labelStyle?: React__default.CSSProperties;
+    /**
+     * Maximum allowed file size in bytes. Files exceeding this limit will be
+     * rejected.
+     */
+    maxFileSize?: number;
+    /** Callback fired when a dropped/pasted/selected file exceeds `maxFileSize`. */
+    onFileSizeError?: (file: File) => void;
 }
 
 declare const ImageDropZone: React__default.ForwardRefExoticComponent<ImageDropZoneProps & React__default.RefAttributes<HTMLDivElement>>;
@@ -8083,6 +8132,12 @@ declare const TreeView: React__default.ForwardRefExoticComponent<TreeViewProps &
 interface PanelProps extends StylingProps {
     /** Content */
     children: ReactNode;
+    /**
+     * Unique identifier for the panel. Required for localStorage persistence when
+     * using `PanelGroup` with `autoSaveId`. Must remain stable across page
+     * loads.
+     */
+    id?: PanelProps$1["id"];
     /**
      * Panel collapses to this size
      *
@@ -8126,7 +8181,8 @@ interface PanelGroupProps extends StylingProps {
     onLayout?: PanelGroupProps$1["onLayout"];
     /**
      * When passed, automatically persists layouts, should be unique amongst other
-     * `PanelGroup`
+     * `PanelGroup`. Each `Panel` should have a stable `id` prop for persistence
+     * to work correctly.
      */
     autoSaveId?: PanelGroupProps$1["autoSaveId"];
 }
@@ -8715,11 +8771,12 @@ declare function useIsFirstRender(): boolean;
 
 /**
  * A hook that provides internationalization functionality. It returns a
- * function to format messages and the current locale. The hook can be used with
- * or without a messages object. If no messages object is provided, the hook
- * will use the messages provided by the `I18nProvider`. If a messages object is
- * provided, the hook will use those messages instead of the ones provided by
- * the `I18nProvider`.
+ * function to format messages and the current locale.
+ *
+ * When both a local `messages` object and provider messages (from
+ * `I18nProvider`) are present, they are merged per locale: provider messages
+ * win on key conflicts, while unmatched local keys are preserved. When only one
+ * source is present the behavior is unchanged (backwards compatible).
  *
  * @example
  *   ```tsx
@@ -8742,8 +8799,11 @@ declare function useIsFirstRender(): boolean;
  *   ```;
  *
  * @template T - A type that represents the shape of the translation messages.
- * @param {Object<string, T>} [messages] - An optional object containing
- *   translation messages for different languages.
+ * @param messages - An optional object containing translation messages for
+ *   different locales. When provider messages (from `I18nProvider`) are also
+ *   present, local and provider messages are merged per locale — provider
+ *   values take precedence on key conflicts. If omitted, the hook reads
+ *   entirely from the provider.
  * @returns {I18nResult<T>} An object containing a function to format messages
  *   and the current locale.
  */
@@ -8946,4 +9006,4 @@ declare namespace reactStately {
   export { type reactStately_Color as Color, type reactStately_ListData as ListData, type reactStately_TreeData as TreeData, reactStately_useListData as useListData, reactStately_useTreeData as useTreeData };
 }
 
-export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, ActionButton, type ActionButtonProps, ActionGroup, ActionGroupItem, type ActionGroupProps, ActionIconButton, type ActionIconButtonProps, Actionable, type ActionableProps, AlertDialog, type AlertDialogProps, AudioPlayer, type AudioPlayerProps, Autocomplete, type AutocompleteProps, Avatar, type AvatarProps, type BlockProps, Box, type BoxProps, ButtonSelect, type ButtonSelectProps, Checkbox, type CheckboxProps, Code, type CodeProps, ColorInput, type ColorInputProps, type ColorPreset, ColorSwatch, ColorSwatchPicker, type ColorSwatchPickerProps, type ColorSwatchProps, ComboBox, type ComboBoxProps, DateField, type DateFieldProps, DateFormat, type DateFormatProps, DefaultListOption, type Device, DeviceProvider, DeviceProviderContext, type DeviceProviderProps, Dialog, type DialogProps, DialogTitle, type DialogTitleProps, Disclosure, type DisclosureProps, DomNodeRenderer, type DomNodeRendererProps, Drawer, type DrawerProps, Editor, type EditorHandle, type EditorProps, FileUpload, type FileUploadProps, FocusScope, Focusable, type FocusableProps, FrameProvider, type FrameProviderProps, FreehandCanvas, type FreehandCanvasProps, GlobalToastRegion, GridLayout, GridList, type GridListProps, Group, type GroupProps, I18nProvider, type I18nProviderProps, type I18nResult, Icon, IconColorInput, IconColorInputButton, type IconColorInputProps, type IconComponentProps$1 as IconComponentProps, type IconProps, IconSelect, type IconSelectProps, IconSlider, type IconSliderProps, ImageDropZone, type ImageDropZoneProps, ImageGallery, type ImageGalleryProps, type ImperativePanelGroupHandle, type ImperativePanelHandle, InlineAlert, type InlineAlertProps, Kbd, type KbdProps, type Key, Link, type LinkProps, ListBox, type ListBoxProps, type ListHandle$1 as ListHandle, ListLayout, type ListOption, Markdown, type MarkdownProps, Menu, type MenuItem, type MenuProps, type MessageDescriptor, MessageFormat, type MessageFormatProps, type MessageFormatter, Modal, ModalClose, ModalContent, type ModalContentProps, type ModalProps, ModalTrigger, NumberFormat, type NumberFormatProps, NumberInput, type NumberInputProps, Pagination, type PaginationProps, Panel, PanelGroup, type PanelGroupProps, type PanelProps, PanelResizeHandle, type PanelResizeHandleProps, PointPicker, PointPickerContent, type PointPickerContentProps, PointPickerDisplay, type PointPickerDisplayProps, type PointPickerProps, Popover, PopoverContent, type PopoverContentHandle, type PopoverContentProps, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, Portal, PortalContainerProvider, type PortalProps, type PressEvent, Pressable, Preview, type PreviewProps, ProgressBar, type ProgressBarProps, ProgressSpinner, type ProgressSpinnerProps, RadioGroup, type RadioGroupProps, Reaction, type ReactionProps, type Rect, type SVGRProps, ScrollControlButton, type ScrollControlButtonProps, SearchInput, type SearchInputProps, Select, type SelectProps, Separator, type SeparatorProps, Size, Slider, type SliderProps, StatusCard, type StatusCardProps, type StylingProps, Switch, type SwitchProps, TabItem, type TabItemProps, TableLayout, Tabs, type TabsProps, TagGroup, type TagGroupProps, TaggedPagination, type TaggedPaginationProps, Text, TextInput, type TextInputProps, type TextProps, ThemeProvider, type ThemeProviderProps, TimeField, type TimeFieldProps, type ToastProps, ToastQueue, ToggleButton, type ToggleButtonProps, ToggleIconButton, type ToggleIconButtonProps, Toolbar, type ToolbarProps, Tooltip, type TooltipProps, type TreeListItem, TreeView, type TreeViewProps, UNSAFE_ListBox, type UNSAFE_ListBoxProps, reactAria as UNSAFE_aria, reactStately as UNSAFE_stately, VIRTUALIZER_LAYOUT_DEFAULT_OPTIONS, Virtualizer, type VirtualizerProps, VisuallyHidden, WaterfallLayout, announce, booleanOrObjectToConfig, calculateFontSizeToFitWidth, classNames, cleanKeyFromGlobImport, clearAnnouncer, defineMessages, destroyAnnouncer, directionVar, disableAnimations, enableAnimations, filterDOMProps, filterTruthyValues, findFocusableElements, getAbsoluteBounds, getAbsolutePosition, getActiveElement, getHTMLElement, getOsSpecificKeyboardShortcutLabel, getOwnerDocument, getPlainText, getSvgPathFromStroke, getTextDimensions, iconMap, invariant, isFocusableElement, isInIframe, isInShadowDOM, isInputThatOpensKeyboard, isInsideOverlayContent, isRect, isUrl, lightenColor, mergeProps, mergeRefs, parseColor, useCollator, useDateFormatter, useDevice, useDragAndDrop, useFilter, useFocusRing, useFocusVisible, useFrameDimensions, useI18n, useId, useImage, useInteractionModality, useIntersectionObserver, useIsFirstRender, useKeyboard, useListData, useLiveInteractionModality, useLocalStorage, useLocale, useMutationObserver, useNumberFormatter, useObjectRef, usePointProximity, usePortalContainer, usePreventFocus, useResizeObserver, useTextSelection, useUndoRedo, useUserPreferences };
+export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, ActionButton, type ActionButtonProps, ActionGroup, ActionGroupItem, type ActionGroupProps, ActionIconButton, type ActionIconButtonProps, Actionable, type ActionableProps, AlertDialog, type AlertDialogProps, AudioPlayer, type AudioPlayerProps, Autocomplete, type AutocompleteProps, Avatar, type AvatarProps, type BlockProps, type BoundaryAxis, Box, type BoxProps, ButtonSelect, type ButtonSelectProps, Checkbox, type CheckboxProps, Code, type CodeProps, ColorInput, type ColorInputProps, type ColorPreset, ColorSwatch, ColorSwatchPicker, type ColorSwatchPickerProps, type ColorSwatchProps, ComboBox, type ComboBoxProps, DateField, type DateFieldProps, DateFormat, type DateFormatProps, DefaultListOption, type Device, DeviceProvider, DeviceProviderContext, type DeviceProviderProps, Dialog, type DialogProps, DialogTitle, type DialogTitleProps, Disclosure, type DisclosureProps, DomNodeRenderer, type DomNodeRendererProps, Drawer, type DrawerProps, Editor, type EditorHandle, type EditorProps, FileUpload, type FileUploadProps, FocusScope, Focusable, type FocusableProps, FrameProvider, type FrameProviderProps, FreehandCanvas, type FreehandCanvasProps, GlobalToastRegion, GridLayout, GridList, type GridListProps, Group, type GroupProps, I18nProvider, type I18nProviderProps, type I18nResult, Icon, IconColorInput, IconColorInputButton, type IconColorInputProps, type IconComponentProps$1 as IconComponentProps, type IconProps, IconSelect, type IconSelectProps, IconSlider, type IconSliderProps, ImageDropZone, type ImageDropZoneProps, ImageGallery, type ImageGalleryProps, type ImperativePanelGroupHandle, type ImperativePanelHandle, InlineAlert, type InlineAlertProps, Kbd, type KbdProps, type Key, Link, type LinkProps, ListBox, type ListBoxProps, type ListHandle$1 as ListHandle, ListLayout, type ListOption, Markdown, type MarkdownProps, Menu, type MenuItem, type MenuProps, type MessageDescriptor, MessageFormat, type MessageFormatProps, type MessageFormatter, Modal, ModalClose, ModalContent, type ModalContentProps, type ModalProps, ModalTrigger, NumberFormat, type NumberFormatProps, NumberInput, type NumberInputProps, Pagination, type PaginationProps, Panel, PanelGroup, type PanelGroupProps, type PanelProps, PanelResizeHandle, type PanelResizeHandleProps, PointPicker, PointPickerContent, type PointPickerContentProps, PointPickerDisplay, type PointPickerDisplayProps, type PointPickerProps, Popover, PopoverContent, type PopoverContentHandle, type PopoverContentProps, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, Portal, PortalContainerProvider, type PortalProps, type PressEvent, Pressable, Preview, type PreviewProps, ProgressBar, type ProgressBarProps, ProgressSpinner, type ProgressSpinnerProps, RadioGroup, type RadioGroupProps, Reaction, type ReactionProps, type Rect, type SVGRProps, ScrollControlButton, type ScrollControlButtonProps, SearchInput, type SearchInputProps, Select, type SelectProps, Separator, type SeparatorProps, Size, Slider, type SliderProps, StatusCard, type StatusCardProps, type StylingProps, Switch, type SwitchProps, TabItem, type TabItemProps, TableLayout, Tabs, type TabsProps, TagGroup, type TagGroupProps, TaggedPagination, type TaggedPaginationProps, Text, TextInput, type TextInputProps, type TextProps, ThemeProvider, type ThemeProviderProps, TimeField, type TimeFieldProps, type ToastProps, ToastQueue, ToggleButton, type ToggleButtonProps, ToggleIconButton, type ToggleIconButtonProps, Toolbar, type ToolbarProps, Tooltip, type TooltipProps, type TreeListItem, TreeView, type TreeViewProps, UNSAFE_ListBox, type UNSAFE_ListBoxProps, reactAria as UNSAFE_aria, reactStately as UNSAFE_stately, VIRTUALIZER_LAYOUT_DEFAULT_OPTIONS, Virtualizer, type VirtualizerProps, VisuallyHidden, WaterfallLayout, announce, booleanOrObjectToConfig, calculateFontSizeToFitWidth, classNames, cleanKeyFromGlobImport, clearAnnouncer, defineMessages, destroyAnnouncer, directionVar, disableAnimations, enableAnimations, filterDOMProps, filterTruthyValues, findFocusableElements, getAbsoluteBounds, getAbsolutePosition, getActiveElement, getHTMLElement, getOsSpecificKeyboardShortcutLabel, getOwnerDocument, getPlainText, getSvgPathFromStroke, getTextDimensions, iconMap, invariant, isFocusableElement, isInIframe, isInShadowDOM, isInputThatOpensKeyboard, isInsideOverlayContent, isRect, isUrl, lightenColor, mergeProps, mergeRefs, parseColor, useCollator, useDateFormatter, useDevice, useDragAndDrop, useFilter, useFocusRing, useFocusVisible, useFrameDimensions, useI18n, useId, useImage, useInteractionModality, useIntersectionObserver, useIsFirstRender, useKeyboard, useListData, useLiveInteractionModality, useLocalStorage, useLocale, useMutationObserver, useNumberFormatter, useObjectRef, usePointProximity, usePortalContainer, usePreventFocus, useResizeObserver, useTextSelection, useUndoRedo, useUserPreferences };

package/dist/index.d.ts

@@ -3070,6 +3070,12 @@ interface AriaMenuTriggerProps {
     trigger?: MenuTriggerType;
 }
 
+/**
+ * Controls which axes the boundary element constrains when calculating overlay
+ * position.
+ */
+type BoundaryAxis = 'horizontal' | 'vertical' | 'both';
+
 interface AriaPositionProps extends PositionProps {
     /**
      * Cross size of the overlay arrow in pixels.
@@ -3077,10 +3083,23 @@ interface AriaPositionProps extends PositionProps {
      */
     arrowSize?: number;
     /**
-     * Element that that serves as the positioning boundary.
+     * Element that serves as the positioning boundary. The overlay is shifted or
+     * flipped to stay within this element's bounds on the axes selected by
+     * `boundaryAxis`. Pass `null` to disable all boundary constraints.
      * @default document.body
      */
-    boundaryElement?: Element;
+    boundaryElement?: Element | null;
+    /**
+     * Controls which axes `boundaryElement` constrains.
+     *
+     * - `"both"` — constrains horizontal and vertical (default)
+     * - `"horizontal"` — constrains only horizontal overflow
+     * - `"vertical"` — constrains only vertical overflow
+     *
+     * Has no effect when `boundaryElement` is `null`.
+     * @default "both"
+     */
+    boundaryAxis?: BoundaryAxis;
     /**
      * The ref for the element which the overlay positions itself with respect to.
      */
@@ -5448,7 +5467,7 @@ type ClassName$1 = string | ((state: {
 type Style = React__default.CSSProperties | ((state: {
     isOpen: boolean;
 }) => React__default.CSSProperties | undefined);
-interface PopoverContentProps extends Omit<AriaPopoverProps, "popoverRef" | "triggerRef" | "arrowSize" | "arrowBoundaryOffset" | "shouldCloseOnScroll">, Pick<OverlayProps, "shouldContainFocus" | "disableFocusManagement">, Pick<ModalContentProps, "disableAnimation">, BlockProps {
+interface PopoverContentProps extends Omit<AriaPopoverProps, "popoverRef" | "triggerRef" | "arrowSize" | "arrowBoundaryOffset" | "shouldCloseOnScroll" | "boundaryElement">, Pick<OverlayProps, "shouldContainFocus" | "disableFocusManagement">, Pick<ModalContentProps, "disableAnimation">, BlockProps {
     /** The class name for the popover element. */
     className?: ClassName$1;
     /** The style for the popover element. */
@@ -5505,6 +5524,29 @@ interface PopoverContentProps extends Omit<AriaPopoverProps, "popoverRef" | "tri
      * trigger popover position recalculation.
      */
     elementHandle?: React__default.Ref<PopoverContentHandle>;
+    /**
+     * The element used as the boundary when calculating popover position. The
+     * popover is shifted or flipped to stay within this element's bounds on the
+     * axes specified by `boundaryAxis`.
+     *
+     * Pass `null` to disable all boundary constraints.
+     *
+     * @default document.body
+     */
+    boundaryElement?: Element | null;
+    /**
+     * Controls which axes the `boundaryElement` constrains. Has no effect when
+     * `boundaryElement` is `null`.
+     *
+     * - `"both"` — constrains horizontal and vertical (default)
+     * - `"horizontal"` — constrains only horizontal overflow; popover may overflow
+     *   vertically
+     * - `"vertical"` — constrains only vertical overflow; popover may overflow
+     *   horizontally
+     *
+     * @default "both"
+     */
+    boundaryAxis?: BoundaryAxis;
 }
 interface PopoverTriggerProps {
     /** The contents of the popover trigger. */
@@ -5533,7 +5575,7 @@ type MenuSection = Omit<ListSection, "children"> & {
     children: MenuOption[];
 };
 type MenuItem = MenuOption | MenuSection;
-type MenuPopoverProps = Pick<PopoverContentProps, "isNonModal" | "placement" | "shouldUpdatePosition" | "shouldFlip" | "boundaryElement" | "crossOffset" | "offset" | "portalContainer">;
+type MenuPopoverProps = Pick<PopoverContentProps, "isNonModal" | "placement" | "shouldUpdatePosition" | "shouldFlip" | "boundaryElement" | "boundaryAxis" | "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;
@@ -6994,6 +7036,13 @@ interface ImageDropZoneProps extends Omit<SharedFileUploadProps, "label" | "vari
     labelClassName?: string;
     /** The style to apply to the label. */
     labelStyle?: React__default.CSSProperties;
+    /**
+     * Maximum allowed file size in bytes. Files exceeding this limit will be
+     * rejected.
+     */
+    maxFileSize?: number;
+    /** Callback fired when a dropped/pasted/selected file exceeds `maxFileSize`. */
+    onFileSizeError?: (file: File) => void;
 }
 
 declare const ImageDropZone: React__default.ForwardRefExoticComponent<ImageDropZoneProps & React__default.RefAttributes<HTMLDivElement>>;
@@ -8083,6 +8132,12 @@ declare const TreeView: React__default.ForwardRefExoticComponent<TreeViewProps &
 interface PanelProps extends StylingProps {
     /** Content */
     children: ReactNode;
+    /**
+     * Unique identifier for the panel. Required for localStorage persistence when
+     * using `PanelGroup` with `autoSaveId`. Must remain stable across page
+     * loads.
+     */
+    id?: PanelProps$1["id"];
     /**
      * Panel collapses to this size
      *
@@ -8126,7 +8181,8 @@ interface PanelGroupProps extends StylingProps {
     onLayout?: PanelGroupProps$1["onLayout"];
     /**
      * When passed, automatically persists layouts, should be unique amongst other
-     * `PanelGroup`
+     * `PanelGroup`. Each `Panel` should have a stable `id` prop for persistence
+     * to work correctly.
      */
     autoSaveId?: PanelGroupProps$1["autoSaveId"];
 }
@@ -8715,11 +8771,12 @@ declare function useIsFirstRender(): boolean;
 
 /**
  * A hook that provides internationalization functionality. It returns a
- * function to format messages and the current locale. The hook can be used with
- * or without a messages object. If no messages object is provided, the hook
- * will use the messages provided by the `I18nProvider`. If a messages object is
- * provided, the hook will use those messages instead of the ones provided by
- * the `I18nProvider`.
+ * function to format messages and the current locale.
+ *
+ * When both a local `messages` object and provider messages (from
+ * `I18nProvider`) are present, they are merged per locale: provider messages
+ * win on key conflicts, while unmatched local keys are preserved. When only one
+ * source is present the behavior is unchanged (backwards compatible).
  *
  * @example
  *   ```tsx
@@ -8742,8 +8799,11 @@ declare function useIsFirstRender(): boolean;
  *   ```;
  *
  * @template T - A type that represents the shape of the translation messages.
- * @param {Object<string, T>} [messages] - An optional object containing
- *   translation messages for different languages.
+ * @param messages - An optional object containing translation messages for
+ *   different locales. When provider messages (from `I18nProvider`) are also
+ *   present, local and provider messages are merged per locale — provider
+ *   values take precedence on key conflicts. If omitted, the hook reads
+ *   entirely from the provider.
  * @returns {I18nResult<T>} An object containing a function to format messages
  *   and the current locale.
  */
@@ -8946,4 +9006,4 @@ declare namespace reactStately {
   export { type reactStately_Color as Color, type reactStately_ListData as ListData, type reactStately_TreeData as TreeData, reactStately_useListData as useListData, reactStately_useTreeData as useTreeData };
 }
 
-export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, ActionButton, type ActionButtonProps, ActionGroup, ActionGroupItem, type ActionGroupProps, ActionIconButton, type ActionIconButtonProps, Actionable, type ActionableProps, AlertDialog, type AlertDialogProps, AudioPlayer, type AudioPlayerProps, Autocomplete, type AutocompleteProps, Avatar, type AvatarProps, type BlockProps, Box, type BoxProps, ButtonSelect, type ButtonSelectProps, Checkbox, type CheckboxProps, Code, type CodeProps, ColorInput, type ColorInputProps, type ColorPreset, ColorSwatch, ColorSwatchPicker, type ColorSwatchPickerProps, type ColorSwatchProps, ComboBox, type ComboBoxProps, DateField, type DateFieldProps, DateFormat, type DateFormatProps, DefaultListOption, type Device, DeviceProvider, DeviceProviderContext, type DeviceProviderProps, Dialog, type DialogProps, DialogTitle, type DialogTitleProps, Disclosure, type DisclosureProps, DomNodeRenderer, type DomNodeRendererProps, Drawer, type DrawerProps, Editor, type EditorHandle, type EditorProps, FileUpload, type FileUploadProps, FocusScope, Focusable, type FocusableProps, FrameProvider, type FrameProviderProps, FreehandCanvas, type FreehandCanvasProps, GlobalToastRegion, GridLayout, GridList, type GridListProps, Group, type GroupProps, I18nProvider, type I18nProviderProps, type I18nResult, Icon, IconColorInput, IconColorInputButton, type IconColorInputProps, type IconComponentProps$1 as IconComponentProps, type IconProps, IconSelect, type IconSelectProps, IconSlider, type IconSliderProps, ImageDropZone, type ImageDropZoneProps, ImageGallery, type ImageGalleryProps, type ImperativePanelGroupHandle, type ImperativePanelHandle, InlineAlert, type InlineAlertProps, Kbd, type KbdProps, type Key, Link, type LinkProps, ListBox, type ListBoxProps, type ListHandle$1 as ListHandle, ListLayout, type ListOption, Markdown, type MarkdownProps, Menu, type MenuItem, type MenuProps, type MessageDescriptor, MessageFormat, type MessageFormatProps, type MessageFormatter, Modal, ModalClose, ModalContent, type ModalContentProps, type ModalProps, ModalTrigger, NumberFormat, type NumberFormatProps, NumberInput, type NumberInputProps, Pagination, type PaginationProps, Panel, PanelGroup, type PanelGroupProps, type PanelProps, PanelResizeHandle, type PanelResizeHandleProps, PointPicker, PointPickerContent, type PointPickerContentProps, PointPickerDisplay, type PointPickerDisplayProps, type PointPickerProps, Popover, PopoverContent, type PopoverContentHandle, type PopoverContentProps, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, Portal, PortalContainerProvider, type PortalProps, type PressEvent, Pressable, Preview, type PreviewProps, ProgressBar, type ProgressBarProps, ProgressSpinner, type ProgressSpinnerProps, RadioGroup, type RadioGroupProps, Reaction, type ReactionProps, type Rect, type SVGRProps, ScrollControlButton, type ScrollControlButtonProps, SearchInput, type SearchInputProps, Select, type SelectProps, Separator, type SeparatorProps, Size, Slider, type SliderProps, StatusCard, type StatusCardProps, type StylingProps, Switch, type SwitchProps, TabItem, type TabItemProps, TableLayout, Tabs, type TabsProps, TagGroup, type TagGroupProps, TaggedPagination, type TaggedPaginationProps, Text, TextInput, type TextInputProps, type TextProps, ThemeProvider, type ThemeProviderProps, TimeField, type TimeFieldProps, type ToastProps, ToastQueue, ToggleButton, type ToggleButtonProps, ToggleIconButton, type ToggleIconButtonProps, Toolbar, type ToolbarProps, Tooltip, type TooltipProps, type TreeListItem, TreeView, type TreeViewProps, UNSAFE_ListBox, type UNSAFE_ListBoxProps, reactAria as UNSAFE_aria, reactStately as UNSAFE_stately, VIRTUALIZER_LAYOUT_DEFAULT_OPTIONS, Virtualizer, type VirtualizerProps, VisuallyHidden, WaterfallLayout, announce, booleanOrObjectToConfig, calculateFontSizeToFitWidth, classNames, cleanKeyFromGlobImport, clearAnnouncer, defineMessages, destroyAnnouncer, directionVar, disableAnimations, enableAnimations, filterDOMProps, filterTruthyValues, findFocusableElements, getAbsoluteBounds, getAbsolutePosition, getActiveElement, getHTMLElement, getOsSpecificKeyboardShortcutLabel, getOwnerDocument, getPlainText, getSvgPathFromStroke, getTextDimensions, iconMap, invariant, isFocusableElement, isInIframe, isInShadowDOM, isInputThatOpensKeyboard, isInsideOverlayContent, isRect, isUrl, lightenColor, mergeProps, mergeRefs, parseColor, useCollator, useDateFormatter, useDevice, useDragAndDrop, useFilter, useFocusRing, useFocusVisible, useFrameDimensions, useI18n, useId, useImage, useInteractionModality, useIntersectionObserver, useIsFirstRender, useKeyboard, useListData, useLiveInteractionModality, useLocalStorage, useLocale, useMutationObserver, useNumberFormatter, useObjectRef, usePointProximity, usePortalContainer, usePreventFocus, useResizeObserver, useTextSelection, useUndoRedo, useUserPreferences };
+export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, ActionButton, type ActionButtonProps, ActionGroup, ActionGroupItem, type ActionGroupProps, ActionIconButton, type ActionIconButtonProps, Actionable, type ActionableProps, AlertDialog, type AlertDialogProps, AudioPlayer, type AudioPlayerProps, Autocomplete, type AutocompleteProps, Avatar, type AvatarProps, type BlockProps, type BoundaryAxis, Box, type BoxProps, ButtonSelect, type ButtonSelectProps, Checkbox, type CheckboxProps, Code, type CodeProps, ColorInput, type ColorInputProps, type ColorPreset, ColorSwatch, ColorSwatchPicker, type ColorSwatchPickerProps, type ColorSwatchProps, ComboBox, type ComboBoxProps, DateField, type DateFieldProps, DateFormat, type DateFormatProps, DefaultListOption, type Device, DeviceProvider, DeviceProviderContext, type DeviceProviderProps, Dialog, type DialogProps, DialogTitle, type DialogTitleProps, Disclosure, type DisclosureProps, DomNodeRenderer, type DomNodeRendererProps, Drawer, type DrawerProps, Editor, type EditorHandle, type EditorProps, FileUpload, type FileUploadProps, FocusScope, Focusable, type FocusableProps, FrameProvider, type FrameProviderProps, FreehandCanvas, type FreehandCanvasProps, GlobalToastRegion, GridLayout, GridList, type GridListProps, Group, type GroupProps, I18nProvider, type I18nProviderProps, type I18nResult, Icon, IconColorInput, IconColorInputButton, type IconColorInputProps, type IconComponentProps$1 as IconComponentProps, type IconProps, IconSelect, type IconSelectProps, IconSlider, type IconSliderProps, ImageDropZone, type ImageDropZoneProps, ImageGallery, type ImageGalleryProps, type ImperativePanelGroupHandle, type ImperativePanelHandle, InlineAlert, type InlineAlertProps, Kbd, type KbdProps, type Key, Link, type LinkProps, ListBox, type ListBoxProps, type ListHandle$1 as ListHandle, ListLayout, type ListOption, Markdown, type MarkdownProps, Menu, type MenuItem, type MenuProps, type MessageDescriptor, MessageFormat, type MessageFormatProps, type MessageFormatter, Modal, ModalClose, ModalContent, type ModalContentProps, type ModalProps, ModalTrigger, NumberFormat, type NumberFormatProps, NumberInput, type NumberInputProps, Pagination, type PaginationProps, Panel, PanelGroup, type PanelGroupProps, type PanelProps, PanelResizeHandle, type PanelResizeHandleProps, PointPicker, PointPickerContent, type PointPickerContentProps, PointPickerDisplay, type PointPickerDisplayProps, type PointPickerProps, Popover, PopoverContent, type PopoverContentHandle, type PopoverContentProps, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, Portal, PortalContainerProvider, type PortalProps, type PressEvent, Pressable, Preview, type PreviewProps, ProgressBar, type ProgressBarProps, ProgressSpinner, type ProgressSpinnerProps, RadioGroup, type RadioGroupProps, Reaction, type ReactionProps, type Rect, type SVGRProps, ScrollControlButton, type ScrollControlButtonProps, SearchInput, type SearchInputProps, Select, type SelectProps, Separator, type SeparatorProps, Size, Slider, type SliderProps, StatusCard, type StatusCardProps, type StylingProps, Switch, type SwitchProps, TabItem, type TabItemProps, TableLayout, Tabs, type TabsProps, TagGroup, type TagGroupProps, TaggedPagination, type TaggedPaginationProps, Text, TextInput, type TextInputProps, type TextProps, ThemeProvider, type ThemeProviderProps, TimeField, type TimeFieldProps, type ToastProps, ToastQueue, ToggleButton, type ToggleButtonProps, ToggleIconButton, type ToggleIconButtonProps, Toolbar, type ToolbarProps, Tooltip, type TooltipProps, type TreeListItem, TreeView, type TreeViewProps, UNSAFE_ListBox, type UNSAFE_ListBoxProps, reactAria as UNSAFE_aria, reactStately as UNSAFE_stately, VIRTUALIZER_LAYOUT_DEFAULT_OPTIONS, Virtualizer, type VirtualizerProps, VisuallyHidden, WaterfallLayout, announce, booleanOrObjectToConfig, calculateFontSizeToFitWidth, classNames, cleanKeyFromGlobImport, clearAnnouncer, defineMessages, destroyAnnouncer, directionVar, disableAnimations, enableAnimations, filterDOMProps, filterTruthyValues, findFocusableElements, getAbsoluteBounds, getAbsolutePosition, getActiveElement, getHTMLElement, getOsSpecificKeyboardShortcutLabel, getOwnerDocument, getPlainText, getSvgPathFromStroke, getTextDimensions, iconMap, invariant, isFocusableElement, isInIframe, isInShadowDOM, isInputThatOpensKeyboard, isInsideOverlayContent, isRect, isUrl, lightenColor, mergeProps, mergeRefs, parseColor, useCollator, useDateFormatter, useDevice, useDragAndDrop, useFilter, useFocusRing, useFocusVisible, useFrameDimensions, useI18n, useId, useImage, useInteractionModality, useIntersectionObserver, useIsFirstRender, useKeyboard, useListData, useLiveInteractionModality, useLocalStorage, useLocale, useMutationObserver, useNumberFormatter, useObjectRef, usePointProximity, usePortalContainer, usePreventFocus, useResizeObserver, useTextSelection, useUndoRedo, useUserPreferences };