@sapui5/sap.ushell 1.142.0 → 1.143.0

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

@@ -5,7 +5,7 @@
  *
  * This module is for internal Shell usage only
  *
- * @version 1.142.0
+ * @version 1.143.0
  */
 sap.ui.define(["sap/base/Log", "sap/ushell/utils/UrlParsing"], (Log, urlParsing) => {
     "use strict";

package/src/main/js/sap/ushell/utils/workpage/WorkPageHost.js

@@ -2,7 +2,7 @@
 
 /**
  * @file WorkPageHost for WorkPageBuilder and DWSPageBuilder
- * @version 1.142.0
+ * @version 1.143.0
  */
 
 sap.ui.define([

package/src/main/js/sap/ushell/utils/workpage/WorkPageService.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module communicates with the content API graphql service to retrieve workpage and visualization data.
- * @version 1.142.0
+ * @version 1.143.0
  */
 sap.ui.define([
     "sap/base/i18n/Localization",

package/src/main/js/sap/ushell/utils/workpage/WorkPageVizInstantiation.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview This module provides utilities for creating visualization instances for work pages.
- * @version 1.142.0
+ * @version 1.143.0
  */
 sap.ui.define([
     "sap/ushell/services/VisualizationInstantiation",

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

@@ -647,7 +647,7 @@ sap.ui.define([
      * @private
      */
     utils.getIframeFeaturePolicies = function () {
-        return "autoplay;battery;camera;display-capture;geolocation;gyroscope;magnetometer;microphone;midi;clipboard-write;clipboard-read;fullscreen;serial;";
+        return "autoplay;battery;camera;display-capture;geolocation;gyroscope;magnetometer;microphone;midi;clipboard-write;clipboard-read;fullscreen;serial;local-network-access *;";
     };
 
     /**
@@ -1360,28 +1360,32 @@ sap.ui.define([
         return sPrefix + sSeparator + aIds.join(":");
     };
 
-    /**
-     * Checks whether the given intent is the configured root intent (apart from its parameters).
-     * "#Shell-home" should never be hardcoded as it can be configured.
-     *
-     * @param {string} sIntent The intent to check, e.g. <code>#Employee-display</code>.
-     *   The initial hash fragment is ignored during the check.
-     *   For example if <code>#Employee-display</code> matches the root intent, also "Employee-display" does.
-     * @returns {boolean} Whether the given intent is the root intent.
-     * @throws {Error} When a wrong input parameter is given.
-     * @private
-     */
-    utils.isRootIntent = function (sIntent) {
-        if (typeof sIntent !== "string") {
-            throw new Error("The given intent must be a string");
+    utils.getRootIntent = function () {
+        const Container = sap.ui.require("sap/ushell/Container");
+        const oRenderer = Container?.getRendererInternal("fiori2");
+
+        let sConfiguredIntent;
+        if (oRenderer) {
+            try {
+                sConfiguredIntent = oRenderer.getShellConfig().rootIntent;
+                // Might fail when accessing Renderer's config before the view is created
+            } catch { /* fail silently */ }
         }
 
-        // validate configured intent
-        const sRootIntentConfigPath = "renderers.fiori2.componentData.config.rootIntent";
-        const sConfiguredIntent = ObjectPath.get(sRootIntentConfigPath, window["sap-ushell-config"]) || "#Shell-home";
-        const sRootIntentNoHash = sConfiguredIntent.replace("#", "");
-        const sIntentNoHash = sIntent.replace("#", "");
-        return sIntentNoHash === "" || sIntentNoHash === sRootIntentNoHash;
+        if (!sConfiguredIntent) { // fallback to config path if there is no FLP (yet)
+            const sRootIntentConfigPath = "renderers.fiori2.componentData.config.rootIntent";
+            sConfiguredIntent = ObjectPath.get(sRootIntentConfigPath, window["sap-ushell-config"]);
+        }
+
+        if (!sConfiguredIntent) {
+            sConfiguredIntent = "#Shell-home";
+        }
+
+        if (!sConfiguredIntent.startsWith("#")) {
+            sConfiguredIntent = `#${sConfiguredIntent}`;
+        }
+
+        return sConfiguredIntent;
     };
 
     /**
@@ -1397,7 +1401,7 @@ sap.ui.define([
         if (!sIntent) {
             sIntent = window.location.hash;
             if (!sIntent) {
-                sIntent = ObjectPath.get("renderers.fiori2.componentData.config.rootIntent", window["sap-ushell-config"]) || "Shell-home";
+                sIntent = utils.getRootIntent();
             }
         } else if (typeof sIntent !== "string") {
             throw new Error("The given intent must be a string");

package/src/test/js/sap/ushell/bootstrap/sandbox.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's bootstrap code for development sandbox scenarios.
  *
- * @version 1.142.0
+ * @version 1.143.0
  */
 
 (function () {

package/ui5.yaml

@@ -103,8 +103,6 @@ builder:
               - sap/ushell/services/appstate/AppState
               - sap/ushell/services/appstate/AppStatePersistencyMethod
               - sap/ushell/services/PluginManager.js
-              - sap/ushell/services/PluginManager/Extensions.js
-              - sap/ushell/services/PluginManager/HeaderExtensions.js
               - sap/ushell/services/ShellNavigation.js
               - sap/ushell/services/ShellNavigationInternal.js
               - sap/ushell/services/ShellNavigationHashChanger.js

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

@@ -1,58 +0,0 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
-/**
- * @fileOverview The extensions which plugins can use to customise the launchpad
- *
- * @version 1.142.0
- * @private
- */
-sap.ui.define([
-    "sap/ushell/services/PluginManager/HeaderExtensions",
-    "sap/ushell/services/PluginManager/MenuExtensions"
-
-], (HeaderExtensions, fnMenuExtensions) => {
-    "use strict";
-
-    /**
-     * Resolves to the MenuExtensions, which allow modifying menu entries at runtime.
-     *
-     * @param {string} pluginName The plugin name.
-     * @returns {Promise<sap.ushell.services.PluginManager.MenuExtensions>}
-     *    The API to update managed menu trees.
-     *
-     * @private
-     * @since 1.85
-     */
-    function getMenuExtensions (pluginName) {
-        return Promise.resolve(fnMenuExtensions(pluginName));
-    }
-
-    /**
-     * Get the HeaderExtensions object, which contains all possible
-     * customisazion methods for the Shell Header.
-     *
-     * @returns {Promise<sap.ushell.services.PluginManager.HeaderExtensions>}
-     *    The API to customise the ShellHeader.
-     *
-     * @private
-     * @since 1.63
-     */
-    function getHeaderExtensions () {
-        // When ShellHeader will be implemented as standalone, need to add some listener and resolve when header is ready
-        return Promise.resolve(HeaderExtensions);
-    }
-
-    const O_AVAILABLE_EXTENSIONS = {
-        Header: getHeaderExtensions,
-        Menu: getMenuExtensions
-    };
-
-    async function getExtensions (sPluginName, sExtensionName) {
-        const fnExtensionFactory = O_AVAILABLE_EXTENSIONS[sExtensionName];
-        if (!fnExtensionFactory) {
-            throw new Error(`Unsupported extension: '${sExtensionName}'`);
-        }
-        return fnExtensionFactory(sPluginName);
-    }
-
-    return getExtensions;
-});

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

@@ -1,35 +0,0 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
-
-/**
- * @fileOverview The extensions for the ShellHeader
- * @version 1.142.0
- */
-sap.ui.define([
-    "sap/ushell/EventHub"
-], (EventHub) => {
-    "use strict";
-
-    /**
-     * Use only in Fiori3
-     *
-     * Set the control in the central area of header.
-     * @param {string} id The id of the control which should be shown in the central area of the header
-     * @param {boolean} currentState Flag, to set the control only for the current state.
-     * @param {string[]} [states] The list of the states where control should be shown. This parameter is ignored when currentState is true.
-     *  If this parameter is not set and current state is false, then all states will be updated.
-     *
-     * @private
-     * @since 1.63
-     */
-    function setHeaderCentralAreaElement (id, currentState, states) {
-        EventHub.emit("setHeaderCentralAreaElement", {
-            id: id,
-            currentState: currentState,
-            states: states
-        });
-    }
-
-    return {
-        setHeaderCentralAreaElement: setHeaderCentralAreaElement
-    };
-});

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

@@ -1,65 +0,0 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
-
-/**
- * @fileOverview The extensions for the MenuBar, an interface to let plugins request menu entry providers.
- *
- * @version 1.142.0
- */
-sap.ui.define(["sap/ushell/Container"], (Container) => {
-    "use strict";
-
-    /**
-     * Wrapper function which receives the pluginName as an argument.
-     * @param {string} pluginName The name of the plugin.
-     * @returns {function} The getMenuEntryProvider function.
-     *
-     * @private
-     * @since 1.85
-     */
-    function createGetMenuEntryProvider (pluginName) {
-        /**
-         * Returns a menu entry provider object which allows modifying the menu tree for the given node IDs.
-         *
-         * To be used in a plugin component as follows:
-         * <pre><code>
-         *     this.getComponentData().getExtensions("Menu").then(function (oMenuExtensions) {
-         *         oMenuExtensions.getMenuEntryProvider(["node-1", "node-2"]).then(function (oEntryProvider) {
-         *             oEntryProvider["node-1"].setData({ // Setter for the menu node with id:node-1
-         *                 ... // your managed tree
-         *             });
-         *
-         *             oEntryProvider["node-2"].setData({ // Setter for the menu node with id:node-2
-         *                 ... // your managed tree
-         *             });
-         *         });
-         *     });
-         * </code></pre>
-         *
-         * The provided nodeIds
-         * - must exist in the menu
-         * - must not be managed by a different plugin already.
-         *
-         * It is not possible to change a menu entry/subtree that does not have an ID.
-         *
-         * Note: Do not modify properties of the top level (root) menu entries.
-         * Such modifications lead to re-rendering of the menu with a visual flicker.
-         *
-         * @param {string[]} nodeIds A list of the nodeIds to modify.
-         * @returns {Promise<object.<string, function>>} A map with the nodeId as keys and the update functions as values.
-         *
-         * @private
-         * @since 1.85
-         */
-        return function getMenuEntryProvider (nodeIds) {
-            return Container.getServiceAsync("Menu").then((menuService) => {
-                return menuService.getEntryProvider(pluginName, nodeIds);
-            });
-        };
-    }
-
-    return function (pluginName) {
-        return {
-            getMenuEntryProvider: createGetMenuEntryProvider(pluginName)
-        };
-    };
-});