@sapui5/sap.ushell 1.138.1 → 1.140.0

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

@@ -5,7 +5,7 @@
  *
  *
  * The CDM personalization adapter can be used to store data in the RA@ABAP platform.
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "./PersonalizationAdapter"

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.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
 ], () => {

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.138.1
+ * @version 1.140.0
  * @private
  */
 sap.ui.define([

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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/URI"

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

@@ -5,7 +5,7 @@
  * Creates CDM site entries for apps with the provided data.
  * Only used on the ABAP platform and on local for testing.
  *
- * @version 1.138.1
+ * @version 1.140.0
  * @private
  */
 sap.ui.define([

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

@@ -5,7 +5,7 @@
  * Creates CDM site entities with the provided data.
  * Only used on the ABAP platform and on local for testing.
  *
- * @version 1.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ushell/adapters/cdm/v3/_LaunchPage/readHome",

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

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

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.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ushell/adapters/cdm/v3/FlpLaunchPageAdapter"

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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.0
  * @private
  */
 sap.ui.define([

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

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

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

@@ -3,7 +3,7 @@
 /**
  * @fileOverview Helper for accessing the read utils for the 'CDM' platform.
  *
- * @version 1.138.1
+ * @version 1.140.0
  * @private
  */
 sap.ui.define([

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

@@ -4,7 +4,7 @@
  *
  * TODO: Simplify function names
  *
- * @version 1.138.1
+ * @version 1.140.0
  * @private
  */
 sap.ui.define([

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileoverview The NavTargetResolution adapter for SAP MyHome used in FioriLaunchpad.CEP.MyHome
- * @version 1.138.1
+ * @version 1.140.0
  * @deprecated since 1.120
  * @private
  */

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileoverview The NavTargetResolutionInternal adapter for SAP MyHome
- * @version 1.138.1
+ * @version 1.140.0
  * @since 1.120
  */
 

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

@@ -2,7 +2,7 @@
 /**
  * @fileOverview The Unified Shell's Search adapter for CEP applications (client-side search).
  *
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ui/core/Lib",

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

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's UserDefaultParameterPersistence adapter for the CFLP
  *               platform.
  *
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ushell/utils/HttpClient",

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

@@ -5,7 +5,7 @@
  *
  * The local personalization adapter can be configured to store data either in
  * the local storage (default) or in memory.
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery",

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

@@ -5,7 +5,7 @@
  *   TODO will be replaced by true persistence within this SP!
  *   This adapter delegates to the Personalization Adapter
  *
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ushell/services/appstate/AppStatePersistencyMethod",

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

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's ClientSideTargetResolutionAdapter for the local
  *               platform.
  *
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery",

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

@@ -2,7 +2,7 @@
 /**
  * @fileOverview The Unified Shell's container adapter for standalone demos.
  *
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/base/Log",

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

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's page builder adapter for the 'demo' platform.
  *
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/base/Log",

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

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's page builder adapter for the 'demo' platform.
  *
  * @deprecated since 1.100
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ushell/adapters/local/FlpLaunchPageAdapter"

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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.0
  * @since 1.120
  * @private
  */

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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.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.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
 ], () => {

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.138.1
+ * @version 1.140.0
  */
 /* eslint-disable quote-props */
 sap.ui.define([], () => {

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

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The SupportTicket adapter for the local platform.
  *
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
 ], () => {

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.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
 ], () => {

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

@@ -6,7 +6,7 @@
  *               TODO will be replaced by true persistence within this SP!
  *               This adapter delegates to the Personalization Adapter
  *
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery",

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The UserInfo adapter for the demo platform.
- * @version 1.138.1
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery",

package/src/main/js/sap/ushell/api/performance/Extension.js

@@ -0,0 +1,147 @@
+// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview extension class for managing navigation sources in the FESR (Front End Statistical Records).
+ */
+
+sap.ui.define([
+    "sap/base/Log",
+    "sap/ushell/api/performance/NavigationSource"
+], (Log, NavigationSource) => {
+    "use strict";
+
+    /**
+     * @typedef {object} sap.ushell.api.performance.Extension.NavigationSource
+     *
+     * @property {string} id The unique identifier of the navigation source.
+     * @property {string} abbreviation The abbreviation of the navigation source. It is not
+     * used for display purposes, just to make the code easier to read.
+     * @private
+     * @ui5-restricted ux.eng.s4producthomes1
+     */
+
+    /**
+     * @alias sap.ushell.api.performance.Extension
+     * @namespace
+     * @description The Extension class provides methods to manage navigation sources in the FESR (Front End Statistical Records).
+     * It allows adding the navigation sources
+     *
+     * @since 1.139.0
+     * @private
+     * @ui5-restricted ux.eng.s4producthomes1
+     *
+     */
+    class Extension {
+        /**
+         * array of known navigation sources
+         * @type {sap.ushell.api.performance.Extension.NavigationSource[]}
+         *
+         * @since 1.139.0
+         * @private
+         * @constant
+         */
+        #aKnownNavigationSources = [];
+
+        #sModuleAbbreviation = "sap.ushell.api.performance.Extension";
+        /**
+         * current navigation sources
+         * @type {sap.ushell.api.performance.Extension.NavigationSource[]}
+         *
+         * @since 1.139.0
+         * @private
+         * @constant
+         * @static
+         */
+        static #aNavigationSources = [];
+
+        /**
+         * Creates an instance of the Extension class.
+         * @class
+         * @since 1.139.0
+         */
+        constructor () {
+            this.#aKnownNavigationSources = this.#getKnownNavigationSources();
+            this.#sModuleAbbreviation = "sap.ushell.api.performance.Extension";
+        }
+
+        /**
+         * Returns the known navigation sources in an array.
+         * @returns {sap.ushell.api.performance.Extension.NavigationSource[]} An array of known navigation sources.
+         * @property {string} id The unique identifier of the navigation source.
+         * @property {string} abbreviation The abbreviation of the navigation source. It is not used for display purposes,
+         * @since 1.139.0
+         * @private
+         */
+        #getKnownNavigationSources () {
+            return Object.keys(NavigationSource).reduce((prevValue, sKey) => {
+                return prevValue.concat({ id: sKey, abbreviation: NavigationSource[sKey] });
+            }, []);
+        }
+
+        /**
+         * formats the navigation source.
+         * @param {sap.ushell.api.performance.Extension.NavigationSource} oRawNavigationSource The navigation source to format.
+         * @returns {string} The formatted navigation source.
+         * @private
+         * @since 1.139.0
+         *
+         */
+        formatNavigationSource (oRawNavigationSource) {
+            if (!this.#aKnownNavigationSources.some((oNavSource) => {
+                return oNavSource.id === oRawNavigationSource.id;
+            })) {
+                Log.warning("navigation source not known", oRawNavigationSource.id, this.#sModuleAbbreviation);
+            }
+            // shorten oRawNavigationSource.abbreviation by up to 4 characters and return it
+            return oRawNavigationSource.abbreviation.length > 4 ? oRawNavigationSource.abbreviation.substring(0, 4) : oRawNavigationSource.abbreviation;
+        }
+
+        /**
+         * Gets the navigation source.
+         * return the last added navigation source and remove it from the stack.
+         * @returns {sap.ushell.api.performance.Extension.NavigationSource|undefined} The the current navigation source.
+         * @private
+         * @since 1.139.0
+         */
+        getNavigationSource () {
+            let oCurrentNavigationSource;
+            switch (Extension.#aNavigationSources.length) {
+                case 0:
+                    // no navigation source found
+                    return undefined;
+                case 1:
+                    oCurrentNavigationSource = Extension.#aNavigationSources.pop();
+                    return { id: this.formatNavigationSource(oCurrentNavigationSource), abbreviation: oCurrentNavigationSource.abbreviation };
+                default:
+                    oCurrentNavigationSource = Extension.#aNavigationSources.pop();
+                    Log.warning("Multiple navigation sources found in stack, returning last one", null, this.#sModuleAbbreviation);
+                    return ({ id: oCurrentNavigationSource.id, abbreviation: this.formatNavigationSource(oCurrentNavigationSource)});
+            }
+        }
+
+        /**
+         * Adds a navigation source to the FESR.
+         * @param {sap.ushell.api.performance.Extension.NavigationSource|string} vNewNavigationSource The navigation source information or id as a string
+         * @since 1.139.0
+         * @private
+         * @ui5-restricted ux.eng.s4producthomes1
+         */
+        addNavigationSource (vNewNavigationSource) {
+            let oNewNavigationSource = {};
+            if (typeof vNewNavigationSource === "string") {
+                oNewNavigationSource = { id: vNewNavigationSource, abbreviation: vNewNavigationSource };
+            } else if (typeof vNewNavigationSource === "object") {
+                if (!vNewNavigationSource || !vNewNavigationSource.id || !vNewNavigationSource.abbreviation) {
+                    Log.error("Invalid navigation source", vNewNavigationSource, this.#sModuleAbbreviation);
+                    return;
+                }
+                oNewNavigationSource = {
+                    id: vNewNavigationSource.id,
+                    abbreviation: vNewNavigationSource.abbreviation
+                };
+            }
+            Extension.#aNavigationSources.push(oNewNavigationSource);
+        }
+    }
+    return Extension;
+});

package/src/main/js/sap/ushell/api/performance/NavigationSource.js

@@ -0,0 +1,86 @@
+// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+
+/**
+ * @fileOverview enumeration of known navigation sources for the FESR (Front End Statistical Records).
+ */
+sap.ui.define([], () => {
+    "use strict";
+    /**
+     * @alias sap.ushell.api.performance.Extension.knownNavigationSources
+     * @enum {string}
+     * Object that denotes all known navigation sources.
+     * @private
+     * @ui5-restricted ux.eng.s4producthomes1
+     * @since 1.139.0
+     */
+    this.oNavigationSource = {
+        /**
+         * App Finder navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        AppFinder: "apFi",
+        /**
+         * Application navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        Application: "appl",
+        /**
+         * Frequently Used navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        FrequentlyUsed: "frUs",
+        /**
+         * Recently Used navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        RecentlyUsed: "reUs",
+        /**
+         * Situation navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        Situation: "situ",
+        /**
+         * Search Tile navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        SearchCEP: "seCP",
+        /**
+         * Search Direct Link navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        SearchDirectLaunch: "seDL",
+        /**
+         * Search Enterprise navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        SearchEnterprise: "seEP",
+        /**
+         * Sidebar navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        SideBar: "siBa",
+        /**
+         * Task navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        Task: "task",
+        /**
+         * To-Do navigation source.
+         * @since 1.139.0
+         * @public
+         */
+        Todo: "toDo"
+    };
+
+    return Object.freeze(this.oNavigationSource);
+});