@sapui5/sap.ushell 1.124.1 → 1.125.0

package/src/main/js/sap/ushell/adapters/local/MenuAdapter.js

@@ -8,12 +8,14 @@ sap.ui.define([
     "sap/base/Log",
     "sap/base/i18n/Localization",
     "sap/base/util/ObjectPath",
-    "sap/ushell/library"
+    "sap/ushell/library",
+    "sap/ushell/Container"
 ], function (
     Log,
     Localization,
     ObjectPath,
-    ushellLibrary
+    ushellLibrary,
+    Container
 ) {
     "use strict";
 
@@ -112,7 +114,7 @@ sap.ui.define([
      * @since 1.114.0
      */
     MenuAdapter.prototype.getMenuPersonalization = function () {
-        return sap.ushell.Container.getServiceAsync("PersonalizationV2")
+        return Container.getServiceAsync("PersonalizationV2")
             .then(async function (oPersonalizationService) {
                 var oPersId;
 

package/src/main/js/sap/ushell/adapters/local/NavTargetResolutionAdapter.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The NavTargetResolution adapter for the demo platform used in scube ui5appruntime.scube.
- * @version 1.124.1
+ * @version 1.125.0
  * @deprecated since 1.120
  * @private
  */

package/src/main/js/sap/ushell/adapters/local/NavTargetResolutionInternalAdapter.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The NavTargetResolutionInternal adapter for the demo platform.
- * @version 1.124.1
+ * @version 1.125.0
  * @since 1.120
  * @private
  */
@@ -11,13 +11,15 @@ sap.ui.define([
     "sap/base/util/ObjectPath",
     "sap/ui/thirdparty/jquery",
     "sap/base/Log",
-    "sap/ushell/utils"
+    "sap/ushell/utils",
+    "sap/ushell/Container"
 ], function (
     oVirtualInbounds,
     ObjectPath,
     jQuery,
     Log,
-    utils
+    utils,
+    Container
 ) {
     "use strict";
 
@@ -112,7 +114,7 @@ sap.ui.define([
                     oDeferred.resolve([]);
                 }, 0);
             } else {
-                sap.ushell.Container.getServiceAsync("URLParsing").then(function (oURLParsingService) {
+                Container.getServiceAsync("URLParsing").then(function (oURLParsingService) {
                     var sParameters = oURLParsingService.paramsToString(mParams);
                     Log.info("getSemanticObjectLinks: " + sSemanticObject);
                     for (var sIntent in oApplications) {

package/src/main/js/sap/ushell/adapters/local/PageBuildingAdapter.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's page builder adapter for the 'demo' platform.
  * It creates chip instances from chip raw data. Compared to the other platforms this adapter has restricted functionality.
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
     "sap/ui/core/ComponentContainer",

package/src/main/js/sap/ushell/adapters/local/PagePersistenceAdapter.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview PagePersistenceAdapter for the local platform.
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
     "sap/ushell/utils",

package/src/main/js/sap/ushell/adapters/local/PersonalizationAdapter.js

@@ -6,7 +6,7 @@
  *
  * The local personalization adapter can be configured to store data either in
  * the local storage (default) or in memory.
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
     "sap/ushell/utils",

package/src/main/js/sap/ushell/adapters/local/PersonalizationV2Adapter.js

@@ -6,7 +6,7 @@
  *
  * The local personalization adapter can be configured to store data either in
  * the local storage (default) or in memory.
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
     "./PersonalizationAdapter"

package/src/main/js/sap/ushell/adapters/local/SearchAdapter.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview The Search adapter for the demo platform.
  *
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
 ], function () {

package/src/main/js/sap/ushell/adapters/local/SearchCEPAdapter.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's Search adapter for CEP Search
  *
- * @version 1.124.1
+ * @version 1.125.0
  */
 /*eslint-disable quote-props*/
 sap.ui.define([], function () {

package/src/main/js/sap/ushell/adapters/local/SupportTicketAdapter.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The SupportTicket adapter for the local platform.
  *
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
 ], function () {

package/src/main/js/sap/ushell/adapters/local/Ui5ComponentLoaderAdapter.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's Ui5ComponentLoaderAdapter for the local platform
  *
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
 ], function () {

package/src/main/js/sap/ushell/adapters/local/UserDefaultParameterPersistenceAdapter.js

@@ -6,13 +6,14 @@
  *               TODO will be replaced by true persistence within this SP!
  *               This adapter delegates to the Personalization Adapter
  *
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery",
-    "sap/base/Log"
+    "sap/base/Log",
+    "sap/ushell/Container"
 ],
-    function (jQuery, Log) {
+    function(jQuery, Log, Container) {
 	"use strict";
 
     // --- Adapter ---
@@ -39,7 +40,7 @@ sap.ui.define([
     };
 
     UserDefaultParameterPersistenceAdapter.prototype._getPersonalizationService = function () {
-        return sap.ushell.Container.getServiceAsync("PersonalizationV2");
+        return Container.getServiceAsync("PersonalizationV2");
     };
 
     /**

package/src/main/js/sap/ushell/adapters/local/UserInfoAdapter.js

@@ -2,13 +2,14 @@
 
 /**
  * @fileOverview The UserInfo adapter for the demo platform.
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery",
     "sap/base/util/ObjectPath",
-    "sap/base/Log"
-], function (jQuery, ObjectPath, Log) {
+    "sap/base/Log",
+    "sap/ushell/Container"
+], function(jQuery, ObjectPath, Log, Container) {
     "use strict";
 
     /**
@@ -59,7 +60,7 @@ sap.ui.define([
                 Log.error(sError, vError && vError.stack, "com.sap.ushell.adapters.local.UserInfo");
             }
 
-            sap.ushell.Container.getServiceAsync("PersonalizationV2").then(function (oPersonalizationService) {
+            Container.getServiceAsync("PersonalizationV2").then(function (oPersonalizationService) {
                 var oScope = {
                     keyCategory: oPersonalizationService.KeyCategory.FIXED_KEY,
                     writeFrequency: oPersonalizationService.WriteFrequency.LOW,

package/src/main/js/sap/ushell/appRuntime/ui5/AppRuntime.js

@@ -602,9 +602,14 @@ sap.ui.define([
                 if (bPopupCallbackRegistered === false) {
                     var oShellUIService = new ShellUIService({ scopeObject: oComponentContainer, scopeType: "component" });
                     oShellUIService.setBackNavigation();
+
                     /* eslint-disable no-new */
+                    /**
+                     * @deprecated since version 1.120
+                     */
                     new UserStatus({ scopeObject: oComponentContainer, scopeType: "component" });
                     /* eslint-enable no-new */
+
                     AppLifeCycleAgent.setShellUIService(oShellUIService);
 
                     RendererUtils.init();
@@ -943,6 +948,12 @@ sap.ui.define([
                         module: "sap.ushell.appRuntime.ui5.services.adapters.EmptyAdapter"
                     }
                 },
+                UserDefaultParameters: {
+                    module: "sap.ushell.appRuntime.ui5.services.UserDefaultParameters",
+                    adapter: {
+                        module: "sap.ushell.appRuntime.ui5.services.adapters.EmptyAdapter"
+                    }
+                },
                 AppState: {
                     module: "sap.ushell.appRuntime.ui5.services.AppState",
                     adapter: {

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/baseRta/CheckConditions.js

@@ -3,11 +3,9 @@
  */
 
 sap.ui.define([
-	"sap/base/util/UriParameters",
 	"sap/ui/Device",
 	"sap/ushell/appRuntime/ui5/plugins/baseRta/AppLifeCycleUtils"
 ], function (
-	UriParameters,
 	Device,
 	AppLifeCycleUtils
 ) {
@@ -35,7 +33,7 @@ sap.ui.define([
 		 * @private
 		 */
 		checkRestartRTA: function (sLayer) {
-			var oUriParams = UriParameters.fromQuery(window.location.search);
+			var oUriParams = new URLSearchParams(window.location.search);
 			var sUriLayer = oUriParams.get("sap-ui-layer");
 			// if a layer is given in the URI it has priority over the config
 			sLayer = sUriLayer || sLayer;

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/rtaAgent/i18n/i18n_sh.properties

@@ -3,8 +3,8 @@ APP_TITLE=RTA cFLP plugin agenta
 
 ERROR_TITLE=Prilago\u0111avanje KI se ne mo\u017Ee pokrenuti
 
-TECHNICAL_ERROR=Tehni\u010Dka gre\u0161ka. Obavijestite tim za podr\u0161ku.
+TECHNICAL_ERROR=Tehni\u010Dka gre\u0161ka. Obavestite tim za podr\u0161ku.
 
 HEADER_FLEX_DISABLED=Informacije
 
-MSG_FLEX_DISABLED=Za ovu aplikaciju nije omogu\u0107ena adaptacija. Dodatne informacije pogledajte [ovdje](https\://help.sap.com/viewer/4fc8d03390c342da8a60f8ee387bca1a/latest/en-US/ef97b2485aa34a8890f4d51e5c2b15a8.html).
+MSG_FLEX_DISABLED=Za ovu aplikaciju nije omogu\u0107ena adaptacija. Dodatne informacije pogledajte [ovde](https\://help.sap.com/viewer/4fc8d03390c342da8a60f8ee387bca1a/latest/en-US/ef97b2485aa34a8890f4d51e5c2b15a8.html).

package/src/main/js/sap/ushell/appRuntime/ui5/renderers/fiori2/RendererExtensions.js

@@ -1,5 +1,10 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview This module enables a RendererExtensions like API.
+ * This module is NOT a wrapper for the outer shell API and has to be required explicitly.
+ * @version 1.125.0
+ */
 sap.ui.define([
     "sap/base/util/uid",
     "sap/ushell/appRuntime/ui5/AppRuntimeService",

package/src/main/js/sap/ushell/appRuntime/ui5/services/AppConfiguration.js

@@ -1,5 +1,11 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview This module is a iframe safe version of the AppConfiguration service.
+ * The inner frame service has to be required explicitly or accessed via the global on the original path.
+ * The require calls to the original file will NOT be replaced.
+ * @version 1.125.0
+ */
 sap.ui.define([
     "sap/base/util/ObjectPath",
     "sap/m/library",
@@ -24,6 +30,15 @@ sap.ui.define([
     // shortcut for sap.m.ButtonType
     var ButtonType = mobileLibrary.ButtonType;
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.AppConfiguration
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.AppConfiguration}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     */
     function AppConfigurationProxy () {
         var aIdsOfAddedButtons = [];
 
@@ -45,6 +60,16 @@ sap.ui.define([
             document.body.classList.toggle("sapUShellApplicationContainerLimitedWidth", !oData.bValue);
         });
 
+        /**
+         * Sets the application screen size to full width
+         *
+         * @param {boolean} bValue A Boolean value indicating if the application fills the full width of the screen
+         *
+         * @private
+         * @deprecated since 1.120.0. Use the "sap.ui/fullWidth" property in the application's manifest.json instead.
+         * @alias sap.ushell.services.AppConfiguration#setApplicationFullWidth
+         * @alias sap.ushell.appRuntime.ui5.services.AppConfiguration#setApplicationFullWidth
+         */
         this.setApplicationFullWidth = function (bValue) {
             if (vGetFullWidthParamFromManifest === true || vGetFullWidthParamFromManifest === "true") {
                 EventHub.emit("appWidthChange", bValue);
@@ -60,6 +85,18 @@ sap.ui.define([
             vGetFullWidthParamFromManifest = sVal;
         };
 
+        /**
+         * Adds buttons to the action sheet in the shell header.
+         * This function always overrides the already existing application settings buttons with the new buttons.
+         * It is meant to be used by applications that want to add their own settings button to the shell header.
+         *
+         * @param {sap.m.Button[]} aButtons List of sap.m.Button controls
+         *
+         * @private
+         * @deprecated since 1.120. Use {@link sap.ushell.services.Extension#addUserAction} instead.
+         * @alias sap.ushell.services.AppConfiguration#addApplicationSettingsButtons
+         * @alias sap.ushell.appRuntime.ui5.services.AppConfiguration#addApplicationSettingsButtons
+         */
         this.addApplicationSettingsButtons = function (aButtons) {
             for (var i = 0; i < aButtons.length; i++) {
                 var oCurrentButton = aButtons[i];

package/src/main/js/sap/ushell/appRuntime/ui5/services/AppState.js

@@ -1,15 +1,34 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.AppState}.
+ *
+ * @version 1.125.0
+ */
 sap.ui.define([
     "sap/ushell/services/AppState",
     "sap/ushell/appRuntime/ui5/AppRuntimeService",
     "sap/ushell/services/appstate/AppState",
-    "sap/ushell/utils",
     "sap/ui/thirdparty/jquery",
     "sap/ushell/appRuntime/ui5/AppRuntimeContext"
-], function (AppState, AppRuntimeService, AppStateAppState, utils, jQuery, AppRuntimeContext) {
+], function (
+    AppState,
+    AppRuntimeService,
+    AppStateAppState,
+    jQuery,
+    AppRuntimeContext
+) {
     "use strict";
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.AppState
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.AppState}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     */
     function AppStateProxy (oAdapter, oContainerInterface, sParameter, oConfig) {
         AppState.call(this, oAdapter, oContainerInterface, sParameter, oConfig);
 

package/src/main/js/sap/ushell/appRuntime/ui5/services/Bookmark.js

@@ -1,12 +1,32 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.Bookmark}.
+ *
+ * @version 1.125.0
+ * @deprecated since 1.120. Use {@link sap.ushell.services.BookmarkV2} instead.
+ */
 sap.ui.define([
     "sap/ushell/services/Bookmark",
     "sap/ushell/appRuntime/ui5/AppRuntimeService",
     "sap/ushell/appRuntime/ui5/AppRuntimeContext"
-], function (Bookmark, AppRuntimeService, AppRuntimeContext) {
+], function (
+    Bookmark,
+    AppRuntimeService,
+    AppRuntimeContext
+) {
     "use strict";
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.Bookmark
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.Bookmark}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     * @deprecated since 1.120. Use {@link sap.ushell.services.BookmarkV2} instead.
+     */
     function BookmarkProxy (oContainerInterface, sParameters, oServiceConfiguration) {
         Bookmark.call(this, oContainerInterface, sParameters, oServiceConfiguration);
 

package/src/main/js/sap/ushell/appRuntime/ui5/services/BookmarkV2.js

@@ -1,12 +1,30 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.Bookmark}.
+ *
+ * @version 1.125.0
+ */
 sap.ui.define([
     "sap/ushell/services/BookmarkV2",
     "sap/ushell/appRuntime/ui5/AppRuntimeService",
     "sap/ushell/appRuntime/ui5/AppRuntimeContext"
-], function (BookmarkV2, AppRuntimeService, AppRuntimeContext) {
+], function (
+    BookmarkV2,
+    AppRuntimeService,
+    AppRuntimeContext
+) {
     "use strict";
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.BookmarkV2
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.BookmarkV2}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     */
     function BookmarkProxy (oContainerInterface, sParameters, oServiceConfiguration) {
         BookmarkV2.call(this, oContainerInterface, sParameters, oServiceConfiguration);
 
@@ -33,11 +51,30 @@ sap.ui.define([
             });
         };
 
+        /**
+         * Returns the list of group ids and their titles.
+         *
+         * @param {boolean} bGetAll If set to `true`, all groups, including locked groups, are returned.
+         * @returns {Promise} A promise that resolves to the list of groups. In launchpad spaces mode the promise gets rejected.
+         *
+         * @private
+         * @deprecated As of version 1.120. Use {@link sap.ushell.services.BookmarkV2.getContentNodes} instead.
+         */
         this.getShellGroupIDs = function () {
             return AppRuntimeService.postMessageToFLP(
                 "sap.ushell.services.BookmarkV2.getShellGroupIDs");
         };
 
+        /**
+         * Adds a bookmark tile to one of the user's home page groups by group id.
+         *
+         * @param {object} oParameters The bookmark parameters
+         * @param {string} [groupId] ID of the group the bookmark tile should be added to.
+         * @returns {Promise} Resolves on success.
+         *
+         * @private
+         * @deprecated As of version 1.120. Use {@link sap.ushell.services.BookmarkV2.addBookmark} instead.
+         */
         this.addBookmarkByGroupId = function (oParameters, groupId) {
             return AppRuntimeService.postMessageToFLP(
                 "sap.ushell.services.BookmarkV2.addBookmark",

package/src/main/js/sap/ushell/appRuntime/ui5/services/CommonDataModel.js

@@ -1,10 +1,28 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.CommonDataModel}.
+ *
+ * @version 1.125.0
+ */
 sap.ui.define([
     "sap/ushell/services/CommonDataModel",
     "sap/ushell/appRuntime/ui5/AppRuntimeService"
-], function (CommonDataModel, AppRuntimeService) {
+], function (
+    CommonDataModel,
+    AppRuntimeService
+) {
     "use strict";
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.CommonDataModel
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.CommonDataModel}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     */
     function CommonDataModelProxy (oAdapter, oContainerInterface, sParameters, oServiceConfiguration) {
         CommonDataModel.call(this, oAdapter, oContainerInterface, sParameters, oServiceConfiguration);
 

package/src/main/js/sap/ushell/appRuntime/ui5/services/Container.js

@@ -1,9 +1,19 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.Container}.
+ *
+ * @version 1.125.0
+ */
 sap.ui.define([
     "sap/ushell/Container",
     "sap/ushell/appRuntime/ui5/AppRuntimeService",
     "sap/base/assert"
-], function (Container, AppRuntimeService, assert) {
+], function (
+    Container,
+    AppRuntimeService,
+    assert
+) {
     "use strict";
 
     var oAdapter,
@@ -33,9 +43,16 @@ sap.ui.define([
         return this.getFLPUrl(bIncludeHash);
     };
 
-    // For compatibility with previous implementations and tests.
-    // Please use getRendererInternal instead.
+    /**
+     * Gets a renderer instance for the given renderer name.
+     * @returns {sap.ui.core.Control|sap.ui.core.Component} The renderer instance.
+     *
+     * @private
+     * @deprecated since 1.120.0. Use {@link sap.ushell.services.Extension} for shell extensions instead.
+     */
     Container.getRenderer = function () {
+        // For compatibility with previous implementations and tests.
+        // Please use getRendererInternal instead.
         return oRenderer;
     };
 

package/src/main/js/sap/ushell/appRuntime/ui5/services/CrossApplicationNavigation.js

@@ -1,4 +1,11 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.CrossApplicationNavigation}.
+ *
+ * @version 1.125.0
+ * @deprecated since 1.120. Use {@link sap.ushell.services.Navigation} instead.
+ */
 sap.ui.define([
     "sap/ushell/services/CrossApplicationNavigation",
     "sap/ushell/services/appstate/AppState",
@@ -9,9 +16,29 @@ sap.ui.define([
     "sap/ushell/appRuntime/ui5/AppRuntimeContext",
     "sap/base/util/deepClone",
     "sap/ushell/utils/UrlParsing"
-], function (CrossApplicationNavigation, AppStateAppState, jQuery, Log, Container, AppRuntimeService, AppRuntimeContext, deepClone, UrlParsing) {
+], function (
+    CrossApplicationNavigation,
+    AppStateAppState,
+    jQuery,
+    Log,
+    Container,
+    AppRuntimeService,
+    AppRuntimeContext,
+    deepClone,
+    UrlParsing
+) {
     "use strict";
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.CrossApplicationNavigation
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.CrossApplicationNavigation}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     * @deprecated since 1.120. Use {@link sap.ushell.services.Navigation} instead.
+     */
     function CrossApplicationNavigationProxy (oContainerInterface, sParameters, oServiceConf) {
         CrossApplicationNavigation.call(this, oContainerInterface, sParameters, oServiceConf);
 

package/src/main/js/sap/ushell/appRuntime/ui5/services/Extension/Item.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview Defines a generic interface for extension items in ShellAreas.
  *
- * @version 1.124.1
+ * @version 1.125.0
  */
 sap.ui.define([
     "sap/ushell/appRuntime/ui5/AppRuntimeService"

package/src/main/js/sap/ushell/appRuntime/ui5/services/Extension.js

@@ -1,5 +1,10 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.Extension}.
+ *
+ * @version 1.125.0
+ */
 sap.ui.define([
     "sap/base/util/isPlainObject",
     "sap/ushell/appRuntime/ui5/services/Extension/Item",
@@ -16,7 +21,9 @@ sap.ui.define([
     /**
      * @alias sap.ushell.appRuntime.ui5.services.Extension
      * @class
-     * @classdesc The inner shell wrapper for the {@link sap.ushell.services.Extension}.
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.Extension}.
+     *
+     * @hideconstructor
      *
      * @since 1.124.0
      * @private
@@ -52,7 +59,7 @@ sap.ui.define([
             complex: {},
             events: {}
         };
-        Object.keys(oControlProperties).forEach(sKey => {
+        Object.keys(oControlProperties).forEach((sKey) => {
             const vValue = oControlProperties[sKey];
 
             if (typeof vValue === "function") {
@@ -151,6 +158,22 @@ sap.ui.define([
         }
     };
 
+    /**
+     * Sets the second title in the shell header next to the application title.
+     * It is displayed indefinitely until a different second title was set.
+     * @param {string} sTitle The title.
+     * @returns {Promise} A promise that resolves when the title was set.
+     *
+     * @since 1.125.0
+     * @private
+     * @experimental since 1.125.0
+     */
+    ExtensionProxy.prototype.setSecondTitle = function (sTitle) {
+        return AppRuntimeService.postMessageToFLP("sap.ushell.services.Extension.setSecondTitle", {
+            title: sTitle
+        });
+    };
+
     ExtensionProxy.hasNoAdapter = true;
 
     return ExtensionProxy;