@zvoove/unity-ui 2.48.0 → 2.49.0

package/dist/unity-ui.d.ts

@@ -2853,7 +2853,7 @@ declare type Panel = {
     children: React.ReactNode;
 };
 
-export declare const PopUpMenu: ({ children, placement, disabled, trigger, density, closeOnItemClick, items, onItemClick, selectedItem, selectable, open, onClose, closeOnClickOutside, closeOnEscape, toggleOnClick, queryHighlight, showSearch, searchPlaceholder, allowClearAll, allowSelectAll, selectAllLabel, clearAllLabel, noResultsFoundMessage, onClearAllOrSelectAllClick, searchMode, onSearchChange, isLoading, wrapperWidth, onScrollEnd, isLoadingMore, height, minHeight, maxHeight, autoFocusFirstItem, ...props }: PopUpMenuProps) => JSX.Element;
+export declare const PopUpMenu: ({ children, placement, disabled, trigger, density, closeOnItemClick, items, onItemClick, selectedItem, selectable, open, onClose, closeOnClickOutside, closeOnEscape, toggleOnClick, queryHighlight, showSearch, searchPlaceholder, allowClearAll, allowSelectAll, selectAllLabel, clearAllLabel, noResultsFoundMessage, onClearAllOrSelectAllClick, searchMode, onSearchChange, isLoading, wrapperWidth, onScrollEnd, isLoadingMore, height, minHeight, maxHeight, autoFocusFirstItem, allowDeselect, ...props }: PopUpMenuProps) => JSX.Element;
 
 export declare type PopUpMenuItem<T extends React.ElementType = 'button'> = UnionAs_3 & {
     /**
@@ -2977,6 +2977,12 @@ export declare interface PopUpMenuProps extends Omit<React.HTMLAttributes<HTMLDi
      * @default none
      */
     selectable?: 'single' | 'multiple' | 'none';
+    /**
+     * Whether clicking an already-selected item deselects it.
+     * Only applies when `selectable` is `'single'`.
+     * @default true
+     */
+    allowDeselect?: boolean;
     /**
      * Whether the context menu should be disabled
      * @default false
@@ -3475,7 +3481,7 @@ export declare interface SegmentGroupProps<T extends React.ElementType = 'button
 
 export declare type SegmentValue<T = string> = T | T[];
 
-export declare const Select: ({ value, multiple, options, onChange, error, errorMessage, disabled, label, hideLabel, name, id, searchable, allowClearAll, allowSelectAll, selectAllLabel, clearAllLabel, noResultsFoundMessage, onScrollEnd, isLoadingMore, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, density, ...props }: SelectProps) => JSX.Element;
+export declare const Select: ({ value, multiple, options, onChange, error, errorMessage, disabled, label, hideLabel, placeholder, required, name, id, searchable, allowClearAll, allowSelectAll, selectAllLabel, clearAllLabel, noResultsFoundMessage, onScrollEnd, isLoadingMore, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, density, ...props }: SelectProps) => JSX.Element;
 
 export declare type SelectOption = Omit<PopUpMenuItem, 'id' | 'onClick' | 'disabled' | 'linkComponent' | 'as'> & {
     /**
@@ -3518,6 +3524,17 @@ export declare type SelectProps = Union & {
      * Whether to hide the label.
      */
     hideLabel?: boolean;
+    /**
+     * Placeholder text shown when no option is selected.
+     * Useful with `hideLabel` to provide a prompt like "Select an option".
+     */
+    placeholder?: string;
+    /**
+     * Whether a selection is required. When `true`, the user cannot deselect
+     * an already-selected option in single-select mode.
+     * @default false
+     */
+    required?: boolean;
     /**
      * The name of the select.
      */
@@ -3822,6 +3839,25 @@ export declare interface SkeletonProps extends React.HTMLAttributes<HTMLDivEleme
  */
 export declare const Snackbar: default_2.FC<SnackbarProps>;
 
+export declare interface SnackbarAction {
+    /**
+     * The label shown in the action button.
+     */
+    label: string;
+    /**
+     * Callback fired when the action button is clicked. Receives the snackbar
+     * ID so you can programmatically dismiss or reference it.
+     */
+    onClick?: (id: string) => void;
+    /**
+     * The Button visual variant.
+     * @default 'text' for all actions except the last, which defaults to 'filled'
+     */
+    variant?: SnackbarActionVariant;
+}
+
+export declare type SnackbarActionVariant = NonNullable<ButtonProps['variant']>;
+
 export declare interface SnackbarItem {
     /**
      * Unique identifier for the snackbar
@@ -3851,12 +3887,22 @@ export declare interface SnackbarItem {
      * Icon to display in the snackbar
      */
     icon?: CommonIconNames | Omit<IconProps, 'size' | 'color'>;
+    /**
+     * Whether the icon is hidden.
+     */
+    hideIcon: boolean;
+    /**
+     * Action buttons displayed in the snackbar.
+     */
+    actions?: SnackbarAction[];
     /**
      * Label for the action button
+     * @deprecated Use `actions` instead for flexible button styling.
      */
     actionLabel?: string;
     /**
      * Action to perform when the action button is clicked
+     * @deprecated Use `actions` instead for flexible button styling.
      */
     onAction?: (id: string) => void;
     /**
@@ -3891,12 +3937,26 @@ export declare interface SnackbarOptions {
      * Icon to display in the Snackbar
      */
     icon?: CommonIconNames | Omit<IconProps, 'size' | 'color'>;
+    /**
+     * Hide the icon entirely. Useful for compact snackbars like selection bars
+     * where only a message and action buttons are needed.
+     * @default false
+     */
+    hideIcon?: boolean;
+    /**
+     * Action buttons displayed in the snackbar. Each action renders as a real
+     * `<Button>` component with automatic variant defaults per snackbar variant.
+     * Takes priority over `actionLabel`/`onAction` when both are provided.
+     */
+    actions?: SnackbarAction[];
     /**
      * Label for the action button
+     * @deprecated Use `actions` instead for flexible button styling.
      */
     actionLabel?: string;
     /**
      * Action to perform when the action button is clicked
+     * @deprecated Use `actions` instead for flexible button styling.
      */
     onAction?: (id: string) => void;
     /**
@@ -4092,6 +4152,8 @@ export declare type SubMenuLayer = {
 
 export declare const Switch: default_2.ForwardRefExoticComponent<SwitchProps & default_2.RefAttributes<HTMLInputElement>>;
 
+declare type SwitchLabelPlacement = 'left' | 'right';
+
 export declare interface SwitchProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange'> {
     /**
      * Whether the switch is checked.
@@ -4115,13 +4177,16 @@ export declare interface SwitchProps extends Omit<React.InputHTMLAttributes<HTML
     label?: string | LabelStates;
     /**
      * The placement of the label.
+     * Accepts a single value or a breakpoint object.
      * @default 'left'
      */
-    labelPlacement?: 'left' | 'right';
+    labelPlacement?: ResponsiveType<SwitchLabelPlacement>;
     /**
      * How the switch and label are aligned horizontally.
+     * Accepts a single value or a breakpoint object.
+     * @default 'flex-start'
      */
-    justify?: JustifyContent;
+    justify?: ResponsiveType<JustifyContent>;
     /**
      * The value of the switch.
      */
@@ -4166,16 +4231,20 @@ export declare interface TableColumnProps extends React.HTMLAttributes<HTMLTable
     id: string;
     /**
      * The alignment of the Table column.
+     * Accepts a single value or a breakpoint object.
+     * @default 'left'
      */
-    align?: ColumnAlign;
+    align?: ResponsiveType<ColumnAlign>;
     /**
      * The width of the Table column.
+     * Accepts a single value or a breakpoint object.
      */
-    width?: string;
+    width?: ResponsiveType<string>;
     /**
      * The minimum width of the Table column.
+     * Accepts a single value or a breakpoint object.
      */
-    minWidth?: string;
+    minWidth?: ResponsiveType<string>;
     /**
      * If true, the column is orderable.
      */
@@ -4740,8 +4809,10 @@ export declare type TypographyProps<T extends TypographyElements = 'p'> = Omit<R
     as?: 'p' | 'span' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
     /**
      * The text alignment of the typography.
+     * Accepts a single value or a breakpoint object.
+     * @default 'left'
      */
-    textAlign?: 'left' | 'center' | 'right';
+    textAlign?: ResponsiveType<'left' | 'center' | 'right'>;
     /**
      * CSS text-transform property
      */
@@ -4752,25 +4823,30 @@ export declare type TypographyProps<T extends TypographyElements = 'p'> = Omit<R
     color?: ForegroundColors;
     /**
      * If true, the text will be hyphenated based on the `lang` attribute of the parent element.
+     * Accepts a single value or a breakpoint object.
      * @default true
      */
-    hyphenate?: boolean;
+    hyphenate?: ResponsiveType<boolean>;
     /**
      * Sets a specific amount of lines to show based on it's container.
-     * The text that doesn't fit the container will be hidden and replaced by ellipsis
+     * The text that doesn't fit the container will be hidden and replaced by ellipsis.
+     * Accepts a single value or a breakpoint object.
      */
-    truncate?: number;
+    truncate?: ResponsiveType<number>;
     /**
      * Controls whether text wraps at word boundaries or individual letters.
      * Can be used with or without `truncate`. The `letter` value applies
      * `word-break: break-all`.
+     * Accepts a single value or a breakpoint object.
      * @default 'word'
      */
-    truncatedBy?: 'word' | 'letter';
+    truncatedBy?: ResponsiveType<'word' | 'letter'>;
     /**
      * If true, the text will be wrapped.
+     * Accepts a single value or a breakpoint object.
+     * @default true
      */
-    wrap?: boolean;
+    wrap?: ResponsiveType<boolean>;
 };
 
 export declare type TypographySize = 'sm' | 'md' | 'lg';
@@ -5576,6 +5652,10 @@ export declare interface UseSnackbarReturn {
      * Show a snackbar message
      */
     snackbar: (message: SnackbarItem['children'], options?: SnackbarOptions) => SnackbarItem['id'];
+    /**
+     * Update an existing snackbar's content and/or options in-place.
+     */
+    update: (id: string, message: SnackbarItem['children'], options?: Partial<SnackbarOptions>) => void;
     /**
      * Dismiss a specific snackbar by ID
      */