@sapui5/sap.ushell 1.134.1 → 1.135.0

package/src/main/js/sap/ushell/services/UserDefaultParameterPersistence.js

@@ -14,7 +14,7 @@
  *
  * This is *not* an application facing service, but for Shell Internal usage.
  *
- * @version 1.134.1
+ * @version 1.135.0
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/UserDefaultParameters.js

@@ -7,7 +7,7 @@
  *               This service should be accessed by the application
  *               via the CrossApplicationNavigation service.
  *
- * @version 1.134.1
+ * @version 1.135.0
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/UserInfo.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's user information service. Allows retrieving information about the logged-in user.
  *
- * @version 1.134.1
+ * @version 1.135.0
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/UserRecents.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's user activity service.
- * @version 1.134.1
+ * @version 1.135.0
  */
 sap.ui.define([
     "sap/base/util/ObjectPath",

package/src/main/js/sap/ushell/services/VisualizationDataProvider.js

@@ -7,7 +7,7 @@
  *
  * Configured with the LaunchPageAdapter.
  *
- * @version 1.134.1
+ * @version 1.135.0
  */
 sap.ui.define([
     "sap/ushell/resources",

package/src/main/js/sap/ushell/services/VisualizationInstantiation.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module deals with the instantiation of visualizations in a platform independent way.
- * @version 1.134.1
+ * @version 1.135.0
  */
 sap.ui.define([
     "sap/ushell/ui/launchpad/VizInstance",

package/src/main/js/sap/ushell/services/_ContentExtensionAdapterFactory/ContentExtensionAdapterConfig.js

@@ -7,7 +7,7 @@
  *  config handler which is called by the factory to generate an explicit
  *  Adapter configuration
  *
- * @version 1.134.1
+ * @version 1.135.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/_ContentExtensionAdapterFactory/FeaturedGroupConfig.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview Provide mock feature group data
  *
- * @version 1.134.1
+ * @version 1.135.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/_CrossApplicationNavigation/utils.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview Cross Application Navigation utility functions
  *
- * @version 1.134.1
+ * @version 1.135.0
  * @deprecated since 1.120.0
  */
 

package/src/main/js/sap/ushell/services/_PageReferencing/PageReferencer.js

@@ -4,7 +4,7 @@
  * @file This module is responsible to create reference pages,
  * which are shareable JSON representations of layout and navigation targets in the specific format.
  *
- * @version 1.134.1
+ * @version 1.135.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/state/BackNavigation.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview handle all the current back navigation.
- * @version 1.134.1
+ * @version 1.135.0
  */
 sap.ui.define([
     "sap/ui/core/library",

package/src/main/js/sap/ushell/state/ContentDensity.js

@@ -0,0 +1,213 @@
+// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview handles content density.
+ * @version 1.135.0
+ */
+sap.ui.define([
+    "sap/ui/Device",
+    "sap/ushell/Config",
+    "sap/ushell/Container",
+    "sap/ushell/EventHub",
+    "sap/ushell/services/AppConfiguration",
+    "sap/ushell/state/StateManager"
+], function (
+    Device,
+    Config,
+    Container,
+    EventHub,
+    AppConfiguration,
+    StateManager
+) {
+    "use strict";
+
+    if (Config.last("/core/navigation/enableAppLifeCycleFallback")) {
+        return {};
+    }
+
+    // shortcut for sap.ushell.state.StateManager.Operation
+    const Operation = StateManager.Operation;
+
+    class ContentDensity {
+        #fnSetContentDensity = () => {
+            throw new Error("ContentDensity is not initialized");
+        };
+        #bInitialized = false;
+        #aDoables = [];
+
+        constructor () {
+            this.#initializeWithDevice();
+        }
+
+        /**
+         * Attaches to application change and to user preference change.
+         * @returns {Promise} Resolves when the content density is initialized.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        async init () {
+            if (this.#bInitialized) {
+                return;
+            }
+
+            this.#bInitialized = true;
+            this.#fnSetContentDensity = this.#setContentDensity.bind(this);
+            this.#aDoables.push(EventHub.on("toggleContentDensity").do(this.#fnSetContentDensity));
+
+            const AppLifeCycle = await Container.getServiceAsync("AppLifeCycle");
+            AppLifeCycle?.attachAppLoaded(this.#fnSetContentDensity);
+        }
+
+        /**
+         * Initializes the content density based on the device type and ignores any user or app preference.
+         * This shall only be done once at the beginning to ensure that at least one content density is set.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        #initializeWithDevice () {
+            const aSupportedByDevice = this.#getSupportedByDeviceType();
+            const sDeviceDefault = this.#getDeviceTypeDefault();
+
+            if (aSupportedByDevice.length === 1) {
+                StateManager.updateAllBaseStates("application.contentDensity", Operation.Set, aSupportedByDevice[0]);
+                StateManager.updateCurrentState("application.contentDensity", Operation.Set, aSupportedByDevice[0]);
+                return;
+            }
+
+            StateManager.updateAllBaseStates("application.contentDensity", Operation.Set, sDeviceDefault);
+            StateManager.updateCurrentState("application.contentDensity", Operation.Set, sDeviceDefault);
+        }
+
+        /**
+         * Recalculates and sets the content density based on the user preference, application support and device type.
+         * Can be called manually once the new AppConfiguration metadata is loaded. ({@link sap.ushell.services.AppConfiguration#getMetadata})
+         * @returns {Promise} Resolves when the content density is set.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        async resetContentDensity () {
+            await this.#setContentDensity();
+        }
+
+        /**
+         * Calculates and sets the content density based on the user preference,
+         * application support and device type.
+         * The following logic is applied for compact/cozy:
+         * - Pure touch devices: always cozy. Other settings are ignored.
+         * - Desktop and combi (laptops with a touch screen):
+         * -- If the application supports only one (compact or cozy), apply that one;
+         * -- If the application supports both, use the user preference from settings;
+         * -- If the application supports both and no user preference, take device default,
+         *    (device default is compact for desktop and cozy for combi).
+         * @returns {Promise} Resolves when the content density is set.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        async #setContentDensity () {
+            const sUserPreference = await this.#getUserPreference();
+            const aSupportedByApp = this.#getSupportedByApp();
+            const aSupportedByDevice = this.#getSupportedByDeviceType();
+            const sDeviceDefault = this.#getDeviceTypeDefault();
+
+            if (aSupportedByDevice.length === 1) {
+                StateManager.updateAllBaseStates("application.contentDensity", Operation.Set, aSupportedByDevice[0]);
+                StateManager.updateCurrentState("application.contentDensity", Operation.Set, aSupportedByDevice[0]);
+                return;
+            }
+
+            const sBaseDensity = sUserPreference || sDeviceDefault;
+
+            let sCurrentDensity;
+            if (aSupportedByApp.length === 1) {
+                sCurrentDensity = aSupportedByApp[0];
+            } else {
+                sCurrentDensity = sBaseDensity;
+            }
+
+            StateManager.updateAllBaseStates("application.contentDensity", Operation.Set, sBaseDensity);
+            StateManager.updateCurrentState("application.contentDensity", Operation.Set, sCurrentDensity);
+        }
+
+        /**
+         * @returns {string} The default content density for the device type.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        #getDeviceTypeDefault () {
+            if (Device.support.touch) {
+                return "cozy"; // combi, phone, tablet
+            }
+            return "compact"; // desktop
+        }
+
+        /**
+         * @returns {Array<string>} The supported content densities by the device type.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        #getSupportedByDeviceType () {
+            // on pure touch devices, force cozy
+            if (!Device.system.desktop && !Device.system.combi) {
+                return ["cozy"];
+            }
+            return ["cozy", "compact"];
+        }
+
+        /**
+         * @returns {Array<string>} The supported content densities by the application.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        #getSupportedByApp () {
+            const oMetadata = AppConfiguration.getMetadata();
+            const aSupported = [];
+            if (oMetadata.cozyContentDensity) {
+                aSupported.push("cozy");
+            }
+            if (oMetadata.compactContentDensity) {
+                aSupported.push("compact");
+            }
+            return aSupported;
+        }
+
+        /**
+         * Returns the user preference for the content density.
+         * @returns {Promise<string>} The user preference for the content density.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        async #getUserPreference () {
+            const UserInfo = await Container.getServiceAsync("UserInfo");
+            const oUser = UserInfo.getUser();
+            return oUser?.getContentDensity();
+        }
+
+        /**
+         * Only for testing purposes.
+         *
+         * @since 1.135.0
+         * @private
+         */
+        async reset () {
+            const AppLifeCycle = await Container.getServiceAsync("AppLifeCycle");
+            AppLifeCycle?.detachAppLoaded(this.#fnSetContentDensity);
+            this.#aDoables.forEach((oDoable) => oDoable.off());
+
+            this.#fnSetContentDensity = () => {
+                throw new Error("Favicon is not initialized");
+            };
+            this.#bInitialized = false;
+            this.#aDoables = [];
+        }
+    }
+
+    return new ContentDensity();
+});

package/src/main/js/sap/ushell/state/Favicon.js

@@ -0,0 +1,119 @@
+// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview handles favicon.
+ * @version 1.135.0
+ */
+sap.ui.define([
+    "sap/ui/core/Theming",
+    "sap/ui/util/Mobile",
+    "sap/ushell/Config",
+    "sap/ushell/utils"
+], function (
+    Theming,
+    Mobile,
+    Config,
+    ushellUtils
+) {
+    "use strict";
+
+    if (Config.last("/core/navigation/enableAppLifeCycleFallback")) {
+        return {};
+    }
+
+    class Favicon {
+        #fnSetFavicon = () => {
+            throw new Error("Favicon is not initialized");
+        };
+        #bInitialized = false;
+        #aDoables = [];
+
+        init () {
+            if (this.#bInitialized) {
+                return;
+            }
+
+            this.#bInitialized = true;
+            this.#fnSetFavicon = this.#setFavicon.bind(this);
+            Theming.attachApplied(this.#fnSetFavicon);
+            this.#aDoables.push(Config.on("/core/shell/favIcon").do(this.#fnSetFavicon));
+        }
+
+        async #getFavicon () {
+            let sFavicon;
+            let bCustomFavicon = false;
+
+            // custom theme favicon
+            const [sThemingFavicon] = await ushellUtils.getThemingParameters(["sapUiShellFavicon"]);
+            if (sThemingFavicon) {
+                // url('path/to/favicon.ico') -> path/to/favicon.ico
+                const aMatches = /url[\s]*\('?"?([^'")]*)'?"?\)/.exec(sThemingFavicon);
+                if (aMatches) {
+                    sFavicon = aMatches[1];
+                    bCustomFavicon = true;
+                } else if (sThemingFavicon !== "''" && sThemingFavicon !== "none") {
+                    sFavicon = sThemingFavicon;
+                }
+            }
+
+            // configuration favicon
+            const sConfigFavicon = Config.last("/core/shell/favIcon");
+            if (!sFavicon && sConfigFavicon) {
+                sFavicon = sConfigFavicon;
+                bCustomFavicon = true;
+            }
+
+            // default favicon
+            if (!sFavicon) {
+                const sSapUshellModulePath = sap.ui.require.toUrl("sap/ushell");
+                sFavicon = `${sSapUshellModulePath}/themes/base/img/launchpad_favicon.ico`;
+            }
+
+            return {
+                favicon: sFavicon,
+                isCustomFavicon: bCustomFavicon
+            };
+        }
+
+        async #setFavicon () {
+            const { favicon, isCustomFavicon } = await this.#getFavicon();
+
+            let oIconSet;
+            if (isCustomFavicon) {
+                oIconSet = {
+                    phone: favicon,
+                    "phone@2": favicon,
+                    tablet: favicon,
+                    "tablet@2": favicon,
+                    favicon: favicon,
+                    precomposed: false
+                };
+            } else {
+                const sSapUshellModulePath = sap.ui.require.toUrl("sap/ushell");
+                oIconSet = {
+                    phone: `${sSapUshellModulePath}/themes/base/img/launchicons/phone-icon_120x120.png`,
+                    "phone@2": `${sSapUshellModulePath}/themes/base/img/launchicons/phone-retina_180x180.png`,
+                    tablet: `${sSapUshellModulePath}/themes/base/img/launchicons/tablet-icon_152x152.png`,
+                    "tablet@2": `${sSapUshellModulePath}/themes/base/img/launchicons/tablet-retina_167x167.png`,
+                    favicon: favicon,
+                    precomposed: false
+                };
+            }
+
+            Mobile.setIcons(oIconSet);
+        }
+
+        reset () {
+            Theming.detachApplied(this.#fnSetFavicon);
+            this.#aDoables.forEach((oDoable) => oDoable.off());
+
+            this.#fnSetFavicon = () => {
+                throw new Error("Favicon is not initialized");
+            };
+            this.#bInitialized = false;
+            this.#aDoables = [];
+        }
+    }
+
+    return new Favicon();
+});

package/src/main/js/sap/ushell/state/StateManager.js

@@ -122,6 +122,7 @@ sap.ui.define([
                     searchScope: ""
                 },
                 icon: "",
+                contentDensity: "",
                 subTitle: "",
                 relatedApps: [],
                 hierarchy: []

package/src/main/js/sap/ushell/state/StrategyFactory/UserActionsStrategy.js

@@ -42,8 +42,9 @@ sap.ui.define([
                 "EditModeBtn": -2,
                 "ContactSupportBtn": -1,
                 //0 custom items
-                "aboutBtn": 1,
-                "logoutBtn": 2
+                "dataPrivacyBtn": 1,
+                "aboutBtn": 2,
+                "logoutBtn": 3
             };
             /* eslint-enable quote-props */
 

package/src/main/js/sap/ushell/support/plugins/flpConfig/FlpConfigurationPlugin.js

@@ -9,7 +9,7 @@
  * Fiori launchpad in a tree table separated by IconTabFilters for the first level properties of the configuration object.
  * Also it provides a search for last level properties.
  *
- * @version 1.134.1
+ * @version 1.135.0
  */
 sap.ui.define([
     "sap/ui/core/Element",

package/src/main/js/sap/ushell/themes/base/ApplicationContainer.less

@@ -25,7 +25,8 @@
   white-space: normal;
 }
 
-.sapUShellApplicationContainerShiftedIframe {
+.sapUShellApplicationContainerHidden {
+  display: none !important;
 }
 
 .sapUShellApplicationContainerIframeHidden {
@@ -41,4 +42,4 @@
   top: 0;
   left: 0;
   z-index: -9999;
-}
+}

package/src/main/js/sap/ushell/themes/base/FlexibleColumnLayout.less

@@ -0,0 +1,10 @@
+/* =========================================== */
+/* CSS for "sap.f.FlexibleColumnLayout" (base) */
+/* =========================================== */
+
+/* This is an aligned style override for FCL usages within the FLP; more details in: FIORITECHP1-32879 */
+
+.sapFFCL {
+  border-top: var(--sapElement_BorderWidth) solid var(--sapPageHeader_BorderColor);
+  box-sizing: border-box;
+}

package/src/main/js/sap/ushell/themes/base/NavContainer.less

@@ -0,0 +1,6 @@
+/* ============================================= */
+/* CSS for control sap.ushell/NavContainer.control theme base */
+/* ============================================= */
+.sapUShellNavContainerPageHidden {
+  display: none !important;
+}

package/src/main/js/sap/ushell/themes/base/ShellHeader.less

@@ -20,6 +20,13 @@
     box-sizing: border-box;
     -webkit-font-smoothing: antialiased;
     -moz-osx-font-smoothing: grayscale;
+
+    .sapUshellShellHeadItm:not(:first-child),
+    #userActionsMenuHeaderButton:not(:first-child),
+    #shell-header-logo:not(:first-child),
+    #shellAppTitle:not(:first-child) {
+      margin-left: 0.5rem;
+    }
   }
 
   .sapUshellHeaderPlaceHolder {
@@ -77,7 +84,7 @@
     padding: 0.25rem 0;
   }
 
-  .sapUshellShellSearch {
+  .sapUshellShellHeader .sapUshellShellSearch {
     display: inline-block;
     position: relative;
     height: 100%;
@@ -202,13 +209,6 @@
     -webkit-touch-callout: default;
   }
 
-  .sapUshellShellHeadItm:not(:first-child),
-  #userActionsMenuHeaderButton:not(:first-child),
-  #shell-header-logo:not(:first-child),
-  #shellAppTitle:not(:first-child) {
-    margin-left: 0.5rem;
-  }
-
   .sapUshellShellHeadItmDisabled {
     opacity: 0.5;
     cursor: default;

package/src/main/js/sap/ushell/themes/base/library.source.less

@@ -17,6 +17,7 @@
 @import "Dashboard.less";
 @import "DynamicTile.less";
 @import "Factsheet.less";
+@import "FlexibleColumnLayout.less";
 @import "FloatingContainer.less";
 @import "FlpSettings.less";
 @import "GroupList.less";
@@ -25,6 +26,7 @@
 @import "ImageTile.less";
 @import "LoadingDialog.less";
 @import "MenuBar.less";
+@import "NavContainer.less";
 @import "Notifications.less";
 @import "Page.less";
 @import "PictureTile.less";

package/src/main/js/sap/ushell/themes/sap_belize_base/ApplicationContainer.less

@@ -25,7 +25,8 @@
   white-space: normal;
 }
 
-.sapUShellApplicationContainerShiftedIframe {
+.sapUShellApplicationContainerHidden {
+  display: none !important;
 }
 
 .sapUShellApplicationContainerIframeHidden {
@@ -35,3 +36,10 @@
   visibility: hidden;
   pointer-events: none;
 }
+
+.sapUShellApplicationContainerIframeHiddenButActive {
+  position: absolute;
+  top: 0;
+  left: 0;
+  z-index: -9999;
+}

package/src/main/js/sap/ushell/themes/sap_belize_base/NavContainer.less

@@ -0,0 +1,6 @@
+/* ============================================= */
+/* CSS for control sap.ushell/NavContainer.control theme base */
+/* ============================================= */
+.sapUShellNavContainerPageHidden {
+  display: none !important;
+}

package/src/main/js/sap/ushell/themes/sap_belize_base/library.source.less

@@ -25,6 +25,7 @@
 @import "ImageTile.less";
 @import "LoadingDialog.less";
 @import "MenuBar.less";
+@import "NavContainer.less";
 @import "Notifications.less";
 @import "Page.less";
 @import "PictureTile.less";

package/src/main/js/sap/ushell/themes/sap_bluecrystal_base/ApplicationContainer.less

@@ -25,7 +25,8 @@
   white-space: normal;
 }
 
-.sapUShellApplicationContainerShiftedIframe {
+.sapUShellApplicationContainerHidden {
+  display: none !important;
 }
 
 .sapUShellApplicationContainerIframeHidden {
@@ -35,3 +36,10 @@
   visibility: hidden;
   pointer-events: none;
 }
+
+.sapUShellApplicationContainerIframeHiddenButActive {
+  position: absolute;
+  top: 0;
+  left: 0;
+  z-index: -9999;
+}

package/src/main/js/sap/ushell/themes/sap_bluecrystal_base/NavContainer.less

@@ -0,0 +1,6 @@
+/* ============================================= */
+/* CSS for control sap.ushell/NavContainer.control theme base */
+/* ============================================= */
+.sapUShellNavContainerPageHidden {
+  display: none !important;
+}

package/src/main/js/sap/ushell/themes/sap_bluecrystal_base/library.source.less

@@ -24,6 +24,7 @@
 @import "IconFonts.less";
 @import "ImageTile.less";
 @import "LoadingDialog.less";
+@import "NavContainer.less";
 @import "MenuBar.less";
 @import "Notifications.less";
 @import "Page.less";

package/src/main/js/sap/ushell/themes/sap_hcb/base_ApplicationContainer.less

@@ -25,7 +25,8 @@
   white-space: normal;
 }
 
-.sapUShellApplicationContainerShiftedIframe {
+.sapUShellApplicationContainerHidden {
+  display: none !important;
 }
 
 .sapUShellApplicationContainerIframeHidden {
@@ -35,3 +36,10 @@
   visibility: hidden;
   pointer-events: none;
 }
+
+.sapUShellApplicationContainerIframeHiddenButActive {
+  position: absolute;
+  top: 0;
+  left: 0;
+  z-index: -9999;
+}

package/src/main/js/sap/ushell/themes/sap_hcb/base_NavContainer.less

@@ -0,0 +1,6 @@
+/* ============================================= */
+/* CSS for control sap.ushell/NavContainer.control theme base */
+/* ============================================= */
+.sapUShellNavContainerPageHidden {
+  display: none !important;
+}