@sapui5/sap.ushell 1.129.1 → 1.130.1

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

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's personalization service, which provides generic read and write access to the currently logged on user's
  * personalization settings for the app currently executed in the shell.
  *
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/PluginManager/Extensions.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview The extensions which plugins can use to customise the launchpad
  *
- * @version 1.129.1
+ * @version 1.130.1
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/PluginManager/HeaderExtensions.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The extensions for the ShellHeader
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/ushell/EventHub"

package/src/main/js/sap/ushell/services/PluginManager/MenuExtensions.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The extensions for the MenuBar, an interface to let plugins request menu entry providers.
  *
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define(["sap/ushell/Container"], function (Container) {
     "use strict";

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's PluginManager service. Allows handling the loading of Fiori Launchpad plugins.
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/base/Log",

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview resolves references
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/base/Log",
@@ -15,7 +15,6 @@ sap.ui.define([
     "sap/ui/core/format/DateFormat",
     "sap/ui/model/odata/ODataUtils",
     "sap/ui/model/odata/v4/ODataUtils",
-    "sap/ui/thirdparty/jquery",
     "sap/ushell/User",
     "sap/ushell/utils",
     "sap/ushell/Container"
@@ -30,7 +29,6 @@ sap.ui.define([
     DateFormat,
     ODataUtilsV2,
     ODataUtilsV4,
-    jQuery,
     User,
     ushellUtils,
     Container
@@ -45,7 +43,7 @@ sap.ui.define([
          *
          * @param {string} sReference
          *    A reference name like <code>User.env.sap-theme</code>
-         * @returns {jQuery.Promise}
+         * @returns {Promise<{value: string}>}
          *    A promise that is always resolved.
          *    resolved, the promise resolves with a rich object like:
          *    <pre>
@@ -69,8 +67,7 @@ sap.ui.define([
          * @private
          * @since 1.42.0
          */
-        this.getValue = function (sReference) {
-            const oDeferred = new jQuery.Deferred();
+        this.getValue = async function (sReference) {
             let sValue;
 
             if (sReference === "User.env.sap-ui-legacy-date-format") {
@@ -103,9 +100,8 @@ sap.ui.define([
             if (sReference === "User.env.sap-theme-NWBC") {
                 sValue = Container.getUser().getTheme(User.prototype.constants.themeFormat.NWBC);
             }
-            oDeferred.resolve({ value: sValue });
 
-            return oDeferred.promise();
+            return { value: sValue };
         };
     }
 
@@ -149,7 +145,7 @@ sap.ui.define([
          * @param {string[]} aReferences
          *    An array of reference names, like <code>["UserDefault.currency", "User.env.sap-theme-name"... ]</code>.
          * @param {object} [oSystemContext] The systemContext
-         * @returns {jQuery.Promise}
+         * @returns {Promise<object>}
          *    <p>A promise that resolves with an object containing all the
          *    resolved references, or is rejected with an error message if it
          *    was not possible to resolve all the references.</p>
@@ -167,24 +163,11 @@ sap.ui.define([
          * @private
          * @since 1.42.0
          */
-        this.resolveReferences = function (aReferences, oSystemContext) {
-            const oDeferred = new jQuery.Deferred();
+        this.resolveReferences = async function (aReferences, oSystemContext) {
             const aReferencePromises = [];
             let bAllRefsResolvable = true;
             const oDistinctRefs = {};
             const oDistinctEnvRefs = {};
-            const oUserDefaultParametersPromise = Container.getServiceAsync("UserDefaultParameters");
-            let oResolver,
-             oSystemContextPromise;
-
-            if (!oSystemContext) {
-                oSystemContextPromise = Container.getServiceAsync("ClientSideTargetResolution")
-                    .then((oCstr) => {
-                        return oCstr.getSystemContext();
-                    });
-            } else {
-                oSystemContextPromise = Promise.resolve(oSystemContext);
-            }
 
             const aRichRefs = aReferences
                 .map((sRefWithPrefix) => {
@@ -210,66 +193,61 @@ sap.ui.define([
                 });
 
             if (!bAllRefsResolvable) {
-                return oDeferred
-                    .reject("One or more references could not be resolved")
-                    .promise();
+                throw new Error("One or more references could not be resolved");
             }
 
-            Promise.all([
-                oSystemContextPromise,
-                oUserDefaultParametersPromise
-            ])
-                .then((aResults) => {
-                    const oResolvedSystemContext = aResults[0];
-                    const UserDefaultParameters = aResults[1];
-
-                    Object.keys(oDistinctRefs).forEach((sName) => {
-                        aReferencePromises.push(UserDefaultParameters.getValue(sName, oResolvedSystemContext));
-                    });
-
-                    Object.keys(oDistinctEnvRefs).forEach((sName) => {
-                        oResolver = oResolver || this._getUserEnvReferenceResolver();
-                        aReferencePromises.push(ushellUtils.promisify(oResolver.getValue(sName)));
-                    });
-
-                    return Promise.all(aReferencePromises);
-                })
-                .then((aRefValues) => {
-                    const oKnownRefs = {};
-                    let iIndex = 0;
-                    Object.keys(oDistinctRefs).forEach((sName) => {
-                        oDistinctRefs[sName] = aRefValues[iIndex];
-                        iIndex = iIndex + 1;
-                    });
-                    Object.keys(oDistinctEnvRefs).forEach((sName) => {
-                        oDistinctEnvRefs[sName] = aRefValues[iIndex];
-                        iIndex = iIndex + 1;
-                    });
-
-                    // All parameters retrieved successfully and stored in arguments.
-                    aRichRefs.forEach((oRef) => {
-                        let oMergedValue;
-                        if (oRef.full.indexOf("UserDefault.extended.") === 0) {
-                            oMergedValue = this.mergeSimpleAndExtended(oDistinctRefs[oRef.name]);
-                            if (!isEmptyObject(oMergedValue)) {
-                                oKnownRefs[oRef.full] = oMergedValue;
-                            } else {
-                                // even if no value is provided, the property must exist to indicate that the
-                                // reference could be resolved
-                                oKnownRefs[oRef.full] = undefined;
-                            }
-                        } else if (oRef.full.indexOf("UserDefault.") === 0) {
-                            oKnownRefs[oRef.full] = oDistinctRefs[oRef.name].value;
-                        } else if (oRef.full.indexOf("User.env.") === 0) {
-                            oKnownRefs[oRef.full] = oDistinctEnvRefs[oRef.name].value;
-                        } // one of the above branches must have been hit, there can be no else here,
-                        // else  { assert(0); }
-                    });
-
-                    oDeferred.resolve(oKnownRefs);
-                });
+            if (!oSystemContext) {
+                const ClientSideTargetResolution = await Container.getServiceAsync("ClientSideTargetResolution");
+                oSystemContext = await ClientSideTargetResolution.getSystemContext();
+            }
+
+            const UserDefaultParameters = await Container.getServiceAsync("UserDefaultParameters");
+
 
-            return oDeferred.promise();
+
+            Object.keys(oDistinctRefs).forEach((sName) => {
+                aReferencePromises.push(UserDefaultParameters.getValue(sName, oSystemContext));
+            });
+
+            const oUserEnvResolver = this._getUserEnvReferenceResolver();
+            Object.keys(oDistinctEnvRefs).forEach((sName) => {
+                aReferencePromises.push(oUserEnvResolver.getValue(sName));
+            });
+
+            const aRefValues = await Promise.all(aReferencePromises);
+
+            const oKnownRefs = {};
+            let iIndex = 0;
+            Object.keys(oDistinctRefs).forEach((sName) => {
+                oDistinctRefs[sName] = aRefValues[iIndex];
+                iIndex = iIndex + 1;
+            });
+            Object.keys(oDistinctEnvRefs).forEach((sName) => {
+                oDistinctEnvRefs[sName] = aRefValues[iIndex];
+                iIndex = iIndex + 1;
+            });
+
+            // All parameters retrieved successfully and stored in arguments.
+            aRichRefs.forEach((oRef) => {
+                let oMergedValue;
+                if (oRef.full.indexOf("UserDefault.extended.") === 0) {
+                    oMergedValue = this.mergeSimpleAndExtended(oDistinctRefs[oRef.name]);
+                    if (!isEmptyObject(oMergedValue)) {
+                        oKnownRefs[oRef.full] = oMergedValue;
+                    } else {
+                        // even if no value is provided, the property must exist to indicate that the
+                        // reference could be resolved
+                        oKnownRefs[oRef.full] = undefined;
+                    }
+                } else if (oRef.full.indexOf("UserDefault.") === 0) {
+                    oKnownRefs[oRef.full] = oDistinctRefs[oRef.name].value;
+                } else if (oRef.full.indexOf("User.env.") === 0) {
+                    oKnownRefs[oRef.full] = oDistinctEnvRefs[oRef.name].value;
+                } // one of the above branches must have been hit, there can be no else here,
+                // else  { assert(0); }
+            });
+
+            return oKnownRefs;
         };
 
         /**
@@ -530,7 +508,7 @@ sap.ui.define([
          *  URL containing User Default parameter names like
          *  /some/url/?param1={%%UserDefault.CompanyCode%%}&param2={Edm.String%%UserDefault.CostCenter%%}&param3={%%abc%%}
          * @param {object} [oSystemContext] The systemContext
-         * @returns {jQuery.Promise} Resolves an Object
+         * @returns {Promise<object>} Resolves an Object
          *  like:
          *  <pre>
          *  {
@@ -547,41 +525,37 @@ sap.ui.define([
          *
          * @private
          */
-        this.resolveUserDefaultParameters = function (sUrl, oSystemContext) {
-            const oDeferred = new jQuery.Deferred();
+        this.resolveUserDefaultParameters = async function (sUrl, oSystemContext) {
 
             const oPlaceholders = this._extractUrlPlaceholders(sUrl, /^UserDefault\.(?!extended\.).+/);
             const aSimpleUserDefaultReferences = oPlaceholders.extractedReferences;
             const aIgnoredReferences = oPlaceholders.ignoredReferences;
 
             if (aSimpleUserDefaultReferences.length === 0) {
-                oDeferred.resolve({
+                return {
                     url: sUrl,
                     defaultsWithoutValue: [],
                     ignoredReferences: aIgnoredReferences
-                });
-                return oDeferred.promise();
+                };
             }
 
             const aReferenceNames = aSimpleUserDefaultReferences.map((oReference) => {
                 return oReference.name;
             });
 
-            ushellUtils.promisify(this.resolveReferences(aReferenceNames, oSystemContext))
-                .then((oResolvedDefaults) => {
-                    aSimpleUserDefaultReferences.forEach((oPlaceholder) => {
-                        oPlaceholder.value = oResolvedDefaults[oPlaceholder.name];
-                    });
-                    const oReplacementResult = this._replaceUrlPlaceholders(sUrl, aSimpleUserDefaultReferences);
-
-                    oDeferred.resolve({
-                        url: oReplacementResult.resolvedUrl,
-                        defaultsWithoutValue: oReplacementResult.placeholdersWithoutValue,
-                        ignoredReferences: aIgnoredReferences
-                    });
-                });
+            const oResolvedDefaults = await this.resolveReferences(aReferenceNames, oSystemContext);
+
+            aSimpleUserDefaultReferences.forEach((oPlaceholder) => {
+                oPlaceholder.value = oResolvedDefaults[oPlaceholder.name];
+            });
+            const oReplacementResult = this._replaceUrlPlaceholders(sUrl, aSimpleUserDefaultReferences);
+
+            return {
+                url: oReplacementResult.resolvedUrl,
+                defaultsWithoutValue: oReplacementResult.placeholdersWithoutValue,
+                ignoredReferences: aIgnoredReferences
+            };
 
-            return oDeferred.promise();
         };
 
         /**

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's search service which provides Enterprise Search via SINA.
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define(["sap/ui/core/Lib"], function (Library) {
     "use strict";

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

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's Search for myHome.
  *
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/base/Log",

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module exposes the searchable content.
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/ushell/Config",

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview Shell Navigation Service.
- * @version 1.129.1
+ * @version 1.130.1
  * @deprecated since 1.120. Use {@link sap.ushell.services.Navigation} for Navigation instead.
  */
 sap.ui.define([

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

@@ -12,7 +12,7 @@
  * it is pertinent that the API user employs this service's version of <code>toExternal()</code> for cross application
  * navigation (instead) of using the one provided by CrossApplicationNavigation service.</p>
  *
- * @version 1.129.1
+ * @version 1.130.1
  *
  * @deprecated since 1.112. This service has been deprecated. Please use the CrossApplicationNavigation service instead.
  */

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview APIs for the S/4 MyHome
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/ushell/Config",

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

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's UI tracing service.
  *
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/ushell/EventHub",

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

@@ -6,7 +6,7 @@
  * Service wrapper for the sap/ushell/utils/UrlShortening module.
  * @deprecated since 1.118. Please use the UrlShortening module directly.
  *
- * @version 1.129.1
+ * @version 1.130.1
  */
  sap.ui.define(["sap/ushell/utils/UrlShortening"], function (UrlShortening) {
     "use strict";

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

@@ -1,7 +1,7 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 /**
  * @fileOverview The URLTemplate service provides utilities when working with URL templates
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/ushell/utils",

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

@@ -3,7 +3,7 @@
  * @fileOverview Helper functions for <code>sap.ushell.services.Ui5ComponentLoader
  *  This is a shell-internal service and no public or application facing API!
  *
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/base/Log",
@@ -101,6 +101,7 @@ sap.ui.define([
         return bLoadDefaultDependencies;
     }
 
+    // todo: [FLPCOREANDUX-10024] Get rid of this calculation
     function constructAppComponentId (oParsedShellHash) {
         var sSemanticObject = oParsedShellHash.semanticObject || null;
         var sAction = oParsedShellHash.action || null;

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

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's UI5 component loader service.
  * This is a shell-internal service and no public or application facing API!
  *
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/base/Log",

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.129.1
+ * @version 1.130.1
  */
 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.129.1
+ * @version 1.130.1
  */
 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.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/base/Log",

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

@@ -2,20 +2,20 @@
 
 /**
  * @fileOverview The Unified Shell's user activity service.
- * @version 1.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/base/util/ObjectPath",
     "sap/ushell/services/UserRecents/RecentsList",
     "sap/ushell/services/UserRecents/RecentActivity",
     "sap/ushell/services/UserRecents/RecentAppsUsage",
-    "sap/ushell/utils"
+    "sap/ushell/utils/UrlParsing"
 ], function (
     ObjectPath,
     RecentsList,
     RecentActivity,
     RecentAppsUsage,
-    ushellUtils
+    UrlParsing
 ) {
     "use strict";
 
@@ -372,7 +372,7 @@ sap.ui.define([
      * @private
      */
     UserRecents.prototype.addAppUsage = async function (sHash) {
-        const sRelevantHash = ushellUtils.getBasicHash(sHash);
+        const sRelevantHash = UrlParsing.getBasicHash(sHash);
 
         await this.oAppsUsage.addAppUsage(sRelevantHash);
     };

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

@@ -7,7 +7,7 @@
  *
  * Configured with the LaunchPageAdapter.
  *
- * @version 1.129.1
+ * @version 1.130.1
  */
 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.129.1
+ * @version 1.130.1
  */
 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.129.1
+ * @version 1.130.1
  * @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.129.1
+ * @version 1.130.1
  * @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.129.1
+ * @version 1.130.1
  * @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.129.1
+ * @version 1.130.1
  * @private
  */
 sap.ui.define([

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

@@ -36,6 +36,35 @@ sap.ui.define([
          */
         #configModel = Config.createModel("/core/shell/model", JSONModel);
 
+        constructor () {
+            this.#overwriteModelRefresh(this.#model);
+        }
+
+        /**
+         * Overwrites the <code>refresh</code> method of the given model
+         * to throw an error when <code>bForceUpdate</code> is set.
+         * @param {sap.ui.model.Model} oModel The model to overwrite the <code>refresh</code> method of.
+         *
+         * @since 1.130.0
+         * @private
+         */
+        #overwriteModelRefresh (oModel) {
+            const fnOriginalRefresh = oModel.refresh.bind(oModel);
+
+            oModel.refresh = function refresh (bForceUpdate) {
+                if (bForceUpdate) {
+                    /*
+                     * The force update invalidates the shell model and triggers a rerendering of the entire shell.
+                     * This leads to issues in stateful extensions like the floating container. This might contain an iframe
+                     * which would be reloaded leading to performance regressions.
+                     * Instead the refresh should be done based on binding paths via {@link sap.ushell.state.StateManager#refreshState}.
+                     */
+                    throw new Error("The shell model does not support force update.");
+                }
+                fnOriginalRefresh();
+            };
+        }
+
         /**
          * Updates the model with the given state data.
          * Should only be called by the state manager.
@@ -91,6 +120,8 @@ sap.ui.define([
 
             this.#model = new RestrictedJSONModel();
             this.#configModel = Config.createModel("/core/shell/model", JSONModel);
+
+            this.#overwriteModelRefresh(this.#model);
         }
 
         /**

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

@@ -338,6 +338,34 @@ sap.ui.define([
             this.#updateModel();
         }
 
+        /**
+         * Updates only the provided path and its sub paths.
+         * Alternative to the {@link sap.ui.model.Model#refresh} method.
+         * @param {sap.ushell.state.StateManager.Path} sPath The path to the data that should be refreshed.
+         *
+         * @since 1.130.0
+         * @private
+         */
+        refreshState (sPath) {
+            const oModel = ShellModel.getModel();
+            const aBindings = oModel.getBindings();
+            const sBindingPath = `/${sPath.replace(/\./g, "/")}`;
+
+            const aRelevantBindings = aBindings.filter((oBinding) => {
+                const sResolvedPath = oBinding.getResolvedPath();
+                if (!sResolvedPath) {
+                    // the binding is not resolved (yet).
+                    // e.g. relative binding before parent context is set
+                    return false;
+                }
+                return sResolvedPath.startsWith(sBindingPath);
+            });
+
+            aRelevantBindings.forEach(function (oBinding) {
+                oBinding.refresh(true);
+            });
+        }
+
         /**
          * Adds a control to the list of managed controls.
          * Managed controls are destroyed in sync with the application.

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.129.1
+ * @version 1.130.1
  */
 sap.ui.define([
     "sap/ui/core/Element",