@sapui5/sap.ushell 1.138.1 → 1.139.1

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.138.1
+ * @version 1.139.1
  */
 sap.ui.define([
     "sap/base/Log",
@@ -22,13 +22,13 @@ sap.ui.define([
     "sap/base/util/ObjectPath",
     "sap/ushell/Container",
     "sap/ushell/utils"
-], function (
+], (
     Log,
     deepExtend,
     ObjectPath,
     Container,
     ushellUtils
-) {
+) => {
     "use strict";
 
     const aValidProperties = [
@@ -54,8 +54,8 @@ sap.ui.define([
      * </pre>
      *
      * @param {object} oAdapter The service adapter for the UserDefaultParameterPersistence service, as already provided by the container
-     * @param {object} oContainerInterface interface
-     * @param {string} sParameter Service instantiation
+     * @param {object} oContainerInterface interface (not in use)
+     * @param {string} sParameter Service instantiation (not in use)
      * @param {object} oConfig Service configuration (not in use)
      *
      * @hideconstructor
@@ -63,7 +63,7 @@ sap.ui.define([
      * @since 1.32.0
      * @private
      */
-    function UserDefaultParameterPersistence (oAdapter/*, oContainerInterface, sParameter, oConfig*/) {
+    function UserDefaultParameterPersistence (oAdapter, oContainerInterface, sParameter, oConfig) {
         this._oAdapter = oAdapter;
         this._oData = {};
     }
@@ -123,7 +123,7 @@ sap.ui.define([
 
         ObjectPath.set([oSystemContext.id, sParameterName], oCleansedValue, this._oData);
 
-        Log.debug(`[UserDefaults] Fetched "${ sParameterName }" for SystemContext=${ oSystemContext.id } from Persistence`, JSON.stringify(oCleansedValue, null, 2));
+        Log.debug(`[UserDefaults] Fetched "${sParameterName}" for SystemContext=${oSystemContext.id} from Persistence`, JSON.stringify(oCleansedValue, null, 2));
 
         return oCleansedValue;
     };
@@ -152,12 +152,12 @@ sap.ui.define([
         const oCleansedValueObject = this._cleanseValue(oValueObject);
 
         if (oValueObject && oValueObject.noStore === true) {
-            Log.debug(`[UserDefaults] Skipped Save "${ sParameterName }" for SystemContext=${ oSystemContext.id}`, "noStore=true");
+            Log.debug(`[UserDefaults] Skipped Save "${sParameterName}" for SystemContext=${oSystemContext.id}`, "noStore=true");
 
             return;
         }
 
-        Log.debug(`[UserDefaults] Saving "${ sParameterName }" for SystemContext=${ oSystemContext.id } to Persistence`, JSON.stringify(oCleansedValueObject, null, 2));
+        Log.debug(`[UserDefaults] Saving "${sParameterName}" for SystemContext=${oSystemContext.id} to Persistence`, JSON.stringify(oCleansedValueObject, null, 2));
 
         ObjectPath.set([oSystemContext.id, sParameterName], oCleansedValueObject, this._oData);
         return ushellUtils.promisify(this._oAdapter.saveParameterValue(sParameterName, oCleansedValueObject, oSystemContext));
@@ -180,7 +180,7 @@ sap.ui.define([
         }
 
         if (this._oData[oSystemContext.id]) {
-            Log.debug(`[UserDefaults] Deleting "${ sParameterName }" for SystemContext=${ oSystemContext.id } from Persistence`);
+            Log.debug(`[UserDefaults] Deleting "${sParameterName}" for SystemContext=${oSystemContext.id} from Persistence`);
 
             delete this._oData[oSystemContext.id][sParameterName];
         }

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.138.1
+ * @version 1.139.1
  */
 sap.ui.define([
     "sap/base/Log",
@@ -18,7 +18,7 @@ sap.ui.define([
     "sap/ui/base/EventProvider",
     "sap/ushell/utils",
     "sap/ushell/Container"
-], function (
+], (
     Log,
     deepClone,
     deepEqual,
@@ -27,7 +27,7 @@ sap.ui.define([
     EventProvider,
     ushellUtils,
     Container
-) {
+) => {
     "use strict";
 
     const sEventNameValueStored = "valueStored";
@@ -149,8 +149,8 @@ sap.ui.define([
 
                     return oResolveValue;
                 } catch {
-                    Log.error(`invocation of getUserDefault("${ sParameterName }") for plugin ${ this._getComponentNameOfPlugin(oPlugin) } rejected.`, null,
-                                "sap.ushell.services.UserDefaultParameters");
+                    Log.error(`invocation of getUserDefault("${sParameterName}") for plugin ${this._getComponentNameOfPlugin(oPlugin)} rejected.`, null,
+                        "sap.ushell.services.UserDefaultParameters");
                 }
             }
 
@@ -216,7 +216,7 @@ sap.ui.define([
 
                     return this._saveParameterValue(sParameterName, oValueObject, bFromEditor, bRemoveExtendedValue, oSystemContext);
                 } catch {
-                    Log.error(`Cannot save value for ${ sParameterName }. One or more plugins could not be loaded.`);
+                    Log.error(`Cannot save value for ${sParameterName}. One or more plugins could not be loaded.`);
                 }
             }
 
@@ -379,7 +379,7 @@ sap.ui.define([
             const oResult = await this._getUserDefaultParameterNames(oSystemContext);
 
             if (!oResult.aAllParameterNames || oResult.aAllParameterNames.indexOf(sParamName) === -1) {
-                Log.error(`The given parameter "${ sParamName }" is not part of the list of parameters for the given system context.`);
+                Log.error(`The given parameter "${sParamName}" is not part of the list of parameters for the given system context.`);
                 return false;
             }
             return true;
@@ -420,7 +420,6 @@ sap.ui.define([
                 }
             } catch { /* always resolve */ }
 
-
             return false;
         };
 
@@ -512,8 +511,8 @@ sap.ui.define([
 
         /**
          * Converts an array of parameter names to an object with the parameter names as keys.
-         * @param {string[]} aParameterNames
-         * @returns {Object<string, object>}
+         * @param {string[]} aParameterNames the parameters in an array format.
+         * @returns {object<string, object>} the parameters in an object format.
          *
          * @private
          */
@@ -556,8 +555,8 @@ sap.ui.define([
 
                         return oResultMetadata;
                     } catch (error) {
-                        Log.error(`Error invoking getEditorMetaData on plugin: ${ error }${error.stack}`, null,
-                        "sap.ushell.services.UserDefaultParameters");
+                        Log.error(`Error invoking getEditorMetaData on plugin: ${error}${error.stack}`, null,
+                            "sap.ushell.services.UserDefaultParameters");
                         return;
                     }
                 }
@@ -606,7 +605,7 @@ sap.ui.define([
                 }
             });
             if (aParameterNamesWithoutMetadata.length > 0) {
-                Log.error(`The following parameter names have no editor metadata and thus likely no configured plugin:\n"${ aParameterNamesWithoutMetadata.join("\",\n\"") }".`);
+                Log.error(`The following parameter names have no editor metadata and thus likely no configured plugin:\n"${aParameterNamesWithoutMetadata.join("\",\n\"")}".`);
             }
             return oParametersDeepCopy;
         };

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

@@ -3,24 +3,22 @@
 /**
  * @fileOverview The Unified Shell's user information service. Allows retrieving information about the logged-in user.
  *
- * @version 1.138.1
+ * @version 1.139.1
  */
 sap.ui.define([
     "sap/base/Log",
-    "sap/ushell/Config",
     "sap/ushell/User",
     "sap/ushell/Container"
-], function (
+], (
     Log,
-    Config,
     User,
     Container
-) {
+) => {
     "use strict";
 
     // To not overload the adapter implementation on any platform, we memorize the Promises,
     // so we can return the same for each method call
-    var mAdapterPromises = {
+    const mAdapterPromises = {
         themeList: null,
         languageList: null,
         userSettingList: null
@@ -141,7 +139,7 @@ sap.ui.define([
          * @returns {Promise<sap.ushell.services.UserInfo.ShellUserInfo>}
          *      Object providing information about the logged-in user.
          *
-         * @since 1.71.0
+         * @since 1.115.0
          * @public
          */
         this.getShellUserInfo = function () {
@@ -175,13 +173,27 @@ sap.ui.define([
             if (mAdapterPromises.themeList) {
                 return mAdapterPromises.themeList;
             }
-            var oPromise = oAdapter.getThemeList();
+            const oPromise = oAdapter.getThemeList();
             mAdapterPromises.themeList = oPromise;
-            oPromise.fail(function () {
+            oPromise.fail(() => {
                 Log.error("getThemeList failed");
             });
             return oPromise;
         };
+        /**
+         * Delegates the possibility to retrieve an updated theme root
+         * for a theme that is meant to be set later.
+         *
+         * @param {string} sThemeId ID of the to-be-set theme
+         */
+        this.updateThemeRoot = async function (sThemeId) {
+            if (oAdapter.getThemeRoot) {
+                const sThemeRoot = await oAdapter.getThemeRoot(sThemeId);
+                if (sThemeRoot !== undefined) {
+                    Container.getUser().addThemeRootForTheme({id: sThemeId, root:sThemeRoot});
+                }
+            }
+        };
 
         /**
          * Sends the updated user attributes to the adapter.
@@ -191,8 +203,8 @@ sap.ui.define([
          * @private
          */
         this.updateUserPreferences = function () {
-            var oPromise = oAdapter.updateUserPreferences(Container.getUser());
-            oPromise.fail(function () {
+            const oPromise = oAdapter.updateUserPreferences(Container.getUser());
+            oPromise.fail(() => {
                 Log.error("updateAttributes: ");
             });
             return oPromise;
@@ -210,9 +222,9 @@ sap.ui.define([
             if (mAdapterPromises.languageList) {
                 return mAdapterPromises.languageList;
             }
-            var oPromise = oAdapter.getLanguageList();
+            const oPromise = oAdapter.getLanguageList();
             mAdapterPromises.languageList = oPromise;
-            oPromise.fail(function () {
+            oPromise.fail(() => {
                 Log.error("getLanguageList failed");
             });
             return oPromise;
@@ -228,9 +240,9 @@ sap.ui.define([
             if (mAdapterPromises.userSettingList) {
                 return mAdapterPromises.userSettingList;
             }
-            var oPromise = oAdapter.getUserProfilePropertyValueLists();
+            const oPromise = oAdapter.getUserProfilePropertyValueLists();
             mAdapterPromises.userSettingList = oPromise;
-            oPromise.fail(function () {
+            oPromise.fail(() => {
                 Log.error("getUserProfilePropertyValueLists failed");
             });
             return oPromise;

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

@@ -9,7 +9,7 @@ sap.ui.define([
     "sap/ushell/library",
     "sap/ushell/services/UserRecents/UserRecentsBase",
     "sap/ushell/utils/UrlParsing"
-], function (
+], (
     Log,
     extend,
     Device,
@@ -18,7 +18,7 @@ sap.ui.define([
     ushellLibrary,
     UserRecentsBase,
     UrlParsing
-) {
+) => {
     "use strict";
 
     // shortcut for sap.ushell.AppType
@@ -276,7 +276,6 @@ sap.ui.define([
         return "mobile";
     };
 
-
     /**
      * getRecentItems return last RecentActivity.ITEM_COUNT activities for current device.
      *   - Check if for the current device we have unresolved entries.
@@ -303,7 +302,7 @@ sap.ui.define([
             bNewDayAdded = true;
         }
 
-        //collect all unresolved activities for current device.
+        // collect all unresolved activities for current device.
         const oUnresolvedActivities = oRecentActivityContainer.recentUsageArray.reduce((oUnresolved, oMetadata, iIndex) => {
             if (oMetadata[sCurrentDevice] === undefined) {
                 const { url: sUrl } = oMetadata.oItem;
@@ -405,7 +404,7 @@ sap.ui.define([
             }
         }
         // Sort in descending order according to the count
-        aFrequentActivity.sort(function (a, b) {
+        aFrequentActivity.sort((a, b) => {
             return b.iCount - a.iCount;
         });
         // Take only first items (ITEM_COUNT most frequent items)
@@ -420,7 +419,7 @@ sap.ui.define([
      * @private
      */
     RecentActivity.prototype._addNewDay = function (oRecentActivityContainer) {
-        oRecentActivityContainer.recentUsageArray.forEach(function (oMetadata) {
+        oRecentActivityContainer.recentUsageArray.forEach((oMetadata) => {
             // initialize the array if it doesn't exist
             if (!oMetadata.aUsageArray) {
                 oMetadata.aUsageArray = [];
@@ -467,7 +466,7 @@ sap.ui.define([
         };
 
         // Validate entries
-        oRecentActivities.recentUsageArray = oRecentActivities.recentUsageArray.filter(function (oMetadata) {
+        oRecentActivities.recentUsageArray = oRecentActivities.recentUsageArray.filter((oMetadata) => {
             const bIsValid = !!oMetadata?.oItem?.url;
             if (!bIsValid) {
                 Log.error("FLP Recent Activity", oMetadata, "is not valid. The activity is removed from the list.");

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

@@ -3,11 +3,11 @@ sap.ui.define([
     "sap/base/Log",
     "sap/ushell/services/UserRecents/UserRecentsBase",
     "sap/ushell/utils"
-], function (
+], (
     Log,
     UserRecentsBase,
     ushellUtils
-) {
+) => {
     "use strict";
 
     /**
@@ -128,8 +128,8 @@ sap.ui.define([
         await this.init();
 
         const oUsageMap = {};
-        let iMaxUsage,
-            iMinUsage;
+        let iMaxUsage;
+        let iMinUsage;
         let bFirstHashUsage = true;
 
         for (const sHash in this.oAppsUsageData.recentAppsUsageMap) {
@@ -198,7 +198,7 @@ sap.ui.define([
      */
     RecentAppsUsage.prototype._getHashUsageSum = function (sHash) {
         const aAppUsages = this.oAppsUsageData.recentAppsUsageMap[sHash];
-        return aAppUsages.reduce(function (iSum, iUsages) {
+        return aAppUsages.reduce((iSum, iUsages) => {
             return iSum + iUsages;
         }, 0);
     };

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

@@ -1,9 +1,9 @@
 // Copyright (c) 2009-2025 SAP SE, All Rights Reserved
 sap.ui.define([
     "sap/ushell/services/UserRecents/UserRecentsBase"
-], function (
+], (
     UserRecentsBase
-) {
+) => {
     "use strict";
 
     /**

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

@@ -3,11 +3,11 @@ sap.ui.define([
     "sap/base/Log",
     "sap/ui/base/Object",
     "sap/ushell/Container"
-], function (
+], (
     Log,
     BaseObject,
     Container
-) {
+) => {
     "use strict";
 
     /**

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's user activity service.
- * @version 1.138.1
+ * @version 1.139.1
  */
 sap.ui.define([
     "sap/base/util/ObjectPath",
@@ -10,13 +10,13 @@ sap.ui.define([
     "sap/ushell/services/UserRecents/RecentActivity",
     "sap/ushell/services/UserRecents/RecentAppsUsage",
     "sap/ushell/utils/UrlParsing"
-], function (
+], (
     ObjectPath,
     RecentsList,
     RecentActivity,
     RecentAppsUsage,
     UrlParsing
-) {
+) => {
     "use strict";
 
     /**