@gooddata/sdk-ui-dashboard 10.16.0-alpha.2 → 10.16.0-alpha.20

package/esm/sdk-ui-dashboard.d.ts

@@ -225,7 +225,8 @@ import { IKpiComparisonTypeComparison } from '@gooddata/sdk-model';
 import { IKpiWidget } from '@gooddata/sdk-model';
 import { IKpiWidgetConfiguration } from '@gooddata/sdk-model';
 import { IKpiWidgetDefinition } from '@gooddata/sdk-model';
-import { ILayoutCoordinates as ILayoutCoordinates_2 } from '../../../types.js';
+import { ILayoutItemPath as ILayoutItemPath_2 } from '../../../types.js';
+import { ILayoutSectionPath as ILayoutSectionPath_2 } from '../../../types.js';
 import { IListedDashboard } from '@gooddata/sdk-model';
 import { ILoadingProps } from '@gooddata/sdk-ui';
 import { ILocale } from '@gooddata/sdk-ui';
@@ -542,8 +543,10 @@ export declare interface AddLayoutSection extends IDashboardCommand {
  *
  * You may optionally specify the initial values of the section header and the items that will be in the new section.
  *
+ * This command operates only on the root layout. For nested layouts, use {@link addNestedLayoutSection}.
+ *
  * @param index - index to place the section at; -1 can be used as convenience to append a new section
- * @param initialHeader - specify specify header for the newly created section
+ * @param initialHeader - specify header for the newly created section
  * @param initialItems - specify one or more items that the newly created section should include from the get-go
  * @param autoResolveDateFilterDataset - specify whether dashboard should auto-resolve date dataset to use for date filtering of KPI
  *  and insight widgets; default is disabled meaning date filtering will be enabled only for those KPI or Insight widgets
@@ -566,8 +569,12 @@ export declare interface AddLayoutSectionPayload {
      * @remarks
      * Index is zero-based and for convenience index -1 means place new section at the end. 0 means place new
      * section at the beginning. Both 0 and -1 and can be used when inserting the first section into and empty layout.
+     *
+     * {@link RelativeIndex} support will be removed in the next major SDK version. Use {@link ILayoutSectionPath} instead.
+     *
+     * TODO LX-648: Remove RelativeIndex type in the next major version.
      */
-    readonly index: RelativeIndex;
+    readonly index: RelativeIndex | ILayoutSectionPath;
     /**
      * Specify the section header.
      */
@@ -591,6 +598,28 @@ export declare interface AddLayoutSectionPayload {
     readonly autoResolveDateFilterDataset?: boolean;
 }
 
+/**
+ * Creates the AddLayoutSection command.
+ *
+ * @remarks
+ * Dispatching this command will result in the addition of a new layout section.
+ * The new section will be placed at the desired index and will be empty by default.
+ *
+ * You may optionally specify the initial values of the section header and the items that will be in the new section.
+ *
+ * @param index - index to place the section at; -1 can be used as convenience to append a new section
+ * @param initialHeader - specify header for the newly created section
+ * @param initialItems - specify one or more items that the newly created section should include from the get-go
+ * @param autoResolveDateFilterDataset - specify whether dashboard should auto-resolve date dataset to use for date filtering of KPI
+ *  and insight widgets; default is disabled meaning date filtering will be enabled only for those KPI or Insight widgets
+ *  that already specify dateDataset.
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function addNestedLayoutSection(index: ILayoutSectionPath, initialHeader?: IDashboardLayoutSectionHeader, initialItems?: DashboardItemDefinition[], autoResolveDateFilterDataset?: boolean, correlationId?: string): AddLayoutSection;
+
 /**
  * Creates the AddSectionItems command.
  *
@@ -599,6 +628,27 @@ export declare interface AddLayoutSectionPayload {
  * section. This item may be a placeholder for KPI or insight, an actual dashboard widget or a previously stashed
  * dashboard item.
  *
+ * @param itemPath - path to which the new item should be added
+ * @param item - definition of the new item.
+ * @param autoResolveDateFilterDataset - specify whether dashboard should auto-resolve date dataset to use for date filtering of KPI
+ *  and insight widgets; default is disabled meaning date filtering will be enabled only for those KPI or Insight widgets
+ *  that already specify dateDataset.
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function addNestedLayoutSectionItem(itemPath: ILayoutItemPath, item: DashboardItemDefinition, autoResolveDateFilterDataset?: boolean, correlationId?: string): AddSectionItems;
+
+/**
+ * Creates the AddSectionItems command.
+ *
+ * @remarks
+ * Dispatching this command will result in addition of a new item into the existing
+ * section. This item may be a placeholder for KPI or insight, an actual dashboard widget or a previously stashed
+ * dashboard item.
+ *
+ * This command operates only on the root layout. For nested layouts, use {@link addNestedLayoutSectionItem}.
  *
  * @param sectionIndex - index of section to which the new item should be added
  * @param itemIndex - index at which to insert the new item
@@ -631,6 +681,10 @@ export declare interface AddSectionItemsPayload {
      *
      * @remarks
      * Index is zero-based.
+     *
+     * {@link AddSectionItemsPayload.sectionIndex} support will be removed in the next major SDK version. Use {@link AddSectionItemsPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove sectionIndex in the next major version.
      */
     readonly sectionIndex: number;
     /**
@@ -638,8 +692,21 @@ export declare interface AddSectionItemsPayload {
      *
      * @remarks
      * Index is zero-based. For convenience, you may specify -1 to append the new item.
+     *
+     * {@link AddSectionItemsPayload.itemIndex} support will be removed in the next major SDK version. Use {@link AddSectionItemsPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove itemIndex in the next major version.
      */
     readonly itemIndex: RelativeIndex;
+    /**
+     * Path to which the item should be added.
+     *
+     * @remarks
+     * Index is zero-based.
+     *
+     * TODO LX-648: make the prop required
+     */
+    readonly itemPath?: ILayoutItemPath;
     /**
      * Items to add. This item may be a placeholder for KPI or insight, an actual dashboard widget or a previously
      * stashed dashboard item.
@@ -974,7 +1041,7 @@ export declare interface BackendCapabilitiesState {
  * @beta
  */
 export declare interface BareUserInteractionPayload {
-    interaction: "kpiAlertDialogClosed" | "poweredByGDLogoClicked" | "filterContextStateReset" | "interactionPanelOpened" | "addInteractionClicked" | AttributeHierarchiesInteractionType | AttributeFilterInteractionType | DateFilterInteractionType | VisualizationSwitcherInteractionType;
+    interaction: "kpiAlertDialogClosed" | "poweredByGDLogoClicked" | "filterContextStateReset" | "interactionPanelOpened" | "addInteractionClicked" | AttributeHierarchiesInteractionType | AttributeFilterInteractionType | DateFilterInteractionType | VisualizationSwitcherInteractionType | NestedLayoutInteractionType;
 }
 
 /**
@@ -1005,6 +1072,7 @@ export declare type BaseDraggableMovingItem = BaseDraggableLayoutItem & {
     isOnlyItemInSection: boolean;
     sectionIndex: number;
     itemIndex: number;
+    layoutPath?: ILayoutItemPath;
 };
 
 /**
@@ -1825,6 +1893,8 @@ export declare interface ChangeLayoutSectionHeader extends IDashboardCommand {
  * @remarks
  * Dispatching this command will result in change of the section's title and/or description.
  *
+ * This command operates only on the root layout. For nested layouts, use {@link changeNestedLayoutSectionHeader}.
+ *
  * @param index - index of section to change
  * @param header - new header
  * @param merge - indicates whether the old header and the new header should be merged; default is no merging
@@ -1845,8 +1915,12 @@ export declare interface ChangeLayoutSectionHeaderPayload {
      *
      * @remarks
      * Index is zero based. Exact index must be provided.
+     *
+     * "number" support will be removed in the next major SDK version. Use {@link ILayoutSectionPath} instead.
+     *
+     * TODO LX-648: Remove number type in the next major version.
      */
-    readonly index: number;
+    readonly index: number | ILayoutSectionPath;
     /**
      * New value of the header.
      */
@@ -1860,6 +1934,22 @@ export declare interface ChangeLayoutSectionHeaderPayload {
     readonly merge?: boolean;
 }
 
+/**
+ * Creates the ChangeLayoutSectionHeader command.
+ *
+ * @remarks
+ * Dispatching this command will result in change of the section's title and/or description.
+ *
+ * @param index - index of section to change
+ * @param header - new header
+ * @param merge - indicates whether the old header and the new header should be merged; default is no merging
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function changeNestedLayoutSectionHeader(index: ILayoutSectionPath, header: IDashboardLayoutSectionHeader, merge?: boolean, correlationId?: string): ChangeLayoutSectionHeader;
+
 /**
  * @beta
  */
@@ -4820,8 +4910,16 @@ export declare interface DashboardLayoutSectionAddedPayload {
      * Index of the new section among other sections in the layout.
      *
      * Index is zero-based.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionAddedPayload.path} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly index: number;
+    /**
+     * Path to the new section among other sections in the layout.
+     */
+    readonly path: ILayoutSectionPath;
 }
 
 /**
@@ -4845,8 +4943,16 @@ export declare interface DashboardLayoutSectionHeaderChangedPayload {
     readonly newHeader: IDashboardLayoutSectionHeader;
     /**
      * Index of the section which had the header updated.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionHeaderChangedPayload.sectionPath} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly sectionIndex: number;
+    /**
+     * Path of the section which had the header updated.
+     */
+    readonly sectionPath: ILayoutSectionPath;
 }
 
 /**
@@ -4870,22 +4976,46 @@ export declare interface DashboardLayoutSectionItemMovedPayload {
     readonly item: ExtendedDashboardItem;
     /**
      * Index of section from which the item was moved.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemMovedPayload.fromPath} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly fromSectionIndex: number;
     /**
      * Index of section to which the item was moved.
      *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemMovedPayload.toPath} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
+     *
      * This may be the same as `fromSectionIndex` - which means the move happened within the same section.
      */
     readonly toSectionIndex: number;
     /**
      * Index within the `fromSection` from where the item was moved.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemMovedPayload.fromPath} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly fromIndex: number;
     /**
      * Index in `toSection` at which the item was inserted.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemMovedPayload.toPath} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly toIndex: number;
+    /**
+     * Path from where the item was moved.
+     */
+    readonly fromPath: ILayoutItemPath;
+    /**
+     * Path at which the item was inserted.
+     */
+    readonly toPath: ILayoutItemPath;
     /**
      * Indicate, that original section has been removed.
      */
@@ -4913,8 +5043,16 @@ export declare interface DashboardLayoutSectionItemRemovedPayload {
     readonly item: ExtendedDashboardItem;
     /**
      * Index where the item resided.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemRemovedPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly itemIndex: number;
+    /**
+     * Path where the item resided.
+     */
+    readonly itemPath: ILayoutItemPath;
     /**
      * If the removal was eager and removed the entire section, then that section is included here.
      *
@@ -4943,12 +5081,24 @@ export declare interface DashboardLayoutSectionItemReplaced extends IDashboardEv
 export declare interface DashboardLayoutSectionItemReplacedPayload {
     /**
      * Index of section where the replacement happened.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemReplacedPayload.path} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly sectionIndex: number;
     /**
      * Index of item within the section that was replaced.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemReplacedPayload.path} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly itemIndex: number;
+    /**
+     * Path of item that was replaced.
+     */
+    readonly path: ILayoutItemPath;
     /**
      * New item definition.
      */
@@ -4981,12 +5131,24 @@ export declare interface DashboardLayoutSectionItemsAdded extends IDashboardEven
 export declare interface DashboardLayoutSectionItemsAddedPayload {
     /**
      * Index of the section to which the items were added.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemsAddedPayload.path} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly sectionIndex: number;
     /**
      * Index within the section at which the items were inserted.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionItemsAddedPayload.path} instead.
+     *
+     * TODO LX-648: Remove property in the next major version.
      */
     readonly startIndex: number;
+    /**
+     * Path of the inserted item.
+     */
+    readonly path: ILayoutItemPath;
     /**
      * Items that were inserted.
      */
@@ -5019,12 +5181,28 @@ export declare interface DashboardLayoutSectionMovedPayload {
     readonly section: ExtendedDashboardLayoutSection;
     /**
      * Index from which the section was moved.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionMovedPayload.fromPath} instead.
+     *
+     * TODO LX-648: Remove property in the next major SDK version.
      */
     readonly fromIndex: number;
+    /**
+     * Path from which the section was moved.
+     */
+    readonly fromPath: ILayoutSectionPath;
     /**
      * Zero-based index to which the section was moved.
+     *
+     * @deprecated The prop will be removed in the next SDK major version. Use {@link DashboardLayoutSectionMovedPayload.toPath} instead.
+     *
+     * TODO LX-648: Remove property in the next major SDK version.
      */
     readonly toIndex: number;
+    /**
+     * Path to which the section was moved.
+     */
+    readonly toPath: ILayoutSectionPath;
 }
 
 /**
@@ -5054,8 +5232,16 @@ export declare interface DashboardLayoutSectionRemovedPayload {
     readonly section: ExtendedDashboardLayoutSection;
     /**
      * Index where the section originally resided.
+     *
+     * @deprecated The prop will be removed in the next major SDK version. Use {@link DashboardLayoutSectionRemovedPayload.path} instead.
+     *
+     * TODO LX-648: Remove property in the next major SDK version.
      */
     readonly index: number;
+    /**
+     * Path where the section originally resided.
+     */
+    readonly path: ILayoutSectionPath;
     /**
      * Indicates that the section was removed as part of eager removal of the section items.
      */
@@ -6938,6 +7124,26 @@ export declare interface DropTargetComponentProps {
  *
  * You may optionally specify the stashIdentifier in order to stash the removed item for later resurrection.
  *
+ * @param itemPath - path of section from which to remove the item
+ * @param stashIdentifier - stash identifier to store the removed item under; if not specified the item will be removed
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function eagerRemoveNestedLayoutSectionItem(itemPath: ILayoutItemPath, stashIdentifier?: StashedDashboardItemsId, correlationId?: string): RemoveSectionItem;
+
+/**
+ * Creates the RemoveSectionItem configured to do eager remove of item.
+ *
+ * @remarks
+ * Dispatching this command will result in removal
+ * of the item from a section and if the section only contains that item then the whole section will be removed as well.
+ *
+ * You may optionally specify the stashIdentifier in order to stash the removed item for later resurrection.
+ *
+ * This command operates only on the root layout. For nested layouts, use {@link eagerRemoveNestedLayoutSectionItem}.
+ *
  * @param sectionIndex - index of section from which to remove the item
  * @param itemIndex - index of item to remove
  * @param stashIdentifier - stash identifier to store the removed item under; if not specified the item will be removed
@@ -6945,6 +7151,8 @@ export declare interface DropTargetComponentProps {
  *  events that will be emitted during the command processing
  *
  * @beta
+ *
+ * TODO LX-648: Consider removing this command variant and leave only a nested variant
  */
 export declare function eagerRemoveSectionItem(sectionIndex: number, itemIndex: number, stashIdentifier?: StashedDashboardItemsId, correlationId?: string): RemoveSectionItem;
 
@@ -7515,6 +7723,7 @@ export declare interface HeadlessDashboardConfig {
 export declare interface HeightResizerDragItem {
     type: "internal-height-resizer";
     sectionIndex: number;
+    sectionPath?: ILayoutSectionPath;
     itemIndexes: number[];
     widgetHeights: number[];
     initialLayoutDimensions: DOMRect;
@@ -9376,9 +9585,10 @@ export declare interface IDashboardNestedLayoutProps {
     onFiltersChange?: (filters: (IDashboardFilter | FilterContextItem)[], resetOthers?: boolean) => void;
     onDrill?: OnFiredDashboardDrillEvent;
     onError?: OnError;
+    widget?: ExtendedDashboardLayoutWidget;
     layout?: IDashboardLayout<ExtendedDashboardWidget>;
-    screen?: ScreenSize;
     parentLayoutItemSize?: IDashboardLayoutSizeByScreenSize;
+    parentLayoutPath?: ILayoutItemPath;
     /**
      * Backend to work with.
      *
@@ -9783,6 +9993,12 @@ export declare interface IDashboardWidgetProps {
      * @alpha
      */
     parentLayoutItemSize?: IDashboardLayoutSizeByScreenSize;
+    /**
+     * The path to the layout item in which the section is nested
+     *
+     * @alpha
+     */
+    parentLayoutPath?: ILayoutItemPath;
     /**
      * Specify date data set to use when passing dashboard date filter to rendered visualization.
      *
@@ -9930,6 +10146,7 @@ export declare type IDraggableCreatePanelItemProps = {
     dragItem: DraggableItem;
     hideDefaultPreview?: boolean;
     disabled?: boolean;
+    onDragStart?: (item: DraggableItem) => void;
 };
 
 /**
@@ -10429,6 +10646,30 @@ export declare interface ILayoutCoordinates {
     itemIndex: number;
 }
 
+/**
+ *  Coordinates of an item in a nested layout.
+ *  @alpha
+ */
+export declare type ILayoutItemPath = ILayoutCoordinates[];
+
+/**
+ *  Coordinates of a section in a nested layout.
+ *  @alpha
+ */
+export declare interface ILayoutSectionPath {
+    /**
+     * The path to the parent item that contains this section.
+     *
+     * Undefined when section is in the root layout, otherwise leads to the layout widget in which the section
+     * is nested.
+     */
+    parent?: ILayoutItemPath;
+    /**
+     * Zero based index.
+     */
+    sectionIndex: number;
+}
+
 /**
  * Legacy Dashboard (a.k.a. PP Dashboard).
  * @alpha
@@ -12422,6 +12663,24 @@ export declare function isKpiPlaceholderDraggableItem(item: any): item is KpiPla
  */
 export declare function isKpiPlaceholderWidget(obj: unknown): obj is KpiPlaceholderWidget;
 
+/**
+ *  Tests whenever the provided object is layout coordinates object.
+ *  @alpha
+ */
+export declare function isLayoutCoordinates(obj: unknown): obj is ILayoutCoordinates;
+
+/**
+ *  Tests whenever the provided object is section path.
+ *  @alpha
+ */
+export declare function isLayoutItemPath(obj: unknown): obj is ILayoutItemPath;
+
+/**
+ *  Tests whenever the provided object is section path.
+ *  @alpha
+ */
+export declare function isLayoutSectionPath(obj: unknown): obj is ILayoutSectionPath;
+
 /**
  * Tests whether an object is a {@link PlaceholderWidget} and is loading.
  *
@@ -12669,6 +12928,7 @@ export declare type IWrapCreatePanelItemWithDragProps = {
     dragItem: DraggableItem;
     hideDefaultPreview?: boolean;
     disabled?: boolean;
+    onDragStart?: (item: DraggableItem) => void;
 };
 
 /**
@@ -12682,6 +12942,7 @@ export declare type IWrapInsightListItemWithDragComponent = React.ComponentType<
 export declare interface IWrapInsightListItemWithDragProps {
     children: JSX.Element;
     insight: IInsight;
+    onDragStart?: (item: DraggableItem) => void;
 }
 
 /**
@@ -13075,6 +13336,9 @@ export declare interface MoveLayoutSection extends IDashboardCommand {
  * Creates the MoveLayoutSection command. Dispatching this command will result in move of the section located at `sectionIndex`
  * to a new place indicated by `toIndex`.
  *
+ * @remarks
+ * This command operates only on the root layout. For nested layouts, use {@link moveNestedLayoutSection}.
+ *
  * @param sectionIndex - index of section to move
  * @param toIndex - the new index for the section
  * @param correlationId - specify correlation id to use for this command. this will be included in all
@@ -13093,16 +13357,103 @@ export declare interface MoveLayoutSectionPayload {
      * Index of the section to move.
      *
      * Index is zero-based.
+     *
+     * @remarks
+     * "number" support will be removed in the next major SDK version. Use {@link ILayoutSectionPath} instead.
+     *
+     * TODO LX-648: Remove number type in the next major version.
      */
-    readonly sectionIndex: number;
+    readonly sectionIndex: number | ILayoutSectionPath;
     /**
      * Index where the section should be moved.
      *
      * Index is zero-based. For convenience index of -1 means moving the item to the end of the section list.
+     *
+     * @remarks
+     * "number" support will be removed in the next major SDK version. Use {@link ILayoutSectionPath} instead.
+     *
+     * TODO LX-648: Remove number type in the next major version.
      */
-    readonly toIndex: RelativeIndex;
+    readonly toIndex: number | ILayoutSectionPath;
 }
 
+/**
+ * Creates the MoveLayoutSection command. Dispatching this command will result in move of the section located at `sectionIndex`
+ * to a new place indicated by `toIndex`.
+ *
+ * @param sectionIndex - index of section to move
+ * @param toIndex - the new index for the section
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function moveNestedLayoutSection(sectionIndex: ILayoutSectionPath, toIndex: ILayoutSectionPath, correlationId?: string): MoveLayoutSection;
+
+/**
+ * Creates the MoveSectionItem command.
+ *
+ * @remarks
+ * Dispatching this command will result in move of single item within
+ * section or from one section to another.
+ *
+ * @param fromPath - source item path
+ * @param toPath - target path; you may specify -1 to move to last section/to be last item
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function moveNestedLayoutSectionItem(fromPath: ILayoutItemPath, toPath: ILayoutItemPath, correlationId?: string): MoveSectionItem;
+
+/**
+ * Creates the MoveSectionItem command.
+ *
+ * @remarks
+ * Dispatching this command will result in move of single item within
+ * section or from one section to another. If original section stays empty after move, then it will be removed.
+ *
+ * @param fromPath - source item path
+ * @param toPath - target path; you may specify -1 to move to last section/to be last item
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function moveNestedLayoutSectionItemAndRemoveOriginalSectionIfEmpty(fromPath: ILayoutItemPath, toPath: ILayoutItemPath, correlationId?: string): MoveSectionItem;
+
+/**
+ * Creates the MoveSectionItemToNewSection command.
+ *
+ * @remarks
+ * Dispatching this command will result in move of single item within
+ * section or from one section to another.
+ *
+ * @param itemPath - source item path
+ * @param toSection - target section path; you may specify -1 to move to last section
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function moveNestedLayoutSectionItemToNewSection(itemPath: ILayoutItemPath, toSection: ILayoutSectionPath, correlationId?: string): MoveSectionItemToNewSection;
+
+/**
+ * Creates the MoveSectionItemToNewSection command.
+ *
+ * @remarks
+ * Dispatching this command will result in move of single item within
+ * section or from one section to another. If original section stays empty after move, then it will be removed.
+ *
+ * @param itemPath - source item index
+ * @param toSection - target section index; you may specify -1 to move to last section
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function moveNestedLayoutSectionItemToNewSectionAndRemoveOriginalSectionIfEmpty(itemPath: ILayoutItemPath, toSection: ILayoutSectionPath, correlationId?: string): MoveSectionItemToNewSection;
+
 /**
  * @beta
  */
@@ -13118,6 +13469,8 @@ export declare interface MoveSectionItem extends IDashboardCommand {
  * Dispatching this command will result in move of single item within
  * section or from one section to another.
  *
+ * This command operates only on the root layout. For nested layouts, use {@link moveNestedLayoutSectionItem}.
+ *
  * @param sectionIndex - source section index
  * @param itemIndex - index of item to move
  * @param toSectionIndex - target section index; you may specify -1 to move to last section
@@ -13126,6 +13479,8 @@ export declare interface MoveSectionItem extends IDashboardCommand {
  *  events that will be emitted during the command processing
  *
  * @beta
+ *
+ * TODO LX-648: Consider removing this command variant and leave only a nested variant
  */
 export declare function moveSectionItem(sectionIndex: number, itemIndex: number, toSectionIndex: number, toItemIndex: number, correlationId?: string): MoveSectionItem;
 
@@ -13136,6 +13491,8 @@ export declare function moveSectionItem(sectionIndex: number, itemIndex: number,
  * Dispatching this command will result in move of single item within
  * section or from one section to another. If original section stays empty after move, then it will be removed.
  *
+ * This command operates only on the root layout. For nested layouts, use {@link moveNestedLayoutSectionItemAndRemoveOriginalSectionIfEmpty}.
+ *
  * @param sectionIndex - source section index
  * @param itemIndex - index of item to move
  * @param toSectionIndex - target section index; you may specify -1 to move to last section
@@ -13144,6 +13501,8 @@ export declare function moveSectionItem(sectionIndex: number, itemIndex: number,
  *  events that will be emitted during the command processing
  *
  * @beta
+ *
+ * TODO LX-648: Consider removing this command variant and leave only a nested variant
  */
 export declare function moveSectionItemAndRemoveOriginalSectionIfEmpty(sectionIndex: number, itemIndex: number, toSectionIndex: number, toItemIndex: number, correlationId?: string): MoveSectionItem;
 
@@ -13156,18 +13515,33 @@ export declare interface MoveSectionItemPayload {
      * Index of the section where the item to move is located.
      *
      * Index is zero-based.
+     *
+     * @remarks
+     * {@link MoveSectionItemPayload.sectionIndex} support will be removed in the next major SDK version. Use {@link MoveSectionItemPayload.fromPath} instead.
+     *
+     * TODO LX-648: Remove sectionIndex in the next major version.
      */
     readonly sectionIndex: number;
     /**
      * Index of section item that should be moved.
      *
      * Index is zero-based.
+     *
+     * @remarks
+     * {@link MoveSectionItemPayload.itemIndex} support will be removed in the next major SDK version. Use {@link MoveSectionItemPayload.fromPath} instead.
+     *
+     * TODO LX-648: Remove itemIndex in the next major version.
      */
     readonly itemIndex: number;
     /**
      * Index of section to which the item should be moved.
      *
      * Index is zero-based. For convenience you may specify -1 to move to last section.
+     *
+     * @remarks
+     * {@link MoveSectionItemPayload.toSectionIndex} support will be removed in the next major SDK version. Use {@link MoveSectionItemPayload.toPath} instead.
+     *
+     * TODO LX-648: Remove toSectionIndex in the next major version.
      */
     readonly toSectionIndex: RelativeIndex;
     /**
@@ -13175,8 +13549,29 @@ export declare interface MoveSectionItemPayload {
      *
      * Index is zero-based. For convenience you may specify -1 to append the item at the end of the target section's
      * items.
+     *
+     * @remarks
+     * {@link MoveSectionItemPayload.toItemIndex} support will be removed in the next major SDK version. Use {@link MoveSectionItemPayload.toPath} instead.
+     *
+     * TODO LX-648: Remove toItemIndex in the next major version.
      */
     readonly toItemIndex: RelativeIndex;
+    /**
+     * Path where the item to move is located.
+     *
+     * Index is zero-based.
+     *
+     * TODO LX-648: make the prop required
+     */
+    readonly fromPath?: ILayoutItemPath;
+    /**
+     * Path to which the item should be moved.
+     *
+     * Index is zero-based. For convenience, you may specify -1 to move to last section.
+     *
+     * TODO LX-648: make the prop required
+     */
+    readonly toPath?: ILayoutItemPath;
     /**
      * If true and original section stays empty after move, then it will be removed.
      */
@@ -13198,6 +13593,8 @@ export declare interface MoveSectionItemToNewSection extends IDashboardCommand {
  * Dispatching this command will result in move of single item within
  * section or from one section to another.
  *
+ * This command operates only on the root layout. For nested layouts, use {@link moveNestedLayoutSectionItemToNewSection}.
+ *
  * @param sectionIndex - source section index
  * @param itemIndex - index of item to move
  * @param toSectionIndex - target section index; you may specify -1 to move to last section
@@ -13205,6 +13602,8 @@ export declare interface MoveSectionItemToNewSection extends IDashboardCommand {
  *  events that will be emitted during the command processing
  *
  * @beta
+ *
+ * TODO LX-648: Consider removing this command variant and leave only a nested variant
  */
 export declare function moveSectionItemToNewSection(sectionIndex: number, itemIndex: number, toSectionIndex: number, correlationId?: string): MoveSectionItemToNewSection;
 
@@ -13215,6 +13614,8 @@ export declare function moveSectionItemToNewSection(sectionIndex: number, itemIn
  * Dispatching this command will result in move of single item within
  * section or from one section to another. If original section stays empty after move, then it will be removed.
  *
+ * This command operates only on the root layout. For nested layouts, use {@link moveNestedLayoutSectionItemToNewSectionAndRemoveOriginalSectionIfEmpty}.
+ *
  * @param sectionIndex - source section index
  * @param itemIndex - index of item to move
  * @param toSectionIndex - target section index; you may specify -1 to move to last section
@@ -13222,6 +13623,8 @@ export declare function moveSectionItemToNewSection(sectionIndex: number, itemIn
  *  events that will be emitted during the command processing
  *
  * @beta
+ *
+ * TODO LX-648: Consider removing this command variant and leave only a nested variant
  */
 export declare function moveSectionItemToNewSectionAndRemoveOriginalSectionIfEmpty(sectionIndex: number, itemIndex: number, toSectionIndex: number, correlationId?: string): MoveSectionItemToNewSection;
 
@@ -13234,26 +13637,60 @@ export declare interface MoveSectionItemToNewSectionPayload {
      * Index of the section where the item to move is located.
      *
      * Index is zero-based.
+     *
+     * @remarks
+     * {@link MoveSectionItemToNewSectionPayload.sectionIndex} support will be removed in the next major SDK version. Use {@link MoveSectionItemToNewSectionPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove sectionIndex in the next major version.
      */
     readonly sectionIndex: number;
     /**
      * Index of section item that should be moved.
      *
      * Index is zero-based.
+     *
+     * @remarks
+     * {@link MoveSectionItemToNewSectionPayload.itemIndex} support will be removed in the next major SDK version. Use {@link MoveSectionItemToNewSectionPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove itemIndex in the next major version.
      */
     readonly itemIndex: number;
     /**
      * Index of section to which should be created and the item should be moved into.
      *
      * Index is zero-based. For convenience you may specify -1 to move to last section.
+     *
+     * @remarks
+     * {@link MoveSectionItemToNewSectionPayload.toSectionIndex} support will be removed in the next major SDK version. Use {@link MoveSectionItemToNewSectionPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove toSectionIndex in the next major version.
      */
     readonly toSectionIndex: RelativeIndex;
+    /**
+     * Index where the item to move is located.
+     *
+     * TODO LX-648: make the prop required
+     */
+    readonly itemPath?: ILayoutItemPath;
+    /**
+     * Path of section that should be created and the item should be moved into.
+     *
+     * Index is zero-based. For convenience, you may specify -1 to move to last section.
+     *
+     * TODO LX-648: make the prop required
+     */
+    readonly toSection?: ILayoutSectionPath;
     /**
      * If true and original section stays empty after move, then it will be removed.
      */
     readonly removeOriginalSectionIfEmpty: boolean;
 }
 
+/**
+ * @beta
+ */
+export declare type NestedLayoutInteractionType = "nestedLayoutRemoved";
+
 /**
  * Creates a new custom widget.
  *
@@ -14446,6 +14883,8 @@ export declare interface RemoveLayoutSection extends IDashboardCommand {
  * section. You can optionally specify that the items in the section should not be physically removed but instead be
  * stashed for later 'resurrection'.
  *
+ * This command operates only on the root layout. For nested layouts, use {@link removeNestedLayoutSection}.
+ *
  * @param index - index of section to remove
  * @param stashIdentifier - specify identifier to stash items under; if you do not specify this, then the dashboard items in the removed section will also be removed
  * @param correlationId - specify correlation id to use for this command. this will be included in all
@@ -14464,8 +14903,13 @@ export declare interface RemoveLayoutSectionPayload {
      * Index of section to remove.
      *
      * Zero based. For convenience -1 can be used to remove the last section.
+     *
+     * @remarks
+     * {@link RelativeIndex} support will be removed in the next major SDK version. Use {@link ILayoutSectionPath} instead.
+     *
+     * TODO LX-648: Remove RelativeIndex type in the next major version.
      */
-    readonly index: RelativeIndex;
+    readonly index: RelativeIndex | ILayoutSectionPath;
     /**
      * Specify stash identifier.
      *
@@ -14479,6 +14923,42 @@ export declare interface RemoveLayoutSectionPayload {
     readonly stashIdentifier?: StashedDashboardItemsId;
 }
 
+/**
+ * Creates the RemoveLayoutSection command.
+ *
+ * @remarks
+ * Dispatching this command will result in removal of the entire dashboard
+ * section. You can optionally specify that the items in the section should not be physically removed but instead be
+ * stashed for later 'resurrection'.
+ *
+ * @param index - index of section to remove
+ * @param stashIdentifier - specify identifier to stash items under; if you do not specify this, then the dashboard items in the removed section will also be removed
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function removeNestedLayoutSection(index: ILayoutSectionPath, stashIdentifier?: StashedDashboardItemsId, correlationId?: string): RemoveLayoutSection;
+
+/**
+ * Creates the RemoveSectionItem command.
+ *
+ * @remarks
+ * Dispatching this command will result in removal
+ * of the item from a section. If the removed item was last in the section, the section will be left on the layout
+ * and will contain no items.
+ *
+ * You may optionally specify the stashIdentifier in order to stash the removed item for later resurrection.
+ *
+ * @param itemPath - index from which to remove the item
+ * @param stashIdentifier - stash identifier to store the removed item under; if not specified the item will be removed
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function removeNestedLayoutSectionItem(itemPath: ILayoutItemPath, stashIdentifier?: StashedDashboardItemsId, correlationId?: string): RemoveSectionItem;
+
 /**
  * @beta
  */
@@ -14497,6 +14977,8 @@ export declare interface RemoveSectionItem extends IDashboardCommand {
  *
  * You may optionally specify the stashIdentifier in order to stash the removed item for later resurrection.
  *
+ * This command operates only on the root layout. For nested layouts, use {@link removeNestedLayoutSectionItem}.
+ *
  * @param sectionIndex - index of section from which to remove the item
  * @param itemIndex - index of item to remove
  * @param stashIdentifier - stash identifier to store the removed item under; if not specified the item will be removed
@@ -14504,6 +14986,8 @@ export declare interface RemoveSectionItem extends IDashboardCommand {
  *  events that will be emitted during the command processing
  *
  * @beta
+ *
+ * TODO LX-648: Consider removing this command variant and leave only a nested variant
  */
 export declare function removeSectionItem(sectionIndex: number, itemIndex: number, stashIdentifier?: StashedDashboardItemsId, correlationId?: string): RemoveSectionItem;
 
@@ -14572,6 +15056,10 @@ export declare interface RemoveSectionItemPayload {
      *
      * @remarks
      * Index is zero-based.
+     *
+     * {@link RemoveSectionItemPayload.sectionIndex} support will be removed in the next major SDK version. Use {@link RemoveSectionItemPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove sectionIndex in the next major version.
      */
     readonly sectionIndex: number;
     /**
@@ -14579,8 +15067,21 @@ export declare interface RemoveSectionItemPayload {
      *
      * @remarks
      * Index is zero-based. For convenience you may use index of -1 to remove last item from section.
+     *
+     * {@link RemoveSectionItemPayload.itemIndex} support will be removed in the next major SDK version. Use {@link RemoveSectionItemPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove itemIndex in the next major version.
      */
     readonly itemIndex: RelativeIndex;
+    /**
+     * Index where the item to remove is located.
+     *
+     * @remarks
+     * Index is zero-based.
+     *
+     * TODO LX-648: make the prop required
+     */
+    readonly itemPath?: ILayoutItemPath;
     /**
      * Specify stash identifier.
      *
@@ -14740,6 +15241,23 @@ export declare function replaceKpiWidgetFilterSettings(ref: ObjRef, settings: Om
  */
 export declare function replaceKpiWidgetIgnoredFilters(ref: ObjRef, displayForms?: ObjRef[], correlationId?: string): ChangeKpiWidgetFilterSettings;
 
+/**
+ * Creates the ReplaceSectionItem command. Dispatching this command will result in replacement of particular dashboard
+ * item with a new item. By default, the old item will be discarded, however you may specify to stash it for later use.
+ *
+ * @param itemPath - path where the item to replace resides
+ * @param item - new item definition
+ * @param stashIdentifier - specify identifier of stash where the old item should be stored
+ * @param autoResolveDateFilterDataset - specify whether dashboard should auto-resolve date dataset
+ *  to use for date filtering of KPI or insight widget that is replacing the existing item; default is disabled
+ *  meaning date filtering will be enabled only for those KPI or Insight widgets that already specify dateDataset.
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function replaceNestedLayoutSectionItem(itemPath: ILayoutItemPath, item: DashboardItemDefinition, stashIdentifier?: StashedDashboardItemsId, autoResolveDateFilterDataset?: boolean, correlationId?: string): ReplaceSectionItem;
+
 /**
  * @beta
  */
@@ -14750,7 +15268,10 @@ export declare interface ReplaceSectionItem extends IDashboardCommand {
 
 /**
  * Creates the ReplaceSectionItem command. Dispatching this command will result in replacement of particular dashboard
- * item with a new item. By default the old item will be discarded, however you may specify to stash it for later use.
+ * item with a new item. By default, the old item will be discarded, however you may specify to stash it for later use.
+ *
+ * @remarks
+ * This command operates only on the root layout. For nested layouts, use {@link replaceNestedLayoutSectionItem}.
  *
  * @param sectionIndex - index of section where the item to replace resides
  * @param itemIndex - index of item within the section
@@ -14763,6 +15284,8 @@ export declare interface ReplaceSectionItem extends IDashboardCommand {
  *  events that will be emitted during the command processing
  *
  * @beta
+ *
+ * TODO LX-648: Consider removing this command variant and leave only a nested variant
  */
 export declare function replaceSectionItem(sectionIndex: number, itemIndex: number, item: DashboardItemDefinition, stashIdentifier?: StashedDashboardItemsId, autoResolveDateFilterDataset?: boolean, correlationId?: string): ReplaceSectionItem;
 
@@ -14773,12 +15296,28 @@ export declare function replaceSectionItem(sectionIndex: number, itemIndex: numb
 export declare interface ReplaceSectionItemPayload {
     /**
      * Index of section where the item to modify resides.
+     *
+     * @remarks
+     * {@link ReplaceSectionItemPayload.sectionIndex} support will be removed in the next major SDK version. Use {@link ReplaceSectionItemPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove sectionIndex in the next major version.
      */
     readonly sectionIndex: number;
     /**
      * Index of item within section that should be modified.
+     *
+     * @remarks
+     * {@link ReplaceSectionItemPayload.itemIndex} support will be removed in the next major SDK version. Use {@link ReplaceSectionItemPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove itemIndex in the next major version.
      */
     readonly itemIndex: number;
+    /**
+     * Index where the item to modify resides.
+     *
+     * TODO LX-648: make the prop required
+     */
+    readonly itemPath?: ILayoutItemPath;
     /**
      * New item definition.
      */
@@ -14902,6 +15441,9 @@ export declare interface ResizeHeight extends IDashboardCommand {
 /**
  * Creates the ResizeHeight command.
  *
+ * @remarks
+ * This command operates only on the root layout. For nested layouts, use {@link resizeNestedLayoutItemsHeight}.
+ *
  * @param sectionIndex - index of the section
  * @param itemIndexes - indexes of the items
  * @param height - height in Grid Rows (by default 1 Grid Row is 20px)
@@ -14921,8 +15463,13 @@ export declare interface ResizeHeightPayload {
      * Index of the section to resize.
      *
      * Index is zero-based.
+     *
+     * @remarks
+     * "number" support will be removed in the next major SDK version. Use {@link ILayoutSectionPath} instead.
+     *
+     * TODO LX-648: Remove number type in the next major version.
      */
-    readonly sectionIndex: number;
+    readonly sectionIndex: number | ILayoutSectionPath;
     /**
      * Indexes of the items to resize.
      *
@@ -14935,6 +15482,31 @@ export declare interface ResizeHeightPayload {
     readonly height: number;
 }
 
+/**
+ * Creates the ResizeHeight command.
+ *
+ * @param sectionIndex - index of the section
+ * @param itemIndexes - indexes of the items
+ * @param height - height in Grid Rows (by default 1 Grid Row is 20px)
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function resizeNestedLayoutItemsHeight(sectionIndex: ILayoutSectionPath, itemIndexes: number[], height: number, correlationId?: string): ResizeHeight;
+
+/**
+ * Creates the ResizeWidth command.
+ *
+ * @param itemPath - index of the section
+ * @param width - width in Grid Rows (by default 1 Grid Row is 20px)
+ * @param correlationId - specify correlation id to use for this command. this will be included in all
+ *  events that will be emitted during the command processing
+ *
+ * @alpha
+ */
+export declare function resizeNestedLayoutItemWidth(itemPath: ILayoutItemPath, width: number, correlationId?: string): ResizeWidth;
+
 /**
  * @beta
  */
@@ -14946,6 +15518,9 @@ export declare interface ResizeWidth extends IDashboardCommand {
 /**
  * Creates the ResizeWidth command.
  *
+ * @remarks
+ * This command operates only on the root layout. For nested layouts, use {@link resizeNestedLayoutItemWidth}.
+ *
  * @param sectionIndex - index of the section
  * @param itemIndex - index of the item
  * @param width - width in Grid Rows (by default 1 Grid Row is 20px)
@@ -14953,6 +15528,8 @@ export declare interface ResizeWidth extends IDashboardCommand {
  *  events that will be emitted during the command processing
  *
  * @beta
+ *
+ * TODO LX-648: Consider removing this command variant and leave only a nested variant
  */
 export declare function resizeWidth(sectionIndex: number, itemIndex: number, width: number, correlationId?: string): ResizeWidth;
 
@@ -14965,14 +15542,32 @@ export declare interface ResizeWidthPayload {
      * Index of the section to resize.
      *
      * Index is zero-based.
+     *
+     * @remarks
+     * {@link ResizeWidthPayload.sectionIndex} support will be removed in the next major SDK version. Use {@link ResizeWidthPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove sectionIndex in the next major version.
      */
     readonly sectionIndex: number;
     /**
      * Indexes of the item to resize.
      *
      * Index is zero-based.
+     *
+     * @remarks
+     * {@link ResizeWidthPayload.itemIndex} support will be removed in the next major SDK version. Use {@link ResizeWidthPayload.itemPath} instead.
+     *
+     * TODO LX-648: Remove itemIndex in the next major version.
      */
     readonly itemIndex: number;
+    /**
+     * Index of the item to resize.
+     *
+     * Index is zero-based.
+     *
+     * TODO LX-648: make the prop required
+     */
+    readonly itemPath?: ILayoutItemPath;
     /**
      * width to resize.
      */
@@ -15387,7 +15982,20 @@ export declare const selectAccessibleDashboards: (state: DashboardState) => ILis
 export declare const selectAccessibleDashboardsMap: DashboardSelector<ObjRefMap<IListedDashboard>>;
 
 /**
+ * The selector returns layout path of active section.
+ *
+ * @internal
+ */
+export declare const selectActiveSection: DashboardSelector<ILayoutSectionPath | undefined>;
+
+/**
+ * The selector returns index of active section.
+ *
  * @internal
+ * @deprecated The selector returns index in its parent section layout. The information is not useful on its
+ *  own when dashboard uses nested layout. For this case use {@link selectActiveSection} instead.
+ *
+ *  TODO LX-648: remove this selector, exported only for backward compatible reasons.
  */
 export declare const selectActiveSectionIndex: DashboardSelector<number | undefined>;
 
@@ -16286,9 +16894,19 @@ export declare const selectDraggingWidgetSource: DashboardSelector<DraggableLayo
 
 /**
  * @internal
+ *
+ * @deprecated The selector returns coordinates in its parent section layout. The information is not useful on its
+ *  own when dashboard uses nested layout. For this case use {@link selectDraggingWidgetTargetLayoutPath} instead.
+ *
+ *  TODO LX-648: remove this selector, exported only for backward compatible reasons.
  */
 export declare const selectDraggingWidgetTarget: DashboardSelector<ILayoutCoordinates | undefined>;
 
+/**
+ * @internal
+ */
+export declare const selectDraggingWidgetTargetLayoutPath: DashboardSelector<ILayoutItemPath | undefined>;
+
 /**
  * Returns drillable items that are currently set.
  *
@@ -16937,9 +17555,19 @@ export declare const selectInsightWidgetPlaceholder: DashboardSelector<ExtendedD
 
 /**
  * @internal
+ *
+ * @deprecated The selector returns coordinates in its parent layout. The information is not useful on its
+ *  own when dashboard uses nested layout. For this case use {@link selectInsightWidgetPlaceholderPath} instead.
+ *
+ *  TODO LX-648: remove this selector, exported only for backward compatible reasons.
  */
 export declare const selectInsightWidgetPlaceholderCoordinates: DashboardSelector<ILayoutCoordinates | undefined>;
 
+/**
+ * @internal
+ */
+export declare const selectInsightWidgetPlaceholderPath: DashboardSelector<ILayoutItemPath | undefined>;
+
 /**
  * @internal
  */
@@ -17267,9 +17895,19 @@ export declare const selectIsWidgetLoadingAdditionalDataByWidgetRef: (refs: ObjR
 
 /**
  * @internal
+ *
+ * @deprecated The selector returns coordinates in its parent layout. The information is not useful on its
+ *  own when dashboard uses nested layout. For this case use {@link selectKpiDeleteDialogWidgetLayoutPath} instead.
+ *
+ *  TODO LX-648: remove this selector, exported only for backward compatible reasons.
  */
 export declare const selectKpiDeleteDialogWidgetCoordinates: DashboardSelector<ILayoutCoordinates | undefined>;
 
+/**
+ * @internal
+ */
+export declare const selectKpiDeleteDialogWidgetLayoutPath: DashboardSelector<ILayoutItemPath | undefined>;
+
 /**
  * @internal
  */
@@ -17277,9 +17915,19 @@ export declare const selectKpiWidgetPlaceholder: DashboardSelector<ExtendedDashb
 
 /**
  * @internal
+ *
+ * @deprecated The selector returns coordinates in its parent layout. The information is not useful on its
+ *  own when dashboard uses nested layout. For this case use {@link selectKpiWidgetPlaceholderPath} instead.
+ *
+ *  TODO LX-648: remove this selector, exported only for backward compatible reasons.
  */
 export declare const selectKpiWidgetPlaceholderCoordinates: DashboardSelector<ILayoutCoordinates | undefined>;
 
+/**
+ * @internal
+ */
+export declare const selectKpiWidgetPlaceholderPath: DashboardSelector<ILayoutItemPath | undefined>;
+
 /**
  * This selector returns dashboard's layout. It is expected that the selector is called only after the layout state
  * is correctly initialized. Invocations before initialization lead to invariant errors.
@@ -17636,6 +18284,11 @@ export declare const selectWidgetByRef: (ref: ObjRef | undefined) => DashboardSe
  * Selects layout coordinates for a given widget.
  *
  * @alpha
+ *
+ * @deprecated The selector returns coordinates in its parent layout. The information is not useful on its
+ *  own when dashboard uses nested layout. For this case use {@link selectWidgetPathByRef} instead.
+ *
+ *  TODO LX-648: remove this selector, exported only for backward compatible reasons.
  */
 export declare const selectWidgetCoordinatesByRef: (ref: ObjRef) => DashboardSelector<ILayoutCoordinates>;
 
@@ -17656,6 +18309,13 @@ export declare const selectWidgetDeleteDialogWidgetRef: DashboardSelector<ObjRef
  */
 export declare const selectWidgetDrills: (ref: ObjRef | undefined) => DashboardSelector<IDrillToLegacyDashboard[] | InsightDrillDefinition[] | DrillDefinition[]>;
 
+/**
+ * Selects layout path for a given widget.
+ *
+ * @alpha
+ */
+export declare const selectWidgetPathByRef: (ref: ObjRef) => DashboardSelector<ILayoutItemPath>;
+
 /**
  * @internal
  */
@@ -17663,9 +18323,19 @@ export declare const selectWidgetPlaceholder: DashboardSelector<ExtendedDashboar
 
 /**
  * @internal
+ *
+ * @deprecated The selector returns coordinates in its parent layout. The information is not useful on its
+ *  own when dashboard uses nested layout. For this case use {@link selectWidgetPlaceholderPath} instead.
+ *
+ *  TODO LX-648: remove this selector, exported only for backward compatible reasons.
  */
 export declare const selectWidgetPlaceholderCoordinates: DashboardSelector<ILayoutCoordinates | undefined>;
 
+/**
+ * @internal
+ */
+export declare const selectWidgetPlaceholderPath: DashboardSelector<ILayoutItemPath | undefined>;
+
 /**
  * Selects dashboard widgets in an obj ref an array. This map will include both analytical and custom
  * widgets that are placed on the dashboard and also all widgets from visualization switchers
@@ -18404,7 +19074,7 @@ closeShareDialog: (state: WritableDraft<UiState_2>, action: AnyAction) => void |
 openDeleteDialog: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
 closeDeleteDialog: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
 openKpiDeleteDialog: (state: WritableDraft<UiState_2>, action: {
-payload: ILayoutCoordinates_2;
+payload: ILayoutItemPath_2;
 type: string;
 }) => void | UiState_2 | WritableDraft<UiState_2>;
 closeKpiDeleteDialog: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
@@ -18443,11 +19113,11 @@ payload: number;
 type: string;
 }) => void | UiState_2 | WritableDraft<UiState_2>;
 clearFilterIndexSelection: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
-setActiveSectionIndex: (state: WritableDraft<UiState_2>, action: {
-payload: number;
+setActiveSection: (state: WritableDraft<UiState_2>, action: {
+payload: ILayoutSectionPath_2;
 type: string;
 }) => void | UiState_2 | WritableDraft<UiState_2>;
-clearActiveSectionIndex: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
+clearActiveSection: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
 openCancelEditModeDialog: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
 closeCancelEditModeDialog: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
 resetInvalidDrillWidgetRefs: (state: WritableDraft<UiState_2>, action: AnyAction) => void | UiState_2 | WritableDraft<UiState_2>;
@@ -18481,7 +19151,7 @@ payload: void;
 type: string;
 }) => void | UiState_2 | WritableDraft<UiState_2>;
 setDraggingWidgetTarget: (state: WritableDraft<UiState_2>, action: {
-payload: ILayoutCoordinates_2;
+payload: ILayoutItemPath_2;
 type: string;
 }) => void | UiState_2 | WritableDraft<UiState_2>;
 clearDraggingWidgetTarget: (state: WritableDraft<UiState_2>, action: {
@@ -18554,7 +19224,7 @@ export declare interface UiState {
         /**
          * Undefined means the dialog should be closed
          */
-        widgetCoordinates: ILayoutCoordinates | undefined;
+        widgetCoordinates: ILayoutItemPath | undefined;
     };
     cancelEditModeDialog: {
         open: boolean;
@@ -18576,7 +19246,7 @@ export declare interface UiState {
     widgetsLoadingAdditionalData: ObjRef[];
     filterAttributeSelectionOpen: boolean;
     selectedFilterIndex: number | undefined;
-    activeSectionIndex: number | undefined;
+    activeSection: ILayoutSectionPath | undefined;
     /** @alpha */
     drillValidationMessages: {
         invalidDrillWidgetRefs: ObjRef[];
@@ -18584,7 +19254,7 @@ export declare interface UiState {
     };
     /** @internal */
     draggingWidgetSource: DraggableLayoutItem | undefined;
-    draggingWidgetTarget: ILayoutCoordinates | undefined;
+    draggingWidgetTarget: ILayoutItemPath | undefined;
     widgetsOverlay: Record<string, IDashboardWidgetOverlay>;
 }
 
@@ -19413,6 +20083,7 @@ export declare const useDashboardUserInteraction: () => {
     visualizationSwitcherInteraction: (eventType: VisualizationSwitcherInteractionType) => void;
     automationInteraction: (eventData: AutomationInteractionData) => void;
     savedFilterViewInteraction: (eventData: SavedFilterViewInteractionData) => void;
+    nestedLayoutInteraction: (eventType: NestedLayoutInteractionType) => void;
 };
 
 /**
@@ -19886,6 +20557,7 @@ export declare interface WidthResizerDragItem {
     type: "internal-width-resizer";
     sectionIndex: number;
     itemIndex: number;
+    layoutPath?: ILayoutItemPath;
     gridColumnWidth: number;
     gridColumnHeightInPx: number;
     currentWidth: number;