@sapui5/sap.ushell 1.124.3 → 1.126.0

package/src/main/js/sap/ushell/api/RTA.js

@@ -3,9 +3,11 @@
  * @fileOverview Utility functions for RTA.
  */
 sap.ui.define([
-    "sap/ushell/Container"
+    "sap/ushell/Container",
+    "sap/ushell/EventHub"
 ], function (
-    Container
+    Container,
+    EventHub
 ) {
     "use strict";
 
@@ -69,6 +71,16 @@ sap.ui.define([
         oRenderer.removeTopHeaderPlaceHolder();
     };
 
+    /**
+     * Sets the property enabled of the navigation bar.
+     * @param {boolean} bEnable Whether the navigation bar should be enabled or not.
+     * @since 1.126.0
+     * @private
+     * @ui5-restricted sap.ui.fl, sap.ui.rta
+     */
+    RtaUtils.setNavigationBarEnabled = function (bEnable) {
+        EventHub.emit("enableMenuBarNavigation", bEnable);
+    };
     return RtaUtils;
 
 });

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();
@@ -659,7 +664,7 @@ sap.ui.define([
                             if (AppRuntimeContext.getIsScube() === true) {
                                 try {
                                     if (sHash && sHash.indexOf("Shell-startIntent") === 0) {
-                                        sAppTitle = oResolutionResultWithComponentHandle.componentHandle.getMetadata().getManifestEntry("/sap.app/title");
+                                        sAppTitle = oResolutionResultWithComponentHandle.componentHandle.getInstance().getManifestEntry("/sap.app/title");
                                         if (typeof sAppTitle === "string") {
                                             setTimeout(function () {
                                                 AppRuntimeService.postMessageToFLP("sap.ushell.services.ShellUIService.setTitle", {sTitle: sAppTitle});
@@ -743,11 +748,11 @@ sap.ui.define([
             var oComp = oResolutionResultWithComponentHandle.componentHandle.getInstance();
             var metadata = oComp.getMetadata();
             if (metadata) {
-                var vFullwidthUi = oComp.getMetadata().getManifestEntry("/sap.ui/fullWidth");
-                var vFullwidthUi5Config = oComp.getMetadata().getManifestEntry("/sap.ui5/config/fullWidth");
-                if (vFullwidthUi === true || vFullwidthUi === "true" || vFullwidthUi5Config === true || vFullwidthUi5Config === "true") {
+                var vFullWidthUi = oComp.getManifestEntry("/sap.ui/fullWidth");
+                var vFullWidthUi5Config = oComp.getManifestEntry("/sap.ui5/config/fullWidth");
+                if (vFullWidthUi === true || vFullWidthUi === "true" || vFullWidthUi5Config === true || vFullWidthUi5Config === "true") {
                     EventHub.emit("appWidthChange", true);
-                } else if (vFullwidthUi === false || vFullwidthUi === "false" || vFullwidthUi5Config === false || vFullwidthUi5Config === "false") {
+                } else if (vFullWidthUi === false || vFullWidthUi === "false" || vFullWidthUi5Config === false || vFullWidthUi5Config === "false") {
                     EventHub.emit("appWidthChange", false);
                 }
             }

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.126.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.126.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.126.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.126.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.126.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.126.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.126.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.126.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.3
+ * @version 1.126.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.126.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;

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

@@ -1,5 +1,10 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.FrameBoundExtension}.
+ *
+ * @version 1.126.0
+ */
 sap.ui.define([
 ], function (
 ) {
@@ -8,7 +13,9 @@ sap.ui.define([
     /**
      * @alias sap.ushell.appRuntime.ui5.services.FrameBoundExtension
      * @class
-     * @classdesc The inner shell wrapper for the {@link sap.ushell.services.FrameBoundExtension}.
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.FrameBoundExtension}.
+     *
+     * @hideconstructor
      *
      * @since 1.124.0
      * @private

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

@@ -1,11 +1,30 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.LaunchPage}.
+ *
+ * @version 1.126.0
+ * @deprecated since 1.120. This service has been deprecated as it only works for the classic homepage.
+ */
 sap.ui.define([
     "sap/ushell/services/LaunchPage",
     "sap/ushell/appRuntime/ui5/AppRuntimeService"
-], function (LaunchPage, AppRuntimeService) {
+], function (
+    LaunchPage,
+    AppRuntimeService
+) {
     "use strict";
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.LaunchPage
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.LaunchPage}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     * @deprecated since 1.120. This service has been deprecated as it only works for the classic homepage.
+     */
     function LaunchPageProxy (oContainerInterface, sParameters, oServiceConfiguration) {
         LaunchPage.call(this, oContainerInterface, sParameters, oServiceConfiguration);
 

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

@@ -1,11 +1,28 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.MessageBroker}.
+ *
+ * @version 1.126.0
+ */
 sap.ui.define([
     "sap/ushell/appRuntime/ui5/AppRuntimeService"
-], function (AppRuntimeService) {
+], function (
+    AppRuntimeService
+) {
     "use strict";
 
     var oClientData = {};
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.MessageBroker
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.MessageBroker}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     */
     var MessageBrokerProxy = function () {};
 
     MessageBrokerProxy.prototype.connect = function (sClientId) {

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

@@ -1,5 +1,11 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.NavTargetResolution}.
+ *
+ * @version 1.126.0
+ * @deprecated since 1.120. Use {@link sap.ushell.services.Navigation} for Navigation instead.
+ */
 sap.ui.define([
     "sap/ushell/services/NavTargetResolution",
     "sap/ushell/appRuntime/ui5/AppRuntimeService",
@@ -13,6 +19,16 @@ sap.ui.define([
 ) {
     "use strict";
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.NavTargetResolution
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.NavTargetResolution}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     * @deprecated since 1.120. Use {@link sap.ushell.services.Navigation} for Navigation instead.
+     */
     function NavTargetResolutionProxy (oAdapter, oContainerInterface, sParameters, oServiceConfiguration) {
         NavTargetResolution.call(this, oAdapter, oContainerInterface, sParameters, oServiceConfiguration);
 

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

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

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

@@ -1,4 +1,10 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview The app runtime wrapper for {@link sap.ushell.services.Navigation}.
+ *
+ * @version 1.126.0
+ */
 sap.ui.define([
     "sap/ushell/services/Navigation",
     "sap/ushell/appRuntime/ui5/AppRuntimeService",
@@ -7,9 +13,26 @@ sap.ui.define([
     "sap/base/util/deepClone",
     "sap/ushell/utils/UrlParsing",
     "sap/ushell/appRuntime/ui5/services/Container"
-], function (Navigation, AppRuntimeService, AppStateAppState, AppRuntimeContext, deepClone, UrlParsing, Container) {
+], function (
+    Navigation,
+    AppRuntimeService,
+    AppStateAppState,
+    AppRuntimeContext,
+    deepClone,
+    UrlParsing,
+    Container
+) {
     "use strict";
 
+    /**
+     * @alias sap.ushell.appRuntime.ui5.services.Navigation
+     * @class
+     * @classdesc The app runtime wrapper for {@link sap.ushell.services.Navigation}.
+     *
+     * @hideconstructor
+     *
+     * @private
+     */
     function NavigationProxy (oContainerInterface, sParameters, oServiceConf) {
         Navigation.call(this, oContainerInterface, sParameters, oServiceConf);