@kentico/xperience-admin-components 30.11.3 → 30.12.0

package/README.md

@@ -0,0 +1,9 @@
+# Xperience by Kentico - Admin Client Package
+
+This package is part of the Xperience by Kentico administration interface framework.
+
+## Documentation
+
+For setup instructions, usage guidelines, and customization options, please refer to the official Xperience by Kentico documentation:
+
+**[Extend the administration interface](https://docs.kentico.com/x/GwKQC)**

package/dist/entry.d.ts

@@ -6,6 +6,7 @@ import { DefineIconParameters } from 'froala-editor';
 import { DraggableProvidedDragHandleProps } from '@hello-pangea/dnd';
 import { DropResult } from '@hello-pangea/dnd';
 import { ForwardRefExoticComponent } from 'react';
+import { default as FroalaEditor } from 'froala-editor';
 import { FroalaOptions } from 'froala-editor';
 import { HTMLAttributeAnchorTarget } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
@@ -467,6 +468,10 @@ declare interface BaseTileProps extends BaseTileBaseProps, UITestProps {
      * Function called when tile is clicked.
      */
     readonly onClick?: () => void;
+    /**
+     * URL to navigate to when tile is clicked. If provided, tile will be rendered as NavLink.
+     */
+    readonly href?: string;
     /**
      * Specifies if checkbox in tile info bar is visible.
      */
@@ -1196,10 +1201,10 @@ export declare const ContentItemTilePreview: React_2.ForwardRefExoticComponent<C
 /**
  * Selected props from ContentItemTileProps for Preview tile.
  */
-export declare interface ContentItemTilePreviewProps extends ContentItemTileExtendedProps, BaseTileBaseProps, Pick<ContentItemTileProps, 'onClick' | 'isSelected' | 'onChange' | 'isCheckboxVisible' | 'selectOnClick' | 'actions' | 'dataTestId' | 'inactiveMessage' | 'isDragging' | 'dragElement'> {
+export declare interface ContentItemTilePreviewProps extends ContentItemTileExtendedProps, BaseTileBaseProps, Pick<ContentItemTileProps, 'onClick' | 'isSelected' | 'onChange' | 'isCheckboxVisible' | 'selectOnClick' | 'actions' | 'href' | 'dataTestId' | 'inactiveMessage' | 'isDragging' | 'dragElement'> {
 }
 
-declare interface ContentItemTileProps extends ContentItemTileExtendedProps, Pick<BaseTileProps, 'errorState' | 'url' | 'uploadState' | 'name' | 'disabled' | 'isCheckboxVisible' | 'selectOnClick' | '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' | 'href' | 'dataTestId' | 'actions' | 'inactiveMessage'> {
     /**
      * Type of content item.
      */
@@ -1632,6 +1637,14 @@ 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;
+    /**
+     * Additional class name(s) to be added to the dropzone overlay container.
+     */
+    readonly className?: string;
+    /**
+     * Additional class name(s) to be added to the overlay element.
+     */
+    readonly overlayClassName?: string;
 }
 
 export declare interface DropzoneProps {
@@ -1764,6 +1777,8 @@ export declare interface FormItemWrapperProps extends UITestProps {
     readonly labelActionsElement?: React_2.ReactNode;
 }
 
+export { FroalaEditor }
+
 /** Configurator enables custom Froala Typescript plugins to use global Froala configuration methods, which would be unavailable due to different module context. */
 export declare interface FroalaEditorConfigurator {
     readonly defineIcon: (iconName: string, parameters: Partial<DefineIconParameters>) => void;
@@ -4792,6 +4807,10 @@ export declare interface TableProps extends UITestProps {
      * Callback {@link TableProps.onRowClick} is invoked if defined.
      */
     readonly toggleSelectionOnRowClick?: boolean;
+    /**
+     * Represents the index of the current page when table data is paginated.
+     */
+    readonly pageIndex?: number;
 }
 
 export declare interface TableRow {
@@ -4893,7 +4912,7 @@ export declare interface TableRowProps extends UITestProps {
     /**
      * Callback when selectable row is selected.
      */
-    readonly onRowSelect?: (selected: boolean) => void;
+    readonly onRowSelect?: (selected: boolean, shiftKey?: boolean) => void;
     /**
      * Callback when row is clicked on.
      */
@@ -5038,9 +5057,11 @@ declare const testIds: {
         Create_V2: "Create";
         CreateFolder_V2: "createfolder-action";
         CreateNewStage: "create-new-stage-button";
-        Delete_V3: "button-Delete";
-        Delete_V4: "delete-action";
+        DeleteContentItem: "button-Move to recycle bin";
         DeleteFolder: "deletefolder-action";
+        DeleteInListing: "button-Delete";
+        DeleteInTree: "delete-action";
+        DeleteMassAction: "Move to recycle bin-action";
         EditRecipientListBasicData: "edit-recipient-list-basic-data-button";
         EmailContentFieldsDropdown: "email-content-fields-dropdown-indicator";
         EnableContentDelivery: "enablecontentdelivery-action";
@@ -5052,8 +5073,10 @@ declare const testIds: {
         MoveFolder: "movefolder-action";
         NestedActionMenuItemMassUpload: "nested-action-menu-item-mass-upload";
         OpenBindingSidePanel: "button-open-binding-sidepanel";
+        PermanentlyDelete: "button-Delete permanently";
         RemoveBinding: "button-RemoveBinding";
         RenameFolder: "renamefolder-action";
+        Restore: "button-Restore";
         RichTextEditorRefinements: "rich-text-editor-refinements-button";
         Save: "button-save";
         WebsiteChannel: "website-channel";
@@ -5089,10 +5112,10 @@ declare const testIds: {
         CreateNewContentItem: "button-create-new-content-item";
         CreateNewVersion: "content-item-menu-split-button-createnewversion";
         CreatePage: "create-page-button";
-        Delete_V1: "delete-button";
-        Delete_V2: "button-delete";
+        Delete: "delete-button";
         DeleteAction: "Delete-action";
         DeleteConditionButton: "delete-condition-button";
+        DeleteCustomerJourneyStageBuilder: "button-delete";
         DialogFooterAction: "dialog-footer-action";
         Draggable: "draggable-button";
         Edit_V1: "button-edit";
@@ -5119,7 +5142,6 @@ declare const testIds: {
         Recalculate: "button-recalculate";
         RecalculateAutomationsStatistics: "recalculate-automations-statistics-button";
         RecalculateEmailStatistics: "recalculate-email-statistics-button";
-        Restore: "restore-button";
         SaveAutomation: "save-automation-button";
         SavePermissions: "save-permissions-button";
         SecondaryAction: "secondary-action";
@@ -5238,6 +5260,7 @@ declare const testIds: {
         Logon: "logonForm";
         Mfa: "mfaForm";
         Properties: "properties-form";
+        SmartAssetInlineUpload: "smart-asset-inline-upload-form";
         SmartFolder: "smart-folder-form";
     };
     Headlines: {
@@ -5424,6 +5447,7 @@ declare const testIds: {
         SelectedLanguage: "selected-language-item";
         SelectLibrary: "select-library-item";
         TreeNodeAction: "action";
+        UploadFiles: "upload-files-menu-item";
     };
     NotificationBars: {
         Alert: "notification-bar-alert-0";
@@ -5518,6 +5542,7 @@ declare const testIds: {
         WebPage: "select-web-page";
         Workspace: "select-workspace";
         WorkspaceID: "WorkspaceID";
+        WorkspaceId: "WorkspaceId";
         WorkspaceItem: "workspace-item-selector";
     };
     SideMenus: {
@@ -6187,6 +6212,37 @@ export declare const useMediaBreakpoints: () => {
  */
 export declare const useMobileKeyboard: (minKeyboardHeight?: number) => boolean;
 
+/**
+ * Hook for handling range selection with shift+click multi-select functionality.
+ * Allows selecting a range of items by holding shift and clicking.
+ */
+export declare function useRangeSelection<T = unknown>({ selectedItems, items, onSelectionChange, resetDependency }: UseRangeSelectionOptions<T>): {
+    onSelectItem: (identifier: T, selected: boolean, shiftKey?: boolean) => void;
+    resetLastClickedIndex: () => void;
+};
+
+declare interface UseRangeSelectionOptions<T> {
+    /**
+     * Array of currently selected item identifiers.
+     */
+    readonly selectedItems: T[];
+    /**
+     * Array of all available items.
+     */
+    readonly items: Array<{
+        identifier: T;
+        disabled?: boolean;
+    }> | undefined;
+    /**
+     * Callback when selection changes.
+     */
+    readonly onSelectionChange: (selectedItems: T[]) => void;
+    /**
+     * Optional page index or other dependency to reset last clicked index.
+     */
+    readonly resetDependency?: unknown;
+}
+
 export declare const useScrollDown: (throttleInterval?: number) => boolean;
 
 export declare const useSidePanel: () => SidePanelManagerContextType;