@kentico/xperience-admin-components 28.4.4 → 29.0.0

package/dist/entry.d.ts

@@ -4,6 +4,7 @@
 import { ConnectDragPreview } from 'react-dnd';
 import { ConnectDragSource } from 'react-dnd';
 import { ConnectDropTarget } from 'react-dnd';
+import { CSSProperties } from 'react';
 import { DefineIconParameters } from 'froala-editor';
 import { DraggableProvidedDragHandleProps } from 'react-beautiful-dnd';
 import { DropResult } from 'react-beautiful-dnd';
@@ -333,12 +334,16 @@ declare interface BaseButtonProps extends UITestProps {
 
 declare interface BaseNotificationBarProps extends UITestProps {
     readonly type: NotificationBarType;
-    readonly children: string;
     readonly onDismiss?: () => void;
     /**
-     * Dangerously sets notification content as inner HTML.
+     * Disables the increase styling when the notification bar height is increased.
+     */
+    readonly noAutoIncrease?: boolean;
+    /**
+     * Dangerously sets notification content as inner HTML. Applies only to the text content.
      */
     readonly childrenAsHtml?: boolean;
+    readonly children: string | React.ReactNode;
 }
 
 declare interface BaseSimpleStatusProps extends UITestProps {
@@ -480,6 +485,14 @@ declare interface BaseTileProps extends BaseTileBaseProps, UITestProps {
      * Tooltip to display when tile is disabled.
      */
     readonly inactiveMessage?: string;
+    /**
+     * Function called on checkbox change, by default, the onCLick function is called.
+     */
+    readonly selectOnClick?: boolean;
+    /**
+     * Drag element for the tile.
+     */
+    readonly dragElement?: JSX.Element;
 }
 
 declare enum BaseTileType {
@@ -499,7 +512,7 @@ declare interface BaseTreeNodeProps {
     /**
      * Identifier of the node.
      */
-    readonly nodeIdentifier: string;
+    readonly nodeIdentifier: TreeNodeId;
     /**
      * Event fired when the node state is toggled.
      * @param isExpanded Indicates if node is currently expanded.
@@ -509,7 +522,7 @@ declare interface BaseTreeNodeProps {
      * Event fired when the node is clicked.
      * @param identifier ID of the clicked node.
      */
-    readonly onNodeClick?: (identifier: string) => void;
+    readonly onNodeClick?: (identifier: TreeNodeId) => void;
     /**
      * Direct children nodes of the current node.
      */
@@ -534,6 +547,20 @@ declare interface BaseTreeNodeProps {
      * Indicates if node can be toggled. Defaults to `false`.
      */
     readonly toggleDisabled?: boolean;
+    /**
+     * Indicates if expand button is hidden on zero level. Defaults to `true`.
+     */
+    readonly omitExpandButtonOnZeroLevel?: boolean;
+    /**
+     * Indicates if expand button is hidden.
+     * This differs from `isToggleable` in that this property does not leave an empty cell in its place when used.
+     * Defaults to `false`.
+     */
+    readonly omitExpandButton?: boolean;
+    /**
+     * Indicates if padding should be omitted on zero level. Defaults to `true`.
+     */
+    readonly omitPaddingOnZeroLevel?: boolean;
     /**
      * Function to render trailing sticky part of the node. Ensures only proper position of rendered components.
      * @param nodeRef Reference to the node HTML element.
@@ -1087,6 +1114,10 @@ declare interface ContentItemTileExtendedProps {
      * Tile icon in preview.
      */
     readonly previewIcon?: IconName;
+    /**
+     * Drag element for the tile.
+     */
+    readonly dragElement?: JSX.Element;
 }
 
 /**
@@ -1097,10 +1128,10 @@ export declare const ContentItemTilePreview: React_2.ForwardRefExoticComponent<C
 /**
  * Selected props from ContentItemTileProps for Preview tile.
  */
-declare interface ContentItemTilePreviewProps extends ContentItemTileExtendedProps, BaseTileBaseProps, Pick<ContentItemTileProps, 'onClick' | 'isSelected' | 'onChange' | 'isCheckboxVisible' | 'actions' | 'dataTestId'> {
+export declare interface ContentItemTilePreviewProps extends ContentItemTileExtendedProps, BaseTileBaseProps, Pick<ContentItemTileProps, 'onClick' | 'isSelected' | 'onChange' | 'isCheckboxVisible' | 'selectOnClick' | 'actions' | 'dataTestId' | 'inactiveMessage' | 'isDragging' | 'dragElement'> {
 }
 
-declare interface ContentItemTileProps extends ContentItemTileExtendedProps, Pick<BaseTileProps, 'errorState' | 'url' | 'uploadState' | 'name' | 'disabled' | 'isCheckboxVisible' | 'isSelected' | 'isDragging' | 'onChange' | 'onClick' | 'dataTestId' | 'actions' | 'inactiveMessage'> {
+declare interface ContentItemTileProps extends ContentItemTileExtendedProps, Pick<BaseTileProps, 'errorState' | 'url' | 'uploadState' | 'name' | 'disabled' | 'isCheckboxVisible' | 'selectOnClick' | 'isSelected' | 'isDragging' | 'onChange' | 'onClick' | 'dataTestId' | 'actions' | 'inactiveMessage'> {
     /**
      * Type of content item.
      */
@@ -1115,7 +1146,7 @@ export declare const ContentItemTileSelectable: React_2.ForwardRefExoticComponen
 /**
  * Selected props from ContentItemTileProps for Selectable tile.
  */
-declare interface ContentItemTileSelectableProps extends ContentItemTileExtendedProps, BaseTileBaseProps, Pick<ContentItemTileProps, 'onClick' | 'isSelected' | 'onChange' | 'isDragging' | 'dataTestId' | 'inactiveMessage'> {
+declare interface ContentItemTileSelectableProps extends ContentItemTileExtendedProps, BaseTileBaseProps, Pick<ContentItemTileProps, 'onClick' | 'isSelected' | 'onChange' | 'isDragging' | 'dataTestId' | 'inactiveMessage' | 'actions'> {
 }
 
 /**
@@ -1345,7 +1376,7 @@ declare interface DraggableTreeNodeProps extends BaseTreeNodeProps {
      * @param targetNodeIdentifier Identifier of the node where the dragged node was dropped.
      * @param dropOffset Indicates if the dragged node should be placed above or below.
      */
-    readonly dropHandler: (draggedNodeIdentifier: string, targetNodeIdentifier: string, dropOffset: DropPlacement) => void;
+    readonly dropHandler: (draggedNodeIdentifier: TreeNodeId, targetNodeIdentifier: TreeNodeId, dropOffset: DropPlacement) => void;
     /**
      * Function to render main part of the node. Components rendered with this function are wrapped by element ensuring proper background color when node is selected, hovered or disabled.
      * @param isNodeSelected Indicates if node is currently selected.
@@ -1619,6 +1650,8 @@ export declare interface GridProps extends LayoutComponentProps, UITestProps {
     readonly columnGap?: Spacing;
 }
 
+export declare type HandleDirection = 'left' | 'right' | 'top' | 'bottom';
+
 export declare interface HeaderCloseButton extends Pick<TooltipProps, 'tooltipText' | 'shortcuts'> {
 }
 
@@ -2438,7 +2471,7 @@ export declare interface MultiselectTreeViewProps extends BaseTreeViewProps {
     /**
      * Identifiers of the selected nodes.
      */
-    readonly selectedIdentifiers?: string[];
+    readonly selectedIdentifiers?: TreeNodeId[];
 }
 
 declare interface NameButtonProps extends Pick<ToggleButtonBaseProps, 'onClick' | 'ariaLabel' | 'isSelected'> {
@@ -2469,13 +2502,13 @@ declare type NativeInputProps = Pick<React.InputHTMLAttributes<HTMLInputElement>
 
 export declare const NotificationBarAlert: ForwardRefExoticComponent<NotificationBarAlertProps & RefAttributes<HTMLDivElement>>;
 
-export declare interface NotificationBarAlertProps extends Pick<BaseNotificationBarProps, 'children' | 'childrenAsHtml' | 'dataTestId'> {
+export declare interface NotificationBarAlertProps extends Pick<BaseNotificationBarProps, 'noAutoIncrease' | 'children' | 'childrenAsHtml' | 'dataTestId'> {
     readonly onDismiss: () => void;
 }
 
 export declare const NotificationBarInfo: ForwardRefExoticComponent<NotificationBarInfoProps & RefAttributes<HTMLDivElement>>;
 
-export declare interface NotificationBarInfoProps extends Pick<BaseNotificationBarProps, 'children' | 'childrenAsHtml' | 'dataTestId'> {
+export declare interface NotificationBarInfoProps extends Pick<BaseNotificationBarProps, 'noAutoIncrease' | 'children' | 'childrenAsHtml' | 'dataTestId'> {
     readonly onDismiss?: () => void;
 }
 
@@ -2487,7 +2520,7 @@ declare enum NotificationBarType {
 
 export declare const NotificationBarWarning: ForwardRefExoticComponent<NotificationBarWarningProps & RefAttributes<HTMLDivElement>>;
 
-export declare interface NotificationBarWarningProps extends Pick<BaseNotificationBarProps, 'children' | 'childrenAsHtml' | 'dataTestId'> {
+export declare interface NotificationBarWarningProps extends Pick<BaseNotificationBarProps, 'noAutoIncrease' | 'children' | 'childrenAsHtml' | 'dataTestId'> {
     readonly onDismiss?: () => void;
 }
 
@@ -2659,6 +2692,63 @@ export declare enum RadioGroupSize {
     Large = "large"
 }
 
+export declare const ResizableBox: React_2.ForwardRefExoticComponent<ResizableBoxProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ResizableBoxProps extends LayoutComponentProps, UITestProps {
+    /**
+     * Initial width of the box in pixels.
+     */
+    width?: number;
+    /**
+     * Initial height of the box in pixels.
+     */
+    height?: number;
+    /**
+     * Minimum width of the box in pixels.
+     */
+    minWidth?: number;
+    /**
+     * Minimum height of the box in pixels.
+     */
+    minHeight?: number;
+    /**
+     * Maximum width of the box in pixels.
+     */
+    maxWidth?: number;
+    /**
+     * Maximum height of the box in pixels.
+     */
+    maxHeight?: number;
+    /**
+     * Directions in which the box can be resized.
+     */
+    directions?: HandleDirection[];
+    /**
+     * Callback fired when the resize starts.
+     */
+    onResizeStart?: (event: ResizeEvent) => unknown;
+    /**
+     * Callback fired when the box is being resized.
+     */
+    onResize?: (event: ResizeEvent) => unknown;
+    /**
+     * Callback fired when the resize ends.
+     */
+    onResizeEnd?: (event: ResizeEvent) => unknown;
+    /**
+     * Style of the component.
+     */
+    style?: CSSProperties;
+}
+
+export declare type ResizeEvent = {
+    size: {
+        width: number;
+        height: number;
+    };
+    direction: HandleDirection;
+};
+
 /**
  * Rich text editor component.
  */
@@ -3353,12 +3443,17 @@ export declare interface StringCell extends TableCell {
      * Value of the cell.
      */
     value: string;
+    /**
+     * Tooltip of the cell. If not set, the tooltip is same as the value.
+     */
+    tooltipText?: string;
 }
 
-export declare const StringTableCellComponent: ({ value }: StringTableCellComponentProps) => JSX.Element;
+export declare const StringTableCellComponent: ({ value, tooltipText }: StringTableCellComponentProps) => JSX.Element;
 
 export declare interface StringTableCellComponentProps {
     readonly value: string;
+    readonly tooltipText?: string;
 }
 
 export declare const SubheaderDivider: React_2.ForwardRefExoticComponent<SubheaderDividerProps & React_2.RefAttributes<HTMLDivElement>>;
@@ -3523,6 +3618,10 @@ export declare interface TableProps extends UITestProps {
      * Indicates if the table should have selectable rows.
      */
     readonly selectable?: boolean;
+    /**
+     * Indicates if the table should have selectable all rows at once.
+     */
+    readonly isAllRowsSelectable?: boolean;
     /**
      * Sort model of the table.
      */
@@ -3595,10 +3694,14 @@ export declare interface TableRow {
      * Indicates whether the row is in an invalid state.
      */
     isInvalid?: boolean;
+    /**
+     * The message to show when if the row is inactive.
+     */
+    inactiveMessage?: string;
 }
 
 export declare const TableRowComponent: {
-    ({ cells, columns, disabled, selectable, selected, skeleton, selectLabel, maxVisibleRowActions, inactiveMessage, dataTestId, onRowSelect: onSelect, onRowClick, isInvalid }: TableRowProps): JSX.Element;
+    ({ cells, columns, disabled, selectable, selected, skeleton, selectLabel, maxVisibleRowActions, inactiveMessage, dataTestId, onRowSelect: onSelect, onRowClick, isInvalid, dragElement }: TableRowProps): JSX.Element;
     displayName: string;
 };
 
@@ -3616,7 +3719,7 @@ export declare enum TableRowElevation {
 /**
  * Represents properties of the TableRow component.
  */
-declare interface TableRowProps extends UITestProps {
+export declare interface TableRowProps extends UITestProps {
     /**
      * List of cells displayed in a table row.
      */
@@ -3670,6 +3773,10 @@ declare interface TableRowProps extends UITestProps {
      * Indicates whether the row is in an invalid state. Defaults to 'False'.
      */
     readonly isInvalid?: boolean;
+    /**
+     * Drag element for the table row.
+     */
+    readonly dragElement?: JSX.Element;
 }
 
 export declare const Tag: React_2.ForwardRefExoticComponent<TagProps & React_2.RefAttributes<HTMLDivElement>>;
@@ -3889,7 +3996,7 @@ declare type TrailingElementType = 'icon' | 'label';
  * Tree node component.
  */
 export declare const TreeNode: {
-    ({ nodeIdentifier, children, level, renderTrailing, loading, onNodeToggle, onNodeClick, isExpanded, dataTestIdNode, dataTestIdNodeChildren, dataTestIdNodeRow, isToggleable, isSelectable, toggleDisabled, disabled, ...props }: TreeNodeProps): JSX.Element;
+    ({ nodeIdentifier, children, level, renderTrailing, loading, onNodeToggle, onNodeClick, isExpanded, dataTestIdNode, dataTestIdNodeChildren, dataTestIdNodeRow, isToggleable, isSelectable, toggleDisabled, disabled, omitExpandButton, omitExpandButtonOnZeroLevel, omitPaddingOnZeroLevel, ...props }: TreeNodeProps): JSX.Element;
     displayName: string;
 };
 
@@ -3929,7 +4036,7 @@ declare interface TreeNodeContentSharedProps extends UITestProps {
     /**
      * Indicates if current node is selected. Defaults to `false`.
      */
-    readonly isSelected: boolean;
+    readonly isSelected?: boolean;
     /**
      * Indicates if current node is disabled. Defaults to `false`.
      */
@@ -3986,6 +4093,11 @@ export declare interface TreeNodeDnDProps {
     draggedNodeName?: string;
 }
 
+/**
+ * Identifier of the tree node.
+ */
+export declare type TreeNodeId = string | number;
+
 /**
  * Tree node leading icon component.
  */
@@ -4027,7 +4139,7 @@ export declare interface TreeNodeMenuActionProps extends UITestProps {
     /**
      * Event fired on action click.
      */
-    readonly onClick: () => void;
+    readonly onClick?: () => void;
     /**
      * Tooltip of the action.
      */
@@ -4163,7 +4275,7 @@ export declare const TreeView: React_2.ForwardRefExoticComponent<TreeViewProps &
 export declare const TreeViewContext: React_2.Context<TreeViewContextType>;
 
 declare type TreeViewContextType = {
-    isSelected: (id: string) => boolean;
+    isSelected: (id: TreeNodeId) => boolean;
     anyNodeIsDragging: boolean;
     setAnyNodeIsDragging: (isDragging: boolean) => void;
 };
@@ -4172,7 +4284,7 @@ export declare interface TreeViewProps extends BaseTreeViewProps {
     /**
      * Identifier of the selected node.
      */
-    readonly selectedIdentifier?: string;
+    readonly selectedIdentifier?: TreeNodeId;
 }
 
 export declare interface UITestProps {