@sapui5/ts-types 1.114.0 → 1.115.1

package/types/sap.ushell.d.ts

@@ -1,18 +1,18 @@
-// For Library Version: 1.114.0
+// For Library Version: 1.115.1
 
 declare namespace sap {
   namespace ushell {
     /**
-     * @SINCE 1.15.0
+     * @since 1.15.0
      *
      * See:
      * 	sap.ushell.Container.getServiceAsync()
      */
     namespace services {
       /**
-       * @SINCE 1.62.0
-       * @EXPERIMENTAL
-       * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+       * @since 1.62.0
+       * @deprecated
+       * @ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)
        */
       export const ContentExtensionAdapterFactory: undefined;
 
@@ -47,7 +47,7 @@ declare namespace sap {
 
       namespace Personalization {
         /**
-         * @SINCE 1.22.0
+         * @since 1.22.0
          *
          * The container is the anchor object of the unified shell personalization in container mode.
          */
@@ -58,7 +58,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns an array with all internal keys of direct items in the container.
            *
@@ -66,13 +66,13 @@ declare namespace sap {
            */
           _getInternalKeys(): any[];
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * clears the local copy data of this container
            */
           clear(): void;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Checks if a specific direct item is contained in the container.
            *
@@ -85,7 +85,7 @@ declare namespace sap {
             sItemKey: string
           ): boolean;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Deletes a direct item from the container. In case the item does not exist, nothing happens.
            */
@@ -96,7 +96,7 @@ declare namespace sap {
             sItemKey: string
           ): void;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * flush all pending request; The result of the promise may reflect the last pending operation in the queue
            *
@@ -104,7 +104,7 @@ declare namespace sap {
            */
           flush(): object;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns an array with the keys of direct items in the container.
            *
@@ -112,7 +112,7 @@ declare namespace sap {
            */
           getItemKeys(): any[];
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns the value for a direct item from the container. (Value semantics, new copy is returned)
            *
@@ -126,7 +126,7 @@ declare namespace sap {
             sItemKey: string
           ): object;
           /**
-           * @SINCE 1.28.0
+           * @since 1.28.0
            *
            * return the container key as a string variable
            *
@@ -134,7 +134,7 @@ declare namespace sap {
            */
           getKey(): string;
           /**
-           * @SINCE 1.28.0
+           * @since 1.28.0
            *
            * Return an instance unmodifiable container instance. There is one instance of this wrapper per container.
            * It will permit all read accesses to the container, but block all modifying accesses.
@@ -143,14 +143,14 @@ declare namespace sap {
            */
           getUnmodifiableContainer(): object;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            * @deprecated (since 1.31) - Support for this function has been discontinued.
            *
            * return the validity of this container only for testing!
            */
           getValidity(): void;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * (Re)loads the current container data from the underlying storage asynchronously. The current local data
            * is discarded.
@@ -164,7 +164,7 @@ declare namespace sap {
            */
           load(): object;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Attempts to save the current container data at the underlying storage asynchronously. The current state
            * is serialized.
@@ -175,7 +175,7 @@ declare namespace sap {
            */
           save(): object;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Save the current container data at the underlying storage asynchronously at the earlies nDelayInMilliseconds
            * seconds before. The current state is serialized.
@@ -186,7 +186,7 @@ declare namespace sap {
            */
           saveDeferred(): object;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Sets the value of a direct item in the container. In case the item is already existing its value is overwritten.
            * In case it is not existing a new item with this key and value is created. The value is serialized during
@@ -204,7 +204,7 @@ declare namespace sap {
           ): void;
         }
         /**
-         * @SINCE 1.22.0
+         * @since 1.22.0
          *
          * The personalization variant contains personalization data. It is used in the personalization container
          * mode.
@@ -216,7 +216,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.18.0
+           * @since 1.18.0
            *
            * Checks if a specific item is contained in this variant.
            *
@@ -229,7 +229,7 @@ declare namespace sap {
             sItemKey: string
           ): boolean;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Deletes an item from this variant. In case the item does not exist, nothing happens.
            */
@@ -240,7 +240,7 @@ declare namespace sap {
             sItemKey: string
           ): void;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns an array with the keys of all items in this variant.
            *
@@ -248,7 +248,7 @@ declare namespace sap {
            */
           getItemKeys(): any[];
           /**
-           * @SINCE 1.18.0
+           * @since 1.18.0
            *
            * Returns the value for an item in this variant.
            *
@@ -262,7 +262,7 @@ declare namespace sap {
             sItemKey: string
           ): object;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns the key of this variant.
            *
@@ -270,7 +270,7 @@ declare namespace sap {
            */
           getVariantKey(): string;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns the name of this variant.
            *
@@ -278,7 +278,7 @@ declare namespace sap {
            */
           getVariantName(): string;
           /**
-           * @SINCE 1.18.0
+           * @since 1.18.0
            *
            * Sets the value for an item in this variant.
            */
@@ -293,7 +293,7 @@ declare namespace sap {
             item: object
           ): void;
           /**
-           * @SINCE 1.24.0
+           * @since 1.24.0
            *
            * Sets the name of the variant.
            *
@@ -308,7 +308,7 @@ declare namespace sap {
           ): void;
         }
         /**
-         * @SINCE 1.22.0
+         * @since 1.22.0
          *
          * The personalization variant set contains variants of personalization data. It is used in the personalization
          * container mode.
@@ -325,7 +325,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Creates a new variant in the variant set. In case a variant with this name is already existing an exception
            * is thrown.
@@ -339,7 +339,7 @@ declare namespace sap {
             sVariantSetName: string
           ): object;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Checks if a specific variant is contained in the variant set.
            *
@@ -352,7 +352,7 @@ declare namespace sap {
             sVariantKey: string
           ): boolean;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Deletes a variant from the variant set. In case the variant does not exist nothing happens.
            */
@@ -363,7 +363,7 @@ declare namespace sap {
             sVariantKey: string
           ): void;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns the current variant key.
            *
@@ -371,7 +371,7 @@ declare namespace sap {
            */
           getCurrentVariantKey(): string;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns a variant object.
            *
@@ -385,7 +385,7 @@ declare namespace sap {
             sVariantKey: string
           ): object;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns the variant key corresponding to a variant name.
            *
@@ -399,7 +399,7 @@ declare namespace sap {
             sVariantName: string
           ): string;
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Returns an array with the keys of the variants in the variant set.
            *
@@ -407,7 +407,7 @@ declare namespace sap {
            */
           getVariantKeys(): any[];
           /**
-           * @SINCE 1.22.0
+           * @since 1.22.0
            *
            * Sets the current variant key.
            */
@@ -422,7 +422,7 @@ declare namespace sap {
 
       namespace personalization {
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Wrapper object to expose a variant interface on a ContextContainer object obtained from the Peronalization
          * service:
@@ -453,7 +453,7 @@ declare namespace sap {
       }
 
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        *
        * The unified shell's AppConfiguration service.
        */
@@ -474,37 +474,18 @@ declare namespace sap {
         ): void;
       }
       /**
-       * @SINCE 1.38
+       * @since 1.38
+       *
+       * The Unified Shell's AppLifeCycle service.
+       *
+       * **Please note:** To retrieve a valid instance of this service you must call `sap.ushell.Container.getServiceAsync("AppLifeCycle")`.
+       * For details see {@link sap.ushell.services.Container#getServiceAsync}.
        */
       class AppLifeCycle {
-        /**
-         * The Unified Shell's AppLifeCycle service This method MUST be called by the Unified Shell's container
-         * only, others MUST call `sap.ushell.Container.getServiceAsync("AppLifeCycle").then(function (AppLifeCycle)
-         * {});`. Constructs a new instance of the AppLifeCycle service.
-         * See:
-         * 	sap.ushell.services.Container#getServiceAsync
-         */
-        constructor(
-          /**
-           * The service adapter for the AppLifeCycle service, as already provided by the container
-           */
-          oAdapter: object,
-          /**
-           * interface
-           */
-          oContainerInterface: object,
-          /**
-           * Service instantiation
-           */
-          sParameter: string,
-          /**
-           * service configuration (not in use)
-           */
-          oConfig: object
-        );
+        constructor();
 
         /**
-         * @SINCE 1.38
+         * @since 1.38
          *
          * Attaches an event handler for the appLoaded event. This event handler will be triggered each time an
          * application has been loaded.
@@ -524,7 +505,7 @@ declare namespace sap {
           oListener: object
         ): void;
         /**
-         * @SINCE 1.38
+         * @since 1.38
          *
          * Detaches an event handler from the EventProvider.
          */
@@ -539,7 +520,7 @@ declare namespace sap {
           oListener: object
         ): void;
         /**
-         * @SINCE 1.38
+         * @since 1.38
          *
          * Returns information about the currently running application.
          *
@@ -547,18 +528,18 @@ declare namespace sap {
          * 	 -  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.
+         *     displayed.
          * 	 -  getTechnicalParameter: `function` that returns the value of a technical parameter for the given
-         * 			application. This method is for SAP internal usage only.
+         *     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!
+         *     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_)
+         *     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
@@ -567,8 +548,8 @@ declare namespace sap {
          * 	 -  ` 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.
+         *     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.
@@ -578,21 +559,18 @@ declare namespace sap {
         getCurrentApplication(): object | undefined;
       }
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        *
-       * The unified shell's bookmark service, which allows you to create shortcuts on the user's home page.
+       * The Unified Shell's bookmark service, which allows you to create shortcuts on the user's home page.
+       *
+       * **Please note:** To retrieve a valid instance of this service you must call `sap.ushell.Container.getServiceAsync("Bookmark")`.
+       * For details see {@link sap.ushell.services.Container#getServiceAsync}.
        */
       class Bookmark {
-        /**
-         * This method MUST be called by the Unified Shell's container only, others MUST call `sap.ushell.Container.getServiceAsync("Bookmark").then(function
-         * (Bookmark) {});`. Constructs a new instance of the bookmark service.
-         * See:
-         * 	sap.ushell.services.Container#getServiceAsync
-         */
         constructor();
 
         /**
-         * @SINCE 1.15.0
+         * @since 1.15.0
          *
          * Adds a bookmark tile to one of the user's classic homepage groups or to multiple provided content nodes.
          * See:
@@ -662,9 +640,9 @@ declare namespace sap {
             numberUnit?: string;
           },
           /**
-           * Either a legacy launchpad home page group, one content node or an array of content nodes. (See {@link
-           * #getContentNodes}) If not provided, the bookmark will be added to the default group if spaces mode is
-           * not active or to the default page if spaces mode is active.
+           * Either a legacy launchpad home page group, one content node or an array of content nodes. (See {@link #getContentNodes})
+           * If not provided, the bookmark will be added to the default group if spaces mode is not active or to the
+           * default page if spaces mode is active.
            */
           vContainer?:
             | object
@@ -676,7 +654,7 @@ declare namespace sap {
           sContentProviderId?: string
         ): jQuery.Promise;
         /**
-         * @SINCE 1.21.2
+         * @since 1.21.2
          * @deprecated (since 1.112) - Please use {@link #addBookmark} instead.
          *
          * Adds the catalog tile with the given ID to given group. The catalog tile is looked up in the legacy SAP
@@ -710,7 +688,7 @@ declare namespace sap {
           }
         ): jQuery.Promise;
         /**
-         * @SINCE 1.17.1
+         * @since 1.17.1
          *
          * Counts **all** bookmarks pointing to the given URL from all of the user's pages. You can use this method
          * to check if a bookmark already exists.  This is a potentially asynchronous operation in case the user's
@@ -726,10 +704,14 @@ declare namespace sap {
           /**
            * The URL of the bookmarks to be counted, exactly as specified to {@link #addBookmark}.
            */
-          sUrl: string
+          sUrl: string,
+          /**
+           * The Content Provider ID.
+           */
+          sContentProviderId: string
         ): jQuery.Promise;
         /**
-         * @SINCE 1.17.1
+         * @since 1.17.1
          *
          * Deletes **all** bookmarks pointing to the given URL from all of the user's pages.
          * See:
@@ -751,7 +733,7 @@ declare namespace sap {
           sContentProviderId?: string
         ): jQuery.Promise;
         /**
-         * @SINCE 1.81
+         * @since 1.81
          *
          * Returns available content nodes based on the current launchpad context. (Classic homepage, spaces mode)
          *
@@ -763,7 +745,7 @@ declare namespace sap {
          * It has the following properties:
          * 	 - id: ID of the content node
          * 	 - label: Human-readable representation of a content node which can be displayed in a control
-         * 	 - type: Specifies the content node type. E.g: space, page, group, etc. See {@link sap.ushell.ContentNodeType}
+         * 	 - type: Specifies the content node type. E.g: space, page, group, etc. See {@link sap.ushell.ContentNodeType }
          *
          * 	 - isContainer: Specifies if a bookmark can be added
          * 	 - children: Specifies sub-nodes
@@ -772,7 +754,7 @@ declare namespace sap {
          */
         getContentNodes(): Promise<sap.ushell.services.Bookmark.ContentNode[]>;
         /**
-         * @SINCE 1.17.1
+         * @since 1.17.1
          *
          * Updates **all** bookmarks pointing to the given URL on all of the user's pages with the given new parameters.
          * Parameters which are omitted are not changed in the existing bookmarks.
@@ -792,9 +774,64 @@ declare namespace sap {
            */
           sUrl: string,
           /**
-           * The bookmark parameters as documented in {@link #addBookmark}.
+           * Bookmark parameters. In addition to title and URL, a bookmark might allow additional 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: object,
+          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;
+          },
           /**
            * The contentProviderId or undefined outside the cFLP
            */
@@ -802,7 +839,7 @@ declare namespace sap {
         ): jQuery.Promise;
       }
       /**
-       * @SINCE 1.64.0
+       * @since 1.64.0
        *
        * The unified shell's Configuration service, which allows to attach to **selected** launchpad configuration
        * settings and their value changes.
@@ -817,7 +854,7 @@ declare namespace sap {
         constructor();
       }
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        *
        * The Unified Shell's CrossApplicationNavigation service allows to navigate to "external" targets outside
        * of the currently running app (but still in scope of the current Fiori launchpad) or create links to such
@@ -908,7 +945,7 @@ declare namespace sap {
           sHashFragment: string
         ): jQuery.Promise;
         /**
-         * @SINCE 1.38.0
+         * @since 1.38.0
          *
          * Returns a list of semantic objects of the intents the current user can navigate to.
          *
@@ -919,7 +956,7 @@ declare namespace sap {
          */
         getDistinctSemanticObjects(): jQuery.Promise;
         /**
-         * @SINCE 1.38.0
+         * @since 1.38.0
          *
          * Resolves the given semantic object (and action) and business parameters to a list of links available
          * to the user.
@@ -948,7 +985,7 @@ declare namespace sap {
          * is in **internal** format, before putting it into a link tag, you must invoke:
          * ```javascript
          *
-         *   externalHash = oCrossApplicationNavigationService.hrefForExternal({ target : { shellHash :  oLink.intent} }, that.oComponent);
+         *   externalHash = oCrossApplicationNavigationService.hrefForExternal({ target : { shellHash :  oLink.intent } }, that.oComponent);
          * ```
          *    NOTE: in case the mass invocation interface is used (see `vArgs` parameter explanation above),
          * the promise will resolve to an array of arrays of arrays. For example, if the mass interface specified
@@ -976,6 +1013,8 @@ declare namespace sap {
         getLinks(
           /**
            * An object containing nominal arguments for the method, having the following structure:
+           *
+           *
            * ```javascript
            *
            *   {
@@ -994,19 +1033,16 @@ declare namespace sap {
            *                               //   - "text" lexicographical sort on returned 'text' field
            *                               //   - "priority" experimental - top intents are returned first
            *
-           *      treatTechHintAsFilter : true, // optional, defaults to false
-           *                                    // if true, only apps that match
-           *                                    // exactly the supplied technology
-           *                                    // (e.g. sap-ui-tech-hint=WDA) will be considered
+           *      treatTechHintAsFilter : true, // optional, defaults to false.
+           *                                    // if true, only apps that match exactly the supplied technology (e.g. sap-ui-tech-hint=WDA) will be considered.
            *
            *      ui5Component: UI5Component, // mandatory, the UI5 component invoking the service, shall be a root component!
            *
-           *      appStateKey: "abc123...",   // optional, application state key to add to the generated links, SAP internal usage only
+           *      appStateKey: "abc123...",   // optional, application state key to add to the generated links, SAP internal usage only.
            *
-           *      compactIntents: true        // optional, whether intents should be returned in compact format.
-           *                                  // Defaults to false.
+           *      compactIntents: true        // optional, whether intents should be returned in compact format. Defaults to false.
            *
-           *      ignoreFormFactor: true,     // optional, defaults to false, deprecated, do not use, may have no effect in the future
+           *      ignoreFormFactor: true,     // optional, defaults to false, deprecated, do not use, may have no effect in the future.
            *
            *      tags: ["tag-1", "tag-2"]    // optional, if specified, only returns links that match inbound with certain tags.
            *   }
@@ -1067,16 +1103,104 @@ declare namespace sap {
            * Calling this method with no arguments will produce the same result as if the method was called with
            * an empty object.
            */
-          vArgs?: object | object[]
+          vArgs?:
+            | {
+                /**
+                 * Optional, matches any semantic objects if undefined
+                 */
+                semanticObject?: string;
+                /**
+                 * Optional, matches any actions if undefined
+                 */
+                action?: string;
+                /**
+                 * Optional business parameters
+                 */
+                params?: object;
+                /**
+                 * Optional, defaults to false. If true, returns only the links that use at least one (non sap-) parameter
+                 * from 'params'.
+                 */
+                withAtLeastOneUsedParam?: boolean;
+                /**
+                 * Optional parameter that decides on how the returned results will be sorted.
+                 */
+                sortResultsBy?: string;
+                /**
+                 * Optional, defaults to false. If true, only apps that match exactly the supplied technology (e.g. sap-ui-tech-hint=WDA)
+                 * will be considered.
+                 */
+                treatTechHintAsFilter?: boolean;
+                /**
+                 * Mandatory, the UI5 component invoking the service, shall be a root component.
+                 */
+                ui5Component: sap.ui.core.Component;
+                /**
+                 * Optional, application state key to add to the generated links, SAP internal usage only.
+                 */
+                appStateKey?: string;
+                /**
+                 * Optional, whether intents should be returned in compact format. Defaults to false.
+                 */
+                compactIntents?: boolean;
+                /**
+                 * Optional, if specified, only returns links that match inbound with certain tags.
+                 */
+                tags?: string[];
+              }
+            | Array<{
+                /**
+                 * Optional, matches any semantic objects if undefined
+                 */
+                semanticObject?: string;
+                /**
+                 * Optional, matches any actions if undefined
+                 */
+                action?: string;
+                /**
+                 * Optional business parameters
+                 */
+                params?: object;
+                /**
+                 * Optional, defaults to false. If true, returns only the links that use at least one (non sap-) parameter
+                 * from 'params'.
+                 */
+                withAtLeastOneUsedParam?: boolean;
+                /**
+                 * Optional parameter that decides on how the returned results will be sorted.
+                 */
+                sortResultsBy?: string;
+                /**
+                 * Optional, defaults to false. If true, only apps that match exactly the supplied technology (e.g. sap-ui-tech-hint=WDA)
+                 * will be considered.
+                 */
+                treatTechHintAsFilter?: boolean;
+                /**
+                 * Mandatory, the UI5 component invoking the service, shall be a root component.
+                 */
+                ui5Component: sap.ui.core.Component;
+                /**
+                 * Optional, application state key to add to the generated links, SAP internal usage only.
+                 */
+                appStateKey?: string;
+                /**
+                 * Optional, whether intents should be returned in compact format. Defaults to false.
+                 */
+                compactIntents?: boolean;
+                /**
+                 * Optional, if specified, only returns links that match inbound with certain tags.
+                 */
+                tags?: string[];
+              }>
         ): jQuery.Promise;
         /**
-         * @SINCE 1.48
+         * @since 1.48
          *
          * For a given semantic object, this method considers all actions associated with the semantic object and
          * returns the one tagged as a "primaryAction". If no inbound tagged as "primaryAction" exists, then the
          * intent of the first inbound (after sorting has been applied) matching the action "displayFactSheet".
          *
-         * The primary intent is determined by querying {@link sap.ushell.services.CrossApplicationNavigation#getLinks}
+         * The primary intent is determined by querying {@link sap.ushell.services.CrossApplicationNavigation#getLinks }
          * with the given semantic object and optional parameter. Then the resulting list is filtered to the outcome
          * that a single item remains.
          *
@@ -1105,7 +1229,7 @@ declare namespace sap {
           mParameters?: object
         ): jQuery.Deferred;
         /**
-         * @SINCE 1.19.0
+         * @since 1.19.0
          * @deprecated (since 1.38) - Please use {@link #getLinks} instead.
          *
          * Resolves a given semantic object and business parameters to a list of links, taking into account the
@@ -1130,7 +1254,7 @@ declare namespace sap {
          * Note that the intent is in **internal** format, before putting it into a link tag, you must invoke:
          * ```javascript
          *
-         *   externalHash = oCrossApplicationNavigationService.hrefForExternal({ target : { shellHash :  oLink.intent} }, that.oComponent);
+         *   externalHash = oCrossApplicationNavigationService.hrefForExternal({ target : { shellHash :  oLink.intent } }, that.oComponent);
          * ```
          */
         getSemanticObjectLinks(
@@ -1177,7 +1301,7 @@ declare namespace sap {
           iSteps: number
         ): void;
         /**
-         * @SINCE 1.15.0
+         * @since 1.15.0
          * @deprecated (since 1.94) - Please use {@link #hrefForAppSpecificHashAsync} instead.
          *
          * Returns a string which can be put into the DOM (e.g. in a link tag) given an application specific hash
@@ -1198,7 +1322,7 @@ declare namespace sap {
           sAppHash: string
         ): string;
         /**
-         * @SINCE 1.94.0
+         * @since 1.94.0
          *
          * Returns a Promise which resolves a string that can be put into the DOM (e.g. in a link tag) given an
          * application specific hash suffix
@@ -1218,7 +1342,7 @@ declare namespace sap {
           sAppHash: string
         ): Promise<string>;
         /**
-         * @SINCE 1.15.0
+         * @since 1.15.0
          * @deprecated (since 1.98) - Please use {@link #hrefForExternalAsync} instead.
          *
          * Returns a string which can be put into the DOM (e.g. in a link tag). **Note:** The generated url / url
@@ -1303,7 +1427,7 @@ declare namespace sap {
           bAsync: boolean
         ): string | Promise<string>;
         /**
-         * @SINCE 1.15.0
+         * @since 1.15.0
          * @deprecated (since 1.98) - Please use {@link #hrefForExternalAsync} instead.
          *
          * Returns a string which can be put into the DOM (e.g. in a link tag). **Note:** The generated url / url
@@ -1384,7 +1508,7 @@ declare namespace sap {
           bAsync: boolean
         ): string | Promise<string>;
         /**
-         * @SINCE 1.94.0
+         * @since 1.94.0
          *
          * Returns a promise resolving to a URL that launches an app with certain parameters. The URL can be used
          * to define a link to a Fiori application, for example.
@@ -1475,7 +1599,7 @@ declare namespace sap {
           oComponent?: object
         ): Promise<string>;
         /**
-         * @SINCE 1.36.0
+         * @since 1.36.0
          * @deprecated (since 1.94) - Please use {@link #isInitialNavigationAsync} instead.
          *
          * Checks wether the FLP currently shows the initially loaded navigation target (i.e. the intent it was
@@ -1486,7 +1610,7 @@ declare namespace sap {
          */
         isInitialNavigation(): boolean;
         /**
-         * @SINCE 1.94.0
+         * @since 1.94.0
          *
          * Checks whether the FLP has performed the first navigation. This method can be used to detect whether
          * the current app was started directly, that is, without a previous navigation to another app, to the FLP
@@ -1496,7 +1620,7 @@ declare namespace sap {
          */
         isInitialNavigationAsync(): Promise<boolean>;
         /**
-         * @SINCE 1.19.1
+         * @since 1.19.1
          * @deprecated (since 1.31) - Please use {@link #isNavigationSupported} instead. Note that this has a slightly
          * different response format.
          *
@@ -1545,15 +1669,15 @@ declare namespace sap {
           oComponent?: object
         ): jQuery.Promise;
         /**
-         * @SINCE 1.32
+         * @since 1.32
          *
          * Tells whether the given navigation intents are supported for the given parameters, form factor etc. .
          * "Supported" means that a valid navigation target is configured for the user and for the given device.
          *
-         * `isNavigationSupported` is effectively a test function for {@link sap.ushell.services.CrossApplicationNavigation#toExternal}
+         * `isNavigationSupported` is effectively a test function for {@link sap.ushell.services.CrossApplicationNavigation#toExternal }
          * and {@link sap.ushell.services.CrossApplicationNavigation#hrefForExternal}.
          *
-         * It is functionally equivalent to {@link sap.ushell.services.CrossApplicationNavigation#isIntentSupported}
+         * It is functionally equivalent to {@link sap.ushell.services.CrossApplicationNavigation#isIntentSupported }
          * but accepts the same interface as {@link sap.ushell.services.CrossApplicationNavigation#toExternal} and
          * {@link sap.ushell.services.CrossApplicationNavigation#hrefForExternal}.
          *
@@ -1659,7 +1783,7 @@ declare namespace sap {
           oComponent?: object
         ): jQuery.Promise;
         /**
-         * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
          * Resolves the URL hash fragment.
          *
@@ -1677,7 +1801,7 @@ declare namespace sap {
           sHashFragment: string
         ): jQuery.Promise;
         /**
-         * @SINCE 1.15.0
+         * @since 1.15.0
          *
          * Triggers a navigation to a specified target outside of the currently running application (e.g. different
          * launchpad application). Invocation will trigger a hash change and subsequent invocation of the target.
@@ -1791,7 +1915,7 @@ declare namespace sap {
         ): Promise<void>;
       }
       /**
-       * @SINCE 1.25.1
+       * @since 1.25.1
        * @deprecated (since 1.93)
        *
        * The Unified Shell's end user feedback service. This service is deprecated and does nothing. End user
@@ -1807,7 +1931,7 @@ declare namespace sap {
         constructor();
 
         /**
-         * @SINCE 1.25.1
+         * @since 1.25.1
          * @deprecated (since 1.93)
          *
          *
@@ -1815,7 +1939,7 @@ declare namespace sap {
          */
         getLegalText(): string;
         /**
-         * @SINCE 1.25.1
+         * @since 1.25.1
          * @deprecated (since 1.93)
          *
          * The service is deprecated. The function always returns a negative answer.
@@ -1824,7 +1948,7 @@ declare namespace sap {
          */
         isEnabled(): Object;
         /**
-         * @SINCE 1.25.1
+         * @since 1.25.1
          * @deprecated (since 1.93)
          *
          * Sends a feedback.
@@ -1834,7 +1958,7 @@ declare namespace sap {
         sendFeedback(): Promise<any>;
       }
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        * @deprecated (since 1.99) - This service has been deprecated as it only works for the classic homepage.
        *
        * A service for handling groups, tiles and catalogs.
@@ -1936,7 +2060,7 @@ declare namespace sap {
           oTile: object
         ): Function;
         /**
-         * @SINCE 1.21.2
+         * @since 1.21.2
          *
          * Returns catalog's technical data.
          *
@@ -1953,7 +2077,7 @@ declare namespace sap {
           oCatalog: object
         ): object;
         /**
-         * @SINCE 1.17.1
+         * @since 1.17.1
          *
          * Returns the catalog's technical error message in case it could not be loaded from the backend.  **Beware:**
          * The technical error message is not translated!
@@ -2016,7 +2140,7 @@ declare namespace sap {
           oCatalogTile: object
         ): string[];
         /**
-         * @SINCE 1.16.3
+         * @since 1.16.3
          *
          * Returns preview icon for a catalog tile.
          *
@@ -2030,7 +2154,7 @@ declare namespace sap {
           oCatalogTile: object
         ): string;
         /**
-         * @SINCE 1.40
+         * @since 1.40
          *
          * Returns preview subtitle for a catalog tile.
          *
@@ -2044,7 +2168,7 @@ declare namespace sap {
           oCatalogTile: object
         ): string;
         /**
-         * @SINCE 1.16.3
+         * @since 1.16.3
          *
          * Returns preview title for a catalog tile.
          *
@@ -2102,7 +2226,7 @@ declare namespace sap {
           oCatalogTile: object
         ): string;
         /**
-         * @SINCE 1.67.0
+         * @since 1.67.0
          *
          * Returns the catalog tile info
          *
@@ -2282,7 +2406,7 @@ declare namespace sap {
           oTile: object
         ): object;
         /**
-         * @SINCE 1.16.4
+         * @since 1.16.4
          *
          * Returns whether the catalogs collection previously returned by `getCatalogs()` is still valid.
          *
@@ -2539,7 +2663,7 @@ declare namespace sap {
         ): void;
       }
       /**
-       * @SINCE 1.16.0
+       * @since 1.16.0
        */
       class Message {
         /**
@@ -2553,7 +2677,7 @@ declare namespace sap {
         constructor();
 
         /**
-         * @SINCE 1.16.0
+         * @since 1.16.0
          *
          * Shows an confirmation dialog on the screen.
          *
@@ -2591,7 +2715,7 @@ declare namespace sap {
             | string[]
         ): void;
         /**
-         * @SINCE 1.16.0
+         * @since 1.16.0
          *
          * Shows an error message on the screen.
          */
@@ -2606,10 +2730,10 @@ declare namespace sap {
           sTitle?: string
         ): void;
         /**
-         * @SINCE 1.81.0
-         * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+         * @since 1.81.0
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
-         * Shows an error message with details on the screen. If more than one control should be shown, an {sap.m.VBox}
+         * Shows an error message with details on the screen. If more than one control should be shown, an {sap.m.VBox }
          * can be used. The default title is "error". If no custom buttons are given, an emphasized "close" button
          * is shown.
          *
@@ -2634,7 +2758,7 @@ declare namespace sap {
           buttons?: sap.m.Button[]
         ): sap.m.Dialog;
         /**
-         * @SINCE 1.16.0
+         * @since 1.16.0
          *
          * Shows a MessageToast on the screen.
          */
@@ -2650,9 +2774,12 @@ declare namespace sap {
         ): void;
       }
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
+       *
+       * The Unified Shell's internal navigation target resolution service.
        *
-       * The Unified Shell's internal navigation target resolution service
+       * **Please note:** To retrieve a valid instance of this service you must call `sap.ushell.Container.getServiceAsync("NavTargetResolution")`.
+       * For details see {@link sap.ushell.services.Container#getServiceAsync}.
        *
        * Methods in this class deal with *internal* representations of the shell hash.
        *
@@ -2661,18 +2788,7 @@ declare namespace sap {
        * ... )
        */
       class NavTargetResolution {
-        /**
-         * This method MUST be called by the Unified Shell's container only, others MUST call `sap.ushell.Container.getServiceAsync("NavTargetResolution").then(function
-         * (NavTargetResolution) {});`. Constructs a new instance of the navigation target resolution service.
-         * See:
-         * 	sap.ushell.services.Container#getServiceAsync
-         */
-        constructor(
-          /**
-           * a Service configuration
-           */
-          oServiceConfiguration: object
-        );
+        constructor();
 
         /**
          * expands a URL hash fragment
@@ -2691,7 +2807,7 @@ declare namespace sap {
           sHashFragment: string
         ): string;
         /**
-         * @SINCE 1.32
+         * @since 1.32
          *
          * Tells whether the given navigation intent(s) are supported for the given parameters Supported" means
          * that a valid navigation target is configured for the user for the given device form factor.
@@ -2704,7 +2820,7 @@ declare namespace sap {
          *  Example:
          *
          * aIntents: an array of parameterized (parsed) Intent objects, in the corresponding structure to arguments
-         * to {@link sap.ushell.services.CrossApplicationNavigation.toExternal}, {@link sap.ushell.services.CrossApplicationNavigation.hrefForExternal}
+         * to {@link sap.ushell.services.CrossApplicationNavigation.toExternal}, {@link sap.ushell.services.CrossApplicationNavigation.hrefForExternal }
          *
          * ```javascript
          *
@@ -2803,7 +2919,7 @@ declare namespace sap {
          *
          * This is an asynchronous operation.
          *
-         * @returns A jQuery.Promise. Its `done()` function gets an object that you can use to create a {@link sap.ushell.components.container.ApplicationContainer}
+         * @returns A jQuery.Promise. Its `done()` function gets an object that you can use to create a {@link sap.ushell.components.container.ApplicationContainer }
          * or `undefined` in case the hash fragment was empty. Typically it contains the following information:
          *
          * ```javascript
@@ -2828,7 +2944,7 @@ declare namespace sap {
           sHashFragment: string
         ): object;
         /**
-         * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
          * Resolves a navigation target taking into account the sap-system
          *
@@ -2869,7 +2985,7 @@ declare namespace sap {
         ): jQuery.Promise;
       }
       /**
-       * @SINCE 1.32.0
+       * @since 1.32.0
        */
       class Notifications {
         /**
@@ -2914,7 +3030,7 @@ declare namespace sap {
         );
 
         /**
-         * @SINCE 1.34
+         * @since 1.34
          *
          * Launches dismiss notification call.
          *
@@ -2928,7 +3044,7 @@ declare namespace sap {
           sNotificationId: object
         ): Promise<any>;
         /**
-         * @SINCE 1.32
+         * @since 1.32
          *
          * Launches a notification action oData call.
          *  After launching the action, the function gets updated notification data in order to push the updated
@@ -2947,7 +3063,7 @@ declare namespace sap {
           sActionId: object
         ): Promise<any>;
         /**
-         * @SINCE 1.38
+         * @since 1.38
          *
          * Returns the notifications of the user sorted by type include the group headers and the notifications
          *
@@ -2955,7 +3071,7 @@ declare namespace sap {
          */
         getNotificationsByTypeWithGroupHeaders(): Promise<any>;
         /**
-         * @SINCE 1.44
+         * @since 1.44
          *
          * Returns the number of notifications
          *  e.g. Notifications for user.
@@ -2964,7 +3080,7 @@ declare namespace sap {
          */
         getNotificationsCount(): number;
         /**
-         * @SINCE 1.44
+         * @since 1.44
          *
          * Returns the group headers of the user notifications
          *
@@ -2972,7 +3088,7 @@ declare namespace sap {
          */
         getNotificationsGroupHeaders(): Promise<any>;
         /**
-         * @SINCE 1.32
+         * @since 1.32
          *
          * Returns the number of unseen notifications
          *  e.g. Notifications that the user hasn't seen yet.
@@ -2981,7 +3097,7 @@ declare namespace sap {
          */
         getUnseenNotificationsCount(): Promise<any>;
         /**
-         * @SINCE 1.32
+         * @since 1.32
          *
          * Initializes the notification service
          *
@@ -3000,7 +3116,7 @@ declare namespace sap {
          */
         init(): void;
         /**
-         * @SINCE 1.32.0
+         * @since 1.32.0
          *
          * Indicates whether notification service is enabled.
          *  Enabling is based on the `enable` service configuration flag.
@@ -3011,14 +3127,14 @@ declare namespace sap {
          */
         isEnabled(): boolean;
         /**
-         * @SINCE 1.38
+         * @since 1.38
          *
          *
          * @returns boolean value whether first request was already performed and data was returned.
          */
         isFirstDataLoaded(): boolean;
         /**
-         * @SINCE 1.34
+         * @since 1.34
          *
          * Launches mark as read notification call.
          *  After launching the action, the function gets updated notification data in order to push the updated
@@ -3033,14 +3149,14 @@ declare namespace sap {
           sNotificationId: object
         ): Promise<any>;
         /**
-         * @SINCE 1.32
+         * @since 1.32
          *
          * Mark all notifications as seen.
          *  the main use-case is when the user navigated to the notification center and sees all the pending notifications.
          */
         notificationsSeen(): void;
         /**
-         * @SINCE 1.32
+         * @since 1.32
          *
          * Gets a callback function that will be called when updated unseen notifications count is available.
          */
@@ -3051,7 +3167,7 @@ declare namespace sap {
           callback: object
         ): void;
         /**
-         * @SINCE 1.32
+         * @since 1.32
          *
          * Gets a callback function that will be called when updated notifications data is available.
          */
@@ -3063,7 +3179,7 @@ declare namespace sap {
         ): void;
       }
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        */
       class Personalization {
         /**
@@ -3089,7 +3205,7 @@ declare namespace sap {
         );
 
         /**
-         * @SINCE 1.22.0
+         * @since 1.22.0
          *
          * Factory method to obtain an empty Data Context object. When data present in a prior context is not relevant
          * (e.g. when using a "uniquely" generated key and planning to overwrite any colliding front-end server
@@ -3102,7 +3218,7 @@ declare namespace sap {
          *
          * An initial object is returned.
          *
-         * @returns Promise object whose done function returns a {@link sap.ushell.services.Personalization.ContextContainer}
+         * @returns Promise object whose done function returns a {@link sap.ushell.services.Personalization.ContextContainer }
          * object as parameter. The personalization container provides two different interfaces to synchronously
          * operate on personalization data. In the item mode the container contains items as name value pairs for
          * personalization data. In the variant mode the container contains variant sets which contain variants
@@ -3128,7 +3244,7 @@ declare namespace sap {
           oComponent: sap.ui.core.Component
         ): object;
         /**
-         * @SINCE 1.22.0
+         * @since 1.22.0
          *
          * Asynchronously starts a deletion request for the given container identified by sContainerKey. Can be
          * called without having ever called getContainer with the corresponding key
@@ -3152,7 +3268,7 @@ declare namespace sap {
           oScope: object
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          * @deprecated (since 1.22) - Please use {@link #delContainer} instead.
          *
          * Asynchronously starts a deletion request for the given container identified by sContainerKey. Can be
@@ -3173,7 +3289,7 @@ declare namespace sap {
           sContainerKey: string
         ): object;
         /**
-         * @SINCE 1.22.0
+         * @since 1.22.0
          *
          * Factory method to obtain a Data Context object, which is a local copy of the persistence layer data.
          * The Container data is asynchronously read on creation if present, otherwise an initial object is created.
@@ -3239,7 +3355,7 @@ declare namespace sap {
          * server persistent storage. Thus a sequence delete( [validity 0])/wait for promise, getContainer(sKey,{
          * validity : Infinity}) may return a valid dataset.
          *
-         * @returns Promise object whose done function returns a {@link sap.ushell.services.Personalization.ContextContainer}
+         * @returns Promise object whose done function returns a {@link sap.ushell.services.Personalization.ContextContainer }
          * object as parameter. The container provides setItemValue / getItemValue methods to synchronously operate
          * on personalization data. By wrapping it in a VariantSetAdapter, an alternate interface to maintain variants
          * can be obtained.
@@ -3266,7 +3382,7 @@ declare namespace sap {
           oComponent: sap.ui.core.Component
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          * @deprecated (since 1.21) - Please use {@link #getContainer} instead.
          *
          * This interface is deprecated since 1.22, please use getContainer / delContainer.
@@ -3307,7 +3423,7 @@ declare namespace sap {
          *
          * Do not mix up the usage of a personalizer and a personalization container for one containerKey.
          *
-         * @returns Promise object whose done function returns a {@link sap.ushell.services.PersonalizationContainer}
+         * @returns Promise object whose done function returns a {@link sap.ushell.services.PersonalizationContainer }
          * object as parameter. The personalization container provides two different interfaces to synchronously
          * operate on personalization data. In the item mode the container contains items as name-value pairs for
          * personalization data. In the variant mode the container contains variant sets which contain variants
@@ -3320,15 +3436,15 @@ declare namespace sap {
           sContainerKey: string
         ): object;
         /**
-         * @SINCE 1.15.0
+         * @since 1.15.0
          *
          * Returns a personalizer object which handles personalization by asynchronous operations storing the personalization
          * data immediately via the connected adapter. For each operation a round trip is executed.
          *
          * Do not mix the usage of a personalizer and a personalization container for one containerKey.
          *
-         * Fetching multiple Personalizer for the same container, but different items is not supported. Use {@link
-         * sap.ushell.services.Personalizer#getContainer} instead for this scenario.
+         * Fetching multiple Personalizer for the same container, but different items is not supported. Use {@link sap.ushell.services.Personalizer#getContainer }
+         * instead for this scenario.
          *
          * @returns {@link sap.ushell.services.Personalizer} which provides generic read and write access to the
          * currently logged on user's personalization settings.
@@ -3358,7 +3474,7 @@ declare namespace sap {
           oComponent?: sap.ui.core.Component
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns a transient personalizer object which handles personalization by asynchronous operations storing
          * the personalization data transiently as an object property. Primary usage of the transient personalizer
@@ -3371,7 +3487,7 @@ declare namespace sap {
         getTransientPersonalizer(): object;
       }
       /**
-       * @SINCE 1.18.0
+       * @since 1.18.0
        *
        * The personalization container is the anchor object of the unified shell personalization in container
        * mode.
@@ -3383,7 +3499,7 @@ declare namespace sap {
         constructor();
 
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Creates a new variant set in the container. In case a variant set with this key is already existing an
          * exception is thrown.
@@ -3397,7 +3513,7 @@ declare namespace sap {
           sVariantSetKey: string
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Checks if a specific direct item is contained in the container.
          *
@@ -3410,7 +3526,7 @@ declare namespace sap {
           sItemKey: string
         ): boolean;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Checks if a specific variant set is contained in the container.
          *
@@ -3423,7 +3539,7 @@ declare namespace sap {
           sVariantSetKey: string
         ): boolean;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Deletes a direct item from the container. In case the item does not exist, nothing happens.
          */
@@ -3434,7 +3550,7 @@ declare namespace sap {
           sItemKey: string
         ): void;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Deletes a variant set from the container. In case the variant set does not exist nothing happens.
          */
@@ -3445,7 +3561,7 @@ declare namespace sap {
           sVariantSetKey: string
         ): void;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns an array with the keys of direct items in the container.
          *
@@ -3453,7 +3569,7 @@ declare namespace sap {
          */
         getItemKeys(): any[];
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns the value for a direct item from the container.
          *
@@ -3467,7 +3583,7 @@ declare namespace sap {
           sItemKey: string
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns an array with the keys of the variant sets in the container.
          *
@@ -3475,7 +3591,7 @@ declare namespace sap {
          */
         getVariantSetKeys(): any[];
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * (Re)loads the current container data from the underlying storage asynchronously. The current local data
          * is discarded.
@@ -3489,7 +3605,7 @@ declare namespace sap {
          */
         load(): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Attempts to save the current container data at the underlying storage asynchronously. The current state
          * is serialized.
@@ -3500,7 +3616,7 @@ declare namespace sap {
          */
         save(): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Sets the value of a direct item in the container. In case the item is already existing its value is overwritten.
          * In case it is not existing a new item with this key and value is created.
@@ -3517,7 +3633,7 @@ declare namespace sap {
         ): void;
       }
       /**
-       * @SINCE 1.18.0
+       * @since 1.18.0
        *
        * The personalization variant contains personalization data. It is used in the personalization container
        * mode.
@@ -3529,7 +3645,7 @@ declare namespace sap {
         constructor();
 
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Checks if a specific item is contained in this variant.
          *
@@ -3542,7 +3658,7 @@ declare namespace sap {
           sItemKey: string
         ): boolean;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Deletes an item from this variant. In case the item does not exist, nothing happens.
          */
@@ -3553,7 +3669,7 @@ declare namespace sap {
           sItemKey: string
         ): void;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns an array with the keys of all items in this variant.
          *
@@ -3561,7 +3677,7 @@ declare namespace sap {
          */
         getItemKeys(): any[];
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns the value for an item in this variant.
          *
@@ -3575,7 +3691,7 @@ declare namespace sap {
           sItemKey: string
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns the key of this variant.
          *
@@ -3583,7 +3699,7 @@ declare namespace sap {
          */
         getVariantKey(): string;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns the name of this variant.
          *
@@ -3591,7 +3707,7 @@ declare namespace sap {
          */
         getVariantName(): string;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Sets the value for an item in this variant.
          */
@@ -3607,7 +3723,7 @@ declare namespace sap {
         ): void;
       }
       /**
-       * @SINCE 1.18.0
+       * @since 1.18.0
        *
        * The personalization variant set contains variants of personalization data. It is used in the personalization
        * container mode.
@@ -3618,14 +3734,14 @@ declare namespace sap {
          */
         constructor();
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Deletes a variant from the variant set. In case the variant does not exist nothing happens.
          */
         delVariant: undefined;
 
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Checks if a specific variant is contained in the variant set.
          *
@@ -3638,7 +3754,7 @@ declare namespace sap {
           sVariantKey: string
         ): boolean;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns the current variant key.
          *
@@ -3646,7 +3762,7 @@ declare namespace sap {
          */
         getCurrentVariantKey(): string;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns a variant object.
          *
@@ -3660,7 +3776,7 @@ declare namespace sap {
           sVariantKey: string
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns the variant key corresponding to a variant name.
          *
@@ -3674,7 +3790,7 @@ declare namespace sap {
           sVariantName: string
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Returns an array with the keys of the variants in the variant set.
          *
@@ -3682,7 +3798,7 @@ declare namespace sap {
          */
         getVariantKeys(): any[];
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Sets the current variant key.
          */
@@ -3694,7 +3810,7 @@ declare namespace sap {
         ): void;
       }
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        */
       class ShellNavigation {
         /**
@@ -3740,7 +3856,7 @@ declare namespace sap {
          * Thus it is crucial to use appropriate interfaces and not directly invoke window.location.hash.
          *
          * - internal construction methods for a "current" App specific and non-app specific hash (invoked by CrossApplicationNavigation),
-         * 			not to be invoked directly!
+         *     not to be invoked directly!
          * See:
          * 	sap.ushell.services.Container#getServiceAsync
          */
@@ -3782,7 +3898,7 @@ declare namespace sap {
         ): object;
       }
       /**
-       * @SINCE 1.44.0
+       * @since 1.44.0
        * @deprecated (since 1.112) - This service has been deprecated. Please use the CrossApplicationNavigation
        * service instead.
        */
@@ -3805,7 +3921,7 @@ declare namespace sap {
         constructor();
       }
       /**
-       * @SINCE 1.19.1
+       * @since 1.19.1
        *
        * The Unified Shell's Support Ticket service
        */
@@ -3853,7 +3969,7 @@ declare namespace sap {
         );
 
         /**
-         * @SINCE 1.20.0
+         * @since 1.20.0
          *
          * Creates a Support Ticket. Forwards the given data (JSON object) to the associated adapter.
          *
@@ -3866,7 +3982,7 @@ declare namespace sap {
           oSupportTicketData: object
         ): object;
         /**
-         * @SINCE 1.20.0
+         * @since 1.20.0
          *
          * Checks if the service is enabled.  The service enablement depends on the configuration in the back-end
          * system and the bootstrap configuration.
@@ -3876,7 +3992,7 @@ declare namespace sap {
         isEnabled(): boolean;
       }
       /**
-       * @SINCE 1.18.0
+       * @since 1.18.0
        *
        * The transient personalizer shall be used in container mode for table personalization.
        */
@@ -3887,7 +4003,7 @@ declare namespace sap {
         constructor();
 
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Deletes a personalization data value.
          *
@@ -3896,7 +4012,7 @@ declare namespace sap {
          */
         delPersData(): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Gets a personalization data value.
          *
@@ -3906,7 +4022,7 @@ declare namespace sap {
          */
         getPersData(): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Synchronously gets a personalization data value.
          *
@@ -3914,7 +4030,7 @@ declare namespace sap {
          */
         getValue(): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Sets a personalization data value.
          *
@@ -3928,7 +4044,7 @@ declare namespace sap {
           oValue: object
         ): object;
         /**
-         * @SINCE 1.18.0
+         * @since 1.18.0
          *
          * Synchronously sets a personalization data value.
          */
@@ -3940,7 +4056,7 @@ declare namespace sap {
         ): void;
       }
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        */
       class URLParsing {
         /**
@@ -3968,7 +4084,7 @@ declare namespace sap {
         constructor();
 
         /**
-         * @SINCE 1.19.1
+         * @since 1.19.1
          * @deprecated (since 1.31) - Please use {@link sap.ui.model.odata.ODataUtils#setOrigin} instead.
          *
          * Note: deprecated, please use `sap.ui.model.odata.ODataUtils.setOrigin(sServiceUrl, { alias : sSystem
@@ -4021,7 +4137,7 @@ declare namespace sap {
           vComponentOrSystem?: string | sap.ui.core.Component
         ): string;
         /**
-         * @SINCE 1.16.0
+         * @since 1.16.0
          *
          * compose a shell Hash from it's respective parts Note that it also may append an app specific route !
          *
@@ -4051,7 +4167,7 @@ declare namespace sap {
           oShellHash: object
         ): string;
         /**
-         * @SINCE 1.16.0
+         * @since 1.16.0
          *
          * Extract a hash part from an URL, including an app-specific part
          *
@@ -4064,9 +4180,9 @@ declare namespace sap {
           sURL: string
         ): string;
         /**
-         * @SINCE 1.16.0
+         * @since 1.16.0
          *
-         * Extract the Shell hash# part from an URL The application specific route part is removed See {@link #getHash}
+         * Extract the Shell hash# part from an URL The application specific route part is removed See {@link #getHash }
          * for a function which retains the app specific route.
          *
          * Shell services shall use this service to extract relevant parts of an URL from an actual URL string (which
@@ -4089,7 +4205,7 @@ declare namespace sap {
           sShellHashString: string
         ): Object;
         /**
-         * @SINCE 1.30.0
+         * @since 1.30.0
          * @deprecated (since 1.96) - Please use {@link #isIntentUrlAsync} instead.
          *
          * Check if a URL has an intent based navigation part which can be parsed into a semantic object and action
@@ -4111,7 +4227,7 @@ declare namespace sap {
           sUrl: string
         ): boolean;
         /**
-         * @SINCE 1.96.0
+         * @since 1.96.0
          *
          * 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
@@ -4132,7 +4248,7 @@ declare namespace sap {
           sUrl: string
         ): Promise<boolean>;
         /**
-         * @SINCE 1.20.0
+         * @since 1.20.0
          *
          * combine members of a javascript object into a parameter string, note that parameters are ordered in an
          * arbitrary manner which is subject to change
@@ -4147,7 +4263,7 @@ declare namespace sap {
           oParams: object
         ): string;
         /**
-         * @SINCE 1.20.0
+         * @since 1.20.0
          *
          * parse parameters from a URI query string (starting with ?) into a parameter object
          *
@@ -4160,7 +4276,7 @@ declare namespace sap {
           sParams: string
         ): object;
         /**
-         * @SINCE 1.16.0
+         * @since 1.16.0
          *
          * Decompose a shell hash into the respective parts
          *
@@ -4192,7 +4308,7 @@ declare namespace sap {
           sHash: string
         ): object;
         /**
-         * @SINCE 1.16.0
+         * @since 1.16.0
          *
          * split a Unified Shell compliant hash into an Object containing a shell specific part and an app specific
          * parts
@@ -4217,7 +4333,7 @@ declare namespace sap {
         ): object;
       }
       /**
-       * @SINCE 1.32.0
+       * @since 1.32.0
        *
        * A UShell service for tracking business flows and user actions.
        */
@@ -4262,7 +4378,7 @@ declare namespace sap {
         );
 
         /**
-         * @SINCE 1.32.0
+         * @since 1.32.0
          *
          * Sets up to 6 customer attributes of logged events according to the given object attributes.
          *  A customer attribute can be set only once during a session.
@@ -4286,13 +4402,13 @@ declare namespace sap {
           oCustomFieldValues: object
         ): void;
         /**
-         * @SINCE 1.32.0
+         * @since 1.32.0
          *
          * Enables the renderer to set the content of the legal message..
          */
         setLegalText(): void;
         /**
-         * @SINCE 1.32.0
+         * @since 1.32.0
          *
          * Indicates whether the service is available.
          *
@@ -4308,7 +4424,7 @@ declare namespace sap {
          */
         systemEnabled(): boolean;
         /**
-         * @SINCE 1.32.0
+         * @since 1.32.0
          *
          * Indicates whether the user has specified to track activities.
          *
@@ -4324,7 +4440,7 @@ declare namespace sap {
         userEnabled(): boolean;
       }
       /**
-       * @SINCE 1.16.3
+       * @since 1.16.3
        */
       class UserInfo {
         /**
@@ -4348,7 +4464,7 @@ declare namespace sap {
         );
 
         /**
-         * @SINCE 1.86.0
+         * @since 1.86.0
          *
          * Returns the email address of the user.
          *
@@ -4356,7 +4472,7 @@ declare namespace sap {
          */
         getEmail(): string;
         /**
-         * @SINCE 1.86.0
+         * @since 1.86.0
          *
          * Returns the first name of the user.
          *
@@ -4364,7 +4480,7 @@ declare namespace sap {
          */
         getFirstName(): string;
         /**
-         * @SINCE 1.86.0
+         * @since 1.86.0
          *
          * Returns the full name of the user.
          *
@@ -4372,7 +4488,7 @@ declare namespace sap {
          */
         getFullName(): string;
         /**
-         * @SINCE 1.16.3
+         * @since 1.16.3
          *
          * Returns the id of the user.
          *
@@ -4380,7 +4496,7 @@ declare namespace sap {
          */
         getId(): string;
         /**
-         * @SINCE 1.86.0
+         * @since 1.86.0
          *
          * Returns the last name of the user.
          *
@@ -4443,6 +4559,10 @@ declare namespace sap {
             image?: sap.m.Image;
           }
 
+          interface PictureTile$PictureDeleteEventParameters {}
+
+          interface PictureViewer$PictureDeletedEventParameters {}
+
           /**
            * @deprecated (since 1.22) - Please use {@link sap.m.Carousel} instead.
            *
@@ -4579,7 +4699,7 @@ declare namespace sap {
               oListener?: object
             ): this;
             /**
-             * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+             * @ui5-protected Do not call from applications (only from related classes in the framework)
              *
              * Fires event {@link #event:pictureDelete pictureDelete} to attached listeners.
              *
@@ -4823,7 +4943,7 @@ declare namespace sap {
               oListener?: object
             ): this;
             /**
-             * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+             * @ui5-protected Do not call from applications (only from related classes in the framework)
              *
              * Fires event {@link #event:pictureDeleted pictureDeleted} to attached listeners.
              *
@@ -5079,13 +5199,29 @@ declare namespace sap {
               sSrc: string
             ): sap.ushell.components.factsheet.controls.PictureViewerItem;
           }
+
+          /**
+           * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'PictureTile$PictureDeleteEventParameters'
+           * in 1.115.1 and any later releases.
+           */
+          type $PictureTilePictureDeleteEventParameters = sap.ushell.components.factsheet.controls.PictureTile$PictureDeleteEventParameters;
+
+          type PictureTile$PictureDeleteEvent = sap.ui.base.Event<PictureTile$PictureDeleteEventParameters>;
+
+          /**
+           * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'PictureViewer$PictureDeletedEventParameters'
+           * in 1.115.1 and any later releases.
+           */
+          type $PictureViewerPictureDeletedEventParameters = sap.ushell.components.factsheet.controls.PictureViewer$PictureDeletedEventParameters;
+
+          type PictureViewer$PictureDeletedEvent = sap.ui.base.Event<PictureViewer$PictureDeletedEventParameters>;
         }
       }
     }
 
     namespace Container {
       /**
-       * @SINCE 1.90.0
+       * @since 1.90.0
        *
        * An enumeration for the application work protect mode state.
        */
@@ -5110,7 +5246,7 @@ declare namespace sap {
         interface $RendererSettings extends sap.ui.core.$UIComponentSettings {}
 
         /**
-         * @SINCE 1.15.0
+         * @since 1.15.0
          *
          * The SAPUI5 component of SAP Fiori Launchpad renderer for the Unified Shell.
          */
@@ -5124,7 +5260,7 @@ declare namespace sap {
            */
           constructor();
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * The launchpad states that can be passed as a parameter.
            *
@@ -5164,7 +5300,7 @@ declare namespace sap {
            */
           static getMetadata(): sap.ui.core.ComponentMetadata;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            * @deprecated (since 1.48) - Please use {@link #addUserAction} instead.
            *
            * Creates an action button in the User Actions Menu in the SAP Fiori launchpad, in the given launchpad
@@ -5213,9 +5349,9 @@ declare namespace sap {
              * control. Valid only if bCurrentState is set to false.
              */
             aStates: string[]
-          ): object;
+          ): sap.ui.core.Control;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            * @deprecated (since 1.93)
            *
            * Adds the given sap.ui.core.Control to the EndUserFeedback dialog.
@@ -5232,7 +5368,7 @@ declare namespace sap {
             bShowCustomUIContent: boolean
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            * @deprecated (since 1.48) - Please use {@link #addFloatingButton} instead.
            *
            * Creates a FloatingActionButton in Fiori launchpad, in the given launchpad states.
@@ -5281,7 +5417,7 @@ declare namespace sap {
             aStates: string[]
           ): object;
           /**
-           * @SINCE 1.48
+           * @since 1.48
            * @deprecated (since 1.52)
            *
            * Creates a FloatingActionButton in Fiori launchpad, in the given launchpad states.
@@ -5320,7 +5456,7 @@ declare namespace sap {
             oParameters: object
           ): object;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Creates and displays a shell header icon in Fiori launchpad, in the given launchpad states.
            *  The icon is displayed in the right side of the Fiori Launchpad shell header or in an overflow menu.
@@ -5395,9 +5531,9 @@ declare namespace sap {
              * in which to add the control.
              */
             aStates: string[]
-          ): object;
+          ): sap.ui.core.Control;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Creates and displays an item in the header of Fiori launchpad, in the given launchpad states.
            *  The new header item will be displayed on the left-hand side of the Fiori Launchpad shell header, according
@@ -5457,9 +5593,9 @@ declare namespace sap {
              *  If no launchpad state is provided the control is added in all states.
              */
             aStates: string[]
-          ): object;
+          ): sap.ui.core.Control;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Creates and displays an item in the header of Fiori launchpad, in the given launchpad states.
            *  The new header item will be displayed on the left-hand side of the Fiori Launchpad shell header, according
@@ -5514,9 +5650,9 @@ declare namespace sap {
              *  If no launchpad state is provided the control is added in all states.
              */
             aStates: string[]
-          ): object;
+          ): sap.ui.core.Control;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            * @deprecated (since 1.48) - Please use {@link #addSidePaneContent} instead.
            *
            * Creates the Left Pane content in Fiori launchpad, in the given launchpad states.
@@ -5564,7 +5700,7 @@ declare namespace sap {
             aStates: string[]
           ): object;
           /**
-           * @SINCE 1.48
+           * @since 1.48
            *
            * Creates and displays a sub header control in Fiori launchpad, in the given launchpad states.
            *  The new control is displayed in FLP UI according to the given display parameters.
@@ -5593,29 +5729,39 @@ declare namespace sap {
            * ```
            *
            *
-           * @returns jQuery.deferred.promise object that when resolved, returns the newly created control
+           * @returns jQuery.Deferred.promise object that when resolved, returns the newly created control
            */
           addShellSubHeader(
             /**
-             * Contains the required parameters for creating and showing the new control object:
-             *  Properties:
-             *  - {string} controlType
-             *  The (class) name of the control type to create.
-             *  - {object} oControlProperties
-             *  The properties that will be passed to the created control.
-             *  - {boolean} bIsVisible
-             *  Specify whether to display the control.
-             *  - {boolean} bCurrentState
-             *  If true, add the current control only to the current rendered shell state.
-             *  Once the user navigates to another app or back to the Home page, this control will be removed.
-             *  - {string[]} aStates
-             *  (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState
-             * in which to add the control.
+             * Contains the required parameters for creating and showing the new control object.
              */
-            oParameters: object
-          ): object;
+            oParameters: {
+              /**
+               * The (class) name of the control type to create.
+               */
+              controlType: string;
+              /**
+               * The properties that will be passed to the created control.
+               */
+              oControlProperties: object;
+              /**
+               * Specify whether to display the control.
+               */
+              bIsVisible: boolean;
+              /**
+               * If true, add the current control only to the current rendered shell state. Once the user navigates to
+               * another app or back to the Home page, this control will be removed.
+               */
+              bCurrentState: boolean;
+              /**
+               * (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState
+               * in which to add the control.
+               */
+              aStates: string[];
+            }
+          ): jQuery.Promise;
           /**
-           * @SINCE 1.48
+           * @since 1.48
            *
            * Creates the Left Pane content in Fiori launchpad, in the given launchpad states.
            *
@@ -5641,7 +5787,7 @@ declare namespace sap {
            * 	LaunchpadState
            *      If no launchpad state is provided the content is added in all states.
            *
-           * @returns jQuery.deferred.promise object that when resolved, returns the newly created control.
+           * @returns jQuery.Deferred.promise object that when resolved, returns the newly created control.
            */
           addSidePaneContent(
             /**
@@ -5671,9 +5817,9 @@ declare namespace sap {
                */
               aStates: string[];
             }
-          ): object;
+          ): jQuery.Promise;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            * @deprecated (since 1.48) - Please use {@link #addShellSubHeader} instead.
            *
            * Creates and displays a sub header control in Fiori launchpad, in the given launchpad states.
@@ -5735,7 +5881,7 @@ declare namespace sap {
             aStates: string[]
           ): object;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Creates a ToolAreaItem in Fiori Launchpad and adds it to the Tool Area, in the given launchpad states.
            * Once the item is added, the Tool Area is rendered on the left side on the Fiori Launchpad shell.
@@ -5782,9 +5928,9 @@ declare namespace sap {
              * in which the controls are added. If no launchpad state is provided the items are added in all states.
              */
             aStates: string[]
-          ): object;
+          ): sap.ui.core.Control;
           /**
-           * @SINCE 1.48
+           * @since 1.48
            *
            * Creates an Action Button in Fiori launchpad, in the given launchpad states.
            *  The button will be displayed in the user actions menu, that is opened from the user button in the shell
@@ -5809,33 +5955,41 @@ declare namespace sap {
            * oRenderer.addUserAction(oAddActionButtonProperties);
            * ```
            *
-           * See:
-           * 	LaunchpadState
-           *   If no launchpad state is provided the content is added in all states.
            *
-           * @returns jQuery.deferred.promise object that when resolved, returns the newly created control
+           * @returns jQuery.Deferred.promise object that when resolved, returns the newly created control
            */
           addUserAction(
             /**
-             * Contains the required parameters for creating and showing the new control object:
-             *  Properties:
-             *  - {string} controlType
-             *  The (class) name of the control type to create.
-             *  - {object} oControlProperties
-             *  The properties that will be passed to the created control.
-             *  - {boolean} bIsVisible
-             *  Specify whether to display the control.
-             *  - {boolean} bCurrentState
-             *  If true, add the current control only to the current rendered shell state.
-             *  Once the user navigates to another app or back to the Home page, this control will be removed.
-             *  - {string[]} aStates
-             *  (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState
-             * in which to add the control.
+             * Contains the required parameters for creating and showing the new control object.
              */
-            oParameters: object
-          ): object;
+            oParameters: {
+              /**
+               * The (class) name of the control type to create.
+               */
+              controlType: string;
+              /**
+               * The properties that will be passed to the created control.
+               */
+              oControlProperties: object;
+              /**
+               * Specify whether to display the control.
+               */
+              bIsVisible: boolean;
+              /**
+               * If true, add the current control only to the current rendered shell state. Once the user navigates to
+               * another app or back to the Home page, this control will be removed.
+               */
+              bCurrentState: boolean;
+              /**
+               * (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState
+               * in which to add the control. If no launchpad state is provided the content is added in all states. @see
+               * LaunchpadState
+               */
+              aStates: string[];
+            }
+          ): jQuery.Promise;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Adds an entry to the User Preferences dialog box including the UI control that appears when the user
            * clicks the new entry, and handling of User Preferences actions such as SAVE and CANCEL.
@@ -5858,43 +6012,59 @@ declare namespace sap {
            * };
            * oRenderer.addUserPreferencesEntry(oEntry);
            * ```
-           *
-           *
-           * @returns User Preference Entry.
            */
           addUserPreferencesEntry(
             /**
-             * The data of the new added User Preference entry Including:
-             * 	{string} entryHelpID (Optional) - The ID of the object.
-             *  {string} title - The title of the entry to be presented in the list in the User Preferences dialog
-             * box.
-             *  We recommend using a string from the translation bundle.
-             *  {string}/{Function} value - A string to be presented as the value of the entry
-             *  OR a function to be called which returns a {jQuery.Deferred.promise} object.
-             *  {Function} content - A function to be called that returns a {jQuery.Deferred.promise} object
-             *  which consists of a {sap.ui.core.Control} to be displayed in a follow-on dialog box. A SAPUI5 view instance
-             * can also be returned. The functions is called on each time the user opens the User Preferences dialog
-             * box. {Function} onSave - A function to be called which returns a {jQuery.Deferred.promise} object
-             * when the user clicks Save in the User Preferences dialog box.
-             *  If an error occurs, pass the error message via the {jQuery.Deferred.promise} object. Errors are displayed
-             * in the log.
-             *  {Function} onCancel - A function to be called that closes the User Preferences dialog box without
-             * saving any changes.
-             *  {Boolean} provideEmptyWrapper - Experimental. Set this value to true if you want that your content
-             * is displayed without the standard header
-             */
-            entryObject: object
-          ): object;
+             * The data of the new added User Preference entry.
+             */
+            entryObject: {
+              /**
+               * (Optional) - The ID of the object.
+               */
+              entryHelpID: string;
+              /**
+               * The title of the entry to be presented in the list in the User Preferences dialog box. We recommend using
+               * a string from the translation bundle.
+               */
+              title: string;
+              /**
+               * A function to be called that returns a {jQuery.Deferred.promise} object which consists of a {sap.ui.core.Control }
+               * to be displayed in a follow-on dialog box. A SAPUI5 view instance can also be returned. The function
+               * is called on each time the user opens the User Preferences dialog box.
+               */
+              content: Function;
+              /**
+               * A function to be called which returns a {jQuery.Deferred.promise} object when the user clicks "save"
+               * in the User Preferences dialog box. If an error occurs, pass the error message via the {jQuery.Deferred.promise }
+               * object. Errors are displayed in the log.
+               */
+              onSave: Function;
+              /**
+               * A function to be called that closes the User Preferences dialog box without saving any changes.
+               */
+              onCancel: Function;
+              /**
+               * Experimental. Set this value to true if you want that your content is displayed without the standard
+               * header.
+               */
+              provideEmptyWrapper: boolean;
+            },
+            /**
+             * A string to be presented as the value of the entry OR a function to be called which returns a {jQuery.Deferred.promise }
+             * object.
+             */
+            value: string | Function
+          ): void;
           /**
-           * @SINCE 1.37
+           * @since 1.37
            *
            * This method returns the current state of the Viewport Container control.
            *
            * @returns The current Viewport State.
            */
-          getCurrentViewportState(): object;
+          getCurrentViewportState(): string;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Hides an action button from the User Actions Menu in the SAP Fiori launchpad, in the given launchpad
            * states (LaunchpadState). The removed button will not be destroyed.
@@ -5920,7 +6090,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            * @deprecated (since 1.52)
            *
            * Hide the given sap.ushell.ui.shell.ShellFloatingAction from Fiori Launchpad, in the given launchpad states.
@@ -5949,7 +6119,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Hide the given sap.ushell.ui.shell.ShellHeadItem from Fiori Launchpad, in the given launchpad states.
            * The removed control will not be destroyed.
@@ -5977,7 +6147,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Hide the given sap.ushell.ui.shell.ShellHeadItem from Fiori Launchpad, in the given launchpad states.
            * The removed control will not be destroyed.
@@ -6005,7 +6175,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Hide the given control from Fiori Launchpad, in the given launchpad states. The removed control will
            * not be destroyed.
@@ -6033,7 +6203,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Hide the given control from the Fiori Launchpad sub header, in the given launchpad states. The removed
            * control will not be destroyed.
@@ -6061,7 +6231,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * If exists, this method will remove the footer from the Fiori Launchpad.
            *
@@ -6071,7 +6241,7 @@ declare namespace sap {
            */
           removeFooter(): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Remove the given Tool Area Item from Fiori Launchpad, in the given launchpad states. This API is meant
            * to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it
@@ -6097,7 +6267,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Displays the given sap.m.Bar as the footer of the Fiori launchpad shell.
            *  The footer will be displayed in all states.
@@ -6117,12 +6287,12 @@ declare namespace sap {
            */
           setFooter(
             /**
-             * The control to be added as the footer of the Fiori Launchpad
+             * sap.m.Bar, the control to be added as the footer of the Fiori Launchpad
              */
             oFooter: sap.m.Bar
           ): void;
           /**
-           * @SINCE 1.42
+           * @since 1.42
            * @deprecated (since 1.48) - Please use {@link #setShellFooter} instead.
            *
            * Creates and displays an SAPUI5 control as the footer of the Fiori launchpad shell.
@@ -6162,7 +6332,7 @@ declare namespace sap {
             oControlProperties: object
           ): sap.ui.core.Control;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Sets the title in the Fiori Launchpad shell header.
            */
@@ -6173,7 +6343,7 @@ declare namespace sap {
             sTitle: string
           ): void;
           /**
-           * @SINCE 1.38
+           * @since 1.38
            *
            * Sets the header visibility according to the given value and shell states. (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
            *
@@ -6208,7 +6378,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Sets the visibility of the left pane in the Fiori Launchpad shell, in the given launchpad state @see
            * LaunchpadState
@@ -6224,7 +6394,7 @@ declare namespace sap {
             bVisible: boolean
           ): void;
           /**
-           * @SINCE 1.48
+           * @since 1.48
            *
            * Creates and displays an SAPUI5 control as the footer of the Fiori launchpad shell.
            *  The footer will be displayed in all states.
@@ -6251,21 +6421,25 @@ declare namespace sap {
            * ```
            *
            *
-           * @returns object that when resolved, returns the newly created control
+           * @returns jQuery.deferred.promise object that when resolved, returns the newly created control
            */
           setShellFooter(
             /**
-             * Contains the required parameters for creating and showing the new control object:
-             *  Properties:
-             *  - {string} controlType
-             *  The (class) name of the control type to create, for example: `"sap.m.Bar"`
-             *  - {object} oControlProperties
-             *  The properties that will be passed to the created control, for example: `{id: "testBar"}`
+             * Contains the required parameters for creating and showing the new control object.
              */
-            oParameters: object
+            oParameters: {
+              /**
+               * The (class) name of the control type to create, for example: `sap.m.Bar`
+               */
+              controlType: string;
+              /**
+               * The properties that will be passed to the created control, for example: `{id: "testBar"}`
+               */
+              oControlProperties: object;
+            }
           ): jQuery.Promise;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Displays action buttons in the User Actions Menu in the SAP Fiori launchpad, in the given launchpad states
            * (LaunchpadState). (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
@@ -6303,7 +6477,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            * @deprecated (since 1.52) - Support for the FloatingActionButton has been discontinued.
            *
            * Displays FloatingActionButton on the bottom right corner of the Fiori launchpad, in the given launchpad
@@ -6337,7 +6511,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Displays HeaderItems on the right side of the Fiori launchpad shell header, in the given launchpad states
            * (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
@@ -6371,7 +6545,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Creates and displays one or more HeaderItem controls according to the given control IDs and Shell states
            *  (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
@@ -6412,7 +6586,7 @@ declare namespace sap {
             aStates: string[]
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Displays one or more sub header controls according to the given control IDs and shell states.
            *  (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
@@ -6468,7 +6642,7 @@ declare namespace sap {
             bVisible?: boolean
           ): void;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Displays ToolAreaItems on the left side of the Fiori Launchpad shell, in the given launchpad states.
            *
@@ -6551,6 +6725,10 @@ declare namespace sap {
           afterRendering?: (oEvent: sap.ui.base.Event) => void;
         }
 
+        interface AppBox$AfterRenderingEventParameters {}
+
+        interface AppBox$PressEventParameters {}
+
         /**
          * Add your documentation for the new ui/appfinder/AppBox
          */
@@ -6749,7 +6927,7 @@ declare namespace sap {
             oListener?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:afterRendering afterRendering} to attached listeners.
            *
@@ -6762,7 +6940,7 @@ declare namespace sap {
             mParameters?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:press press} to attached listeners.
            *
@@ -6907,6 +7085,22 @@ declare namespace sap {
             sUrl?: string
           ): this;
         }
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'AppBox$AfterRenderingEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $AppBoxAfterRenderingEventParameters = sap.ushell.ui.appfinder.AppBox$AfterRenderingEventParameters;
+
+        type AppBox$AfterRenderingEvent = sap.ui.base.Event<AppBox$AfterRenderingEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'AppBox$PressEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $AppBoxPressEventParameters = sap.ushell.ui.appfinder.AppBox$PressEventParameters;
+
+        type AppBox$PressEvent = sap.ui.base.Event<AppBox$PressEventParameters>;
       }
 
       namespace footerbar {
@@ -6974,7 +7168,7 @@ declare namespace sap {
             | `{${string}}`;
 
           /**
-           * Data source of the OData service. See same parameter of {@link sap.ushell.services.Bookmark#addBookmark}
+           * Data source of the OData service. See same parameter of {@link sap.ushell.services.Bookmark#addBookmark }
            * for details
            */
           dataSource?:
@@ -7123,7 +7317,7 @@ declare namespace sap {
           /**
            * Gets current value of property {@link #getDataSource dataSource}.
            *
-           * Data source of the OData service. See same parameter of {@link sap.ushell.services.Bookmark#addBookmark}
+           * Data source of the OData service. See same parameter of {@link sap.ushell.services.Bookmark#addBookmark }
            * for details
            *
            * @returns Value of property `dataSource`
@@ -7279,7 +7473,7 @@ declare namespace sap {
           /**
            * Sets a new value for property {@link #getDataSource dataSource}.
            *
-           * Data source of the OData service. See same parameter of {@link sap.ushell.services.Bookmark#addBookmark}
+           * Data source of the OData service. See same parameter of {@link sap.ushell.services.Bookmark#addBookmark }
            * for details
            *
            * When called with a value of `null` or `undefined`, the default value of the property will be restored.
@@ -7546,6 +7740,23 @@ declare namespace sap {
           press?: (oEvent: sap.ui.base.Event) => void;
         }
 
+        interface ActionItem$AfterRenderingEventParameters {}
+
+        interface ActionItem$PressEventParameters
+          extends sap.m.Button$PressEventParameters {}
+
+        interface DashboardGroupsContainer$AfterRenderingEventParameters {}
+
+        interface LinkTileWrapper$AfterRenderingEventParameters {}
+
+        interface LinkTileWrapper$CoverDivPressEventParameters {}
+
+        interface LinkTileWrapper$PressEventParameters {}
+
+        interface LinkTileWrapper$ShowActionsEventParameters {}
+
+        interface TileState$PressEventParameters {}
+
         class ActionItem extends sap.m.Button {
           /**
            * Constructor for a new ui/launchpad/ActionItem.
@@ -7731,7 +7942,7 @@ declare namespace sap {
             oListener?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:afterRendering afterRendering} to attached listeners.
            *
@@ -7744,7 +7955,7 @@ declare namespace sap {
             mParameters?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:press press} to attached listeners.
            *
@@ -7926,7 +8137,7 @@ declare namespace sap {
             oListener?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:afterRendering afterRendering} to attached listeners.
            *
@@ -8379,7 +8590,7 @@ declare namespace sap {
             oListener?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:afterRendering afterRendering} to attached listeners.
            *
@@ -8392,7 +8603,7 @@ declare namespace sap {
             mParameters?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:coverDivPress coverDivPress} to attached listeners.
            *
@@ -8405,7 +8616,7 @@ declare namespace sap {
             mParameters?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:press press} to attached listeners.
            *
@@ -8418,7 +8629,7 @@ declare namespace sap {
             mParameters?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:showActions showActions} to attached listeners.
            *
@@ -8868,7 +9079,7 @@ declare namespace sap {
             oListener?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:press press} to attached listeners.
            *
@@ -8904,6 +9115,70 @@ declare namespace sap {
             sState?: string
           ): this;
         }
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'ActionItem$AfterRenderingEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $ActionItemAfterRenderingEventParameters = sap.ushell.ui.launchpad.ActionItem$AfterRenderingEventParameters;
+
+        type ActionItem$AfterRenderingEvent = sap.ui.base.Event<ActionItem$AfterRenderingEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'ActionItem$PressEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $ActionItemPressEventParameters = sap.ushell.ui.launchpad.ActionItem$PressEventParameters;
+
+        type ActionItem$PressEvent = sap.ui.base.Event<ActionItem$PressEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'DashboardGroupsContainer$AfterRenderingEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $DashboardGroupsContainerAfterRenderingEventParameters = sap.ushell.ui.launchpad.DashboardGroupsContainer$AfterRenderingEventParameters;
+
+        type DashboardGroupsContainer$AfterRenderingEvent = sap.ui.base.Event<DashboardGroupsContainer$AfterRenderingEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'LinkTileWrapper$AfterRenderingEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $LinkTileWrapperAfterRenderingEventParameters = sap.ushell.ui.launchpad.LinkTileWrapper$AfterRenderingEventParameters;
+
+        type LinkTileWrapper$AfterRenderingEvent = sap.ui.base.Event<LinkTileWrapper$AfterRenderingEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'LinkTileWrapper$CoverDivPressEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $LinkTileWrapperCoverDivPressEventParameters = sap.ushell.ui.launchpad.LinkTileWrapper$CoverDivPressEventParameters;
+
+        type LinkTileWrapper$CoverDivPressEvent = sap.ui.base.Event<LinkTileWrapper$CoverDivPressEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'LinkTileWrapper$PressEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $LinkTileWrapperPressEventParameters = sap.ushell.ui.launchpad.LinkTileWrapper$PressEventParameters;
+
+        type LinkTileWrapper$PressEvent = sap.ui.base.Event<LinkTileWrapper$PressEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'LinkTileWrapper$ShowActionsEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $LinkTileWrapperShowActionsEventParameters = sap.ushell.ui.launchpad.LinkTileWrapper$ShowActionsEventParameters;
+
+        type LinkTileWrapper$ShowActionsEvent = sap.ui.base.Event<LinkTileWrapper$ShowActionsEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'TileState$PressEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $TileStatePressEventParameters = sap.ushell.ui.launchpad.TileState$PressEventParameters;
+
+        type TileState$PressEvent = sap.ui.base.Event<TileState$PressEventParameters>;
       }
 
       namespace shell {
@@ -8927,7 +9202,7 @@ declare namespace sap {
           text?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Text which will be read by screenreader.
            */
@@ -8962,8 +9237,12 @@ declare namespace sap {
           expand?: (oEvent: sap.ui.base.Event) => void;
         }
 
+        interface ToolAreaItem$ExpandEventParameters {}
+
+        interface ToolAreaItem$PressEventParameters {}
+
         /**
-         * @SINCE 1.30.5
+         * @since 1.30.5
          *
          * A control to be placed in the tool area
          */
@@ -9153,7 +9432,7 @@ declare namespace sap {
             oListener?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:expand expand} to attached listeners.
            *
@@ -9166,7 +9445,7 @@ declare namespace sap {
             mParameters?: object
           ): this;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Fires event {@link #event:press press} to attached listeners.
            *
@@ -9179,7 +9458,7 @@ declare namespace sap {
             mParameters?: object
           ): this;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Gets current value of property {@link #getAriaLabel ariaLabel}.
            *
@@ -9235,7 +9514,7 @@ declare namespace sap {
            */
           getVisible(): boolean;
           /**
-           * @SINCE 1.30
+           * @since 1.30
            *
            * Sets a new value for property {@link #getAriaLabel ariaLabel}.
            *
@@ -9333,11 +9612,27 @@ declare namespace sap {
             bVisible?: boolean
           ): this;
         }
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'ToolAreaItem$ExpandEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $ToolAreaItemExpandEventParameters = sap.ushell.ui.shell.ToolAreaItem$ExpandEventParameters;
+
+        type ToolAreaItem$ExpandEvent = sap.ui.base.Event<ToolAreaItem$ExpandEventParameters>;
+
+        /**
+         * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'ToolAreaItem$PressEventParameters'
+         * in 1.115.1 and any later releases.
+         */
+        type $ToolAreaItemPressEventParameters = sap.ushell.ui.shell.ToolAreaItem$PressEventParameters;
+
+        type ToolAreaItem$PressEvent = sap.ui.base.Event<ToolAreaItem$PressEventParameters>;
       }
 
       namespace tile {
         /**
-         * @SINCE 1.15.0
+         * @since 1.15.0
          *
          * An applauncher tile for simple, static apps, displaying title, subtitle, an icon and additional information
          */
@@ -9349,8 +9644,8 @@ declare namespace sap {
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
            *
-           * This class does not have its own settings, but all settings applicable to the base type {@link sap.ushell.ui.tile.TileBase#constructor
-           * sap.ushell.ui.tile.TileBase} can be used.
+           * This class does not have its own settings, but all settings applicable to the base type {@link sap.ushell.ui.tile.TileBase#constructor sap.ushell.ui.tile.TileBase }
+           * can be used.
            */
           constructor(
             /**
@@ -9431,10 +9726,9 @@ declare namespace sap {
          */
         getMetadata(): sap.ui.base.Metadata;
       }
-      const UserStatus: UserStatus;
 
       /**
-       * @SINCE 1.38.0
+       * @since 1.38.0
        *
        * The Unified Shell's ShellUIService service.
        *
@@ -9562,7 +9856,7 @@ declare namespace sap {
          */
         static getMetadata(): sap.ui.base.Metadata;
         /**
-         * @SINCE 1.38.0
+         * @since 1.38.0
          *
          * Returns the title that was last set via {@link setTitle}.
          *
@@ -9570,7 +9864,7 @@ declare namespace sap {
          */
         getTitle(): string;
         /**
-         * @SINCE 1.38.0
+         * @since 1.38.0
          *
          * Displays the given hierarchy in the shell header.
          */
@@ -9607,7 +9901,7 @@ declare namespace sap {
           aHierarchyLevels?: object[]
         ): void;
         /**
-         * @SINCE 1.40.0
+         * @since 1.40.0
          *
          * Used by apps to set related apps. This setting is propagated towards the Shell Header via corresponding
          * events.
@@ -9644,7 +9938,7 @@ declare namespace sap {
           aRelatedApps?: object[]
         ): void;
         /**
-         * @SINCE 1.38.0
+         * @since 1.38.0
          *
          * Displays the given title in the shell header. This method should not be called if the app calling the
          * method is not currently displayed in the Fiori Launchpad.
@@ -9659,7 +9953,7 @@ declare namespace sap {
     }
 
     /**
-     * @SINCE 1.15.0
+     * @since 1.15.0
      *
      * The Unified Shell's container which manages renderers, services, and adapters. The container is designed
      * to be a singleton. Instead of creating an instance please access the central instance via namespace `sap.ushell.Container`.
@@ -9667,14 +9961,14 @@ declare namespace sap {
     class Container {
       constructor();
       /**
-       * @SINCE 1.21.1
+       * @since 1.21.1
        *
        * An enumeration for the application work protect mode state.
        */
       DirtyState: sap.ushell.Container.DirtyState;
 
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        *
        * Logs out the current user from all relevant back-end systems, including the logon system itself. This
        * member represents the default native implementation of logout. If SessionHandler was created, we register
@@ -9683,7 +9977,7 @@ declare namespace sap {
       logout: undefined;
 
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        *
        * Adds a system to the list of remote systems currently in use. On logout this list is processed and performs
        * a logout for each system via the ContainerAdapter specific for its platform.
@@ -9695,7 +9989,7 @@ declare namespace sap {
         oRemoteSystem: sap.ushell.System
       ): void;
       /**
-       * @SINCE 1.19.1
+       * @since 1.19.1
        *
        * Attaches a listener to the logout event. In case the bAsyncFunction parameter is true, the fnFunction
        * must return a promise. FLP will wait for the promise to be resolved before doing the actual logout.
@@ -9711,7 +10005,7 @@ declare namespace sap {
         bAsyncFunction: boolean
       ): void;
       /**
-       * @SINCE 1.34.1
+       * @since 1.34.1
        *
        * Attaches a listener to the rendererCreated event.
        */
@@ -9725,7 +10019,7 @@ declare namespace sap {
         fnFunction: Function
       ): void;
       /**
-       * @SINCE 1.21.2
+       * @since 1.21.2
        *
        * Cancels the logon procedure in the current frame, if any. This MUST be used by the logon frame provider
        * in case the user wants to close the logon frame for good. It will report "Authentication cancelled" and
@@ -9736,7 +10030,7 @@ declare namespace sap {
        */
       cancelLogon(): void;
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        *
        * Creates a new renderer instance for the given renderer name.
        *
@@ -9767,9 +10061,13 @@ declare namespace sap {
          * If `true`, the renderer is created asynchronously and a `Promise` is returned.
          */
         bAsync?: boolean
-      ): sap.ui.core.Control | Promise<any>;
+      ):
+        | sap.ui.core.Control
+        | Promise<sap.ui.core.Control>
+        | sap.ui.core.ComponentContainer
+        | Promise<sap.ui.core.ComponentContainer>;
       /**
-       * @SINCE 1.67.0
+       * @since 1.67.0
        *
        * Deregister the work protection dirty callback function. See registerDirtyStateProvider for more information.
        * Only the last registered function will be deregistered (in case it was registered multiple times).
@@ -9781,7 +10079,7 @@ declare namespace sap {
         fnDirty: Function
       ): void;
       /**
-       * @SINCE 1.19.1
+       * @since 1.19.1
        *
        * Detaches a listener from the logout event.
        */
@@ -9792,7 +10090,7 @@ declare namespace sap {
         fnFunction: Function
       ): void;
       /**
-       * @SINCE 1.34.1
+       * @since 1.34.1
        *
        * Detaches a listener from the rendererCreated event.
        */
@@ -9803,7 +10101,7 @@ declare namespace sap {
         fnFunction: Function
       ): void;
       /**
-       * @SINCE 1.27.0
+       * @since 1.27.0
        *
        * If the dirty state was set to 'false' using 'setDirtyFlag' the registered dirty state provider methods
        * get called to determine the actual dirty state. The determined dirty state is then returned.
@@ -9815,7 +10113,7 @@ declare namespace sap {
        */
       getDirtyFlag(): boolean;
       /**
-       * @SINCE 1.21.1
+       * @since 1.21.1
        *
        * Returns the global dirty state.
        *
@@ -9825,7 +10123,7 @@ declare namespace sap {
        */
       getGlobalDirty(): jQuery.Deferred;
       /**
-       * @SINCE 1.30.0
+       * @since 1.30.0
        *
        * Gets a renderer instance for the given renderer name, that was created by the createRenderer method.
        *
@@ -9840,9 +10138,9 @@ declare namespace sap {
          * if not given here.
          */
         sRendererName?: string
-      ): object;
+      ): sap.ui.core.Control | sap.ui.core.Component;
       /**
-       * @SINCE 1.15.0
+       * @since 1.15.0
        * @deprecated (since 1.77) - Please use {@link #getServiceAsync} instead.
        *
        * Returns a service with the given name, creating it if necessary. Services are singleton objects identified
@@ -9915,9 +10213,9 @@ declare namespace sap {
          * if true, the adapter is loaded asynchronously and a Promise is returned. (since 1.55.0)
          */
         bAsync?: boolean
-      ): object | Promise<any>;
+      ): object | Promise<object>;
       /**
-       * @SINCE 1.55.0
+       * @since 1.55.0
        *
        * Returns a Promise that resolves a service with the given name, creating it if necessary. Services are
        * singleton objects identified by their (resulting) name.
@@ -9983,9 +10281,9 @@ declare namespace sap {
          * A parameter which is passed to the service constructor and every adapter constructor.
          */
         sParameter?: string
-      ): Promise<any>;
+      ): Promise<object>;
       /**
-       * @SINCE 1.31.0
+       * @since 1.31.0
        *
        * Register the work protection dirty callback function. In the work protect mechanism, each platform can
        * register their own method in order to check if data was changed during the session, and notify the container
@@ -10012,7 +10310,7 @@ declare namespace sap {
         fnDirty: Function
       ): void;
       /**
-       * @SINCE 1.27.0
+       * @since 1.27.0
        *
        * Setter for the isDirty flag value.
        *
@@ -10026,7 +10324,7 @@ declare namespace sap {
       ): void;
     }
     /**
-     * @SINCE 1.15.0
+     * @since 1.15.0
      *
      * A representation of a system
      */