@sapui5/sap.ushell 1.141.3 → 1.142.1

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

@@ -8,7 +8,7 @@
  * This service can only be called from the outer shell and is not available
  * in the inner shell or via post message API.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ui/core/Element",
@@ -59,6 +59,19 @@ sap.ui.define([
     function FrameBoundExtension () { }
 
     // ========================================== Helper ====================================================================
+    async function getRendererInternalAsync (sRendererName) {
+        return new Promise(async (resolve) => {
+            const oRenderer = Container.getRendererInternal(sRendererName);
+            if (oRenderer) {
+                resolve(oRenderer);
+            } else {
+                Container.attachRendererCreatedEvent(function onRendererCreated () {
+                    Container.detachRendererCreatedEvent(onRendererCreated);
+                    resolve(Container.getRendererInternal(sRendererName));
+                });
+            }
+        });
+    }
 
     /**
      * Creates a function which scopes a specific control to a single visibility handler.
@@ -174,7 +187,7 @@ sap.ui.define([
      * @private
      */
     FrameBoundExtension.prototype._createHeaderEndItem = async function (controlProperties) {
-        const oRenderer = Container.getRendererInternal();
+        const oRenderer = await getRendererInternalAsync();
 
         const aCreateArgs = [
             controlProperties,
@@ -239,7 +252,7 @@ sap.ui.define([
      * @public
      */
     FrameBoundExtension.prototype.createSubHeader = async function (controlProperties, parameters = {}) {
-        const oRenderer = Container.getRendererInternal();
+        const oRenderer = await getRendererInternalAsync();
 
         const aCreateArgs = [{
             controlType: parameters.controlType || "sap.m.Bar",
@@ -320,7 +333,7 @@ sap.ui.define([
      * @public
      */
     FrameBoundExtension.prototype.createUserAction = async function (controlProperties, parameters = {}) {
-        const oRenderer = Container.getRendererInternal();
+        const oRenderer = await getRendererInternalAsync();
 
         const aCreateArgs = [{
             controlType: parameters.controlType || "sap.m.Button",
@@ -386,7 +399,7 @@ sap.ui.define([
      * @public
      */
     FrameBoundExtension.prototype.createFooter = async function (controlProperties, parameters = {}) {
-        const oRenderer = Container.getRendererInternal();
+        const oRenderer = await getRendererInternalAsync();
 
         const aCreateArgs = [{
             controlType: parameters.controlType || "sap.m.Bar",
@@ -421,7 +434,7 @@ sap.ui.define([
      * @public
      */
     FrameBoundExtension.prototype.addUserSettingsEntry = async function (properties) {
-        const oRenderer = Container.getRendererInternal();
+        const oRenderer = await getRendererInternalAsync();
         const sId = oRenderer.getShellController().addUserPreferencesEntry(properties);
         return new UserSettingsEntry(sId);
     };
@@ -450,7 +463,7 @@ sap.ui.define([
      * @ui5-restricted sap.fe, sap.esh.search.ui
      */
     FrameBoundExtension.prototype.addGroupedUserSettingsEntry = async function (properties) {
-        const oRenderer = Container.getRendererInternal();
+        const oRenderer = await getRendererInternalAsync();
         const sId = oRenderer.getShellController().addUserPreferencesEntry(properties, true);
         return new UserSettingsEntry(sId);
     };
@@ -483,7 +496,7 @@ sap.ui.define([
      * @experimental since 1.125.0
      */
     FrameBoundExtension.prototype.setSecondTitle = async function (sTitle) {
-        const oRenderer = Container.getRendererInternal();
+        const oRenderer = await getRendererInternalAsync();
         oRenderer.setHeaderTitle(sTitle);
     };
 

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileoverview The Unified Shell's page builder service providing the data for the Fiori launchpad's classic Homepage.
- * @version 1.141.3
+ * @version 1.142.1
  * @deprecated since 1.120
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/Menu.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The menu service provides the entries for the menu bar
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ushell/Config",
@@ -693,186 +693,6 @@ sap.ui.define([
         return false;
     };
 
-    /**
-     * Retrieves info about the given nodeId
-     *
-     * @param {string} nodeId The nodeId to search for.
-     * @param {object[]} nodes The array of nodes and their children.
-     * @param {boolean} [isChild] If the current node is a child node.
-     * @param {string} [managerId] The managerId - to be called recursively.
-     * @returns {object} The result object.
-     * @private
-     */
-    Menu.prototype._getNodeInfo = function (nodeId, nodes, isChild, managerId) {
-        let oNodeInfo;
-        for (let i = 0; i < nodes.length; i++) {
-            if (!isChild) { managerId = this._getManagerIdInNodeTree(nodeId, nodes[i]); }
-            if (nodes[i].id === nodeId) {
-                return {
-                    node: nodes[i],
-                    isRootNode: !isChild,
-                    managerId: managerId || null
-                };
-            }
-
-            if (nodes[i].menuEntries && nodes[i].menuEntries.length > 0) {
-                oNodeInfo = this._getNodeInfo(nodeId, nodes[i].menuEntries, true, managerId);
-                if (oNodeInfo.node) { return oNodeInfo; }
-            }
-        }
-        return {
-            node: null,
-            isRootNode: false,
-            managerId: null
-        };
-    };
-
-    /**
-     * Checks if the given nodeId exists and if the managerId is allowed to manage the given nodeId.
-     *
-     * @param {string} nodeId The node id to search for.
-     * @param {object[]} rootNodes The nodes in the menu.
-     * @param {string} managerId The managerId to check.
-     * @returns {boolean} The result - True if the managerId of the node is null or equal to the given managerId.
-     * @private
-     */
-    Menu.prototype._nodeManagementPermitted = function (nodeId, rootNodes, managerId) {
-        const oNodeInfo = this._getNodeInfo(nodeId, rootNodes);
-        if (!oNodeInfo.node) {
-            Log.error(`Node with id ${nodeId} cannot be found and will be skipped.`);
-            return false;
-        }
-        if (oNodeInfo.managerId && oNodeInfo.managerId !== managerId) {
-            Log.error(`Node with id ${nodeId} cannot be managed by '${managerId}'` +
-                ` because it is already managed by '${oNodeInfo.managerId}'.`);
-            return false;
-        }
-        return true;
-    };
-
-    /**
-     * Returns the managerId for a given node if it exists on itself or on a parent.
-     *
-     * @param {string} nodeId The node id to search for.
-     * @param {object} node The node to start the search.
-     * @param {string} [managerId] The if of the entry manager.
-     * @returns {string|null} The managerId if a managed node is found.
-     * @private
-     */
-    Menu.prototype._getManagerIdInNodeTree = function (nodeId, node, managerId) {
-        if (node.id === nodeId) { return managerId || node.managerId; }
-        if (node.managerId) { managerId = node.managerId; }
-        if (node.menuEntries && node.menuEntries.length > 0) {
-            for (let i = 0; i < node.menuEntries.length; ++i) {
-                managerId = this._getManagerIdInNodeTree(nodeId, node.menuEntries[i], managerId);
-            }
-            return managerId;
-        }
-        return null;
-    };
-
-    /**
-     * Replaces the node and all its menuEntries with the given managedTree.
-     *
-     * @param {string} nodeId The nodeId to replace.
-     * @param {object[]} nodes The nodes tree.
-     * @param {object} managedTree The tree to replace the node with.
-     * @returns {object[]} The new nodes tree.
-     * @private
-     */
-    Menu.prototype._updateNode = function (nodeId, nodes, managedTree) {
-        const oTree = deepClone(managedTree || {});
-        // Make sure that all menu entries have uid:
-        function addUid (treeObj) {
-            if (treeObj) {
-                treeObj.uid = treeObj.uid || ushellUtils.generateUniqueId([]);
-                (treeObj.menuEntries || []).forEach(addUid);
-            }
-        }
-        addUid(oTree);
-
-        // traverse the tree to find the menu entry with the required ID and replace it
-        return nodes.map((node) => {
-            if (node.id === nodeId) {
-                return oTree;
-            }
-            if (node.menuEntries && node.menuEntries.length > 0) {
-                node.menuEntries = this._updateNode(nodeId, node.menuEntries, oTree);
-            }
-            return node;
-        });
-    };
-
-    /**
-     * Creates entry provider functions, mapped to the given nodeIds.
-     *
-     * @param {string} managerId The ID of the entry manager.
-     * @param {string[]} nodeIds The nodeIds to update.
-     * @param {object} model The model bound to the UI.
-     * @returns {object} The entry provider functions mapped to the nodeIds.
-     * @private
-     */
-    Menu.prototype._createEntryProviders = function (managerId, nodeIds, model) {
-        const aNodes = model.getData();
-        const oMenuEntryProvider = {};
-        let sNodeId;
-
-        for (let i = 0; i < nodeIds.length; ++i) {
-            sNodeId = nodeIds[i];
-
-            if (!this._nodeManagementPermitted(sNodeId, aNodes, managerId)) {
-                continue;
-            }
-
-            oMenuEntryProvider[sNodeId] = {
-                setData: function (nodeId, managedTree) {
-                    const aUpdatedNodes = this._updateNode(nodeId, aNodes, managedTree);
-
-                    model.setData(aUpdatedNodes);
-                }.bind(this, sNodeId)
-            };
-        }
-
-        return oMenuEntryProvider;
-    };
-
-    /**
-     * @param {string} managerId The ID of the entry manager.
-     * @returns {boolean} True if the given managerId is in the blocked list, otherwise false.
-     * @private
-     */
-    Menu.prototype._isManagerBlocked = function (managerId) {
-        return this._aBlockedList.indexOf(managerId) > -1;
-    };
-
-    /**
-     * Adds the given managerId to the blocked list.
-     *
-     * @param {string} managerId The ID of the entry manager.
-     * @private
-     */
-    Menu.prototype._setManagerBlocked = function (managerId) {
-        this._aBlockedList.push(managerId);
-    };
-
-    /**
-     * Checks if the given managerId (pluginName) is blocked. If not, blocks it and resolves to
-     * the entry provider functions for the given nodeIds.
-     *
-     * @param {string} pluginName The ID of the plugin.
-     * @param {string[]} nodeIds An array of nodeId strings.
-     * @returns {Promise<object>} The entry provider functions mapped to the nodeIds.
-     */
-    Menu.prototype.getEntryProvider = async function (pluginName, nodeIds) {
-        if (this._isManagerBlocked(pluginName)) {
-            Log.error(`ManagerId '${pluginName}' is already listed as an entry manager.`);
-            throw new Error(`ManagerId ${pluginName} is already listed as an entry manager.`);
-        }
-        this._setManagerBlocked(pluginName);
-        const oModel = await this.getMenuModel();
-        return this._createEntryProviders(pluginName, nodeIds, oModel);
-    };
-
     // Return menu service from this module
     Menu.hasNoAdapter = false;
     return Menu;

package/src/main/js/sap/ushell/services/Message.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's message service.
- * @version 1.141.3
+ * @version 1.142.1
  * @deprecated since 1.120
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/MessageBroker/MessageBrokerEngine.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module contains the implementation of the message broker
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/base/Log",

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

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module exposes API endpoints for Generic Communication
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ushell/services/MessageBroker/ClientAlias",

package/src/main/js/sap/ushell/services/MessageInternal.js

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's message service.
  * This is a private service replacing the depercated Message service, as the functionality is used thoughout the ushell.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/Navigation/compatibility.js

@@ -4,7 +4,7 @@
  * compatible with the CrossApplicationNavigation service.
  * This shall only be used for the AppRuntime to enable 1.x inner shell running in 2.x host.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 
 sap.ui.define([

package/src/main/js/sap/ushell/services/Navigation/utils.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview Navigation utility functions
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 
 sap.ui.define([

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

@@ -5,7 +5,7 @@
  * This file exposes an API to perform (invoke) Navigation for applications.
  * It exposes interfaces to perform a hash change and trigger a navigation.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/NavigationDataProvider.js

@@ -9,7 +9,7 @@
  *
  * Configured with the ClientSideTargetResolutionAdapter.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ushell/resources",

package/src/main/js/sap/ushell/services/PageBuilding.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's page building service.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery"

package/src/main/js/sap/ushell/services/PagePersistence.js

@@ -6,7 +6,7 @@
  * It provides the layout and tile data of pages in the pages runtime.
  * Only used on the ABAP platform and on local for testing.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([], () => {
     "use strict";

package/src/main/js/sap/ushell/services/PageReferencing.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module deals with page related referencing and dereferencing.
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ushell/services/_PageReferencing/PageReferencer"

package/src/main/js/sap/ushell/services/Pages.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module exposes a model containing the pages hierarchy to its clients.
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/Personalization.js

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's personalization service, which provides generic read and write access to the currently logged on user's
  * personalization settings for the app currently executed in the shell.
  *
- * @version 1.141.3
+ * @version 1.142.1
  * @deprecated since 1.120. Please use {@link sap.ushell.services.PersonalizationV2} instead.
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/PersonalizationV2.js

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's personalization service, which provides generic read and write access to the currently logged on user's
  * personalization settings for the app currently executed in the shell.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/PluginManager/Extensions.js

@@ -2,7 +2,7 @@
 /**
  * @fileOverview The extensions which plugins can use to customise the launchpad
  *
- * @version 1.141.3
+ * @version 1.142.1
  * @private
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/PluginManager/HeaderExtensions.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The extensions for the ShellHeader
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ushell/EventHub"

package/src/main/js/sap/ushell/services/PluginManager/MenuExtensions.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The extensions for the MenuBar, an interface to let plugins request menu entry providers.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define(["sap/ushell/Container"], (Container) => {
     "use strict";

package/src/main/js/sap/ushell/services/PluginManager/SimpleExpression.js

@@ -4,7 +4,7 @@
  * This allows to enter simple postfix expressions and to test if an id complies with the expression.
  * It can replace unsafe regular expressions that are vulnerable to ReDoS attacks.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 
 sap.ui.define([], () => {

package/src/main/js/sap/ushell/services/PluginManager.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's PluginManager service. Allows handling the loading of Fiori Launchpad plugins.
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/base/Log",
@@ -259,7 +259,6 @@ sap.ui.define([
                             UI5ComponentLoaderService
                                 .createComponent(
                                     oApplicationProperties,
-                                    {},
                                     [],
                                     UI5ComponentType.Plugin
                                 )

package/src/main/js/sap/ushell/services/ReferenceResolver.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview resolves references
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/Search.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview The Unified Shell's search service which provides Enterprise Search via SINA.
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ui/core/Lib"

package/src/main/js/sap/ushell/services/SearchCEP.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's Search for myHome.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/base/Log",

package/src/main/js/sap/ushell/services/SearchableContent.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module exposes the searchable content.
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ushell/Config",

package/src/main/js/sap/ushell/services/ShellNavigation.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview Shell Navigation Service.
- * @version 1.141.3
+ * @version 1.142.1
  * @deprecated since 1.120. Use {@link sap.ushell.services.Navigation} for Navigation instead.
  */
 sap.ui.define([

package/src/main/js/sap/ushell/services/SmartNavigation.js

@@ -12,7 +12,7 @@
  * it is pertinent that the API user employs this service's version of <code>toExternal()</code> for cross application
  * navigation (instead) of using the one provided by CrossApplicationNavigation service.</p>
  *
- * @version 1.141.3
+ * @version 1.142.1
  *
  * @deprecated since 1.112. Please use the CrossApplicationNavigation service instead.
  */

package/src/main/js/sap/ushell/services/SpaceContent.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview APIs for the S/4 MyHome
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ushell/Config",

package/src/main/js/sap/ushell/services/UITracer.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's UI tracing service.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
     "sap/ushell/EventHub",

package/src/main/js/sap/ushell/services/URLShortening.js

@@ -6,7 +6,7 @@
  * Service wrapper for the sap/ushell/utils/UrlShortening module.
  * @deprecated since 1.118. Please use the UrlShortening module directly.
  *
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define(["sap/ushell/utils/UrlShortening"], (UrlShortening) => {
     "use strict";

package/src/main/js/sap/ushell/services/URLTemplate.js

@@ -1,7 +1,7 @@
 // Copyright (c) 2009-2025 SAP SE, All Rights Reserved
 /**
  * @fileOverview The URLTemplate service provides utilities when working with URL templates
- * @version 1.141.3
+ * @version 1.142.1
  */
 sap.ui.define([
 ], (