@cube-dev/ui-kit 0.69.1 → 0.69.3

package/types/components/fields/ListBox/ListBox.d.ts

@@ -4,64 +4,72 @@ import { Section as BaseSection, Item } from 'react-stately';
 import { BasePropsWithoutChildren, Styles } from '../../../tasty';
 import type { CollectionBase, Key } from '@react-types/shared';
 import type { FieldBaseProps } from '../../../shared';
-export interface CubeListBoxProps<T> extends Omit<AriaListBoxProps<T>, 'onSelectionChange'>, CollectionBase<T>, FieldBaseProps, BasePropsWithoutChildren {
+export interface CubeListBoxProps<T> extends AriaListBoxProps<T>, CollectionBase<T>, FieldBaseProps, BasePropsWithoutChildren {
     /** Custom styles for the list container */
     listStyles?: Styles;
-    /** Custom styles for options */
+    /** Custom styles for individual options */
     optionStyles?: Styles;
-    /** Custom styles for sections */
+    /** Custom styles for section containers */
     sectionStyles?: Styles;
     /** Custom styles for section headings */
     headingStyles?: Styles;
     /** Whether the ListBox is disabled */
     isDisabled?: boolean;
-    /** The selected key(s) */
+    /** The selected key in controlled single selection mode */
     selectedKey?: Key | null;
-    selectedKeys?: Key[];
-    /** Default selected key(s) */
+    /** The selected keys in controlled multiple selection mode. Use "all" to select all items or an array of keys */
+    selectedKeys?: 'all' | Key[];
+    /** The default selected key in uncontrolled single selection mode */
     defaultSelectedKey?: Key | null;
-    defaultSelectedKeys?: Key[];
-    /** Selection change handler */
-    onSelectionChange?: (key: Key | null | Key[]) => void;
-    /** Ref for the list */
+    /** The default selected keys in uncontrolled multiple selection mode. Use "all" to select all items or an array of keys */
+    defaultSelectedKeys?: 'all' | Key[];
+    /** Callback fired when selection changes */
+    onSelectionChange?: (key: Key | null | 'all' | Key[]) => void;
+    /** The selection mode of the ListBox */
+    selectionMode?: 'single' | 'multiple';
+    /** Ref for accessing the list DOM element */
     listRef?: RefObject<HTMLDivElement>;
+    /** Whether to disallow empty selection */
+    disallowEmptySelection?: boolean;
+    /** Whether to wrap focus when reaching the end of the list */
+    shouldFocusWrap?: boolean;
     /**
      * Ref to access the internal ListState instance.
      * This allows parent components to access selection state and other list functionality.
      */
     stateRef?: MutableRefObject<any | null>;
     /**
-     * When true (default) moving the pointer over an option will move DOM focus to that option.
+     * Whether moving the pointer over an option will move DOM focus to that option.
      * Set to false for components that keep DOM focus outside (e.g. searchable FilterListBox).
+     * Defaults to true.
      */
     focusOnHover?: boolean;
-    /** Custom header content */
+    /** Custom header content displayed above the list */
     header?: ReactNode;
-    /** Custom footer content */
+    /** Custom footer content displayed below the list */
     footer?: ReactNode;
     /** Custom styles for the header */
     headerStyles?: Styles;
     /** Custom styles for the footer */
     footerStyles?: Styles;
-    /** Mods for the ListBox */
+    /** Additional modifiers for styling the ListBox */
     mods?: Record<string, boolean>;
-    /** Size of the ListBox */
+    /** Size variant of the ListBox */
     size?: 'medium' | 'large';
     /**
-     * When true, ListBox will use virtual focus. This keeps actual DOM focus
-     * outside of the individual option elements (e.g. for searchable lists
-     * where focus stays within an external input).
+     * Whether to use virtual focus for keyboard navigation.
+     * When true, DOM focus stays outside individual option elements (useful for searchable lists).
      * Defaults to false for backward compatibility.
      */
     shouldUseVirtualFocus?: boolean;
     /**
-     * Optional callback fired when the user presses Escape key.
+     * Callback fired when the user presses Escape key.
      * When provided, this prevents React Aria's default Escape behavior (selection reset).
      */
     onEscape?: () => void;
     /**
-     * Whether the options in the ListBox are checkable.
-     * This adds a checkbox icon to the left of the option.
+     * Whether to show checkboxes for multiple selection mode.
+     * This adds a checkbox icon to the left of each option.
      */
     isCheckable?: boolean;
     /**
@@ -69,6 +77,15 @@ export interface CubeListBoxProps<T> extends Omit<AriaListBoxProps<T>, 'onSelect
      * Used by FilterPicker to close the popover on non-checkbox clicks.
      */
     onOptionClick?: (key: Key) => void;
+    /**
+     * Whether to show the "Select All" option in multiple selection mode.
+     * This adds a select all option to the header that allows selecting/deselecting all items.
+     */
+    showSelectAll?: boolean;
+    /**
+     * Label for the "Select All" option. Defaults to "Select All".
+     */
+    selectAllLabel?: ReactNode;
 }
 export declare const ListBox: (<T>(props: CubeListBoxProps<T> & {
     ref?: ForwardedRef<HTMLDivElement>;

package/types/components/overlays/Dialog/DialogTrigger.d.ts

@@ -38,6 +38,7 @@ export interface CubeDialogTriggerProps extends OverlayTriggerProps, PositionPro
     onOpenChange?: (isOpen: boolean) => void;
     defaultOpen?: boolean;
     shouldFlip?: boolean;
+    shouldUpdatePosition?: boolean;
 }
 /**
  * DialogTrigger serves as a wrapper around a Dialog and its associated trigger, linking the Dialog's