@sapui5/types 1.123.1 → 1.124.0

package/types/sap.ushell.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.123.0
+// For Library Version: 1.124.1
 
 declare module "sap/ushell/library" {
   /**
@@ -868,7 +868,14 @@ declare module "sap/ushell/Container" {
 
   /**
    * The Unified Shell's container. Manages renderers, services, and adapters. The container is designed to
-   * be a singleton, therefore instead of creating an instance, access the central one via `sap.ushell.Container`.
+   * be a singleton, therefore instead of creating an instance, access the central one via
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     // do something with the container
+   *   });
+   * ```
+   *
    * See:
    * 	sap.ushell.bootstrap
    *
@@ -1272,8 +1279,7 @@ declare module "sap/ushell/renderers/fiori2/Renderer" {
 
   /**
    * The SAPUI5 component of SAP Fiori Launchpad renderer for the Unified Shell. This method MUST be called
-   * by the Unified Shell's container only, others MUST call `sap.ushell.Container.createRenderer("fiori2",
-   * true)`.
+   * by the Unified Shell's container only, others MUST call {@link sap.ushell.Container#getRenderer}.
    *
    * @since 1.15.0
    * @deprecated (since 1.120.0) - Please use {@link sap.ushell.services.Extension} instead.
@@ -2744,8 +2750,16 @@ declare module "sap/ushell/services/AppLifeCycle" {
   /**
    * The Unified Shell's AppLifeCycle service.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("AppLifeCycle")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const AppLifeCycle = await Container.getServiceAsync("AppLifeCycle");
+   *     // do something with the AppLifeCycle service
+   *   });
+   * ```
+   *
    *
    * @since 1.38
    */
@@ -2810,8 +2824,7 @@ declare module "sap/ushell/services/AppLifeCycle" {
       oListener: object
     ): void;
     /**
-     * Returns information about the currently running application Information object about currently running
-     * application or `undefined` if no application is running.
+     * Returns information about the currently running application or `undefined` if no application is running.
      *
      * @since 1.38
      *
@@ -3024,8 +3037,16 @@ declare module "sap/ushell/services/Bookmark" {
   /**
    * The Unified Shell's bookmark service. Allows creating shortcuts on the user's home page.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Bookmark")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const Bookmark = await Container.getServiceAsync("Bookmark");
+   *     // do something with the Bookmark service
+   *   });
+   * ```
+   *
    *
    * @since 1.15.0
    * @deprecated (since 1.119) - Please use {@link sap.ushell.services.BookmarkV2} instead.
@@ -3368,8 +3389,16 @@ declare module "sap/ushell/services/BookmarkV2" {
   /**
    * The Unified Shell's bookmark service. Allows creating shortcuts on the user's home page.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("BookmarkV2")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const BookmarkV2 = await Container.getServiceAsync("BookmarkV2");
+   *     // do something with the BookmarkV2 service
+   *   });
+   * ```
+   *
    *
    * @since 1.119.0
    */
@@ -3626,8 +3655,16 @@ declare module "sap/ushell/services/Configuration" {
    * The unified shell's Configuration service. Allows attaching to **selected** launchpad configuration settings
    * and their value changes.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Configuration")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const Configuration = await Container.getServiceAsync("Configuration");
+   *     // do something with the Configuration service
+   *   });
+   * ```
+   *
    *
    * @since 1.64.0
    */
@@ -3755,8 +3792,16 @@ declare module "sap/ushell/services/CrossApplicationNavigation" {
    * of the currently running app (but still in scope of the current Fiori launchpad) or to create links to
    * such external targets.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const CrossApplicationNavigation = await Container.getServiceAsync("CrossApplicationNavigation");
+   *     // do something with the CrossApplicationNavigation service
+   *   });
+   * ```
+   *
    *
    * The CrossApplicationNavigation service currently provides platform independent functionality.
    *
@@ -3765,9 +3810,7 @@ declare module "sap/ushell/services/CrossApplicationNavigation" {
    * Usage:
    * ```javascript
    *
-   *   sap.ushell.Container.getServiceAsync("CrossApplicationNavigation").then( function (oService) {
-   *
-   *      oService.hrefForExternalAsync({
+   *      CrossApplicationNavigation.hrefForExternalAsync({
    *          target : {
    *              semanticObject: "Product",
    *              action: "display"
@@ -3778,7 +3821,6 @@ declare module "sap/ushell/services/CrossApplicationNavigation" {
    *      }).then( function(sHref) {
    *          // Place sHref somewhere in the DOM
    *      });
-   *   });
    *   ```
    *
    *
@@ -4427,12 +4469,10 @@ declare module "sap/ushell/services/CrossApplicationNavigation" {
      * to use in link tags:
      * ```javascript
      *
-     *   sap.ushell.Container.getServiceAsync("CrossApplicationNavigation").then( function (oService) {
-     *     oService.hrefForExternalAsync({
-     *         target: { shellHash: oLink.intent }
-     *     }, that.oComponent).then( function (sExternalHref) {
-     *          // do something with the resolved sExternalHref.
-     *        });
+     *   CrossApplicationNavigation.hrefForExternalAsync({
+     *       target: { shellHash: oLink.intent }
+     *   }, that.oComponent).then( function (sExternalHref) {
+     *        // do something with the resolved sExternalHref.
      *   });
      * ```
      *
@@ -4620,7 +4660,7 @@ declare module "sap/ushell/services/CrossApplicationNavigation" {
      *     target: { shellHash: "SalesOrder-approve?SOId=1234" }
      *   ])
      *   .done(function(aResponses) {
-     *     if (oResponse[0].supported===true){
+     *     if (aResponses[0].supported===true){
      *       // enable link
      *     }
      *     else {
@@ -4816,8 +4856,16 @@ declare module "sap/ushell/services/EndUserFeedback" {
    * The Unified Shell's end user feedback service. This service is deprecated and does nothing. End user
    * feedback functionality is not part of the ushell library.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("DarkModeSupport")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const EndUserFeedback = await Container.getServiceAsync("EndUserFeedback");
+   *     // do something with the EndUserFeedback service
+   *   });
+   * ```
+   *
    *
    * @since 1.25.1
    * @deprecated (since 1.93)
@@ -4857,30 +4905,194 @@ declare module "sap/ushell/services/EndUserFeedback" {
 }
 
 declare module "sap/ushell/services/Extension" {
+  import { Properties } from "sap/ushell/ui/shell/ShellHeadItem";
+
+  import Item from "sap/ushell/services/Extension/Item";
+
+  /**
+   * The Unified Shell's Extension service. Allows adding extensions on the user's home page.
+   *
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const Extension = await Container.getServiceAsync("Extension");
+   *     // do something with the Extension service
+   *   });
+   * ```
+   *
+   *
+   * This service is available in any FLP context (native, iframe, ...).
+   *
+   *
+   *  All extension items and extension areas are instantiated as invisible. You have to call .show<...> to
+   * make them visible.
+   *
+   * @since 1.120.0
+   */
+  export default class Extension extends sap.ushell.services.Service {
+    /**
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     */
+    protected constructor();
+
+    /**
+     * Creates a header item in the shell header. **Restrictions:**
+     * 	 - The control properties are only allowed to contain primitive properties and event handlers. Aggregations,
+     *     controls and types with prototypes are not allowed!
+     * 	 - The event handlers are not bound to the actual control and do not receive the event arguments.
+     *
+     * @since 1.120.0
+     *
+     * @returns The newly created header item.
+     */
+    createHeaderItem(
+      /**
+       * The properties that will be passed to the created control.
+       */
+      controlProperties: Properties,
+      /**
+       * Additional parameters.
+       */
+      parameters?: {
+        /**
+         * Possible values are `begin` and `end`.
+         */
+        position?: string;
+      }
+    ): Promise<Item>;
+    /**
+     * Creates a user action in the user action menu.
+     *  **Restrictions:**
+     * 	 - The control properties are only allowed to contain primitive properties and event handlers. Aggregations,
+     *     controls and types with prototypes are not allowed!
+     * 	 - The event handlers are not bound to the actual control and do not receive the event arguments.
+     *
+     * @since 1.120.0
+     *
+     * @returns The newly created user action.
+     */
+    createUserAction(
+      /**
+       * The properties that will be passed to the created control.
+       */
+      controlProperties: object,
+      /**
+       * Additional parameters.
+       */
+      parameters?: {
+        /**
+         * Defines the `controlType`.
+         */
+        controlType?: string;
+      }
+    ): Promise<Item>;
+  }
+}
+
+declare module "sap/ushell/services/Extension/Item" {
+  /**
+   * Item wrapping an item positioned in an extension point. To be instantiated by {@link sap.ushell.services.Extension}.
+   *
+   * @since 1.120.0
+   */
+  export default class Item {
+    /**
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     */
+    protected constructor();
+
+    /**
+     * Destroys the item and it's related content.
+     *
+     * @since 1.120.0
+     *
+     * @returns Resolves once the item was destroyed.
+     */
+    destroy(): Promise<any>;
+    /**
+     * Shows the item for all applications. Does not change the visibility of the item for the launchpad "home".
+     *
+     * @since 1.120.0
+     *
+     * @returns Reference to `this` for method chaining.
+     */
+    hideForAllApps(): this;
+    /**
+     * Hides the item for the current application. Note: The item will not be hidden if it was set visible for
+     * all apps {@link #showForAllApps}
+     *
+     * @since 1.120.0
+     *
+     * @returns Reference to `this` for method chaining.
+     */
+    hideForCurrentApp(): this;
+    /**
+     * Hides the item for launchpad "home". Does not change the visibility of the item within applications.
+     *
+     * @since 1.120.0
+     *
+     * @returns Reference to `this` for method chaining.
+     */
+    hideOnHome(): this;
+    /**
+     * Shows the item for all applications. Does not change the visibility of the item for the launchpad "home".
+     *
+     * @since 1.120.0
+     *
+     * @returns Reference to `this` for method chaining.
+     */
+    showForAllApps(): this;
+    /**
+     * Shows the item for the current application. The item will be hidden after the user navigates away from
+     * this application. The item will not be added again if the user navigates back to the application.
+     *
+     * @since 1.120.0
+     *
+     * @returns Reference to `this` for method chaining.
+     */
+    showForCurrentApp(): this;
+    /**
+     * Shows the item for launchpad "home". Does not change the visibility of the item within applications.
+     *
+     * @since 1.120.0
+     *
+     * @returns Reference to `this` for method chaining.
+     */
+    showOnHome(): this;
+  }
+}
+
+declare module "sap/ushell/services/FrameBoundExtension" {
   import Control from "sap/ui/core/Control";
 
-  import Footer from "sap/ushell/services/Extension/Footer";
+  import Footer from "sap/ushell/services/FrameBoundExtension/Footer";
 
-  import Item from "sap/ushell/services/Extension/Item";
+  import { Properties } from "sap/ushell/ui/shell/ShellHeadItem";
 
-  import SidePane from "sap/ushell/services/Extension/SidePane";
+  import Item from "sap/ushell/services/FrameBoundExtension/Item";
 
-  import ToolArea from "sap/ushell/services/Extension/ToolArea";
+  import SidePane from "sap/ushell/services/FrameBoundExtension/SidePane";
+
+  import ToolArea from "sap/ushell/services/FrameBoundExtension/ToolArea";
 
   /**
    * The Unified Shell's Extension service. Allows adding extensions on the user's home page.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Extension")`.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("FrameBoundExtension")`.
    * For details, see {@link sap.ushell.Container#getServiceAsync}.
    *
+   * **Restriction:** This Service does not work when called from within a iframe. The calling function
+   * has to be in the 'same frame' as the launchpad itself.
+   *
    *
    *  All extension items and extension areas are instantiated as invisible. You have to call .show<...> to
    * make them visible.
    *
-   * @since 1.120.0
-   * @experimental (since 1.120.0) - Restriction: API calls might be ignored for apps running in an iframe
+   * @since 1.124.0
    */
-  export default class Extension extends sap.ushell.services.Service {
+  export default class FrameBoundExtension extends sap.ushell.services.Service {
     /**
      * @ui5-protected Do not call from applications (only from related classes in the framework)
      */
@@ -4888,10 +5100,10 @@ declare module "sap/ushell/services/Extension" {
 
     /**
      * Adds an entry to the user settings dialog box including the UI control that appears when the user clicks
-     * the new entry, and handling of user settings actions such as SAVE and CANCEL. **Restriction:** Might
-     * be ignored for apps running in an iframe
+     * the new entry, and handling of user settings actions such as SAVE and CANCEL. **Restriction:** NOT
+     * available for apps running in an iframe
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Resolves once the settings entry was added.
      */
@@ -4938,9 +5150,9 @@ declare module "sap/ushell/services/Extension" {
      * Creates a new footer which is positioned below the launchpad content.
      *
      * **Note:** Only one footer is displayed at once. Any new footer will replace the previous one **Restriction:**
-     * Might be ignored for apps running in an iframe
+     * NOT available for apps running in an iframe
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns The newly created footer.
      */
@@ -4962,7 +5174,7 @@ declare module "sap/ushell/services/Extension" {
     /**
      * Creates a header item in the shell header.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns The newly created header item.
      */
@@ -4970,7 +5182,7 @@ declare module "sap/ushell/services/Extension" {
       /**
        * The properties that will be passed to the created control.
        */
-      controlProperties: object,
+      controlProperties: Properties,
       /**
        * Additional parameters.
        */
@@ -4984,10 +5196,10 @@ declare module "sap/ushell/services/Extension" {
     /**
      * Creates a new sub header which is positioned below the header.
      *
-     * **Note:** Only one sub header is displayed at once **Restriction:** Might be ignored for apps
+     * **Note:** Only one sub header is displayed at once **Restriction:** NOT available for apps
      * running in an iframe
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns The newly created sub header.
      */
@@ -5009,7 +5221,7 @@ declare module "sap/ushell/services/Extension" {
     /**
      * Creates a user action in the user action menu.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns The newly created user action.
      */
@@ -5030,18 +5242,18 @@ declare module "sap/ushell/services/Extension" {
     ): Promise<Item>;
     /**
      * Returns the API for the SidePane which is located next to the launchpad content. **Restriction:**
-     * Might be ignored for apps running in an iframe
+     * NOT available for apps running in an iframe
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns The SidePane.
      */
     getSidePane(): Promise<SidePane>;
     /**
      * Returns the API for the ToolArea which is located next to the launchpad content. **Restriction:**
-     * Might be ignored for apps running in an iframe
+     * NOT available for apps running in an iframe
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns The ToolArea.
      */
@@ -5049,13 +5261,16 @@ declare module "sap/ushell/services/Extension" {
   }
 }
 
-declare module "sap/ushell/services/Extension/Footer" {
+declare module "sap/ushell/services/FrameBoundExtension/Footer" {
+  import Control from "sap/ui/core/Control";
+
   /**
-   * The footer extension point is positioned below the launchpad content. To be instantiated by {@link sap.ushell.services.Extension}.
-   * **Restriction:** Might be ignored for apps running in an iframe
+   * The footer extension point is positioned below the launchpad content. To be instantiated by {@link sap.ushell.services.FrameBoundExtension}.
    *
-   * @since 1.120.0
-   * @experimental (since 1.120.0)
+   * **Restriction:** Does not work when called from within a iframe. The calling function has to be in
+   * the 'same frame' as the launchpad itself.
+   *
+   * @since 1.124.0
    */
   export default class Footer {
     /**
@@ -5066,20 +5281,32 @@ declare module "sap/ushell/services/Extension/Footer" {
     /**
      * Destroys the footer.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Resolves once the footer was destroyed.
      */
     destroy(): Promise<any>;
+    /**
+     * Returns the related control instance.
+     *
+     * @since 1.124.0
+     *
+     * @returns The control.
+     */
+    getControl(): Promise<Control>;
   }
 }
 
-declare module "sap/ushell/services/Extension/Item" {
+declare module "sap/ushell/services/FrameBoundExtension/Item" {
+  import Control from "sap/ui/core/Control";
+
   /**
-   * Item wrapping an item positioned in an extension point. To be instantiated by {@link sap.ushell.services.Extension}.
+   * Item wrapping an item positioned in an extension point. To be instantiated by {@link sap.ushell.services.FrameBoundExtension}.
    *
-   * @since 1.120.0
-   * @experimental (since 1.120.0)
+   * **Restriction:** Does not work when called from within a iframe. The calling function has to be in
+   * the 'same frame' as the launchpad itself.
+   *
+   * @since 1.124.0
    */
   export default class Item {
     /**
@@ -5090,15 +5317,23 @@ declare module "sap/ushell/services/Extension/Item" {
     /**
      * Destroys the item and it's related content.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Resolves once the item was destroyed.
      */
     destroy(): Promise<any>;
+    /**
+     * Returns the related control instance.
+     *
+     * @since 1.124.0
+     *
+     * @returns The control.
+     */
+    getControl(): Promise<Control>;
     /**
      * Shows the item for all applications. Does not change the visibility of the item for the launchpad "home".
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5107,7 +5342,7 @@ declare module "sap/ushell/services/Extension/Item" {
      * Hides the item for the current application. Note: The item will not be hidden if it was set visible for
      * all apps {@link #showForAllApps}
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5115,7 +5350,7 @@ declare module "sap/ushell/services/Extension/Item" {
     /**
      * Hides the item for launchpad "home". Does not change the visibility of the item within applications.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5123,7 +5358,7 @@ declare module "sap/ushell/services/Extension/Item" {
     /**
      * Shows the item for all applications. Does not change the visibility of the item for the launchpad "home".
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5132,7 +5367,7 @@ declare module "sap/ushell/services/Extension/Item" {
      * Shows the item for the current application. The item will be hidden after the user navigates away from
      * this application. The item will not be added again if the user navigates back to the application.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5140,7 +5375,7 @@ declare module "sap/ushell/services/Extension/Item" {
     /**
      * Shows the item for launchpad "home". Does not change the visibility of the item within applications.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5148,15 +5383,16 @@ declare module "sap/ushell/services/Extension/Item" {
   }
 }
 
-declare module "sap/ushell/services/Extension/SidePane" {
-  import Item from "sap/ushell/services/Extension/Item";
+declare module "sap/ushell/services/FrameBoundExtension/SidePane" {
+  import Item from "sap/ushell/services/FrameBoundExtension/Item";
 
   /**
-   * The side pane extension point is positioned next the launchpad content. To be instantiated by {@link sap.ushell.services.Extension}.
-   * **Restriction:** Might be ignored for apps running in an iframe
+   * The side pane extension point is positioned next the launchpad content. To be instantiated by {@link sap.ushell.services.FrameBoundExtension}.
    *
-   * @since 1.120.0
-   * @experimental (since 1.120.0)
+   * **Restriction:** Does not work when called from within a iframe. The calling function has to be in
+   * the 'same frame' as the launchpad itself.
+   *
+   * @since 1.124.0
    */
   export default class SidePane {
     /**
@@ -5167,7 +5403,7 @@ declare module "sap/ushell/services/Extension/SidePane" {
     /**
      * Creates an item in the side pane.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns The newly created item.
      */
@@ -5190,7 +5426,7 @@ declare module "sap/ushell/services/Extension/SidePane" {
      * Shows the side pane for all applications. Does not change the visibility of the side pane for the launchpad
      * "home".
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5198,7 +5434,7 @@ declare module "sap/ushell/services/Extension/SidePane" {
     /**
      * Hides the area for launchpad "home". Does not change the visibility of the area within applications.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5207,7 +5443,7 @@ declare module "sap/ushell/services/Extension/SidePane" {
      * Shows the side pane for all applications. Does not change the visibility of the side pane for the launchpad
      * "home".
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5215,7 +5451,7 @@ declare module "sap/ushell/services/Extension/SidePane" {
     /**
      * Shows the side pane for launchpad "home". Does not change the visibility of the side pane within applications.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5223,15 +5459,16 @@ declare module "sap/ushell/services/Extension/SidePane" {
   }
 }
 
-declare module "sap/ushell/services/Extension/ToolArea" {
-  import Item from "sap/ushell/services/Extension/Item";
+declare module "sap/ushell/services/FrameBoundExtension/ToolArea" {
+  import Item from "sap/ushell/services/FrameBoundExtension/Item";
 
   /**
-   * The tool area extension point is positioned next the launchpad content. To be instantiated by {@link sap.ushell.services.Extension}.
-   * **Restriction:** Might be ignored for apps running in an iframe
+   * The tool area extension point is positioned next the launchpad content. To be instantiated by {@link sap.ushell.services.FrameBoundExtension}.
    *
-   * @since 1.120.0
-   * @experimental (since 1.120.0)
+   * **Restriction:** Does not work when called from within a iframe. The calling function has to be in
+   * the 'same frame' as the launchpad itself.
+   *
+   * @since 1.124.0
    */
   export default class ToolArea {
     /**
@@ -5242,7 +5479,7 @@ declare module "sap/ushell/services/Extension/ToolArea" {
     /**
      * Creates an item in the tool area.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns The newly created item.
      */
@@ -5256,7 +5493,7 @@ declare module "sap/ushell/services/Extension/ToolArea" {
      * Shows the tool area for all applications. Does not change the visibility of the tool area for the launchpad
      * "home".
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5264,7 +5501,7 @@ declare module "sap/ushell/services/Extension/ToolArea" {
     /**
      * Hides the tool area for launchpad "home". Does not change the visibility of the tool area within applications.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5273,7 +5510,7 @@ declare module "sap/ushell/services/Extension/ToolArea" {
      * Shows the tool area for all applications. Does not change the visibility of the tool area for the launchpad
      * "home".
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5281,7 +5518,7 @@ declare module "sap/ushell/services/Extension/ToolArea" {
     /**
      * Shows the tool area for launchpad "home". Does not change the visibility of the tool area within applications.
      *
-     * @since 1.120.0
+     * @since 1.124.0
      *
      * @returns Reference to `this` for method chaining.
      */
@@ -5293,8 +5530,16 @@ declare module "sap/ushell/services/LaunchPage" {
   /**
    * A service for handling groups, tiles and catalogs.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Extension")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const LaunchPage = await Container.getServiceAsync("LaunchPage");
+   *     // do something with the LaunchPage service
+   *   });
+   * ```
+   *
    *
    * The functions that return the main objects are getGroups, getGroupTitle, getCatalogs and getCatalogTiles.
    * Since the implementation (i.e. adapter) is platform specific, do not call or access properties and functions
@@ -6064,8 +6309,16 @@ declare module "sap/ushell/services/Message" {
   /**
    * Message service.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Message")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const Message = await Container.getServiceAsync("Message");
+   *     // do something with the Message service
+   *   });
+   * ```
+   *
    *
    * @since 1.16.0
    * @deprecated (since 1.120)
@@ -6184,8 +6437,16 @@ declare module "sap/ushell/services/Navigation" {
    * The Unified Shell's Navigation service. Allows navigating to "external" targets outside of the currently
    * running app (but still in scope of the current Fiori launchpad) or to create links to such external targets.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Navigation")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const Navigation = await Container.getServiceAsync("Navigation");
+   *     // do something with the Navigation service
+   *   });
+   * ```
+   *
    *
    * The Navigation service currently provides platform independent functionality.
    *
@@ -6194,19 +6455,16 @@ declare module "sap/ushell/services/Navigation" {
    * Usage:
    * ```javascript
    *
-   *   sap.ui.require(["sap/ushell/Container"], async (Container) => {
-   *     const oNavigationService = await Container.getServiceAsync("Navigation");
-   *     const sHref = await oNavigationService.getHref({
-   *       target : {
-   *         semanticObject: "Product",
-   *         action: "display"
-   *       },
-   *       params: {
-   *         "ProductID": "102343333"
-   *       }
-   *     }, oComponent);
-   *     // do something with the resolved sHref.
-   *   });
+   *   const sHref = await Navigation.getHref({
+   *     target : {
+   *       semanticObject: "Product",
+   *       action: "display"
+   *     },
+   *     params: {
+   *       "ProductID": "102343333"
+   *     }
+   *   }, oComponent);
+   *   // do something with the resolved sHref.
    * ```
    *
    *
@@ -6264,13 +6522,10 @@ declare module "sap/ushell/services/Navigation" {
      *
      * ```javascript
      *
-     *   sap.ui.require(["sap/ushell/Container"], async (Container) => {
-     *     const oNavigationService = await Container.getServiceAsync("Navigation");
-     *     const sHref = await oNavigationService.getHref({
-     *       target: { shellHash: oLink.intent }
-     *     }, oComponent);
-     *     // do something with the resolved sHref.
-     *   });
+     *   const sHref = await Navigation.getHref({
+     *     target: { shellHash: oLink.intent }
+     *   }, oComponent);
+     *   // do something with the resolved sHref.
      * ```
      *
      *
@@ -6690,14 +6945,30 @@ declare module "sap/ushell/services/Navigation" {
    * @since 1.121.0
    */
   export type TargetIntent = string;
+
+  /**
+   * The target intent in strict format. same as {@link sap.ushell.services.Navigation.TargetIntent} but with
+   * the following restriction: The intent must not start with a hash character (#).
+   *
+   * @since 1.124.0
+   */
+  export type TargetIntentStrict = string;
 }
 
 declare module "sap/ushell/services/NavTargetResolution" {
   /**
    * The Unified Shell's internal navigation target resolution service.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("NavTargetResolution")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const NavTargetResolution = await Container.getServiceAsync("NavTargetResolution");
+   *     // do something with the NavTargetResolution service
+   *   });
+   * ```
+   *
    *
    * Methods in this class deal with *internal* representations of the shell hash.
    *
@@ -6916,8 +7187,16 @@ declare module "sap/ushell/services/Notifications" {
    * UShell service for fetching user notification data from the Notification center/service
    *  and exposing them to the Unified Shell and Fiori applications UI controls.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const Notifications = await Container.getServiceAsync("Notifications");
+   *     // do something with the Notifications service
+   *   });
+   * ```
+   *
    *
    * In order to get user notifications, Unified Shell notification service issues OData requests
    *  to the service defined by the configuration property `serviceUrl`,
@@ -7105,8 +7384,16 @@ declare module "sap/ushell/services/NotificationsV2" {
    * UShell service for fetching user notification data from the Notification center/service
    *  and exposing them to the Unified Shell and Fiori applications UI controls.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("NotificationsV2")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const NotificationsV2 = await Container.getServiceAsync("NotificationsV2");
+   *     // do something with the NotificationsV2 service
+   *   });
+   * ```
+   *
    *
    * In order to get user notifications, Unified Shell notification service issues OData requests
    *  to the service defined by the configuration property `serviceUrl`,
@@ -7136,7 +7423,7 @@ declare module "sap/ushell/services/NotificationsV2" {
      */
     protected constructor();
     /**
-     * Enumaration for The nature of the notification
+     * Enumeration for The nature of the notification
      *
      * This enum is part of the 'sap/ushell/services/NotificationsV2' module export and must be accessed by
      * the property 'Nature'.
@@ -7355,7 +7642,7 @@ declare module "sap/ushell/services/NotificationsV2" {
   };
 
   /**
-   * Enumaration for The nature of the notification
+   * Enumeration for The nature of the notification
    *
    * This enum is part of the 'sap/ushell/services/NotificationsV2' module export and must be accessed by
    * the property 'Nature'.
@@ -7527,8 +7814,16 @@ declare module "sap/ushell/services/Personalization" {
    * The Unified Shell's personalization service, which provides a personalizer object that handles all personalization
    * operations.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const Personalization = await Container.getServiceAsync("Personalization");
+   *     // do something with the Personalization service
+   *   });
+   * ```
+   *
    *
    * @since 1.15.0
    * @deprecated (since 1.120) - Please use {@link sap.ushell.services.PersonalizationV2} instead
@@ -8606,8 +8901,16 @@ declare module "sap/ushell/services/PersonalizationV2" {
    * The Unified Shell's personalization service. Provides a personalizer object that handles all personalization
    * operations.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("PersonalizationV2")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const PersonalizationV2 = await Container.getServiceAsync("PersonalizationV2");
+   *     // do something with the PersonalizationV2 service
+   *   });
+   * ```
+   *
    *
    * @since 1.120.0
    */
@@ -8813,7 +9116,7 @@ declare module "sap/ushell/services/PersonalizationV2" {
     getTransientPersonalizer(): Promise<TransientPersonalizer>;
   }
   /**
-   * currently the validity property of the scope object is relevant:
+   * The persId identifies the stored personalization container.
    */
   export type PersId = {
     /**
@@ -8827,30 +9130,42 @@ declare module "sap/ushell/services/PersonalizationV2" {
   };
 
   /**
-   * currently the validity property of the scope object is relevant:
+   * The scope controls the behavior of the container used by the personalization service.
    */
   export type Scope = {
     /**
-     * validity of the container persistence in minutes
-     *  0 ( per FLP Window),
-     *  Infinity, undefined (front-end server persistence per user )
-     *  x Minutes (front-end server persistence per user, ignored if older than x minutes)
+     * validity of the container persistence in minutes. Available values:
+     *  · 0 - The data is persisted in the launchpad window, and is lost when the window is closed or when the
+     * launchpad is reloaded.
+     *  · Infinity - The data is persisted on the front-end server without any time restrictions.
+     *  · x Minutes - Number of minutes the data is to be persisted on the front-end server, for example 30.
+     *
+     *
+     * For validity > 0 (including infinity) a copy of the container is stored in the volatile memory of the
+     * launchpad window in the browser. Therefore, no roundtrip is necessary for reloading a container at a
+     * later point in time. Only if the launchpad itself is reloaded, the copy is lost and a roundtrip is necessary.
      */
     validity?: int;
     /**
      * Type or category of key
      */
-    keyCategory?: /* was: sap.ushell.services.PersonalizationV2.constants.keyCategory */ any;
+    keyCategory?:
+      | sap.ushell.services.PersonalizationV2.KeyCategory
+      | keyof typeof sap.ushell.services.PersonalizationV2.KeyCategory;
     /**
      * Expected frequency how often users will use this container to store data inside
      */
-    writeFrequency?: /* was: sap.ushell.services.PersonalizationV2.constants.writeFrequency */ any;
+    writeFrequency?:
+      | sap.ushell.services.PersonalizationV2.WriteFrequency
+      | keyof typeof sap.ushell.services.PersonalizationV2.WriteFrequency;
     /**
-     * Defines if storage on client side should be allowed or not
+     * Defines if storage on client side should be allowed or not. Security-relevant data must not be stored
+     * on client side, for instance in local storage or in the HTTP browser cache. Applications should set this
+     * parameter to `true` only if the data is not critical from a security point of view.
      */
     clientStorageAllowed?: boolean;
     /**
-     * Indicates the container is intended to be shared across multiple applications
+     * Indicates the container is intended to be shared across multiple applications.
      */
     shared?: boolean;
   };
@@ -9396,8 +9711,16 @@ declare module "sap/ushell/services/ShellNavigation" {
   /**
    * The Unified Shell's internal navigation service (platform independent).
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ShellNavigation")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const ShellNavigation = await Container.getServiceAsync("ShellNavigation");
+   *     // do something with the ShellNavigation service
+   *   });
+   * ```
+   *
    *
    * This interface is for consumption by shell renderers/containers only
    *
@@ -9565,8 +9888,16 @@ declare module "sap/ushell/services/SmartNavigation" {
    * will cause an increment of the frequency count, regardless of whether or not the navigation was successful.
    *
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const SmartNavigation = await Container.getServiceAsync("SmartNavigation");
+   *     // do something with the SmartNavigation service
+   *   });
+   * ```
+   *
    *
    * @since 1.44.0
    * @deprecated (since 1.112) - This service has been deprecated. Please use the CrossApplicationNavigation
@@ -9731,8 +10062,16 @@ declare module "sap/ushell/services/SupportTicket" {
   /**
    * The Unified Shell's SupportTicket service.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("SupportTicket")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const SupportTicket = await Container.getServiceAsync("SupportTicket");
+   *     // do something with the SupportTicket service
+   *   });
+   * ```
+   *
    *
    * @since 1.19.1
    */
@@ -9783,15 +10122,26 @@ declare module "sap/ushell/services/SupportTicket" {
 declare module "sap/ushell/services/URLParsing" {
   import Component from "sap/ui/core/Component";
 
-  import { URI } from "sap/ui/core/library";
+  import {
+    TargetIntentStrict,
+    TargetIntent,
+  } from "sap/ushell/services/Navigation";
 
-  import { TargetIntent } from "sap/ushell/services/Navigation";
+  import { URI } from "sap/ui/core/library";
 
   /**
    * The Unified Shell's internal URL parsing service (platform independent).
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("URLParsing")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const URLParsing = await Container.getServiceAsync("URLParsing");
+   *     // do something with the URLParsing service
+   *   });
+   * ```
+   *
    *
    * Methods in this class allow to break down a shell compliant hash into it's respective parts (SemanticObject,Action,Context,
    * Parameters, appSpecificHash) or (ShellPart,appSpecificHash) respectively or construct a hash from its
@@ -9874,31 +10224,16 @@ declare module "sap/ushell/services/URLParsing" {
      *
      * @since 1.16.0
      *
-     * @returns the hash part of an URL, e.g. `"Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH` returns
-     * "" for an undefined object
+     * @returns the hash part of an URL, e.g. `"Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH` Returns
+     * an empty string in case no shell hash was provided.
      */
     constructShellHash(
       /**
-       * The action must be a valid action, it may not contain "?" or directly a parameter string `undefined`
-       * if not a parsable hash
-       * ```javascript
-       *
-       *   {
-       *     target: {
-       *       semanticObject: string,
-       *       action: string,
-       *       contextRaw: string
-       *     },
-       *     params: MapObject,
-       *     appStateKey: string
-       *     appSpecificRoute: string
-       *   }
-       * ```
-       *  xor `{ target: { shellHash } }` Note: in general it is preferred to add an appStateKey directly to the
-       * params object
+       * The parts of a shell hash. Its action must be a valid action, It may not contain "?" or directly a parameter
+       * string. Note: In general it is preferred to add an appStateKey directly to the params object.
        */
-      oShellHash: object
-    ): string;
+      oShellHash?: SimpleDecomposedHash | DecomposedHash
+    ): TargetIntentStrict;
     /**
      * Extract a hash part from an URL, including an app-specific part
      *
@@ -9935,8 +10270,8 @@ declare module "sap/ushell/services/URLParsing" {
        * a valid (Shell) url, e.g.
        *  `http://xx.b.c#Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH`
        */
-      sShellHashString: string
-    ): object;
+      sShellHashString: URI
+    ): TargetIntent;
     /**
      * Check if a URL has an intent based navigation part which can be parsed into a semantic object and action
      * part. Accepts only a relative URL (must contain #) or fully qualified Urls for which origin and filename
@@ -10024,7 +10359,7 @@ declare module "sap/ushell/services/URLParsing" {
        *  e.g. `"#Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH`
        */
       sHash: TargetIntent
-    ): decomposedHash;
+    ): DecomposedHash;
     /**
      * split a Unified Shell compliant hash into an Object containing a shell specific part and an app specific
      * parts
@@ -10048,14 +10383,14 @@ declare module "sap/ushell/services/URLParsing" {
        * Here is an example for the hash part of an URL: "#Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH
        */
       sHash: TargetIntent
-    ): splitHash;
+    ): SplitHash;
   }
   /**
-   * Type for decomposedHash
+   * Type for DecomposedHash
    *
    * @since 1.120.0
    */
-  export type decomposedHash = {
+  export type DecomposedHash = {
     /**
      * the semantic object
      */
@@ -10072,14 +10407,40 @@ declare module "sap/ushell/services/URLParsing" {
      * the parameters
      */
     params: Record<string, string[]>;
+    /**
+     * the app state key
+     */
+    appStateKey?: string;
+    /**
+     * the app specific route
+     */
+    appSpecificRoute?: string;
   };
 
   /**
-   * Type for splitHash
+   * Simple Type for DecomposedHash with shell hash as part of the target property. Use this type for edge
+   * cases only. Use {@link sap.ushell.services.URLParsing.DecomposedHash} instead.
+   *
+   * @since 1.124.0
+   */
+  export type SimpleDecomposedHash = {
+    /**
+     * The target object
+     */
+    target: {
+      /**
+       * The shell hash
+       */
+      shallHash: TargetIntent;
+    };
+  };
+
+  /**
+   * Type for SplitHash
    *
    * @since 1.120.0
    */
-  export type splitHash = {
+  export type SplitHash = {
     /**
      * the shell part of the hash
      */
@@ -10102,8 +10463,16 @@ declare module "sap/ushell/services/UsageAnalytics" {
   /**
    * A UShell service for tracking business flows and user actions.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const UsageAnalytics = await Container.getServiceAsync("UsageAnalytics");
+   *     // do something with the UsageAnalytics service
+   *   });
+   * ```
+   *
    *
    * The UsageAnalytics service exposes API for logging custom events and setting custom field values in the
    * logged events.
@@ -10142,6 +10511,7 @@ declare module "sap/ushell/services/UsageAnalytics" {
      *  Currently these attributes correspond to database columns custom5...custom10.
      *
      * @since 1.32.0
+     * @deprecated (since 1.120.0)
      */
     setCustomAttributes(
       /**
@@ -10164,6 +10534,7 @@ declare module "sap/ushell/services/UsageAnalytics" {
      * Enables the renderer to set the content of the legal message..
      *
      * @since 1.32.0
+     * @deprecated (since 1.120.0)
      */
     setLegalText(): void;
     /**
@@ -10171,13 +10542,10 @@ declare module "sap/ushell/services/UsageAnalytics" {
      *
      *
      *
-     * Returns `true` if the following conditions exist, and `false` otherwise:
-     *  a) Service configuration property `enable` is set to `true`
-     *  b) Service configuration property `pubToken` is not empty
-     *  c) Agreement text exists or `setUsageAnalyticsPermitted` is set to `false`
-     *
+     * Since the service is deprecated and no longer supported, this method always returns `false`.
      *
      * @since 1.32.0
+     * @deprecated (since 1.120.0)
      *
      * @returns A boolean value indicating whether the UsageAnalytics service is enabled
      */
@@ -10187,12 +10555,10 @@ declare module "sap/ushell/services/UsageAnalytics" {
      *
      *
      *
-     * Returns `true` if the following conditions exist, and `false` otherwise:
-     *  a) The function `system enabled` returns `true`
-     *  b) The user property `trackUsageAnalytics` is set to `true`
-     *
+     * Since the service is deprecated and no longer supported, this method always returns `false`.
      *
      * @since 1.32.0
+     * @deprecated (since 1.120.0)
      *
      * @returns A boolean value indicating whether the user has specified to track activities
      */
@@ -10204,8 +10570,16 @@ declare module "sap/ushell/services/UserInfo" {
   /**
    * The Unified Shell's user information service. Allows retrieving information about the logged-in user.
    *
-   * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("UserInfo")`.
-   * For details, see {@link sap.ushell.Container#getServiceAsync}.
+   * **Note:** To retrieve a valid instance of this service, it is necessary to call {@link sap.ushell.Container#getServiceAsync}.
+   *
+   * ```javascript
+   *
+   *   sap.ui.require(["sap/ushell/Container"], async function (Container) {
+   *     const UserInfo = await Container.getServiceAsync("UserInfo");
+   *     // do something with the UserInfo service
+   *   });
+   * ```
+   *
    *
    * @since 1.16.3
    */
@@ -12572,6 +12946,42 @@ declare module "sap/ushell/ui/launchpad/TileState" {
   >;
 }
 
+declare module "sap/ushell/ui/shell/ShellHeadItem" {
+  import { URI, aria } from "sap/ui/core/library";
+
+  export type Properties = {
+    /**
+     * The icon of the item, either defined in the sap.ui.core.IconPool or an URI to a custom image.
+     */
+    icon: URI;
+    /**
+     * The text of the item. It is either visible as tooltip or as label when the item is rendered as part of
+     * an overflow button in a popover.
+     */
+    text?: string;
+    /**
+     * Target URI of the item.
+     */
+    target?: URI;
+    /**
+     * The aria-label attribute of the item.
+     */
+    ariaLabel?: string;
+    /**
+     * Specifies whether the aria-hidden attribute is set to true.
+     */
+    ariaHidden?: boolean;
+    /**
+     * Specifies the value of the aria-haspopup attribute
+     */
+    ariaHaspopup?: aria.HasPopup | keyof typeof aria.HasPopup;
+    /**
+     * The press handler function.
+     */
+    press?: Function;
+  };
+}
+
 declare module "sap/ushell/ui/shell/ToolAreaItem" {
   import { default as Control, $ControlSettings } from "sap/ui/core/Control";
 
@@ -13056,7 +13466,8 @@ declare module "sap/ushell/ui/tile/StaticTile" {
    * @deprecated (since 1.120)
    */
   export default class StaticTile
-    /* was: sap.ushell.ui.tile.TileBase */ extends Object {
+    extends /* was: sap.ushell.ui.tile.TileBase */ Object
+  {
     /**
      * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
      * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
@@ -13155,7 +13566,8 @@ declare module "sap/ushell/ui5service/UserStatus" {
    * @deprecated (since 1.70) - Support for this service has been discontinued.
    */
   export default class UserStatus
-    /* was: sap.ui.core.service.Service */ extends Object {
+    extends /* was: sap.ui.core.service.Service */ Object
+  {
     constructor();
 
     /**
@@ -13324,6 +13736,32 @@ declare namespace sap {
      * @since 1.15.0
      */
     namespace services {
+      namespace PersonalizationV2 {
+        /**
+         * @since 1.124.0
+         */
+        enum KeyCategory {
+          /**
+           * A static hard-coded key which does not change. This value is required for caching to take place.
+           */
+          FIXED_KEY = "FIXED_KEY",
+          /**
+           * For all other cases.
+           */
+          GENERATED_KEY = "GENERATED_KEY",
+        }
+        /**
+         * @since 1.124.0
+         */
+        enum WriteFrequency {
+          HIGH = "HIGH",
+          /**
+           * The key is typically rarely updated, for example in explicit table personalization by end users.
+           */
+          LOW = "LOW",
+        }
+      }
+
       /**
        * Abstract base class for ushell services. For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
@@ -13413,7 +13851,8 @@ declare namespace sap {
        * @since 1.38.0
        */
       class ShellUIService
-        /* was: sap.ui.core.service.Service */ extends Object {
+        extends /* was: sap.ui.core.service.Service */ Object
+      {
         /**
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          */
@@ -13504,6 +13943,8 @@ declare namespace sap {
   }
 
   interface IUI5DefineDependencyNames {
+    "sap/ushell/api/NewExperience": undefined;
+
     "sap/ushell/api/RTA": undefined;
 
     "sap/ushell/api/workpage/Designtime": undefined;
@@ -13558,15 +13999,19 @@ declare namespace sap {
 
     "sap/ushell/services/Extension": undefined;
 
-    "sap/ushell/services/Extension/FloatingContainer": undefined;
+    "sap/ushell/services/Extension/Item": undefined;
 
-    "sap/ushell/services/Extension/Footer": undefined;
+    "sap/ushell/services/FrameBoundExtension": undefined;
 
-    "sap/ushell/services/Extension/Item": undefined;
+    "sap/ushell/services/FrameBoundExtension/FloatingContainer": undefined;
+
+    "sap/ushell/services/FrameBoundExtension/Footer": undefined;
+
+    "sap/ushell/services/FrameBoundExtension/Item": undefined;
 
-    "sap/ushell/services/Extension/SidePane": undefined;
+    "sap/ushell/services/FrameBoundExtension/SidePane": undefined;
 
-    "sap/ushell/services/Extension/ToolArea": undefined;
+    "sap/ushell/services/FrameBoundExtension/ToolArea": undefined;
 
     "sap/ushell/services/LaunchPage": undefined;
 
@@ -13588,6 +14033,8 @@ declare namespace sap {
 
     "sap/ushell/services/PersonalizationV2": undefined;
 
+    "sap/ushell/services/PersonalizationV2/constants": undefined;
+
     "sap/ushell/services/PersonalizationV2/ContextContainer": undefined;
 
     "sap/ushell/services/PersonalizationV2/Personalizer": undefined;
@@ -13604,6 +14051,8 @@ declare namespace sap {
 
     "sap/ushell/services/ShellNavigation": undefined;
 
+    "sap/ushell/services/ShellNavigationInternal": undefined;
+
     "sap/ushell/services/SmartNavigation": undefined;
 
     "sap/ushell/services/SpaceContent": undefined;
@@ -13636,6 +14085,8 @@ declare namespace sap {
 
     "sap/ushell/ui/launchpad/VizInstanceBase": undefined;
 
+    "sap/ushell/ui/shell/ShellHeadItem": undefined;
+
     "sap/ushell/ui/shell/ToolAreaItem": undefined;
 
     "sap/ushell/ui/tile/StaticTile": undefined;