@kentico/xperience-admin-components 29.5.3 → 29.6.0

package/dist/entry.d.ts

@@ -7,6 +7,7 @@ import { DraggableProvidedDragHandleProps } from 'react-beautiful-dnd';
 import { DropResult } from 'react-beautiful-dnd';
 import { ForwardRefExoticComponent } from 'react';
 import { FroalaOptions } from 'froala-editor';
+import { HTMLAttributeAnchorTarget } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { KeyboardEvent as KeyboardEvent_2 } from 'react';
 import { MouseEvent as MouseEvent_2 } from 'react';
@@ -394,6 +395,10 @@ declare interface BaseTileBaseProps {
          */
         readonly onErrorClose: () => void;
     };
+    /**
+     * Indicates that user is missing permission to view the tile.
+     */
+    readonly isMissingPermission?: boolean;
     /**
      * Indicates uploading a file.
      */
@@ -1469,6 +1474,15 @@ export declare enum DropPlacement {
 
 export declare const Dropzone: React_2.ForwardRefExoticComponent<DropzoneProps & React_2.RefAttributes<HTMLDivElement>>;
 
+export declare const DropzoneOverlay: React_2.ForwardRefExoticComponent<DropzoneOverlayProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface DropzoneOverlayProps extends DropzoneProps {
+    /**
+     * The main title of the dropzone, which will be shown to the user in the center of the screen.
+     */
+    readonly title?: string;
+}
+
 export declare interface DropzoneProps {
     /**
      * Callback method called when files are selected.
@@ -1526,8 +1540,27 @@ export declare interface FileInputProps extends UITestProps {
     readonly onFileChange: (files: FileList) => void;
 }
 
+declare enum FileSizeUnit {
+    Byte = "byte",
+    Kilobyte = "kilobyte",
+    Megabyte = "megabyte",
+    Gigabyte = "gigabyte"
+}
+
 export declare function forceClickOutside(e?: MouseEvent): void;
 
+/**
+ * Formats file size to a readable string.
+ * @param fileSizeObject Object containing formatted file size and units.
+ * @returns Formatted file size string.
+ */
+export declare const formatFileSize: (fileSizeObject: FormattedFileSize | null) => string | null;
+
+declare type FormattedFileSize = {
+    fileSize: string;
+    unit: FileSizeUnit;
+};
+
 export declare const FormItemWrapper: React_2.ForwardRefExoticComponent<FormItemWrapperProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface FormItemWrapperProps extends UITestProps {
@@ -1622,6 +1655,16 @@ export declare function getDataTestId(input: string): string;
 
 export declare function getDataTestId(input: string | undefined, fallback: string): string;
 
+/**
+ * Converts file size from bytes to other units to make the size readable.
+ * If the converted file size is less than DecimalSizeLimit and rounding the number doesn't degrade it to integer,
+ * the file size is rounded and formatted to a number of fraction digits specified by DecimalDigits,
+ * otherwise the file size is rounded and formatted to a whole number.
+ * @param fileSizeInBytes File size to be formatted.
+ * @returns Object containing formatted file size and units.
+ */
+export declare const getFileSizeObject: (fileSizeInBytes: number) => FormattedFileSize | null;
+
 export declare enum Gradients {
     VeryLightWarmGrey = "var(--gradient-very-light-warm-grey)",
     Medium = "var(--gradient-medium)",
@@ -2118,6 +2161,7 @@ export declare const KXIcons: {
     'xp-folder-clock': ForwardRefExoticComponent<GeneratedIconProps & RefAttributes<SVGSVGElement>>;
     'xp-folder-cogwheel': ForwardRefExoticComponent<GeneratedIconProps & RefAttributes<SVGSVGElement>>;
     'xp-folder-inverted': ForwardRefExoticComponent<GeneratedIconProps & RefAttributes<SVGSVGElement>>;
+    'xp-folder-move': ForwardRefExoticComponent<GeneratedIconProps & RefAttributes<SVGSVGElement>>;
     'xp-folder-opened': ForwardRefExoticComponent<GeneratedIconProps & RefAttributes<SVGSVGElement>>;
     'xp-folder': ForwardRefExoticComponent<GeneratedIconProps & RefAttributes<SVGSVGElement>>;
     'xp-form': ForwardRefExoticComponent<GeneratedIconProps & RefAttributes<SVGSVGElement>>;
@@ -2364,14 +2408,14 @@ export declare const KXIcons: {
  * Component for displaying label with tooltip visible when hovering over information icon.
  */
 export declare const LabelWithTooltip: {
-    ({ label, tooltipText }: LabelWithTooltipProps): JSX_2.Element;
+    ({ label, tooltipText, dataTestId }: LabelWithTooltipProps): JSX_2.Element;
     displayName: string;
 };
 
 /**
  * Represents properties for the LabelWithTooltip component.
  */
-export declare interface LabelWithTooltipProps {
+export declare interface LabelWithTooltipProps extends UITestProps {
     readonly label: string;
     readonly tooltipText: string;
 }
@@ -3316,10 +3360,11 @@ export declare const SimpleStatusSuccess: React_2.ForwardRefExoticComponent<Simp
 export declare interface SimpleStatusSuccessProps extends Omit<BaseSimpleStatusProps, 'type' | 'labelColor' | 'iconColor'> {
 }
 
-export declare const SimpleStatusTableCellComponent: ({ iconName, label, iconColor, labelColor, tooltipText }: SimpleStatusTableCellComponentProps) => JSX_2.Element;
+export declare const SimpleStatusTableCellComponent: ({ iconName, label, iconColor, iconAlign, labelColor, tooltipText }: SimpleStatusTableCellComponentProps) => JSX_2.Element;
 
 export declare interface SimpleStatusTableCellComponentProps extends StatusComponentProps {
     readonly tooltipText?: string;
+    readonly iconAlign?: SimpleStatusAlign;
 }
 
 declare enum SimpleStatusType {
@@ -3421,7 +3466,7 @@ export declare interface SpinnerProps extends Omit<IconProps, 'name'> {
 }
 
 export declare const SplitButton: {
-    ({ size, color, disabled, disabledState, inProgress, icon, open, onToggle, children, onClick, title, ...props }: SplitButtonProps): JSX_2.Element;
+    ({ size, color, disabled, disabledState, inProgress, icon, open, onToggle, children, href, target, onClick, title, ...props }: SplitButtonProps): JSX_2.Element;
     displayName: string;
 };
 
@@ -3433,10 +3478,12 @@ export declare enum SplitButtonDisabledState {
 
 export declare interface SplitButtonProps extends Omit<BaseButtonProps, 'renderComponent' | 'trailingIcon' | 'active' | 'badge' | 'fillContainer' | 'destructive' | 'borderless' | 'className'> {
     readonly color: ButtonColor.Primary | ButtonColor.Secondary;
-    readonly size: ButtonSize.S | ButtonSize.M | ButtonSize.L;
     readonly onToggle?: (isOpen: boolean) => void;
+    readonly size: ButtonSize.S | ButtonSize.M | ButtonSize.L;
     readonly open?: boolean;
-    readonly onClick: () => void;
+    readonly href?: string;
+    readonly target?: HTMLAttributeAnchorTarget;
+    readonly onClick?: (e: MouseEvent_2<HTMLElement>) => void;
     readonly children: React.ReactNode;
     readonly title?: string;
     /**
@@ -3902,6 +3949,7 @@ export declare const TextArea: React_2.ForwardRefExoticComponent<TextAreaProps &
 
 export declare interface TextAreaProps extends Pick<React_2.TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange' | 'disabled' | 'name' | 'onClick' | 'onKeyPress' | 'id' | 'placeholder' | 'maxLength'>, UITestProps {
     readonly label?: string;
+    readonly readOnly?: boolean;
     readonly validationMessage?: string;
     readonly invalid?: boolean;
     readonly value?: string;