@sapui5/sap.cux.home 1.142.0 → 1.143.0

package/src/sap/cux/home/BasePanel.js

@@ -2,10 +2,11 @@
  * SAP UI development toolkit for HTML5 (SAPUI5)
  *  * (c) Copyright 2009-2025 SAP SE. All rights reserved
  */
-sap.ui.define(["sap/ui/core/dnd/DragDropInfo", "sap/ui/core/Element", "sap/ui/core/Lib", "sap/ui/core/library", "./utils/Device", "./utils/DragDropUtils"], function (DragDropInfo, Element, Lib, sap_ui_core_library, ___utils_Device, ___utils_DragDropUtils) {
+sap.ui.define(["sap/ui/core/dnd/DragDropInfo", "sap/ui/core/Element", "sap/ui/core/Lib", "sap/ui/core/library", "./utils/DataFormatUtils", "./utils/Device", "./utils/DragDropUtils"], function (DragDropInfo, Element, Lib, sap_ui_core_library, ___utils_DataFormatUtils, ___utils_Device, ___utils_DragDropUtils) {
   "use strict";
 
   const dnd = sap_ui_core_library["dnd"];
+  const recycleId = ___utils_DataFormatUtils["recycleId"];
   const calculateDeviceType = ___utils_Device["calculateDeviceType"];
   const attachKeyboardHandler = ___utils_DragDropUtils["attachKeyboardHandler"];
   /**
@@ -207,7 +208,7 @@ sap.ui.define(["sap/ui/core/dnd/DragDropInfo", "sap/ui/core/Element", "sap/ui/co
       return container ? container.getDeviceType() : calculateDeviceType();
     },
     addDragDropConfigTo: function _addDragDropConfigTo(container, dropHandler, keyboardHandler, dropPositionType = dnd.DropPosition.Between) {
-      container.addDragDropConfig(new DragDropInfo(`${container.getId()}--addDragDropConfig`, {
+      container.addDragDropConfig(new DragDropInfo(recycleId(`${container.getId()}--addDragDropConfig`), {
         sourceAggregation: "items",
         targetAggregation: "items",
         dropPosition: dropPositionType,

package/src/sap/cux/home/BasePanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"BasePanel.js","names":["sap","ui","define","DragDropInfo","Element","Lib","sap_ui_core_library","___utils_Device","___utils_DragDropUtils","dnd","calculateDeviceType","attachKeyboardHandler","BasePanel","extend","metadata","library","properties","title","type","group","defaultValue","key","visible","showBadge","visibility","tooltip","enableSettings","enableKeyUserSettings","enableFullScreen","fullScreenName","defaultAggregation","aggregations","content","multiple","singularName","actionButtons","menuItems","events","onExpand","loaded","associations","fullScreenButton","constructor","_constructor","id","settings","Element.prototype.constructor.call","init","_init","_i18nBundle","getResourceBundleFor","getProperty","setProperty","getId","_setCount","count","getParent","_setPanelCount","_showBadge","show","_setPanelBadge","getDeviceType","_getDeviceType","container","addDragDropConfigTo","_addDragDropConfigTo","dropHandler","keyboardHandler","dropPositionType","DropPosition","Between","addDragDropConfig","sourceAggregation","targetAggregation","dropPosition","dropLayout","DropLayout","Horizontal","drop","attachBrowserEvent","event","disableNavigation","metaKey","ctrlKey","dragDropEvent"],"sources":["BasePanel.ts"],"sourcesContent":["/*!\n * SAP UI development toolkit for HTML5 (SAPUI5)\n *  * (c) Copyright 2009-2025 SAP SE. All rights reserved\n */\n\nimport ResourceBundle from \"sap/base/i18n/ResourceBundle\";\nimport GridContainer from \"sap/f/GridContainer\";\nimport FlexBox from \"sap/m/FlexBox\";\nimport HeaderContainer from \"sap/m/HeaderContainer\";\nimport DragDropInfo from \"sap/ui/core/dnd/DragDropInfo\";\nimport { DropInfo$DropEvent } from \"sap/ui/core/dnd/DropInfo\";\nimport type { MetadataOptions } from \"sap/ui/core/Element\";\nimport Element from \"sap/ui/core/Element\";\nimport Lib from \"sap/ui/core/Lib\";\nimport { dnd } from \"sap/ui/core/library\";\nimport BaseContainer from \"./BaseContainer\";\nimport { $BasePanelSettings } from \"./BasePanel\";\nimport { DeviceType, calculateDeviceType } from \"./utils/Device\";\nimport { attachKeyboardHandler } from \"./utils/DragDropUtils\";\n\n/**\n *\n * Abstract base class for all panels placed in {@link sap.cux.home.BaseContainer}.\n *\n * @extends sap.ui.core.Element\n *\n * @author SAP SE\n * @version 0.0.1\n * @since 1.121\n *\n * @abstract\n * @private\n * @ui5-restricted ux.eng.s4producthomes1\n *\n * @alias sap.cux.home.BasePanel\n */\nexport default abstract class BasePanel extends Element {\n\tprotected _i18nBundle!: ResourceBundle;\n\n\tconstructor(id?: string | $BasePanelSettings);\n\tconstructor(id?: string, settings?: $BasePanelSettings);\n\t/**\n\t * Constructor for a new Base Panel.\n\t *\n\t * @param {string} [id] ID for the new control, generated automatically if an ID is not provided\n\t * @param {object} [settings] Initial settings for the new control\n\t */\n\tpublic constructor(id?: string, settings?: $BasePanelSettings) {\n\t\tsuper(id, settings);\n\t}\n\n\tstatic readonly metadata: MetadataOptions = {\n\t\tlibrary: \"sap.cux.home\",\n\t\tproperties: {\n\t\t\t/**\n\t\t\t * Title for the panel.\n\t\t\t */\n\t\t\ttitle: { type: \"string\", group: \"Misc\", defaultValue: \"\" },\n\t\t\t/**\n\t\t\t * Key for the panel.\n\t\t\t */\n\t\t\tkey: { type: \"string\", group: \"Misc\", defaultValue: \"\" },\n\t\t\t/**\n\t\t\t * Specifies whether the panel should be visible.\n\t\t\t */\n\t\t\tvisible: { type: \"boolean\", group: \"Misc\", defaultValue: true },\n\t\t\t/**\n\t\t\t * Specifies whether the badge should be shown on the panel.\n\t\t\t * Applicable only for Side-by-Side orientation.\n\t\t\t */\n\t\t\tshowBadge: { type: \"boolean\", group: \"Misc\", defaultValue: false, visibility: \"hidden\" },\n\t\t\t/**\n\t\t\t * Tooltip for the panel.\n\t\t\t */\n\t\t\ttooltip: { type: \"string\", group: \"Misc\", defaultValue: \"\", visibility: \"hidden\" },\n\t\t\t/**\n\t\t\t * Specifies whether settings should be enabled for the panel.\n\t\t\t */\n\t\t\tenableSettings: { type: \"boolean\", group: \"Misc\", visibility: \"hidden\" },\n\t\t\t/**\n\t\t\t * Specifies whether key user settings should be enabled for the panel.\n\t\t\t */\n\t\t\tenableKeyUserSettings: { type: \"boolean\", group: \"Misc\", visibility: \"hidden\", defaultValue: true },\n\t\t\t/**\n\t\t\t * Indicates whether full screen is enabled for this control.\n\t\t\t */\n\t\t\tenableFullScreen: { type: \"boolean\", group: \"Misc\", visibility: \"hidden\" },\n\t\t\t/**\n\t\t\t * The name of the URL parameter used to expand the container into full-screen mode.\n\t\t\t * This property specifies the parameter key expected in the URL query string\n\t\t\t * to identify the container to be expanded.\n\t\t\t */\n\t\t\tfullScreenName: { type: \"string\", group: \"Misc\", visibility: \"hidden\" }\n\t\t},\n\t\tdefaultAggregation: \"content\",\n\t\taggregations: {\n\t\t\t/**\n\t\t\t * Specifies the content aggregation of the panel.\n\t\t\t */\n\t\t\tcontent: { multiple: true, singularName: \"content\" },\n\t\t\t/**\n\t\t\t * Specifies the actions to be shown within the panel.\n\t\t\t */\n\t\t\tactionButtons: { type: \"sap.m.Button\", multiple: true, singularName: \"actionButton\" },\n\t\t\t/**\n\t\t\t * Specifies the items that are shown within the dropdown menu of the panel.\n\t\t\t */\n\t\t\tmenuItems: { type: \"sap.cux.home.MenuItem\", multiple: true, singularName: \"menuItem\" }\n\t\t},\n\t\tevents: {\n\t\t\t/**\n\t\t\t * Event is fired before the container is expanded.\n\t\t\t */\n\t\t\tonExpand: {},\n\t\t\t/**\n\t\t\t * Event is fired after the panel is loaded.\n\t\t\t */\n\t\t\tloaded: {}\n\t\t},\n\t\tassociations: {\n\t\t\tfullScreenButton: { type: \"sap.m.Button\", multiple: false, singularName: \"fullScreenButton\", visibility: \"hidden\" }\n\t\t}\n\t};\n\n\t/**\n\t * Init lifecycle method\n\t *\n\t * @private\n\t * @override\n\t */\n\tpublic init(): void {\n\t\tthis._i18nBundle = Lib.getResourceBundleFor(\"sap.cux.home.i18n\") as ResourceBundle;\n\n\t\t// set default key if not provided\n\t\tif (!this.getProperty(\"key\")) {\n\t\t\tthis.setProperty(\"key\", this.getId());\n\t\t}\n\t}\n\n\t/**\n\t * Updates the count information of IconTabFilter of IconTabBar inner control\n\t * in case of SideBySide layout\n\t *\n\t * @private\n\t * @param {string} count - updated count information\n\t */\n\tpublic _setCount(count?: string): void {\n\t\t(this.getParent() as BaseContainer)?._setPanelCount(this, count);\n\t}\n\n\t/**\n\t * Shows or hides the badge on the IconTabFilter of IconTabBar inner control\n\t *\n\t * @private\n\t * @param show - whether to show the badge\n\t */\n\tpublic _showBadge(show?: boolean): void {\n\t\tthis.setProperty(\"showBadge\", show, true);\n\t\t(this.getParent() as BaseContainer)?._setPanelBadge(this, show);\n\t}\n\n\t/**\n\t * Retrieves the device type for the current panel.\n\t *\n\t * @private\n\t * @returns {DeviceType} - The device type of the parent container if it exists,\n\t * otherwise calculates and returns the device type based on the current device width.\n\t */\n\tprotected getDeviceType(): DeviceType {\n\t\tconst container = this.getParent() as BaseContainer;\n\t\treturn container ? container.getDeviceType() : calculateDeviceType();\n\t}\n\n\tprotected addDragDropConfigTo(\n\t\tcontainer: GridContainer | FlexBox | HeaderContainer,\n\t\tdropHandler: (event: DropInfo$DropEvent) => void,\n\t\tkeyboardHandler?: (event: KeyboardEvent) => void,\n\t\tdropPositionType: dnd.DropPosition = dnd.DropPosition.Between\n\t): void {\n\t\tcontainer\n\t\t\t.addDragDropConfig(\n\t\t\t\tnew DragDropInfo(`${container.getId()}--addDragDropConfig`, {\n\t\t\t\t\tsourceAggregation: \"items\",\n\t\t\t\t\ttargetAggregation: \"items\",\n\t\t\t\t\tdropPosition: dropPositionType,\n\t\t\t\t\tdropLayout: dnd.DropLayout.Horizontal,\n\t\t\t\t\tdrop: dropHandler\n\t\t\t\t})\n\t\t\t)\n\t\t\t.attachBrowserEvent(\"keydown\", (event: KeyboardEvent) => {\n\t\t\t\tconst disableNavigation = event.metaKey || event.ctrlKey;\n\t\t\t\tvoid attachKeyboardHandler(event, disableNavigation, (dragDropEvent: DropInfo$DropEvent) => {\n\t\t\t\t\tdropHandler(dragDropEvent);\n\t\t\t\t});\n\t\t\t});\n\t\tif (keyboardHandler) {\n\t\t\tcontainer.attachBrowserEvent(\"keydown\", keyboardHandler);\n\t\t}\n\t}\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BasePanel.js","names":["sap","ui","define","DragDropInfo","Element","Lib","sap_ui_core_library","___utils_DataFormatUtils","___utils_Device","___utils_DragDropUtils","dnd","recycleId","calculateDeviceType","attachKeyboardHandler","BasePanel","extend","metadata","library","properties","title","type","group","defaultValue","key","visible","showBadge","visibility","tooltip","enableSettings","enableKeyUserSettings","enableFullScreen","fullScreenName","defaultAggregation","aggregations","content","multiple","singularName","actionButtons","menuItems","events","onExpand","loaded","associations","fullScreenButton","constructor","_constructor","id","settings","Element.prototype.constructor.call","init","_init","_i18nBundle","getResourceBundleFor","getProperty","setProperty","getId","_setCount","count","getParent","_setPanelCount","_showBadge","show","_setPanelBadge","getDeviceType","_getDeviceType","container","addDragDropConfigTo","_addDragDropConfigTo","dropHandler","keyboardHandler","dropPositionType","DropPosition","Between","addDragDropConfig","sourceAggregation","targetAggregation","dropPosition","dropLayout","DropLayout","Horizontal","drop","attachBrowserEvent","event","disableNavigation","metaKey","ctrlKey","dragDropEvent"],"sources":["BasePanel.ts"],"sourcesContent":["/*!\n * SAP UI development toolkit for HTML5 (SAPUI5)\n *  * (c) Copyright 2009-2025 SAP SE. All rights reserved\n */\n\nimport ResourceBundle from \"sap/base/i18n/ResourceBundle\";\nimport GridContainer from \"sap/f/GridContainer\";\nimport FlexBox from \"sap/m/FlexBox\";\nimport HeaderContainer from \"sap/m/HeaderContainer\";\nimport DragDropInfo from \"sap/ui/core/dnd/DragDropInfo\";\nimport { DropInfo$DropEvent } from \"sap/ui/core/dnd/DropInfo\";\nimport type { MetadataOptions } from \"sap/ui/core/Element\";\nimport Element from \"sap/ui/core/Element\";\nimport Lib from \"sap/ui/core/Lib\";\nimport { dnd } from \"sap/ui/core/library\";\nimport BaseContainer from \"./BaseContainer\";\nimport { $BasePanelSettings } from \"./BasePanel\";\nimport { recycleId } from \"./utils/DataFormatUtils\";\nimport { DeviceType, calculateDeviceType } from \"./utils/Device\";\nimport { attachKeyboardHandler } from \"./utils/DragDropUtils\";\n\n/**\n *\n * Abstract base class for all panels placed in {@link sap.cux.home.BaseContainer}.\n *\n * @extends sap.ui.core.Element\n *\n * @author SAP SE\n * @version 0.0.1\n * @since 1.121\n *\n * @abstract\n * @private\n * @ui5-restricted ux.eng.s4producthomes1\n *\n * @alias sap.cux.home.BasePanel\n */\nexport default abstract class BasePanel extends Element {\n\tprotected _i18nBundle!: ResourceBundle;\n\n\tconstructor(id?: string | $BasePanelSettings);\n\tconstructor(id?: string, settings?: $BasePanelSettings);\n\t/**\n\t * Constructor for a new Base Panel.\n\t *\n\t * @param {string} [id] ID for the new control, generated automatically if an ID is not provided\n\t * @param {object} [settings] Initial settings for the new control\n\t */\n\tpublic constructor(id?: string, settings?: $BasePanelSettings) {\n\t\tsuper(id, settings);\n\t}\n\n\tstatic readonly metadata: MetadataOptions = {\n\t\tlibrary: \"sap.cux.home\",\n\t\tproperties: {\n\t\t\t/**\n\t\t\t * Title for the panel.\n\t\t\t */\n\t\t\ttitle: { type: \"string\", group: \"Misc\", defaultValue: \"\" },\n\t\t\t/**\n\t\t\t * Key for the panel.\n\t\t\t */\n\t\t\tkey: { type: \"string\", group: \"Misc\", defaultValue: \"\" },\n\t\t\t/**\n\t\t\t * Specifies whether the panel should be visible.\n\t\t\t */\n\t\t\tvisible: { type: \"boolean\", group: \"Misc\", defaultValue: true },\n\t\t\t/**\n\t\t\t * Specifies whether the badge should be shown on the panel.\n\t\t\t * Applicable only for Side-by-Side orientation.\n\t\t\t */\n\t\t\tshowBadge: { type: \"boolean\", group: \"Misc\", defaultValue: false, visibility: \"hidden\" },\n\t\t\t/**\n\t\t\t * Tooltip for the panel.\n\t\t\t */\n\t\t\ttooltip: { type: \"string\", group: \"Misc\", defaultValue: \"\", visibility: \"hidden\" },\n\t\t\t/**\n\t\t\t * Specifies whether settings should be enabled for the panel.\n\t\t\t */\n\t\t\tenableSettings: { type: \"boolean\", group: \"Misc\", visibility: \"hidden\" },\n\t\t\t/**\n\t\t\t * Specifies whether key user settings should be enabled for the panel.\n\t\t\t */\n\t\t\tenableKeyUserSettings: { type: \"boolean\", group: \"Misc\", visibility: \"hidden\", defaultValue: true },\n\t\t\t/**\n\t\t\t * Indicates whether full screen is enabled for this control.\n\t\t\t */\n\t\t\tenableFullScreen: { type: \"boolean\", group: \"Misc\", visibility: \"hidden\" },\n\t\t\t/**\n\t\t\t * The name of the URL parameter used to expand the container into full-screen mode.\n\t\t\t * This property specifies the parameter key expected in the URL query string\n\t\t\t * to identify the container to be expanded.\n\t\t\t */\n\t\t\tfullScreenName: { type: \"string\", group: \"Misc\", visibility: \"hidden\" }\n\t\t},\n\t\tdefaultAggregation: \"content\",\n\t\taggregations: {\n\t\t\t/**\n\t\t\t * Specifies the content aggregation of the panel.\n\t\t\t */\n\t\t\tcontent: { multiple: true, singularName: \"content\" },\n\t\t\t/**\n\t\t\t * Specifies the actions to be shown within the panel.\n\t\t\t */\n\t\t\tactionButtons: { type: \"sap.m.Button\", multiple: true, singularName: \"actionButton\" },\n\t\t\t/**\n\t\t\t * Specifies the items that are shown within the dropdown menu of the panel.\n\t\t\t */\n\t\t\tmenuItems: { type: \"sap.cux.home.MenuItem\", multiple: true, singularName: \"menuItem\" }\n\t\t},\n\t\tevents: {\n\t\t\t/**\n\t\t\t * Event is fired before the container is expanded.\n\t\t\t */\n\t\t\tonExpand: {},\n\t\t\t/**\n\t\t\t * Event is fired after the panel is loaded.\n\t\t\t */\n\t\t\tloaded: {}\n\t\t},\n\t\tassociations: {\n\t\t\tfullScreenButton: { type: \"sap.m.Button\", multiple: false, singularName: \"fullScreenButton\", visibility: \"hidden\" }\n\t\t}\n\t};\n\n\t/**\n\t * Init lifecycle method\n\t *\n\t * @private\n\t * @override\n\t */\n\tpublic init(): void {\n\t\tthis._i18nBundle = Lib.getResourceBundleFor(\"sap.cux.home.i18n\") as ResourceBundle;\n\n\t\t// set default key if not provided\n\t\tif (!this.getProperty(\"key\")) {\n\t\t\tthis.setProperty(\"key\", this.getId());\n\t\t}\n\t}\n\n\t/**\n\t * Updates the count information of IconTabFilter of IconTabBar inner control\n\t * in case of SideBySide layout\n\t *\n\t * @private\n\t * @param {string} count - updated count information\n\t */\n\tpublic _setCount(count?: string): void {\n\t\t(this.getParent() as BaseContainer)?._setPanelCount(this, count);\n\t}\n\n\t/**\n\t * Shows or hides the badge on the IconTabFilter of IconTabBar inner control\n\t *\n\t * @private\n\t * @param show - whether to show the badge\n\t */\n\tpublic _showBadge(show?: boolean): void {\n\t\tthis.setProperty(\"showBadge\", show, true);\n\t\t(this.getParent() as BaseContainer)?._setPanelBadge(this, show);\n\t}\n\n\t/**\n\t * Retrieves the device type for the current panel.\n\t *\n\t * @private\n\t * @returns {DeviceType} - The device type of the parent container if it exists,\n\t * otherwise calculates and returns the device type based on the current device width.\n\t */\n\tprotected getDeviceType(): DeviceType {\n\t\tconst container = this.getParent() as BaseContainer;\n\t\treturn container ? container.getDeviceType() : calculateDeviceType();\n\t}\n\n\tprotected addDragDropConfigTo(\n\t\tcontainer: GridContainer | FlexBox | HeaderContainer,\n\t\tdropHandler: (event: DropInfo$DropEvent) => void,\n\t\tkeyboardHandler?: (event: KeyboardEvent) => void,\n\t\tdropPositionType: dnd.DropPosition = dnd.DropPosition.Between\n\t): void {\n\t\tcontainer\n\t\t\t.addDragDropConfig(\n\t\t\t\tnew DragDropInfo(recycleId(`${container.getId()}--addDragDropConfig`), {\n\t\t\t\t\tsourceAggregation: \"items\",\n\t\t\t\t\ttargetAggregation: \"items\",\n\t\t\t\t\tdropPosition: dropPositionType,\n\t\t\t\t\tdropLayout: dnd.DropLayout.Horizontal,\n\t\t\t\t\tdrop: dropHandler\n\t\t\t\t})\n\t\t\t)\n\t\t\t.attachBrowserEvent(\"keydown\", (event: KeyboardEvent) => {\n\t\t\t\tconst disableNavigation = event.metaKey || event.ctrlKey;\n\t\t\t\tvoid attachKeyboardHandler(event, disableNavigation, (dragDropEvent: DropInfo$DropEvent) => {\n\t\t\t\t\tdropHandler(dragDropEvent);\n\t\t\t\t});\n\t\t\t});\n\t\tif (keyboardHandler) {\n\t\t\tcontainer.attachBrowserEvent(\"keydown\", keyboardHandler);\n\t\t}\n\t}\n}\n"],"mappings":"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","ignoreList":[]}

package/src/sap/cux/home/BasePanel.ts

@@ -15,6 +15,7 @@ import Lib from "sap/ui/core/Lib";
 import { dnd } from "sap/ui/core/library";
 import BaseContainer from "./BaseContainer";
 import { $BasePanelSettings } from "./BasePanel";
+import { recycleId } from "./utils/DataFormatUtils";
 import { DeviceType, calculateDeviceType } from "./utils/Device";
 import { attachKeyboardHandler } from "./utils/DragDropUtils";
 
@@ -179,7 +180,7 @@ export default abstract class BasePanel extends Element {
 	): void {
 		container
 			.addDragDropConfig(
-				new DragDropInfo(`${container.getId()}--addDragDropConfig`, {
+				new DragDropInfo(recycleId(`${container.getId()}--addDragDropConfig`), {
 					sourceAggregation: "items",
 					targetAggregation: "items",
 					dropPosition: dropPositionType,

package/src/sap/cux/home/CardsContainer.d.ts

@@ -0,0 +1,108 @@
+declare module "sap/cux/home/CardsContainer" {
+    /*!
+     * SAP UI development toolkit for HTML5 (SAPUI5)
+     *  * (c) Copyright 2009-2025 SAP SE. All rights reserved
+     */
+    import BaseContainer, { $BaseContainerSettings } from "sap/cux/home/BaseContainer";
+    import BasePanel from "sap/cux/home/BasePanel";
+    import CardsPanel from "sap/cux/home/CardsPanel";
+    const cardsPanelName: string;
+    interface IpanelLoaded {
+        [key: string]: {
+            loaded: boolean | undefined;
+            count: number;
+        };
+    }
+    interface IpanelContext {
+        [key: string]: CardsPanel;
+    }
+    /**
+     *
+     * Container class for managing and storing Insights Cards.
+     *
+     * @extends sap.cux.home.BaseContainer
+     *
+     * @author SAP SE
+     * @version 0.0.1
+     * @since 1.142
+     *
+     * @private
+     * @ui5-restricted ux.eng.s4producthomes1
+     *
+     * @alias sap.cux.home.CardsContainer
+     */
+    export default class CardsContainer extends BaseContainer {
+        private panelLoaded;
+        private panelContext;
+        private _isInitialRender;
+        static readonly renderer: {
+            apiVersion: number;
+            render: (rm: import("sap/ui/core/RenderManager").default, control: BaseContainer) => void;
+            renderContent: (rm: import("sap/ui/core/RenderManager").default, control: BaseContainer) => void;
+        };
+        constructor(id?: string | $BaseContainerSettings);
+        constructor(id?: string, settings?: $BaseContainerSettings);
+        /**
+         * Init lifecycle method
+         *
+         * @private
+         * @override
+         */
+        init(): void;
+        /**
+         * Loads the Insights section.
+         * Overrides the load method of the BaseContainer.
+         *
+         * @private
+         * @override
+         */
+        load(): void;
+        /**
+         * Handles the hiding of a panel by removing its content, updating the panel load status,
+         * and managing the display of the container header and error panel.
+         *
+         * @param {BasePanel} panel - The panel to be hidden.
+         * @private
+         */
+        handleHidePanel(panel: BasePanel): void;
+        /**
+         * Unhides the specified panel if it is hidden.
+         *
+         * @param {CardsPanel} panel - The panel to unhide.
+         */
+        unhidePanelIfHidden(panel: CardsPanel): void;
+        /**
+         * Adjusts the layout of the container.
+         *
+         * @private
+         * @override
+         */
+        adjustLayout(): void;
+        /**
+         * Handles the loading of a panel.
+         *
+         * @param {string} panelName - The name of the panel.
+         * @param {object} oVal - The load status and count of the panel.
+         * @param {boolean} oVal.loaded - The load status of the panel.
+         * @param {number} oVal.count - The count of items in the panel.
+         */
+        handlePanelLoad(panelName: string, oVal: {
+            loaded: boolean;
+            count: number;
+        }): void;
+        /**
+         * Retrieves the generic placeholder content for the Cards container.
+         *
+         * @returns {string} The HTML string representing the cards container's placeholder content.
+         */
+        protected getGenericPlaceholderContent(): string;
+        /**
+         * Refreshes the data for a specific panel based on its key.
+         *
+         * @private
+         * @param {string} key - The key of the panel to refresh.
+         */
+        refreshData(key: string): Promise<void>;
+    }
+}
+//# sourceMappingURL=CardsContainer.d.ts.map

package/src/sap/cux/home/CardsContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardsContainer.d.ts","sourceRoot":"../../../../..","sources":["src/sap/cux/home/CardsContainer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,6BAA6B,CAAC;IAC7C;;;OAGG;IACH,OAAO,aAAa,EAAE,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;IACnF,OAAO,SAAS,MAAM,wBAAwB,CAAC;IAC/C,OAAO,UAAU,MAAM,yBAAyB,CAAC;IAGjD,MAAM,cAAc,EAAE,MAAkC,CAAC;IAEzD,UAAU,YAAY;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG;YAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9D;IACD,UAAU,aAAa;QACtB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;KAC1B;IACD;;;;;;;;;;;;;;OAcG;IAEH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,aAAa;QACxD,OAAO,CAAC,WAAW,CAAgB;QACnC,OAAO,CAAC,YAAY,CAAiB;QACrC,OAAO,CAAC,gBAAgB,CAAiB;QACzC,MAAM,CAAC,QAAQ,CAAC,QAAQ;;;;UAGtB;oBACU,EAAE,CAAC,EAAE,MAAM,GAAG,sBAAsB;oBACpC,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB;QAW1D;;;;;WAKG;QACI,IAAI,IAAI,IAAI;QAoBnB;;;;;;WAMG;QACI,IAAI;QAkBX;;;;;;WAMG;QACI,eAAe,CAAC,KAAK,EAAE,SAAS;QAMvC;;;;WAIG;QACI,mBAAmB,CAAC,KAAK,EAAE,UAAU;QAkC5C;;;;;WAKG;QACI,YAAY;QAKnB;;;;;;;WAOG;QACI,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;YAAE,MAAM,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE;QAOlF;;;;WAIG;QACH,SAAS,CAAC,4BAA4B,IAAI,MAAM;QAIhD;;;;;WAKG;QACU,WAAW,CAAC,GAAG,EAAE,MAAM;KAIpC;CAEA"}

package/src/sap/cux/home/CardsContainer.js

@@ -0,0 +1,207 @@
+/*!
+ * SAP UI development toolkit for HTML5 (SAPUI5)
+ *  * (c) Copyright 2009-2025 SAP SE. All rights reserved
+ */
+sap.ui.define(["./BaseContainer", "./CardsPanel", "./utils/placeholder/CardsPlaceholder"], function (__BaseContainer, __CardsPanel, ___utils_placeholder_CardsPlaceholder) {
+  "use strict";
+
+  function _interopRequireDefault(obj) {
+    return obj && obj.__esModule && typeof obj.default !== "undefined" ? obj.default : obj;
+  }
+  const BaseContainer = _interopRequireDefault(__BaseContainer);
+  const CardsPanel = _interopRequireDefault(__CardsPanel);
+  const getCardsPlaceholder = ___utils_placeholder_CardsPlaceholder["getCardsPlaceholder"];
+  const cardsPanelName = "sap.cux.home.CardsPanel";
+  /**
+   *
+   * Container class for managing and storing Insights Cards.
+   *
+   * @extends sap.cux.home.BaseContainer
+   *
+   * @author SAP SE
+   * @version 0.0.1
+   * @since 1.142
+   *
+   * @private
+   * @ui5-restricted ux.eng.s4producthomes1
+   *
+   * @alias sap.cux.home.CardsContainer
+   */
+  const CardsContainer = BaseContainer.extend("sap.cux.home.CardsContainer", {
+    renderer: {
+      ...BaseContainer.renderer,
+      apiVersion: 2
+    },
+    /**
+     * Constructor for a new Cards container.
+     *
+     * @param {string} [id] ID for the new control, generated automatically if an ID is not provided
+     * @param {object} [settings] Initial settings for the new control
+     */
+    constructor: function _constructor(id, settings) {
+      BaseContainer.prototype.constructor.call(this, id, settings);
+      this._isInitialRender = true;
+    },
+    /**
+     * Init lifecycle method
+     *
+     * @private
+     * @override
+     */
+    init: function _init() {
+      BaseContainer.prototype.init.call(this);
+      /* As Container Level default value for enableSettings is false,
+      	this needs to be added from container level.
+      	(default value cannot be true as News & Page Container header should be hidden)
+      */
+      this.setProperty("enableSettings", false);
+      this.setProperty("orientation", "Vertical");
+      this.setProperty("compositeId", "Insights");
+      this.panelLoaded = {
+        [cardsPanelName]: {
+          loaded: undefined,
+          count: 0
+        }
+      };
+      this.panelContext = {};
+      this.addCustomSetting("title", this._i18nBundle.getText("insightsCards"));
+      this.addCustomSetting("groupTitle", this._i18nBundle.getText("insights"));
+      this.setTooltip(String(this._i18nBundle.getText("insightsCards")));
+      //remove aggregation menuItems and actionButtons as they will be added from individual panels
+      this.removeAllAggregation("menuItems");
+      this.removeAllAggregation("actionButtons");
+    },
+    /**
+     * Loads the Insights section.
+     * Overrides the load method of the BaseContainer.
+     *
+     * @private
+     * @override
+     */
+    load: function _load() {
+      if (this._isInitialRender) {
+        const aContent = this.getContent();
+        aContent.forEach(oContent => {
+          this.panelContext[oContent.getMetadata().getName()] = oContent;
+        });
+
+        // Render individual panels
+        aContent.forEach(content => {
+          const panel = content;
+          panel.attachHandleHidePanel(() => this.handleHidePanel(panel));
+          panel.attachHandleUnhidePanel(() => this.unhidePanelIfHidden(panel));
+          void panel.renderPanel();
+        });
+        this._isInitialRender = false;
+      }
+    },
+    /**
+     * Handles the hiding of a panel by removing its content, updating the panel load status,
+     * and managing the display of the container header and error panel.
+     *
+     * @param {BasePanel} panel - The panel to be hidden.
+     * @private
+     */
+    handleHidePanel: function _handleHidePanel(panel) {
+      this.removeContent(panel);
+      const panelName = panel.getMetadata().getName();
+      this.handlePanelLoad(panelName, {
+        loaded: false,
+        count: 0
+      });
+    },
+    /**
+     * Unhides the specified panel if it is hidden.
+     *
+     * @param {CardsPanel} panel - The panel to unhide.
+     */
+    unhidePanelIfHidden: function _unhidePanelIfHidden(panel) {
+      const layout = this._getLayout();
+      const panelExpandedName = layout._getCurrentExpandedElementName();
+      // Function to handle panel content insertion
+      const processPanelVisibility = (panelName, insertContentFn) => {
+        if (!panelExpandedName || panelExpandedName === panel.getProperty("fullScreenName")) {
+          /**
+                          loaded value can be false or undefined, false being hidden and undefined being loading
+                          if the panel is hidden then only unhide it
+                      */
+          if (this.panelLoaded[panelName].loaded === false) {
+            insertContentFn();
+            // Remove hidden class if applied
+            panel.setVisible(true);
+          }
+          this.handlePanelLoad(panelName, {
+            loaded: true,
+            count: this.panelLoaded[panelName].count
+          });
+        } else {
+          const listener = () => {
+            insertContentFn();
+            // Remove hidden class if applied
+            panel.setVisible(true);
+            layout.detachOnCollapse(listener); // Remove the listener after execution
+          };
+          this.handlePanelLoad(panelName, {
+            loaded: true,
+            count: this.panelLoaded[panelName].count
+          });
+          layout.attachOnCollapse(listener);
+        }
+      };
+
+      // Handling CardsPanel
+      if (panel instanceof CardsPanel && !this.panelLoaded[cardsPanelName].loaded) {
+        processPanelVisibility(cardsPanelName, () => this.addContent(this.panelContext[cardsPanelName]));
+      }
+    },
+    /**
+     * Adjusts the layout of the container.
+     *
+     * @private
+     * @override
+     */
+    adjustLayout: function _adjustLayout() {
+      //adjust layout of all panels
+      this.getContent().forEach(panel => panel._adjustLayout?.());
+    },
+    /**
+     * Handles the loading of a panel.
+     *
+     * @param {string} panelName - The name of the panel.
+     * @param {object} oVal - The load status and count of the panel.
+     * @param {boolean} oVal.loaded - The load status of the panel.
+     * @param {number} oVal.count - The count of items in the panel.
+     */
+    handlePanelLoad: function _handlePanelLoad(panelName, oVal) {
+      if (this.panelLoaded[panelName].loaded !== oVal.loaded) {
+        this.panelLoaded[panelName] = oVal;
+      }
+      this.adjustLayout();
+    },
+    /**
+     * Retrieves the generic placeholder content for the Cards container.
+     *
+     * @returns {string} The HTML string representing the cards container's placeholder content.
+     */
+    getGenericPlaceholderContent: function _getGenericPlaceholderContent() {
+      return getCardsPlaceholder();
+    },
+    /**
+     * Refreshes the data for a specific panel based on its key.
+     *
+     * @private
+     * @param {string} key - The key of the panel to refresh.
+     */
+    refreshData: function _refreshData(key) {
+      try {
+        const _this = this;
+        const panel = Object.values(_this.panelContext).find(panel => panel.getKey() === key);
+        return Promise.resolve(panel?.refreshData?.()).then(function () {});
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    }
+  });
+  return CardsContainer;
+});
+//# sourceMappingURL=CardsContainer.js.map

package/src/sap/cux/home/CardsContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardsContainer.js","names":["sap","ui","define","__BaseContainer","__CardsPanel","___utils_placeholder_CardsPlaceholder","_interopRequireDefault","obj","__esModule","default","BaseContainer","CardsPanel","getCardsPlaceholder","cardsPanelName","CardsContainer","extend","renderer","apiVersion","constructor","_constructor","id","settings","BaseContainer.prototype.constructor.call","_isInitialRender","init","_init","BaseContainer.prototype.init.call","setProperty","panelLoaded","loaded","undefined","count","panelContext","addCustomSetting","_i18nBundle","getText","setTooltip","String","removeAllAggregation","load","_load","aContent","getContent","forEach","oContent","getMetadata","getName","content","panel","attachHandleHidePanel","handleHidePanel","attachHandleUnhidePanel","unhidePanelIfHidden","renderPanel","_handleHidePanel","removeContent","panelName","handlePanelLoad","_unhidePanelIfHidden","layout","_getLayout","panelExpandedName","_getCurrentExpandedElementName","processPanelVisibility","insertContentFn","getProperty","setVisible","listener","detachOnCollapse","attachOnCollapse","addContent","adjustLayout","_adjustLayout","_handlePanelLoad","oVal","getGenericPlaceholderContent","_getGenericPlaceholderContent","refreshData","_refreshData","key","_this","Object","values","find","getKey","Promise","resolve","then","e","reject"],"sources":["CardsContainer.ts"],"sourcesContent":["/*!\n * SAP UI development toolkit for HTML5 (SAPUI5)\n *  * (c) Copyright 2009-2025 SAP SE. All rights reserved\n */\nimport BaseContainer, { $BaseContainerSettings } from \"./BaseContainer\";\nimport BasePanel from \"./BasePanel\";\nimport CardsPanel from \"./CardsPanel\";\nimport { getCardsPlaceholder } from \"./utils/placeholder/CardsPlaceholder\";\n\nconst cardsPanelName: string = \"sap.cux.home.CardsPanel\";\n\ninterface IpanelLoaded {\n\t[key: string]: { loaded: boolean | undefined; count: number };\n}\ninterface IpanelContext {\n\t[key: string]: CardsPanel;\n}\n/**\n *\n * Container class for managing and storing Insights Cards.\n *\n * @extends sap.cux.home.BaseContainer\n *\n * @author SAP SE\n * @version 0.0.1\n * @since 1.142\n *\n * @private\n * @ui5-restricted ux.eng.s4producthomes1\n *\n * @alias sap.cux.home.CardsContainer\n */\n\nexport default class CardsContainer extends BaseContainer {\n\tprivate panelLoaded!: IpanelLoaded;\n\tprivate panelContext!: IpanelContext;\n\tprivate _isInitialRender: boolean = true;\n\tstatic readonly renderer = {\n\t\t...BaseContainer.renderer,\n\t\tapiVersion: 2\n\t};\n\tconstructor(id?: string | $BaseContainerSettings);\n\tconstructor(id?: string, settings?: $BaseContainerSettings);\n\t/**\n\t * Constructor for a new Cards container.\n\t *\n\t * @param {string} [id] ID for the new control, generated automatically if an ID is not provided\n\t * @param {object} [settings] Initial settings for the new control\n\t */\n\tpublic constructor(id?: string, settings?: $BaseContainerSettings) {\n\t\tsuper(id, settings);\n\t}\n\n\t/**\n\t * Init lifecycle method\n\t *\n\t * @private\n\t * @override\n\t */\n\tpublic init(): void {\n\t\tsuper.init();\n\t\t/* As Container Level default value for enableSettings is false,\n\t\t\tthis needs to be added from container level.\n\t\t\t(default value cannot be true as News & Page Container header should be hidden)\n\t\t*/\n\t\tthis.setProperty(\"enableSettings\", false);\n\t\tthis.setProperty(\"orientation\", \"Vertical\");\n\t\tthis.setProperty(\"compositeId\", \"Insights\");\n\t\tthis.panelLoaded = {\n\t\t\t[cardsPanelName]: { loaded: undefined, count: 0 }\n\t\t};\n\t\tthis.panelContext = {};\n\t\tthis.addCustomSetting(\"title\", this._i18nBundle.getText(\"insightsCards\") as string);\n\t\tthis.addCustomSetting(\"groupTitle\", this._i18nBundle.getText(\"insights\") as string);\n\t\tthis.setTooltip(String(this._i18nBundle.getText(\"insightsCards\")));\n\t\t//remove aggregation menuItems and actionButtons as they will be added from individual panels\n\t\tthis.removeAllAggregation(\"menuItems\");\n\t\tthis.removeAllAggregation(\"actionButtons\");\n\t}\n\t/**\n\t * Loads the Insights section.\n\t * Overrides the load method of the BaseContainer.\n\t *\n\t * @private\n\t * @override\n\t */\n\tpublic load() {\n\t\tif (this._isInitialRender) {\n\t\t\tconst aContent = this.getContent();\n\t\t\taContent.forEach((oContent) => {\n\t\t\t\tthis.panelContext[oContent.getMetadata().getName()] = oContent as CardsPanel;\n\t\t\t});\n\n\t\t\t// Render individual panels\n\t\t\taContent.forEach((content) => {\n\t\t\t\tconst panel = content as CardsPanel;\n\t\t\t\tpanel.attachHandleHidePanel(() => this.handleHidePanel(panel));\n\t\t\t\tpanel.attachHandleUnhidePanel(() => this.unhidePanelIfHidden(panel));\n\t\t\t\tvoid panel.renderPanel();\n\t\t\t});\n\t\t\tthis._isInitialRender = false;\n\t\t}\n\t}\n\n\t/**\n\t * Handles the hiding of a panel by removing its content, updating the panel load status,\n\t * and managing the display of the container header and error panel.\n\t *\n\t * @param {BasePanel} panel - The panel to be hidden.\n\t * @private\n\t */\n\tpublic handleHidePanel(panel: BasePanel) {\n\t\tthis.removeContent(panel);\n\t\tconst panelName = panel.getMetadata().getName();\n\t\tthis.handlePanelLoad(panelName, { loaded: false, count: 0 });\n\t}\n\n\t/**\n\t * Unhides the specified panel if it is hidden.\n\t *\n\t * @param {CardsPanel} panel - The panel to unhide.\n\t */\n\tpublic unhidePanelIfHidden(panel: CardsPanel) {\n\t\tconst layout = this._getLayout();\n\t\tconst panelExpandedName = layout._getCurrentExpandedElementName();\n\t\t// Function to handle panel content insertion\n\t\tconst processPanelVisibility = (panelName: string, insertContentFn: () => void) => {\n\t\t\tif (!panelExpandedName || panelExpandedName === panel.getProperty(\"fullScreenName\")) {\n\t\t\t\t/**\n                    loaded value can be false or undefined, false being hidden and undefined being loading\n                    if the panel is hidden then only unhide it\n                */\n\t\t\t\tif (this.panelLoaded[panelName].loaded === false) {\n\t\t\t\t\tinsertContentFn();\n\t\t\t\t\t// Remove hidden class if applied\n\t\t\t\t\tpanel.setVisible(true);\n\t\t\t\t}\n\t\t\t\tthis.handlePanelLoad(panelName, { loaded: true, count: this.panelLoaded[panelName].count });\n\t\t\t} else {\n\t\t\t\tconst listener = () => {\n\t\t\t\t\tinsertContentFn();\n\t\t\t\t\t// Remove hidden class if applied\n\t\t\t\t\tpanel.setVisible(true);\n\t\t\t\t\tlayout.detachOnCollapse(listener); // Remove the listener after execution\n\t\t\t\t};\n\t\t\t\tthis.handlePanelLoad(panelName, { loaded: true, count: this.panelLoaded[panelName].count });\n\t\t\t\tlayout.attachOnCollapse(listener);\n\t\t\t}\n\t\t};\n\n\t\t// Handling CardsPanel\n\t\tif (panel instanceof CardsPanel && !this.panelLoaded[cardsPanelName].loaded) {\n\t\t\tprocessPanelVisibility(cardsPanelName, () => this.addContent(this.panelContext[cardsPanelName]));\n\t\t}\n\t}\n\n\t/**\n\t * Adjusts the layout of the container.\n\t *\n\t * @private\n\t * @override\n\t */\n\tpublic adjustLayout() {\n\t\t//adjust layout of all panels\n\t\t(this.getContent() as CardsPanel[]).forEach((panel) => panel._adjustLayout?.());\n\t}\n\n\t/**\n\t * Handles the loading of a panel.\n\t *\n\t * @param {string} panelName - The name of the panel.\n\t * @param {object} oVal - The load status and count of the panel.\n\t * @param {boolean} oVal.loaded - The load status of the panel.\n\t * @param {number} oVal.count - The count of items in the panel.\n\t */\n\tpublic handlePanelLoad(panelName: string, oVal: { loaded: boolean; count: number }) {\n\t\tif (this.panelLoaded[panelName].loaded !== oVal.loaded) {\n\t\t\tthis.panelLoaded[panelName] = oVal;\n\t\t}\n\t\tthis.adjustLayout();\n\t}\n\n\t/**\n\t * Retrieves the generic placeholder content for the Cards container.\n\t *\n\t * @returns {string} The HTML string representing the cards container's placeholder content.\n\t */\n\tprotected getGenericPlaceholderContent(): string {\n\t\treturn getCardsPlaceholder();\n\t}\n\n\t/**\n\t * Refreshes the data for a specific panel based on its key.\n\t *\n\t * @private\n\t * @param {string} key - The key of the panel to refresh.\n\t */\n\tpublic async refreshData(key: string) {\n\t\tconst panel = Object.values(this.panelContext).find((panel) => panel.getKey() === key);\n\t\tawait panel?.refreshData?.();\n\t}\n}\n"],"mappings":"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","ignoreList":[]}

package/src/sap/cux/home/CardsContainer.ts

@@ -0,0 +1,202 @@
+/*!
+ * SAP UI development toolkit for HTML5 (SAPUI5)
+ *  * (c) Copyright 2009-2025 SAP SE. All rights reserved
+ */
+import BaseContainer, { $BaseContainerSettings } from "./BaseContainer";
+import BasePanel from "./BasePanel";
+import CardsPanel from "./CardsPanel";
+import { getCardsPlaceholder } from "./utils/placeholder/CardsPlaceholder";
+
+const cardsPanelName: string = "sap.cux.home.CardsPanel";
+
+interface IpanelLoaded {
+	[key: string]: { loaded: boolean | undefined; count: number };
+}
+interface IpanelContext {
+	[key: string]: CardsPanel;
+}
+/**
+ *
+ * Container class for managing and storing Insights Cards.
+ *
+ * @extends sap.cux.home.BaseContainer
+ *
+ * @author SAP SE
+ * @version 0.0.1
+ * @since 1.142
+ *
+ * @private
+ * @ui5-restricted ux.eng.s4producthomes1
+ *
+ * @alias sap.cux.home.CardsContainer
+ */
+
+export default class CardsContainer extends BaseContainer {
+	private panelLoaded!: IpanelLoaded;
+	private panelContext!: IpanelContext;
+	private _isInitialRender: boolean = true;
+	static readonly renderer = {
+		...BaseContainer.renderer,
+		apiVersion: 2
+	};
+	constructor(id?: string | $BaseContainerSettings);
+	constructor(id?: string, settings?: $BaseContainerSettings);
+	/**
+	 * Constructor for a new Cards container.
+	 *
+	 * @param {string} [id] ID for the new control, generated automatically if an ID is not provided
+	 * @param {object} [settings] Initial settings for the new control
+	 */
+	public constructor(id?: string, settings?: $BaseContainerSettings) {
+		super(id, settings);
+	}
+
+	/**
+	 * Init lifecycle method
+	 *
+	 * @private
+	 * @override
+	 */
+	public init(): void {
+		super.init();
+		/* As Container Level default value for enableSettings is false,
+			this needs to be added from container level.
+			(default value cannot be true as News & Page Container header should be hidden)
+		*/
+		this.setProperty("enableSettings", false);
+		this.setProperty("orientation", "Vertical");
+		this.setProperty("compositeId", "Insights");
+		this.panelLoaded = {
+			[cardsPanelName]: { loaded: undefined, count: 0 }
+		};
+		this.panelContext = {};
+		this.addCustomSetting("title", this._i18nBundle.getText("insightsCards") as string);
+		this.addCustomSetting("groupTitle", this._i18nBundle.getText("insights") as string);
+		this.setTooltip(String(this._i18nBundle.getText("insightsCards")));
+		//remove aggregation menuItems and actionButtons as they will be added from individual panels
+		this.removeAllAggregation("menuItems");
+		this.removeAllAggregation("actionButtons");
+	}
+	/**
+	 * Loads the Insights section.
+	 * Overrides the load method of the BaseContainer.
+	 *
+	 * @private
+	 * @override
+	 */
+	public load() {
+		if (this._isInitialRender) {
+			const aContent = this.getContent();
+			aContent.forEach((oContent) => {
+				this.panelContext[oContent.getMetadata().getName()] = oContent as CardsPanel;
+			});
+
+			// Render individual panels
+			aContent.forEach((content) => {
+				const panel = content as CardsPanel;
+				panel.attachHandleHidePanel(() => this.handleHidePanel(panel));
+				panel.attachHandleUnhidePanel(() => this.unhidePanelIfHidden(panel));
+				void panel.renderPanel();
+			});
+			this._isInitialRender = false;
+		}
+	}
+
+	/**
+	 * Handles the hiding of a panel by removing its content, updating the panel load status,
+	 * and managing the display of the container header and error panel.
+	 *
+	 * @param {BasePanel} panel - The panel to be hidden.
+	 * @private
+	 */
+	public handleHidePanel(panel: BasePanel) {
+		this.removeContent(panel);
+		const panelName = panel.getMetadata().getName();
+		this.handlePanelLoad(panelName, { loaded: false, count: 0 });
+	}
+
+	/**
+	 * Unhides the specified panel if it is hidden.
+	 *
+	 * @param {CardsPanel} panel - The panel to unhide.
+	 */
+	public unhidePanelIfHidden(panel: CardsPanel) {
+		const layout = this._getLayout();
+		const panelExpandedName = layout._getCurrentExpandedElementName();
+		// Function to handle panel content insertion
+		const processPanelVisibility = (panelName: string, insertContentFn: () => void) => {
+			if (!panelExpandedName || panelExpandedName === panel.getProperty("fullScreenName")) {
+				/**
+                    loaded value can be false or undefined, false being hidden and undefined being loading
+                    if the panel is hidden then only unhide it
+                */
+				if (this.panelLoaded[panelName].loaded === false) {
+					insertContentFn();
+					// Remove hidden class if applied
+					panel.setVisible(true);
+				}
+				this.handlePanelLoad(panelName, { loaded: true, count: this.panelLoaded[panelName].count });
+			} else {
+				const listener = () => {
+					insertContentFn();
+					// Remove hidden class if applied
+					panel.setVisible(true);
+					layout.detachOnCollapse(listener); // Remove the listener after execution
+				};
+				this.handlePanelLoad(panelName, { loaded: true, count: this.panelLoaded[panelName].count });
+				layout.attachOnCollapse(listener);
+			}
+		};
+
+		// Handling CardsPanel
+		if (panel instanceof CardsPanel && !this.panelLoaded[cardsPanelName].loaded) {
+			processPanelVisibility(cardsPanelName, () => this.addContent(this.panelContext[cardsPanelName]));
+		}
+	}
+
+	/**
+	 * Adjusts the layout of the container.
+	 *
+	 * @private
+	 * @override
+	 */
+	public adjustLayout() {
+		//adjust layout of all panels
+		(this.getContent() as CardsPanel[]).forEach((panel) => panel._adjustLayout?.());
+	}
+
+	/**
+	 * Handles the loading of a panel.
+	 *
+	 * @param {string} panelName - The name of the panel.
+	 * @param {object} oVal - The load status and count of the panel.
+	 * @param {boolean} oVal.loaded - The load status of the panel.
+	 * @param {number} oVal.count - The count of items in the panel.
+	 */
+	public handlePanelLoad(panelName: string, oVal: { loaded: boolean; count: number }) {
+		if (this.panelLoaded[panelName].loaded !== oVal.loaded) {
+			this.panelLoaded[panelName] = oVal;
+		}
+		this.adjustLayout();
+	}
+
+	/**
+	 * Retrieves the generic placeholder content for the Cards container.
+	 *
+	 * @returns {string} The HTML string representing the cards container's placeholder content.
+	 */
+	protected getGenericPlaceholderContent(): string {
+		return getCardsPlaceholder();
+	}
+
+	/**
+	 * Refreshes the data for a specific panel based on its key.
+	 *
+	 * @private
+	 * @param {string} key - The key of the panel to refresh.
+	 */
+	public async refreshData(key: string) {
+		const panel = Object.values(this.panelContext).find((panel) => panel.getKey() === key);
+		await panel?.refreshData?.();
+	}
+}