@sapui5/sap.ushell 1.139.0 → 1.140.0

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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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.139.0
+ * @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);
+});

package/src/main/js/sap/ushell/appIntegration/AppLifeCycle.js

@@ -2,10 +2,9 @@
 
 /**
  * @fileOverview handle all the resources for the different applications.
- * @version 1.139.0
+ * @version 1.140.0
  */
 sap.ui.define([
-    "sap/base/util/deepEqual",
     "sap/base/util/Deferred",
     "sap/ui/Device",
     "sap/ui/core/Element",
@@ -21,11 +20,7 @@ sap.ui.define([
     "sap/ushell/appIntegration/ApplicationContainerCache",
     "sap/ushell/appIntegration/ApplicationHandle",
     "sap/ushell/appIntegration/AppLifeCycle/KeepAliveMode",
-    "sap/ushell/appIntegration/PostMessageManager/AppruntimeHandler",
-    "sap/ushell/appIntegration/PostMessageManager/NWBCHandler",
-    "sap/ushell/appIntegration/PostMessageManager/LifecycleHandler",
-    "sap/ushell/appIntegration/PostMessageManager/ServiceHandler",
-    "sap/ushell/appIntegration/PostMessageManager/MessageBrokerHandler",
+    "sap/ushell/appIntegration/PostMessageHandler",
     "sap/ushell/appIntegration/PostMessageManager",
     "sap/ushell/appIntegration/PostMessagePluginInterface",
     "sap/ushell/appIntegration/IframeApplicationContainer",
@@ -50,9 +45,9 @@ sap.ui.define([
     "sap/ushell/state/KeepAlive",
     "sap/ushell/ui5service/ShellUIServiceFactory",
     "sap/ui/core/service/ServiceFactoryRegistry",
-    "sap/ushell/library"
+    "sap/ushell/library",
+    "sap/ushell/renderer/RendererManagedComponents"
 ], (
-    deepEqual,
     Deferred,
     Device,
     Element,
@@ -68,11 +63,7 @@ sap.ui.define([
     ApplicationContainerCache,
     ApplicationHandle,
     KeepAliveMode,
-    AppRuntimeHandler,
-    NWBCHandler,
-    LifecycleHandler,
-    ServiceHandler,
-    MessageBrokerHandler,
+    PostMessageHandler,
     PostMessageManager,
     PostMessagePluginInterface,
     IframeApplicationContainer,
@@ -97,7 +88,8 @@ sap.ui.define([
     KeepAlive,
     ShellUIServiceFactory,
     ServiceFactoryRegistry,
-    ushellLibrary
+    ushellLibrary,
+    RendererManagedComponents
 ) => {
     "use strict";
 
@@ -116,6 +108,8 @@ sap.ui.define([
     // shortcut for sap.m.URLHelper
     const URLHelper = mobileLibrary.URLHelper;
 
+    const oRendererManagedComponents = new RendererManagedComponents();
+
     // todo: [FLPCOREANDUX-10024] cleanup
     // const CACHED_APP_TYPES = ["URL"];
 
@@ -235,61 +229,17 @@ sap.ui.define([
                 return ApplicationContainerCache.getAll();
             }
         });
-        AppRuntimeHandler.register();
-        NWBCHandler.register();
-        LifecycleHandler.register();
-        ServiceHandler.register();
-        MessageBrokerHandler.register();
+        PostMessageHandler.register();
         this._waitForPluginsAndReplayPostMessages();
 
-        // todo: [FLPCOREANDUX-10024] harmonize with Appruntime
         PostMessagePluginInterface.init(
-            true, // bRunsInOuterShell
-            (oCommObj) => { // fnAddCommunicationObject
-                Object.keys(oCommObj).forEach((sService) => {
-                    const oServiceDef = oCommObj[sService];
-
-                    if (oServiceDef.oServiceCalls) {
-                        Object.keys(oServiceDef.oServiceCalls).forEach((sInterface) => {
-                            const oInterface = oServiceDef.oServiceCalls[sInterface];
-                            const sServiceRequest = `${sService}.${sInterface}`;
-
-                            if (oInterface.executeServiceCallFn) {
-                                PostMessageManager.setRequestHandler(
-                                    sServiceRequest,
-                                    async (oMessageBody, oEvent) => {
-                                        const oServiceParams = {
-                                            oMessageData: JSON.parse(oEvent.data),
-                                            oMessage: oEvent
-                                        };
-                                        return ushellUtils.promisify(oInterface.executeServiceCallFn(oServiceParams));
-                                    }
-                                );
-                            }
-                        });
-                    }
-
-                    if (oServiceDef.oRequestCalls) {
-                        Object.keys(oServiceDef.oRequestCalls).forEach((sInterface) => {
-                            const oInterface = oServiceDef.oRequestCalls[sInterface];
-                            const sServiceRequest = `${sService}.${sInterface}`;
-                            const oTarget = {};
-
-                            if (deepEqual(oInterface.distributionType, ["all"])) {
-                                oTarget.ignoreCapabilities = true;
-                            } else if (oInterface.distributionType) {
-                                Log.error("Unsupported distribution type", oInterface.distributionType, "sap.ushell.appIntegration.AppLifeCycle");
-                            }
-
-                            if (oInterface.isActiveOnly) {
-                                oTarget.onlyCurrentApplication = true;
-                            }
-
-                            PostMessageManager.setDistributionPolicy(sServiceRequest, oTarget);
-                        });
-                    }
-                });
-            }
+            async (sServiceRequest, oBody) => {
+                const aMessageBodies = await PostMessageManager.sendRequestToAllApplications(sServiceRequest, oBody, true);
+                return aMessageBodies[0]?.result;
+            },
+            PostMessageManager.setRequestHandler.bind(PostMessageManager),
+            PostMessageManager.setDistributionPolicy.bind(PostMessageManager),
+            true // bRunsInOuterShell
         );
     };
 
@@ -438,18 +388,8 @@ sap.ui.define([
         const sToId = oEvent.getParameter("toId") || "";
         const oTo = oEvent.getParameter("to");
 
-        const aFlpComponentIds = [
-            "Shell-appfinder-component",
-            "Shell-home-component",
-            "pages-component-container",
-            "homeApp-component-wrapper-container",
-            "homeApp-component-container",
-            "workPageRuntime-component-container",
-            "runtimeSwitcher-component-container"
-        ];
-
         const bNavWithinSameContainer = sFromId === sToId;
-        const bNavigationToFlpComponent = aFlpComponentIds.some((sFlpComponentId) => sToId.includes(sFlpComponentId));
+        const bNavigationToFlpComponent = oRendererManagedComponents.isComponentId(sToId);
 
         // first cleanup
         if (sFromId && oFrom) {
@@ -1391,6 +1331,7 @@ sap.ui.define([
         const oDeferred = await this._awaitLastApplicationStart();
 
         const oApplicationBefore = this._oCurrentApplication;
+        this._oNavContainer.setBusy(true);
 
         try {
             const oApplicationHandle = await this._startApplication(
@@ -1422,6 +1363,8 @@ sap.ui.define([
                 }
             }
 
+            this._oNavContainer.setBusy(false);
+
             oDeferred.resolve();
             throw oError;
         }
@@ -1683,7 +1626,7 @@ sap.ui.define([
         });
         this._aDoables = [];
 
-        KeepAliveApps._clean();
+        KeepAliveApps.reset();
         ApplicationContainerCache.destroyAllContainers();
         PostMessageManager.reset();
 

package/src/main/js/sap/ushell/appIntegration/ApplicationContainer.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The UI integration's SAPUI5 control which supports application embedding.
- * @version 1.139.0
+ * @version 1.140.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -135,7 +135,7 @@ sap.ui.define([
                  * event holds a technology specific configuration object for the embedded application.
                  * As of now, only configuration for an embedded <em>SAPUI5 component</em> is supported.
                  */
-                applicationConfiguration: { // todo: [FLPCOREANDUX-10024] make this event used consistently
+                applicationConfiguration: { // todo: [FLPCOREANDUX-10024] remove this
                     parameters: {
                         /**
                          * The technology specific configuration object of the embedded application.
@@ -340,13 +340,6 @@ sap.ui.define([
         // can be implemented by sub classes
     };
 
-    // todo: [FLPCOREANDUX-10024] remove this
-    ApplicationContainer.setHandleMessageEvent = function (fnHandleMessageEvent) {
-        ApplicationContainer.handleMessageEvent = fnHandleMessageEvent;
-
-        return this;
-    };
-
     /**
      * Determine if the source of a received postMessage can be considered as trusted. We consider
      * the content window of the application container's iframe as trusted
@@ -365,11 +358,12 @@ sap.ui.define([
 
     ApplicationContainer.prototype.getPostMessageTarget = function () {
         // needs to be implemented by sub classes
+        throw new Error("getPostMessageTarget is not implemented in ApplicationContainer");
     };
 
     ApplicationContainer.prototype.getPostMessageTargetOrigin = function () {
         // needs to be implemented by sub classes
-        return "";
+        throw new Error("getPostMessageTargetOrigin is not implemented in ApplicationContainer");
     };
 
     /**
@@ -393,7 +387,7 @@ sap.ui.define([
     /**
      * Removes the given capabilities from the existing blue box capabilities.
      * If no capabilities are provided, all capabilities are removed.
-     * @param {string[]} [aCapabilitiesToRemove] The capabilities to remove.
+     * @param {string[]} [aCapabilitiesToRemove] The capabilities to remove. If not provided, all capabilities are removed.
      * @returns {this} this instance for method chaining
      *
      * @since 1.130.0