@sapui5/sap.ushell 1.117.2 → 1.119.0

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

@@ -9,6 +9,7 @@ sap.ui.define([
     "sap/ushell/utils/UrlShortening",
     "sap/ushell/utils/UrlParsing",
     "sap/ui/core/routing/HashChanger",
+    "sap/ui/performance/trace/Interaction",
     "sap/ui/thirdparty/hasher",
     "sap/ushell/TechnicalParameters",
     "sap/base/util/merge",
@@ -21,6 +22,7 @@ sap.ui.define([
     UrlShortening,
     UrlParsing,
     HashChanger,
+    Interaction,
     hasher,
     TechnicalParameters,
     merge,
@@ -89,6 +91,9 @@ sap.ui.define([
         }
     };
 
+    const sModuleName = "ShellNavigationHashChanger";
+    const sLogFesrPrefix = "[FesrFlp]";
+
     var ShellNavigationHashChanger = HashChanger.extend("sap.ushell.services.ShellNavigationHashChanger", {
         constructor: function (oConfig) {
             this.oServiceConfig = oConfig;
@@ -131,7 +136,7 @@ sap.ui.define([
     /**
      * Obtains the current shell hash (with #) urlDecoded
      * Shortened(!)
-     * @return {object} Object containing the shell hash
+     * @returns {object} Object containing the shell hash
      * @private
      */
     ShellNavigationHashChanger.prototype.privgetCurrentShellHash = function () {
@@ -145,7 +150,7 @@ sap.ui.define([
      * Internally constructs the next hash, with #
      * shortened(!)
      * @param {string} sAppSpecific Application specific hash
-     * @return {string} constructed full hash
+     * @returns {string} constructed full hash
      * @private
      */
     ShellNavigationHashChanger.prototype.privconstructHash = function (sAppSpecific) {
@@ -157,7 +162,7 @@ sap.ui.define([
     /**
      * internal, without #
      * @param {object} oShellHash shell hash concept
-     * @return {string} return constructed string
+     * @returns {string} return constructed string
      * @private
      */
     ShellNavigationHashChanger.prototype.privconstructShellHash = function (oShellHash) {
@@ -265,7 +270,7 @@ sap.ui.define([
      * @param {object} AppStateService The AppState service
      * @param {object} oComponent a ui5 component
      * @param {boolean} [bTransient] whether the AppState is supposed to be transient
-     * @constructor
+     * @class
      * @alias sap.ushell.services.StoreContext
      * @class
      */
@@ -335,7 +340,7 @@ sap.ui.define([
 
     /// protected API, only used by shell services
     /**
-     * Returns a string which can be put into the DOM (e.g. in a link tag)
+     * Returns a string which can be put into the DOM (e.g. in a link tag), asynchronously.
      * Please use CrossApplicationNavigation service and do not invoke this method directly
      * if you are an application.
      *
@@ -369,13 +374,7 @@ sap.ui.define([
      *    instead of a string.
      * @param {object} [oComponent]
      *    an optional instance of sap.ui.core.UIComponent
-     * @param {boolean} [bAsync]
-     *    indicates whether the method should return the result
-     *    asynchronously. When set to <code>true</code>, the method
-     *    returns a jQuery Deferred object that is resolved only after
-     *    the URLShortening save operation is completed.
-     *
-     * @returns {object}
+     * @returns {Promise<object>}
      *    <p>a string that can be put into an href attribute of an
      *    HTML anchor.  The returned string will always start with a
      *    hash character.</p>
@@ -398,12 +397,12 @@ sap.ui.define([
      * <li><code>skippedParams</code> is an object containing truncated parameters if truncation occurred or undefined if not</li>
      * </ul>
      *
-     * @methodOf sap.ushell.services.ShellNavigation#
+     * @memberof sap.ushell.services.ShellNavigation#
      * @name hrefForExternal
      * @since 1.15.0
      * @private
      */
-    ShellNavigationHashChanger.prototype.hrefForExternal = function (oArgs, bVerbose, oComponent, bAsync) {
+    ShellNavigationHashChanger.prototype.hrefForExternal = function (oArgs, bVerbose, oComponent) {
         // must encode the result
         function encodeResult (vResult, bIsVerbose) {
             if (bIsVerbose === true) {
@@ -414,16 +413,84 @@ sap.ui.define([
             return vResult;
         }
 
-        if (bAsync) {
-            var oDeferred = new jQuery.Deferred();
-
-            this.hrefForExternalNoEncAsync(oArgs, bVerbose, oComponent)
-                .then(function (vResult) {
-                    oDeferred.resolve(encodeResult(vResult, bVerbose));
-                })
-                .catch(oDeferred.reject.bind(oDeferred));
+        return this.hrefForExternalNoEncAsync(oArgs, bVerbose, oComponent).then(function (vResult) {
+            return encodeResult(vResult, bVerbose);
+        });
+    };
 
-            return oDeferred;
+    /**
+     * Returns a string which can be put into the DOM (e.g. in a link tag), synchronously.
+     * Please use CrossApplicationNavigation service and do not invoke this method directly
+     * if you are an application.
+     *
+     * @param {object} oArgs
+     *     object encoding a semantic object and action
+     *     e.g.:
+     *     <pre>
+     *     {
+     *        target: {
+     *            semanticObject: "AnObject",
+     *            action: "Action"
+     *        },
+     *        params: {
+     *            A: "B"
+     *        }
+     *     }
+     *     </pre>
+     *
+     *     or
+     *
+     *     <pre>
+     *     {
+     *         target: {
+     *             shellHash: "SO-36&jumper=postman"
+     *         }
+     *     }
+     *     </pre>
+     * @param {boolean} [bVerbose]
+     *    whether the response should be returned in verbose format. If
+     *    this flag is set to true, this function returns an object
+     *    instead of a string.
+     * @param {object} [oComponent]
+     *    an optional instance of sap.ui.core.UIComponent
+     * @returns {object}
+     *    <p>a string that can be put into an href attribute of an
+     *    HTML anchor.  The returned string will always start with a
+     *    hash character.</p>
+     *
+     *    <p>
+     *    In case the <b>bVerbose</b> parameter is set to true, an
+     *    object that wraps the result string will be returned
+     *    instead:
+     *    <pre>
+     *    { hash : {string},
+     *      params : {object}
+     *      skippedParams : {object}
+     *    }
+     *    </pre>
+     *    </p>
+     *
+     * where:
+     * <ul>
+     * <li><code>params</code> is an object containing non-truncated parameters</li>
+     * <li><code>skippedParams</code> is an object containing truncated parameters if truncation occurred or undefined if not</li>
+     * </ul>
+     *
+     * @memberof sap.ushell.services.ShellNavigation#
+     * @name hrefForExternal
+     * @since 1.119.0
+     * @deprecated since 1.119.0 Please use {@link #hrefForExternal} instead.
+     * @private
+     */
+    ShellNavigationHashChanger.prototype.hrefForExternalSync = function (oArgs, bVerbose, oComponent) {
+        // must encode the result
+        function encodeResult (vResult, bIsVerbose) {
+            if (bIsVerbose === true) {
+                vResult.hash = encodeURI(vResult.hash);
+            } else {
+                vResult = encodeURI(vResult);
+            }
+            return vResult;
         }
 
         var vResult = this.hrefForExternalNoEnc(oArgs, bVerbose, oComponent);
@@ -434,7 +501,7 @@ sap.ui.define([
      * Behaves as {@link #hrefForExternal} but does not encode the
      * returned intents with encodeURI.
      *
-     * @param {Object} oArgs
+     * @param {object} oArgs
      *     object encoding a semantic object and action
      * @param {boolean} [bVerbose]
      *    whether the response should be returned in verbose format.
@@ -448,10 +515,10 @@ sap.ui.define([
      *    <p>a string that can be put into an href attribute of an
      *    HTML anchor.</p>
      *
-     * @methodOf sap.ushell.services.ShellNavigation#
+     * @memberof sap.ushell.services.ShellNavigation#
      * @name hrefForExternal
      * @see {@link #hrefForExternal}
-     * @deprecated since 1.108. Please use {@link #hrefForExternalNoEncAsync} instead.
+     * @deprecated since 1.108.0 Please use {@link #hrefForExternalNoEncAsync} instead.
      * @since 1.32.0
      * @private
      */
@@ -493,7 +560,7 @@ sap.ui.define([
      * Behaves as {@link #hrefForExternal} but does not encode the
      * returned intents with encodeURI.
      *
-     * @param {Object} oArgs
+     * @param {object} oArgs
      *     object encoding a semantic object and action
      * @param {boolean} [bVerbose]
      *    whether the response should be returned in verbose format.
@@ -540,17 +607,16 @@ sap.ui.define([
      * Shortened(!)
      * @param {object} oArgs arguments
      * @param {object} oSaveContext Save context
-     * @return {string} Shell hash
+     * @returns {string} Shell hash
      */
     ShellNavigationHashChanger.prototype.privhrefForExternalNoEnc = function (oArgs, oSaveContext) {
-        var r;
         if (oArgs === undefined) {
             return this.privgetCurrentShellHash();
         }
         // construct url
         if (oArgs && oArgs.target && (typeof oArgs.target.semanticObject === "string" || typeof oArgs.target.shellHash === "string")) {
-            r = "#" + this.privconstructShellHash(oArgs);
-            return UrlShortening.compactHash(r, undefined, oSaveContext);
+            const sHash = "#" + this.privconstructShellHash(oArgs);
+            return UrlShortening.compactHash(sHash, undefined, oSaveContext);
         }
         return this.privgetCurrentShellHash();
     };
@@ -576,7 +642,7 @@ sap.ui.define([
      *
      * example: hrefForAppSpecificHash("View1/details/0/") returns
      * "#MyApp-Display&/View1/details/0/"
-     * @methodOf sap.ushell.services.ShellNavigation#
+     * @memberof sap.ushell.services.ShellNavigation#
      * @name parseShellHash
      * @since 1.15.0
      * @private
@@ -590,18 +656,18 @@ sap.ui.define([
      * Navigate to an external target
      * Please use CrossApplicationNavigation service and do not invoke this method directly!
      *
-     * @param {Object} oArgs  configuration object describing the target
+     * @param {object} oArgs  configuration object describing the target
      *
      *  e.g. { target : { semanticObject : "AnObject", action: "Action" },
      *         params : { A : "B" } }
      *
      * constructs sth. like    http://....ushell#AnObject-Action?A=B ....
      * and navigates to it.
-     * @param {Object} oComponent runtime
+     * @param {object} oComponent runtime
      * @param {boolean} bWriteHistory
      *     set to false to invoke replaceHash
      *
-     * @returns {Promise<void>} A Promise which resolves after the navigation was triggered
+     * @returns {Promise<undefined>} A Promise which resolves after the navigation was triggered
      *
      * @private
      */
@@ -633,7 +699,7 @@ sap.ui.define([
      * This will start listening to hash changes and also fire a hash changed event with the initial hash.
      * @param {function} fnShellCallback Shell callback
      * @protected
-     * @return {boolean} false if it was initialized before, true if it was initialized the first time
+     * @returns {boolean} false if it was initialized before, true if it was initialized the first time
      */
     ShellNavigationHashChanger.prototype.initShellNavigation = function (fnShellCallback) {
         if (this._initializedByShellNav) {
@@ -661,7 +727,7 @@ sap.ui.define([
      * The init method of the base class is overridden, because the hasher initialization (registration for hash changes) is already done
      * in <code>initShellNavigation</code> method. The application-specific initialization ensures that the application receives a hash change event for the
      * application-specific part if set in the  initial hash.
-     * @return {boolean} false if it was initialized before, true if it was initialized the first time
+     * @returns {boolean} false if it was initialized before, true if it was initialized the first time
      * @protected
      */
     ShellNavigationHashChanger.prototype.init = function () {
@@ -687,6 +753,16 @@ sap.ui.define([
     };
 
     ShellNavigationHashChanger.prototype._setNavigationStatus = function (sNavigationStatus) {
+        // inform ui5 interaction about pending navigation
+        if (sNavigationStatus === NavigationState.InProgress && !this._fnResolveInteraction) {
+            Log.debug(`${sLogFesrPrefix} Interaction Start`, null, sModuleName);
+            this._fnResolveInteraction = Interaction.notifyAsyncStep();
+        } else if (sNavigationStatus === NavigationState.Finished && this._fnResolveInteraction) {
+            Log.debug(`${sLogFesrPrefix} Interaction End`, null, sModuleName);
+            this._fnResolveInteraction();
+            this._fnResolveInteraction = null;
+        }
+
         this._oNavigationState.status = sNavigationStatus;
     };
 
@@ -1034,7 +1110,7 @@ sap.ui.define([
      * @param {string} sOldHash
      *   The old hash as returned by <code>treatHashChanged</code>
      *
-     * @return {boolean}
+     * @returns {boolean}
      *   Whether the hash change is only in the appSpecificRoute.
      *
      * @protected
@@ -1057,7 +1133,7 @@ sap.ui.define([
      * @param {object} oNewHash New hash split by privsplitHash
      * @param {object} oOldHash Old hash split by privsplitHash
      *
-     * @return {boolean}
+     * @returns {boolean}
      *   Whether two hash fragments have the same semantic object and action
      *   during an app-to-app navigation.
      *

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.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery",
@@ -46,7 +46,7 @@ sap.ui.define([
      * @see sap.ushell.services.Container#getServiceAsync
      *
      * @name sap.ushell.services.SmartNavigation
-     * @constructor
+     * @class
      * @public
      * @deprecated since 1.112. This service has been deprecated. Please use the CrossApplicationNavigation service instead.
      * @since 1.44.0
@@ -358,8 +358,8 @@ sap.ui.define([
      * For object inputs, this method is guaranteed to execute with a meaningful outcome provided
      * that the input passed has an appropriately implemented `toString` method.
      *
-     * @param {object|string|number|undefined} vAny Value for which hash code should be calculated.
-     * @returns {number} Hash code of the input value.
+     * @param {object|string|int|undefined} vAny Value for which hash code should be calculated.
+     * @returns {int} Hash code of the input value.
      */
     SmartNavigation.prototype._getHashCode = function (vAny) {
         var sAny = vAny + "";

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview APIs for the S/4 MyHome
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/Config",
@@ -36,7 +36,6 @@ sap.ui.define([
      *
      * @namespace sap.ushell.services.SpaceContent
      *
-     * @constructor
      * @class
      * @see {@link sap.ushell.services.Container#getServiceAsync}
      * @since 1.103.0
@@ -116,7 +115,7 @@ sap.ui.define([
      * @param {int} sectionIndex The index of the added section on the page
      * @param {object} [sectionProperties] Properties of the added section
      *
-     * @returns {Promise<void>} Promise which resolves after the personalization was saved
+     * @returns {Promise<undefined>} Promise which resolves after the personalization was saved
      *
      * @since 1.103.0
      *
@@ -140,7 +139,7 @@ sap.ui.define([
      * @param {string} [sectionId] The ID of the section the visualization should be added to
      * @param {string} vizId The ID of the visualization to add
      *
-     * @returns {Promise<void>} Promise which resolves after the personalization was saved
+     * @returns {Promise<undefined>} Promise which resolves after the personalization was saved
      *
      * @since 1.103.0
      *
@@ -191,7 +190,7 @@ sap.ui.define([
      * @param {string} [visualizationData.subtitle] The subtitle of the visualization
      * @param {string} [visualizationData.info] The information text of the visualization
      *
-     * @returns {Promise<void>} The promise resolves when the visualization has been updated successfully
+     * @returns {Promise<undefined>} The promise resolves when the visualization has been updated successfully
      *
      * @since 1.105
      * @private
@@ -220,7 +219,7 @@ sap.ui.define([
      * @param {int} sectionIndex The index of the section from where the visualization is deleted
      * @param {int} visualizationIndex The index of the deleted visualization
      *
-     * @returns {Promise<void>} Promise which resolves after the personalization was saved.
+     * @returns {Promise<undefined>} Promise which resolves after the personalization was saved.
      *
      * @since 1.103.0
      * @private

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

@@ -76,7 +76,7 @@ sap.ui.define([
          * <p>
          * The service enablement depends on the configuration in the back-end system and the bootstrap configuration.
          *
-         * @return {boolean} <code>true</code> if the service is enabled; <code>false</code> otherwise
+         * @returns {boolean} <code>true</code> if the service is enabled; <code>false</code> otherwise
          *
          * @public
          * @alias sap.ushell.services.SupportTicket#isEnabled

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

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's UI tracing service.
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/EventHub",
@@ -219,7 +219,7 @@ sap.ui.define([
         this._sDeviceType = this._getDeviceType();
 
         if (sap.ushell.Container) {
-            sap.ushell.Container.getFLPPlatform().then(function (sPlatform) {
+            this._initialized = sap.ushell.Container.getFLPPlatform().then(function (sPlatform) {
                 if (sPlatform === "MYHOME") {
                     this._sSiteType = "sap-start" + this._sSpacesPages;
                     return;
@@ -236,8 +236,10 @@ sap.ui.define([
                             this._sSiteType = "wz-advanced" + this._sSpacesPages;
                         }
                     }.bind(this));
-                });
+                }.bind(this));
             }.bind(this));
+        } else {
+            this._initialized = Promise.resolve();
         }
     }
 

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

@@ -4,9 +4,9 @@
  * @fileOverview URLShortening
  *
  * Service wrapper for the sap/ushell/utils/UrlShortening module.
- * Deprecated. Please use the UrlShortening module directly.
+ * @deprecated since 1.118. Please use the UrlShortening module directly.
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
  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.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/utils",
@@ -18,7 +18,7 @@ sap.ui.define([
      * Constructs a new instance of the URLTemplate service.
      *
      * @namespace sap.ushell.services.URLTemplate
-     * @constructor
+     * @class
      * @see sap.ushell.services.Container#getServiceAsync
      * @since 1.94.0
      * @private

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.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/Config",
@@ -47,7 +47,7 @@ sap.ui.define([
      * @param {*} sParameter Not used
      * @param {*} oConfig Used to configure the loader with properties loadDefaultDependencies
      * @private
-     * @constructor
+     * @class
      * @see sap.ushell.services.Container#getServiceAsync
      * @since 1.38.0
     */
@@ -58,8 +58,8 @@ sap.ui.define([
 
         /**
          * Logger adding a trace an propagates the eror
-         * @param {Object} oComponentProperties The component properties
-         * @param {Object} vError The error to be logged
+         * @param {object} oComponentProperties The component properties
+         * @param {object} vError The error to be logged
          * @returns {Promise} Promise that resolves with vError
         */
         this._logStackTrace = function (oComponentProperties, vError) {
@@ -80,7 +80,7 @@ sap.ui.define([
          * It is the wrapper for the adapter, that may implement this method or not
          * @param {object} oData The oData with component properties as a member
          * @param {string} sUI5ComponentType Type used to define the type of loading a ui5component by FLP
-         * @return {Promise} oPromise The promise that resolves with the modified oData
+         * @returns {Promise} oPromise The promise that resolves with the modified oData
          */
         this.modifyComponentProperties = function (oData, sUI5ComponentType) {
             if (!this._oAdapter.modifyComponentProperties) {
@@ -106,7 +106,7 @@ sap.ui.define([
          *   the Component class until those Promises are resolved.
          * @param {string} sUI5ComponentType Type used to define the type of loading a ui5component by FLP
          *   as defined ushellLibrary
-         * @return {jQuery.Deferred.promise} a jQuery promise which resolves with the application properties object which is enriched
+         * @returns {jQuery.Deferred.promise} a jQuery promise which resolves with the application properties object which is enriched
          *   with an <code>componentHandle<code> object that encapsulates the loaded component.
          *   If the UI5 core resources have been loaded completely as a result of this call
          *   (either customPreload is disabled or the core-ext-light.js module is loaded as part of this call or was already loaded),
@@ -216,7 +216,7 @@ sap.ui.define([
          * (the result of a navigation target resolution).
          *
          * @param {object} oData Contains all application & component properties and data
-         * @return {jQuery.Deferred.promise} a jQuery promise which resolves with the application properties object which is enriched
+         * @returns {jQuery.Deferred.promise} a jQuery promise which resolves with the application properties object which is enriched
          *   with an <code>componentHandle<code> object that encapsulates the loaded component.
          *   If the UI5 core resources have been loaded completely as a result of this call
          *   (either customPreload is disabled or the core-ext-light.js module is loaded as part of this call or was already loaded),

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.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -48,7 +48,6 @@ sap.ui.define([
      * @param {object} oContainerInterface interface
      * @param {string} sParameter Service instantiation
      * @param {object} oConfig Service configuration (not in use)
-     * @constructor
      * @class
      * @see sap.ushell.services.Container#getServiceAsync
      * @since 1.32.0

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

@@ -7,10 +7,11 @@
  *               This service should be accessed by the application
  *               via the CrossApplicationNavigation service.
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/base/Log",
+    "sap/base/util/deepClone",
     "sap/base/util/deepEqual",
     "sap/base/util/deepExtend",
     "sap/base/util/isEmptyObject",
@@ -19,6 +20,7 @@ sap.ui.define([
     "sap/ushell/utils"
 ], function (
     Log,
+    deepClone,
     deepEqual,
     deepExtend,
     isEmptyObject,
@@ -45,7 +47,6 @@ sap.ui.define([
      *
      *
      * @private
-     * @constructor
      * @class
      * @see sap.ushell.services.Container#getServiceAsync
      *
@@ -67,7 +68,7 @@ sap.ui.define([
          *
          * @param {object} oPlugin a plug-in
          *
-         * @returns {number} an integer value (default 0) representing the priority of the plug-in
+         * @returns {int} an integer value (default 0) representing the priority of the plug-in
          *
          */
         function getPrio (oPlugin) {
@@ -281,7 +282,7 @@ sap.ui.define([
                             .always(function () {
                                 var oStoreValue = {
                                     parameterName: sParameterName,
-                                    parameterValue: oUtils.clone(oValueObject || {}),
+                                    parameterValue: deepClone(oValueObject || {}),
                                     systemContext: oSystemContext
                                 };
 
@@ -341,7 +342,7 @@ sap.ui.define([
          * @param {array} aMembersToCheck
          *   An array of members to check
          *
-         * @return {boolean}
+         * @returns {boolean}
          *   true if each member in <code>aMembersToCheck</code> has the same
          *   value in both the objects. false in case at least one member
          *   differs.
@@ -490,7 +491,7 @@ sap.ui.define([
                         });
                 }.bind(this))
                 .then(function (oPersistedValue) {
-                    var oValueClone = oUtils.clone(oPersistedValue);
+                    var oValueClone = deepClone(oPersistedValue);
 
                     var bAskValueToPlugins =
                         (!oPersistedValue._shellData && this._valueIsEmpty(oPersistedValue)) // _shellData is added by the shell when the parameter is stored
@@ -829,7 +830,7 @@ sap.ui.define([
          * @param {function} fnFunction
          *     Event handler to be attached.
          *
-         * @methodOf sap.ushell.services.UserDefaultParameters#
+         * @memberof sap.ushell.services.UserDefaultParameters#
          * @name attachValueStored
          * @since 1.34.0
          * @public
@@ -845,7 +846,7 @@ sap.ui.define([
          * @param {function} fnFunction
          *     Event handler to be detached.
          *
-         * @methodOf sap.ushell.services.UserDefaultParameters#
+         * @memberof sap.ushell.services.UserDefaultParameters#
          * @name detachValueStored
          * @since 1.34.0
          * @public

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

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's user information service, which allows you to retrieve
  *     information about the user.
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -144,6 +144,13 @@ sap.ui.define([
                 fullName: this.getFullName()
             });
         };
+        /**
+         * Returns the list of available calendar week numberings to the user.
+         * @returns {Array|null} Array of calendar week numberings, null if method in adapter does not exist.
+         */
+        this.getCalendarWeekNumberingList = function () {
+                return oAdapter.getCalendarWeekNumberingList?.();
+        };
 
         /**
          * Returns the list of themes available for the user.