@hitachivantara/uikit-react-core 5.56.0 → 5.57.0

package/dist/types/index.d.ts

@@ -1183,24 +1183,34 @@ export declare interface HvActionBarProps extends HvBaseProps {
 
 declare type HvActionContainerClasses = ExtractNames<typeof useClasses_27>;
 
-declare interface HvActionContainerProps extends HvBaseProps<HTMLButtonElement> {
-    /** onClose function. */
+declare interface HvActionContainerProps extends HvBaseProps<HTMLButtonElement>, Pick<Partial<HvActionsGenericProps>, "onAction"> {
+    /** Function called when clicking on the close button. */
     onClose?: (event: React.MouseEvent<HTMLButtonElement>) => void;
     /** Actions to display. */
-    action?: React.ReactNode | HvActionGeneric[];
-    /**  The callback function ran when an action is triggered, receiving `action` as param */
-    actionCallback?: (event: React.SyntheticEvent, id: string, action: HvActionGeneric) => void;
+    action?: HvActionsGenericProps["actions"];
+    /**
+     * The callback function called when an action is triggered, receiving `action` as parameter.
+     *
+     * @deprecated Use `onAction` instead.
+     * */
+    actionCallback?: HvActionsGenericProps["actionsCallback"];
     /** A Jss Object used to override or extend the styles applied to the component. */
     classes?: HvActionContainerClasses;
 }
 
 export declare interface HvActionGeneric {
+    /** Action id. */
     id: string;
+    /** Action label. */
     label: string;
-    icon?: React_2.ReactNode | ((params: {
+    /** Action icon. */
+    icon?: React.ReactNode | ((params: {
         isDisabled?: boolean;
-    }) => React_2.ReactNode);
+    }) => React.ReactNode);
+    /** Whether the action is disabled or not. */
     disabled?: boolean;
+    /** When set to `true`, the button will have the icon has its content and a tooltip with the label will appear when the button is visible and hovered. */
+    iconOnly?: boolean;
 }
 
 export declare const HvActionsGeneric: (props: HvActionsGenericProps) => JSX_3.Element | null;
@@ -1208,15 +1218,29 @@ export declare const HvActionsGeneric: (props: HvActionsGenericProps) => JSX_3.E
 export declare type HvActionsGenericClasses = ExtractNames<typeof useClasses_20>;
 
 export declare interface HvActionsGenericProps extends HvBaseProps {
-    /** Button category. */
+    /**
+     * The button category for all actions.
+     *
+     * @deprecated Use `variant` instead.
+     */
     category?: HvButtonVariant;
-    /**  Whether actions should be all disabled */
+    /** The button variant for all actions. */
+    variant?: HvButtonVariant;
+    /** Whether the actions should be all disabled. */
     disabled?: boolean;
-    /** The renderable content inside the actions slot of the footer, or an Array of actions `{id, label, icon, disabled}` */
-    actions: React_2.ReactNode | HvActionGeneric[];
-    /**  The callback function ran when an action is triggered, receiving `action` as param */
-    actionsCallback?: (event: React_2.SyntheticEvent, id: string, action: HvActionGeneric) => void;
-    /**  The number of maximum visible actions before they're collapsed into a `DropDownMenu`. */
+    /** Whether the actions should be all icon buttons when visible. */
+    iconOnly?: boolean;
+    /** The renderable content inside the actions slot of the footer, or an array of actions. */
+    actions: React.ReactNode | HvActionGeneric[];
+    /**
+     * The callback function called when an action is triggered, receiving the `action` as parameter.
+     *
+     * @deprecated Use `onAction` instead.
+     * */
+    actionsCallback?: (event: React.SyntheticEvent, id: string, action: HvActionGeneric) => void;
+    /** The callback function called when an action is triggered, receiving the `action` as parameter. */
+    onAction?: (event: React.SyntheticEvent, action: HvActionGeneric) => void;
+    /** The maximum number of visible actions before they're collapsed into a dropdown menu. */
     maxVisibleActions?: number;
     /** A Jss Object used to override or extend the styles applied to the component. */
     classes?: HvActionsGenericClasses;
@@ -1462,12 +1486,18 @@ export declare interface HvBannerContentProps extends Omit<SnackbarContentProps,
     showIcon?: boolean;
     /** Custom icon to replace the variant default. */
     customIcon?: React.ReactNode;
-    /** onClose function. */
+    /** Function called when clicking on the close button. */
     onClose?: (event: React.MouseEvent<HTMLButtonElement>) => void;
     /** Actions to display on the right side. */
-    actions?: React.ReactNode | HvActionGeneric[];
-    /**  The callback function ran when an action is triggered, receiving `action` as param */
-    actionsCallback?: (event: React.SyntheticEvent, id: string, action: HvActionGeneric) => void;
+    actions?: HvActionsGenericProps["actions"];
+    /**
+     * The callback function called when an action is triggered, receiving `action` as parameter.
+     *
+     * @deprecated Use `onAction` instead.
+     * */
+    actionsCallback?: HvActionsGenericProps["actionsCallback"];
+    /** The callback function called when an action is triggered, receiving `action` as parameter. */
+    onAction?: HvActionsGenericProps["onAction"];
     /** The position property of the header. */
     actionsPosition?: HvBannerActionPosition;
     /** The props to pass down to the Action Container. */
@@ -1479,7 +1509,11 @@ export declare interface HvBannerContentProps extends Omit<SnackbarContentProps,
 export declare interface HvBannerProps extends Omit<SnackbarProps, "anchorOrigin" | "classes" | "onClose"> {
     /** If true, the snackbar is open. */
     open: boolean;
-    /** Callback fired when the component requests to be closed. Typically onClose is used to set state in the parent component, which is used to control the Snackbar open prop. The reason parameter can optionally be used to control the response to onClose, for example ignoring clickaway. */
+    /**
+     * Callback fired when the component requests to be closed.
+     * Typically onClose is used to set state in the parent component, which is used to control the Snackbar open prop.
+     * The reason parameter can optionally be used to control the response to onClose, for example ignoring click away.
+     * */
     onClose?: (event: React.MouseEvent<HTMLButtonElement>) => void;
     /** The message to display. */
     label?: string;
@@ -1492,9 +1526,15 @@ export declare interface HvBannerProps extends Omit<SnackbarProps, "anchorOrigin
     /** Controls if the associated icon to the variant should be shown. */
     showIcon?: boolean;
     /** Actions to display on the right side. */
-    actions?: React.ReactNode | HvActionGeneric[];
-    /** The callback function ran when an action is triggered, receiving `action` as param */
-    actionsCallback?: (event: React.SyntheticEvent, id: string, action: HvActionGeneric) => void;
+    actions?: HvActionsGenericProps["actions"];
+    /**
+     * The callback function called when an action is triggered, receiving `action` as parameter.
+     *
+     * @deprecated Use `onAction` instead.
+     * */
+    actionsCallback?: HvActionsGenericProps["actionsCallback"];
+    /** The callback function called when an action is triggered, receiving `action` as parameter. */
+    onAction?: HvActionsGenericProps["onAction"];
     /** The position property of the header. */
     actionsPosition?: HvBannerActionPosition;
     /** How much the transition animation last in milliseconds, if 0 no animation is played. */
@@ -1947,67 +1987,41 @@ export declare type HvBulkActionsClasses = ExtractNames<typeof useClasses_34>;
 export declare type HvBulkActionsPropGetter<D extends object> = PropGetter<D, HvTAbleBulkActionsProps>;
 
 export declare interface HvBulkActionsProps extends HvBaseProps {
-    /**
-     * Custom label for select all checkbox
-     */
+    /** Custom label for select all checkbox */
     selectAllLabel?: React.ReactNode;
-    /**
-     * Custom label for select all checkbox conjunction
-     */
+    /** Custom label for select all checkbox conjunction */
     selectAllConjunctionLabel?: string;
-    /**
-     * Custom label for select all pages button
-     */
+    /** Custom label for select all pages button */
     selectAllPagesLabel?: React.ReactNode;
-    /**
-     * Whether select all pages element should be visible
-     */
+    /** Whether select all pages element should be visible */
     showSelectAllPages?: boolean;
-    /**
-     * The total number of elements
-     */
+    /** The total number of elements */
     numTotal?: number;
-    /**
-     * The number of elements currently selected
-     */
+    /** The number of elements currently selected */
     numSelected?: number;
-    /**
-     * Function called when the "select all" Checkbox is toggled.
-     */
+    /** Function called when the "select all" Checkbox is toggled. */
     onSelectAll?: HvCheckBoxProps["onChange"];
-    /**
-     * Function called when the "select all pages" button is clicked toggled.
-     */
+    /** Function called when the "select all pages" button is clicked toggled. */
     onSelectAllPages?: HvButtonProps["onClick"];
-    /**
-     * Whether the bulk actions should use the semantic styles when there are selected elements.
-     */
+    /** Whether the bulk actions should use the semantic styles when there are selected elements. */
     semantic?: boolean;
-    /**
-     * The renderable content inside the right actions slot,
-     * or an Array of actions `{ id, label, icon, disabled, ... }`
-     */
-    actions?: React.ReactNode | HvActionGeneric[];
-    /**
-     *  Whether actions should be all disabled
-     */
+    /** The renderable content inside the right actions slot, or an array of actions `{ id, label, icon, disabled, ... }` */
+    actions?: HvActionsGenericProps["actions"];
+    /** Whether actions should be all disabled */
     actionsDisabled?: boolean;
     /**
-     *  The callback function ran when an action is triggered, receiving `action` as param
-     */
+     * The callback function called when an action is triggered, receiving `action` as parameter.
+     *
+     * @deprecated Use `onAction` instead.
+     * */
     actionsCallback?: HvActionsGenericProps["actionsCallback"];
-    /**
-     *  The number of maximum visible actions before they're collapsed into a `DropDownMenu`.
-     */
+    /** The callback function called when an action is triggered, receiving `action` as parameter. */
+    onAction?: HvActionsGenericProps["onAction"];
+    /** The number of maximum visible actions before they're collapsed into a `DropDownMenu`. */
     maxVisibleActions?: number;
-    /**
-     * Properties to be passed onto the checkbox component, the values of the object are equivalent to the
-     * HvCheckbox API.
-     */
+    /** Properties to be passed onto the checkbox component, the values of the object are equivalent to the HvCheckbox API. */
     checkboxProps?: HvCheckBoxProps;
-    /**
-     * A Jss Object used to override or extend the styles applied.
-     */
+    /** A Jss Object used to override or extend the styles applied. */
     classes?: HvBulkActionsClasses;
 }
 
@@ -5922,7 +5936,7 @@ export declare interface HvSliderProps extends HvBaseProps<HTMLDivElement, "onCh
  * One is the HvSnackbar, which wraps all the positioning, transition, auto hide, etc.
  * The other is the HvSnackbarContent, which allows a finer control and customization of the content of the Snackbar.
  */
-export declare const HvSnackbar: ({ classes: classesProp, className, id, open, onClose, label, anchorOrigin, autoHideDuration, variant, showIcon, customIcon, action, actionCallback, transitionDuration, transitionDirection, container, offset, snackbarContentProps, ...others }: HvSnackbarProps) => JSX_3.Element;
+export declare const HvSnackbar: ({ classes: classesProp, className, id, open, onClose, label, anchorOrigin, autoHideDuration, variant, showIcon, customIcon, action, actionCallback, onAction, transitionDuration, transitionDirection, container, offset, snackbarContentProps, ...others }: HvSnackbarProps) => JSX_3.Element;
 
 export declare type HvSnackbarClasses = ExtractNames<typeof useClasses_101>;
 
@@ -5941,8 +5955,14 @@ export declare interface HvSnackbarContentProps extends Omit<SnackbarContentProp
     customIcon?: React.ReactNode;
     /** Action to display. */
     action?: React.ReactNode | HvActionGeneric;
-    /** The callback function ran when an action is triggered, receiving `action` as param */
-    actionCallback?: (event: React.SyntheticEvent, id: string, action: HvActionGeneric) => void;
+    /**
+     * The callback function called when an action is triggered, receiving `action` as parameter.
+     *
+     * @deprecated Use `onAction` instead.
+     * */
+    actionCallback?: HvActionsGenericProps["actionsCallback"];
+    /** The callback function called when an action is triggered, receiving `action` as parameter. */
+    onAction?: HvActionsGenericProps["onAction"];
     /** A Jss Object used to override or extend the styles applied to the component. */
     classes?: HvSnackbarContentClasses;
 }
@@ -5950,11 +5970,17 @@ export declare interface HvSnackbarContentProps extends Omit<SnackbarContentProp
 export declare interface HvSnackbarProps extends Omit<SnackbarProps, "action" | "classes" | "children"> {
     /** If true, Snackbar is open. */
     open?: boolean;
-    /** Callback fired when the component requests to be closed. Typically onClose is used to set state in the parent component, which is used to control the Snackbar open prop. The reason parameter can optionally be used to control the response to onClose, for example ignoring clickaway. */
+    /**
+     * Callback fired when the component requests to be closed.
+     * Typically onClose is used to set state in the parent component, which is used to control the Snackbar open prop.
+     * The reason parameter can optionally be used to control the response to onClose, for example ignoring click away.
+     * */
     onClose?: ((event: Event | SyntheticEvent<any, Event>, reason: SnackbarCloseReason) => void) | undefined;
     /** The message to display. */
     label?: React.ReactNode;
-    /** The anchor of the Snackbar. vertical: "top", "bottom" | horizontal: "left","center","right. It defines where the snackbar will end his animation */
+    /**
+     * The anchor of the Snackbar. vertical: "top", "bottom" | horizontal: "left", "center", "right".
+     * It defines where the snackbar will end his animation */
     anchorOrigin?: SnackbarOrigin;
     /** The number of milliseconds to wait before automatically calling the onClose function. onClose should then set the state of the open prop to hide the Snackbar */
     autoHideDuration?: number;
@@ -5966,8 +5992,14 @@ export declare interface HvSnackbarProps extends Omit<SnackbarProps, "action" |
     showIcon?: boolean;
     /** Action to display. */
     action?: React.ReactNode | HvActionGeneric;
-    /** The callback function ran when an action is triggered, receiving `action` as param */
-    actionCallback?: (event: React.SyntheticEvent, id: string, action: HvActionGeneric) => void;
+    /**
+     * The callback function called when an action is triggered, receiving `action` as parameter.
+     *
+     * @deprecated Use `onAction` instead.
+     * */
+    actionCallback?: HvActionsGenericProps["actionsCallback"];
+    /** The callback function called when an action is triggered, receiving `action` as parameter. */
+    onAction?: HvActionsGenericProps["onAction"];
     /** Duration of transition in milliseconds. */
     transitionDuration?: number;
     /** Direction of slide transition. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hitachivantara/uikit-react-core",
-  "version": "5.56.0",
+  "version": "5.57.0",
   "private": false,
   "author": "Hitachi Vantara UI Kit Team",
   "description": "Core React components for the NEXT Design System.",
@@ -63,7 +63,7 @@
     "access": "public",
     "directory": "package"
   },
-  "gitHead": "67ac3fbb762df89f4f55c563f24f691c775fe99c",
+  "gitHead": "2ee2a5f6502b55ac9f6aafd36baf96bbb8c9d765",
   "main": "dist/cjs/index.cjs",
   "exports": {
     ".": {