@sapui5/sap.ushell 1.117.2 → 1.119.0

package/src/main/js/sap/ushell/_ApplicationType/wdaResolution.js

@@ -26,7 +26,7 @@ sap.ui.define([
      *   were defaulted -- not contained in the intent, but in the inbound
      *   signature.
      *
-     * @return {Promise}
+     * @returns {Promise}
      *   An ES6 promise that resolves with a string representing the parameters
      *   that must be appended to a final WDA URL, or rejects with an error
      *   message.
@@ -208,7 +208,7 @@ sap.ui.define([
      * @param {string} sUrlParameters
      *    The URL parameters to append to the WDA URL.
      *
-     * @return {string}
+     * @returns {string}
      *    The standalone WDA URL
      *
      * @private
@@ -235,7 +235,7 @@ sap.ui.define([
      * @param {string} sSapSystemDataSrc
      *  The sap-system-src from the matched target.
      *
-     * @return {object}
+     * @returns {object}
      *  An object that represents the resolution result, like:
      *  <pre>
      *     {
@@ -253,7 +253,7 @@ sap.ui.define([
             "sap-system": sSapSystem,
             url: sFinalWDAURL,
             text: oInbound.title,
-            applicationType: "NWBC"
+            applicationType: "WDA"
         };
 
         if (typeof sSapSystemDataSrc === "string") {
@@ -375,7 +375,7 @@ sap.ui.define([
 
                 var oResolutionResult = {
                     url: oURI.toString(),
-                    applicationType: "NWBC",
+                    applicationType: "WDA",
                     text: sAppId,
                     additionalInformation: "",
                     "sap-system": sSapSystem

package/src/main/js/sap/ushell/_Config/utils.js

@@ -19,7 +19,7 @@ sap.ui.define([
      *   The configuration contract. In other words, a plain object describing
      *   the structure of the configuration.
      *
-     * @return {object}
+     * @returns {object}
      *   An object indicating what part of the path belongs to the contract and
      *   what part doesn't. Note that the path that belongs to the contract is
      *   returned as a string, and the one that doesn't is returned as an
@@ -64,7 +64,7 @@ sap.ui.define([
      * @param {variant} v
      *   Any value.
      *
-     * @return {boolean}
+     * @returns {boolean}
      *   Whether the given argument represents a
      *   <code>sap.ui.model.Context</code>.
      * @private
@@ -118,7 +118,7 @@ sap.ui.define([
      *   The property-to-prefix mapping (object), or just the prefix to prepend
      *   (string).
      *
-     * @return {function}
+     * @returns {function}
      *   The prefix prepender, a function that takes a string indicating a path
      *   , and returns the string with the right prefix prepended.
      * @private
@@ -159,7 +159,7 @@ sap.ui.define([
      *   The property to prefix mapping. Holds the model path prefix if the
      *   model was created from a single path, or a property-to-path-prefix
      *   mapping if the model was created from multiple paths.
-     * @return {string}
+     * @returns {string}
      *   The full path, relative to the config channel.
      * @private
      */
@@ -191,7 +191,7 @@ sap.ui.define([
      *   model was created from a single path, or a property-to-path-prefix
      *   mapping if the model was created from multiple paths.
      *
-     * @return {object}
+     * @returns {object}
      *   A "sealed" model, where calling <code>setData</code> throws and
      *   calling setProperty causes an event to be emitted against the
      *   configuration channel.

package/src/main/js/sap/ushell/_URLTemplateProcessor/DefinitionParameterSetBuilder.js

@@ -4,7 +4,7 @@
  * @fileOverview Methods to build the set of parameters used by the URL template.
  *
  *
- * @version 1.117.2
+ * @version 1.119.0
  *
  * @private
  *

package/src/main/js/sap/ushell/_URLTemplateProcessor/DependencyGraph.js

@@ -8,7 +8,7 @@
  * The proper order of evaluation can be determined by creating and visiting a graph that represents parameters and depending parameters
  * as nodes. This graph can be also used to detect cyclic references in the parameter set definition.
  *
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/_URLTemplateProcessor/Functions.js

@@ -2,7 +2,7 @@
 
 /**
  * @file Methods to parse and execute functions defined for the URL Template parameter language.
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/_URLTemplateProcessor/Resolvers.js

@@ -5,7 +5,7 @@
  * For a given context (e.g. the reference to a site, the application section from the site, parameters added during runtime, etc),
  * this module can be used to find the values associated to given URL Template parameter names.
  *
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/_URLTemplateProcessor/TemplateParameterParser.js

@@ -34,7 +34,7 @@
  *     }
  *   }
  *   </pre>
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/_URLTemplateProcessor/utils.js

@@ -2,7 +2,7 @@
 
 /**
  * @file Utility functions for modules of <code>URLTemplateProcessor</code>.
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/adapters/cdm/ClientSideTargetResolutionAdapter.js

@@ -9,14 +9,21 @@
  * <li>provide the resolveHashFragment function, a fallback method called by ClientSideTargetResolution service.</li>
  * </ul>
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/base/util/Version",
     "sap/ui/thirdparty/jquery",
     "sap/base/util/deepExtend",
-    "sap/base/Log"
-], function (Version, jQuery, fnDeepExtend, Log) {
+    "sap/base/Log",
+    "sap/ushell/Container"
+], function (
+    Version,
+    jQuery,
+    fnDeepExtend,
+    Log,
+    Container
+) {
     "use strict";
 
     /**
@@ -30,18 +37,17 @@ sap.ui.define([
      * @param {object} oAdapterConfig
      *   A potential adapter configuration
      *
-     * @constructor
+     * @class
      *
      * @private
      */
 
     var ClientSideTargetResolutionAdapter = function (oSystem, sParameters, oAdapterConfig) {
         this._oAdapterConfig = oAdapterConfig && oAdapterConfig.config;
-        var oContainer = sap.ushell.Container,
-            sProductName = "";
+        var sProductName = "";
 
-        if (oContainer) {
-            sProductName = oContainer.getLogonSystem().getProductName() || "";
+        if (Container.isInitialized()) {
+            sProductName = Container.getLogonSystem().getProductName() || "";
         }
 
         /*
@@ -161,7 +167,7 @@ sap.ui.define([
          * @param {string} sSystemAlias
          *    the system alias name to be resolved
          *
-         * @return {jQuery.Deferred.Promise}
+         * @returns {jQuery.Deferred.Promise}
          *    a jQuery promise that resolves to a system alias data object.
          *    A live object is returned! The service must not change it.
          *    If the alias could not be resolved the promise is rejected.

package/src/main/js/sap/ushell/adapters/cdm/CommonDataModelAdapter.js

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's sap.ushell.adapters.cdm.CommonDataModelAdapter for the 'CDM'
  *               platform.
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -38,7 +38,6 @@ sap.ui.define([
      *  - Whether it should be allowed to specify a custom site url via url parameter, default is false
      *
      * @class
-     * @constructor
      * @see {@link sap.ushell.adapters.cdm.CommonDataModelAdapter}
      */
 
@@ -97,7 +96,7 @@ sap.ui.define([
      * @param {string} sCurrentURL
      *    The URL where the Launchpad is running.
      *
-     * @return {string}
+     * @returns {string}
      *    An normalized URL absolute to the given <code>sCurrentUrl</code>
      *
      * @private
@@ -203,9 +202,9 @@ sap.ui.define([
      * - 3.0.0 Sites are only compatible with 3.0.0 personalizations
      * - If no personalization version property is available, we assume a version below 3.0.0 since it was introduced at a later point
      * </pre>
-     * @param {String} siteVersion
+     * @param {string} siteVersion
      *   The site version to be compared with
-     * @param {String} personalizationVersion
+     * @param {string} personalizationVersion
      *   The personalization version. Might be empty
      * @returns {boolean} result
      *   The result of the validation. True if personalization version is okay, false if it's not compatible

package/src/main/js/sap/ushell/adapters/cdm/ConfigurationDefaultsAdapter.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The ConfigurationDefaults adapter for the CDM platform.
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/bootstrap/cdm/cdm.constants",

package/src/main/js/sap/ushell/adapters/cdm/ContainerAdapter.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview The Unified Shell"s container adapter for the Common Data Model (CDM) platform.
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 /**
  * @namespace Default namespace for Unified Shell adapters for the Common Data Model (CDM) platform.
@@ -46,7 +46,6 @@ sap.ui.define([
      *
      * @class The Unified Shell's container adapter which does the bootstrap for the Common Data Model (CDM) platform.
      *
-     * @constructor
      * @see sap.ushell.services.initializeContainer
      * @since 1.48.0
      * @private

package/src/main/js/sap/ushell/adapters/cdm/LaunchPageAdapter.js

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's LaunchPageAdapter for the
  *               'CDM' platform - Version 2 (V2)
  * @deprecated since 1.100
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/adapters/cdm/_LaunchPage/readHome",
@@ -84,7 +84,6 @@ sap.ui.define([
      *
      * @class
      *
-     * @constructor
      * @since 1.15.0
      * @deprecated since 1.100
      */
@@ -841,7 +840,7 @@ sap.ui.define([
          * (assigned group).
          * @param {object} oGroup
          *  Group to be checked
-         * @return {boolean}
+         * @returns {boolean}
          *  true if the group is preset (assigned by admin), false if added by the user.
          *
          * @private
@@ -854,7 +853,7 @@ sap.ui.define([
          * Tells if the group is locked, meaning that the user is not able to do modifications.
          * @param {object} oGroup
          * Group to be checked
-         * @return {boolean}
+         * @returns {boolean}
          *  true if the group is locked.
          *
          * @private
@@ -1055,7 +1054,7 @@ sap.ui.define([
          *
          * @param {object} oGroup
          *  Group object
-         * @param {number} nNewIndex
+         * @param {int} nNewIndex
          *  New index the group will be moved to
          * @returns {jQuery.Deferred}
          *  A promise which will be resolved when the group has been moved successfully.
@@ -2273,7 +2272,7 @@ sap.ui.define([
          *  Group object
          * @param {object} oTile
          *  Tile object
-         * @param {number} iIndex
+         * @param {int} iIndex
          *  Index of the given tile in the respective group
          * @returns {jQuery.Promise}
          *  A promise which will be resolved when the tile has been removed successfully.
@@ -2346,9 +2345,9 @@ sap.ui.define([
          *
          * @param {object} oTile
          *  Tile to be moved
-         * @param {number} iSourceIndex
+         * @param {int} iSourceIndex
          *  Position index of tile in source group
-         * @param {number} iTargetIndex
+         * @param {int} iTargetIndex
          *  Aimed position index of tile in target group
          * @param {object} oSourceGroup
          *  Source group which currently contains the tile
@@ -2446,7 +2445,7 @@ sap.ui.define([
          * Catalog A
          * @param {object} oB
          * Catalog B
-         * @returns {number}
+         * @returns {int}
          * 1 if A bigger than B, -1 if B is bigger than A, else 0
          */
         this._compareCatalogs = function (oA, oB) {
@@ -3136,7 +3135,7 @@ sap.ui.define([
          *   The annotations of the data source service
          * @param {string} [oParameters.dataSource.Settings.localUri]
          *   The local URI of the data source service
-         * @param {number} [oParameters.dataSource.Settings.maxAge]
+         * @param {int} [oParameters.dataSource.Settings.maxAge]
          *   The maxAge parameter of the data source service
          * @param {string} [oParameter.serviceUrlPath]
          *   The path to the service method/action that actually returns the dynamic
@@ -3593,9 +3592,9 @@ sap.ui.define([
 
         /**
          * Updates the properties of a bookmark tile during its composition.
-         * @param {Object} oTile JSON Object that holds the properties of a bookmark tile.
-         * @param {Object} oParameters Properties to merge into the bookmark tile
-         * @param {Object} oTarget The navigation target as a JSON object.
+         * @param {object} oTile JSON Object that holds the properties of a bookmark tile.
+         * @param {object} oParameters Properties to merge into the bookmark tile
+         * @param {object} oTarget The navigation target as a JSON object.
          *
          * @private
          */

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

@@ -24,7 +24,7 @@ sap.ui.define([
     /**
      * Constructs a new instance of the MenuAdapter for the CDM platform
      *
-     * @constructor
+     * @class
      * @since 1.72.0
      * @private
      */

package/src/main/js/sap/ushell/adapters/cdm/PagesCommonDataModelAdapter.js

@@ -1,9 +1,11 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
-
 /**
  * @fileOverview The Unified Shell's platform independent sap.ushell.adapters.PagesCommonDataModelAdapter.
  *
- * @version 1.117.2
+ * It combines the page data, tile data, navigation data and personalization into a CDM 3.1 site.
+ * Only used on the ABAP platform and on local for testing.
+ *
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -21,7 +23,6 @@ sap.ui.define([
      * Constructs a new instance of the platform independent PagesCommonDataModelAdapter.
      *
      * @class
-     * @constructor
      * @see {@link sap.ushell.adapters.PagesCommonDataModelAdapter}
      *
      * @since 1.69.0

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

@@ -5,7 +5,7 @@
  *
  *
  * The CDM personalization adapter can be used to store data in the RA@ABAP platform.
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/adapters/cdm/_Personalization/internals",

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

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

package/src/main/js/sap/ushell/adapters/cdm/_LaunchPage/modifyHome.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview Helper of modifying the home page data for the 'CDM' platform.
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([
@@ -75,7 +75,7 @@ sap.ui.define([
      *      Common Data Model site
      *  @param {object} oGroup
      *      Group object to be added
-     *  @param {number} [iIndex]
+     *  @param {int} [iIndex]
      *      Index in which place inside the current order the
      *      group should be added. If skipped the group is appended
      *  @returns {object}

package/src/main/js/sap/ushell/adapters/cdm/_LaunchPage/readCatalogs.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview Helper of accessing catalog data for the 'CDM' platform.
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/adapters/cdm/_LaunchPage/readHome.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview Helper of accessing Home Page data for the 'CDM' platform.
  *
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/adapters/cdm/_LaunchPage/uri.transform.js

@@ -4,7 +4,7 @@
  * @fileOverview Transforms relative URIs as used e.g. for data sources in the
  * manifest.json
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/URI"

package/src/main/js/sap/ushell/adapters/cdm/_Personalization/internals.js

@@ -390,7 +390,7 @@ sap.ui.define([
     *   headers as an array of name value pairs
     * @param {string} sName
     *   name of the header to return the value for; in lowercase
-    * @return {string} header value in letter case as contained in aHeader
+    * @returns {string} header value in letter case as contained in aHeader
     * @private
     */
     function getHttpHeaderValue (aHeader, sName) {

package/src/main/js/sap/ushell/adapters/cdm/util/AppForInbound.js

@@ -1,8 +1,11 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
-
 /**
  * @fileOverview AppForInbound uses a navigation data inbound to resolve an CDM app reference of a CDM page.
- * @version 1.117.2
+ *
+ * Creates CDM site entries for apps with the provided data.
+ * Only used on the ABAP platform and on local for testing.
+ *
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/adapters/cdm/util/cdmSiteUtils.js

@@ -2,7 +2,10 @@
 /**
  * @fileOverview The file provides helper functions for PagesCommonDataModelAdapter.
  *
- * @version 1.117.2
+ * Creates CDM site entities with the provided data.
+ * Only used on the ABAP platform and on local for testing.
+ *
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/adapters/cdm/v3/AdapterBase.js

@@ -4,7 +4,7 @@
  * @fileOverview The Base of Unified Shell's LaunchPageAdapter for the 'CDM' platform - Version 3 (V3)
  *   and StaticGroupsContainer for Featured Group
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/adapters/cdm/v3/_LaunchPage/readHome",
@@ -70,7 +70,6 @@ sap.ui.define([
      *
      * @class
      *
-     * @constructor
      * @experimental Since 1.65.0
      * @since 1.65.0
      * @private
@@ -632,7 +631,7 @@ sap.ui.define([
      * (assigned group).
      * @param {object} oGroup
      *  Group to be checked
-     * @return {boolean}
+     * @returns {boolean}
      *  true if the group is preset (assigned by admin), false if added by the user.
      *
      * @private
@@ -645,7 +644,7 @@ sap.ui.define([
      * Tells if the group is locked, meaning that the user is not able to do modifications.
      * @param {object} oGroup
      * Group to be checked
-     * @return {boolean}
+     * @returns {boolean}
      *  true if the group is locked.
      *
      * @private

package/src/main/js/sap/ushell/adapters/cdm/v3/LaunchPageAdapter.js

@@ -5,7 +5,7 @@
  *               'CDM' platform - Version 3 (V3)
  *
  * @deprecated since 1.100
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/adapters/cdm/v3/_LaunchPage/readHome",
@@ -75,7 +75,6 @@ sap.ui.define([
      *
      * @class
      *
-     * @constructor
      * @since 1.15.0
      * @deprecated since 1.100
      */
@@ -408,7 +407,7 @@ sap.ui.define([
          *
          * @param {object} oGroup
          *  Group object
-         * @param {number} nNewIndex
+         * @param {int} nNewIndex
          *  New index the group will be moved to
          * @returns {jQuery.Deferred}
          *  A promise which will be resolved when the group has been moved successfully.
@@ -825,7 +824,7 @@ sap.ui.define([
          *  Group object
          * @param {object} oTile
          *  Tile object
-         * @param {number} iIndex
+         * @param {int} iIndex
          *  Index of the given tile in the respective group
          * @returns {jQuery.Promise}
          *  A promise which will be resolved when the tile has been removed successfully.
@@ -896,9 +895,9 @@ sap.ui.define([
          *
          * @param {object} oTile
          *  Tile to be moved
-         * @param {number} iSourceIndex
+         * @param {int} iSourceIndex
          *  Position index of tile in source group
-         * @param {number} iTargetIndex
+         * @param {int} iTargetIndex
          *  Aimed position index of tile in target group
          * @param {object} oSourceGroup
          *  Source group which currently contains the tile
@@ -990,7 +989,7 @@ sap.ui.define([
          * Sort catalogs by title
          * @param {object} oA Catalog A
          * @param {object} oB Catalog B
-         * @returns {number} Sort order
+         * @returns {int} Sort order
          * @private
          */
         this._compareCatalogs = function (oA, oB) {
@@ -1700,7 +1699,7 @@ sap.ui.define([
          *   The annotations of the data source service
          * @param {string} [oParameters.dataSource.Settings.localUri]
          *   The local URI of the data source service
-         * @param {number} [oParameters.dataSource.Settings.maxAge]
+         * @param {int} [oParameters.dataSource.Settings.maxAge]
          *   The maxAge parameter of the data source service
          * @param {string} [oParameters.serviceUrlPath]
          *   The path to the service method/action that actually returns the dynamic
@@ -2369,9 +2368,9 @@ sap.ui.define([
 
         /**
          * Updates the properties of a bookmark tile during its composition.
-         * @param {Object} oTile JSON Object that holds the properties of a bookmark tile.
-         * @param {Object} oParameters Properties to merge into the bookmark tile
-         * @param {Object} oTarget The navigation target as a JSON object.
+         * @param {object} oTile JSON Object that holds the properties of a bookmark tile.
+         * @param {object} oParameters Properties to merge into the bookmark tile
+         * @param {object} oTarget The navigation target as a JSON object.
          *
          * @private
          */

package/src/main/js/sap/ushell/adapters/cdm/v3/StaticGroupsAdapter.js

@@ -3,7 +3,7 @@
  * @fileOverview The Unified Shell's LaunchPageAdapter for the
  *               'CDM' platform - Version 3 (V3)
  *
- * @version 1.117.2
+ * @version 1.119.0
  */
 sap.ui.define([
     "sap/ushell/adapters/cdm/v3/AdapterBase"

package/src/main/js/sap/ushell/adapters/cdm/v3/_LaunchPage/readApplications.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview Helper for accessing application data for the 'CDM' platform.
  *
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/adapters/cdm/v3/_LaunchPage/readCatalogs.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview Helper for accessing catalog data for the 'CDM' platform.
  *
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define( [

package/src/main/js/sap/ushell/adapters/cdm/v3/_LaunchPage/readHome.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview Helper for accessing Home Page data for the 'CDM' platform.
  *
- * @version 1.117.2
+ * @version 1.119.0
  * @private
  */
 sap.ui.define([