@sapui5/ts-types 1.122.2 → 1.123.0

package/types/sap.ushell.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.122.2
+// For Library Version: 1.123.0
 
 declare namespace sap {
   /**
@@ -73,6 +73,230 @@ declare namespace sap {
      * @since 1.15.0
      */
     namespace services {
+      namespace AppConfiguration {
+        /**
+         * Type for the metadata object for AppConfiguration
+         *
+         * @since 1.120.0
+         */
+        type Metadata = {
+          /**
+           * The title of the application
+           */
+          title: string;
+          /**
+           * The library of the application
+           */
+          library: string;
+          /**
+           * The version of the application
+           */
+          version: string;
+          /**
+           * A Boolean value indicating if the application fills the full width of the screen
+           */
+          fullWidth: boolean;
+        };
+      }
+
+      namespace AppLifeCycle {
+        /**
+         * Enumeration of application info parameter names.
+         *
+         * This enum is part of the 'sap/ushell/services/AppLifeCycle' module export and must be accessed by the
+         * property 'AppInfoParameterName'.
+         *
+         * @since 1.120.0
+         */
+        enum AppInfoParameterName {
+          /**
+           * ID of the framework
+           */
+          appFrameworkId = "appFrameworkId",
+          /**
+           * Version of the framework
+           */
+          appFrameworkVersion = "appFrameworkVersion",
+          /**
+           * Universal stable logical identifier of the application across the whole content.
+           */
+          appId = "appId",
+          /**
+           * Intent that was used to launch the application (including parameters)
+           */
+          appIntent = "appIntent",
+          /**
+           * The name of an organizational component that handles support incidents.
+           */
+          appSupportInfo = "appSupportInfo",
+          /**
+           * Version of the app
+           */
+          appVersion = "appVersion",
+          /**
+           * Current Language (BCP47 format)
+           */
+          languageTag = "languageTag",
+          /**
+           * A human readable free form text maintained on the platform where FLP runs, and identifying the current
+           * product.
+           */
+          productName = "productName",
+          /**
+           * Identifier of the component that implements the base application.
+           */
+          technicalAppComponentId = "technicalAppComponentId",
+          /**
+           * Current FLP theme. Includes the path to the theme resources if the theme is not an sap theme (does not
+           * start with sap_)
+           */
+          theme = "theme",
+        }
+        /**
+         * Enumeration of application types.
+         *
+         * This enum is part of the 'sap/ushell/services/AppLifeCycle' module export and must be accessed by the
+         * property 'ApplicationType'.
+         *
+         * @since 1.120.0
+         */
+        enum ApplicationType {
+          /**
+           * The application is starting using the SAP Business Client.
+           */
+          NWBC = "NWBC",
+          /**
+           * The application is started using a transaction
+           */
+          TR = "TR",
+          /**
+           * The application is a UI5 application.
+           */
+          UI5 = "UI5",
+          /**
+           * The application is started using a URL
+           */
+          URL = "URL",
+          /**
+           * The application is a Webdynpro application.
+           */
+          WDA = "WDA",
+        }
+        /**
+         * Defines the application info.
+         *
+         * @since 1.120.0
+         */
+        type AppInfo = {
+          /**
+           * A human readable free form text maintained on the platform where FLP runs, and identifying the current
+           * product.
+           */
+          productName: string;
+          /**
+           * Current FLP theme. Includes the path to the theme resources if the theme is not an sap theme (does not
+           * start with sap_)
+           */
+          theme: string;
+          /**
+           * Current Language (BCP47 format)
+           */
+          languageTag: string;
+          /**
+           * Intent that was used to launch the application (including parameters)
+           */
+          appIntent: string;
+          /**
+           * ID of the framework
+           */
+          appFrameworkId: string;
+          /**
+           * Identifier of the component that implements the base application.
+           */
+          technicalAppComponentId: string;
+          /**
+           * Universal stable logical identifier of the application across the whole content.
+           */
+          appId: string;
+          /**
+           * Version of the app
+           */
+          appVersion: string;
+          /**
+           * The name of an organizational component that handles support incidents.
+           */
+          appSupportInfo: string;
+          /**
+           * Version of the framework
+           */
+          appFrameworkVersion: string;
+        };
+
+        /**
+         * Defines the current application.
+         *
+         * @since 1.120.0
+         */
+        type CurrentApplication = {
+          /**
+           * The type of the current application.
+           */
+          applicationType: sap.ushell.services.AppLifeCycle.ApplicationType;
+          /**
+           * reference to component (only for applicationType "UI5")
+           */
+          componentInstance?: sap.ui.core.Component;
+          /**
+           * `true` when root intent (normally #Shell-home) or Appfinder (#Shell-appfinder) is currently displayed.
+           */
+          homePage: boolean;
+          /**
+           * function that returns the value of a technical parameter for the given application. This method is for
+           * SAP internal usage only.
+           */
+          getTechnicalParameter: Function;
+          /**
+           * See {@link sap.ushell.services.URLParsing#parseShellHash} for details. This property is for SAP-internal
+           * use only!
+           */
+          getIntent: () => Promise<sap.ushell.services.AppLifeCycle.Intent>;
+          /**
+           * provides the values of the given parameters.
+           */
+          getInfo: (
+            p1: sap.ushell.services.AppLifeCycle.AppInfoParameterName[]
+          ) => Promise<sap.ushell.services.AppLifeCycle.AppInfo>;
+        };
+
+        /**
+         * Defines an intent. See {@link sap.ushell.services.URLParsing#parseShellHash} for details.
+         *
+         * @since 1.120.0
+         */
+        type Intent = {
+          /**
+           * The semantic object of the intent.
+           */
+          semanticObject: string;
+          /**
+           * The action of the intent.
+           */
+          action: string;
+          /**
+           * The raw context of the intent.
+           */
+          contextRaw: string;
+          /**
+           * The parameters of the intent.
+           */
+          params: Record<string, string[]>;
+          /**
+           * The app specific route of the intent.
+           */
+          appSpecificRoute: string;
+        };
+      }
+
       namespace Bookmark {
         /**
          * A content node may be: - a classic home page group - an unselectable node (space) or a selectable node
@@ -103,8 +327,113 @@ declare namespace sap {
       }
 
       namespace BookmarkV2 {
+        /**
+         * Type for data source object. Metadata for parameter serviceUrl. Mandatory to specify if parameter serviceURL
+         * contains semantic date ranges. This does not influence the data source of the app itself.
+         *
+         * Specify the data source as follows:
+         * ```javascript
+         *
+         *   {
+         *       type: "OData",
+         *       settings: {
+         *           odataVersion: "4.0"
+         *       }
+         *   }
+         *   ```
+         *
+         *
+         *
+         * 	type: The type of the serviceURL's service. Only "OData" is supported. odataVersion: The OData version
+         * of parameter serviceURL. Valid values are "2.0" and "4.0".
+         *
+         * @since 1.121.0
+         */
+        type BookmarkParameters = {
+          /**
+           * The type of the serviceURL's service. Only "OData" is supported.
+           */
+          type: string;
+          /**
+           * The settings for the data source.
+           */
+          settings: {
+            x: any;
+          };
+          /**
+           * The title of the bookmark.
+           */
+          title: string;
+          /**
+           * The URL of the bookmark. The target intent or URL of the bookmark. If the target app runs in the current
+           * shell, the URL has to be a valid intent, i.e. in the format `"#SO-Action?P1=a&P2=x&/route?RPV=1"`.
+           */
+          url: /* was: sap.ushell.services.navigation.TargetIntent */
+            | any
+            | sap.ui.core.URI;
+          /**
+           * The optional icon URL of the bookmark (e.g. `"sap-icon://home"`).
+           */
+          icon?: string;
+          /**
+           * The optional information text of the bookmark.
+           */
+          info?: string;
+          /**
+           * The optional subtitle of the bookmark.
+           */
+          subtitle?: string;
+          /**
+           * The URL to a REST or OData service that provides some dynamic information for the bookmark. The URL to
+           * a REST or OData service that provides some dynamic information for the bookmark.
+           *
+           * **Semantic Date Ranges:**
+           *
+           * You can use placeholders for dynamic dates in the query parameters of the service URL. This can be used
+           * to create KPI tiles based on user entries in control {@link sap.m.DynamicDateRange}, where it is possible
+           * to specify dynamic dates like YESTERDAY or THISYEAR.
+           *
+           * The placeholder format looks like this: {Edm.<type>%%DynamicDate.<operator>.<value1>.<value2>.<position>%%}
+           *
+           *
+           * 	 - <type>: The Edm Type of the parameter. Supported types are String, DateTime and DateTimeOffset
+           *     for OData V2 and Date and DateTimeOffset for OData V4.
+           * 	 - <operator>, <value1>, <value2>: Possible values are the ones that can be used in
+           *     {@link sap.m.DynamicDateRange#toDates} to create a date range.
+           * 	 - <position>: Possible values are 'start' and 'end' which mark the start or end of the interval
+           *     specified by the operator.
+           *
+           * Examples:
+           * 	 - /a/url/$count?$filter=(testDate ge {Edm.DateTimeOffset%DynamicDate.YESTERDAY.start%} and testDate
+           *     le {Edm.DateTimeOffset%DynamicDate.YESTERDAY.end%})
+           * 	 - /a/url/$count?$filter=(testDate ge {Edm.DateTime%DynamicDate.THISYEAR.start%} and testDate le {Edm.DateTime%DynamicDate.THISYEAR.end%})
+           *
+           * 	 - /a/url/$count?$filter=(testDate ge {Edm.Date%DynamicDate.TODAYFROMTO.1.5.start%} and testDate le
+           *     {Edm.Date%DynamicDate.TODAYFROMTO.1.5.end%})
+           *
+           * Hint: Check the debug log when displaying the resulting KPI tiles to get more information about the resolution
+           * of the placeholders.
+           */
+          serviceUrl?: sap.ui.core.URI;
+          /**
+           * Metadata for parameter serviceUrl. Mandatory to specify if parameter serviceURL contains semantic date
+           * ranges.
+           */
+          dataSource?: /* was: sap.ushell.services.BookmarkV2.DataSource */ any;
+          /**
+           * The refresh interval for the `serviceUrl` in seconds.
+           */
+          serviceRefreshInterval?: string;
+          /**
+           * The unit for the number retrieved from `serviceUrl`.
+           */
+          numberUnit?: string;
+        };
+
         /**
          * A tree of content nodes.
+         *
+         * @since 1.121.0
          */
         type ContentNode = {
           /**
@@ -116,7 +445,7 @@ declare namespace sap {
            */
           label: string;
           /**
-           * Specifies the content node type. E.g: space, page, etc. See {@link sap.ushell.sap.ushell.services.BookmarkV2.ContentNodeType}
+           * Specifies the content node type. E.g: space, page, etc.
            */
           type: sap.ushell.ContentNodeType;
           /**
@@ -536,6 +865,269 @@ declare namespace sap {
            */
           processParams?: boolean;
         };
+
+        /**
+         * The target intent.
+         *
+         * Navigation is encoded in the fragment identifier of the URL within FLPthe URL has to be a valid intent,
+         * i.e. in the format `"#SO-Action?P1=a&P2=x&/route?RPV=1"`. The generic syntax consists of the semantic
+         * object, the action and an optional part:
+         * ```javascript
+         * Intent = "#" semanticObject "-" action ["?" intentParameters "&/" innerAppRoute + "?" + innerAppRouteParameters]```
+         *  The intent compries of the fthe following parts:
+         * 	semanticObject: Semantic object as defined in an app launcher tile. The following characters are allowed:
+         * uppercase letters [A-Z], lowercase letters [a-z], numbers [0-9]. The first character must be an uppercase
+         * or lowercase letter. The length of the semantic object is limited to 30 characters.
+         *
+         *
+         * 	 - action: Action as defined in an app launcher tile. For the action name, choose a verb or a short
+         *     phrase starting with lower case and without blanks. Examples are display, create, or release. The following
+         *     characters are allowed: uppercase letters [A-Z], lowercase letters [a-z], numbers [0-9] and underscores
+         *     [_]. The first character must be an uppercase or lowercase letter or an underscore. The length of the
+         *     action is limited to 50 characters.
+         * 	 - intentParameters: Intent parameters are optional parameters. The parameters are separated by the
+         *     ampersand character (&). The parameter name and value are separated by the equal sign (=). The parameter
+         *     value must be URL-encoded. When navigating via Intent Based Navigation (IBN) the intent parameters are
+         *     used to determine the target application.
+         * 	 - innerAppRoute: The inner app route is an optional parameter that is used to navigate within the target
+         *     application. The inner app route is separated from the intent parameters by the "&/".
+         * 	 - innerAppRouteParameters: The inner app route parameters are optional parameters that are passed to
+         *     the target application. The parameters are separated by the ampersand character (&). The parameter name
+         *     and value are separated by the equal sign (=). The parameter value must be URL-encoded.
+         *
+         * @since 1.121.0
+         */
+        type TargetIntent = string;
+      }
+
+      namespace NotificationsV2 {
+        /**
+         * Enumaration 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'.
+         *
+         * @since 1.120.0
+         */
+        enum Nature {
+          /**
+           * The Negative nature.
+           */
+          NEGATIVE = "NEGATIVE",
+          /**
+           * The Neutral nature.
+           */
+          NEUTRAL = "NEUTRAL",
+          /**
+           * The Positive nature.
+           */
+          POSITIVE = "POSITIVE",
+        }
+        /**
+         * Enumeration for the priority of a notification
+         *
+         * This enum is part of the 'sap/ushell/services/NotificationsV2' module export and must be accessed by
+         * the property 'Priority'.
+         *
+         * @since 1.120.0
+         */
+        enum Priority {
+          /**
+           * High priority.
+           */
+          HIGH = "HIGH",
+          /**
+           * Low priority.
+           */
+          LOW = "LOW",
+          /**
+           * Medium priority.
+           */
+          MEDIUM = "MEDIUM",
+        }
+        /**
+         * Type for Action
+         *
+         * @since 1.120.0
+         */
+        type Action = {
+          /**
+           * The ID of the action
+           */
+          ActionId: string;
+          /**
+           * The text of the action
+           */
+          ActionText: string;
+          /**
+           * The group action text
+           */
+          GroupActionText: string;
+          /**
+           * The nature of the action
+           */
+          Nature: sap.ushell.services.NotificationsV2.Nature;
+        };
+
+        /**
+         * Type for Actor
+         *
+         * @since 1.120.0
+         */
+        type Actor = {
+          /**
+           * The ID of the actor
+           */
+          Id: string;
+          /**
+           * The display text of the actor
+           */
+          DisplayText: string;
+          /**
+           * The image source of the actor
+           */
+          ImageSource: string;
+        };
+
+        /**
+         * Type for executeBulkAction
+         *
+         * @since 1.120.0
+         */
+        type BulkAction = {
+          /**
+           * Indicates whether the notification should be deleted after the action is executed
+           */
+          DeleteOnReturn: boolean;
+          /**
+           * Indicates whether the action was executed successfully
+           */
+          Success: boolean;
+          /**
+           * The ID of the notification
+           */
+          NotificationId: string;
+        };
+
+        /**
+         * Type for the notification item
+         *
+         * @since 1.120.0
+         */
+        type NotificationItem = {
+          /**
+           * The ID of the notification.
+           */
+          Id: string;
+          /**
+           * The ID of the origin, can be a combination of system and client or the value `LOCAL`.
+           */
+          OriginId: string;
+          /**
+           * The date and time the notification was created.
+           */
+          CreatedAt: string;
+          /**
+           * Indicates whether the notification is actionable.
+           */
+          IsActionable: boolean;
+          /**
+           * Indicates whether the notification has been read.
+           */
+          IsRead: boolean;
+          /**
+           * Indicates whether the notification can be grouped.
+           */
+          IsGroupable: boolean;
+          /**
+           * Indicates whether the notification is a group header.
+           */
+          IsGroupHeader: boolean;
+          /**
+           * The action to be executed when the notification is clicked.
+           */
+          NavigationTargetAction: string;
+          /**
+           * The object to be navigated to when the notification is clicked.
+           */
+          NavigationTargetObject: string;
+          /**
+           * The intent for navigation when the notification is clicked.
+           */
+          NavigationIntent: string;
+          /**
+           * The ID for the notification type specified in `NotificationTypeKey`.
+           */
+          NotificationTypeId: string;
+          /**
+           * The key of the notification type.
+           */
+          NotificationTypeKey: string;
+          /**
+           * The ID of the parent notification.
+           */
+          ParentId: string;
+          /**
+           * The priority of the notification.
+           */
+          Priority: sap.ushell.services.NotificationsV2.Priority;
+          /**
+           * The sensitive text of the notification.
+           */
+          SensitiveText: string;
+          /**
+           * The text of the notification.
+           */
+          Text: string;
+          /**
+           * The header text of the notification group.
+           */
+          GroupHeaderText: string;
+          /**
+           * The number of notifications.
+           */
+          NotificationCount: number;
+          /**
+           * The subtitle of the notification.
+           */
+          SubTitle: string;
+          /**
+           * The description of the notification type.
+           */
+          NotificationTypeDesc: string;
+          /**
+           * The actor of the notification.
+           */
+          Actor: sap.ushell.services.NotificationsV2.Actor;
+          /**
+           * The navigation target parameters of the notification.
+           */
+          NavigationTargetParams: sap.ushell.services.NotificationsV2.NotificationTargetParameter[];
+          /**
+           * The actions of the notification.
+           */
+          Actions: sap.ushell.services.NotificationsV2.Action[];
+        };
+
+        /**
+         * Type for notification target parameters.
+         *
+         * @since 1.120.0
+         */
+        type NotificationTargetParameter = {
+          /**
+           * The ID of the notification.
+           */
+          NotificationId: string;
+          /**
+           * The key of the notification target parameter.
+           */
+          Key: string;
+          /**
+           * The value of the notification target parameter.
+           */
+          Value: string;
+        };
       }
 
       namespace Personalization {
@@ -1372,7 +1964,7 @@ declare namespace sap {
            *
            * @returns Resolves with undefined on success or rejects on failure
            */
-          load(): Promise<undefined>;
+          load(): Promise<any>;
           /**
            * Save the current container data at the underlying storage asynchronously at the earlies nDelayInMilliseconds
            * seconds before. The current state is serialized.
@@ -1727,7 +2319,7 @@ declare namespace sap {
             /**
              * Context
              */
-            oContextContainer: object
+            oContextContainer: sap.ushell.services.PersonalizationV2.ContextContainer
           );
 
           /**
@@ -1834,6 +2426,148 @@ declare namespace sap {
           shared?: boolean;
         };
       }
+
+      namespace SpaceContent {
+        /**
+         * Type for the value of a UserDefault parameter. It contains either a value, an extendedValue, or both.
+         *
+         * Example:
+         * ```javascript
+         *
+         *      {
+         *          "value": "ZMAT1",
+         *          "extendedValue": {
+         *              "Ranges": [
+         *                  {
+         *                      "Sign": "I",
+         *                      "Option": "BT",
+         *                      "Low": "A*",
+         *                      "High": "F*"
+         *                  }
+         *              ]
+         *          }
+         *      }
+         * ```
+         *
+         *
+         * @since 1.120.0
+         */
+        type ParameterValue = {
+          /**
+           * The value of a single-parameter.
+           */
+          value?: string;
+          /**
+           * Object containing the ranges for a range-parameter.
+           */
+          extendedValue?: {
+            Ranges: sap.ushell.services.SpaceContent.Range[];
+          };
+        };
+
+        /**
+         * Type for describing a parameter value range.
+         *
+         * @since 1.120.0
+         */
+        type Range = {
+          /**
+           * The sign value of the range.
+           */
+          Sign: string;
+          /**
+           * The option value of the range.
+           */
+          Option: string;
+          /**
+           * The low value of the range.
+           */
+          Low: string;
+          /**
+           * The high value of the range.
+           */
+          High: string;
+        };
+      }
+
+      namespace URLParsing {
+        /**
+         * Type for decomposedHash
+         *
+         * @since 1.120.0
+         */
+        type decomposedHash = {
+          /**
+           * the semantic object
+           */
+          semanticObject: string;
+          /**
+           * the action
+           */
+          action: string;
+          /**
+           * the raw context string
+           */
+          contextRaw: string;
+          /**
+           * the parameters
+           */
+          params: Record<string, string[]>;
+        };
+
+        /**
+         * Type for splitHash
+         *
+         * @since 1.120.0
+         */
+        type splitHash = {
+          /**
+           * the shell part of the hash
+           */
+          shellPart: sap.ui.core.URI;
+          /**
+           * the app specific route part of the hash
+           */
+          appSpecificRoute: sap.ui.core.URI;
+        };
+
+        /**
+         * Type for Url value
+         *
+         * @since 1.120.0
+         */
+        type URLValue = string | int;
+      }
+
+      namespace UserInfo {
+        /**
+         * Type for an object representing data about the user: ID, first name, last name, full name, e-mail address.
+         *
+         * @since 1.120.0
+         */
+        type ShellUserInfo = {
+          /**
+           * The user id.
+           */
+          id: string;
+          /**
+           * The user's email address.
+           */
+          email: string;
+          /**
+           * The user's first name.
+           */
+          firstName: string;
+          /**
+           * The user's last name.
+           */
+          lastName: string;
+          /**
+           * The user's full name.
+           */
+          fullName: string;
+        };
+      }
       /**
        * The unified shell's AppConfiguration service as a singleton object.
        *
@@ -1928,15 +2662,18 @@ declare namespace sap {
          *
          * @since 1.38
          */
-        attachAppLoaded(
+        attachAppLoaded<ObjectToBePassedToHandler extends object>(
           /**
            * An object that will be passed to the handler along with the event object when the event is fired.
            */
-          oData: object,
+          oData: ObjectToBePassedToHandler,
           /**
            * The handler function to call when the event occurs.
            */
-          fnFunction: Function,
+          fnFunction: (
+            p1: sap.ui.base.Event,
+            p2: ObjectToBePassedToHandler
+          ) => void,
           /**
            * The object that wants to be notified when the event occurs (this context within the handler function).
            */
@@ -1958,43 +2695,18 @@ declare namespace sap {
           oListener: object
         ): void;
         /**
-         * Returns information about the currently running application.
-         *
-         * The function returns an object with following parameters:
-         * 	 -  applicationType: “UI5|WDA|NWBC|URL|TR”
-         * 	 -  componentInstance: reference to component (only for applicationType "UI5").
-         * 	 -  homePage: `true` when root intent (normally #Shell-home) or Appfinder (#Shell-appfinder) is currently
-         *     displayed.
-         * 	 -  getTechnicalParameter: `function` that returns the value of a technical parameter for the given
-         *     application. This method is for SAP internal usage only.
-         * 	 -  getIntent: `function` that returns a `Promise` that resolves with the current shell hash as an `Object`.
-         *     See {@link sap.ushell.services.URLParsing#parseShellHash} for details. This property is for SAP-internal
-         *     use only!
-         * 	 -  getInfo: `function` that is called with an `Array` with following optional elements of type `String`
-         *
-         * 	 ` productName ` A human readable free form text maintained on the platform where FLP runs, and identifying
-         * the current product.
-         * 	 -  ` theme ` Current FLP theme. Includes the path to the theme resources if the theme is not an sap
-         *     theme (does not start with sap_)
-         * 	 -  ` languageTag ` Current Language (BCP47 format)
-         * 	 -  ` appIntent ` Intent that was used to launch the application (including parameters)
-         * 	 -  ` appFrameworkId `ID of the framework
-         * 	 -  ` technicalAppComponentId ` Identifier of the component that implements the base application.
-         * 	 -  ` appId ` Universal stable logical identifier of the application across the whole content.
-         * 	 -  ` appVersion ` Version of the app
-         * 	 -  ` appSupportInfo ` The name of an organizational component that handles support incidents.
-         * 	 -  ` appFrameworkVersion ` Version of the framework   The `function` returns a `Promise` that
-         *     resolves with an `Object` with properties corresponding to the elements of the `Array` passed as input.
-         *     Each of these properties holds its value or undefined if not configured.
-         *
-         * **Note:** Return value is only valid after app is loaded. See {@link #attachAppLoaded} for details. Before
-         * an app is loaded, `undefined` is returned.
+         * Returns information about the currently running application Information object about currently running
+         * application or `undefined` if no application is running.
          *
          * @since 1.38
          *
          * @returns Information object about currently running application or `undefined` if no application is running.
+         * **Note:** Return value is only valid after app is loaded. See {@link #attachAppLoaded} for details. Before
+         * an app is loaded, `undefined` is returned.
          */
-        getCurrentApplication(): object | undefined;
+        getCurrentApplication():
+          | sap.ushell.services.AppLifeCycle.CurrentApplication
+          | undefined;
       }
       /**
        * The Unified Shell's bookmark service. Allows creating shortcuts on the user's home page.
@@ -2319,110 +3031,27 @@ declare namespace sap {
        * @since 1.119.0
        */
       class BookmarkV2 extends sap.ushell.services.Service {
-        /**
-         * @ui5-protected Do not call from applications (only from related classes in the framework)
-         */
-        protected constructor();
-
-        /**
-         * Adds a bookmark tile to the provided content nodes.
-         * See:
-         * 	sap.ushell.services.URLParsing#getShellHash
-         *
-         * @since 1.119.0
-         *
-         * @returns A `Promise` which resolves on success, but rejects with a reason-message on failure to add the
-         * bookmark to the specified or implied content node. The promise gets resolved if personalization is disabled.
-         */
-        addBookmark(
-          /**
-           * Bookmark parameters. In addition to title and URL, a bookmark might allow further settings, such as an
-           * icon or a subtitle. Which settings are supported depends on the environment in which the application
-           * is running. Unsupported parameters will be ignored.
-           */
-          oParameters: {
-            /**
-             * The title of the bookmark.
-             */
-            title: string;
-            /**
-             * The target intent or URL of the bookmark. If the target app runs in the current shell, the URL has to
-             * be a valid intent, i.e. in the format `"#SO-Action?P1=a&P2=x&/route?RPV=1"`.
-             */
-            url: string;
-            /**
-             * The optional icon URL of the bookmark (e.g. `"sap-icon://home"`).
-             */
-            icon?: string;
-            /**
-             * The information text of the bookmark.
-             */
-            info?: string;
-            /**
-             * The subtitle of the bookmark.
-             */
-            subtitle?: string;
-            /**
-             * The URL to a REST or OData service that provides some dynamic information for the bookmark.
-             *
-             * **Semantic Date Ranges:**
-             *
-             * You can use placeholders for dynamic dates in the query parameters of the service URL. This can be used
-             * to create KPI tiles based on user entries in control {@link sap.m.DynamicDateRange}, where it is possible
-             * to specify dynamic dates like YESTERDAY or THISYEAR.
-             *
-             * The placeholder format looks like this: {Edm.<type>%%DynamicDate.<operator>.<value1>.<value2>.<position>%%}
-             *
-             *
-             * 	 - <type>: The Edm Type of the parameter. Supported types are String, DateTime and DateTimeOffset
-             *     for OData V2 and Date and DateTimeOffset for OData V4.
-             * 	 - <operator>, <value1>, <value2>: Possible values are the ones that can be used in
-             *     {@link sap.m.DynamicDateRange#toDates} to create a date range.
-             * 	 - <position>: Possible values are 'start' and 'end' which mark the start or end of the interval
-             *     specified by the operator.
-             *
-             * Examples:
-             * 	 - /a/url/$count?$filter=(testDate ge {Edm.DateTimeOffset%DynamicDate.YESTERDAY.start%} and testDate
-             *     le {Edm.DateTimeOffset%DynamicDate.YESTERDAY.end%})
-             * 	 - /a/url/$count?$filter=(testDate ge {Edm.DateTime%DynamicDate.THISYEAR.start%} and testDate le {Edm.DateTime%DynamicDate.THISYEAR.end%})
-             *
-             * 	 - /a/url/$count?$filter=(testDate ge {Edm.Date%DynamicDate.TODAYFROMTO.1.5.start%} and testDate le
-             *     {Edm.Date%DynamicDate.TODAYFROMTO.1.5.end%})
-             *
-             * Hint: Check the debug log when displaying the resulting KPI tiles to get more information about the resolution
-             * of the placeholders.
-             */
-            serviceUrl?: string;
-            /**
-             * Metadata for parameter serviceUrl. Mandatory to specify if parameter serviceURL contains semantic date
-             * ranges. This does not influence the data source of the app itself.
-             *
-             * Specify the data source as follows:
-             * ```javascript
-             *
-             *   {
-             *       type: "OData",
-             *       settings: {
-             *           odataVersion: "4.0"
-             *       }
-             *   }
-             *   ```
-             *
-             *
-             *
-             * 	type: The type of the serviceURL's service. Only "OData" is supported. odataVersion: The OData version
-             * of parameter serviceURL. Valid values are "2.0" and "4.0".
-             */
-            dataSource?: object;
-            /**
-             * The refresh interval for the `serviceUrl` in seconds.
-             */
-            serviceRefreshInterval?: string;
-            /**
-             * The unit for the number retrieved from `serviceUrl`.
-             */
-            numberUnit?: string;
-          },
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
+
+        /**
+         * Adds a bookmark tile to the provided content nodes.
+         * See:
+         * 	sap.ushell.services.URLParsing#getShellHash
+         *
+         * @since 1.119.0
+         *
+         * @returns A promise which resolves on success
+         */
+        addBookmark(
+          /**
+           * Bookmark parameters. In addition to title and URL, a bookmark might allow further settings, such as an
+           * icon or a subtitle. Which settings are supported depends on the environment in which the application
+           * is running. Unsupported parameters will be ignored.
+           */
+          oParameters: sap.ushell.services.BookmarkV2.BookmarkParameters,
           /**
            * Either a content node or an array of content nodes (see {@link #getContentNodes}). If not provided, the
            * bookmark will be added to the default page.
@@ -2452,12 +3081,15 @@ declare namespace sap {
           /**
            * The URL of the bookmarks to be counted, exactly as specified to {@link #addBookmark}.
            */
-          sUrl: string,
+          sUrl: /* was: sap.ushell.services.navigation.TargetIntent */
+            | any
+            | sap.ui.core.URI,
           /**
-           * The Content Provider ID.
+           * **SAP internal usage only** The contentProviderId or undefined outside the cFLP. The Content Provider
+           * ID.
            */
-          sContentProviderId: string
-        ): Promise<any>;
+          sContentProviderId?: string
+        ): Promise<int>;
         /**
          * Deletes **all** bookmarks pointing to the given URL from all of the user's pages.
          * See:
@@ -2474,12 +3106,14 @@ declare namespace sap {
           /**
            * The URL of the bookmarks to be deleted, exactly as specified to {@link #addBookmark}.
            */
-          sUrl: string,
+          sUrl: /* was: sap.ushell.services.navigation.TargetIntent */
+            | any
+            | sap.ui.core.URI,
           /**
-           * The contentProviderId or undefined outside the cFLP
+           * **SAP internal usage only** The contentProviderId or undefined outside the cFLP.
            */
           sContentProviderId?: string
-        ): Promise<any>;
+        ): Promise<int>;
         /**
          * Returns available content nodes.
          *
@@ -2515,65 +3149,12 @@ declare namespace sap {
            * an icon or a subtitle. Which settings are supported depends on the environment in which the application
            * is running. Unsupported parameters will be ignored.
            */
-          oParameters: {
-            /**
-             * The title of the bookmark.
-             */
-            title: string;
-            /**
-             * The target URL or intent of the bookmark. If the target application shall run in the current shell, the
-             * URL has to be a valid intent, i.e. in the format like `"#SO-Action?P1=a&P2=x&/route?RPV=1"`.
-             */
-            url: string;
-            /**
-             * The optional icon URL of the bookmark (e.g. `"sap-icon://home"`).
-             */
-            icon?: string;
-            /**
-             * The information text of the bookmark.
-             */
-            info?: string;
-            /**
-             * The subtitle of the bookmark.
-             */
-            subtitle?: string;
-            /**
-             * The URL to a REST or OData service that provides some dynamic information for the bookmark.
-             */
-            serviceUrl?: string;
-            /**
-             * Metadata for parameter serviceUrl. Mandatory to specify if parameter serviceURL contains semantic date
-             * ranges. This does not influence the data source of the app itself.
-             */
-            dataSource?: {
-              /**
-               * The type of the serviceURL's service. Only "OData" is supported.
-               */
-              type?: string;
-              /**
-               * Additional settings for the data source.
-               */
-              settings?: {
-                /**
-                 * The OData version of parameter serviceURL. Valid values are "2.0" and "4.0".
-                 */
-                odataVersion?: object;
-              };
-            };
-            /**
-             * The refresh interval for the `serviceUrl` in seconds.
-             */
-            serviceRefreshInterval?: string;
-            /**
-             * The unit for the number retrieved from `serviceUrl`.
-             */
-            numberUnit?: string;
-          },
+          oParameters: sap.ushell.services.BookmarkV2.BookmarkParameters,
           /**
-           * The contentProviderId or undefined outside the cFLP
+           * **SAP internal usage only** The contentProviderId or undefined outside the cFLP.
            */
           sContentProviderId?: string
-        ): Promise<any>;
+        ): Promise<int>;
       }
       /**
        * The unified shell's Configuration service. Allows attaching to **selected** launchpad configuration settings
@@ -5537,7 +6118,7 @@ declare namespace sap {
            * The ID of the notification whose action is being executed
            */
           sNotificationId: string
-        ): Promise<undefined>;
+        ): Promise<any>;
         /**
          * Launches a notification action oData call.
          *  After launching the action, the function gets updated notification data in order to push the updated
@@ -5555,14 +6136,17 @@ declare namespace sap {
            * The ID of the action that is being executed
            */
           sActionId: string
-        ): Promise<any>;
+        ): Promise<sap.ushell.services.NotificationsV2.BulkAction[]>;
         /**
          * Returns the notifications of the user sorted by type include the group headers and the notifications
          *
          *
-         * @returns Promise for all notification items
+         * @returns Promise for all notification items The notifications items have value true for attribute group
+         * header if they are group headers.
          */
-        getNotificationsByTypeWithGroupHeaders(): Promise<any>;
+        getNotificationsByTypeWithGroupHeaders(): Promise<
+          sap.ushell.services.NotificationsV2.NotificationItem[]
+        >;
         /**
          * Returns the number of notifications
          *  e.g. Notifications for user.
@@ -5575,9 +6159,11 @@ declare namespace sap {
          * Returns the group headers of the user notifications
          *
          *
-         * @returns Promise for all group headers
+         * @returns Promise for all group headers The notifications items have value true for attribute group header
          */
-        getNotificationsGroupHeaders(): Promise<any>;
+        getNotificationsGroupHeaders(): Promise<
+          sap.ushell.services.NotificationsV2.NotificationItem[]
+        >;
         /**
          * Returns the number of unseen notifications
          *  e.g. Notifications that the user hasn't seen yet.
@@ -5585,7 +6171,7 @@ declare namespace sap {
          *
          * @returns Promise resolves with the number of unread notifications of the user
          */
-        getUnseenNotificationsCount(): Promise<any>;
+        getUnseenNotificationsCount(): Promise<int>;
         /**
          * Initializes the notification service
          *
@@ -5631,7 +6217,7 @@ declare namespace sap {
            * The ID of the notification whose action is being executed
            */
           sNotificationId: string
-        ): Promise<undefined>;
+        ): Promise<any>;
         /**
          * Mark all notifications as seen.
          *  the main use-case is when the user navigated to the notification center and sees all the pending notifications.
@@ -6700,50 +7286,35 @@ declare namespace sap {
          *
          * @since 1.20.0
          *
-         * @returns `ABC=1&ABC=1%202DEF=4` Note that the result is *not* prefixed with a "?", parameter values are
-         * encodeURIComponent encoded.
+         * @returns * @returns {sap.ui.core.URI} The parameter string, e.g. `ABC=1&ABC=1%202&DEF=4`. Note that the
+         * result is *not* prefixed with a "?", parameter values are encodeURIComponent encoded.
          */
         paramsToString(
           /**
-           * any value { ABC : [1,"1 2"], DEF : ["4"]}
+           * The parameters to combine into the parameter String, e.g. `{ ABC : [1,"1 2"], DEF : ["4"]}`
            */
-          oParams: object
-        ): string;
+          oParams: Record<string, sap.ushell.services.URLParsing.URLValue[]>
+        ): sap.ui.core.URI;
         /**
-         * parse parameters from a URI query string (starting with ?) into a parameter object
+         * This method parses parameters from a URI query string (starting with ?) and puts the result into a parameter
+         * object.
          *
          * @since 1.20.0
          *
-         * @returns oParams, any value { ABC : ["1", "1 2DEF=4"]}
+         * @returns The parsed parameters, e.g. { ABC : ["1", "1 2"], DEF : ["4"]}.
          */
         parseParameters(
           /**
-           * Parameter string, e.g. `?ABC=1&ABC=1%202DEF=4`
+           * Parameter string, e.g. `?ABC=1&ABC=1%202&DEF=4`
            */
-          sParams: string
-        ): object;
+          sParams: sap.ui.core.URI
+        ): Record<string, sap.ushell.services.URLParsing.URLValue[]>;
         /**
          * Decompose a shell hash into the respective parts
          *
          * @since 1.16.0
          *
          * @returns `undefined` if not a parsable hash
-         *
-         * ```javascript
-         *
-         *   {
-         *     semanticObject : string,
-         *
-         *     action : string,
-         *
-         *     contextRaw : string,
-         *
-         *     params :  MapObject,
-         *
-         *     appSpecificRoute : string
-         *
-         *   }
-         * ```
          *  Note that params always has an Array for each parameter value!
          */
         parseShellHash(
@@ -6752,8 +7323,8 @@ declare namespace sap {
            *
            *  e.g. `"#Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH`
            */
-          sHash: string
-        ): object;
+          sHash: sap.ushell.services.Navigation.TargetIntent
+        ): sap.ushell.services.URLParsing.decomposedHash;
         /**
          * split a Unified Shell compliant hash into an Object containing a shell specific part and an app specific
          * parts
@@ -6773,11 +7344,11 @@ declare namespace sap {
          */
         splitHash(
           /**
-           * Hash part of a shell conformant URL #SO-Action~Context?P1=a&P2=x&/route?RPV=1 the hash part
-           * of an URL, e.g. "#Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH
+           * The hash part of a shell conformant URL. It has to have the following format: #SO-Action~Context?P1=a&P2=x&/route?RPV=1
+           * Here is an example for the hash part of an URL: "#Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH
            */
-          sHash: string
-        ): object;
+          sHash: sap.ushell.services.Navigation.TargetIntent
+        ): sap.ushell.services.URLParsing.splitHash;
       }
       /**
        * A UShell service for tracking business flows and user actions.
@@ -6933,20 +7504,29 @@ declare namespace sap {
          */
         getLastName(): string;
         /**
-         * Returns an object representing data about the user: ID, first name, last name, full name, e-mail address.
+         * Returns an object representing data about the user.
          *
          * @since 1.71.0
          *
-         * @returns object providing information about the logged-in user: ID, first name, last name, full name,
-         * e-mail address
+         * @returns Object providing information about the logged-in user.
          */
-        getShellUserInfo(): Promise<any>;
+        getShellUserInfo(): Promise<sap.ushell.services.UserInfo.ShellUserInfo>;
       }
     }
 
     namespace components {
       namespace factsheet {
         namespace controls {
+          /**
+           * Describes the settings that can be provided to the PictureTile constructor.
+           *
+           * @deprecated (since 1.22) - Please use {@link sap.m.Carousel} instead.
+           *
+           * PictureTile is used in PictureViewer control and is not meant to be consumed outside of PictureViewer
+           * usage. PictureViewer was replacing the sap.m.Carousel as it wasn't supporting some versions of MS Internet
+           * Explorer. Now, the sap.m.Carousel is fully functional, please use sap.m.Carousel instead. This control
+           * will not be supported anymore.
+           */
           interface $PictureTileSettings extends sap.m.$CustomTileSettings {
             height?:
               | sap.ui.core.CSSSize
@@ -6965,6 +7545,13 @@ declare namespace sap {
             pictureDelete?: (oEvent: sap.ui.base.Event) => void;
           }
 
+          /**
+           * Describes the settings that can be provided to the PictureViewer constructor.
+           *
+           * @deprecated (since 1.22) - Please use {@link sap.m.Carousel} instead. PictureViewer was replacing the
+           * Carousel as it wasn't supporting some versions of MS Internet Explorer. Now, the sap.m.Carousel is fully
+           * functional, please use sap.m.Carousel instead. This control will not be supported anymore.
+           */
           interface $PictureViewerSettings
             extends sap.m.$TileContainerSettings {
             /**
@@ -6990,6 +7577,14 @@ declare namespace sap {
             pictureDeleted?: (oEvent: sap.ui.base.Event) => void;
           }
 
+          /**
+           * Describes the settings that can be provided to the PictureViewerItem constructor.
+           *
+           * @deprecated (since 1.22) - Please use {@link sap.m.Carousel} instead. PictureViewerItem is used in PictureViewer
+           * control and is not meant to be consumed outside of PictureViewer usage. PictureViewer was replacing the
+           * Carousel as it wasn't supporting some versions of MS Internet Explorer. Now, the sap.m.Carousel is fully
+           * functional, please use sap.m.Carousel instead. This control will not be supported anymore.
+           */
           interface $PictureViewerItemSettings
             extends sap.ui.core.$ControlSettings {
             src?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
@@ -6997,8 +7592,14 @@ declare namespace sap {
             image?: sap.m.Image;
           }
 
+          /**
+           * Parameters of the PictureTile#pictureDelete event.
+           */
           interface PictureTile$PictureDeleteEventParameters {}
 
+          /**
+           * Parameters of the PictureViewer#pictureDeleted event.
+           */
           interface PictureViewer$PictureDeletedEventParameters {}
 
           /**
@@ -7670,11 +8271,17 @@ declare namespace sap {
             ): sap.ushell.components.factsheet.controls.PictureViewerItem;
           }
 
+          /**
+           * Event object of the PictureTile#pictureDelete event.
+           */
           type PictureTile$PictureDeleteEvent = sap.ui.base.Event<
             PictureTile$PictureDeleteEventParameters,
             PictureTile
           >;
 
+          /**
+           * Event object of the PictureViewer#pictureDeleted event.
+           */
           type PictureViewer$PictureDeletedEvent = sap.ui.base.Event<
             PictureViewer$PictureDeletedEventParameters,
             PictureViewer
@@ -7707,6 +8314,11 @@ declare namespace sap {
 
     namespace renderers {
       namespace fiori2 {
+        /**
+         * Describes the settings that can be provided to the Renderer constructor.
+         *
+         * @deprecated (since 1.120.0) - Please use {@link sap.ushell.services.Extension} instead.
+         */
         interface $RendererSettings extends sap.ui.core.$UIComponentSettings {}
 
         /**
@@ -9124,6 +9736,11 @@ declare namespace sap {
 
     namespace ui {
       namespace appfinder {
+        /**
+         * Describes the settings that can be provided to the AppBox constructor.
+         *
+         * @deprecated (since 1.120)
+         */
         interface $AppBoxSettings extends sap.ui.core.$ControlSettings {}
 
         /**
@@ -9157,6 +9774,9 @@ declare namespace sap {
       }
 
       namespace footerbar {
+        /**
+         * Describes the settings that can be provided to the AddBookmarkButton constructor.
+         */
         interface $AddBookmarkButtonSettings extends sap.m.$ButtonSettings {
           /**
            * A callback function that is called before the save-as-tile dialog is opened.
@@ -9726,6 +10346,9 @@ declare namespace sap {
       }
 
       namespace launchpad {
+        /**
+         * Describes the settings that can be provided to the ActionItem constructor.
+         */
         interface $ActionItemSettings extends sap.m.$ButtonSettings {
           actionType?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
@@ -9734,6 +10357,11 @@ declare namespace sap {
           afterRendering?: (oEvent: sap.ui.base.Event) => void;
         }
 
+        /**
+         * Describes the settings that can be provided to the DashboardGroupsContainer constructor.
+         *
+         * @deprecated (since 1.120)
+         */
         interface $DashboardGroupsContainerSettings
           extends sap.ui.core.$ControlSettings {
           /**
@@ -9754,6 +10382,11 @@ declare namespace sap {
           afterRendering?: (oEvent: sap.ui.base.Event) => void;
         }
 
+        /**
+         * Describes the settings that can be provided to the LinkTileWrapper constructor.
+         *
+         * @deprecated (since 1.120)
+         */
         interface $LinkTileWrapperSettings
           extends sap.ui.core.$ControlSettings {
           uuid?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
@@ -9816,27 +10449,56 @@ declare namespace sap {
           showActions?: (oEvent: sap.ui.base.Event) => void;
         }
 
+        /**
+         * Describes the settings that can be provided to the TileState constructor.
+         *
+         * @deprecated (since 1.120)
+         */
         interface $TileStateSettings extends sap.ui.core.$ControlSettings {
           state?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
           press?: (oEvent: sap.ui.base.Event) => void;
         }
 
+        /**
+         * Parameters of the ActionItem#afterRendering event.
+         */
         interface ActionItem$AfterRenderingEventParameters {}
 
+        /**
+         * Parameters of the ActionItem#press event.
+         */
         interface ActionItem$PressEventParameters
           extends sap.m.Button$PressEventParameters {}
 
+        /**
+         * Parameters of the DashboardGroupsContainer#afterRendering event.
+         */
         interface DashboardGroupsContainer$AfterRenderingEventParameters {}
 
+        /**
+         * Parameters of the LinkTileWrapper#afterRendering event.
+         */
         interface LinkTileWrapper$AfterRenderingEventParameters {}
 
+        /**
+         * Parameters of the LinkTileWrapper#coverDivPress event.
+         */
         interface LinkTileWrapper$CoverDivPressEventParameters {}
 
+        /**
+         * Parameters of the LinkTileWrapper#press event.
+         */
         interface LinkTileWrapper$PressEventParameters {}
 
+        /**
+         * Parameters of the LinkTileWrapper#showActions event.
+         */
         interface LinkTileWrapper$ShowActionsEventParameters {}
 
+        /**
+         * Parameters of the TileState#press event.
+         */
         interface TileState$PressEventParameters {}
 
         /**
@@ -11276,6 +11938,8 @@ declare namespace sap {
          * Denotes display states of the viewport
          *
          * This enum is part of the 'sap/ushell/library' module export and must be accessed by the property 'ui.launchpad.ViewPortState'.
+         *
+         * @deprecated (since 1.120.0) - The ViewPortState is related to Fiori2 and not used anymore.
          */
         enum ViewPortState {
           /**
@@ -11307,42 +11971,65 @@ declare namespace sap {
            */
           RightCenter = "RightCenter",
         }
-
+        /**
+         * Event object of the ActionItem#afterRendering event.
+         */
         type ActionItem$AfterRenderingEvent = sap.ui.base.Event<
           ActionItem$AfterRenderingEventParameters,
           ActionItem
         >;
 
+        /**
+         * Event object of the ActionItem#press event.
+         */
         type ActionItem$PressEvent = sap.ui.base.Event<
           ActionItem$PressEventParameters,
           ActionItem
         >;
 
+        /**
+         * Event object of the DashboardGroupsContainer#afterRendering event.
+         */
         type DashboardGroupsContainer$AfterRenderingEvent = sap.ui.base.Event<
           DashboardGroupsContainer$AfterRenderingEventParameters,
           DashboardGroupsContainer
         >;
 
+        /**
+         * Event object of the LinkTileWrapper#afterRendering event.
+         */
         type LinkTileWrapper$AfterRenderingEvent = sap.ui.base.Event<
           LinkTileWrapper$AfterRenderingEventParameters,
           LinkTileWrapper
         >;
 
+        /**
+         * Event object of the LinkTileWrapper#coverDivPress event.
+         */
         type LinkTileWrapper$CoverDivPressEvent = sap.ui.base.Event<
           LinkTileWrapper$CoverDivPressEventParameters,
           LinkTileWrapper
         >;
 
+        /**
+         * Event object of the LinkTileWrapper#press event.
+         */
         type LinkTileWrapper$PressEvent = sap.ui.base.Event<
           LinkTileWrapper$PressEventParameters,
           LinkTileWrapper
         >;
 
+        /**
+         * Event object of the LinkTileWrapper#showActions event.
+         */
         type LinkTileWrapper$ShowActionsEvent = sap.ui.base.Event<
           LinkTileWrapper$ShowActionsEventParameters,
           LinkTileWrapper
         >;
 
+        /**
+         * Event object of the TileState#press event.
+         */
         type TileState$PressEvent = sap.ui.base.Event<
           TileState$PressEventParameters,
           TileState
@@ -11350,6 +12037,9 @@ declare namespace sap {
       }
 
       namespace shell {
+        /**
+         * Describes the settings that can be provided to the ToolAreaItem constructor.
+         */
         interface $ToolAreaItemSettings extends sap.ui.core.$ControlSettings {
           /**
            * Icon that is displayed in the item.
@@ -11405,8 +12095,14 @@ declare namespace sap {
           expand?: (oEvent: sap.ui.base.Event) => void;
         }
 
+        /**
+         * Parameters of the ToolAreaItem#expand event.
+         */
         interface ToolAreaItem$ExpandEventParameters {}
 
+        /**
+         * Parameters of the ToolAreaItem#press event.
+         */
         interface ToolAreaItem$PressEventParameters {}
 
         /**
@@ -11799,11 +12495,17 @@ declare namespace sap {
           ): this;
         }
 
+        /**
+         * Event object of the ToolAreaItem#expand event.
+         */
         type ToolAreaItem$ExpandEvent = sap.ui.base.Event<
           ToolAreaItem$ExpandEventParameters,
           ToolAreaItem
         >;
 
+        /**
+         * Event object of the ToolAreaItem#press event.
+         */
         type ToolAreaItem$PressEvent = sap.ui.base.Event<
           ToolAreaItem$PressEventParameters,
           ToolAreaItem
@@ -11874,6 +12576,44 @@ declare namespace sap {
     }
 
     namespace ui5service {
+      namespace ShellUIService {
+        /**
+         * Defines essential information about an app.
+         *
+         * Example:
+         * ```javascript
+         *
+         * {
+         *      title: "App 1",
+         *      icon: "sap-icon://folder",
+         *      subtitle: "go to app 1",
+         *      intent: "#Action-toapp1"
+         * }
+         * ```
+         *
+         *
+         * @since 1.120.0
+         */
+        type AppInfo = {
+          /**
+           * The title of the app.
+           */
+          title: string;
+          /**
+           * The icon src representing the app.
+           */
+          icon: string;
+          /**
+           * An optional subtitle of the app.
+           */
+          subtitle?: string;
+          /**
+           * The navigation intent of the app.
+           */
+          intent: string;
+        };
+      }
+
       /**
        * The Unified Shell's ShellUIService service.
        *
@@ -11951,25 +12691,9 @@ declare namespace sap {
       class ShellUIService
         /* was: sap.ui.core.service.Service */ extends Object {
         /**
-         * Returns an instance of the ShellUIService. This constructor must only be called internally by the Fiori
-         * Launchpad renderer and never by applications.
-         *
-         * Instead, this service should be consumed by app components as described in the overview section of this
-         * class.
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
          */
-        constructor(
-          /**
-           * The context in which the service was instantiated. Must have the format:
-           * ```javascript
-           *
-           * {
-           *   scopeType: "component",
-           *   scopeObject: [a UI5 Component in the sap.ushell package]
-           * }
-           * ```
-           */
-          oCallerContext: object
-        );
+        protected constructor();
 
         /**
          * Creates a new subclass of class sap.ushell.ui5service.ShellUIService with name `sClassName` and enriches
@@ -12017,35 +12741,11 @@ declare namespace sap {
          */
         setHierarchy(
           /**
-           * An array representing hierarchies of the currently displayed app. The array should specify title, icon,
-           * and navigation intent as shown in the following example:
-           *
-           *
-           * ```javascript
-           *
-           * [
-           *     {
-           *         title: "Main View",
-           *         icon: "sap-icon://documents",
-           *         intent: "#Action-sameApp"
-           *     },
-           *     {
-           *         title: "View 2",
-           *         subtitle: "Application view number 2",
-           *         intent: "#Action-sameApp&/View2/"
-           *     },
-           *     {
-           *         title: "View 3",
-           *         subtitle: "Application view number 3",
-           *         intent: "#Action-sameApp&/View3/"
-           *     }
-           * ]
-           * ```
-           *
+           * An array representing hierarchies of the currently displayed app.
            *
            * The default app hierarchy is applied if no parameter is given.
            */
-          aHierarchyLevels?: object[]
+          aHierarchyLevels?: sap.ushell.ui5service.ShellUIService.AppInfo[]
         ): void;
         /**
          * Used by apps to set related apps. This setting is propagated towards the Shell Header via corresponding
@@ -12055,34 +12755,9 @@ declare namespace sap {
          */
         setRelatedApps(
           /**
-           * an array of related apps, for example like:
-           *
-           *
-           * ```javascript
-           *
-           * [
-           *       {
-           *           title: "App 1",
-           *           icon: "sap-icon://folder",
-           *           subtitle: "go to app 1",
-           *           intent: "#Action-toapp1"
-           *       },
-           *       {
-           *           title: "App 2",
-           *           icon: "sap-icon://folder",
-           *           subtitle: "go to app 2",
-           *           intent: "#Action-toapp2"
-           *       },
-           *       {
-           *           title: "App 3",
-           *           icon: "sap-icon://folder",
-           *           subtitle: "go to app 3",
-           *           intent: "#Action-toapp3"
-           *       }
-           * ]
-           * ```
+           * An array of related apps.
            */
-          aRelatedApps?: object[]
+          aRelatedApps?: sap.ushell.ui5service.ShellUIService.AppInfo[]
         ): void;
         /**
          * Displays the given title in the shell header. This method should not be called if the app calling the
@@ -12662,6 +13337,8 @@ declare namespace sap {
 
     "sap/ushell/services/_Personalization/VariantSet": undefined;
 
+    "sap/ushell/services/_Ui5ComponentLoader/utils": undefined;
+
     "sap/ushell/services/AppConfiguration": undefined;
 
     "sap/ushell/services/AppLifeCycle": undefined;
@@ -12702,6 +13379,8 @@ declare namespace sap {
 
     "sap/ushell/services/NotificationsV2": undefined;
 
+    "sap/ushell/services/Pages": undefined;
+
     "sap/ushell/services/Personalization": undefined;
 
     "sap/ushell/services/personalization/VariantSetAdapter": undefined;