@gooddata/sdk-ui-dashboard 10.19.0-alpha.16 → 10.19.0-alpha.18

package/esm/__version.d.ts

@@ -1,2 +1,2 @@
-export declare const LIB_VERSION = "10.19.0-alpha.16";
+export declare const LIB_VERSION = "10.19.0-alpha.18";
 //# sourceMappingURL=__version.d.ts.map

package/esm/__version.js

@@ -1,4 +1,4 @@
 // (C) 2021 GoodData Corporation
 // DO NOT CHANGE THIS FILE, IT IS RE-GENERATED ON EVERY BUILD
-export const LIB_VERSION = "10.19.0-alpha.16";
+export const LIB_VERSION = "10.19.0-alpha.18";
 //# sourceMappingURL=__version.js.map

package/esm/_staging/dashboard/flexibleLayout/builder/interfaces.d.ts

@@ -1,6 +1,7 @@
 import { ObjRef, IDashboardLayout, IDashboardWidget, IDashboardLayoutSection, IDashboardLayoutSectionHeader, IDashboardLayoutSize, IDashboardLayoutSizeByScreenSize, IDashboardLayoutItem } from "@gooddata/sdk-model";
 import { InsightWidgetBuilder, KpiWidgetBuilder, ValueOrUpdateCallback } from "@gooddata/sdk-backend-base";
 import { IDashboardLayoutFacade, IDashboardLayoutItemFacade, IDashboardLayoutItemsFacade, IDashboardLayoutSectionFacade, IDashboardLayoutSectionsFacade } from "../facade/interfaces.js";
+import { ILayoutItemPath, ILayoutSectionPath } from "../../../../types.js";
 /**
  * Represents a query to select a subset of layout sections.
  *
@@ -125,6 +126,14 @@ export interface IDashboardLayoutItemBuilder<TWidget = IDashboardWidget> {
      * @param modify - callback to modify the widget
      */
     modifyKpiWidget(modify: (builder: KpiWidgetBuilder) => KpiWidgetBuilder): this;
+    /**
+     * Modify existing layout widget in this item.
+     *
+     * Note: When the item doesn't contain a layout widget, the error is thrown.
+     *
+     * @param modify - callback to modify the widget
+     */
+    modifyLayoutWidget(modify: (builder: IDashboardLayoutBuilder<TWidget>) => IDashboardLayoutBuilder<TWidget>, dashboardLayoutBuilderConstructor: (layout: IDashboardLayout<TWidget>, layoutPath?: ILayoutItemPath) => IDashboardLayoutBuilder<TWidget>): this;
 }
 /**
  * Builder for convenient creation or transformation of any {@link @gooddata/sdk-backend-spi#IDashboardLayoutRow}.
@@ -309,6 +318,22 @@ export interface IDashboardLayoutBuilder<TWidget = IDashboardWidget> {
      * @returns this
      */
     createSection(create?: (builder: IDashboardLayoutSectionBuilder<TWidget>) => IDashboardLayoutSectionBuilder<TWidget>, index?: number): this;
+    /**
+     * Creates a new section and adds it to a layout.
+     *
+     * Note:
+     * - This operation is non-invasive, it cannot replace an existing section.
+     *   This means that if there is already an existing section on the specified index,
+     *   this and all subsequent sections will be moved after the added section.
+     *   If you want to replace an existing section use .modifySection() or .modifySections() method instead.
+     *
+     * - When no create callback is provided, an empty section is added
+     *
+     * @param create - callback to create the section
+     * @param sectionPath - path in layout where to place the section
+     * @returns this
+     */
+    createSection(create?: (builder: IDashboardLayoutSectionBuilder<TWidget>) => IDashboardLayoutSectionBuilder<TWidget>, sectionPath?: ILayoutSectionPath): this;
     /**
      * Adds a new section to a layout.
      *
@@ -325,6 +350,20 @@ export interface IDashboardLayoutBuilder<TWidget = IDashboardWidget> {
      * @returns this
      */
     addSection(section: IDashboardLayoutSection<TWidget>, index?: number): this;
+    /**
+     * Adds a new section to a layout.
+     *
+     * Note:
+     * - This operation is non-invasive, it cannot replace an existing section.
+     *   This means that if there is already an existing section on the specified index,
+     *   this and all subsequent sections will be moved after the added section.
+     *   If you want to replace an existing section use .modifySection() or .modifySections() method instead.
+     *
+     * @param section - section to add
+     * @param sectionPath - path where to place the section
+     * @returns this
+     */
+    addSection(section: IDashboardLayoutSection<TWidget>, sectionPath: ILayoutSectionPath): this;
     /**
      * Modify section at a specified index.
      *
@@ -338,6 +377,19 @@ export interface IDashboardLayoutBuilder<TWidget = IDashboardWidget> {
      * @returns this
      */
     modifySection(index: number, modify: DashboardLayoutSectionModifications<TWidget>): this;
+    /**
+     * Modify section at a specified path.
+     *
+     * Note:
+     * - If the section does not exist at the specified index, the error is thrown.
+     *   Do this only when you are sure about the section index, or use .modifySections() method instead,
+     *   which allows you to select the sections according to your predicate and does nothing if it is not met.
+     *
+     * @param sectionPath - section path
+     * @param modify - callback to modify the section
+     * @returns this
+     */
+    modifySection(sectionPath: ILayoutSectionPath, modify: DashboardLayoutSectionModifications<TWidget>): this;
     /**
      * Remove the section at a specified index.
      *
@@ -350,6 +402,18 @@ export interface IDashboardLayoutBuilder<TWidget = IDashboardWidget> {
      * @returns this
      */
     removeSection(index: number): this;
+    /**
+     * Remove the section at a specified path.
+     *
+     * Note:
+     * - If the section does not exist at the specified index, the error is thrown.
+     *   Do this only when you are sure about the section index, or use .removeSections() method instead,
+     *   which allows you to select the sections according to your predicate and does nothing if it is not met.
+     *
+     * @param sectionPath - the path of the section to remove
+     * @returns this
+     */
+    removeSection(sectionPath: ILayoutSectionPath): this;
     /**
      * Move section from a specified index to a target index.
      *
@@ -366,11 +430,26 @@ export interface IDashboardLayoutBuilder<TWidget = IDashboardWidget> {
      * @returns this
      */
     moveSection(fromIndex: number, toIndex: number): this;
+    /**
+     * Move section from a specified path to a target path.
+     *
+     * Note:
+     * - If the section does not exist at the specified path, the error is thrown.
+     * - This operation is non-invasive, it cannot replace an existing section.
+     *   This means that if there is already an existing section at the target path,
+     *   this and all subsequent sections will be moved after the added section.
+     *
+     * @param fromPath - the path of the section to move
+     * @param toPath - the target path where the section will be moved
+     * @returns this
+     */
+    moveSection(fromPath: ILayoutSectionPath, toPath: ILayoutSectionPath): this;
     /**
      * Perform modifications for the selected section(s).
      * This is useful to perform a set of transformations for sections selected by any predicate.
      * Usually, you want to use .filter() and or .find() for the selector,
      * but it's really flexible and you can select any subset of the sections.
+     * Works only in root of this layout. Any nested layouts are not affected.
      *
      * Note:
      * - When no selector is provided, all sections are selected by default.
@@ -387,6 +466,7 @@ export interface IDashboardLayoutBuilder<TWidget = IDashboardWidget> {
      * This is useful to remove sections selected by any predicate.
      * Usually, you want to use .filter() and or .find() for the selector,
      * but it's really flexible and you can select any subset of the sections.
+     * Works only in root of this layout. Any nested layouts are not affected.
      *
      * Note:
      * - When no selector is provided, all sections are selected by default (and therefore removed).
@@ -399,6 +479,7 @@ export interface IDashboardLayoutBuilder<TWidget = IDashboardWidget> {
     removeSections(selector?: DashboardLayoutSectionsSelector<TWidget>): this;
     /**
      * Remove all empty sections.
+     * Works only in root of this layout. Any nested layouts are not affected.
      *
      * @returns this
      */

package/esm/_staging/dashboard/flexibleLayout/builder/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../../src/_staging/dashboard/flexibleLayout/builder/interfaces.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../../src/_staging/dashboard/flexibleLayout/builder/interfaces.ts"],"names":[],"mappings":"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"}

package/esm/_staging/dashboard/flexibleLayout/builder/item.d.ts

@@ -1,9 +1,9 @@
-import { DashboardLayoutItemModifications, IDashboardLayoutItemBuilder, IDashboardLayoutSectionBuilder } from "./interfaces.js";
+import { DashboardLayoutItemModifications, IDashboardLayoutItemBuilder, IDashboardLayoutSectionBuilder, IDashboardLayoutBuilder } from "./interfaces.js";
 import { IDashboardLayoutItemFacade } from "../facade/interfaces.js";
 import { InsightWidgetBuilder, KpiWidgetBuilder, ValueOrUpdateCallback } from "@gooddata/sdk-backend-base";
-import { ObjRef, IDashboardLayoutSection, IDashboardLayoutSizeByScreenSize, IDashboardLayoutItem } from "@gooddata/sdk-model";
+import { ObjRef, IDashboardLayoutSection, IDashboardLayoutSizeByScreenSize, IDashboardLayoutItem, IDashboardLayout } from "@gooddata/sdk-model";
+import { ILayoutItemPath } from "../../../../types.js";
 /**
- * TODO LX-603: rewrite to support nested layouts
  * @alpha
  */
 export declare class DashboardLayoutItemBuilder<TWidget> implements IDashboardLayoutItemBuilder<TWidget> {
@@ -28,5 +28,6 @@ export declare class DashboardLayoutItemBuilder<TWidget> implements IDashboardLa
     modifyInsightWidget(modify: (builder: InsightWidgetBuilder) => InsightWidgetBuilder): this;
     newKpiWidget(measure: ObjRef, create?: (builder: KpiWidgetBuilder) => KpiWidgetBuilder): this;
     modifyKpiWidget(modify: (builder: KpiWidgetBuilder) => KpiWidgetBuilder): this;
+    modifyLayoutWidget(modify: (builder: IDashboardLayoutBuilder<TWidget>) => IDashboardLayoutBuilder<TWidget>, dashboardLayoutBuilderConstructor: (layout: IDashboardLayout<TWidget>, layoutPath?: ILayoutItemPath) => IDashboardLayoutBuilder<TWidget>): this;
 }
 //# sourceMappingURL=item.d.ts.map

package/esm/_staging/dashboard/flexibleLayout/builder/item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../../../../src/_staging/dashboard/flexibleLayout/builder/item.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,EACjC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAEhB,qBAAqB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,MAAM,EAKN,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EAEvB,MAAM,qBAAqB,CAAC;AAG7B;;;GAGG;AACH,qBAAa,0BAA0B,CAAC,OAAO,CAAE,YAAW,2BAA2B,CAAC,OAAO,CAAC;IAExF,SAAS,CAAC,UAAU,EAAE,CAClB,qBAAqB,EAAE,qBAAqB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,KAC7E,IAAI;IACT,SAAS,CAAC,aAAa,EAAE,MAAM,0BAA0B,CAAC,OAAO,CAAC;IAClE,SAAS,CAAC,SAAS,EAAE,MAAM;IAL/B,SAAS,aACK,UAAU,EAAE,CAClB,qBAAqB,EAAE,qBAAqB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,KAC7E,IAAI,EACC,aAAa,EAAE,MAAM,0BAA0B,CAAC,OAAO,CAAC,EACxD,SAAS,EAAE,MAAM;IAG/B;;;;;OAKG;WACW,GAAG,CAAC,OAAO,EACrB,cAAc,EAAE,8BAA8B,CAAC,OAAO,CAAC,EACvD,SAAS,EAAE,MAAM,GAClB,2BAA2B,CAAC,OAAO,CAAC;IAchC,IAAI,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,gCAAgC,CAAC,GAAG,IAAI;IAQ1F,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,IAAI;IAQ/E,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI;IAY1F,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE,KAAK,IAAI,oBAAoB,CAAC,OAAO,CAAC;IAItC,MAAM,IAAI,0BAA0B,CAAC,OAAO,CAAC;IAI7C,gBAAgB,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,oBAA+B,GAC3E,IAAI;IAKA,mBAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,oBAAoB,GAAG,IAAI;IAU1F,YAAY,CACf,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,gBAA2B,GACnE,IAAI;IAKA,eAAe,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,IAAI;CASxF"}
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../../../../src/_staging/dashboard/flexibleLayout/builder/item.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,EAC9B,uBAAuB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAEhB,qBAAqB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,MAAM,EAKN,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EAGpB,gBAAgB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,qBAAa,0BAA0B,CAAC,OAAO,CAAE,YAAW,2BAA2B,CAAC,OAAO,CAAC;IAExF,SAAS,CAAC,UAAU,EAAE,CAClB,qBAAqB,EAAE,qBAAqB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,KAC7E,IAAI;IACT,SAAS,CAAC,aAAa,EAAE,MAAM,0BAA0B,CAAC,OAAO,CAAC;IAClE,SAAS,CAAC,SAAS,EAAE,MAAM;IAL/B,SAAS,aACK,UAAU,EAAE,CAClB,qBAAqB,EAAE,qBAAqB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,KAC7E,IAAI,EACC,aAAa,EAAE,MAAM,0BAA0B,CAAC,OAAO,CAAC,EACxD,SAAS,EAAE,MAAM;IAG/B;;;;;OAKG;WACW,GAAG,CAAC,OAAO,EACrB,cAAc,EAAE,8BAA8B,CAAC,OAAO,CAAC,EACvD,SAAS,EAAE,MAAM,GAClB,2BAA2B,CAAC,OAAO,CAAC;IAchC,IAAI,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,gCAAgC,CAAC,GAAG,IAAI;IAQ1F,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,IAAI;IAQ/E,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI;IAY1F,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE,KAAK,IAAI,oBAAoB,CAAC,OAAO,CAAC;IAItC,MAAM,IAAI,0BAA0B,CAAC,OAAO,CAAC;IAI7C,gBAAgB,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,oBAA+B,GAC3E,IAAI;IAKA,mBAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,oBAAoB,GAAG,IAAI;IAU1F,YAAY,CACf,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,gBAA2B,GACnE,IAAI;IAKA,eAAe,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,IAAI;IAW9E,kBAAkB,CACrB,MAAM,EAAE,CAAC,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,KAAK,uBAAuB,CAAC,OAAO,CAAC,EACvF,iCAAiC,EAAE,CAC/B,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACjC,UAAU,CAAC,EAAE,eAAe,KAC3B,uBAAuB,CAAC,OAAO,CAAC,GACtC,IAAI;CAQV"}

package/esm/_staging/dashboard/flexibleLayout/builder/item.js

@@ -1,10 +1,9 @@
-// (C) 2019-2024 GoodData Corporation
+// (C) 2019-2025 GoodData Corporation
 import { invariant } from "ts-invariant";
 import { InsightWidgetBuilder, KpiWidgetBuilder, resolveValueOrUpdateCallback, } from "@gooddata/sdk-backend-base";
-import { isKpiWidgetDefinition, isKpiWidget, isInsightWidgetDefinition, isInsightWidget, isDashboardLayoutItem, } from "@gooddata/sdk-model";
+import { isKpiWidgetDefinition, isKpiWidget, isInsightWidgetDefinition, isInsightWidget, isDashboardLayoutItem, isDashboardLayout, } from "@gooddata/sdk-model";
 import identity from "lodash/identity.js";
 /**
- * TODO LX-603: rewrite to support nested layouts
  * @alpha
  */
 export class DashboardLayoutItemBuilder {
@@ -80,7 +79,16 @@ export class DashboardLayoutItemBuilder {
     modifyKpiWidget(modify) {
         const content = this.facade().widget();
         invariant(isKpiWidgetDefinition(content) || isKpiWidget(content), "Content of the item is not a kpi widget.");
-        this.widget(modify(KpiWidgetBuilder.for(content)).build());
+        const builder = KpiWidgetBuilder.for(content);
+        this.widget(modify(builder).build());
+        return this;
+    }
+    modifyLayoutWidget(modify, dashboardLayoutBuilderConstructor) {
+        const content = this.facade().widget();
+        invariant(isDashboardLayout(content), "Content of the item is not a layout widget.");
+        const itemPath = this.getItemFacade().index();
+        const builder = dashboardLayoutBuilderConstructor(content, itemPath);
+        this.widget(modify(builder).build());
         return this;
     }
 }

package/esm/_staging/dashboard/flexibleLayout/builder/item.js.map

@@ -1 +1 @@
-{"version":3,"file":"item.js","sourceRoot":"","sources":["../../../../../src/_staging/dashboard/flexibleLayout/builder/item.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"item.js","sourceRoot":"","sources":["../../../../../src/_staging/dashboard/flexibleLayout/builder/item.ts"],"names":[],"mappings":"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"}

package/esm/_staging/dashboard/flexibleLayout/builder/layout.d.ts

@@ -1,10 +1,9 @@
 import { IDashboardLayout, IDashboardLayoutSection, IDashboardLayoutSize } from "@gooddata/sdk-model";
-import { DashboardLayoutModifications, DashboardLayoutSectionModifications, DashboardLayoutSectionsSelector, IDashboardLayoutBuilder } from "./interfaces.js";
+import { DashboardLayoutModifications, DashboardLayoutSectionModifications, DashboardLayoutSectionsSelector, IDashboardLayoutBuilder, IDashboardLayoutSectionBuilder } from "./interfaces.js";
 import { IDashboardLayoutFacade } from "../facade/interfaces.js";
 import { ValueOrUpdateCallback } from "@gooddata/sdk-backend-base";
-import { ILayoutItemPath } from "../../../../types.js";
+import { ILayoutItemPath, ILayoutSectionPath } from "../../../../types.js";
 /**
- * TODO LX-603: rewrite to support nested layouts
  * @alpha
  */
 export declare class DashboardLayoutBuilder<TWidget> implements IDashboardLayoutBuilder<TWidget> {
@@ -16,19 +15,24 @@ export declare class DashboardLayoutBuilder<TWidget> implements IDashboardLayout
      *
      * @param layout - layout to modify
      */
-    static for<TWidget>(layout: IDashboardLayout<TWidget>, layoutPath?: ILayoutItemPath): IDashboardLayoutBuilder<TWidget>;
+    static for<TWidget>(layout: IDashboardLayout<TWidget>, layoutPath?: ILayoutItemPath): DashboardLayoutBuilder<TWidget>;
     /**
      * Creates an instance of DashboardLayoutBuilder with empty layout.
      *
      * @param layoutPath - layout path in case of nested layout
      */
-    static forNewLayout<TWidget>(layoutPath: ILayoutItemPath | undefined): IDashboardLayoutBuilder<TWidget>;
+    static forNewLayout<TWidget>(layoutPath?: ILayoutItemPath): IDashboardLayoutBuilder<TWidget>;
     size(valueOrUpdateCallback: ValueOrUpdateCallback<IDashboardLayoutSize | undefined>): this;
-    createSection(create?: DashboardLayoutSectionModifications<TWidget>, index?: number): this;
-    addSection(section: IDashboardLayoutSection<TWidget>, index?: number): this;
-    modifySection(index: number, modify: DashboardLayoutSectionModifications<TWidget>): this;
-    removeSection(index: number): this;
-    moveSection(fromIndex: number, toIndex: number): this;
+    createSection(create?: (builder: IDashboardLayoutSectionBuilder<TWidget>) => IDashboardLayoutSectionBuilder<TWidget>, indexOrPath?: number | ILayoutSectionPath): this;
+    private createSectionByPath;
+    addSection(section: IDashboardLayoutSection<TWidget>, indexOrPath: number | ILayoutSectionPath | undefined): this;
+    private addSectionByPath;
+    modifySection(indexOrPath: number | ILayoutSectionPath, modify: DashboardLayoutSectionModifications<TWidget>): this;
+    private modifySectionByPath;
+    removeSection(indexOrPath: number | ILayoutSectionPath): this;
+    private removeSectionByPath;
+    moveSection(fromIndexOrPath: number | ILayoutSectionPath, toIndexOrPath: number | ILayoutSectionPath): this;
+    private moveSectionByPath;
     removeSections(selector?: DashboardLayoutSectionsSelector<TWidget>): this;
     removeEmptySections(): this;
     modifySections(modify: DashboardLayoutSectionModifications<TWidget>, selector?: DashboardLayoutSectionsSelector<TWidget>): this;

package/esm/_staging/dashboard/flexibleLayout/builder/layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../src/_staging/dashboard/flexibleLayout/builder/layout.ts"],"names":[],"mappings":"AACA,OAAO,EACH,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EAEvB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACH,4BAA4B,EAC5B,mCAAmC,EACnC,+BAA+B,EAC/B,uBAAuB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,OAAO,EAAgC,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEjG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,qBAAa,sBAAsB,CAAC,OAAO,CAAE,YAAW,uBAAuB,CAAC,OAAO,CAAC;IAEhF,SAAS,CAAC,YAAY,EAAE,sBAAsB,CAAC,OAAO,CAAC;IACvD,SAAS,CAAC,uBAAuB,EAAE,CAC/B,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACjC,UAAU,EAAE,eAAe,GAAG,SAAS,KACtC,sBAAsB,CAAC,OAAO,CAAC;IALxC,SAAS,aACK,YAAY,EAAE,sBAAsB,CAAC,OAAO,CAAC,EAC7C,uBAAuB,EAAE,CAC/B,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACjC,UAAU,EAAE,eAAe,GAAG,SAAS,KACtC,sBAAsB,CAAC,OAAO,CAAC;IAGxC;;;;OAIG;WACW,GAAG,CAAC,OAAO,EACrB,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACjC,UAAU,CAAC,EAAE,eAAe,GAC7B,uBAAuB,CAAC,OAAO,CAAC;IAUnC;;;;OAIG;WACW,YAAY,CAAC,OAAO,EAC9B,UAAU,EAAE,eAAe,GAAG,SAAS,GACxC,uBAAuB,CAAC,OAAO,CAAC;IAQ5B,IAAI,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,oBAAoB,GAAG,SAAS,CAAC,GAAG,IAAI;IAO1F,aAAa,CAChB,MAAM,GAAE,mCAAmC,CAAC,OAAO,CAAY,EAC/D,KAAK,GAAE,MAAyC,GACjD,IAAI;IAiBA,UAAU,CACb,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,EACzC,KAAK,GAAE,MAAyC,GACjD,IAAI;IAaA,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mCAAmC,CAAC,OAAO,CAAC,GAAG,IAAI;IAQxF,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAclC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAarD,cAAc,CACjB,QAAQ,GAAE,+BAA+B,CAAC,OAAO,CAAgC,GAClF,IAAI;IAoBA,mBAAmB,IAAI,IAAI;IAI3B,cAAc,CACjB,MAAM,EAAE,mCAAmC,CAAC,OAAO,CAAC,EACpD,QAAQ,GAAE,+BAA+B,CAAC,OAAO,CAAgC,GAClF,IAAI;IAcA,SAAS,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI;IAOxF,MAAM,IAAI,sBAAsB,CAAC,OAAO,CAAC;IAIzC,MAAM,CAAC,aAAa,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAAG,IAAI;IAKlE,KAAK,IAAI,gBAAgB,CAAC,OAAO,CAAC;CAG5C"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../src/_staging/dashboard/flexibleLayout/builder/layout.ts"],"names":[],"mappings":"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"}

package/esm/_staging/dashboard/flexibleLayout/builder/layout.js

@@ -1,4 +1,4 @@
-// (C) 2019-2024 GoodData Corporation
+// (C) 2019-2025 GoodData Corporation
 import { isDashboardLayout, } from "@gooddata/sdk-model";
 import { invariant } from "ts-invariant";
 import difference from "lodash/difference.js";
@@ -8,8 +8,8 @@ import { DashboardLayoutFacade } from "../facade/layout.js";
 import { DashboardLayoutSectionBuilder } from "./section.js";
 import { resolveValueOrUpdateCallback } from "@gooddata/sdk-backend-base";
 import { getSectionIndex } from "../../../layout/coordinates.js";
+import { DashboardLayoutItemBuilder } from "./item.js";
 /**
- * TODO LX-603: rewrite to support nested layouts
  * @alpha
  */
 export class DashboardLayoutBuilder {
@@ -26,8 +26,7 @@ export class DashboardLayoutBuilder {
      */
     static for(layout, layoutPath) {
         invariant(isDashboardLayout(layout), "Provided data must be IDashboardLayout.");
-        const dashboardLayoutBuilder = new DashboardLayoutBuilder(DashboardLayoutFacade.for(layout, layoutPath), DashboardLayoutFacade.for);
-        return dashboardLayoutBuilder;
+        return new DashboardLayoutBuilder(DashboardLayoutFacade.for(layout, layoutPath), DashboardLayoutFacade.for);
     }
     /**
      * Creates an instance of DashboardLayoutBuilder with empty layout.
@@ -47,59 +46,174 @@ export class DashboardLayoutBuilder {
             size: resolveValueOrUpdateCallback(valueOrUpdateCallback, this.facade().size()),
         }));
     }
-    createSection(create = identity, index = this.facade().sections().count()) {
-        const emptySection = {
-            type: "IDashboardLayoutSection",
-            items: [],
-        };
-        this.setLayout((layout) => {
-            const updatedRows = [...layout.sections];
-            updatedRows.splice(index, 0, emptySection);
-            return {
-                ...layout,
-                sections: updatedRows,
+    createSection(create = identity, indexOrPath) {
+        if (typeof indexOrPath === "number" || typeof indexOrPath === "undefined") {
+            const index = indexOrPath ?? this.facade().sections().count();
+            const emptySection = {
+                type: "IDashboardLayoutSection",
+                items: [],
+            };
+            this.setLayout((layout) => {
+                const updatedRows = [...layout.sections];
+                updatedRows.splice(index, 0, emptySection);
+                return {
+                    ...layout,
+                    sections: updatedRows,
+                };
+            });
+            DashboardLayoutSectionBuilder.for(this, index).modify(create);
+        }
+        else {
+            this.createSectionByPath(create, indexOrPath);
+        }
+        return this;
+    }
+    createSectionByPath(create, sectionPath) {
+        if (sectionPath.parent && sectionPath.parent.length > 0) {
+            const [nextPathEntry, ...remainingPath] = sectionPath.parent;
+            const nestedLayout = this.facade().nestedLayout([nextPathEntry])?.raw();
+            invariant(nestedLayout, `Cannot create section - nested layout at path ${JSON.stringify(nextPathEntry)} does not exist.`);
+            const sectionBuilder = DashboardLayoutSectionBuilder.for(this, nextPathEntry.sectionIndex);
+            const modify = (nestedLayoutBuilder) => {
+                return nestedLayoutBuilder.createSection(create, {
+                    parent: remainingPath,
+                    sectionIndex: sectionPath.sectionIndex,
+                });
             };
-        });
-        DashboardLayoutSectionBuilder.for(this, index).modify(create);
+            DashboardLayoutItemBuilder.for(sectionBuilder, nextPathEntry.itemIndex).modifyLayoutWidget(modify, DashboardLayoutBuilder.for);
+        }
+        else {
+            this.createSection(create, sectionPath.sectionIndex);
+        }
+        return this;
+    }
+    addSection(section, indexOrPath) {
+        if (typeof indexOrPath === "number" || typeof indexOrPath === "undefined") {
+            const index = indexOrPath === undefined ? this.facade().sections().count() : indexOrPath;
+            this.setLayout((layout) => {
+                const updatedRows = [...layout.sections];
+                updatedRows.splice(index, 0, section);
+                return {
+                    ...layout,
+                    sections: updatedRows,
+                };
+            });
+        }
+        else {
+            this.addSectionByPath(indexOrPath, section);
+        }
         return this;
     }
-    addSection(section, index = this.facade().sections().count()) {
-        this.setLayout((layout) => {
-            const updatedRows = [...layout.sections];
-            updatedRows.splice(index, 0, section);
-            return {
-                ...layout,
-                sections: updatedRows,
+    addSectionByPath(sectionPath, section) {
+        if (sectionPath.parent && sectionPath.parent.length > 0) {
+            const [nextPathEntry, ...remainingPath] = sectionPath.parent;
+            const nestedLayout = this.facade().nestedLayout([nextPathEntry])?.raw();
+            invariant(nestedLayout, `Cannot add section - nested layout at path ${JSON.stringify(nextPathEntry)} does not exist.`);
+            const sectionBuilder = DashboardLayoutSectionBuilder.for(this, nextPathEntry.sectionIndex);
+            const modify = (nestedLayoutBuilder) => {
+                return nestedLayoutBuilder.addSection(section, {
+                    parent: remainingPath,
+                    sectionIndex: sectionPath.sectionIndex,
+                });
             };
-        });
+            DashboardLayoutItemBuilder.for(sectionBuilder, nextPathEntry.itemIndex).modifyLayoutWidget(modify, DashboardLayoutBuilder.for);
+        }
+        else {
+            this.addSection(section, sectionPath.sectionIndex);
+        }
         return this;
     }
-    modifySection(index, modify) {
-        const sectionFacade = this.facade().sections().section(index);
-        invariant(sectionFacade, `Cannot modify the section - section at index ${index} does not exist.`);
-        DashboardLayoutSectionBuilder.for(this, index).modify(modify);
+    modifySection(indexOrPath, modify) {
+        if (typeof indexOrPath === "number") {
+            const sectionFacade = this.facade().sections().section(indexOrPath);
+            invariant(sectionFacade, `Cannot modify the section - section at index ${indexOrPath} does not exist.`);
+            DashboardLayoutSectionBuilder.for(this, indexOrPath).modify(modify);
+        }
+        else {
+            this.modifySectionByPath(indexOrPath, modify);
+        }
         return this;
     }
-    removeSection(index) {
-        const sectionFacade = this.facade().sections().section(index);
-        invariant(sectionFacade, `Cannot remove the section - section at index ${index} does not exist.`);
-        return this.setLayout((layout) => {
-            const updatedRows = [...layout.sections];
-            updatedRows.splice(index, 1);
-            return {
-                ...layout,
-                sections: updatedRows,
+    modifySectionByPath(sectionPath, modify) {
+        if (sectionPath.parent && sectionPath.parent.length > 0) {
+            const [nextPathEntry, ...remainingPath] = sectionPath.parent;
+            const nestedLayout = this.facade().nestedLayout([nextPathEntry])?.raw();
+            invariant(nestedLayout, `Cannot modify section - nested layout at path ${JSON.stringify(nextPathEntry)} does not exist.`);
+            const sectionBuilder = DashboardLayoutSectionBuilder.for(this, nextPathEntry.sectionIndex);
+            const widgetModify = (nestedLayoutBuilder) => {
+                return nestedLayoutBuilder.modifySection({
+                    parent: remainingPath,
+                    sectionIndex: sectionPath.sectionIndex,
+                }, modify);
             };
-        });
+            DashboardLayoutItemBuilder.for(sectionBuilder, nextPathEntry.itemIndex).modifyLayoutWidget(widgetModify, DashboardLayoutBuilder.for);
+        }
+        else {
+            this.modifySection(sectionPath.sectionIndex, modify);
+        }
+        return this;
+    }
+    removeSection(indexOrPath) {
+        if (typeof indexOrPath === "number") {
+            const sectionFacade = this.facade().sections().section(indexOrPath);
+            invariant(sectionFacade, `Cannot remove the section - section at index ${indexOrPath} does not exist.`);
+            return this.setLayout((layout) => {
+                const updatedRows = [...layout.sections];
+                updatedRows.splice(indexOrPath, 1);
+                return {
+                    ...layout,
+                    sections: updatedRows,
+                };
+            });
+        }
+        return this.removeSectionByPath(indexOrPath);
+    }
+    removeSectionByPath(sectionPath) {
+        if (sectionPath.parent && sectionPath.parent.length > 0) {
+            const [nextPathEntry, ...remainingPath] = sectionPath.parent;
+            const nestedLayout = this.facade().nestedLayout([nextPathEntry])?.raw();
+            invariant(nestedLayout, `Cannot modify section - nested layout at path ${JSON.stringify(nextPathEntry)} does not exist.`);
+            const sectionBuilder = DashboardLayoutSectionBuilder.for(this, nextPathEntry.sectionIndex);
+            const widgetModify = (nestedLayoutBuilder) => {
+                return nestedLayoutBuilder.removeSection({
+                    parent: remainingPath,
+                    sectionIndex: sectionPath.sectionIndex,
+                });
+            };
+            DashboardLayoutItemBuilder.for(sectionBuilder, nextPathEntry.itemIndex).modifyLayoutWidget(widgetModify, DashboardLayoutBuilder.for);
+            return this;
+        }
+        else {
+            return this.removeSection(sectionPath.sectionIndex);
+        }
+    }
+    moveSection(fromIndexOrPath, toIndexOrPath) {
+        if (typeof fromIndexOrPath === "number" && typeof toIndexOrPath === "number") {
+            const section = this.facade().section(fromIndexOrPath)?.raw();
+            invariant(section, `Cannot move the section - section at index ${fromIndexOrPath} does not exist.`);
+            const maxToIndex = Math.min(toIndexOrPath, this.facade().sections().count() - 1);
+            this.removeSection(fromIndexOrPath);
+            this.createSection((r) => {
+                return r.setSection(section);
+            }, maxToIndex);
+        }
+        else {
+            this.moveSectionByPath(fromIndexOrPath, toIndexOrPath);
+        }
+        return this;
     }
-    moveSection(fromIndex, toIndex) {
-        const section = this.facade().sections().section(fromIndex)?.raw();
-        invariant(section, `Cannot move the section - section at index ${fromIndex} does not exist.`);
-        const maxToIndex = Math.min(toIndex, this.facade().sections().count() - 1);
-        this.removeSection(fromIndex);
+    moveSectionByPath(fromIndexOrPath, toIndexOrPath) {
+        const section = typeof fromIndexOrPath === "number"
+            ? this.facade().section(fromIndexOrPath)?.raw()
+            : this.facade()
+                .nestedLayout(fromIndexOrPath.parent ?? [])
+                ?.section(fromIndexOrPath.sectionIndex)
+                ?.raw();
+        invariant(section, `Cannot move the section - section at index ${JSON.stringify(fromIndexOrPath)} does not exist.`);
+        this.removeSection(fromIndexOrPath);
         this.createSection((r) => {
             return r.setSection(section);
-        }, maxToIndex);
+        }, toIndexOrPath);
         return this;
     }
     removeSections(selector = (sections) => sections.all()) {
@@ -114,7 +228,6 @@ export class DashboardLayoutBuilder {
             });
         }
         else if (sectionsToRemove) {
-            // TODO LX-603: rewrite to support nested layouts, currently works only in root layout
             this.removeSection(getSectionIndex(sectionsToRemove.index()));
         }
         return this;
@@ -126,20 +239,17 @@ export class DashboardLayoutBuilder {
         const sectionsToModify = selector(this.facade().sections());
         if (isArray(sectionsToModify)) {
             sectionsToModify.forEach((section) => {
-                // TODO LX-603: rewrite to support nested layouts, currently works only in root layout
                 this.modifySection(getSectionIndex(section.index()), modify);
             });
         }
         else if (sectionsToModify) {
-            // TODO LX-603: rewrite to support nested layouts, currently works only in root layout
             this.modifySection(getSectionIndex(sectionsToModify.index()), modify);
         }
         return this;
     }
     setLayout(valueOrUpdateCallback) {
         const updatedLayout = resolveValueOrUpdateCallback(valueOrUpdateCallback, this.build());
-        // TODO LX-603: rewrite to support nested layouts, currently works only in root layout
-        this.layoutFacade = this.layoutFacadeConstructor(updatedLayout, undefined);
+        this.layoutFacade = this.layoutFacadeConstructor(updatedLayout, this.facade().path());
         return this;
     }
     facade() {